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.10): spec, design, changelog and gate results
chipfighter0b448f5915fb
diff --git a/AGENTS.md b/AGENTS.mdindex a944dee..2b9f540 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -11,6 +11,7 @@ Context Attachment Manager(上下文素材管理器,2026-10-11 前叫 Codex- [docs/v0.6/plan.md](docs/v0.6/plan.md):v0.6 方案,默认开启自动选图、Claude 桌面版自动打开面板(已发布 0.6.0)。- [docs/v0.7/plan.md](docs/v0.7/plan.md):v0.7 方案,Codex 的子代理和旁聊也自动选图(已发布 0.7.0)。- [docs/v0.8/plan.md](docs/v0.8/plan.md):v0.8 方案,模型给每张图写特征行、压缩后照样拿对图,面板改成搜索加缩略图(已发布 0.8.0)。+- [docs/v0.10/plan.md](docs/v0.10/plan.md):v0.10 方案,压缩和续接之后照样拿回之前的图,编号不变(开发中,未发布;关卡结果见方案第 3 节)。- [docs/history/v0.1/](docs/history/v0.1/):v0.1 的开发记录(原方案、任务记录、各阶段报告、最初的构想),只作参考,不作依据。- [CHANGELOG.md](CHANGELOG.md):每个版本的更新记录,发布时就是 Release 说明。- [eval/README_CN.md](eval/README_CN.md):评测(英文版 [eval/README.md](eval/README.md)),装插件和不装插件的对比:方法、结果和复现步骤。@@ -27,7 +28,7 @@ Context Attachment Manager(上下文素材管理器,2026-10-11 前叫 Codex- 先在 Windows 上开发和测试。技术栈用 TypeScript/Node。- 界面开发:Claude 自己截图检查效果;做到界面的关键节点时,截图给用户看,停下来等反馈再继续(用户 2026-09-24 确认)。- 测试时调用模型一律用 `gpt-6-sol`,推理强度 `low`,包括脚本自测和桌面版测试,为了省 token(用户 2026-09-24 要求)。-- 界面和提示文字分简体中文、英文两份:面板的在 `plugin/src/panel.html` 的文字表里,插件服务和命令行的在 `plugin/src/messages.ts`。新增或修改文字时两份一起改,单元测试会检查条目一一对应。改发给模型的占位符和说明(`plugin/src/rewrite.ts`)时,中文、英文(`--lang en`)各跑一次 `spike/src/v01-placeholder-selftest.ts`(用户 2026-09-25 要求)和 `spike/src/v01-needs-selftest.ts`(没有名字的工具截图全部取消后,模型能不能按编号要图、面板能不能认出来;用户 2026-09-26 要求);改的是自动选图的文字(自动版的占位符和说明、`cam_view_image` 的说明和返回的文字)时,再跑 `spike/src/v03-auto-selftest.ts`(模型该取图时会不会取、不该取时会不会不取;用户 2026-10-06 要求);改的是特征行说明时,再跑 `spike/src/v08-features-selftest.ts`(模型会不会给新图写特征行、照原话记评价、正文里不提,压缩后能不能靠特征行拿对图;v0.8)。这些自测三个 GPT-6 模型都要跑:`gpt-6-sol`、`gpt-6-luna`、`gpt-6-astra`,推理强度 low,用环境变量 `CAM_TEST_MODEL` 切换(用户 2026-09-28 要求)。自测在用户的 Codex 里建的任务,测完由脚本自动归档,不留给用户手动整理(用户 2026-09-28 要求);遗留的可以用 `spike/scripts/archive-test-threads.ts` 归档。+- 界面和提示文字分简体中文、英文两份:面板的在 `plugin/src/panel.html` 的文字表里,插件服务和命令行的在 `plugin/src/messages.ts`。新增或修改文字时两份一起改,单元测试会检查条目一一对应。改发给模型的占位符和说明(`plugin/src/rewrite.ts`)时,中文、英文(`--lang en`)各跑一次 `spike/src/v01-placeholder-selftest.ts`(用户 2026-09-25 要求)和 `spike/src/v01-needs-selftest.ts`(没有名字的工具截图全部取消后,模型能不能按编号要图、面板能不能认出来;用户 2026-09-26 要求);改的是自动选图的文字(自动版的占位符和说明、`cam_view_image` 的说明和返回的文字)时,再跑 `spike/src/v03-auto-selftest.ts`(模型该取图时会不会取、不该取时会不会不取;用户 2026-10-06 要求);改的是特征行说明时,再跑 `spike/src/v08-features-selftest.ts`(模型会不会给新图写特征行、照原话记评价、正文里不提,压缩后能不能靠特征行拿对图;v0.8);改的是压缩后放回的说明和清单时,再跑 `spike/src/v10-compaction-selftest.ts`(Codex 压缩之后,模型能不能靠清单认出之前的图、要看原图时按编号取对;v0.10)。这些自测三个 GPT-6 模型都要跑:`gpt-6-sol`、`gpt-6-luna`、`gpt-6-astra`,推理强度 low,用环境变量 `CAM_TEST_MODEL` 切换(用户 2026-09-28 要求)。自测在用户的 Codex 里建的任务,测完由脚本自动归档,不留给用户手动整理(用户 2026-09-28 要求);遗留的可以用 `spike/scripts/archive-test-threads.ts` 归档。- 分工:Claude 维护 `docs/` 下的规格和方案,并负责开发和测试(阶段 0 的 T0–T2 由 Codex 完成;测试需要在 Codex 之外启动 app-server,所以从 T3 起改由 Claude 执行)。其他协作者不修改 spec.md 和 design.md。## Git 规范diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 191d0c0..8b576d8 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -2,6 +2,30 @@When a version is released, its section here becomes the GitHub release notes.+## [0.10.0] - Unreleased++Earlier images come back after compaction and resume, with the same IDs, in Codex and Claude Code.++### Features++- After Codex compacts a task, the images that tools viewed, generated or returned before the compaction go back into the request right after it: pinned images as originals, the others one line each with the model's feature line and ratings. Previously only uploaded images survived a Codex compaction. The panel marks these images as from before the compaction.+- Images put back after a compaction are now one compact list, one line per image (ID, name, source, turn, feature line, ratings), instead of a placeholder each, on both platforms. In a real session with 127 earlier images this is an estimated 5–7K tokens per request instead of 13–19K.+- The model can correct a wrong feature line by writing it again with "corrected:".+- When the user stops a turn before the model writes the feature lines for its new images, those images are sent once more in the next turn, labelled as still missing a feature line.++### Fixes++- Claude Code 2.1.304 and later keep the last messages through a compaction. The plugin now links them the way Claude Code does, so it recognizes the compaction and puts the earlier images back; before, such a compaction could put none back.+- When Claude Desktop resumes a session into a new transcript, the plugin follows it back to the earlier transcripts, also across several resumes and forks. Images keep their IDs, feature lines and ratings. Before, IDs restarted in the new transcript, so earlier feature lines could attach to the wrong image; lines written that way are now matched back to the right image.+- Resumed and forked Claude sessions start with the previous session's checked, pinned and Auto-select settings.+- Long feature lines and ratings are cut by width rather than by character count, whatever the language setting, so English feature lines in a Chinese setup are no longer cut down to the place alone.++### Notes++- After updating, reopen Claude sessions that were open: their image tool still runs the earlier code and numbering until then.+- Earlier transcripts are read only up to the compaction, and their image data stays on disk until needed: for the longest real session tested (9 transcripts, 210 images), the engine uses about 60 MB more memory and the first index takes under 2 seconds.+- Verified so far with 281 unit tests and read-only replays of real Codex and Claude sessions. The model self-tests and a live Claude Desktop compaction test are still to run.+## [0.9.1] - 2026-10-29Japanese panel support and smoother image previews.diff --git a/docs/design.md b/docs/design.mdindex 4a98d2f..1bc28d7 100644--- a/docs/design.md+++ b/docs/design.md@@ -81,6 +81,8 @@- 归档的任务挪到 `archived_sessions`,一样要读;新版 Codex 会把一周没动的记录压缩成 `.jsonl.zst`,用 Node 自带的 zstd 解开。- 前面某一段历史找不到了(例如被删掉),就跳过这一段,照常读剩下的,面板上提示。- **目录遍历**:完整遍历只做一次,之后只重新列出今天和昨天的目录,每分钟再完整遍历一次作为兜底;读某一段找不到时立刻重新查找,最多每 5 秒一次。+- **Codex 的压缩**(v0.10,`thread-index.ts`):记录里的 `compacted` 条目带着 Codex 压缩后保留的历史(`replacement_history`:系统和开发者消息、全部用户消息、一个加密的 `compaction` 项)。索引照旧读全部条目,编号不受影响;最近一次压缩之前、又不在保留的历史里的图(工具查看、生成或返回的)标上 `compacted`,引擎据此放回(第 4 节),面板标“压缩前”。索引另外带上历史的全部条目(`items`),放回原图时从这里取数据。+- **被打断的轮次**(v0.10,`thread-index.ts`、`claude-index.ts`):Codex 记录里的 `turn_aborted`,或 Claude Code 在下一轮记下的“[Request interrupted by user…]”(这一条本身算一轮,记为跳过),标出模型没来得及写最后那条回复的轮次。`awaitingLine`:图在这样一轮里、还没有特征行,之后也没有一轮正常结束,就在当前这一轮再发一次。## 4. 改写请求(引擎)@@ -96,7 +98,7 @@- 只在本来就改写的请求里做,Codex 的改写时机不变(手动模式要等第一次取消勾选);子代理、旁聊和 Codex 的后台任务不做(`writesNotes` 看会话记录的 `source`,旁聊没有记录也不做)。- 请求里有索引认得的图时,在第一张图所在那一轮的用户消息之前插一条开发者消息“特征行说明”;有“上下文管理说明”时,两条都在,特征行说明在前。- 每张发送的图都加“已提供”标签,这一轮的新图也加;新图的标签只在请求末尾,前面的历史不变。- - 占位符的标题行下面加一行特征和评价(`notesLine`):特征行加最近 3 条评价和它们的轮次;超长时在上限以内最后一个标点或空格处截断,加“…”(中文特征 30 字、评价 15 字,英文按字符数放宽)。+ - 占位符的标题行下面加一行特征和评价(`notesLine`):特征行加最近 3 条评价和它们的轮次;超长时在上限以内最后一个标点或空格处截断,加“…”(`clip`:特征 30、评价 15,按宽度算,中日韩文字一个算 1,其他字符算 0.3,即 30 个汉字或 100 个字母;v0.10 起和界面语言无关,原来中文界面按字符数截,英文特征行只剩地点)。- 改写报告多三项,只记数字:`featureAt`(特征行说明插在第几条)、`labeled`(加了几个标签)、`unknown`(索引不认得的图有几张,这一轮取回的副本不算)。关卡 3 用 `unknown` 确认新图在它那一轮的第一个请求里就有编号。- **自动选图**(v0.3,`proxy.ts`、`rewrite.ts`):- 这一轮是第几轮,按请求头里的 `turn_id` 在索引里查;记录里还没有这一轮时,算最后一轮之后。@@ -111,6 +113,8 @@- 旁聊:请求所属的任务没有会话记录、请求里又有 `forked_from_thread_id`,就是旁聊(`sideChatOrigin`;用户自己分叉的任务有记录,照旧按分叉规则)。用原任务的索引改写:原任务的各轮都算之前的轮次,所以带过来的图都换成自动版占位符,原任务里每轮都发的照发(`sideChatSelection`)。- 子代理:会话记录第一条 `session_meta` 里有 `source.subagent.thread_spawn`、没有 `forked_from_id` 的,是不带历史启动的子代理(`spawnParent`),顺着父任务一路找到最上面的主任务(`mainTaskOf`)。子代理自己没有开关时就是自动选图,从子代理开始时算起(`childSelection`)。带历史启动的子代理是分叉,照旧。子代理的第一个请求可能早于它的会话记录,这时按 v0.6 的默认算;它的第一个请求里没有之前各轮的图。- 登记:引擎每次看到子代理或旁聊的请求(HTTP 和 WebSocket 都算),就把它记在主任务名下(数据目录 `state/children/<主任务>.json`:类型、来自哪个任务、第一次请求的时间),每个只写一次。旁聊没有会话记录,这是面板知道它的唯一来源。+- **Codex 压缩之后**(v0.10,`proxy.ts`、`rewrite.ts` 的 `addCodexCompacted`):请求里有 `compaction` 项、索引里有标着 `compacted` 又不在请求里的图时,在压缩项后面插一条开发者消息(说明加清单:一张一行,编号、名称、来源、轮次、特征和评价),每轮都发的(手动模式下是勾着的)再跟一条用户消息,放“已提供”标签和原图(数据从索引的 `items` 取)。只给任务自己的请求(`writesNotes`),旁聊和子代理不放。勾选和记录不变时插入的内容逐字节相同,缓存接得上。日志里记 `compacted: { at, listed, resent }`。+- **补写特征行**(v0.10):自动选图算“之前各轮不发”的图时,跳过 `awaitingLine` 的图(第 3 节):它们照常发送,标签状态写“已提供,还没有特征行”(`Described.awaiting`),特征行说明里告诉模型补写。Codex 和 Claude 相同。- **切到 HTTP**:WebSocket 连接上 Codex 只发新增的条目,靠 `previous_response_id` 接上服务端保存的历史,已经发过的图去不掉。所以:- 任务一需要改写(有取消项,或者用过自动选图),引擎就对它的 WebSocket 握手回 426,Codex 在这个会话里改走 HTTP,每次都发完整历史;- 它已有的 WebSocket 连接,空闲 1.5 秒后由引擎关掉;@@ -255,7 +259,7 @@- v0.3 查证:GPT-6 Luna(low)读工具结果里的图,比读用户消息里的图差。同一张图放在消息里问,四次都读对;经 `cam_view_image` 或 Codex 自带的 `view_image` 送来,常把角落的小数字读错(5 读成 3,7 读成 2),有时说看不到数字。把取回的图挪进紧跟着的一条用户消息也没改善,问题在“先调用工具再看图”这个过程,不在图放在哪里。Sol、Astra 没有这个问题。发布说明写明了这一点。- **桌面版的上下文比自测多**:桌面版每轮还带着电脑操作、浏览器等插件的工具说明(约 1 万 token)。自测为了不让测试模型操作用户的电脑,没开这些插件,所以个别只在桌面版出现的模型行为,自测复现不出来。-## 12. Claude Code 接入(v0.4–v0.9)+## 12. Claude Code 接入(v0.4–v0.10)方案、关卡和任务见 [v0.4/plan.md](v0.4/plan.md)。做法是把上面的机制逐块移植,这里写对应的做法和平台逼迫的改动。@@ -282,7 +286,12 @@- **压缩之后**(v0.5,`claude-index.ts`、`claude-rewrite.ts` 的 `addCompacted`、`proxy.ts`;实测见 [v0.5/plan.md](v0.5/plan.md)):- Claude Code 2.1.295 压缩后的请求:第一条是用户消息,内容是整段摘要(等于会话记录里 `isCompactSummary` 那条的文字),接着常有一条它自己的系统消息(例如带 `output_config` 的空消息),然后是压缩前的最后一条回复,再往后是新的一轮;压缩前的图一张都没有。写摘要的那个请求和普通请求一样带着全部历史和图,照常改写。- 索引照常跨分界编号,压缩前的图标着 `compacted`,还记下摘要的文字(`summary`)。请求里找到这段摘要,才算压缩后的请求;找不到就不补。- - 补在摘要文字后面,按编号:要发的(勾着的,自动选图时是勾成每轮都发的)是“已提供”标签加原图(`claudeImageData` 从会话记录读),其余是占位文字(手动和自动各用各的)。说明并进摘要后面的系统消息(没有就插一条):列出压缩前的全部图;有图没发时前面是完整说明,v0.4 的改写在后面的消息里就只加短说明(`noted`)。全部发出时说明里写明勾回的图回到这里、不会出现在新消息里,以及之前说看不到是因为当时被省略。勾选不变时这两条消息逐字节相同,提示缓存照常命中。+ - 补在摘要文字后面:要发的(勾着的,自动选图时是勾成每轮都发的)是“已提供”标签加原图(`claudeImageData` 从会话记录读),其余的 v0.10 起合成一个文本块,一张一行(`compactList`),v0.5 到 v0.9 是每张一个占位。说明并进摘要后面的系统消息(没有就插一条):v0.10 起只写压缩前有几张、编号从哪到哪,不再列一遍;有图没发时前面是完整说明,v0.4 的改写在后面的消息里就只加短说明(`noted`)。全部发出时说明里写明勾回的图回到这里、不会出现在新消息里,以及之前说看不到是因为当时被省略。勾选不变时这两条消息逐字节相同,提示缓存照常命中。+ - 保留消息的压缩(v0.10,`claude-index.ts` 的 `relinked`):Claude Code 2.1.304 起压缩记录带 `compactMetadata.preservedSegment`(`headUuid`、`anchorUuid` 即摘要、`tailUuid`)或 `preservedMessages`(`anchorUuid`、`uuids`),原样保留最后几条消息。它读记录时(2.1.309 程序里的函数)对最后一个压缩点:保留的消息接在摘要后面;原来接在摘要上的记录,以及接在被它删掉的记录(压缩点之前、没被保留的)上的消息,接到最后一条保留消息后面;然后删掉那些记录。文件里存的是改接之前的样子:新消息接在保留消息上时,按文件连对话链会绕过压缩点。插件照同样的规则改接(只改 `activeChain` 用的父节点,不改记录),但不删历史:压缩点往前接到第一条保留消息原来的前一条,压缩前的图照旧标 `compacted`。+ - 续接后的记录(v0.10,`withHistory`、`originalOf`、`readHistoryTranscript`):桌面版每次重启 Claude Code 进程都续接成新会话,新记录文件只有改接后剩下的记录,从最近一个压缩点开始。插件找到压缩发生的那个记录文件:先看摘要里 Claude Code 写的“read the full transcript at: …”(取最后一处,只认 `<home>/projects` 下、含同一个压缩点且压缩点前面还有记录的文件),找不到再在同一个项目文件夹里、压缩之后改动过的记录里按压缩点的 uuid 找;它也可能是续接来的,逐层往回。旧记录只取压缩点之前、带 uuid 的记录,图片只留指纹,原始数据用到时再按位置从文件读(`onDisk`);文件不变就不重读。这样编号和续接前一样,压缩前的图照样能放回、能取回。+ - 换算老记录行(v0.10,`translator`、`oldNumbering`、`familyOf`):修复之前,续接后的文件从自己的起点编号,那段时间写下的记录行和取回副本前面那行字用的是这套编号。同一项目文件夹里,第一条对话记录是会话起点或某个压缩点的记录文件,就是这个会话的全部记录文件,各自的创建时间是开头第一条带时间的记录;一条记录行是写它时最近开的那个文件的进程写的。那个文件从压缩点开始的,就按“从那里数起”的旧编号找到图(key),再换成恢复后的编号;会话起点开始的不用换。只换算 `claude/selection/stable-ids.json` 记下的这个版本第一次运行之前写的(和 v0.6 的 auto-default.json 一样,引擎和插件服务启动时写一次)。旧编号只数到那个时刻,算一次就缓存。真实会话回放:两组会话,分别 6 个和 3 个记录文件,同一张图编号一致;挂错的特征行都回到对的图(`local/` 里的评估报告)。+ - 勾选沿用(v0.10,`selection.ts` 的 `claudeOwnSelection`、`ClaudeIndex.previous`):会话还没有自己的勾选文件时,按 `previous`(分叉时复制来的记录里留着的原会话 id 在前,然后是同一会话里更早开的记录文件,近的在前)找第一个有勾选文件的,沿用续接那一刻之前的标记和开关,写成自己的文件。+ - 代价(v0.10,用户要先看再定):最长的真实会话(9 个记录文件、210 张图)堆内存 83 → 145 MB,第一次建索引约 1.8 秒;之后记录有变化时重建约 10 毫秒,同一请求里其余几次读取用缓存(按当前记录数组、记录数和 `since` 判断)。- 先算好要补哪些,再跑 v0.4 的改写,最后补图;面板统计里 `compacted` 记下补了哪几张(`resent`),面板的“上一次请求”写“补回压缩前的图 N 张”。- 面板里压缩前的图照常可勾,标“压缩前”;请求预估把勾着的算作这次加上的。- 补图改的是摘要之后的内容,之后产生的思考按上面“思考记录”的做法处理;新账号(模拟)上实测对话不中断。diff --git a/docs/spec.md b/docs/spec.mdindex e907893..d15f9a4 100644--- a/docs/spec.md+++ b/docs/spec.md@@ -1,6 +1,6 @@# 规格:Context Attachment Manager(上下文素材管理器)-> 本文件是目标、范围、约束和验收标准的唯一事实来源(2026-09-24 经用户、Claude、Codex 三方确认),描述当前版本 v0.9.0,以后随版本更新。v0.4 加的 Claude 桌面 Code 接入,相关内容都标着“v0.4”;它的关卡、任务和验收步骤见 [v0.4/](v0.4/)。v0.5 加的 Claude Code 压缩后保留图片标着“v0.5”,方案和实测见 [v0.5/plan.md](v0.5/plan.md)。v0.6 的默认开启自动选图和 Claude 桌面版自动打开面板标着“v0.6”,见 [v0.6/plan.md](v0.6/plan.md)。v0.7 的 Codex 子代理和旁聊也自动选图标着“v0.7”,见 [v0.7/plan.md](v0.7/plan.md)。v0.8 的特征行(压缩后照样拿对图)和重做的面板(凭印象找图)标着“v0.8”,见 [v0.8/plan.md](v0.8/plan.md)。v0.9 把两平台的服务线路分开,并接管兼容中转;技术做法见 [design.md](design.md) 第 2、5、12 节。项目 2026-10-11 由 Codex Attachment Manager 改名,因为不再只给 Codex 用(用户定);安装用的标识(`codex-attachment-manager`)和数据目录不变,已装的用户照常升级。+> 本文件是目标、范围、约束和验收标准的唯一事实来源(2026-09-24 经用户、Claude、Codex 三方确认),描述当前版本 v0.9.0,以后随版本更新。v0.4 加的 Claude 桌面 Code 接入,相关内容都标着“v0.4”;它的关卡、任务和验收步骤见 [v0.4/](v0.4/)。v0.5 加的 Claude Code 压缩后保留图片标着“v0.5”,方案和实测见 [v0.5/plan.md](v0.5/plan.md)。v0.6 的默认开启自动选图和 Claude 桌面版自动打开面板标着“v0.6”,见 [v0.6/plan.md](v0.6/plan.md)。v0.7 的 Codex 子代理和旁聊也自动选图标着“v0.7”,见 [v0.7/plan.md](v0.7/plan.md)。v0.8 的特征行(压缩后照样拿对图)和重做的面板(凭印象找图)标着“v0.8”,见 [v0.8/plan.md](v0.8/plan.md)。v0.9 把两平台的服务线路分开,并接管兼容中转;技术做法见 [design.md](design.md) 第 2、5、12 节。v0.10(待发布)让两个平台在压缩之后(Claude 还包括续接之后)照样拿回之前的图,标着“v0.10”,见 [v0.10/plan.md](v0.10/plan.md)。项目 2026-10-11 由 Codex Attachment Manager 改名,因为不再只给 Codex 用(用户定);安装用的标识(`codex-attachment-manager`)和数据目录不变,已装的用户照常升级。> 技术方案见 [design.md](design.md)。v0.1 的开发记录(原方案、任务记录、各阶段报告、最初的构想)归档在 [history/v0.1/](history/v0.1/),只作参考。## 1. 目标@@ -24,6 +24,7 @@ v0.4:同样的管理也用在 Claude 桌面应用的 Code 标签页里(本- 这些记录写成 Markdown 链接定义 `[//]: # (cam IMG-015 深蓝雨夜|近景,正脸)`,放在模型最后那条回复的开头,Codex 和 Claude 的桌面版都不显示;模型在正文里也不提这件事。- 引擎和插件服务只从模型自己的回复里读这些记录,用户消息和工具结果里同样的字不算。特征行和评价写进这张图的占位符(见“占位符”),对话压缩之后模型照样认得出每张图;面板只拿它们来搜索和分组,不显示。- 升级之前已有的图不补写。子代理和旁聊不写,Codex 手动模式在第一次取消勾选之前也不写(见“选择规则”)。+ - v0.10(用户 2026-10-31 采纳):写错的特征行可以更正:模型照同样的格式整行重写,开头加“更正:”(英文 “corrected:”),替换原来那一行。用户中途打断、模型还没写特征行的那一轮,里面的新图在下一轮照常再发一次(标签写“已提供,还没有特征行”),让模型补写;之后有一轮正常结束,就不再追。- **来源**:每条出现记录属于一类来源:用户上传、PDF 页面、网页截图、查看的图片、工具返回、生成的图片。PDF 页面和网页截图是用户在 Codex 桌面版里给 PDF 或网页加评论时,Codex 随消息附上的截图,靠 Codex 写在图前面的固定说明认出(例如 “The next image shows PDF page 3 at the time of Comment 1.”)。PDF 页面记下页码;同一条消息只提到一个 PDF 时,再记下文件名。认不出的仍算用户上传(v0.2,用户 2026-09-29 定:只做认得准的来源)。### 免配置@@ -58,11 +59,14 @@ v0.9(用户 2026-10-23 定):两平台使用兼容中转时,图片照样- 模型需要看被省略的图时,调用取图工具、传入编号,原图随工具结果回到这一轮;下一轮又换回占位符,还要就再取。- 取回的图放在这一轮末尾,不放回原来的位置:原来的占位符不变,前面的历史一个字节都不变,不影响缓存。- 关着时,选择规则和 v0.2 完全一样。+ - v0.10:被打断那一轮里还没有特征行的图是例外,见“核心概念”里的特征行。+- Codex 压缩之后(v0.10,用户 2026-10-31 定):Codex 自己压缩任务时只留下用户消息,工具查看、生成或返回的图连占位一起从请求里消失。引擎把它们按编号放回压缩项后面:每轮都发的(手动模式下是勾着的)发原图,其余的一张一行,写编号、名称、来源、轮次和模型记下的特征与评价(见“占位符”);前面一条开发者消息说明这些图当时真实存在、之前的描述仍然有效、怎么取回。用户上传的图本来就在,照旧。面板上这些图标“压缩前”。+- Claude 续接和分叉(v0.10):Claude 桌面版每次重启 Claude Code 进程都会续接成一个新会话,分叉也是新会话。新会话还没有自己的勾选时,沿用它接着的那个会话的勾选、每轮都发和自动选图开关(只沿用续接或分叉那一刻之前的);之后各管各的。### 占位符- **普通占位符**:第一行是编号、名称、来源、所在轮次和尺寸;最后一行提示需要时回复“需要 IMG-004”。v0.8 起这一句缩短成“需要重看时,在回复里写“需要 IMG-004”。”,抵掉特征行增加的字数(用户 2026-10-18 定)。-- **占位符里的特征行**(v0.8):模型给这张图记过特征行或评价时,第一行后面多一行,例如“特征:深蓝雨夜|近景,正脸;评价:第 4 轮“脸最好”,第 6 轮“太暗””。评价按时间累积,只显示最近 3 条,不排序,也不替用户判断褒贬;超长时在上限以内最后一个标点处截断,加“…”。索引里记什么,占位符里就显示什么。照常发送的图只带编号标签,不带特征行:模型看得到原图,不带也免得每轮去改前面的标签、弄断缓存。+- **占位符里的特征行**(v0.8):模型给这张图记过特征行或评价时,第一行后面多一行,例如“特征:深蓝雨夜|近景,正脸;评价:第 4 轮“脸最好”,第 6 轮“太暗””。评价按时间累积,只显示最近 3 条,不排序,也不替用户判断褒贬;超长时在上限以内最后一个标点处截断,加“…”。上限按宽度算,和界面语言无关:特征 30 个汉字或 100 个字母,评价 15 个汉字或 50 个字母(v0.10;原来按界面语言数字符,中文界面里模型写的英文特征行被截到只剩地点,一个真实会话里 180 条有 51 条截完和别的行一样)。索引里记什么,占位符里就显示什么。照常发送的图只带编号标签,不带特征行:模型看得到原图,不带也免得每轮去改前面的标签、弄断缓存。- **特征行说明**(v0.8,用户 2026-10-19 定措辞):从第一张图所在的那一轮起,插入一条说明,告诉模型怎么写特征行、怎么记评价:- 记录行写在每一轮最后那条回复的开头(不写在中途调用工具时说的话里),一张图一行,和正文之间空一行;这一轮没有新图、也没有评价时不写;- 用户装这个工具,是为了让模型以后(包括压缩之后)还能认出每张图、记得用户的评价;这些行只给工具读,用户在界面上看不到,正文照常回答,不提这些行,也不回应记录这件事(不说“记下了”);用户只是评价、没提要求时,正文简短回应评价本身;@@ -77,6 +81,8 @@ v0.9(用户 2026-10-23 定):两平台使用兼容中转时,图片照样- **为什么放在开发者消息里**:用户 2026-09-25 发现,占位符放在原图的位置,模型会以为自己从没看过那张图,于是收回之前看着原图做出的正确回答。把这些说明写在占位符里也没用:占位符属于用户内容,模型不把它当成证据。改成开发者消息后,两次自测都不再收回(见 [history/v0.1/tasks.md](history/v0.1/tasks.md))。- **重复占位符**:包含编号、名称、来源、所在轮次和尺寸,说明它和哪一条(编号、名称、轮次)内容完全相同,那一条照常提供,请参考那一条。内容仍然看得到,不需要上面的说明。- **“已提供”标签**:一次请求里只要有图被换掉,每张仍在发送、有编号的图前面都加一行标签,写法和占位符的第一行一样,状态是“已提供”,例如“[图片 IMG-002([Image #2]) 已提供|名称|来源|第 1 轮|尺寸]”。原因:用户 2026-09-28 发现,重新勾选的图回到原来的位置、夹在占位符中间,而 Codex 自己的“[Image #2]”在每条消息里都从 1 开始,模型对不上编号,就说看不到。没有图被换掉时不加,请求照旧原样转发。v0.8:写特征行的任务里,每张发送的图都带这个标签,这一轮的新图也带,模型才能当场对上编号;新图在它那一轮的第一个请求里就已经有编号(Codex 和 Claude 都先把新图写进本机记录,再发请求,2026-10-19 实测)。这一轮新图的标签只影响请求的末尾,不弄断缓存。+- **压缩后放回的清单**(v0.10):压缩之后放回请求、又不发原图的图,不再一张一个占位,而是合成一份清单,一张一行,例如“IMG-101|alley_v2.png|查看|第 66 轮|雨后小巷|路面反光局部|评价:第 70 轮“太空了””(没有名字的写“-”),清单第一行说明这是压缩之前的图、这次没有附原图,以及各列是什么。怎么取回只在说明里讲一次,说明里也不再把这些图列一遍。原因:一个有 127 张压缩前图片的真实会话,照原来每张一个占位、说明里再列一遍的写法,每条请求多 1.3–1.9 万 token;清单加说明约 0.5–0.7 万(用户 2026-10-31 定)。+- **“已提供,还没有特征行”标签**(v0.10):被打断那一轮里还没有特征行、这一轮再发一次的图,标签的状态写“已提供,还没有特征行”(英文 “included, no feature line yet”),特征行说明里告诉模型给它补一行。- 占位符里不写本地路径。Codex 附在上传图片前后的路径标签,也一起换掉。- PDF 页面和网页截图被取消时,占位符和用户上传的图一样,来源写“用户上传”;Codex 写在图前面的那句说明原样保留,模型仍然知道那是哪一页(v0.2,用户 2026-09-29 定:不改发给模型的文字)。- 勾选状态不变时,占位符和说明的文字、位置每次都一样,不影响缓存。v0.8:后来加的评价会让那张图的占位符变一次,缓存从那里往后断一次,和改一次勾选一样。@@ -163,10 +169,12 @@ v0.9(用户 2026-10-23 定):两平台使用兼容中转时,图片照样- 没有 Codex 特有的“启用插件 / 停用插件”按钮和新任务绑定;v0.8 起也没有子代理和旁聊那一行,没有 PDF 和网页的角标;压缩前的图照样标“压缩前”(用户 2026-10-19 定:Claude 桌面版用同一个面板)。- 语言跟着插件,和发给模型的说明一致,不跟着浏览器。- **取图工具**:模型调用 `cam_view_image` 不弹权限确认,和 Codex 版的自动批准一样;用户自己的钩子或设置拒绝、或要求询问时,照旧按它们来(用户 2026-10-10 同意)。-- **压缩之后**(v0.5,用户 2026-10-12 定):Claude Code 压缩对话(手动 `/compact` 或自动压缩)时,把旧历史换成一段摘要,压缩前的图不再发给模型。Codex 没有这个问题,不变。+- **压缩之后**(v0.5,用户 2026-10-12 定):Claude Code 压缩对话(手动 `/compact` 或自动压缩)时,把旧历史换成一段摘要,压缩前的图不再发给模型。Codex 的做法见“选择规则”里的“Codex 压缩之后”(v0.10)。- 压缩前的勾选照样有效:勾着的图(开着自动选图时是每轮都发的图)照样发给模型,取消的照样不发;用户随时可以改,从下一条消息起生效。原图从本地会话记录里读,不另存一份。- - 位置:压缩前的图按编号排在摘要后面(摘要所在的那条用户消息里):照样发的带“已提供”标签和原图,不发的是占位文字,和别处一样。勾选不变时这一段逐字节相同,缓存能续上。- - 说明:摘要那条消息后面跟一条系统消息,列出压缩前的全部图片,说清哪些这次没发、怎么要回(手动时写“需要 IMG-xxx”,自动选图时用 `cam_view_image`);有图没发时,前面是完整的“上下文管理说明”,后面消息里的占位文字只再跟一段短说明。说明放在消息里面时模型不信,会收回之前看着原图做出的回答(2026-10-12 实测),所以和 v0.4 一样放在系统消息里。+ - 位置:压缩前的图放在摘要后面(摘要所在的那条用户消息里):照样发的带“已提供”标签和原图;不发的,v0.10 起合成一份清单,一张一行(见“占位符”),v0.5 到 v0.9 是每张一个占位。勾选不变时这一段逐字节相同,缓存能续上。+ - 说明:摘要那条消息后面跟一条系统消息,说清摘要之前有多少张图(v0.10 起只写数量和编号范围,不再列一遍)、哪些这次没发、怎么要回(手动时写“需要 IMG-xxx”,自动选图时用 `cam_view_image`);有图没发时,前面是完整的“上下文管理说明”,后面消息里的占位文字只再跟一段短说明。说明放在消息里面时模型不信,会收回之前看着原图做出的回答(2026-10-12 实测),所以和 v0.4 一样放在系统消息里。+ - 压缩时保留的消息(v0.10):Claude Code 2.1.304 起压缩时原样保留最后几条消息,读记录时把它们接到摘要后面;插件照同样的规则连对话链,压缩前的历史照旧算“压缩前”。之前插件按文件里的原样连,有的压缩认不出来,压缩前的图一张都没放回(2026-10-31 真实会话:94 张)。+ - 续接之后(v0.10):Claude 桌面版续接后的新会话,记录文件从最近一次压缩开始,前面的历史在压缩发生的那个记录文件里。插件顺着摘要里 Claude Code 写的原记录路径(找不到时,在同一个项目文件夹里找含同一个压缩点的记录)一层层接回去:编号和续接前一样,压缩前的图照样放回,旧文件只读,里面的图片数据用到时再从文件读。修复之前,续接后编号从头重排,按旧编号写下的特征行和评价会挂到别的图上;这些记录行按“当时写它的进程用的编号”换算回来(这个版本第一次运行之后写的不用换算)。- 不替用户做决定:不做自动保护。补回的图太多、请求被拒或 Claude Code 又压缩时,由用户少勾几张或切到自动选图。Claude Code 自己的上下文用量显示不含补回的图,Anthropic 返回的用量含。### 为后续扩展预留@@ -199,6 +207,10 @@ v0.1 到 v0.3 都不做下面这些。其中音频和其他语言已确认是后- 给升级前已有的图补写特征行;- Codex 手动模式下,第一次取消勾选之前写特征行(以后可以研究直接在 WebSocket 上加说明和编号);- 子代理和旁聊写特征行:它们的图不在主任务的面板里,存在的时间也短;旁聊的占位符照样显示原任务里的特征行。+- v0.10 也不做(用户 2026-10-31 定):+ - 生成时交给生图工具哪些参考图:不归插件管;+ - 改检索算法(独立的检索模块、字段化标签等):真实会话里模型按编号选图很准,先修压缩和续接,修完以后小规模回放,哪里错了再针对改;+ - 浏览器和电脑操作截图的专门规则(例如同一轮只发最近几张):另议。- 所有 agent 平台通用的版本(用户 2026-10-18 定:先不做):只有自动选图、不带面板,任何多模态 agent 客户端都能装,压缩后也能准确找回图片。原因:- 省略旧图要让引擎站在客户端和模型 API 之间,只有允许改 API 地址的客户端接得进来,闭源客户端一般接不进。MCP 只能给模型加取图工具,不能从客户端发出的历史里删图。- 每接一个客户端,都要单独适配它的请求格式、分轮方式和本地记录;编号和压缩后准确找回都靠读它的本地记录。@@ -215,7 +227,7 @@ v0.1 到 v0.3 都不做下面这些。其中音频和其他语言已确认是后- 真实数据不进仓库:从真实会话和用户素材里提取的图片、记录片段、日志和备份,只能放在本机,开发时放在 `local/` 目录(已被 git 忽略),装好的插件放在数据目录(Windows 是 `%USERPROFILE%\.codex-attachment-manager`,macOS 是 `~/Library/Application Support/codex-attachment-manager`,Linux 是 `~/.local/share/codex-attachment-manager`);任何时候都不提交。仓库里的样例数据只能是合成的或脱敏的。Windows 的数据目录 2026-09-25 从 `%LOCALAPPDATA%` 下挪出来(用户同意):Codex、Claude 这类微软商店应用启动的程序在 AppData 里新建的文件,会被转存到各应用的私有目录,插件服务、引擎和命令行看到的数据就不一样了。- 仓库里的文档和代码不写用户本机的具体路径(例如个人项目文件夹)。`~/.codex`、`%LOCALAPPDATA%` 这类通用位置可以写。本项目以后会开源。- 不改写原生任务的历史记录。-- 代理只替换用户取消的图片,连同 Codex 附在它前后的路径标签;自动选图开着时,还替换之前各轮没有勾“每轮都发”的图(v0.3)。有图片被省略时,另外插入一条“上下文管理说明”开发者消息(用户 2026-09-25 要求告诉模型原因,见第 1 节“占位符”),并在仍发送的图前面加“已提供”标签(v0.1-25)。v0.8:写特征行的任务里,还插入一条“特征行说明”,每张发送的图都带“已提供”标签,占位符里带着模型记下的特征行和评价(见第 1 节“占位符”)。请求里的其他内容原样转发。v0.4:Claude 的请求里,说明是系统消息(位置见第 1 节“Claude Code(v0.4)”);思考块原样转发,只在账号拒绝时去掉对不上的那些,不关掉思考(用户 2026-10-11 定)。v0.5:Claude Code 压缩之后,引擎还把压缩前的图从本地会话记录里取出来,补在摘要后面(用户勾选或每轮都发的发原图,其余放占位文字),并跟一条说明(用户 2026-10-12 定,见第 1 节“压缩之后”)。这是唯一往请求里加图的地方,其余内容仍原样转发。+- 代理只替换用户取消的图片,连同 Codex 附在它前后的路径标签;自动选图开着时,还替换之前各轮没有勾“每轮都发”的图(v0.3)。有图片被省略时,另外插入一条“上下文管理说明”开发者消息(用户 2026-09-25 要求告诉模型原因,见第 1 节“占位符”),并在仍发送的图前面加“已提供”标签(v0.1-25)。v0.8:写特征行的任务里,还插入一条“特征行说明”,每张发送的图都带“已提供”标签,占位符里带着模型记下的特征行和评价(见第 1 节“占位符”)。请求里的其他内容原样转发。v0.4:Claude 的请求里,说明是系统消息(位置见第 1 节“Claude Code(v0.4)”);思考块原样转发,只在账号拒绝时去掉对不上的那些,不关掉思考(用户 2026-10-11 定)。v0.5:Claude Code 压缩之后,引擎还把压缩前的图从本地会话记录里取出来,补在摘要后面(用户勾选或每轮都发的发原图,其余放占位文字,v0.10 起是一份一张一行的清单),并跟一条说明(用户 2026-10-12 定,见第 1 节“压缩之后”)。v0.10:Codex 压缩之后,引擎同样把它没保留的图放回压缩项后面(每轮都发或勾着的发原图,其余写进清单),前面一条开发者消息说明(见第 1 节“选择规则”);被打断那一轮里还没有特征行的图,下一轮再发一次。往请求里加图只有这几处,其余内容仍原样转发。- 选择权在用户:默认只由用户在面板里勾选决定,工具和模型都不能自动勾选或取消;模型只能按约定索要(例如回复“需要 IMG-004”),给不给由用户决定。用户给某个任务打开“自动选图”后,之前各轮的图默认不发,由模型用取图工具按编号取回需要的图,只在这一轮有效;模型不能改用户的勾选,也不能替用户开关自动选图(v0.3,用户 2026-10-06 定,取代原来的“选择权永远在用户”)。v0.6 起新任务和新会话默认开着自动选图,用户随时可以关(用户 2026-10-13 定)。v0.7 起 Codex 任务的子代理和旁聊也默认按自动选图管(用户 2026-10-13 定),v0.8 起一律如此、不再有开关(用户 2026-10-19 定)。v0.8:模型按特征行说明写的记录只是它回复里的文字,改不了勾选;面板也不让模型改。- 先在 Windows 上开发和测试。技术栈:TypeScript/Node。macOS、Linux 由 CI 验证能装上、能启动;这两个平台桌面版上的实测,等用户在 GitHub 上反馈(用户 2026-09-25 定)。- 交付形态:Codex 插件。插件带一个本地 MCP 服务,负责拉起引擎、提供面板;仓库根目录就是插件市场。面板位置见第 1 节“界面”。@@ -328,6 +340,17 @@ v0.1 之前的阶段验收(阶段 0 的重建路线、代理路线 P2)都已6. 单独更新一个平台、引擎更新重启时,已登记线路不会落入旧引擎的默认转发;新进程能继续读取已有绑定。7. Windows 上旧插件目录被运行中的进程占用时,升级不会留下缺失的旧运行文件;新副本能启动,卸载后配置恢复。macOS、Linux 的安装、升级、启动检查由 CI 验证。+### v0.10++> 用户 2026-10-31 定,方案、关卡和实测见 [v0.10/plan.md](v0.10/plan.md)。++1. Claude:压缩当场和续接之后(包括多次续接、分叉),压缩前的图都放回在摘要后面,编号和续接前一样;老会话里按重排编号写下的特征行和评价,换算后落在对的图上。用户的真实会话只读回放验证。+2. Claude:续接和分叉出来的会话沿用上一个会话的勾选。+3. Codex:压缩之后,工具查看、生成的图带着编号、特征行和评价回到请求里,模型能靠清单拿对,要看原图时按编号取对。+4. 压缩后放回的那一段用紧凑清单:130 张图的会话多出的不超过请求的约 8%(原定 6%,英文特征行不再截短后约 6%–8%,待用户确认);往回读旧记录时,最长的真实会话引擎堆内存多不超过 80 MB,第一次建索引不超过 2 秒。+5. 写错的特征行能更正;被打断那一轮里还没有特征行的图,下一轮再发一次让模型补写。+6. 原有测试和自测不退化(gpt-6-sol,中英文);Claude 桌面版用 `/compact` 再续接实测一次。+## 5. 待定问题- 在插件页面移除或关掉插件、没先在面板里停用时,代理设置还在:diff --git a/docs/v0.10/plan.md b/docs/v0.10/plan.mdindex 2d136b0..26b221f 100644--- a/docs/v0.10/plan.md+++ b/docs/v0.10/plan.md@@ -1,6 +1,6 @@# v0.10 方案:压缩和续接之后,照样拿回之前的图-> 状态:草案,Claude 2026-10-31 写,待用户确认。起因是用 5 个真实会话评估图片检索(会话内容只在本机,不进仓库)。规格仍以 [spec.md](../spec.md) 为准,方案确认后再改 spec 和 design。+> 状态:用户 2026-10-31 确认方案,让 Claude 按自己的安排做完(第 8 节)。代码和单元测试已完成,spec 和 design 已改;关卡 1–4 用本机回放验证通过,关卡 6 只有估算,关卡 5、7 的模型自测因为 Codex 用量到了上限没跑成,Claude 桌面的 `/compact` 实测要用户手动触发。这几项通过之前不发布。起因是用 5 个真实会话评估图片检索(会话内容只在本机,不进仓库)。规格以 [spec.md](../spec.md) 为准,实现见 [design.md](../design.md)。## 1. 背景与目标@@ -48,13 +48,14 @@### 两边-6. **紧凑写法**(只用于压缩后放回的那一段):一张图一行,写编号、名称、特征行和最近 3 条评价;怎么取图在说明里讲一次,说明里不再把图列第二遍。- - 原因:原来每个占位都重复一句“需要原图时调用 cam_view_image…”,说明里又把全部图列一遍。一个有 130 张压缩前图片的真实会话,照原写法每条请求要多 1.3–1.9 万 token(约占请求的 15%–20%);紧凑写法约 0.4–0.5 万。+6. **紧凑写法**(只用于压缩后放回的那一段):一张图一行,写编号、名称、来源、轮次、特征行和最近 3 条评价,例如“IMG-041|exec-….png|查看|第 28 轮|海边栈道|半身中景,白衬衫,回头|评价:第 29 轮“光太硬了””,没有名字的写“-”,清单第一行说明各列;怎么取图在说明里讲一次,说明里不再把图列第二遍。+ - 原因:原来每个占位都重复一句“需要原图时调用 cam_view_image…”,说明里又把全部图列一遍。一个有 127 张压缩前图片的真实会话,照原写法每条请求要多 1.3–1.9 万 token(约占请求的 15%–20%);紧凑写法加说明约 0.5–0.7 万(见关卡 6)。- 别处的占位(图在原位被省略的)不变。-7. **补写和更正特征行**(用户 2026-10-31 采纳了方向,做法待定,见第 8 节):- - 补写:被打断的那一轮,新图没写上特征行。+7. **补写和更正特征行**(用户 2026-10-31 采纳了方向,做法见第 8 节):+ - 补写:被打断的那一轮,新图没写上特征行。被打断那一轮里还没有特征行的图,下一轮再发一次,标签写“已提供,还没有特征行”。- 更正:模型发现特征行写错了(比如用户指出),写一行 `[//]: # (cam IMG-005 更正:…)`,替换原来的特征行。- 这一条改的是特征行说明,按 AGENTS.md 跑自测。+8. **截断按宽度算**(做的时候回放发现,Claude 定):特征行和评价超长时,原来按界面语言数字符截断(中文 30、英文 100),中文界面里模型写的英文特征行被截到只剩地点。第 6 条那个会话的 180 条特征行里 91 条是英文,全被截成“cafe storefront morning |…”这样,51 条截完和别的行一模一样;压缩之后清单是模型看到这些特征的唯一地方,它就分不清这些图。改成按宽度算,和界面语言无关:中日韩文字一个算 1,其他字符算 0.3,特征 30、评价 15,也就是 30 个汉字或 100 个字母。截完相同的从 51 条降到 6 条(127 张里能分开的特征行从 76 条升到 105 条),放回的一段多约 0.13–0.15 万 token。原位的占位用的是同一个截断,也跟着变。## 3. 要先验证的事(关卡)@@ -62,15 +63,22 @@1. **改接覆盖到的格式**:`preservedSegment` 和 `preservedMessages`,新消息接在保留消息上、接在摘要上两种形状。用合成记录,再加真实记录回放(本机,结果只放 `local/`):压缩前的图都认出来,编号和原始文件一致。- 原型(2026-10-31,没改插件,只在内存里改接后交给现有的索引代码):一次真实压缩从认出 0 张变成 94 张。+ - 结果(最终代码,2026-10-31 回放):通过。那次压缩认出 94 张;两个真实会话(6 个、3 个记录文件)里,同一张图在每个文件里的编号都一样(0 处不同)。2. **往回接**:摘要里的路径、按压缩点找、往回两层、分叉、原文件不在。真实回放:编号和原始文件一致,特征行一条不挂错。- 原型:续接一层和两层都接上了,压缩前的图编号、特征行和原始文件里一样。+ - 结果:通过。最长的会话 210 张图,压缩前的 127 张都接回来了,编号和原始文件一致;抽查原来挂错的特征行,都回到了对的图;17 个取回副本都认回原图(原型里有 9 张被当成新图)。3. **换算**:真实回放里,换算过的特征行中“写下的轮次等于图出现的轮次”的比例,不低于从没被打乱过的那段,并且抽查无误。- 原型:换算的 80 条里 73 条一致;从没被打乱过的那段是 103 条里 71 条,不一致的都是晚了 1–4 轮才写(后台任务完成算新的一轮)。约 3 条(2%)明显不对,要查清。+ - 结果:通过。换算过的 77 条里 73 条写在图出现的那一轮,4 条晚 1–4 轮;从没被打乱过的 103 条里 71 条、晚的 32 条;没有挂错的。原型里那 3 条“明显不对”的,是同一个文件前后看了两次、模型两次写了一样的特征行,统计时按文字找到了前一次,不是换算错。4. **内存和时间**:最长的真实会话(9 个记录文件、219 张图),引擎的堆内存比现在多不超过 80 MB;第一次建索引不超过 2 秒;之后每条请求的改写,耗时不超过现在的两倍。- 原型照原样读:堆内存从 83 MB 到 268 MB,多出的几乎都是旧文件里的图片数据,所以要改成用到时再从文件读(发原图、取图、面板缩略图时)。第一次建索引 1.7 秒,之后每条请求 9–12 毫秒(现在 6 毫秒)。+ - 结果:通过。旧文件只留压缩点之前带 uuid 的记录,图片数据留在磁盘上、用到时再读:堆内存 83 → 145 MB(多 62 MB),第一次建索引 1.8 秒;每条请求重建约 10 毫秒,同一请求里再读走缓存,约 0.5 毫秒(现在是每次都建,3 次共约 6 毫秒)。5. **Codex 放回的位置**:压缩项后面能不能插;插成开发者消息还是用户消息,模型才把它当真;连续两次请求里这一段逐字节相同,缓存接得上。用 app-server 的 `thread/compact/start` 做探针验证。+ - 结果:未完成。按真实压缩记录重建的请求(本机回放)和单元测试里,放回的一段在压缩项后面(说明是开发者消息,原图在后面一条用户消息里),两次请求逐字节相同。探针(`spike/src/v10-compaction-selftest.ts`)没跑成:Codex 用量到了上限,2026-11-04 15:35 恢复。6. **token**:实测压缩后的请求,按 API 返回的用量算,不按估算。130 张图的 Claude 会话多出的不超过请求的约 6%,33 张图的 Codex 任务不超过约 3%。+ - 结果:只有估算(按字数估的 token,不是 API 返回的用量)。Claude 那个 127 张的会话,放回的一段约 5.4–7.3 千 token(清单 4.4–5.8 千、说明 1.0–1.5 千),约占请求的 6%–8%,比上限高,高出的部分来自第 2 节第 8 条(英文特征行不再截短);Codex 那个 33 张的任务约 1.2–1.7 千,约占 3%–4%。实测用量等桌面实测和自测。7. **模型照样会取、取对**:改成紧凑写法、放回之后,Codex 自测(gpt-6-sol,推理强度 low),Claude 桌面测试会话(Haiku 5.5),中英文都测。+ - 结果:未完成。10 组自测(新的 v10-compaction 和 v08-features、v01-placeholder、v01-needs、v03-auto,各中英文)都因 Codex 用量上限(HTTP 429)没跑成,建的测试任务都已归档;Claude 桌面实测要用户在测试会话里手打 `/compact`。## 4. 做法@@ -116,6 +124,12 @@## 8. 待用户定-1. 第 2 节第 7 条的补写怎么做:被打断那一轮的新图,下一轮照常再发一次,让模型补写特征行(多花一轮这几张图的 token);还是不补。-2. 第 2 节第 6 条:别处原位的占位要不要也改短。这次只改压缩后放回的那一段。+用户 2026-10-31 让 Claude 按自己的建议定了前三条:++1. 第 2 节第 7 条的补写:被打断那一轮的新图,下一轮再发一次,让模型补写特征行(多花一轮这几张图的 token)。+2. 第 2 节第 6 条:别处原位的占位不改短,这次只改压缩后放回的那一段。3. 截图的规则:另议。++还要用户定:++4. 关卡 6:英文特征行不再截短以后,Claude 的估算是 6%–8%,超过原定的 6%。Claude 的建议是接受,因为多出的约 0.15 万 token 换来 29 张图能互相分开;不接受的话,第 2 节第 8 条改回按字符截断。