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: 添加规格、技术方案和阶段 0 任务清单

chipfighterac149d99d571
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..19798a5
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,5 @@
+node_modules/
+dist/
+
+# 真实会话数据、提取的图片、日志和备份只留在本机
+local/
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..edcea9d
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,19 @@
+# AGENTS.md
+
+Codex 上下文素材管理器(暂名):让用户逐轮决定,Codex 任务里的哪些图片和文件进入下一轮请求。
+
+## 从哪里读起
+
+- [docs/spec.md](docs/spec.md):目标、范围、硬约束和验收标准,是唯一的事实来源。
+- [docs/plan.md](docs/plan.md):技术方案。
+- [docs/tasks.md](docs/tasks.md):当前任务。
+- [IDEA.md](IDEA.md):最初的构想,已被 spec 取代,不作依据。
+
+## 已确认的规矩
+
+- 原始对话记录和素材文件始终只读。
+- 真实数据不进仓库:从真实会话和用户素材里提取的内容只能放在 `local/`(已被 git 忽略),任何时候都不提交。
+- 仓库里的文档和代码不写用户本机的具体路径;通用位置(如 `~/.codex`、`%LOCALAPPDATA%`)可以写。
+- Git 按个人开发流程:每项开发在短分支上进行,完成后直接合并到 main,不开 PR。
+- 先在 Windows 上开发和测试。技术栈用 TypeScript/Node。
+- 分工:Claude 维护 `docs/` 下的规格和方案;Codex 按 tasks.md 执行,不修改 spec.md 和 plan.md;全部完成后由 Claude 审查代码。
diff --git a/IDEA.md b/IDEA.md
new file mode 100644
index 0000000..0c650b6
--- /dev/null
+++ b/IDEA.md
@@ -0,0 +1,51 @@
+# Codex Attachment Manager(暂定)
+
+> **状态:已被 [docs/spec.md](docs/spec.md) 取代(2026-09-24)。** 本文件保留作为最初构想的记录,不再作为依据。
+
+## 一句话目标
+
+在 Codex 桌面窗口旁提供一个可视化附件面板,让用户逐轮决定哪些历史图片、音频、视频和文件进入下一次模型请求。所有原始文件及聊天记录留在本地;取消勾选只改变下一轮发送的内容,不删除文件或聊天历史。
+
+## 用户场景
+
+用户先上传参考图 A,Codex 生成图片 B,随后用户再次引用 B 请求修改。面板应按聊天时间顺序显示 A、B 及 B 再次出现的记录。用户可以取消勾选 A,保留 B;B 的再次出现应指向同一份素材,不再作为另一份图片发送。废稿仍可在面板中回看,需要时重新勾选。
+
+## 核心概念与规则
+
+- **素材**:一份可读取的本地媒体或附件,具有稳定的 `asset_id`、类型、原始路径、内容哈希和来源。原始文件保持不变。
+- **出现记录**:素材在上传、生成、引用或工具结果中出现的一次事件。多条记录可以指向同一份素材;不能把“聊天里出现几次”当成“有几个不同文件”。
+- **本轮选择集**:用户在面板里勾选、允许进入下一次请求的素材。选择状态按素材管理;每轮发送前都可调整。
+- **精确重复**:内容哈希相同的记录归到同一素材。重新编码但画面相同的图片可提示用户确认;有实际修改的版本保留为另一素材,并记录版本关系。
+- **未勾选的重复记录**:只发送短文本引用,例如 `记录 #12 与 IMG-004 为同一素材;本记录没有额外图像内容`。如果 IMG-004 本轮被勾选,它的图像内容只发送一次;如果也未勾选,则两条记录都只有文字占位。
+- **未勾选的独立素材**:只发送短文本占位,例如 `IMG-001:本轮未提供图像内容;不能据此判断画面细节`。不发送其媒体字节,也不在占位符中暴露可被误读为已提供内容的路径。
+- **已勾选素材**:在本轮输入里附上实际内容,并在文字索引中用 `asset_id` 指向它。面板必须同时显示“文字索引”和“实际附带的文件”。
+
+## 界面形态
+
+第一版面向 Windows Codex 桌面版。一个独立的小按钮贴在 Codex 窗口右侧,随窗口移动、缩放、最小化和恢复;点击后展开可滚动的附件时间线。每条记录展示缩略图或文件图标、所在轮次、来源、文件大小、重复/版本关系和本轮勾选状态。面板提供“本轮将发送什么”预览,明确区分实际媒体内容、重复引用和独立占位符。窗口最大化或贴近屏幕边缘时,面板自动改到可见位置。
+
+## 实现边界与路线
+
+Codex 现有公开插件接口不能逐项改写原生任务中已经存在的模型历史。仅在旧任务旁显示勾选框,无法保证旧图片从它下一次原生请求中消失;也不能通过修改本地聊天记录文件来冒充请求管理。
+
+因此第一版分两层:
+
+1. **只读导入与素材索引**:从可用的任务接口及本地素材位置识别历史附件,建立自己的索引和缩略图。旧聊天记录与原文件只读,不移动、不删除。
+2. **受控的后续请求**:面板维持一个对用户连续的“创作项目”;底层在需要控制上下文时建立干净的 Codex 后续任务,只交接必要文字摘要、素材索引和本轮勾选的附件。生成和查看媒体的受控工具应把完整媒体保存在本地,给 Codex 返回简短 ID/路径说明,避免把大块图片数据写进工具结果。
+
+这意味着可以实现用户感受到的连续多轮创作,但不能承诺同一个原生 Codex 任务 ID 在不变的情况下任意剔除旧图片。面板中必须明确标示当前操作是“只读预览”还是“受控发送”。
+
+## 第一轮验证
+
+用已经出现断连的任务作**只读样本**,不打断或修改它:
+
+1. 展示该任务能识别到的素材时间线、精确重复项和无法识别的项目;允许用户勾选。
+2. 同屏展示两种未勾选记录的模型可见文本、实际选择的媒体清单,以及各项预计发送字节数。预览不得被描述成已经发出的网络请求。
+3. 使用受控的干净后续任务发送选中素材,记录实际请求在压缩前后的大小、连接错误和完成情况;与旧任务的只读基线比较。
+4. 验证原始素材文件和旧任务记录在操作前后没有被删除或改写。
+
+2026-09-24 的初步只读检查:原任务记录中可识别到 10 份不同的内联图片内容;fork 中可识别到的 4 张图片均能与原任务的图片匹配。该 fork 近期再次出现 WebSocket 断流,后续 HTTP 请求约为 43.8 MB(压缩前)。这些数字只描述已检查到的记录和请求,不代表任务里全部可能存在的本地附件,也不证明图片大小是断连的唯一原因。
+
+## 首版范围
+
+先做图片的完整流程:导入、时间线、精确去重、勾选、两种占位符、受控发送和前后请求大小展示。素材模型预留 MIME 类型和通用文件元数据,音频、视频及其他附件在图片流程验证后接入。
diff --git a/docs/plan.md b/docs/plan.md
new file mode 100644
index 0000000..7efbeb9
--- /dev/null
+++ b/docs/plan.md
@@ -0,0 +1,109 @@
+# 技术方案:阶段 0 验证设计
+
+> 目标、约束和验收关卡以 [spec.md](spec.md) 为准。本文件说明怎么做、为什么这样做。阶段 0 结束后,按报告重写第 2 节,并补上首版架构。
+
+## 1. 已知事实(2026-09-24)
+
+### 验证环境(Windows)
+
+- Codex 桌面版:`OpenAI.Codex` 26.917.6896.0(MSIX)。它自带的 CLI 位于 `%LOCALAPPDATA%\OpenAI\Codex\bin\<hash>\codex.exe`,版本是 `codex-cli 0.155.0-alpha.16`。`<hash>` 会随桌面版更新而变化。
+- 验证机上没有运行中的 app-server 后台服务(执行 `codex app-server daemon version` 连接失败),所以桌面版目前不经过这个服务。
+- `~/.codex` 里和本项目有关的位置:
+ - 会话记录:`sessions/**/*.jsonl`
+ - 线程历史库:`thread_history_*.sqlite`;另有 `state_*.sqlite`
+ - 生成的图片:`generated_images/`
+ - 附件:`attachments/`(验证机上目前只有文本附件)
+ - 线程写锁:`thread-writer-locks/`
+- 样本任务的内联图片在 `sessions` 的 JSONL 记录里,该任务没有对应的 `generated_images/<thread-id>` 目录。它生成的 PNG 原件散落在用户项目文件夹的多个子目录里;具体位置执行者已知,不写进仓库。所以索引器不能只扫一个目录。
+- 样本 fork 在“只发文字”之后调用了看图工具,把 4 张图以内联形式写进了历史,单条结果约 13.3 MB。(此条和上一条由 Codex 在验证机上核实。)
+
+### 上游 Codex(公开源码和 PR)
+
+- 历史图片目前以内联 base64 的形式保存,每一轮都整包重新发送。0.156.0 已合入 `file_id` 引用和附件存储([#45794](https://github.com/openai/codex/pull/45794)、[#46065](https://github.com/openai/codex/pull/46065)),但 main 分支的 app-server 仍在用内联存储,而且已有的图片不会被迁移。
+- [#45794](https://github.com/openai/codex/pull/45794) 会拒绝“最近图片里含文件引用”的改图请求,所以改图这条路必须实测。
+- `thread/inject_items` 向线程追加原始 Responses 条目:条目进入模型可见的历史,但不产生新的用户轮次(见 [app-server 文档](https://developers.openai.com/codex/app-server))。
+- `postToolUse` hook 只能替换 MCP 工具的输出,改不了内置的 `view_image` 和生图。
+- `codex app-server` 的相关能力:
+ - 用 `-c key=value` 覆盖配置;
+ - 用 `--enable` / `--disable` 开关功能,例如 `view_image`;
+ - 用 `generate-ts` 生成和本机版本一致的 TypeScript 类型。
+- 按公开源码,模型发起的 MCP 调用会附带线程和会话标识([mcp_tool_call.rs](https://github.com/openai/codex/blob/main/codex-rs/core/src/mcp_tool_call.rs))。本地 stdio 服务实际收到什么,还没有实测。
+
+## 2. 两条路线
+
+### 路线 A:重建(首选,待验证)
+
+1. 只读读取原任务的历史,建立素材索引。
+2. 通过 app-server 新建任务,依次调用:
+ - `thread/start`
+ - `thread/inject_items`,注入按第 3 节规则搬过来的历史
+ - `thread/name/set`
+ - `turn/start`,附上选中的图
+3. 之后用户在桌面版里继续这个新任务。
+
+### 路线 B:交接包(回退方案)
+
+生成一份文字摘要,加一个装有选中图片的文件夹。用户手动开新任务,贴入摘要并附上图片。实现成本低,但连续性差。
+
+### 怎么选
+
+- spec 阶段 0 的关卡 1–6 全部通过:路线 A 作为首版主方案。
+- 关卡 2 或 3 失败:首版改用路线 B,路线 A 留作研究。
+- 关卡 4 或 5 失败:先当实现问题排查。如果确认是结构性原因(例如 app-server 会自动带回未选的图片),改用路线 B。
+- 关卡 6 失败:调整占位符的措辞。这不影响路线选择,但首版发布前必须通过。
+
+## 3. 路线 A 的搬迁规则
+
+- **搬过去的内容**
+ - 用户消息的文字;
+ - 助手的 `message` 回复;
+ - 占位符和重复引用,格式见 spec 的“占位符”一节。
+- **不搬的内容**
+ - reasoning 条目:它们是加密的,不能保证在另一个线程里可用;
+ - 压缩标记;
+ - 原始的工具调用及其输出。每次工具调用改写成一行说明,例如“(此处 image_gen 生成了 IMG-005,提示词:……)”。
+- **图片放在哪**
+ - 注入的历史里只放占位符,不放图片。选中的图片作为下一轮 `turn/start` 的附件发送,并在该轮文字里写明“附件 1 = IMG-004”。
+ - 这样“勾选”和“重新勾选”走的是同一条路:都在下一轮作为附件发送,不需要重建。这种方式也最接近改图工具取“最近图片”的方式。
+- **磁盘上找不到原件的图片**(只存在于记录里):解码后缓存到本地工作目录,作为附件的来源。缓存只是副本,不写回任何原始位置。
+- **原任务做过压缩时**:记录压缩条目的形态(是否可读),并在报告里说明搬的是哪一段历史。
+- **条目格式**:以 `generate-ts` 在本机生成的协议类型为准。
+
+## 4. 防止图片再次堆积
+
+在新任务里,模型自己调用 `view_image` 之类的工具时,仍会把图片以内联形式写回历史,样本 fork 就是这么变大的。
+
+阶段 0 做一个附加实验:用 `--disable view_image`,或在 `thread/start` 里用配置覆盖,关掉看图工具,记录这样是否可行、对流程有什么影响。首版方案按实验结果再定。
+
+## 5. 测量方法
+
+- **请求字节数**:调高我们自己启动的 app-server 的日志级别,从日志里读出请求体大小。上游的日志里出现过 `pre_compression_bytes=... post_compression_bytes=...` 这类记录,具体用哪个日志开关由执行者查证。
+- **历史构成**:只读检查新任务的记录,统计内联图片的数量和字节数,确认里面没有未选的图片。
+- **原始文件不变**:操作前后分别计算样本记录文件和相关素材文件的哈希,然后对比。
+- **估算值**:注入文字的字节数,加上选中图片转成 base64 后的字节数,与实测的请求字节数对比。
+
+## 6. 安全措施
+
+- **用同一个 codex**:独立的 app-server 用桌面版自带的那个 `codex.exe` 启动,避免状态库迁移不一致。如果版本对不上,先停下报告。
+- **先备份**:第一次通过 app-server 创建任务前,用 SQLite 在线备份(只读打开源库)给 `state_*.sqlite` 和 `thread_history_*.sqlite` 生成一致的副本,放进本地工作目录 `local/`(已被 git 忽略)。
+- **测试任务加前缀**:测试用的新任务,名称统一加前缀 `[CAM测试]`,方便用户识别和归档。
+- **先释放写锁**:在桌面版里打开新任务之前,先结束我们的 app-server 进程,释放线程写锁。
+- **不改用户配置**:不修改用户的 `config.toml`。需要的配置用命令行的 `-c`、`--disable`,或 `thread/start` 里的配置覆盖。
+- **不碰认证信息**:不输出、不记录认证信息(例如 `auth.json` 的内容)。
+- **沙箱权限**:独立的 app-server 需要联网和写入 `~/.codex`,可能被 Codex 沙箱拦下。遇到这种情况,请用户批准提权,或者由用户在普通终端里运行。
+
+## 7. 关键决策
+
+| 决策 | 原因 |
+|---|---|
+| 不改原生任务,改为在新任务中继续 | 官方没有删除历史条目的接口;直接改记录文件不安全 |
+| 路线 A 优先于只交接摘要 | 保留完整的对话文字,连续性更好 |
+| 只搬文字和占位符,不搬 reasoning 和工具记录 | 加密条目和调用配对不可靠,工具记录还可能夹带大块内容 |
+| 选中的图作为下一轮的附件发送 | 一套机制同时覆盖勾选和重新勾选,也贴近改图工具的取图方式 |
+| 首版用本地网页面板,不做贴靠按钮和对话内嵌卡片 | 跨平台、稳定;桌面版的内嵌卡片目前还有渲染问题 |
+| 首版只做单个任务、只做图片 | 全量扫描很重;图片是当前的痛点 |
+| 用 TypeScript/Node | 验证机已有 Node 24;能生成官方协议类型;面板也用同一种语言 |
+
+## 8. 阶段 0 之后
+
+根据 `docs/phase0-report.md` 重写第 2 节,并补上首版架构,大致包括:索引器、素材缓存、重建服务、本地网页面板、skill 和插件打包。首版的任务另行写进 tasks.md。
diff --git a/docs/spec.md b/docs/spec.md
new file mode 100644
index 0000000..339e05e
--- /dev/null
+++ b/docs/spec.md
@@ -0,0 +1,94 @@
+# 规格:Codex 上下文素材管理器(暂名)
+
+> 本文件是目标、范围、约束和验收标准的唯一事实来源(2026-09-24 经用户、Claude、Codex 三方确认)。
+> 技术方案见 [plan.md](plan.md),当前任务见 [tasks.md](tasks.md)。[IDEA.md](../IDEA.md) 是最初构想,已被本文件取代。
+
+## 1. 目标
+
+做一个开源工具,把某个 Codex 任务里出现过的素材按时间顺序列出来,让用户逐轮决定下一轮让模型看哪些。原始文件和聊天记录都留在本地、保持不变;取消勾选只影响之后发送的内容,不删除任何东西。
+
+### 用户场景
+
+用户先上传参考图 A,Codex 生成图片 B,用户再引用 B 要求修改。面板按时间顺序显示 A、B,以及 B 再次出现的记录。用户取消 A、保留 B 后继续创作。B 的再次出现指向同一份素材,只发送一次。之后任何一轮,用户都可以重新勾选 A,让它从下一轮起重新进入上下文。
+
+### 核心概念
+
+- **素材**:一份本地可读的图片或文件。有稳定编号(`asset_id`,例如 `IMG-004`),并记录类型、来源、所在轮次、字节哈希、解码后的像素哈希、尺寸和版本关系。
+- **出现记录**:素材在上传、生成、引用或工具结果中出现的一次事件。多条记录可以指向同一素材,出现次数不等于文件个数。
+- **选择集**:用户勾选、允许进入下一轮的素材。按素材管理,每轮发送前都可以调整。
+- **文字索引**:说明素材编号和状态的一段文字。重建任务时随历史一起提供;之后在附带素材的轮次里注明“附件 1 = IMG-004”这样的对应关系。
+
+### 选择规则
+
+- 任何素材在任何一轮都可以勾选或取消。取消的素材仍留在列表里,之后任何一轮都能重新勾选。
+- 新勾选(包括重新勾选)、且尚未在当前任务中发送过的素材,在下一轮作为附件发送,不需要重建任务。已经在当前任务里发送过、仍保持勾选的素材,不重复发送。
+- 取消一个已经发进当前任务的素材,要重建任务才能生效。界面要提示这一点,并支持攒一批取消操作后一次重建。
+- 字节哈希或像素哈希相同的出现记录归为同一素材,只发送一次。只是“看起来相似”的,提示用户确认,不自动合并。有实际修改的版本算另一份素材,并记录版本关系。
+
+### 占位符
+
+- **重复记录**:只放一句短文字,例如“记录 #12 与 IMG-004 为同一素材,此处不重复提供”。
+- **未勾选的独立素材**:用占位符替换,不删除。占位符包含:
+ - 编号、名称、类型、所在轮次、尺寸和大小;
+ - 来源说明:生成图附生成提示词,上传图附文件名和随附的那句话,工具结果附产生它的工具调用;
+ - 省略原因:为控制上下文而省略;
+ - 明确声明本轮未提供该内容,不能据此判断画面细节;
+ - 索要方式:需要时回复“需要 IMG-004”,用户勾选后在下一轮提供。
+- 占位符里不写本地路径,避免模型误以为已拿到内容,或自行调用工具去读。
+
+### 界面
+
+- 按时间顺序列出出现记录,每条显示缩略图或图标、轮次、来源、大小、重复/版本关系和勾选状态。
+- 提供“本轮将发送什么”预览,区分实际发送的素材、重复引用和占位符,并给出预计字节数。预览不得被说成已经发出的请求。
+- 明确标出当前是“只读预览”还是“受控发送”。
+
+### 为后续扩展预留
+
+数据模型记录 MIME 类型和通用的文件元数据,核心命名不写死“图片”,方便以后接入其他文件类型。
+
+## 2. 非目标
+
+首版不做下面这些。其中前两项已确认是后续方向。
+
+- 图片以外的文件类型,例如音频、视频、md、docx、xlsx;
+- 按文件类型筛选的栏目(全选、只看某一类)和跨任务的素材库;
+- 存储清理;
+- 贴靠在 Codex 窗口边的按钮、Codex 对话里的内嵌卡片;
+- macOS 和 Linux 适配;
+- coding agent 场景,例如省略模型已读过的代码文件;
+- 修改或删除原生 Codex 任务里已有的历史。
+
+## 3. 硬约束
+
+- 原始对话记录和素材文件始终只读,不修改、不移动、不删除。不直接写入 `~/.codex` 下的任何文件;唯一的例外是官方 app-server 在创建和运行任务时自己产生的正常写入。
+- 真实数据不进仓库:从真实会话和用户素材里提取的图片、记录片段、日志和备份,只能放在本机的 `local/` 目录(已被 git 忽略),任何时候都不提交。仓库里的样例数据只能是合成的或脱敏的。
+- 仓库里的文档和代码不写用户本机的具体路径(例如个人项目文件夹)。`~/.codex`、`%LOCALAPPDATA%` 这类通用位置可以写。本项目以后会开源。
+- 对上下文的控制只通过“在新任务中继续”来实现,不改写原生任务的历史。
+- 先在 Windows 上开发和测试。技术栈:TypeScript/Node。
+- 交付形态:Codex 插件(skill 加本地 MCP 服务)加本地网页面板。
+
+## 4. 验收标准
+
+### 阶段 0:技术验证
+
+用 IDEA.md 中 2026-09-24 做过只读检查的那个断流任务(原任务及其 fork)做样本,依次通过下面的关卡。测量方法见 plan.md。
+
+1. **只读导入**:列出样本里全部图片出现记录,包括来源、轮次、大小和去重关系;无法识别的项单独列出。原任务应得到 10 份不同的内联图片,fork 的 4 张都能和原任务匹配;如果数字对不上,要解释原因。操作前后,原始记录和素材文件的哈希不变。
+2. **可见、可续**:重建出的新任务能在 Codex 桌面版里看到、打开并继续对话;重启桌面版后仍能恢复。
+3. **能继续改图**:选中的图能在下一轮用于继续修改;取消过的素材在后面的轮次重新勾选后,模型能正确使用它。
+4. **未选不发送**:未勾选图片的内容既不出现在新任务的历史里,也不出现在实际请求里。
+5. **请求变小**:实际请求字节数与“文字历史 + 选中图片”的估算相符(误差在 ±20% 以内),并且明显低于约 43.8 MB 的基线。
+6. **占位符有效**:被问到未提供图片的画面细节时,模型不编造,而是说明未提供,并按约定方式索要。
+
+### 首版
+
+1. 选定一个任务后,按时间顺序列出全部图片出现记录,无法识别的项单独列出。
+2. 可以勾选、取消、重新勾选,并预览本轮将发送什么(实际素材、重复引用、占位符、预计字节数)。
+3. 一键在新任务中继续:未勾选的图片不进入请求,选中的图可以继续修改。
+4. 取消过的素材在之后任何一轮都能重新勾选并被发送。
+5. 操作前后,原始记录和素材文件的哈希不变。
+6. 显示操作前后的请求大小对比。
+
+## 5. 待定问题
+
+- 重建路线由阶段 0 的结果决定:路线 A 用 `thread/inject_items` 重建,路线 B 用交接包。选择规则见 plan.md。
diff --git a/docs/tasks.md b/docs/tasks.md
new file mode 100644
index 0000000..469fbc6
--- /dev/null
+++ b/docs/tasks.md
@@ -0,0 +1,79 @@
+# 任务清单:阶段 0 技术验证
+
+> 验收关卡见 [spec.md](spec.md) 第 4 节,方法见 [plan.md](plan.md)。按顺序做,完成一项勾一项,并写明证据放在哪里。
+
+## 执行规则
+
+- 代码放在 `spike/` 下。每个脚本开头用注释写明用途、输入和输出。这是一次性的验证代码,不追求产品化,但必须遵守只读规则。
+- 从真实会话里提取的图片、记录片段、日志和备份,只放在 `local/`(已被 git 忽略),不提交。
+- 标了【需用户】的步骤,要由用户在桌面版上操作或做判断。走到这一步先停下,说清楚需要用户做什么。
+- 遇到 plan.md 没有覆盖的决策,停下来写进报告,交给用户决定。这类决策包括:改变路线、扩大范围、需要直接写入 `~/.codex`、需要修改用户配置。
+- 不修改 `docs/spec.md` 和 `docs/plan.md`。发现需要修改的地方,写进报告。
+
+## 任务
+
+- [ ] **T0 准备**
+ - 在 `spike/` 下初始化 TypeScript/Node 工程。
+ - 记录桌面版版本,以及桌面版自带的 `codex.exe` 的路径和版本。路径写成 `%LOCALAPPDATA%\…` 这样的通用形式。
+ - 确认样本任务(原任务和 fork)的线程 ID,以及它们的历史存在 JSONL 里还是 SQLite 里。
+ - 用 `codex app-server generate-ts` 生成本机的协议类型。
+ - 完成标准:以上信息都写进报告草稿。
+
+- [ ] **T1 只读导入**(关卡 1)
+ - 读取样本的记录,输出一份素材清单,同时给出 JSON 和便于阅读的表格。每条出现记录包括:轮次、时间、来源类型、字节数、字节哈希、像素哈希、尺寸、已知的本地路径。
+ - 标出重复关系,无法识别的项单独列出。
+ - 操作前后,对样本的记录文件分别计算哈希并对比。
+ - 完成标准:满足 spec 关卡 1。
+
+- [ ] **T2 找到磁盘上的原件**
+ - 在样本任务所用的项目素材文件夹(包括子目录;位置执行者已知,不写进仓库)和 `generated_images/` 里,按哈希找每份素材的原件。
+ - 如果 Codex 发送前缩放过图片,导致哈希对不上,记下有多少张。然后把图片缩放到相同尺寸再比较相似度,给出候选匹配,标为“待确认”。
+ - 统计“找到原件”和“只存在于记录里”各有多少。后者解码后缓存到 `local/`。
+ - 完成标准:每份素材都有一个可以当附件用的本地文件。
+
+- [ ] **T3 连上 app-server**
+ - 按 plan“安全措施”备份 SQLite 状态库。
+ - 用桌面版自带的 `codex.exe` 启动一个独立的 app-server(stdio),完成 `initialize`,再调用只读的 `thread/list`。
+ - 如果被沙箱拦下,请用户批准提权,或者请用户在普通终端里运行。
+ - 完成标准:能列出样本任务。
+
+- [ ] **T4 重建**
+ - 按 plan“搬迁规则”生成要注入的条目。
+ - 新建任务,命名为 `[CAM测试] <原任务名>`。勾选 1–2 张图(例如 B),发一轮简短的请求,同时记录请求字节数。
+ - 桌面版全程开着(这就是真实的使用场景),记录有没有出现写锁冲突或报错。
+ - 完成标准:
+ - 新任务正常回复;
+ - 拿到请求字节数;
+ - 报告里写明注入了哪些条目、搬的是哪一段历史。
+
+- [ ] **T5 可见、可续**(关卡 2)【需用户】
+ - 先结束我们的 app-server,再请用户在桌面版里打开新任务并继续对话,然后重启桌面版,确认任务还能恢复。
+
+- [ ] **T6 改图与重新勾选**(关卡 3)【需用户】
+ - 在新任务里,让模型基于选中的图,用内置生图继续修改。
+ - 找一张之前取消了的图(例如 A),在下一轮重新勾选并作为附件带上,检查模型能否正确描述和使用它。
+ - 完成标准:满足 spec 关卡 3。报告附上相关的工具调用记录,画面由用户确认。
+
+- [ ] **T7 未选不发送、请求变小**(关卡 4、5)
+ - 按 plan“测量方法”检查新任务的历史和请求。
+ - 完成标准:满足 spec 关卡 4、5,并给出与 43.8 MB 基线的对比。
+
+- [ ] **T8 占位符有效**(关卡 6)
+ - 针对一张没有提供的图,询问画面细节,检查模型怎么回答。
+ - 完成标准:满足 spec 关卡 6,报告里摘录这段问答。
+
+- [ ] **T9 附加实验**(不算关卡,只记录结果)
+ - a. 关掉 `view_image` 后,整个流程是否还能用(plan 第 4 节)。
+ - b. 如果能通过配置覆盖临时挂一个测试用的 stdio MCP 服务,记录它收到的调用里 `_meta` 有哪些内容。做不到就跳过,不要为此修改用户配置。
+ - c. 生成一份路线 B 的交接包,记录手动继续需要哪些步骤、体验如何。
+
+- [ ] **T10 报告**
+ - 写 `docs/phase0-report.md`,内容包括:
+ - 环境和版本;
+ - 每个关卡的结果(通过或失败)和证据;
+ - 实测数字;
+ - 发现的问题和风险;
+ - 按 plan“怎么选”给出的路线建议;
+ - 需要用户决定的事项。
+ - 报告里不贴原任务的图片和对话原文,也不写本机的具体路径,只写统计和必要的简短摘录。测试任务里的问答可以摘录。
+ - 写完就停下,不要进入首版开发。