FrameKeeper 帧管家

让 Agent 在长任务中，持续使用它看过的图片。
图片退出当前上下文，仍然是任务的一部分。
自动管理，需要时取回原图。

English · 简体中文 · 日本語

https://github.com/user-attachments/assets/5a674aa3-9723-4b33-afa8-75693feb1cda

English video · 日语视频

图片，始终是任务的一部分

一张图可以退出当前请求，仍然保留在任务里。在 Codex 和 Claude Code 中，FrameKeeper 保留图片、视觉特征和你对它的评价之间的联系：

• 找得到：稳定编号、视觉特征和你的评价，帮助模型认出之前讨论的是哪张图。
• 拿得回：需要核对细节时，模型按需取回原图，重新看图继续工作。
• 接得上：长对话经过压缩后，图片索引仍然保留，之前的原图依旧可以识别和取回。

默认自动完成，照常使用就行。 图片和视频创作、扫描文档、电脑与浏览器操作、日常看图对话，都可以使用。不打开面板、不手动挑图，它也在工作。

安装

把这句话发给你的 Agent，它会认出自己所在的平台，完成对应的安装：

帮我安装 FrameKeeper 插件，按这里的说明来：https://github.com/chipfighter/framekeeper/blob/main/INSTALL.md

装好后重启 Agent（Claude 桌面版是新建一个 Code 会话）。查看支持的平台，或阅读安装、更新和卸载说明（英文）。

想自己掌控时，打开面板

• 凭印象找图：搜“雨夜”或“脸最好”，按记得的特征和评价找回来。
• 固定重要参考：点开图片，勾上每轮都发。
• 自己选择图片：关掉自动选图，决定下一条消息带哪些图。

Codex：在任务的侧边面板里打开上下文素材。Claude 桌面版的 Code 标签页：有了图，面板就会自动打开；输入 /cam 可以再打开。

隐私

FrameKeeper 在本机运行。原始图片和对话记录保留在你的电脑上，请求仍发给 Agent 原本使用的服务。

效果测试

我们在 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 聊天客户端，能接多家模型	自动选图，新接入，欢迎反馈
你的 Agent	写一层薄薄的接入，核心一行不用改	提个 PR，把你的平台加到这里：接入说明（英文）

想接入自己的 Agent？按接入说明（英文）提个 PR，把你的平台加到这里，一起让更多人看到。安装步骤见 INSTALL.md（英文）。

_{更新记录 · 参与开发 · MIT 许可证}