Skip to content

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.

docs: “模型需要”提示条(v0.1-17);记下对话里图片引用的调研和不做的决定

chipfighter613d66caf71c
diff --git a/README.md b/README.md
index 077db64..332666d 100644
--- a/README.md
+++ b/README.md
@@ -62,6 +62,7 @@ curl -fsSL https://github.com/chipfighter/codex-attachment-manager/releases/late
1. 打开一个任务,在侧边面板里打开“上下文素材”(位置见上面安装的第 4 步)。面板左上角显示任务名。新任务也可以在发第一条消息之前打开:发出第一条消息后,面板会自动切到这个任务。
2. 取消勾选不想再发送的图(点缩略图可以看大图),然后点“确定”。从下一条消息起生效。
+3. 模型回复里说“需要 IMG-xxx”、而那张图没勾上时,面板页头会出现“模型需要 N 张没发送的图”。点编号就跳到那张图,勾上再点“确定”,下一条消息就会带上它。
面板里的标签:
diff --git a/docs/plan.md b/docs/plan.md
index 8976ae6..554aff0 100644
--- a/docs/plan.md
+++ b/docs/plan.md
@@ -500,3 +500,23 @@ P1 通过后,再按用户的节奏一步步探索改写。
- Codex 会同时启动好几个插件服务:用一个锁文件保证只有一个在复制,其他的等它完成;锁文件超过一分钟没动,就当作复制的进程已经中断,接手重做。
- 设了 `CAM_DATA_DIR`(测试、开发)时不迁移。
- `uninstall.ps1` 的配置备份也改放到新目录。
+
+## 18. 对话里的图片引用(2026-09-26 调研,不做)
+
+用户想让对话里模型要的图(“需要 IMG-017”)变成可点的引用,点了打开面板定位到那张图,或者直接看原图。调研后用户决定不做,改为 v0.1-17 的“模型需要”提示条(见 spec.md 界面一节)。
+
+### 已查证的事实
+
+依据桌面版 26.917 的前端代码:
+
+- 助手回复里的 Markdown 链接,目标是本机绝对路径或 `file://` 地址时,显示成可点的文件链接,链接文字照常显示;左键点击在右侧侧边面板打开。带行号的链接交给 Codex 的文本编辑器;文件不存在时改用系统的文件管理器打开。
+- 插件可以在工具的 `_meta["openai/ui"].entrypoints` 里声明 `{ type: "file", extensions: [...] }`(扩展名不分大小写,带不带点都行)。打开这类文件时,Codex 在侧边面板里用这个工具的页面显示;工具调用的 `_meta["openai/resource"].path` 是文件路径,同时带着当前任务的编号。
+- 标签页按文件路径区分。从回复里打开的文件是“预览标签页”,再打开另一个文件会替换它。插件没有办法切到某个已有的标签页,所以点链接进不了用户手动打开的面板。
+- 面板页面可以发 `openai/files/open`(参数 `path`,绝对路径),请 Codex 在侧边面板打开一个文件。
+- 回复里的 Markdown 图片 `![说明](本机路径)` 由 Codex 读出文件,显示成缩略图(最大约 200 像素见方),点击在原地放大;对话记录里的图不能这样引用,只能引用本机文件。
+
+### 为什么不做
+
+- 两条路都要让模型在回复里写出链接,要改发给模型的说明并重新自测。
+- 点文字链接只能在右侧另开一个预览标签页,和手动打开的面板是两个标签页;原地看大图则要把被取消的图另存成文件,并把路径告诉模型,模型可能自己去打开它。
+- 用户认为收益不值得这些代价(2026-09-26)。
diff --git a/docs/spec.md b/docs/spec.md
index fd3eb7d..16e6004 100644
--- a/docs/spec.md
+++ b/docs/spec.md
@@ -55,6 +55,10 @@
- 主题、字体和配色跟随 Codex。
- 面板顶部显示下一条消息的发送预览:照常发送几张、占位几张(其中重复几张),预计请求大小和全部发送时的对比,以及上一次请求实际少发了多少。预计值以引擎记录的上一次完整请求为基准,标明是“预计”,不写成已经发出的请求。
- 上一次请求没能按勾选改写,或者取消时这一轮还在走 WebSocket,面板上都有提示;代理没在运行时也提示。
+- 模型最近一次回复说了“需要 IMG-xxx”,而其中有图还没勾上时,页头显示一行“模型需要 N 张没发送的图”,列出这些编号(用户 2026-09-26 定,图多时靠它找到模型要的那张):
+ - 点编号,列表把那一行滚到正中,闪两下,键盘焦点落到它的勾选框上;
+ - 勾上以后(不必等“确定”)编号就从这一行消失,全部勾上后整行隐藏;
+ - 这一行固定在页头,不跟着列表滚动。
- 面板自动刷新:
- 平时每 3 秒读一次;
- 用户把鼠标移进面板、点击、滚动时立刻读一次;
@@ -74,7 +78,7 @@
- v0.1 支持简体中文和英文:任何地区的中文都显示简体中文,其他语言都显示英文。以后有用户反馈再加其他语言。
- Codex 自己显示的名字:插件页上名称和一句话简介用英文(Codex Attachment Manager),详细说明先英文、再附一段中文,因为插件清单只能写一种文字;标签页标题跟着语言(“上下文素材”或 Context Assets)。
- 安装命令在终端里的输出,按系统语言。
-- 以上是用户 2026-09-24 定的 MVP,外加 2026-09-25 要求补上的发送预览、改写失败提示、自动刷新、这两个按钮的位置和名称、标题里的任务名、新任务的自动绑定,以及中英文界面。
+- 以上是用户 2026-09-24 定的 MVP,外加 2026-09-25 要求补上的发送预览、改写失败提示、自动刷新、这两个按钮的位置和名称、标题里的任务名、新任务的自动绑定,以及中英文界面;2026-09-26 加了“模型需要”提示条。
### 为后续扩展预留
@@ -89,7 +93,8 @@
- 按文件类型筛选的栏目(全选、只看某一类)和跨任务的素材库;
- 存储清理;
- coding agent 场景,例如省略模型已读过的代码文件;
-- 修改或删除原生 Codex 任务里已有的历史。
+- 修改或删除原生 Codex 任务里已有的历史;
+- 在 Codex 对话里把模型要的图的编号做成可点的引用,点了打开面板或原图(用户 2026-09-26 看过调研结果后决定不做,收益不值得;原因见 plan.md 第 18 节)。
## 3. 硬约束
diff --git a/docs/tasks.md b/docs/tasks.md
index 9539a01..f77eb02 100644
--- a/docs/tasks.md
+++ b/docs/tasks.md
@@ -80,6 +80,11 @@
- [x] **v0.1-16 面板只跟最新开始的任务**(用户 2026-09-25 同意;`binding.ts`;证据:2 个单元测试)
- 起因:同一次收尾检查发现,新任务页的面板每隔 5 分钟左右被切换一次(Codex 换了预备任务),切换记录不断累积;如果面板显示期间先后开始过两个任务,面板每次都会让用户选。
- 现在只跟最新的一个,相差 20 秒以内同时开始的才让用户选;一周前的切换记录自动删掉。
+- [x] **v0.1-17 “模型需要”提示条**(用户 2026-09-26 定;`panel.html`;开发页 `?thread=many`;证据:开发页上 45 张图实测,点编号后那一行停在列表正中、闪两下,焦点落到勾选框;117 个单元测试通过)
+ - 起因:任务里有四五十张图时,模型说“需要 IMG-017”,用户要一行一行翻才找得到。
+ - 页头列出模型要了、还没勾上的图的编号,点了滚过去、闪两下。不做自动跳转、筛选开关和一键全部勾上。
+ - 同一次讨论过“对话里可点的图片引用”,调研后用户决定不做,见 plan.md 第 18 节。
+ - 待用户重装后在 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 节。