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-16)

chipfighter7487e65b1b48
diff --git a/docs/plan.md b/docs/plan.md
index 6ddb6f7..8976ae6 100644
--- a/docs/plan.md
+++ b/docs/plan.md
@@ -431,9 +431,10 @@ P1 通过后,再按用户的节奏一步步探索改写。
- 面板所在的任务还没有记录时,插件服务列出符合条件的任务:
- 开始的时间落在某一段里,或者在这一段结束后 5 秒内(用户发完消息马上切走,页面还没来得及记下);
- 来源不是子代理、内部任务、`exec` 或 `mcp`,不是分叉,`thread_source` 为空或者是 `user`。
- - 正好一个就自动切过去;两个以上就列出名称,让用户选。
+ - 正好一个就自动切过去;两个以上就列出名称,让用户选。v0.1-16 起只提供最新的一个,以及和它相差 20 秒以内开始的(见下一条)。
- 为什么按时间段,不按“最近 30 秒”:第一版按 30 秒算。可是用户发完第一条消息就切到别的窗口、过一会儿才回来,任务就超过 30 秒了,面板会一直等下去。按时间段算,回来多晚都能切过去;在别的页面开始的任务,因为当时这个面板不在屏幕上,照样不会被认走。
- 已知的例外:两个窗口并排、两个面板都开在新任务页上,在一个窗口里发消息,两个面板都会切过去。
+ - v0.1-16:用户 2026-09-25 的机器上看到,面板所在的新任务页大约每 5 分钟换一个预备任务,面板收到的编号跟着变,于是每隔几分钟都要重新切一次,留下一条切换记录。如果面板显示期间先后开始过两个任务,每次都会让用户选。现在只提供最新开始的任务,以及和它相差 20 秒以内开始的;写切换记录时删掉一周前的旧记录。
- 绑定记在数据目录的 `bindings/<面板的任务编号>.json`。之后这个标签页的所有调用都按新任务处理,面板重新加载后也一样。
- 只接受面板的绑定调用,模型调用会被拒绝。
- **卡顿**:
diff --git a/docs/spec.md b/docs/spec.md
index b52334c..fd3eb7d 100644
--- a/docs/spec.md
+++ b/docs/spec.md
@@ -64,7 +64,7 @@
- 在新任务发出第一条消息之前打开的面板,发出第一条消息后自动切到这个任务(用户 2026-09-25 定,取代 v0.1-8 的“关掉再打开”):
- 只认用户自己开的任务,子代理、分叉和后台自动任务都不算;
- 只认面板显示在屏幕上时开始的任务;
- - 同时有两个任务都符合时,列出名称让用户点选。
+ - 面板显示期间开始了好几个任务时,跟最新的一个;只有两个任务几乎同时开始(相差 20 秒以内)时,才列出名称让用户点选(用户 2026-09-25 改:原来只要有两个就让用户选,而 Codex 每隔几分钟给新任务页换一个预备任务,面板会被反复询问)。
- 子代理不单独处理:带历史启动的子代理,Codex 记成从主任务分叉,按分叉的规则继承勾选。其他情况等开源后按用户反馈再定(用户 2026-09-25 定)。
- 标题右侧是“停用插件”或“启用插件”,两种样式不同。点一下立即生效,不用再确认(用户 2026-09-25 定)。
- 停用或启用后,中间的提示说明要重启 Codex 才生效,另一个按钮随时可以撤回;
diff --git a/docs/tasks.md b/docs/tasks.md
index 38b2ebc..9539a01 100644
--- a/docs/tasks.md
+++ b/docs/tasks.md
@@ -77,6 +77,9 @@
- [x] **v0.1-15 Windows 的数据目录挪出 AppData**(用户 2026-09-25 同意;`paths.ts`、`migrate-data.ts`、`uninstall.ps1`;设计见 plan.md 第 17 节;证据:3 个单元测试)
- 起因:收尾检查语言记录时发现,Codex、Claude 启动的程序写的数据被 Windows 转存到了各自的私有目录,插件服务、引擎和命令行看到的数据不一样。
- 数据目录改为 `%USERPROFILE%\.codex-attachment-manager`;第一次启动时把旧目录和各私有副本里的数据合并过来,同名文件取最新的。
+- [x] **v0.1-16 面板只跟最新开始的任务**(用户 2026-09-25 同意;`binding.ts`;证据:2 个单元测试)
+ - 起因:同一次收尾检查发现,新任务页的面板每隔 5 分钟左右被切换一次(Codex 换了预备任务),切换记录不断累积;如果面板显示期间先后开始过两个任务,面板每次都会让用户选。
+ - 现在只跟最新的一个,相差 20 秒以内同时开始的才让用户选;一周前的切换记录自动删掉。
- [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 节。