拾光手记

Codex Pocket：把远程 Codex 装进安卓手机

Thu, 29 Oct 2026 00:00:00 GMT

在服务器上交给 Codex 一个耗时任务后，人不一定还能一直守在电脑前。也许只是临时离开工位，也许服务器本来就放在云端；这时真正需要的往往不是一套完整远程桌面，而是能用手机看进度、回复问题、处理审批，再补一句后续要求。

Codex Pocket 正是围绕这个场景制作的独立安卓客户端。它通过 SSH 连接 Linux 服务器，启动服务器上的 codex app-server，再把会话、流式回答、命令输出和审批请求整理成适合手机操作的界面。实际命令和文件修改仍发生在服务器中，手机承担的是随身控制台的角色。

Codex Pocket 是社区开源项目，并非 OpenAI 官方应用。它能够操作远程服务器上的 Codex、项目文件与命令，使用前应当像对待 SSH 客户端一样审慎配置访问权限。

它是怎样工作的

Codex Pocket 的连接路径很直接：

安卓手机
  └─ SSH
      └─ Linux 服务器
          └─ codex app-server
              └─ 项目文件、命令与 Codex 会话

服务器只需要开放原本的 SSH 端口，不必再部署网页桥接服务，也不需要把 Codex 的 HTTP 或 WebSocket 接口暴露到网络。应用使用 bash -lc 启动 Codex，默认从服务器的 PATH、常见安装目录和 nvm 的 Node 目录中自动查找程序，同时识别远程用户的主目录。

这套设计适合已经拥有 Linux 云服务器、虚拟机或家用主机的人。服务器负责保存项目、开发环境和 Codex 会话；手机随时连接同一台机器，因此不会把工作环境复制到移动设备上。

在手机上可以做什么

应用把每台服务器作为一个一级工作区，各自保存所属聊天。连接后可以新建任务，也可以导入服务器中已有的 Codex 会话，用远程 thread ID 继续之前的上下文。

聊天页不仅显示普通文本，还支持：

流式回答、标题、列表、表格、引用与链接；
代码高亮、行内代码和代码块单独复制；
命令执行输出与文件改动；
命令或文件操作审批；
Codex 发起的问题与选项回答；
停止当前任务，以及重命名、搜索和删除手机本地记录。

一台手机可以保存多台服务器，同时连接不同服务器；同一台服务器上，由应用发起的任务则保持一次只运行一个。手机端删除聊天记录不会删除服务器文件，也不会归档远程会话。

界面默认使用深色主题，也能切换为浅色。手机上采用抽屉侧栏，大屏设备使用双栏布局，因此平板或横屏使用时也不会只是把手机版简单拉宽。

SSH 连接与主机指纹

Codex Pocket 支持 SSH 密码认证、OpenSSH/PEM 私钥，以及带口令的私钥。首次连接一台服务器时，应用会显示 SHA-256 主机指纹；确认后会固定这把主机密钥，之后若指纹发生变化便阻止连接。

这一步不要直接凭感觉点确认。可以先在云服务商控制台或已经可信的终端中核对指纹，再让应用保存。主机重装或 SSH 密钥确实更换后，也应先确认变更原因，避免把中间人攻击误当成普通连接异常。

添加或编辑服务器时，可以直接测试当前表单中的 SSH 认证、路径识别与 Codex 握手。测试不会保存尚未提交的修改，也不会打断已经存在的连接。完整连接过程设有 30 秒总超时，并显示当前阶段；遇到地址解析、TCP 连接、SSH 响应、算法协商或认证问题时，比单一的“连接失败”更容易定位原因。

下载与准备

截至 2026 年 10 月 29 日，最新正式版为 v0.2.0，支持 Android 8.0（API 26）及以上，并需要较新的 Android System WebView。

下载 Codex Pocket v0.2.0 APK
查看 v0.2.0 发布说明
下载 SHA256SUMS.txt
APK SHA-256：08fd730517c857ab9b78d5149b11a1006c78c900e9b2be36bffe544d85b24999

