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-23 面板只剩一条的真正原因;更正 v0.1-21 的判断

chipfighter2eda3de50527
diff --git a/docs/plan.md b/docs/plan.md
index 25cf313..ef4b86b 100644
--- a/docs/plan.md
+++ b/docs/plan.md
@@ -535,21 +535,20 @@ P1 通过后,再按用户的节奏一步步探索改写。
- 点文字链接只能在右侧另开一个预览标签页,和手动打开的面板是两个标签页;原地看大图则要把被取消的图另存成文件,并把路径告诉模型,模型可能自己去打开它。
- 用户认为收益不值得这些代价(2026-09-26)。
-## 19. Codex 26.924 的面板高度(v0.1-21)
+## 19. 面板只剩一条:整页被滚走(v0.1-21、v0.1-23)
-用户 2026-09-27 报告:更新到桌面版 26.924 后,面板只剩约 200 像素高,列表被压没,底栏跑到上面,下面一片空白。
+用户 2026-09-27、28 报告:桌面版 26.924 里,面板只剩一条,看得见列表最后一截和底栏,页头不见了,下面一片空白。两次都是在点了整轮勾选框之后。
-### 已查证的事实
-
-依据桌面版 26.924 的前端代码:
+### 查证经过
-- **不再给固定高度**:打开插件页面时,host context 里的 `containerDimensions` 只有 `maxHeight`、`maxWidth`,即最多能占多高、多宽,没有固定的 `height`。按 MCP 应用规范,这表示高度由页面决定,页面用 `ui/notifications/size-changed` 报告自己要多高。
-- **框的高度**:取页面的内容高度,没有时取资源声明的高度提示,都没有时是 480;不低于资源声明的最小高度,没声明时是 200;一般不超过 720。侧边面板里的插件标签页是占满整块区域的模式。
-- **原来的写法量不出高度**:面板的页面高度等于框的高度(`height: 100%`),列表占去剩余空间。这样量出的内容高度只有几十像素,于是只得到最低的 200 像素。
+- **第一次判断错了(v0.1-21)**:以为 26.924 不再给面板固定高度、框被压成最低的 200 像素,于是让页面按 Codex 给的最大高度报告自己的高度。在用户的 Codex 里没有用。
+- **临时诊断版量到的(2026-09-28)**:面板读数据时把尺寸记进数据目录,用户照常操作一遍。
+ - Codex 给的框一直是完整的 451×727,页面一开始也完全正常:页头 194、列表 490、底栏 43,正好 727。
+ - 点 Turn 4、Turn 5 的勾选框之后,整个页面被往上滚了 415、625 像素:页头滚出顶部,底栏跟着上移,下面空了。
+- **原因**:勾选框真正的 `<input>` 是隐藏的绝对定位元素。每一行图片(`.row`)是定位容器,input 留在行里;每轮标题那一行(`.turn`)不是,input 就挂在整个页面上,位置在列表内容里很靠下的地方(列表按未滚动时算)。页面因此能滚动(可滚动高度 4047,视口 727),而焦点落到这个 input 时,浏览器把它滚进视野,滚的是整个页面。
+- **复现和修复**:开发页里让 Turn 4 的勾选框获得焦点,整页滚走 1052 像素,和用户看到的一样。给 `.turn` 加上 `position: relative` 后,页面的可滚动高度等于视口,获得焦点、真实点击都不再滚动。
-### 设计
+### 保留的部分
-- 页面拿到 `containerDimensions` 后,把自己的高度设成 `maxHeight`(给了固定的 `height` 就用它),并发 `size-changed` 报告;面板大小变了,Codex 会再发 host context,页面跟着重新报告。
-- 页面实际得到的框比要的矮(有的宿主会截短),框稳定 1.5 秒后就改成框的高度,底栏始终看得见。页面高度也不低于框的高度,框更高时照样撑满。
-- 没有 `containerDimensions` 时(旧版 Codex 给的是固定高度),照旧撑满框。
-- 验证:面板开发页的 `?host=924` 模拟新版的做法(报告之前只给 200 像素,之后按报告的高度显示,`&cap=N` 模拟截短),在无头 Edge 里检查了撑满、截短、窗口变高和旧版四种情况。桌面版里的效果要重装后看。
+- 26.924 的 host context 里 `containerDimensions` 确实只有 `maxHeight`、`maxWidth`(用户的 Codex 里是 727)。按 MCP 应用规范,这时页面应当用 `ui/notifications/size-changed` 报告自己的高度,所以 v0.1-21 的报告保留:页面高度设成 `maxHeight`,发 `size-changed`;得到的框更矮时,稳定 1.5 秒后改成框的高度;没有这个值时照旧撑满。
+- 开发页的 `?host=924` 模拟这种宿主(报告之前只给 200 像素,`&cap=N` 模拟截短),用来检查页面在这种宿主里的表现。
diff --git a/docs/spec.md b/docs/spec.md
index ad21842..159fada 100644
--- a/docs/spec.md
+++ b/docs/spec.md
@@ -52,7 +52,7 @@
- 只列这个任务历史里已有的图:用户上传的,和模型在这个任务里查看、生成的。面板不新增素材。
- 按时间顺序、按轮次列出,可以滚动。每条显示缩略图、编号、名称、来源、尺寸、大小、内容相同的关系和勾选状态;点缩略图放大预览。
- 勾选和取消(单张或整轮)点一下就保存,从下一条消息起生效;没有“确定”和“撤销”(用户 2026-09-28 定:先暂存再确认的操作感受差,也容易出错)。
-- 面板占满侧边面板的高度:页头和底栏固定,列表在中间滚动(用户 2026-09-27 报告:Codex 26.924 里面板被压成约 200 像素高,已修复)。
+- 面板占满侧边面板的高度:页头和底栏固定,只有列表在中间滚动,整个面板不会被滚走(用户 2026-09-27、28 报告:点靠下的整轮勾选框后,面板只剩一条,已修复)。
- 主题、字体和配色跟随 Codex。
- 面板顶部显示下一条消息的发送预览:照常发送几张、占位几张(其中重复几张),预计请求大小和全部发送时的对比,以及上一次请求实际少发了多少。预计值以引擎记录的上一次完整请求为基准,标明是“预计”,不写成已经发出的请求。
- 上一次请求没能按勾选改写,或者取消时这一轮还在走 WebSocket,面板上都有提示;代理没在运行时也提示。
diff --git a/docs/tasks.md b/docs/tasks.md
index e5f2647..56b7056 100644
--- a/docs/tasks.md
+++ b/docs/tasks.md
@@ -99,10 +99,13 @@
- 用户提议默认英文,没有采用: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 节。
+- [x] **v0.1-21 适配 Codex 26.924:报告面板高度;整轮勾选立即保存**(用户 2026-09-27 报告和决定;`panel.html`,开发页加了 `?host=924`;证据:无头 Edge 里撑满、截短、窗口变高、旧版四种情况都对,整轮勾选点一下就保存、刷新后仍在;119 个单元测试通过)
+ - 面板高度:当时以为面板只剩一条是因为框被压扁,于是按 MCP 应用规范报告页面高度。这个判断错了,真正的原因见 v0.1-23;报告高度保留,见 plan.md 第 19 节。
- 整轮勾选:点一下立即保存,不用点“确定”;这一轮里暂存的单张改动被取代,其他轮的不受影响。单张勾选仍然先暂存。
- 同时确认(2026-09-26,桌面版 26.924,自带命令行 0.158.0-alpha.2):单元测试、插件和安装脚本两项冒烟测试、两个模型自测的中英文都通过;新任务页的预备任务规则(285 秒)没变。
+- [x] **v0.1-23 面板只剩一条:点整轮勾选框把整页滚走了**(用户 2026-09-27、28 报告;`panel.html` 一行 CSS;证据:临时诊断版在用户的 Codex 里量到框一直是 451×727,点 Turn 4、Turn 5 后整页被滚走 415、625 像素;开发页复现(焦点落到 Turn 4 的勾选框,整页滚走 1052 像素),修复后页面可滚动高度等于视口,获得焦点、真实点击都不再滚动;勾选和高度的检查重跑都通过)
+ - 原因:每轮标题那一行不是定位容器,隐藏的勾选框挂在了整个页面上,页面因此能滚动;焦点落到它上面时,浏览器滚的是整个页面。详见 plan.md 第 19 节。
+ - 诊断代码只在临时分支上,没有合进 main。
- [x] **v0.1-22 去掉“确定”和“撤销”**(用户 2026-09-28 定:先暂存再确认的操作感受差,也容易出错;`panel.html`;证据:开发页在无头 Edge 里实测,单张、连点三下(其中一张点两次)、整轮、从“模型需要”提示条勾上都立即保存,刷新后仍在,底栏只剩状态文字;119 个单元测试通过)
- 单张和整轮的勾选、取消都是点一下就保存。点击马上显示;保存进行中又点的,合并到下一次保存,不会丢。
- 删掉的文字:“有 N 处改动,点‘确定’后生效”“撤销”“确定”,中英文各一份。