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.4(Claude 桌面 Code 接入)确认的内容写回 spec.md 和 design.md
chipfighterbae0ea4cae06
diff --git a/docs/design.md b/docs/design.mdindex e1b5513..a115240 100644--- a/docs/design.md+++ b/docs/design.md@@ -1,7 +1,7 @@# 技术方案> 目标、约束和验收标准以 [spec.md](spec.md) 为准。本文件说明现在是怎么实现的、为什么这样做。-> 文中“已查证”的 Codex 行为,都针对桌面版 26.924(自带命令行 0.158),标着 v0.3 的针对 26.930(自带命令行 0.160);Codex 更新后可能变化。+> 文中“已查证”的 Codex 行为,都针对桌面版 26.924(自带命令行 0.158),标着 v0.3 的针对 26.930(自带命令行 0.160);Codex 更新后可能变化。第 12 节的 Claude 行为(v0.4,开发中,未发布)针对 Claude 桌面应用 2.31226,自带 Claude Code 2.1.293。> v0.1 开发过程中的调研和排错经过,归档在 [history/v0.1/](history/v0.1/),其中 plan.md 是当时逐步写成的完整方案。## 1. 总体结构@@ -12,7 +12,7 @@2. 引擎按这个任务的勾选,把取消的图换成占位符,再转发给 `chatgpt.com`;3. 回复原路返回,由 Codex 照常记进同一个任务。-任务不换,历史和界面都不动,勾选和取消从下一次请求起生效。+任务不换,历史和界面都不动,勾选和取消从下一次请求起生效。v0.4 起,Claude Code 的请求也经过同一个引擎,转发到 `api.anthropic.com`,见第 12 节。另一条路线是在新任务里重建历史(阶段 0 验证过,技术上可行)。没有采用,因为用户要在同一个任务里看到连续的对话,见 [history/v0.1/phase0-report.md](history/v0.1/phase0-report.md)。@@ -25,6 +25,9 @@| 改写 | `rewrite.ts`、`selection.ts`、`request-stats.ts` | 占位符、说明和标签;勾选状态;请求统计 || 接入和安装 | `codexconfig.ts`、`setup.ts`、`install.ts`、`codexcli.ts`、`cam.ts` | 管理 Codex 配置里带标记的块;用 Codex 的命令行装卸插件;`cam` 命令行 || 其他 | `language.ts`、`messages.ts`、`paths.ts`、`migrate-data.ts`、`binding.ts`、`entry.ts` | 语言、文字表、数据目录、旧数据迁移、新任务绑定 |+| Claude 接入(v0.4) | `hooks/register.js`(Mod,不在 `plugin/src`) | 把会话的请求地址指向引擎;`/cam` 打开面板;取图工具免确认 |+| Claude 会话索引和改写(v0.4) | `claude-index.ts`、`claude-rewrite.ts` | 从 Claude Code 的会话记录找图、编号;改写 Anthropic Messages 请求 |+| 面板页(v0.4) | `panel-web.js` | 引擎把 `panel.html` 作为网页提供时,代替 MCP 应用的宿主 |引擎和插件服务之间只通过数据目录里的文件共享状态,任何一方不在,另一方都照常工作。@@ -97,9 +100,9 @@## 5. 引擎的生命周期- **全机一个**:监听 17891 端口(`127.0.0.1` 和 `::1`),`/__cam/health` 报告进程、build(运行目录里 .ts 文件的哈希,换行统一成 LF)和版本。-- **跟着 Codex**:插件服务启动时确保引擎在运行,之后每隔几秒检查一次,崩了就重新拉起。Codex 全部退出后,引擎自己退出。+- **跟着 Codex**:插件服务启动时确保引擎在运行,之后每隔几秒检查一次,崩了就重新拉起。Codex 全部退出后,引擎自己退出;v0.4 起 Claude Code 也用这个引擎,要等 Codex 和 Claude 的进程都没有了才退出。- **Windows 的 Job**:插件服务在一个“关闭即结束、不许脱离”的 Job 里,它拉起的引擎随它一起结束,其他会话的插件服务会在几秒内重新拉起。macOS、Linux 上引擎用 `setsid` 脱离进程组。-- **升级时替换**:插件服务发现引擎的代码和自己不同、版本不低,就请旧引擎退役(`/__cam/retire`):旧引擎立刻停止监听,把正在进行的请求和 WebSocket 这一轮做完再退出,新引擎马上接手端口。+- **升级时替换**:插件服务发现运行中的引擎版本比自己低,就请旧引擎退役(`/__cam/retire`):旧引擎立刻停止监听,把正在进行的请求和 WebSocket 这一轮做完再退出,新引擎马上接手端口。版本相同、代码不同时不替换,只有安装命令(`cam install`)强制替换:v0.4 起 Codex 和 Claude 各有一份插件副本,否则两份副本会来回让对方的引擎退役。- **插件被移除、没先停用**:引擎每 15 秒检查一次,只认明确的迹象:插件缓存目录不在了,或者 `config.toml` 写着 `enabled = false`。连续两次,或者引擎退出前再查一次,就把 Codex 恢复直连。Windows 上引擎通常随插件服务一起被结束,来不及做这一步,所以面板、插件说明和 README 都写“先停用再移除”,卸载命令负责恢复。## 6. 面板@@ -204,3 +207,42 @@- **模型的差别**:小模型在低推理强度下(例如 GPT-6 Luna Light)偶尔会要错图,或者拿到错图时不说“这张里没有”,而是猜一个答案(v0.1-25 的录屏里遇到过)。- v0.3 查证:GPT-6 Luna(low)读工具结果里的图,比读用户消息里的图差。同一张图放在消息里问,四次都读对;经 `cam_view_image` 或 Codex 自带的 `view_image` 送来,常把角落的小数字读错(5 读成 3,7 读成 2),有时说看不到数字。把取回的图挪进紧跟着的一条用户消息也没改善,问题在“先调用工具再看图”这个过程,不在图放在哪里。Sol、Astra 没有这个问题。README 和发布说明写明了这一点。- **桌面版的上下文比自测多**:桌面版每轮还带着电脑操作、浏览器等插件的工具说明(约 1 万 token)。自测为了不让测试模型操作用户的电脑,没开这些插件,所以个别只在桌面版出现的模型行为,自测复现不出来。++## 12. Claude Code 接入(v0.4,开发中,未发布)++方案、关卡和任务见 [v0.4/plan.md](v0.4/plan.md)。做法是把上面的机制逐块移植,这里写对应的做法和平台逼迫的改动。++- **接入**(`hooks/register.js`,Mod):+ - Claude 桌面启动 Code 会话时传入 `ANTHROPIC_BASE_URL`,不认 settings 文件里的同名设置。所以由 Mod 在会话启动(`session.start`)时切换:等引擎回答健康检查、确认它能转发 `api.anthropic.com`,再用 `$.env.set` 把这个 Claude Code 进程的 `ANTHROPIC_BASE_URL` 指向 `http://127.0.0.1:17891`,并把本机地址加进 `NO_PROXY`。+ - 原值存在会话状态里,进程结束(`session.end`,`/clear`、`/resume` 除外)时还原。尽量在第一个请求之前切好;引擎还在启动时,先等几秒,其余时间在后台等。+ - 已经设了别的服务地址或第三方服务(`CLAUDE_CODE_USE_BEDROCK` 等)的会话不接管。运行中的引擎太旧、不转发 Claude 时也不接管,小面板上提示。+ - 订阅登录不受影响:引擎把同样的请求头转给 `api.anthropic.com`,不记认证信息。+- **认出会话**:靠请求头 `x-claude-code-session-id`。子代理的请求另带 `x-claude-code-agent-id`,它们有自己的历史,不按主会话改写。+- **找图和编号**(`claude-index.ts`):+ - 会话记录在 `~/.claude/projects/<项目>/<会话 id>.jsonl`(`CLAUDE_CONFIG_DIR` 可改),只读、增量地读。记录用 `parentUuid` 串成链,从最新一条消息往回走就是当前的对话,撤回、编辑留下的旧分支不算;压缩分界的记录用 `logicalParentUuid` 接上前面的历史。+ - 并行调用工具时,每个结果挂在自己那条调用记录下面,对话从最后一个结果接着往下走。所以调用在链上、链上又没有它结果的那些结果,补回到调用后面。+ - 用户贴的图按“记录 uuid + 序号”识别,工具结果里的图按 `tool:<tool_use_id>#序号` 识别。请求里用户消息的图没有 id,按内容依次对齐。+ - 一轮从用户的一条输入开始:Claude Code 给这条记录标了 `turnPosition`,别的会话发来的消息也算一轮。+- **改写**(`claude-rewrite.ts`、`proxy.ts`):+ - 只改 `/v1/messages`:用户消息里和工具结果里的图换成占位符,文字和 Codex 版相同。+ - 说明是 `role: "system"` 消息,放在第一张被省略的图所在的那条消息之后;那里已经有系统消息时,并进去。每条含被省略图片的消息后面都跟一条简短说明(`rewrite.ts` 里的 `here`),从后往前插,勾选不变时位置不变。+ - 思考块原样转发。账号拒绝改过的历史(400,`thinkingRejected`)时,改发原始请求,统计里记下 `fallback`,面板提示。`CAM_EXPERIMENT_BLOCK_BINDING=error` 让老账号也按新账号的方式校验,只用于实验。+ - 面板的“上一次请求”只记带工具的主对话请求。桌面版还会在会话里发附带请求(用户离开时的状态摘要、自动模式的安全检查):照样改写,但不记进这一行。+- **面板**(`proxy.ts`、`panel-web.js`、Mod):+ - Claude Code 不登记只给应用用的工具,所以用户打不开插件的 MCP 应用;Mod 面板只能画 Claude 自带的元素,也放不进网页。于是由引擎在 `/__cam/panel?session=<id>` 提供 `panel.html`,前面加一段 `panel-web.js` 代替 MCP 应用的宿主:把面板的工具调用转成引擎的本机接口 `/__cam/claude/panel`、`select`、`image`。+ - 页面和接口只接受用本机名字(`localhost`、`127.0.0.1`、`[::1]`)访问、不带其他网站 Origin 的请求;接口还要带 `x-cam-panel` 请求头;页面带严格的 CSP。+ - `/cam` 用桌面版给每个 Code 会话的浏览器工具(`Claude_Browser` 的 `preview_start`),在自带的浏览器里打开页面。这个工具不是公开给插件的接口,调用失败或者没有时,Mod 弹出小面板给链接。Mod 面板里的链接,点开会交给系统浏览器。+ - 小面板上的图片数,在打开时、每轮结束后,以及 `/clear`、`/resume` 之后重新读取。+ - 页面语言跟着引擎(`CAM_LANG` 或系统语言),不看浏览器。+- **取图工具**:插件服务以 `CAM_HOST=claude` 运行,只给模型 `cam_view_image`。Mod 把调用它的会话 id 补进参数(插件服务可能比 `/clear`、`/resume` 活得久),并在 `classic.PreToolUse` 里放行这一个工具:先让下面的钩子和设置判断,它们拒绝或要求询问时照旧。+- **数据目录**:Claude 会话的勾选在 `claude/selection/`,请求统计在 `claude/requests/`,和 Codex 的分开。+- **安装**:+ - 仓库根目录同时是 Claude 插件市场(`.claude-plugin/marketplace.json` 指向仓库根目录),清单是 `.claude-plugin/plugin.json`:同一个 MCP 服务(`plugin/scripts/launch`,`CAM_HOST=claude`),另加 Mod(`hooks/hooks.json`)。+ - 用户运行 `claude plugin marketplace add chipfighter/codex-attachment-manager` 和 `claude plugin install codex-attachment-manager@codex-attachment-manager`。装好的插件按版本缓存,代码改了要升版本才会重新安装。+ - Claude 桌面不带 Node。没装 Codex 时,启动脚本用 PATH 上 24 以上的 `node`,找不到就提示安装 Node 24。+- **测试**:单元测试同第 10 节(`claude-*.test.ts`)。Mod 的界面和钩子用 Claude Code 自带的测试工具(`claude plugin test`)测。模型测试用真实的 Claude 桌面订阅会话,按 v0.4/plan.md 的约定用 Haiku 5.5,中英文都测。+- **依赖的 Claude 行为**(都不是公开接口,Claude 更新后要重新验证):+ - 会话记录的格式:`parentUuid`、`turnPosition`、压缩分界、并行工具结果的挂法;请求头 `x-claude-code-session-id`。+ - 桌面版启动会话的方式:启动时传入 `ANTHROPIC_BASE_URL`;新会话要到第一条输入才启动进程,所以 `/cam` 在那之前不在输入框的命令列表里。+ - `Claude_Browser` 浏览器工具;Mod 面板里的链接交给系统浏览器;桌面版在会话里发的附带请求。+ - 思考记录的前缀校验:替换历史里的一张图,之后的思考块就对不上了;2026-08-31 以后注册的账号直接拒绝。diff --git a/docs/spec.md b/docs/spec.mdindex d338d96..2b067ec 100644--- a/docs/spec.md+++ b/docs/spec.md@@ -1,12 +1,14 @@# 规格:Codex Attachment Manager(上下文素材管理器)-> 本文件是目标、范围、约束和验收标准的唯一事实来源(2026-09-24 经用户、Claude、Codex 三方确认),描述当前版本 v0.3.0,以后随版本更新。+> 本文件是目标、范围、约束和验收标准的唯一事实来源(2026-09-24 经用户、Claude、Codex 三方确认),描述当前版本 v0.3.0,以后随版本更新。v0.4(Claude 桌面 Code 接入)正在开发、尚未发布,相关内容都标着“v0.4”;它的关卡、任务和验收步骤见 [v0.4/](v0.4/)。> 技术方案见 [design.md](design.md)。v0.1 的开发记录(原方案、任务记录、各阶段报告、最初的构想)归档在 [history/v0.1/](history/v0.1/),只作参考。## 1. 目标做一个开源工具,把某个 Codex 任务里出现过的素材按时间顺序列出来,让用户逐轮决定下一轮让模型看哪些。原始文件和聊天记录都留在本地、保持不变;取消勾选只影响之后发送的内容,不删除任何东西。+v0.4(开发中,未发布):同样的管理也用在 Claude 桌面应用的 Code 标签页里(本地会话、官方订阅登录)。做法是把现有插件的机制逐块移植过去,不另起架构、不削减功能,只在平台逼迫的地方改(用户 2026-10-10 定)。和 Codex 不同的地方见下面“Claude Code(v0.4)”一节。+### 用户场景用户先上传参考图 A,Codex 生成图片 B,用户再引用 B 要求修改。面板按时间顺序列出 A、B,以及 B 再次出现的记录,默认全部勾选。用户取消 A 和 B 的再次出现,然后继续创作:A 换成占位符,B 的再次出现换成指向 B 的占位符。之后任何一轮,用户都可以重新勾选 A,让它从下一次请求起重新进入上下文。@@ -113,6 +115,22 @@- 安装命令在终端里的输出,按系统语言。- 以上是用户 2026-09-24 定的 MVP,外加 2026-09-25 要求补上的发送预览、改写失败提示、自动刷新、这两个按钮的位置和名称、标题里的任务名、新任务的自动绑定,以及中英文界面;2026-09-26 加了“模型需要”提示条、整轮勾选,以及直接读 Codex 的语言设置;v0.2 加了 PDF 页面、网页截图两类来源和按来源筛选(用户 2026-09-29 定);v0.3 加了自动选图(用户 2026-10-06 定)。+### Claude Code(v0.4)++开发中,尚未发布。这里只写和 Codex 不同的地方;编号、内容相同、勾选、占位符和自动选图的规则照搬。++- **范围**:Claude 桌面应用 Code 标签页里的本地会话,官方订阅登录,不需要 API key。Claude Code 的会话就相当于 Codex 的任务,每个会话各有一套勾选。已经改用别的服务地址,或者用第三方模型服务(Bedrock、Vertex、Foundry)的会话不接管。+- **接入**:装上 Claude 插件就生效,不用手动配置。插件在会话启动时,把这个 Claude Code 进程的请求地址指向本机引擎,进程结束时还原。登录凭据原样转给 Anthropic。+- **说明的位置**:Anthropic 不允许把系统消息放在用户消息之前,所以“上下文管理说明”放在第一张被省略的图所在的那条消息之后,是一条系统消息。另外,每条含被省略图片的消息后面都跟一条简短说明:这几张图当时是原图,之前的描述仍然有效;被问到要看图才能回答的细节时,写出“需要 IMG-xxx”,用户才知道该勾回哪张。Codex 的措辞不变。+- **思考记录**:思考块原样转发。改过的历史被 Anthropic 拒绝时(2026-08-31 以后注册的账号会这样),改发原始请求,面板提示这次没能按勾选改写,这一次也不算取消成功。+- **面板**:和 Codex 是同一个面板页面(用户 2026-10-10 要求两边一致)。Claude Code 不给用户打开插件的 MCP 应用,插件自己的小面板(Mod 面板)也放不进网页,所以面板由本机引擎作为网页提供:+ - 用户输入 `/cam`,面板在 Claude 桌面自带的浏览器里打开,就在对话旁边(用户 2026-10-10 选定)。+ - 只有两种情况才弹出插件的小面板:自带浏览器打不开时(终端、VS Code,或调用失败),给出面板链接和“复制链接”按钮;这个会话的请求没经过引擎、勾选不会生效时,提醒用户。+ - 新会话的第一条输入就是 `/cam` 时,输入框会提示命令不存在,但发出后照常打开:Claude 桌面要等第一条输入才启动会话的进程,插件这时才注册 `/cam`。保持现状,在用户文档里写明(用户 2026-10-10 定)。+ - 没有 Codex 特有的“启用插件 / 停用插件”按钮和新任务绑定。+ - 语言跟着插件,和发给模型的说明一致,不跟着浏览器。+- **取图工具**:模型调用 `cam_view_image` 不弹权限确认,和 Codex 版的自动批准一样;用户自己的钩子或设置拒绝、或要求询问时,照旧按它们来(用户 2026-10-10 同意)。+### 为后续扩展预留以后接入音频时,照图片的做法:Codex 发音频的格式和图片几乎一样,见 [design.md](design.md) 第 11 节;什么时候开始做,见第 2 节。@@ -132,6 +150,7 @@ v0.1 到 v0.3 都不做下面这些。其中音频和其他语言已确认是后- coding agent 场景,例如省略模型已读过的代码文件;- 修改或删除原生 Codex 任务里已有的历史;- 在 Codex 对话里把模型要的图的编号做成可点的引用,点了打开面板或原图(用户 2026-09-26 看过调研结果后决定不做,收益不值得;原因见 [history/v0.1/plan.md](history/v0.1/plan.md) 第 18 节)。+- v0.4 也不做(用户 2026-10-10 确认的方案):其他模型供应商、云端会话、跨会话素材库、新的常驻系统服务;也不因为换了客户端,就把原生 PDF、文档、音频、视频和普通文本文件纳入管理。## 3. 硬约束@@ -140,15 +159,17 @@ v0.1 到 v0.3 都不做下面这些。其中音频和其他语言已确认是后- 官方 app-server 在创建和运行任务时自己产生的正常写入;- 为接入本地代理和面板服务,工具可以修改 `config.toml` 里由它自己管理、带标记的设置(用户 2026-09-24 授权)。改之前先备份,能一键恢复,其他设置一律不动。只在这些时候改:用户运行安装或卸载命令;用户在面板里点“启用”或“停用”;插件被移除或关掉、又没先停用时,引擎把 Codex 恢复直连(v0.1);- 为让生图和改图也能连到本地代理,工具可以在 `~/.codex/.env` 里写一段带标记的 `NO_PROXY`,只含本机地址,并保留用户自己的条目(用户 2026-09-24 同意)。`.env` 可能含密钥,工具不复制、不输出它,只增删自己的那一段;文件里只剩这一段时,恢复时连文件一起删掉。+- v0.4:Claude Code 的会话记录(`~/.claude/projects/` 下)同样只读。工具不直接写 `~/.claude` 下的文件,Claude 插件的登记、安装和卸载都由 Claude Code 自己的插件命令完成。插件只改它所在的那个 Claude Code 进程里的 `ANTHROPIC_BASE_URL` 和 `NO_PROXY`,进程结束时还原。- 真实数据不进仓库:从真实会话和用户素材里提取的图片、记录片段、日志和备份,只能放在本机,开发时放在 `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)。请求里的其他内容原样转发。+- 代理只替换用户取消的图片,连同 Codex 附在它前后的路径标签;自动选图开着时,还替换之前各轮没有固定发送的图(v0.3)。有图片被省略时,另外插入一条“上下文管理说明”开发者消息(用户 2026-09-25 要求告诉模型原因,见第 1 节“占位符”),并在仍发送的图前面加“已提供”标签(v0.1-25)。请求里的其他内容原样转发。v0.4:Claude 的请求里,说明是系统消息(位置见第 1 节“Claude Code(v0.4)”);思考块原样转发,不删除,也不关掉思考。- 选择权在用户:默认只由用户在面板里勾选决定,工具和模型都不能自动勾选或取消;模型只能按约定索要(例如回复“需要 IMG-004”),给不给由用户决定。用户给某个任务打开“自动选图”后,之前各轮的图默认不发,由模型用取图工具按编号取回需要的图,只在这一轮有效;模型不能改用户的勾选,也不能替用户开关自动选图(v0.3,用户 2026-10-06 定,取代原来的“选择权永远在用户”)。- 先在 Windows 上开发和测试。技术栈:TypeScript/Node。macOS、Linux 由 CI 验证能装上、能启动;这两个平台桌面版上的实测,等用户在 GitHub 上反馈(用户 2026-09-25 定)。- 交付形态:Codex 插件。插件带一个本地 MCP 服务,负责拉起引擎、提供面板;仓库根目录就是插件市场。面板位置见第 1 节“界面”。- 用户在 Codex 的插件页面添加插件市场 `chipfighter/codex-attachment-manager`、装上插件,再在面板里点“启用”;卸载前在面板里点“停用”。- 也可以用发布附带的一行命令安装、卸载。开发时用仓库里的 `cam install` / `cam uninstall`。+ - v0.4:同一个仓库也是 Claude 插件市场(`.claude-plugin/`)。Claude 插件带同一个 MCP 服务,另加一个 Mod,分别负责切换请求地址和 `/cam`。用户用 `claude plugin marketplace add chipfighter/codex-attachment-manager`、`claude plugin install codex-attachment-manager@codex-attachment-manager` 安装。Claude 桌面不带 Node,没装 Codex 时需要 Node 24 或更新版本(用户 2026-10-10 定:在说明里写明,不自动下载)。- 许可证:MIT(用户 2026-09-25 确定)。## 4. 验收标准@@ -189,9 +210,22 @@ v0.1 之前的阶段验收(阶段 0 的重建路线、代理路线 P2)都已5. 面板按第 1 节“界面”里自动选图的写法显示:开关、“固定发送”的勾选、“最近一轮模型取回”提示条和行标签、发送预览;取回的副本不另占一行。6. 删减图片不诱发模型幻觉:模型不收回之前看着原图做出的回答,也不编造没看到的细节(同 v0.1 第 8 条)。+### v0.4(开发中)++> 用户 2026-10-10 确认的方案。每条的检查步骤和证据要求见 [v0.4/acceptance.md](v0.4/acceptance.md)。++1. 装上 Claude 插件后不用手动配置:在 Claude 桌面 Code 的本地会话里,用官方订阅登录,请求经过本机引擎,回复正常;会话结束后还原。+2. `/cam` 在 Claude 桌面自带的浏览器里打开面板,面板和 Codex 一致:列表、缩略图、放大预览、勾选、整轮勾选、筛选、发送预览、自动选图开关和中英文;按第 1 节“Claude Code(v0.4)”的写法弹出小面板。+3. 同一个会话里逐轮取消、恢复,从下一条消息起生效;原始会话记录只读。+4. 删减图片不诱发模型幻觉:不收回看着原图做出的回答,不编造没看到的细节,需要时按编号要图。用真实的 Claude 订阅模型,中英文都测。+5. 自动选图:需要看图时用取图工具取回,之前说过的内容够用时不取;取回的副本只在那一轮提供。+6. 改写被拒时,原样发送并在面板提示,对话不中断。+7. Codex 的功能没有退化。+## 5. 待定问题- 在插件页面移除或关掉插件、没先在面板里停用时,代理设置还在:- macOS、Linux 上,引擎会发现这一点,把 Codex 恢复直连,下次启动 Codex 时生效。- Windows 上,引擎随插件服务一起被结束(Codex 的 Job 限制,见 [design.md](design.md) 第 5 节),Codex 会连不上,要运行卸载命令恢复。面板、插件说明和 README 都提示“先停用再移除”。- 要不要让引擎不依赖插件启动(例如用 Windows 计划任务),需要用户同意在系统里注册任务,之后再定。+- v0.4:2026-08-31 以后注册的 Claude 账号会拒绝改过的历史(思考记录的校验),引擎只能改发原始请求。所以在这类账号上,取消勾选基本不会生效(面板会如实提示)。要不要另想办法,用户之后再定(2026-10-10)。diff --git a/docs/v0.4/plan.md b/docs/v0.4/plan.mdindex 87eda7d..2a5eff5 100644--- a/docs/v0.4/plan.md+++ b/docs/v0.4/plan.md@@ -42,6 +42,9 @@ v0.4 按现行 v0.3 的图片管理语义验收:稳定编号、每次出现独- 只写 `enabledPlugins` 不完成安装;必须实际登记并安装插件,再加载到目标会话。首次命令缺失由漏安装造成,补安装后已解决。- 面板(2026-10-10 桌面实测):Mod 面板只能画 Claude 自带的元素,放不进网页;Claude Code 不登记只给应用调用的工具,用户打不开插件的 MCP 应用。Mod 面板里的链接,点开交给系统默认浏览器。Mod 用 `$.mcp.call("Claude_Browser", "preview_start", { url })` 能在桌面自带的浏览器里打开本机页面,默认权限模式下也不弹确认;这是桌面版给模型用的工具,不是公开给插件的接口,终端和 VS Code 里没有。- 桌面版的新会话,发出第一条输入时才启动 Claude Code 进程。Mod 注册的命令在那之前不在输入框的命令列表里:输入时提示命令不存在,发出后照常执行。插件自带的命令文件一律带插件名前缀(`/codex-attachment-manager:cam`)。+- 图片与思考(2026-10-10,T04-01,Haiku 5.5,推理强度 low,桌面订阅会话,工具查看的图,中英各 3 次):用户自己的账号接受改过的历史连同思考记录(全部 200)。全部省略后,模型不收回之前的描述、不猜新细节、不自己重读文件,勾回后看图答对;逐条说明写明何时写“需要 IMG-xxx”后,中英都 3/3 按编号要图。模拟新账号(`CAM_EXPERIMENT_BLOCK_BINDING=error`)时,改写后的请求得到 400,引擎改发原始请求得到 200,对话不断,面板提示。自动选图:需要看图时都用 `cam_view_image` 取回并答对;不需要时,中文有 1 次多取,英文都不取;取回的副本下一轮换回说明。+- 并行调用工具时,Claude Code 把除最后一个以外的结果挂在各自的调用记录下面,不在沿父记录回溯出的链上(2026-10-10 在测试中发现并修复)。+- 安装(2026-10-10,在隔离的配置目录里):从仓库导出的插件市场添加、安装到用户范围后,插件服务能起来;用 Codex 带的 Node,或只有系统的 Node 24,都能运行。私有实验记录位于验证机的 `local/claude-live-routing/`;不得把原始记录、凭据、图片或本机路径复制到提交中。仓库只保留上述脱敏结论和实验方法。该目录被忽略,克隆仓库后无需存在。@@ -50,13 +53,13 @@ v0.4 按现行 v0.3 的图片管理语义验收:稳定编号、每次出现独2026-10-09 查官方文档(链接见第 8 节)和桌面自带 Claude Code 2.1.293 的 Mod 类型定义。文档说的是 API 行为,订阅链路的实际表现以实测为准。- 桌面启动的环境变量过滤,与 Mod 运行时设置是不同入口;正式生命周期是否一直保持有效,不能从一次文本请求推断。-- **思考签名**:Fable 5.1、Opus 5.5、Sonnet 5.5、Haiku 5.5 做前缀校验。替换历史里的一张图、缩短一个工具结果,或增删 `tools` 里的工具,都会让之后所有的思考块失效。2026-08-31 起注册的账号默认返回 400;更早的账号照样校验,但放行给模型。加 beta 头 `thinking-binding-controls-2026-08-01` 并设 `thinking.block_binding.prefix_mismatch_behavior: "error"`,老账号也按新账号拒绝,可用于实验;只加 beta 头、不设该字段,响应会列出放行的失效块。文档明说代理自己的改写也算编辑。服务端上下文编辑只能按规则清掉最早的工具结果,不能指定某张图,也碰不到用户消息里的图。待实测:订阅链路是否接受该 beta 头,Claude Code 收到 400 后怎么处理,用户自己的账号是哪一种。-- **说明消息的位置**:对话中途可以放 `role: "system"` 消息,不需要 beta 头,但它必须紧跟在用户消息之后,后面是助手消息或已是最后一条。所以 Codex 的位置(那一轮用户消息之前)在 Claude 上不合法。待实测:订阅链路是否接受,Claude 模型的效果。+- **思考签名**:Fable 5.1、Opus 5.5、Sonnet 5.5、Haiku 5.5 做前缀校验。替换历史里的一张图、缩短一个工具结果,或增删 `tools` 里的工具,都会让之后所有的思考块失效。2026-08-31 起注册的账号默认返回 400;更早的账号照样校验,但放行给模型。加 beta 头 `thinking-binding-controls-2026-08-01` 并设 `thinking.block_binding.prefix_mismatch_behavior: "error"`,老账号也按新账号拒绝,可用于实验;只加 beta 头、不设该字段,响应会列出放行的失效块。文档明说代理自己的改写也算编辑。服务端上下文编辑只能按规则清掉最早的工具结果,不能指定某张图,也碰不到用户消息里的图。2026-10-10 实测(见 2.1):订阅链路接受该 beta 头;400 由引擎接住、改发原始请求,Claude Code 看不到;用户自己的账号是放行的那种。+- **说明消息的位置**:对话中途可以放 `role: "system"` 消息,不需要 beta 头,但它必须紧跟在用户消息之后,后面是助手消息或已是最后一条。所以 Codex 的位置(那一轮用户消息之前)在 Claude 上不合法。2026-10-10 实测:订阅链路接受,效果见 2.1。- `turn.step` 只能改模型和推理强度,不是历史消息改写接口,不能替代请求改写引擎。### 2.3 尚未通过-带思考记录的图片取消/恢复、历史与请求中的图片出现记录对齐、完整桌面内面板、自动取图、续聊/分叉/多会话隔离、登录刷新、免配置安装及失败恢复。目前均不得标记为完成。+带思考记录的图片取消/恢复、历史与请求中的图片出现记录对齐、完整桌面内面板、自动取图、续聊/分叉/多会话隔离、登录刷新、免配置安装及失败恢复。目前均不得标记为完成。其中取消/恢复、对齐和自动取图已有 G04-1 的实测证据(见 2.1),正式验收还没做。## 3. 变更要求与追踪@@ -139,10 +142,9 @@ G04-1 任一核心能力失败时,不跳过关卡开发完整面板或宣称 v## 7. 开始正式实现前需确定-1. G04-1 的实测结论:订阅链路下账号放行还是拒绝、被拒后原样重发能否接上;`role: "system"` 说明的效果。-2. 正式专项验收的模型范围与成本上限(G04-1 用 Haiku 5.5),以及要覆盖的账号差异(2026-08-31 前后注册)。-3. Claude 插件的目录与清单,以及 MCP 服务在 Claude 下的 Node 运行环境;启动方式照原机制。-4. 规格维护者将确认内容同步到现行 spec/design,保留唯一事实来源。+1. 正式专项验收的模型范围与成本上限(G04-1 用 Haiku 5.5),以及要覆盖的账号差异(2026-08-31 前后注册)。++G04-1 的实测结论见 2.1;Claude 插件的目录、清单和 Node 运行环境见 design.md 第 12 节;确认的内容已写回 spec.md、design.md(2026-10-10)。## 8. 资料依据