CodexRemoteWin:用手机继续电脑上的 Codex 任务

Administrator 5 阅读

Codex Desktop 很适合处理需要访问本机项目的工作,但人一离开电脑,任务也就很难继续。我做 CodexRemoteWin,是想在不搬走本机环境的前提下,给它补一个手机入口。

程序运行在 Windows 上,通过 Codex Desktop 提供的本地接口读取任务和项目。手机只需要打开网页,就能查看对话、继续发消息,或者处理一些常用的任务操作。

CodexRemoteWin 任务对话界面
CodexRemoteWin 任务对话界面

手机端能做什么

  • 按项目查看本机 Codex 任务和最近对话。
  • 向指定任务发送文字、图片、文档、PDF 和压缩包等附件。
  • 新建任务,并选择项目目录或 Git 工作树。
  • 重命名、置顶、归档和恢复任务。
  • 查看账户可用额度和重置时间。
  • 在浅色与深色界面之间切换。

Windows 端是单文件 EXE,启动后进入系统托盘,没有控制台黑框。网页会定时读取正在进行的回复,发送成功后显示简短回执;结果不确定时保留查询入口,避免同一条消息被重复提交。

安装方法

系统需要 Windows 10 或 Windows 11 x64,并且电脑上已经安装、登录并运行新版 Codex Desktop。至少先在桌面端打开过一个本机任务。

CodexRemoteWin Releases 下载最新版 CodexRemoteWin.exe,放到一个固定目录后双击运行。它会进入系统托盘。右键托盘图标,可以查看访问地址、配对码和开机启动设置。

如果想自己构建,需要 Go 1.22 或更高版本:

git clone https://github.com/fangxinbuzaijia/CodexRemoteWin.git
cd CodexRemoteWin
.\build.ps1

生成的程序位于 dist/CodexRemoteWin.exe

第一次使用

手机和电脑在同一个局域网时,直接在手机浏览器打开托盘菜单显示的地址。首次访问输入六位配对码,配对成功后就能选择任务。

打开一条任务后,可以像聊天一样继续发送内容。添加附件时,文件会先传到 Windows 电脑,再以本机文件路径交给 Codex 读取。一条消息最多 6 个附件,每个文件最多 12 MB。

如果需要从外网访问,可以通过 VPN、带认证的 FRP 或 HTTPS 反向代理接入。不要把 8787 端口直接暴露到公网。公网入口至少要有 TLS、访问认证和来源限制。

目前的限制

当前版本只展示本机任务,最近任务和归档任务都有数量上限。它还不能在手机端停止任务、切换模型、控制 SSH 任务或接收逐字推送。Codex Desktop 的内部接口也可能随版本变化,所以桌面端升级后,如果连接突然失效,应先检查项目发布页是否有兼容更新。

附件和发送回执保存在 EXE 同目录的 data 文件夹。清理这个目录前要先备份仍需保留的附件。浏览器会话令牌只放在浏览器本地存储,服务端保存的是令牌哈希。

项目地址:fangxinbuzaijia/CodexRemoteWin

这是一个非官方工具,不是 OpenAI 官方产品。项目采用 Codex Mini Source-Available Non-Commercial License 1.0,个人、教育、研究和评估可以使用,商业用途需要另行取得授权。