A local plugin for image-heavy chats in Codex, Claude Code and other agents: earlier images stop going out with every message, and the model fetches the one it needs by its ID, also after compaction.
TypeScript ai-agentsclaude-codeclaude-code-plugincodexcodex-plugincontext-managementdeveloper-toolsimage-generationmcpmultimodal
docs: v0.1-20 读 Codex 的语言设置;记下 Codex 缓存工具定义、切换语言要重启
chipfighterb86565869471
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 1ab94a0..e8e9890 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -12,6 +12,7 @@- 勾选的图照常发送;取消的图从下一条消息起换成占位符。有内容相同的图还在发送时,占位符指向那一张。任务不换,对话连续。- 省略图片时,给模型一条“上下文管理说明”:原图是用户为了节省上下文省略的,之前看着原图做出的回答仍然有效。模型不会因此收回之前的回答,也不编造没看到的细节;需要原图时回复“需要 IMG-xxx”。- 面板顶部预估下一条消息的请求大小,以及和全部发送相比省了多少;改写失败,或者 WebSocket 这一轮仍带着原图时会提示。+- 面板、侧边面板里的入口名字和发给模型的说明,跟随 Codex 的界面语言(简体中文、英文)。- 安装不用开终端:在 Codex 的插件页面添加插件市场、装上插件,在面板里点“启用”。也可以用一行命令安装、卸载。- 卸载前在面板里点“停用”,Codex 恢复直连;卸载命令不需要插件文件,Codex 连不上时也能用它恢复。- 插件升级后,新引擎接替还在运行的旧引擎,正在进行的请求照常完成。diff --git a/README.md b/README.mdindex 24c7570..186f02a 100644--- a/README.md+++ b/README.md@@ -107,6 +107,7 @@ macOS、Linux 上,插件被移除或关掉后,引擎会自己恢复直连,- Codex 自带生图工具的结果不能取消。- 取消勾选时,如果这一轮对话还在进行,并且走的是 WebSocket,这一轮剩下的请求仍会带着原图。面板会提示,从下一条消息起生效。- 启用、停用和升级,都要重启 Codex 才生效。+- 切换 Codex 的界面语言后,侧边面板里入口的名字要重启 Codex 才会跟着变;面板里的文字马上就换,发给模型的说明从下一条消息起换。- Codex 刚启动的头几十秒里,引擎可能会重启几次,偶尔会看到一次“正在重新连接”。- 引擎沿用系统代理:Windows 读系统设置,macOS 只认 HTTP(S) 代理(不支持 PAC 和 SOCKS),Linux 读 `HTTPS_PROXY` 等环境变量。diff --git a/docs/plan.md b/docs/plan.mdindex 554aff0..01b3128 100644--- a/docs/plan.md+++ b/docs/plan.md@@ -458,21 +458,35 @@ P1 通过后,再按用户的节奏一步步探索改写。- 引擎也按剩下的部分改写。取消过的图照样换成占位符,认不出的图原样发送。- 任务自己的最后一段找不到时,仍然当作没有记录。-## 16. 中英文界面(v0.1-14)+## 16. 中英文界面(v0.1-14、v0.1-20)### 已查证的事实-- **Codex 把界面语言告诉面板**:MCP 应用规范里,Codex 打开面板时给的 host context 带 `locale`,变了会再发一次。Codex 实际给不给,重装后用 `cam status` 确认(显示语言来自 Codex 还是系统)。+- **Codex 把界面语言告诉面板**:MCP 应用规范里,Codex 打开面板时给的 host context 带 `locale`,变了会再发一次。用户 2026-09-25 实测:Codex 确实给了。+- **Codex 不把界面语言告诉插件服务**:启动插件服务时没有表示语言的环境变量(桌面版 26.924 的前端代码),MCP 的初始化请求本来也没有语言字段。+- **Codex 自己把界面语言写在一个文件里**:桌面版 26.924 给自带的 Computer Use 写 `<CODEX_HOME>/computer-use/config.json`,其中 `locale` 是设置里选的界面语言,没选(“Auto detect”)就是应用自己的语言,也就是系统语言。+ - 用户改语言或主题时重写,每次给任务准备工具配置时也重写(前端代码)。+ - 用户 2026-09-26 切到英文后,这个文件里是 `en-US`。+ - 这不是公开接口,以后可能变。- **插件清单只能写一种文字**:Codex 的插件清单(codex-rs 的 manifest.rs)里,名称、简介、详细说明都是普通字符串,没有按语言切换的写法。-- **工具列表在插件服务启动时读取**:标签页标题就是面板工具的 `title`,所以它的语言在插件服务启动时就定了。+- **工具列表在插件服务启动时读取,之后不再更新**:+ - 标签页标题就是面板工具的 `title`(前端按工具定义里的 `title` 显示)。+ - 桌面版 26.924 自带的命令行(0.158)把工具定义缓存在应用进程里,各任务共用,最长 30 分钟(codex-rs 的 `tool_catalog_cache.rs`)。+ - 插件服务发“工具列表已变”的通知,Codex 只记一行日志(codex-rs 的 `logging_client_handler.rs`)。+ - 所以切换语言后,标签页标题要重启 Codex 才换。用户 2026-09-26 遇到过:面板在中文界面下报告过语言,之后 Codex 改成英文,标题还是“上下文素材”。### 设计- **判断语言**(`language.ts`):以 `zh` 开头的都算简体中文,其他都算英文。- 面板:先看 host context 的 `locale`,没有就看浏览器语言。- - 面板每次调用都带上语言;读面板数据时还带上“来自 Codex 还是系统”,插件记在数据目录的 `language.json` 里,变了才写。- - 引擎(发给模型的文字)和工具列表(标签页标题)读这份记录;没有记录时用系统语言。- - 命令行一律按系统语言:POSIX 的 `LC_ALL`、`LC_MESSAGES`、`LANG`,都没有就看运行时报告的语言。+ - 面板每次调用都带上语言;读面板数据时还带上“来自 Codex 还是系统”。插件记在数据目录的 `language.json` 里,同时记下当时 Codex 的语言设置,变了才写。+ - 引擎(发给模型的文字)和工具列表(标签页标题)按这个顺序决定语言(v0.1-20):+ 1. 面板报告的语言,只要 Codex 的语言设置还是面板报告时那个。面板看到的是界面实际显示的语言,可能和应用自己的语言不同。+ 2. Codex 的语言设置:还没有面板报告过,或者用户之后改了设置。+ 3. 面板最后一次报告的语言;+ 4. 系统语言。+ - 结果:装好就对,不用先打开面板;切换语言后,发给模型的说明从下一条消息起换,标签页标题重启 Codex 后换。+ - 命令行一律按系统语言:POSIX 的 `LC_ALL`、`LC_MESSAGES`、`LANG`,都没有就看运行时报告的语言。`cam status` 显示最终用的语言、Codex 的设置和面板的报告。- **文字表**:- 插件服务和命令行的文字在 `messages.ts`;- 面板的文字在 `panel.html` 里一段 JSON,英文可以多一条 `key_one`(数量为 1 时用);diff --git a/docs/spec.md b/docs/spec.mdindex ba26add..89a6be3 100644--- a/docs/spec.md+++ b/docs/spec.md@@ -79,10 +79,11 @@- 撤回到 Codex 启动时的状态,就不再提示重启。- 语言(用户 2026-09-25 定):- 面板跟随 Codex 的界面语言;Codex 没告诉面板时,看系统语言。+ - 标签页标题和发给模型的说明也跟随 Codex 的界面语言,从装好起就对,不用先打开面板;切换语言后,发给模型的说明从下一条消息起就换,标签页标题要重启 Codex 才换(用户 2026-09-26 定:直接读 Codex 自己记下的语言设置,不改成默认英文)。- v0.1 支持简体中文和英文:任何地区的中文都显示简体中文,其他语言都显示英文。以后有用户反馈再加其他语言。- Codex 自己显示的名字:插件页上名称和一句话简介用英文(Codex Attachment Manager),详细说明先英文、再附一段中文,因为插件清单只能写一种文字;标签页标题跟着语言(“上下文素材”或 Context Assets)。- 安装命令在终端里的输出,按系统语言。-- 以上是用户 2026-09-24 定的 MVP,外加 2026-09-25 要求补上的发送预览、改写失败提示、自动刷新、这两个按钮的位置和名称、标题里的任务名、新任务的自动绑定,以及中英文界面;2026-09-26 加了“模型需要”提示条和整轮勾选。+- 以上是用户 2026-09-24 定的 MVP,外加 2026-09-25 要求补上的发送预览、改写失败提示、自动刷新、这两个按钮的位置和名称、标题里的任务名、新任务的自动绑定,以及中英文界面;2026-09-26 加了“模型需要”提示条、整轮勾选,以及直接读 Codex 的语言设置。### 为后续扩展预留diff --git a/docs/tasks.md b/docs/tasks.mdindex 0c17e6c..2e69ea1 100644--- a/docs/tasks.md+++ b/docs/tasks.md@@ -35,7 +35,7 @@- 一行命令:`install.ps1` / `install.sh` 用 Codex 的命令行装插件,再运行装好的副本里的 `cam setup`;`uninstall.ps1` / `uninstall.sh` 不需要 Node 和插件文件,Codex 连不上时也能恢复。- 插件被移除或关掉却没先停用:macOS、Linux 上引擎会恢复直连;Windows 上引擎随插件服务一起结束(Codex 的 Job 限制),只能靠停用或卸载命令。面板、插件说明和 README 都写了“先停用再移除”。- 顺手修复:引擎的工作目录不再是插件目录;面板开发页的导入路径,以及它改用临时 Codex 目录。-- [ ] **v0.1-6 在 GitHub 上发布 v0.1**:Release 工作流已备好(`.github/workflows/release.yml`:推 `v0.1.0` 标签后先跑三个平台的 CI,再建草稿 Release,附带写好版本号的四个安装、卸载脚本,说明取自 `CHANGELOG.md`)。发布前还差最后一步【需用户】:README、演示视频、截图、仓库目录结构调整;仓库改成公开。+- [ ] **v0.1-6 在 GitHub 上发布 v0.1**:Release 工作流已备好(`.github/workflows/release.yml`:推 `v0.1.0` 标签后先跑三个平台的 CI,再建草稿 Release,附带写好版本号的四个安装、卸载脚本,说明取自 `CHANGELOG.md`)。发布前还差最后一步【需用户】:README、演示视频、截图、仓库目录结构调整;仓库改成公开。README 改版时,“一点补充”里要写:切换 Codex 的界面语言后,重启 Codex,侧边面板里的入口名字才会跟着变(用户 2026-09-26 要求)。- [x] **v0.1-8 用户测试反馈(2026-09-25)**(`panel.html`;用户截图确认:取消两张图后,模型说现在看不到、之前的描述仍然有效,没有收回,也没有编造)- 面板没有自动更新:发送前打开面板,发出带图的一轮、模型收到、模型回复,这三个时间点面板都没变,重新打开才看到最新。- 第一次推断是 Codex 停掉了面板的计时器,于是加了“鼠标移进面板就刷新”和“刷新”按钮。用户再测:点“刷新”也没用,面板一直显示“还没有图片”。所以不是计时器的问题。@@ -94,6 +94,11 @@- 起因:用户实测时模型没写编号。看过那个任务的文字记录:截图是模型操作到一半时截的,之后用户自己改完了设置,问的又是“现在”的设置,所以模型要新截图是对的,不是占位符的问题。- 自测用没有名字的工具截图,全部取消后提问:模型能按操作标题对上编号,但写法不止“需要 IMG-xxx”,会把编号加粗,或借说明里的话写“请重新勾选”“check it back in”“restore”。面板现在都能认出,“取消勾选”“已勾选”这类描述不算。- 发给模型的占位符和说明不改。+- [x] **v0.1-20 标签页标题跟随 Codex 的语言设置**(用户 2026-09-26 定;`language.ts`、`cam.ts`;证据:新增 1 个单元测试,共 119 个;本机 `cam status` 显示用英文,Codex 的设置是 `en-US`)+ - 起因:用户把 Codex 切到英文后,侧边面板里的入口还叫“上下文素材”。插件原来只能从面板得知 Codex 的界面语言;入口名字是插件服务启动时交给 Codex 的,Codex 还会缓存它、不理会更新通知(见 plan.md 第 16 节)。+ - 用户提议默认英文,没有采用:Codex 的界面语言默认跟随系统,默认英文会让大多数中文用户一开始就看到英文名字。+ - 现在插件服务和引擎直接读 Codex 自己写下的语言设置(`<CODEX_HOME>/computer-use/config.json`);设置没变时,面板的报告优先;读不到时照旧。+ - 仍然存在:切换语言后,入口名字要重启 Codex 才换。- [x] **v0.1-7 许可证和 CI**(用户 2026-09-25 定:MIT,并加上 CI):`LICENSE`(插件目录里也放一份);`.github/workflows/ci.yml` 在 Windows、macOS、Linux 上跑单元测试;问题反馈模板,方便 macOS、Linux 用户在 GitHub 上报问题。- 待定:Windows 上不先停用就移除插件,Codex 会断连,只能靠卸载命令恢复;要不要用计划任务让引擎不依赖插件启动,见 spec.md 第 5 节。