Stop paying the multimodal tax. Your AI agent keeps every image it has seen but only sends the ones it needs: lighter chats, no endless reconnecting, no starting over. Works with Codex, Claude Code, Cline, Gemini CLI, OpenCode, WorkBuddy and more. Install once, forget it.
TypeScript ai-agentsai-imageclaude-codeclaude-code-pluginclinecodexcodex-plugincomputer-usecontext-engineeringcontext-managementdeveloper-toolsgemini-cliimage-generationmcpmultimodalmultimodal-aiopencodeqwen-codetoken-optimizationvision-language-model
docs: 代理随 Codex 启停、界面截图确认的规矩;记录不等更新让生图经过代理的办法
chipfightere2c5ce5748fd
diff --git a/AGENTS.md b/AGENTS.mdindex 53ced6a..f1e3ce2 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -15,6 +15,7 @@ Codex 上下文素材管理器(暂名):让用户逐轮决定,Codex 任- 真实数据不进仓库:从真实会话和用户素材里提取的内容只能放在 `local/`(已被 git 忽略),任何时候都不提交。- 仓库里的文档和代码不写用户本机的具体路径;通用位置(如 `~/.codex`、`%LOCALAPPDATA%`)可以写。- 先在 Windows 上开发和测试。技术栈用 TypeScript/Node。+- 界面开发:Claude 自己截图检查效果;做到界面的关键节点时,截图给用户看,停下来等反馈再继续(用户 2026-09-24 确认)。- 分工:Claude 维护 `docs/` 下的规格和方案,并负责开发和测试(阶段 0 的 T0–T2 由 Codex 完成;测试需要在 Codex 之外启动 app-server,所以从 T3 起改由 Claude 执行)。其他协作者不修改 spec.md 和 plan.md。## Git 规范diff --git a/docs/plan.md b/docs/plan.mdindex 8218c2e..44796ae 100644--- a/docs/plan.md+++ b/docs/plan.md@@ -109,6 +109,7 @@| 编号只由本地记录决定,命令行(以后是面板)和代理各自计算 | 两边不用共享状态,编号也不会对不上 || 取消了图的任务改走 HTTP | WebSocket 只发新增条目,已发的图留在服务端;426 是 Codex 自己的回退路径 || 改写不了就原样发送,并记下原因 | 宁可多发,也不让对话中断;面板要把这种情况显示出来 |+| 代理跟着 Codex 一起启动、一起退出 | 用户 2026-09-24 确认;配置指向代理而代理不在时,Codex 连不上。做法待验证,候选是让 Codex 自己启动的插件本地服务顺带运行代理 || 首版只做单个任务、只做图片 | 全量扫描很重;图片是当前的痛点 || 用 TypeScript/Node | 验证机已有 Node 24;能生成官方协议类型;面板也用同一种语言 |@@ -139,6 +140,12 @@- Codex 默认按环境变量选择代理。用户环境里有 `HTTP(S)_PROXY`、没有 `NO_PROXY` 时,连本地地址的请求也会被交给系统代理,然后失败。- 所以要同时打开 `features.respect_system_proxy`,让 Codex 先看 Windows 的代理设置,并把地址写成 `localhost`:Windows 设置里的 `<local>` 只让不带点的主机名直连。- 生图和改图要等 Codex 包含 #47742 的版本才会遵守这个开关。上游从 `0.158.0-alpha.8` 起包含;桌面版 26.917(自带 `0.155.0-alpha.16.4`)还没有,而且检查更新显示已是最新。在此之前,环境变量里有代理、又没有 `NO_PROXY` 的用户,开着代理时不能生图和改图。详见 [p1-report.md](p1-report.md)。+- **不等更新的办法(待用户授权)**:+ - Codex 每次启动都会读 `$CODEX_HOME/.env`,把里面的变量设进自己的进程(`CODEX_` 开头的除外,见源码 `arg0` 的 `load_dotenv`)。+ - 生图模块用的默认客户端认 `NO_PROXY`(P1-3 已实测)。所以在 `.env` 里写 `NO_PROXY=localhost,127.0.0.1,::1`,生图和改图不等 #47742 也能连到本地代理。+ - 这样还可以不再打开 `respect_system_proxy`:Codex 其他请求走代理的方式和原来完全一样,只有发往本机的请求不走系统代理。+ - 影响范围只有 Codex 自己的进程和它启动的工具,而且只涉及本机地址。+ - 要写 `~/.codex/.env`,超出了目前的授权范围,需要用户同意。- **元数据差异**:地址不是官方域名时,Codex 会去掉请求里附带的原始工具结果元数据(`executed_tool_calls` 里的 `tool_result_metadata`)。这是随请求上报的内部元数据,不是模型看到的内容。### P1:只转发、不改写diff --git a/docs/spec.md b/docs/spec.mdindex e6a1a00..b53bc34 100644--- a/docs/spec.md+++ b/docs/spec.md@@ -21,6 +21,8 @@用户不需要手动编辑任何文件。工具自动找到 Codex 的目录(Windows 上是 `CODEX_HOME`,没设时是 `%USERPROFILE%\.codex`),自动完成接入。每个任务(session)各有一套自己的勾选状态,互不影响。+代理跟着 Codex 一起启动、一起退出(用户 2026-09-24 确认)。只要配置指向代理,代理就必须在运行,否则 Codex 连不上。+### 选择规则- 新出现的图默认勾选,照常发送,包括和前面内容相同的副本(用户 2026-09-24 决定)。用户没有取消任何图时,请求原样转发,Codex 的表现和没装工具时一样。@@ -116,3 +118,4 @@- 路线待定。路线 A(用 `thread/inject_items` 在新任务里重建)已验证可行,但用户不接受“重建后在界面上看不到原对话”:在同一个任务里勾选、取消文件时,对话必须保持连续可见。现在验证代理路线,即任务不换,每次请求发出前由本地代理按勾选改写:- P1(只转发)已在桌面版通过,生图和改图要等桌面版带上新版 Codex 后复测,见 plan.md 第 9 节;- P2(按勾选改写)的自测已通过,待桌面版验证,见 plan.md 第 10 节。+- 是否允许工具在 `~/.codex/.env` 里写一段带标记的 `NO_PROXY`,让生图和改图不等 Codex 更新也能经过代理,见 plan.md 第 9 节。