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-22 勾选和取消点一下就保存
chipfighter0ce90a207ba7
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 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.mdindex 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.mdindex 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.mdindex 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.mdindex 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 节。