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-21 面板高度和整轮勾选;记下 26.924 的兼容性测试结果

chipfighterc3853ea33105
diff --git a/CHANGELOG.md b/CHANGELOG.md
index e8e9890..4d0210c 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.md
index 186f02a..d29991f 100644
--- a/README.md
+++ b/README.md
@@ -61,7 +61,7 @@ curl -fsSL https://github.com/chipfighter/codex-attachment-manager/releases/late
## 使用
1. 打开一个任务,在侧边面板里打开“上下文素材”(位置见上面安装的第 4 步)。面板左上角显示任务名。新任务也可以在发第一条消息之前打开:发出第一条消息后,面板会自动切到这个任务。
-2. 取消勾选不想再发送的图(点缩略图可以看大图),然后点“确定”。从下一条消息起生效。每一轮标题右侧的勾选框可以整轮勾上或取消。
+2. 取消勾选不想再发送的图(点缩略图可以看大图),然后点“确定”。从下一条消息起生效。每一轮标题右侧的勾选框可以整轮勾上或取消,点了立即保存,不用点“确定”。
3. 模型回复里说“需要 IMG-xxx”、而那张图没勾上时,面板页头会出现“模型需要 N 张没发送的图”。点编号就跳到那张图,勾上再点“确定”,下一条消息就会带上它。
面板里的标签:
diff --git a/docs/plan.md b/docs/plan.md
index 01b3128..e6d1f4b 100644
--- a/docs/plan.md
+++ b/docs/plan.md
@@ -534,3 +534,22 @@ P1 通过后,再按用户的节奏一步步探索改写。
- 两条路都要让模型在回复里写出链接,要改发给模型的说明并重新自测。
- 点文字链接只能在右侧另开一个预览标签页,和手动打开的面板是两个标签页;原地看大图则要把被取消的图另存成文件,并把路径告诉模型,模型可能自己去打开它。
- 用户认为收益不值得这些代价(2026-09-26)。
+
+## 19. Codex 26.924 的面板高度(v0.1-21)
+
+用户 2026-09-27 报告:更新到桌面版 26.924 后,面板只剩约 200 像素高,列表被压没,底栏跑到上面,下面一片空白。
+
+### 已查证的事实
+
+依据桌面版 26.924 的前端代码:
+
+- **不再给固定高度**:打开插件页面时,host context 里的 `containerDimensions` 只有 `maxHeight`、`maxWidth`,即最多能占多高、多宽,没有固定的 `height`。按 MCP 应用规范,这表示高度由页面决定,页面用 `ui/notifications/size-changed` 报告自己要多高。
+- **框的高度**:取页面的内容高度,没有时取资源声明的高度提示,都没有时是 480;不低于资源声明的最小高度,没声明时是 200;一般不超过 720。侧边面板里的插件标签页是占满整块区域的模式。
+- **原来的写法量不出高度**:面板的页面高度等于框的高度(`height: 100%`),列表占去剩余空间。这样量出的内容高度只有几十像素,于是只得到最低的 200 像素。
+
+### 设计
+
+- 页面拿到 `containerDimensions` 后,把自己的高度设成 `maxHeight`(给了固定的 `height` 就用它),并发 `size-changed` 报告;面板大小变了,Codex 会再发 host context,页面跟着重新报告。
+- 页面实际得到的框比要的矮(有的宿主会截短),框稳定 1.5 秒后就改成框的高度,底栏始终看得见。页面高度也不低于框的高度,框更高时照样撑满。
+- 没有 `containerDimensions` 时(旧版 Codex 给的是固定高度),照旧撑满框。
+- 验证:面板开发页的 `?host=924` 模拟新版的做法(报告之前只给 200 像素,之后按报告的高度显示,`&cap=N` 模拟截短),在无头 Edge 里检查了撑满、截短、窗口变高和旧版四种情况。桌面版里的效果要重装后看。
diff --git a/docs/spec.md b/docs/spec.md
index 89a6be3..6bad777 100644
--- a/docs/spec.md
+++ b/docs/spec.md
@@ -51,7 +51,8 @@
- 位置:Codex 右侧侧边面板里的一个标签页“上下文素材”。用户在侧边面板的“新建标签页 → 插件和 MCP”里手动打开,不经过模型,也不花 token(P4 实测通过)。Codex 标题栏没有给插件的入口,所以不做外挂窗口。
- 只列这个任务历史里已有的图:用户上传的,和模型在这个任务里查看、生成的。面板不新增素材。
- 按时间顺序、按轮次列出,可以滚动。每条显示缩略图、编号、名称、来源、尺寸、大小、内容相同的关系和勾选状态;点缩略图放大预览。
-- 勾选和取消先暂存,点“确定”才保存,从下一条消息起生效。
+- 单张图的勾选和取消先暂存,点“确定”才保存,从下一条消息起生效。
+- 面板占满侧边面板的高度:页头和底栏固定,列表在中间滚动(用户 2026-09-27 报告:Codex 26.924 里面板被压成约 200 像素高,已修复)。
- 主题、字体和配色跟随 Codex。
- 面板顶部显示下一条消息的发送预览:照常发送几张、占位几张(其中重复几张),预计请求大小和全部发送时的对比,以及上一次请求实际少发了多少。预计值以引擎记录的上一次完整请求为基准,标明是“预计”,不写成已经发出的请求。
- 上一次请求没能按勾选改写,或者取消时这一轮还在走 WebSocket,面板上都有提示;代理没在运行时也提示。
@@ -62,7 +63,7 @@
- 每一轮的标题行末尾有一个勾选框,和各行的勾选框在同一列,用来整轮勾选或取消(用户 2026-09-26 定,图多时成批去掉某一轮的图):
- 这一轮能改的图全勾着时显示 ✓,点一下全部不发送;只勾了一部分时显示“–”,没勾的时候是空框,这两种点一下都是全部勾上;
- 只算能改的图,“无法取消”和“已不在上下文”的不算;能改的图少于两张时不显示,因为那一行自己的勾选框就够了;
- - 改动和单张勾选一样先暂存,点“确定”才保存。
+ - 点一下立即保存,不用点“确定”(用户 2026-09-27 定);这一轮里暂存着的单张改动被它取代,其他轮暂存的改动不受影响。
- 面板自动刷新:
- 平时每 3 秒读一次;
- 用户把鼠标移进面板、点击、滚动时立刻读一次;
diff --git a/docs/tasks.md b/docs/tasks.md
index 2e69ea1..361740b 100644
--- a/docs/tasks.md
+++ b/docs/tasks.md
@@ -99,6 +99,10 @@
- 用户提议默认英文,没有采用:Codex 的界面语言默认跟随系统,默认英文会让大多数中文用户一开始就看到英文名字。
- 现在插件服务和引擎直接读 Codex 自己写下的语言设置(`<CODEX_HOME>/computer-use/config.json`);设置没变时,面板的报告优先;读不到时照旧。
- 仍然存在:切换语言后,入口名字要重启 Codex 才换。
+- [x] **v0.1-21 适配 Codex 26.924:面板高度;整轮勾选立即保存**(用户 2026-09-27 报告和决定;`panel.html`,开发页加了 `?host=924`;证据:无头 Edge 里撑满、截短、窗口变高、旧版四种情况都对,整轮勾选点一下就保存、刷新后仍在;119 个单元测试通过;桌面版里的效果重装后由用户确认)
+ - 面板高度:更新到 26.924 后面板只剩约 200 像素高。原因和做法见 plan.md 第 19 节。
+ - 整轮勾选:点一下立即保存,不用点“确定”;这一轮里暂存的单张改动被取代,其他轮的不受影响。单张勾选仍然先暂存。
+ - 同时确认(2026-09-26,桌面版 26.924,自带命令行 0.158.0-alpha.2):单元测试、插件和安装脚本两项冒烟测试、两个模型自测的中英文都通过;新任务页的预备任务规则(285 秒)没变。
- [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 节。