APK 大小约 3.21 MiB。下载后可以用发布页提供的校验文件核对完整性，再安装到手机。

从 0.1.2 起，正式安装包沿用固定签名，后续版本可以直接覆盖安装并保留连接配置、凭据和聊天记录。0.1.0 与 0.1.1 使用的是已经无法继续沿用的临时 debug 签名，升级到新版本前需要卸载旧包；卸载会清除手机本地数据，但不会影响服务器上的 Codex 会话与项目文件。

连接手机前，先在 Linux 服务器上以今后用于 SSH 登录的同一用户安装并登录 Codex：

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version
codex login --device-auth

按照终端提示，在手机浏览器中完成设备授权。账号需要具备 Codex 使用权限；也可以预先在服务器上配置 API key，应用本身不要求在手机里再次保存 OpenAI API key。

然后在应用中完成以下设置：

添加虚拟机，填写名称、地址、SSH 端口和用户名；
选择密码或私钥认证并保存；
工作目录与 Codex 路径先保持自动识别；
连接时核对服务器主机指纹；
选择服务器，新建聊天并指定一个真实存在的 Linux 绝对目录。

第一次可以先发送一个只读任务：

查看当前项目结构，介绍如何启动，先不要修改文件。

如果自动识别没有找到 Codex 或项目目录，再到高级设置中填写路径。服务器启动脚本也不要向 stdout 输出欢迎横幅，因为 stdout 用于传输 JSON 协议。

后台保活不是任务重试

连接成功后，Codex Pocket 会通过 Android 前台服务和连接期间的部分唤醒锁维持 SSH。网络中断后，它会按 5 秒到 5 分钟的退避间隔尝试重连；网络恢复时会提前重试。主动点击“断开”或“断开全部连接”后，应用会取消保活意图，不再自行连接。

这里最重要的边界是：自动重连只恢复连接，不会自动重发消息、继续审批或重跑被中断的任务。 这样可以避免同一条命令因为网络抖动被执行两次。重新连接后，应当先刷新远程记录，检查服务器上的文件和进程状态，再决定是否继续。

为了提高熄屏后的稳定性，可以在“设置 → 后台连接 → 设置”中允许应用不受电池优化限制。vivo 等对后台限制较强的系统，通常还需要单独允许自启动和后台高耗电。即便如此，系统强制停止、厂商策略或彻底断网仍可能中断连接，而且持续保活会增加耗电。

本地凭据与日志怎样保存

密码、私钥和聊天记录统一使用 Android Keystore 生成的 AES-GCM 密钥加密保存，并且系统备份已关闭。应用的 WebView 只加载 APK 内的本地界面资源，禁止跳转和访问外部资源；远程回答中的 HTML 会作为文字显示，图片也不会自动加载。

排查问题时，可以在设置中导出最近 24 小时的调试日志。日志记录客户端与系统版本、目标地址、连接阶段、耗时线索和错误，但不记录私钥、密码、验证码或聊天正文。导出的日志文件由用户自行管理，提交 Issue 前仍应检查其中是否含有不希望公开的服务器信息。

当前还不适合哪些场景

Codex Pocket 的定位是远程 Codex 控制台，不是完整的 Linux 桌面或通用 SSH 工具。当前版本不包含：

Linux 图形桌面的鼠标与窗口操作；
离线任务队列和消息自动重试；
SFTP 文件浏览；
跳板机与端口转发配置；
跨手机历史同步或凭据导出；
复杂 MCP 表单与额外权限请求的授权界面。

它也不会替你在服务器上安装或登录 Codex。由于应用能够触发服务器命令与文件改动，最好为 SSH 用户配置与任务相称的最小权限，并继续使用 on-request 审批和 workspace-write 沙箱，而不是把手机端连接当成绕过服务器安全策略的入口。

适合谁使用

