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.
Context Attachment Manager
Codex、Claude Code 等 Agent 多图对话的本地插件。
之前的图不再每条消息都重发一遍。模型要看哪张,按编号取回,对话压缩之后也一样。
它做什么
Agent 每发一条消息,通常会把之前所有的图再发一遍,图一多,对话就越来越慢,最后可能发不出去。这个插件给每张图编号(IMG-001、IMG-002……),之前的图改成发一段简短的占位:
- 模型要哪张取哪张:需要再看之前的某张图时,按编号取回原图。
- 认得出是哪张:模型给每张图记一行看得见的特征,也记下你对它的评价;这些写在占位里,对话压缩之后也还在。
- 什么都不删:原始图片和对话记录保持原样。
默认开着,不用打开面板。常见用法:图片和视频创作、扫描文档、电脑和浏览器操作。
安装
把这句话发给你的 Agent,它会认出自己所在的平台,完成对应的安装:
帮我安装 Context Attachment Manager 插件,按这里的说明来:https://github.com/chipfighter/context-attachment-manager/blob/main/INSTALL.md
装好后重启 Agent(Claude 桌面版是新建一个 Code 会话)。查看支持的平台,或阅读安装、更新和卸载说明(英文)。
想自己掌控时,打开面板
- 凭印象找图:搜“雨夜”或“脸最好”,按记得的特征和评价找回来。
- 固定重要参考:点开图片,勾上每轮都发。
- 自己选择图片:关掉自动选图,决定下一条消息带哪些图。
Codex:在任务的侧边面板里打开上下文素材。Claude 桌面版的 Code 标签页:有了图,面板就会自动打开;输入 /cam 可以再打开。
隐私
插件在本机运行。原始图片和对话记录保留在你的电脑上,请求仍发给 Agent 原本使用的服务。
效果测试
在 Codex 里,一段有九张关键帧的对话涨到 42.4 MB,重启或压缩之后发不出去;装上插件,同样的请求是 0.12 MB。结果和复现步骤见 Codex 对比评测与 Claude Code 长任务评测。
支持的平台
Codex 和 Claude Code 已实测,Codex 和 Claude 桌面版还有面板。下面其他平台也支持,接入是照各平台的代码和文档写的,但我们还没有实际测过。如果你在用其中某个,欢迎告诉我们用起来怎么样,能用和不能用都有帮助。
| 平台 | 简介 | 接入情况 |
|---|---|---|
| Codex | OpenAI 的编程智能体,桌面版和命令行 | 自动选图+面板,已实测 |
| Claude Code | Anthropic 的编程智能体,桌面版和命令行 | 自动选图+面板(桌面版),已实测 |
| WorkBuddy | 腾讯的桌面 AI 工作助手,内置 CodeBuddy | 自动选图,未实测 |
| OpenCode | 开源的终端编程智能体,能接任意模型服务 | 自动选图,未实测 |
| Gemini CLI | Google 开源的终端智能体 | 自动选图,未实测 |
| pi | 极简、可扩展的终端编程智能体 | 自动选图(pi 扩展),未实测 |
| DeepSeek Harness | DeepSeek 的智能体框架,一切皆插件 | 自动选图(dsh 插件),未实测 |
| Qwen Code | 通义千问开源的终端智能体 | 自动选图,未实测 |
| Cline | 开源的编程智能体,VS Code、JetBrains 和终端都能用 | 自动选图,未实测 |
| Kilo Code | 开源的编程智能体,VS Code、JetBrains 和终端都能用 | 自动选图,未实测 |
| goose | 开源的桌面和终端智能体,用 MCP 扩展 | 自动选图,未实测 |
| Cherry Studio | 开源的桌面 AI 聊天客户端,能接多家模型 | 自动选图,未实测 |
这些平台的安装步骤见 INSTALL.md(英文)。想接入别的 Agent,见接入说明(英文)。