按需加载图片,减轻编程助手会话负担
Context Attachment Manager是面向Codex桌面端和Claude Desktop Code标签页的MIT许可本地插件,可省略历史图片并按ID取回。它支持固定参考图、手动选择附件,以及搜索图片描述和用户反馈,旨在减少长会话中的重复图片传输。
AI 深度解读
长对话里的图片越积越多,每次请求都带上历史图片,传输负担可能比预想的大。作者在一次用 GPT 反复改图的 Codex 长任务中遇到持续重连,当时携带累计图片历史的请求已达到约 44 MB。
为保留参考图、修改过程和反馈,作者做了本地插件 Context Attachment Manager:对话继续,旧图按需取回。它值得关注的地方,是把「记住有这张图」和「每轮都发送这张图」拆开了。不过,请求变小的实测结果,不能直接推导出费用下降或重连问题得到解决。
旧图片不必每轮发送,但要能随时找回来
Context Attachment Manager 面向 Codex desktop,以及 Claude Desktop 的 Code tab 中的本地会话。普通 Claude Chat 不在集成范围内。
开启 Auto-select 后,早先轮次的图片可以从后续请求中省略。模型需要重新查看时,再通过图片 ID 取回原图。对于角色参考图等需要持续可见的内容,可以固定,让它每轮发送;想自己决定,就关闭 Auto-select,用面板复选框手动选择。
这套做法保留了原有会话的连续性。用户不用为了减轻图片负担,重新开一个失去参考资料和修改反馈的对话。

找图也不必依赖文件名。模型会记录简短的图像特征和用户反馈,作为检索线索。用户可以搜索「雨夜」「脸最好的一版」这类记忆,再打开对应原图。这些线索可以在对话压缩后保留下来,帮助模型定位历史图片。
检索描述负责找图,涉及视觉细节的判断仍然要看原图。
例如,反馈里记着某张图的脸最好,并不足以判断它的眼睛、光影或局部修改是否符合新要求。原文也明确承认,文字线索无法替代原图检查。
请求从 24.9 MB 降到 212 KB,能证明什么
项目记录了一次包含 15 张图片的测试:下一次请求体从 24.9 MB 降到了 212 KB。面板还会估算请求大小,让用户在发送前看到变化。
这个数字支持一个范围明确的结论:在该场景中,减少重复携带的历史图片,可以显著缩小下一次请求。
但它不是通用收益承诺。某一轮保留多少图片、模型又取回多少图片,都会影响实际效果。如果任务要求反复比较大量原图,传输量仍可能增加。
作者没有提供 token 成本测量,也没有证明最初的重连一定由图片历史造成。因此,不能把这次结果写成「节省了同等比例的费用」,更不能据此判断所有重连都能修好。网络故障、本地渲染和模型容量问题,都超出插件处理范围。
本地代理怎样减负,兼容性又卡在哪里
插件用一个仅监听本机回环地址的引擎,放在客户端与已配置的模型端点之间。它把不需要发送的历史图片载荷替换成带编号的占位符,再转发请求;模型需要原图时,通过 MCP 工具取回。
可以把编号理解成原图的取件凭证:请求里先留一个可定位的标记,需要检查时再拿图片。
面板负责搜索、预览、固定和手动选择。原始对话记录与图片文件保持只读,插件不会额外把整份对话发给另一家云服务;正常模型请求仍然发往用户配置的提供商。它也不会缩小磁盘上的原始历史文件。
版本 0.9.0 会把每条路由同时绑定到客户端平台和原始上游地址。兼容的自定义端点也可以使用图片管理,但必须支持对应客户端的 API 格式、图片输入和工具调用。插件不会在 Responses 与 Anthropic Messages 之间转换协议。
项目采用 MIT 许可证,使用 TypeScript/Node 编写,支持 Windows、macOS、Linux,提供英文和简体中文界面。Windows 是主要人工测试平台;三平台 CI 覆盖单元测试,以及安装、启动、升级、卸载检查。维护者尚未实测第三方网关的真实模型调用,这部分兼容性仍需要实际验证。
我的判断
我认同它处理问题的切入点:长会话需要延续上下文,却未必需要反复传输每一张旧图。编号占位、文字检索和原图取回,给图片密集型任务提供了更细的控制。
相比重新开会话,它更有利于保留修改过程;相比全靠手动挑图,Auto-select 减少了操作。不过,自动模式能否及时找回正确图片,还取决于检索线索和模型的工具调用。关键参考图值得固定,细节判断则应确认模型确实看过原图。
现有证据主要证明了一次请求体缩减。原文没有给出延迟、任务完成质量、检索准确率,以及与其他做法的对照数据,这些收益仍属于设计预期,不能替它背书。
另外,原文披露文章由 AI agent 基于项目文档、实现和记录的测试结果起草并发布。判断时应看具体测试边界,不能把介绍文章当成独立评测。
能拿来做什么
- 如果你在 Codex 中连续调整页面截图、比较视觉参考,可以先观察下一次请求的估算大小,再决定使用 Auto-select 还是手动选择,并固定持续需要的参考图。
- 可以让 Codex 或 Claude Desktop Code 按 INSTALL.md 安装插件。安装后重启 Codex,或开启新的 Claude Code 会话;Codex 从任务侧栏的 Context Assets 进入,Claude Desktop Code 在会话有图片后打开面板,之后可用
/cam再次打开。 - 使用自定义端点时,先核对客户端 API 格式、图片输入和工具调用支持,再用包含历史图片取回的小任务验证。遇到问题,反馈客户端版本、平台和可复现步骤,尤其补充 macOS、Linux 或第三方网关上的实际表现。