如果日常工作主要发生在 Linux 服务器上，又经常需要离开电脑后查看 Codex 进度，Codex Pocket 提供了一条足够短的路径：不搭建额外桥接服务，只通过 SSH 把已有环境延伸到安卓手机。

它尤其适合云服务器开发、家用实验室和远程虚拟机用户。对于只在本地桌面项目中使用 Codex、没有长期在线 Linux 主机的人，现阶段继续使用电脑端会更直接；如果需要随时浏览服务器文件、传输文件或操作图形界面，则仍要配合专业 SSH/SFTP 客户端或远程桌面。

v0.2.0 已经覆盖了移动端最常用的一条闭环：连接服务器、查看与继续会话、处理审批、后台保活，并在断线后安全地恢复连接。它没有试图把整台电脑塞进手机，而是把真正需要随身处理的 Codex 操作做成了一个轻量入口。

项目链接

ShotInk：轻量截图、长截图与本地 OCR 工具

Mon, 26 Oct 2026 00:00:00 GMT

日常写教程、提 Bug 或整理资料时，截图往往只是第一步。真正占时间的，是继续打开图片编辑器画箭头、遮住敏感信息、截取整页内容，再把图片里的文字重新输入一遍。

ShotInk 把这些高频操作放进了同一套流程：按下快捷键框选区域，直接完成标注、马赛克、文字识别、滚动长截图，最后复制到剪贴板或保存为 PNG。软件面向 Windows 10 / 11 x64，提供免安装的 ZIP 便携包，完整解压后即可运行。

下载 ShotInk

截至 2026 年 10 月 26 日，最新正式版为 v1.6.0，发布包大小约 74.3 MiB。

下载 ShotInk v1.6.0（Gitee）
查看最新版发布说明（Gitee）
访问 ShotInk Gitee 仓库
v1.6.0 SHA-256：11e1c8bfe92ab41de6ae9b7c71449222d1475339dfcceeab742479406a2ed791

当前下载文件托管在 Gitee。若链接提示 403、无权访问或页面不存在，请先登录拥有该仓库访问权限的 Gitee 账号。

下载后请完整解压 ZIP，不要直接在压缩包内运行。打开解压目录中的 ShotInk.exe，并保留同目录下的 ocr 文件夹，否则文字识别功能将无法正常工作。

运行环境：

OCR 组件、识别模型和所需的 .NET 8 运行时已经包含在便携包中，不需要另装 Python、.NET SDK，也不需要首次启动后再下载模型。

一次截图，直接完成标注

ShotInk 的基础入口是 F1。拖出截图区域后，选区下方会出现浮动工具栏，可以继续调整截图边界，也可以直接添加内容：

矩形、椭圆、直线、折线和箭头；
自由画笔与荧光笔；
支持中文、多行、粗体、斜体和旋转的文字标注；
马赛克与高斯模糊；
按涂抹或框选范围恢复原图的橡皮擦；
撤销、重做、贴图、保存和复制。

每种工具会分别记住颜色、线宽、字号、马赛克颗粒或模糊强度，重新截图或重启后仍可沿用。工具栏、边框、选区手柄和 OCR 高亮只用于编辑，不会出现在最终导出的图片里。

未启用绘图工具时，按 Enter、Ctrl+C 或双击选区即可复制结果；按 Ctrl+S 保存为 PNG。这样处理聊天截图、教程配图和问题反馈时，不必在截图工具与图片编辑器之间来回切换。

滚动长截图：从页面中间也能开始

ShotInk 的滚动长截图不是简单地录制屏幕，而是根据相邻画面的重叠区域拼接原始像素。按 Ctrl+Alt+L 可以直接框选并开始，也可以先按 F1 截出范围，再点击工具栏中的长截图按钮。

进入采集后，只需在原窗口中向上或向下滚动。它支持双向拼接，因此即使从文档中间开始，也可以先向上补齐顶部，再向下继续采集；重复经过已经收集的区域不会再次加入长图。完成后，长图会留在固定预览框中，可以继续标注、OCR、复制或保存。

