Skip to content

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.

docs: v0.1-22 勾选和取消点一下就保存

chipfighter0ce90a207ba7
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4d0210c..794af40 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,10 +9,10 @@
### 功能
- Codex 桌面版右侧的侧边面板里多出“上下文素材”:按轮次列出任务历史里的全部图片(上传的、模型查看和生成的),带缩略图、编号、来源、尺寸和大小,点开看大图。
-- 勾选的图照常发送;取消的图从下一条消息起换成占位符。有内容相同的图还在发送时,占位符指向那一张。任务不换,对话连续。
+- 勾选的图照常发送;取消的图从下一条消息起换成占位符,点一下就生效。有内容相同的图还在发送时,占位符指向那一张。任务不换,对话连续。
- 省略图片时,给模型一条“上下文管理说明”:原图是用户为了节省上下文省略的,之前看着原图做出的回答仍然有效。模型不会因此收回之前的回答,也不编造没看到的细节;需要原图时回复“需要 IMG-xxx”。
- 面板顶部预估下一条消息的请求大小,以及和全部发送相比省了多少;改写失败,或者 WebSocket 这一轮仍带着原图时会提示。
-- 图多的时候:模型要了却还没勾上的图,列在面板顶部,点编号就跳到那一张;每一轮可以整轮勾上或取消,点一下立即生效。
+- 图多的时候:模型要了却还没勾上的图,列在面板顶部,点编号就跳到那一张;每一轮可以整轮勾上或取消。
- 面板、侧边面板里的入口名字和发给模型的说明,跟随 Codex 的界面语言(简体中文、英文)。
- 安装不用开终端:在 Codex 的插件页面添加插件市场、装上插件,在面板里点“启用”。也可以用一行命令安装、卸载。
- 卸载前在面板里点“停用”,Codex 恢复直连;卸载命令不需要插件文件,Codex 连不上时也能用它恢复。
diff --git a/README.md b/README.md
index d29991f..af4a69d 100644
--- a/README.md
+++ b/README.md
@@ -61,8 +61,8 @@ curl -fsSL https://github.com/chipfighter/codex-attachment-manager/releases/late
## 使用
1. 打开一个任务,在侧边面板里打开“上下文素材”(位置见上面安装的第 4 步)。面板左上角显示任务名。新任务也可以在发第一条消息之前打开:发出第一条消息后,面板会自动切到这个任务。
-2. 取消勾选不想再发送的图(点缩略图可以看大图),然后点“确定”。从下一条消息起生效。每一轮标题右侧的勾选框可以整轮勾上或取消,点了立即保存,不用点“确定”。
-3. 模型回复里说“需要 IMG-xxx”、而那张图没勾上时,面板页头会出现“模型需要 N 张没发送的图”。点编号就跳到那张图,勾上再点“确定”,下一条消息就会带上它。
+2. 取消勾选不想再发送的图(点缩略图可以看大图),点一下就保存,从下一条消息起生效。每一轮标题右侧的勾选框可以整轮勾上或取消。
+3. 模型回复里说“需要 IMG-xxx”、而那张图没勾上时,面板页头会出现“模型需要 N 张没发送的图”。点编号就跳到那张图,勾上它,下一条消息就会带上它。
面板里的标签:
diff --git a/docs/plan.md b/docs/plan.md
index e6d1f4b..25cf313 100644
--- a/docs/plan.md
+++ b/docs/plan.md
@@ -305,7 +305,7 @@ P1 通过后,再按用户的节奏一步步探索改写。
- **入口工具**:`cam_panel`,标题“上下文素材”,声明 `thread` 入口,页面固定为 `ui://codex-attachment-manager/panel.html`(地址变了可能白屏,见 #47512)。它和其他面板工具一样只给面板用(`visibility: ["app"]`)。
- **页面**:`spike/src/panel.html`,单文件,不联网。
- 按轮次列出任务历史里的图;缩略图排队加载,看得见的优先;点开后预览大图。
- - 勾选先暂存,点“确定”才调用 `cam_set_selection` 保存。
+ - 每次勾选或取消都立即调用 `cam_set_selection` 保存(v0.1-22 起;之前是先暂存,点“确定”才保存)。点击马上显示,保存进行中的点击合并到下一次调用;读的过程中开始了保存,这次读到的结果就不用,免得旧状态盖掉刚点的。
- 每 3 秒刷新一次,没有变化就不重画。页面报告自己不可见时降到 15 秒一次,因为有的宿主会误报。
- **取图**:`cam_image`。PNG 超过要求的尺寸就缩小,其他格式原样交给页面,由浏览器缩放。
- **开发页**:`spike/scripts/panel-dev.ts` 在浏览器里扮演 Codex 的侧边面板,用合成测试图调通页面,不用重启 Codex。页面上的“切换明暗”“加一张图”只用来模拟 Codex 的操作,不会出现在 Codex 里。
diff --git a/docs/spec.md b/docs/spec.md
index 6bad777..ad21842 100644
--- a/docs/spec.md
+++ b/docs/spec.md
@@ -51,19 +51,19 @@
- 位置:Codex 右侧侧边面板里的一个标签页“上下文素材”。用户在侧边面板的“新建标签页 → 插件和 MCP”里手动打开,不经过模型,也不花 token(P4 实测通过)。Codex 标题栏没有给插件的入口,所以不做外挂窗口。
- 只列这个任务历史里已有的图:用户上传的,和模型在这个任务里查看、生成的。面板不新增素材。
- 按时间顺序、按轮次列出,可以滚动。每条显示缩略图、编号、名称、来源、尺寸、大小、内容相同的关系和勾选状态;点缩略图放大预览。
-- 单张图的勾选和取消先暂存,点“确定”才保存,从下一条消息起生效。
+- 勾选和取消(单张或整轮)点一下就保存,从下一条消息起生效;没有“确定”和“撤销”(用户 2026-09-28 定:先暂存再确认的操作感受差,也容易出错)。
- 面板占满侧边面板的高度:页头和底栏固定,列表在中间滚动(用户 2026-09-27 报告:Codex 26.924 里面板被压成约 200 像素高,已修复)。
- 主题、字体和配色跟随 Codex。
- 面板顶部显示下一条消息的发送预览:照常发送几张、占位几张(其中重复几张),预计请求大小和全部发送时的对比,以及上一次请求实际少发了多少。预计值以引擎记录的上一次完整请求为基准,标明是“预计”,不写成已经发出的请求。
- 上一次请求没能按勾选改写,或者取消时这一轮还在走 WebSocket,面板上都有提示;代理没在运行时也提示。
- 模型最近一次回复说了“需要 IMG-xxx”,而其中有图还没勾上时,页头显示一行“模型需要 N 张没发送的图”,列出这些编号(用户 2026-09-26 定,图多时靠它找到模型要的那张):
- 点编号,列表把那一行滚到正中,闪两下,键盘焦点落到它的勾选框上;
- - 勾上以后(不必等“确定”)编号就从这一行消失,全部勾上后整行隐藏;
+ - 勾上以后编号就从这一行消失,全部勾上后整行隐藏;
- 这一行固定在页头,不跟着列表滚动。
- 每一轮的标题行末尾有一个勾选框,和各行的勾选框在同一列,用来整轮勾选或取消(用户 2026-09-26 定,图多时成批去掉某一轮的图):
- 这一轮能改的图全勾着时显示 ✓,点一下全部不发送;只勾了一部分时显示“–”,没勾的时候是空框,这两种点一下都是全部勾上;
- 只算能改的图,“无法取消”和“已不在上下文”的不算;能改的图少于两张时不显示,因为那一行自己的勾选框就够了;
- - 点一下立即保存,不用点“确定”(用户 2026-09-27 定);这一轮里暂存着的单张改动被它取代,其他轮暂存的改动不受影响。
+ - 和单张勾选一样,点一下就保存。
- 面板自动刷新:
- 平时每 3 秒读一次;
- 用户把鼠标移进面板、点击、滚动时立刻读一次;
diff --git a/docs/tasks.md b/docs/tasks.md
index 361740b..e5f2647 100644
--- a/docs/tasks.md
+++ b/docs/tasks.md
@@ -103,6 +103,9 @@
- 面板高度:更新到 26.924 后面板只剩约 200 像素高。原因和做法见 plan.md 第 19 节。
- 整轮勾选:点一下立即保存,不用点“确定”;这一轮里暂存的单张改动被取代,其他轮的不受影响。单张勾选仍然先暂存。
- 同时确认(2026-09-26,桌面版 26.924,自带命令行 0.158.0-alpha.2):单元测试、插件和安装脚本两项冒烟测试、两个模型自测的中英文都通过;新任务页的预备任务规则(285 秒)没变。
+- [x] **v0.1-22 去掉“确定”和“撤销”**(用户 2026-09-28 定:先暂存再确认的操作感受差,也容易出错;`panel.html`;证据:开发页在无头 Edge 里实测,单张、连点三下(其中一张点两次)、整轮、从“模型需要”提示条勾上都立即保存,刷新后仍在,底栏只剩状态文字;119 个单元测试通过)
+ - 单张和整轮的勾选、取消都是点一下就保存。点击马上显示;保存进行中又点的,合并到下一次保存,不会丢。
+ - 删掉的文字:“有 N 处改动,点‘确定’后生效”“撤销”“确定”,中英文各一份。
- [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 节。