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.10): raise Codex's put-back cap to 4%

chipfighterd25f0eb183a0
diff --git a/docs/spec.md b/docs/spec.md
index e6ad1d7..3b2288e 100644
--- a/docs/spec.md
+++ b/docs/spec.md
@@ -347,7 +347,7 @@ v0.1 之前的阶段验收(阶段 0 的重建路线、代理路线 P2)都已
1. Claude:压缩当场和续接之后(包括多次续接、分叉),压缩前的图都放回在摘要后面,编号和续接前一样;老会话里按重排编号写下的特征行和评价,换算后落在对的图上。用户的真实会话只读回放验证。
2. Claude:续接和分叉出来的会话沿用上一个会话的勾选。
3. Codex:压缩之后,工具查看、生成的图带着编号、特征行和评价回到请求里,模型能靠清单拿对,要看原图时按编号取对。
-4. 压缩后放回的那一段用紧凑清单:130 张图的会话多出的不超过请求的约 8%(原定 6%,英文特征行不再截短后用户同意放宽);往回读旧记录时,最长的真实会话引擎堆内存多不超过 80 MB,第一次建索引不超过 2 秒。
+4. 压缩后放回的那一段用紧凑清单:130 张图的 Claude 会话多出的不超过请求的约 8%,33 张图的 Codex 任务不超过约 4%(原定 6% 和 3%,用户看了估算后放宽);往回读旧记录时,最长的真实会话引擎堆内存多不超过 80 MB,第一次建索引不超过 2 秒。
5. 写错的特征行能更正;被打断那一轮里还没有特征行的图,下一轮再发一次让模型补写。
6. 原有测试和自测不退化(gpt-6-sol,中英文);Claude 桌面版用 `/compact` 再续接实测一次。
diff --git a/docs/v0.10/plan.md b/docs/v0.10/plan.md
index 7d28f34..d8e100a 100644
--- a/docs/v0.10/plan.md
+++ b/docs/v0.10/plan.md
@@ -75,8 +75,8 @@
- 结果:通过。旧文件只留压缩点之前带 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 会话多出的不超过请求的约 8%(原定 6%,英文特征行不再截短后用户同意放宽,见第 8 节第 4 条),33 张图的 Codex 任务不超过约 3%。
- - 结果:只有估算(按字数估的 token,不是 API 返回的用量)。Claude 那个 127 张的会话,放回的一段约 5.4–7.3 千 token(清单 4.4–5.8 千、说明 1.0–1.5 千),约占请求的 6%–8%,超过 6% 的部分来自第 2 节第 8 条(英文特征行不再截短)。Codex 那个 33 张的任务约 1.2–1.7 千(说明 0.24–0.34 千、清单 0.98–1.33 千),压缩后第一条真实请求是 44,893 token,约占 2.7%–3.7%,可能略超上限,见第 8 节第 5 条。实测用量等桌面实测和自测。
+6. **token**:实测压缩后的请求,按 API 返回的用量算,不按估算。130 张图的 Claude 会话多出的不超过请求的约 8%(原定 6%,英文特征行不再截短后用户同意放宽,见第 8 节第 4 条),33 张图的 Codex 任务不超过约 4%(原定 3%,用户同意放宽,见第 8 节第 5 条)。
+ - 结果:只有估算(按字数估的 token,不是 API 返回的用量)。Claude 那个 127 张的会话,放回的一段约 5.4–7.3 千 token(清单 4.4–5.8 千、说明 1.0–1.5 千),约占请求的 6%–8%,超过 6% 的部分来自第 2 节第 8 条(英文特征行不再截短)。Codex 那个 33 张的任务约 1.2–1.7 千(说明 0.24–0.34 千、清单 0.98–1.33 千),压缩后第一条真实请求是 44,893 token,约占 2.7%–3.7%,超过 3% 的部分主要是编号式的文件名(第 8 节第 5 条)。实测用量等桌面实测和自测。
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`。
@@ -122,15 +122,12 @@
5. 自测和桌面实测通过,原有测试不退化。
6. 公开评测发布到 `eval/`。
-## 8. 待用户定
+## 8. 用户的决定
-用户 2026-10-31 让 Claude 按自己的建议定了前三条,第 4 条是用户看了估算后定的:
+用户 2026-10-31 让 Claude 按自己的建议定了前三条,第 4、5 条是用户看了估算后定的:
1. 第 2 节第 7 条的补写:被打断那一轮的新图,下一轮再发一次,让模型补写特征行(多花一轮这几张图的 token)。
2. 第 2 节第 6 条:别处原位的占位不改短,这次只改压缩后放回的那一段。
3. 截图的规则:另议。
4. 关卡 6 的 Claude 部分:英文特征行不再截短以后,估算是 6%–8%,超过原定的 6%。用户接受,上限改成约 8%:多出的约 0.15 万 token 换来 29 张图能互相分开。
-
-还要用户定:
-
-5. 关卡 6 的 Codex 部分:估算 2.7%–3.7%,上限是约 3%,可能略超。多出的主要是 15 行里 `exec-<uuid>.png` 这样由一串编号组成的文件名(9 个不同的名字),约 0.17–0.34 千 token;压缩后保留的对话里这些名字一个都没再出现,模型拿它们对不上任何东西。Claude 的建议是清单里这类文件名写成“-”,放回段降到约 2.3%–3.3%,上限不动;Claude 那个 127 张的清单里没有这类名字,不受影响。另一个办法是上限放宽到约 4%,名字照留。
+5. 关卡 6 的 Codex 部分:估算 2.7%–3.7%,超过原定的约 3%。多出的主要是 15 行里 `exec-<uuid>.png` 这样由一串编号组成的文件名(9 个不同的名字),约 0.17–0.34 千 token;压缩后保留的对话里这些名字一个都没再出现。用户选了上限放宽到约 4%,名字照留。另一个办法是清单里把这类名字写成“-”(约 2.3%–3.3%),没有采用。