为了让拼接更稳定，使用时最好注意三点：

框选正文区域，尽量避开固定页头、悬浮按钮和动画内容；
连续滚动时保留足够重叠，不要直接拖动滚动条进行大跨度跳转；
页面内容尚未加载完成时先等待，避免前后帧发生布局变化。

单张长图高度达到 30,000 像素，或总像素达到 8,000 万时，软件会自动结束采集并保留已经完成的部分。如果无法继续找到可靠的重叠区域，也会停止拼接并给出提示，避免在没有提示的情况下遗漏内容。

本地 OCR：识别、选择，还能搜索长图

点击工具栏中的“方框＋文”图标，ShotInk 会在本地识别图片里的中英文、数字和标点。识别完成后可以像选择网页文字一样拖选内容，也支持：

单击选择英文单词；
双击选择整行；
Ctrl+A 全选；
Ctrl+C 复制选中文字；
跨行选择表格中的一列内容。

v1.6.0 重点改善了长截图 OCR。软件会将长图分块识别，再合并坐标与阅读顺序；识别完成后，右上角会出现搜索框。按 Ctrl+F 输入关键词，便能查看匹配数量并自动滚动到对应位置。Enter 或 F3 跳到下一处，Shift+Enter 或 Shift+F3 返回上一处。

搜索会兼容 OCR 结果中的空格、零宽字符、全角字符和同一行被拆开的文字块。例如识别结果中夹有空格的 L i s t，仍然可以用 list 找到。搜索高亮与文字选择不会修改复制内容，也不会进入最终图片。

截图和 OCR 都在本机处理，应用不会把截图上传到开发者服务器。对于包含账号信息、内部文档或客户资料的截图，本地处理能减少不必要的传输环节。不过，复制到剪贴板或保存到云同步目录后的数据，仍会受到 Windows、剪贴板工具和同步软件各自规则的影响。

桌面贴图与本地历史

按 F3 可以把剪贴板中的图片固定在桌面最上层。贴图支持拖动位置、滚轮缩放和半透明显示，适合对照设计稿、抄录参数或在多个窗口之间核对内容。

软件默认在本地保留最近 10 张截图，可以在工作台中修改数量，也可以完全关闭历史记录。双击历史图片能够重新进入编辑器，继续标注或搜索识别结果。手动保存的图片与历史记录相互独立，减少历史数量不会删除已经保存到其他目录的 PNG 文件。

常用快捷键

操作	默认快捷键
区域截图	`F1`
剪贴板贴图	`F3`
滚动长截图	`Ctrl+Alt+L`
保存结果	`Ctrl+S`
复制结果	`Ctrl+C`
撤销 / 重做	`Ctrl+Z` / `Ctrl+Y`
完成截图并复制	`Enter`
搜索 OCR 文字	`Ctrl+F`

截图、贴图与长截图快捷键都可以在设置中修改。如果快捷键与其他软件冲突，ShotInk 会提示冲突并保留原绑定，也可以暂时从工作台按钮或托盘菜单启动对应功能。

使用建议

ShotInk 比较适合需要频繁制作说明截图的人：开发者可以快速标记错误位置，写作者可以完成教程配图，客服与运营人员可以在长页面中查找并复制文字。它的优势不在于堆叠复杂图像效果，而是把“截图—标注—识别—复制或保存”压缩成一个连贯流程。

升级版本前，先从系统托盘彻底退出旧版，再替换或解压新版本，避免仍在使用旧进程。软件设置与截图历史位于 %LOCALAPPDATA%\ShotInk，日常手动保存的图片则以设置中选择的目录为准。

如果你只需要偶尔截一张图，Windows 自带工具已经足够；如果截图之后经常还要画箭头、打码、截长页或复制图片文字，ShotInk 会更省步骤。