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(readme): back to Context Attachment Manager, plain tool wording
chipfighterdea2d7cec647
diff --git a/ADAPTERS.md b/ADAPTERS.mdindex 3322f1a..8eb5f5f 100644--- a/ADAPTERS.md+++ b/ADAPTERS.md@@ -1,6 +1,6 @@# Connecting an agent-Context Attachment Manager cuts the multimodal tax on any agent: earlier turns' images go out as short placeholders, and the model pulls back the one it needs by its id. The plugin has three layers:+Context Attachment Manager can work with any agent through a thin adapter: earlier turns' images go out as short placeholders, and the model pulls back the one it needs by its id. The plugin has three layers:- **The core** (`plugin/src/core`) knows no platform. It decides what to leave out, numbers the images and keeps them for the fetch tool.- **Request-format translators** (`plugin/src/adapters/protocols`) find the images in a request and put the core's decision into it. Four formats today: OpenAI Responses, OpenAI Chat Completions, Anthropic Messages, Gemini generateContent.@@ -10,7 +10,7 @@ The panel (pick images, pin, search) is only in Codex and Claude Desktop. Every## Agents you can connect now-WorkBuddy, OpenCode, Gemini CLI, pi, DeepSeek Harness, Qwen Code, Cline, Kilo Code, goose and Cherry Studio. These adapters were written from each agent's code and docs and are **not tested live yet**. If one does not work for you, please [open an issue](https://github.com/chipfighter/context-attachment-manager/issues) with what you saw.+WorkBuddy, OpenCode, Gemini CLI, pi, DeepSeek Harness, Qwen Code, Cline, Kilo Code, goose and Cherry Studio. These adapters were written from each agent's code and docs and are **not tested live yet**. If you use one of them, please [open an issue](https://github.com/chipfighter/context-attachment-manager/issues) and tell us how it went, whether it worked or not.How to install, step by step (also for an AI doing it for you): [INSTALL.md, Other agents](INSTALL.md#other-agents). In short, from a clone of this repository:diff --git a/README.md b/README.mdindex 0bb2267..40d3f39 100644--- a/README.md+++ b/README.md@@ -2,38 +2,38 @@<img src="plugin/assets/logo.png" width="96" height="96" alt=""></p>-<h1 align="center">FrameKeeper</h1>+<h1 align="center">Context Attachment Manager</h1>-<p align="center"><b>Keep earlier images usable throughout long-running agent work.</b><br>Images can leave the current context and remain part of the task.<br>Automatic management. Original images on demand.</p>+<p align="center"><b>A local plugin for image-heavy chats in Codex, Claude Code and other agents.</b><br>Earlier images stop going out with every message. The model fetches the one it needs by its ID, also after the chat is compacted.</p><p align="center">- <a href="https://github.com/chipfighter/framekeeper/releases"><img src="https://img.shields.io/github/v/release/chipfighter/framekeeper?include_prereleases" alt="Release"></a>+ <a href="https://github.com/chipfighter/context-attachment-manager/releases"><img src="https://img.shields.io/github/v/release/chipfighter/context-attachment-manager?include_prereleases" alt="Release"></a><img src="https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey" alt="Platform: Windows, macOS, Linux"><a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License: MIT"></a></p><p align="center"><b>English</b> · <a href="README_CN.md">简体中文</a> · <a href="README_JA.md">日本語</a></p>-https://github.com/user-attachments/assets/aeb90ea2-6cb9-4f7a-9db7-8b4cd382430e--[简体中文视频](README_CN.md) · [日本語動画](README_JA.md)+<p align="center">+ <img src="docs/images/loop.gif" alt="The panel on a task with fifteen keyframes. With auto-select on, earlier images turn grey and the next request drops from 7.5 MB to 1.7 MB." width="100%">+</p>-## Images stay part of the task+## What it does-An image can leave the current request without losing its place in the task. In Codex and Claude Code, FrameKeeper preserves the link between images, visual details and your feedback:+An agent normally sends every earlier image again with each message, so a long chat with many images gets slow and can stop going through. This plugin numbers each image (`IMG-001`, `IMG-002`, …) and sends earlier ones as short placeholders instead:-- **Find the right reference**: stable image IDs, visual descriptions and your feedback help the model identify an image discussed earlier.-- **Inspect the original**: when details matter, the model retrieves the original image on demand and looks again.-- **Continue after compaction**: the image index survives conversation compaction, so earlier originals remain identifiable and retrievable.+- **The model fetches what it needs**: when it has to look at an earlier image again, it gets the original back by its ID.+- **It can tell images apart**: the model notes one line on what each image shows, plus your comments on it. These stay in the placeholders, also after the chat is compacted.+- **Nothing is deleted**: your original images and chat history stay as they are.-**Automatic by default. Keep working.** Use it for image and video creation, scanned documents, computer and browser use, or everyday visual chats. It works even if you never open the panel or pick images yourself.+It is on by default; you do not need to open the panel. Typical uses: image and video creation, scanned documents, computer and browser use.## InstallSend this to your agent. It identifies its platform and installs the right setup:```text-Install FrameKeeper for me, following https://github.com/chipfighter/framekeeper/blob/main/INSTALL.md+Install Context Attachment Manager for me, following https://github.com/chipfighter/context-attachment-manager/blob/main/INSTALL.md```Then restart the agent (in Claude Desktop, start a new Code session). See [supported agents](#works-with) and [installation, updates and uninstall](INSTALL.md).@@ -41,7 +41,7 @@ Then restart the agent (in Claude Desktop, start a new Code session). See [suppo## The panel, when you want control<p align="center">- <img src="docs/images/hero.png" alt="The FrameKeeper panel: automatically manage earlier images, search by what you remember, and preview an image." width="100%">+ <img src="docs/images/hero.png" alt="The panel: automatically manage earlier images, search by what you remember, and preview an image." width="100%"></p>- **Find an image** by a detail or a comment you remember, like "rainy night" or "best face".@@ -52,32 +52,31 @@ In **Codex**, open **Context Assets** in the task's side panel. In **Claude Desk## Privacy-FrameKeeper runs locally. Your original images and chat history stay on your computer; requests go to the service your agent already uses.+The plugin runs locally. Your original images and chat history stay on your computer; requests go to the service your agent already uses.## How we tested-We tested image-heavy conversations in Codex and Claude Code, including finding earlier images after long chats and compaction. See the [Codex comparison](eval/README.md) and [Claude Code long-task comparison](eval/long-task/README.md) for the results and reproduction steps.+In Codex, a chat with nine keyframes grew to 42.4 MB and could not be sent after a restart or a compaction; with the plugin the same requests were 0.12 MB. See the [Codex comparison](eval/README.md) and [Claude Code long-task comparison](eval/long-task/README.md) for the results and reproduction steps.## Works with-Auto-select works across the agents below. Codex and Claude Desktop also include the panel.+Codex and Claude Code are tested, and Codex and Claude Desktop also have the panel. The other agents below are supported through adapters written from their code and docs, but we have not tested them live yet. If you use one of them, please [tell us how it went](https://github.com/chipfighter/context-attachment-manager/issues), whether it worked or not.| Agent | What it is | Support ||---|---|---|| [Codex](https://github.com/openai/codex) | OpenAI's coding agent, desktop and CLI | Auto-select + panel, tested || [Claude Code](https://github.com/anthropics/claude-code) | Anthropic's coding agent, desktop and CLI | Auto-select + panel (desktop), tested |-| [WorkBuddy](https://www.workbuddy.cn) | Tencent's desktop AI work assistant, with CodeBuddy inside | Auto-select, new, feedback welcome |-| [OpenCode](https://github.com/anomalyco/opencode) | Open-source terminal coding agent for any model provider | Auto-select, new, feedback welcome |-| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | Google's open-source terminal agent | Auto-select, new, feedback welcome |-| [pi](https://github.com/earendil-works/pi) | Minimal, extensible terminal coding agent | Auto-select (pi extension), new, feedback welcome |-| [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) | DeepSeek's agent harness where everything is a plugin | Auto-select (dsh plugin), new, feedback welcome |-| [Qwen Code](https://github.com/QwenLM/qwen-code) | Qwen's open-source terminal agent | Auto-select, new, feedback welcome |-| [Cline](https://github.com/cline/cline) | Open-source coding agent for VS Code, JetBrains and the terminal | Auto-select, new, feedback welcome |-| [Kilo Code](https://github.com/Kilo-Org/kilocode) | Open-source coding agent for VS Code, JetBrains and the terminal | Auto-select, new, feedback welcome |-| [goose](https://github.com/aaif-goose/goose) | Open-source agent for desktop and terminal, extended with MCP | Auto-select, new, feedback welcome |-| [Cherry Studio](https://github.com/CherryHQ/cherry-studio) | Open-source desktop chat client for many models | Auto-select, new, feedback welcome |-| **Your agent** | A thin adapter; the core stays as it is | Send a PR and add your agent here: [ADAPTERS.md](ADAPTERS.md) |--Want to connect your own agent? [Build an adapter](ADAPTERS.md), send a PR and add your platform to this list. For setup instructions, see [INSTALL.md](INSTALL.md#other-agents).+| [WorkBuddy](https://www.workbuddy.cn) | Tencent's desktop AI work assistant, with CodeBuddy inside | Auto-select, not tested yet |+| [OpenCode](https://github.com/anomalyco/opencode) | Open-source terminal coding agent for any model provider | Auto-select, not tested yet |+| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | Google's open-source terminal agent | Auto-select, not tested yet |+| [pi](https://github.com/earendil-works/pi) | Minimal, extensible terminal coding agent | Auto-select (pi extension), not tested yet |+| [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) | DeepSeek's agent harness where everything is a plugin | Auto-select (dsh plugin), not tested yet |+| [Qwen Code](https://github.com/QwenLM/qwen-code) | Qwen's open-source terminal agent | Auto-select, not tested yet |+| [Cline](https://github.com/cline/cline) | Open-source coding agent for VS Code, JetBrains and the terminal | Auto-select, not tested yet |+| [Kilo Code](https://github.com/Kilo-Org/kilocode) | Open-source coding agent for VS Code, JetBrains and the terminal | Auto-select, not tested yet |+| [goose](https://github.com/aaif-goose/goose) | Open-source agent for desktop and terminal, extended with MCP | Auto-select, not tested yet |+| [Cherry Studio](https://github.com/CherryHQ/cherry-studio) | Open-source desktop chat client for many models | Auto-select, not tested yet |++Setup for these agents: [INSTALL.md](INSTALL.md#other-agents). To connect another agent, see [ADAPTERS.md](ADAPTERS.md).<p align="center"><sub><a href="CHANGELOG.md">Changelog</a> · <a href="CONTRIBUTING.md">Contributing</a> · <a href="LICENSE">MIT License</a></sub></p>diff --git a/README_CN.md b/README_CN.mdindex 25ef5b2..e92f9fc 100644--- a/README_CN.md+++ b/README_CN.md@@ -2,38 +2,38 @@<img src="plugin/assets/logo.png" width="96" height="96" alt=""></p>-<h1 align="center">FrameKeeper 帧管家</h1>+<h1 align="center">Context Attachment Manager</h1>-<p align="center"><b>让 Agent 在长任务中,持续使用它看过的图片。</b><br>图片退出当前上下文,仍然是任务的一部分。<br>自动管理,需要时取回原图。</p>+<p align="center"><b>Codex、Claude Code 等 Agent 多图对话的本地插件。</b><br>之前的图不再每条消息都重发一遍。模型要看哪张,按编号取回,对话压缩之后也一样。</p><p align="center">- <a href="https://github.com/chipfighter/framekeeper/releases"><img src="https://img.shields.io/github/v/release/chipfighter/framekeeper?include_prereleases" alt="版本"></a>+ <a href="https://github.com/chipfighter/context-attachment-manager/releases"><img src="https://img.shields.io/github/v/release/chipfighter/context-attachment-manager?include_prereleases" alt="版本"></a><img src="https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey" alt="支持 Windows、macOS、Linux"><a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="MIT 许可证"></a></p><p align="center"><a href="README.md">English</a> · <b>简体中文</b> · <a href="README_JA.md">日本語</a></p>-https://github.com/user-attachments/assets/5a674aa3-9723-4b33-afa8-75693feb1cda--[English video](README.md) · [日语视频](README_JA.md)+<p align="center">+ <img src="docs/images/loop-zh.gif" alt="面板上是一个有十五张关键帧的任务。打开自动选图,之前的图变灰,下一条请求从 7.5 MB 降到 1.7 MB。" width="100%">+</p>-## 图片,始终是任务的一部分+## 它做什么-一张图可以退出当前请求,仍然保留在任务里。在 Codex 和 Claude Code 中,FrameKeeper 保留图片、视觉特征和你对它的评价之间的联系:+Agent 每发一条消息,通常会把之前所有的图再发一遍,图一多,对话就越来越慢,最后可能发不出去。这个插件给每张图编号(`IMG-001`、`IMG-002`……),之前的图改成发一段简短的占位:-- **找得到**:稳定编号、视觉特征和你的评价,帮助模型认出之前讨论的是哪张图。-- **拿得回**:需要核对细节时,模型按需取回原图,重新看图继续工作。-- **接得上**:长对话经过压缩后,图片索引仍然保留,之前的原图依旧可以识别和取回。+- **模型要哪张取哪张**:需要再看之前的某张图时,按编号取回原图。+- **认得出是哪张**:模型给每张图记一行看得见的特征,也记下你对它的评价;这些写在占位里,对话压缩之后也还在。+- **什么都不删**:原始图片和对话记录保持原样。-**默认自动完成,照常使用就行。** 图片和视频创作、扫描文档、电脑与浏览器操作、日常看图对话,都可以使用。不打开面板、不手动挑图,它也在工作。+默认开着,不用打开面板。常见用法:图片和视频创作、扫描文档、电脑和浏览器操作。## 安装把这句话发给你的 Agent,它会认出自己所在的平台,完成对应的安装:```text-帮我安装 FrameKeeper 插件,按这里的说明来:https://github.com/chipfighter/framekeeper/blob/main/INSTALL.md+帮我安装 Context Attachment Manager 插件,按这里的说明来:https://github.com/chipfighter/context-attachment-manager/blob/main/INSTALL.md```装好后重启 Agent(Claude 桌面版是新建一个 Code 会话)。查看[支持的平台](#支持的平台),或阅读[安装、更新和卸载说明](INSTALL.md)(英文)。@@ -41,7 +41,7 @@ https://github.com/user-attachments/assets/5a674aa3-9723-4b33-afa8-75693feb1cda## 想自己掌控时,打开面板<p align="center">- <img src="docs/images/hero-zh.png" alt="FrameKeeper 面板:自动管理之前的图片,凭印象搜索,点开预览大图。" width="100%">+ <img src="docs/images/hero-zh.png" alt="面板:自动管理之前的图片,凭印象搜索,点开预览大图。" width="100%"></p>- **凭印象找图**:搜“雨夜”或“脸最好”,按记得的特征和评价找回来。@@ -52,32 +52,31 @@ https://github.com/user-attachments/assets/5a674aa3-9723-4b33-afa8-75693feb1cda## 隐私-FrameKeeper 在本机运行。原始图片和对话记录保留在你的电脑上,请求仍发给 Agent 原本使用的服务。+插件在本机运行。原始图片和对话记录保留在你的电脑上,请求仍发给 Agent 原本使用的服务。## 效果测试-我们在 Codex 和 Claude Code 里测试了多图对话,包括聊很久、压缩对话之后再找回之前的图。结果和复现步骤见 [Codex 对比评测](eval/README_CN.md)与 [Claude Code 长任务评测](eval/long-task/README_CN.md)。+在 Codex 里,一段有九张关键帧的对话涨到 42.4 MB,重启或压缩之后发不出去;装上插件,同样的请求是 0.12 MB。结果和复现步骤见 [Codex 对比评测](eval/README_CN.md)与 [Claude Code 长任务评测](eval/long-task/README_CN.md)。## 支持的平台-下面的平台都能自动选图,Codex 和 Claude 桌面版还提供面板。+Codex 和 Claude Code 已实测,Codex 和 Claude 桌面版还有面板。下面其他平台也支持,接入是照各平台的代码和文档写的,但我们还没有实际测过。如果你在用其中某个,欢迎[告诉我们用起来怎么样](https://github.com/chipfighter/context-attachment-manager/issues),能用和不能用都有帮助。| 平台 | 简介 | 接入情况 ||---|---|---|| [Codex](https://github.com/openai/codex) | OpenAI 的编程智能体,桌面版和命令行 | 自动选图+面板,已实测 || [Claude Code](https://github.com/anthropics/claude-code) | Anthropic 的编程智能体,桌面版和命令行 | 自动选图+面板(桌面版),已实测 |-| [WorkBuddy](https://www.workbuddy.cn) | 腾讯的桌面 AI 工作助手,内置 CodeBuddy | 自动选图,新接入,欢迎反馈 |-| [OpenCode](https://github.com/anomalyco/opencode) | 开源的终端编程智能体,能接任意模型服务 | 自动选图,新接入,欢迎反馈 |-| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | Google 开源的终端智能体 | 自动选图,新接入,欢迎反馈 |-| [pi](https://github.com/earendil-works/pi) | 极简、可扩展的终端编程智能体 | 自动选图(pi 扩展),新接入,欢迎反馈 |-| [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) | DeepSeek 的智能体框架,一切皆插件 | 自动选图(dsh 插件),新接入,欢迎反馈 |-| [Qwen Code](https://github.com/QwenLM/qwen-code) | 通义千问开源的终端智能体 | 自动选图,新接入,欢迎反馈 |-| [Cline](https://github.com/cline/cline) | 开源的编程智能体,VS Code、JetBrains 和终端都能用 | 自动选图,新接入,欢迎反馈 |-| [Kilo Code](https://github.com/Kilo-Org/kilocode) | 开源的编程智能体,VS Code、JetBrains 和终端都能用 | 自动选图,新接入,欢迎反馈 |-| [goose](https://github.com/aaif-goose/goose) | 开源的桌面和终端智能体,用 MCP 扩展 | 自动选图,新接入,欢迎反馈 |-| [Cherry Studio](https://github.com/CherryHQ/cherry-studio) | 开源的桌面 AI 聊天客户端,能接多家模型 | 自动选图,新接入,欢迎反馈 |-| **你的 Agent** | 写一层薄薄的接入,核心一行不用改 | 提个 PR,把你的平台加到这里:[接入说明](ADAPTERS.md)(英文) |--想接入自己的 Agent?按[接入说明](ADAPTERS.md)(英文)提个 PR,把你的平台加到这里,一起让更多人看到。安装步骤见 [INSTALL.md](INSTALL.md#other-agents)(英文)。+| [WorkBuddy](https://www.workbuddy.cn) | 腾讯的桌面 AI 工作助手,内置 CodeBuddy | 自动选图,未实测 |+| [OpenCode](https://github.com/anomalyco/opencode) | 开源的终端编程智能体,能接任意模型服务 | 自动选图,未实测 |+| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | Google 开源的终端智能体 | 自动选图,未实测 |+| [pi](https://github.com/earendil-works/pi) | 极简、可扩展的终端编程智能体 | 自动选图(pi 扩展),未实测 |+| [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) | DeepSeek 的智能体框架,一切皆插件 | 自动选图(dsh 插件),未实测 |+| [Qwen Code](https://github.com/QwenLM/qwen-code) | 通义千问开源的终端智能体 | 自动选图,未实测 |+| [Cline](https://github.com/cline/cline) | 开源的编程智能体,VS Code、JetBrains 和终端都能用 | 自动选图,未实测 |+| [Kilo Code](https://github.com/Kilo-Org/kilocode) | 开源的编程智能体,VS Code、JetBrains 和终端都能用 | 自动选图,未实测 |+| [goose](https://github.com/aaif-goose/goose) | 开源的桌面和终端智能体,用 MCP 扩展 | 自动选图,未实测 |+| [Cherry Studio](https://github.com/CherryHQ/cherry-studio) | 开源的桌面 AI 聊天客户端,能接多家模型 | 自动选图,未实测 |++这些平台的安装步骤见 [INSTALL.md](INSTALL.md#other-agents)(英文)。想接入别的 Agent,见[接入说明](ADAPTERS.md)(英文)。<p align="center"><sub><a href="CHANGELOG.md">更新记录</a> · <a href="CONTRIBUTING.md">参与开发</a> · <a href="LICENSE">MIT 许可证</a></sub></p>diff --git a/README_JA.md b/README_JA.mdindex 64325b1..ba22629 100644--- a/README_JA.md+++ b/README_JA.md@@ -2,38 +2,38 @@<img src="plugin/assets/logo.png" width="96" height="96" alt=""></p>-<h1 align="center">FrameKeeper</h1>+<h1 align="center">Context Attachment Manager</h1>-<p align="center"><b>長いタスクでも、以前見た画像を使い続ける。</b><br>画像が今のコンテキストから外れても、タスクとのつながりは残ります。<br>管理は自動。必要なときに元画像を取り出せます。</p>+<p align="center"><b>Codex、Claude Code などのエージェントで、画像が多い会話のためのローカルプラグイン。</b><br>以前の画像をメッセージごとに送り直しません。必要な画像はモデルが ID で取り出します。会話を圧縮したあとも同じです。</p><p align="center">- <a href="https://github.com/chipfighter/framekeeper/releases"><img src="https://img.shields.io/github/v/release/chipfighter/framekeeper?include_prereleases" alt="リリース"></a>+ <a href="https://github.com/chipfighter/context-attachment-manager/releases"><img src="https://img.shields.io/github/v/release/chipfighter/context-attachment-manager?include_prereleases" alt="リリース"></a><img src="https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey" alt="対応 OS:Windows、macOS、Linux"><a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="MIT ライセンス"></a></p><p align="center"><a href="README.md">English</a> · <a href="README_CN.md">简体中文</a> · <b>日本語</b></p>-https://github.com/user-attachments/assets/d6de1b05-d789-45f4-a764-a82079ace896--[英語版の動画](README.md) · [中国語版の動画](README_CN.md)+<p align="center">+ <img src="docs/images/loop.gif" alt="15 枚のキーフレームがあるタスクのパネル。自動選択をオンにすると以前の画像が灰色になり、次のリクエストが 7.5 MB から 1.7 MB に減ります。" width="100%">+</p>-## 画像は、タスクの一部であり続ける+## できること-画像を今のリクエストから外しても、タスクの中で参照し続けられます。Codex と Claude Code では、FrameKeeper が画像、見た目の特徴、あなたの評価のつながりを保ちます。+エージェントは通常、メッセージを送るたびに以前の画像をすべて送り直します。画像が増えると会話は重くなり、送信できなくなることもあります。このプラグインは画像ごとに番号(`IMG-001`、`IMG-002`…)を付け、以前の画像の代わりに短いプレースホルダーを送ります。-- **必要な画像を見つける**:変わらない画像 ID、見た目の特徴、あなたの評価を手がかりに、以前話した画像を特定できます。-- **元画像を見直す**:細部を確認したいときは、モデルが必要な元画像を取り出して、もう一度見られます。-- **会話を圧縮しても続けられる**:画像の索引が残るので、過去の元画像を引き続き特定して取り出せます。+- **必要な画像だけ取り出す**:以前の画像をもう一度見る必要があるとき、モデルが ID で元画像を取り出します。+- **どの画像か見分けられる**:モデルが画像ごとに見た目の特徴を一行で記録し、あなたの評価も残します。これはプレースホルダーに入るので、会話を圧縮したあとも残ります。+- **何も削除しない**:元の画像と会話履歴はそのままです。-**最初から自動。いつもどおり作業を続けるだけ。** 画像・動画の制作、スキャン文書、パソコンやブラウザーの操作、日常の画像を使った会話に。パネルを開いたり、画像を手で選んだりしなくても働きます。+最初からオンで、パネルを開く必要はありません。主な用途:画像・動画の制作、スキャン文書、パソコンやブラウザーの操作。## インストール次の文をお使いのエージェントに送ってください。実行中のプラットフォームを確認し、それに合わせてインストールします。```text-次の手順に従って、FrameKeeper をインストールしてください:https://github.com/chipfighter/framekeeper/blob/main/INSTALL.md+次の手順に従って、Context Attachment Manager をインストールしてください:https://github.com/chipfighter/context-attachment-manager/blob/main/INSTALL.md```インストール後はエージェントを再起動してください(Claude Desktop では新しい Code セッションを始めてください)。[対応エージェント](#対応エージェント)、[インストール・更新・アンインストールの手順](INSTALL.md)(英語)もご覧ください。@@ -41,7 +41,7 @@ https://github.com/user-attachments/assets/d6de1b05-d789-45f4-a764-a82079ace896## 自分で選びたいときは、パネルで<p align="center">- <img src="docs/images/hero.png" alt="FrameKeeper のパネル:過去の画像を自動管理し、覚えている特徴から検索して、大きくプレビューできます。" width="100%">+ <img src="docs/images/hero.png" alt="パネル:過去の画像を自動管理し、覚えている特徴から検索して、大きくプレビューできます。" width="100%"></p>- **覚えていることから検索**:「雨の夜」「いちばん良い顔」など、画像の特徴や感想で探せます。@@ -52,32 +52,31 @@ https://github.com/user-attachments/assets/d6de1b05-d789-45f4-a764-a82079ace896## プライバシー-FrameKeeper はローカルで動作します。元の画像と会話履歴は自分のコンピューターに残り、リクエストはエージェントが元から使っているサービスに送られます。+プラグインはローカルで動作します。元の画像と会話履歴は自分のコンピューターに残り、リクエストはエージェントが元から使っているサービスに送られます。## 効果の検証-Codex と Claude Code で画像の多い会話をテストし、長い会話や会話の圧縮後に以前の画像を取り出す動作も確認しました。結果と再現手順は [Codex の比較検証](eval/README.md)と [Claude Code の長期タスク検証](eval/long-task/README.md)(英語)をご覧ください。+Codex では、9 枚のキーフレームがある会話が 42.4 MB になり、再起動や圧縮のあとに送信できませんでした。プラグインを入れると、同じリクエストは 0.12 MB でした。結果と再現手順は [Codex の比較検証](eval/README.md)と [Claude Code の長期タスク検証](eval/long-task/README.md)(英語)をご覧ください。## 対応エージェント-以下のエージェントで自動選択が使えます。Codex と Claude Desktop にはパネルもあります。+Codex と Claude Code は動作確認済みで、Codex と Claude Desktop にはパネルもあります。ほかのエージェントにも対応しています。接続層は各エージェントのコードとドキュメントをもとに書きましたが、まだ実際には試していません。お使いの方は、動いたかどうか[ぜひ教えてください](https://github.com/chipfighter/context-attachment-manager/issues)。| エージェント | 概要 | 対応状況 ||---|---|---|| [Codex](https://github.com/openai/codex) | OpenAI のコーディングエージェント(デスクトップ版・CLI) | 自動選択+パネル、動作確認済み || [Claude Code](https://github.com/anthropics/claude-code) | Anthropic のコーディングエージェント(デスクトップ版・CLI) | 自動選択+パネル(デスクトップ版)、動作確認済み |-| [WorkBuddy](https://www.workbuddy.cn) | Tencent のデスクトップ AI アシスタント(CodeBuddy 内蔵) | 自動選択、新規対応、フィードバック歓迎 |-| [OpenCode](https://github.com/anomalyco/opencode) | どのモデルサービスにもつながるオープンソースのターミナル型エージェント | 自動選択、新規対応、フィードバック歓迎 |-| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | Google のオープンソースのターミナル型エージェント | 自動選択、新規対応、フィードバック歓迎 |-| [pi](https://github.com/earendil-works/pi) | ミニマルで拡張できるターミナル型コーディングエージェント | 自動選択(pi 拡張)、新規対応、フィードバック歓迎 |-| [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) | すべてがプラグインの DeepSeek のエージェント基盤 | 自動選択(dsh プラグイン)、新規対応、フィードバック歓迎 |-| [Qwen Code](https://github.com/QwenLM/qwen-code) | Qwen のオープンソースのターミナル型エージェント | 自動選択、新規対応、フィードバック歓迎 |-| [Cline](https://github.com/cline/cline) | VS Code・JetBrains・ターミナルで使えるオープンソースのコーディングエージェント | 自動選択、新規対応、フィードバック歓迎 |-| [Kilo Code](https://github.com/Kilo-Org/kilocode) | VS Code・JetBrains・ターミナルで使えるオープンソースのコーディングエージェント | 自動選択、新規対応、フィードバック歓迎 |-| [goose](https://github.com/aaif-goose/goose) | MCP で拡張できる、デスクトップとターミナルのオープンソースエージェント | 自動選択、新規対応、フィードバック歓迎 |-| [Cherry Studio](https://github.com/CherryHQ/cherry-studio) | 多くのモデルにつながるオープンソースのデスクトップ AI チャット | 自動選択、新規対応、フィードバック歓迎 |-| **あなたのエージェント** | 薄い接続層を書くだけで、コアは変更不要 | PR を送って、ここに追加してください:[ADAPTERS.md](ADAPTERS.md)(英語) |--お使いのエージェントも接続しませんか?[接続層の作り方](ADAPTERS.md)(英語)を参考に PR を送り、この一覧に追加してください。設定手順は [INSTALL.md](INSTALL.md#other-agents)(英語)をご覧ください。+| [WorkBuddy](https://www.workbuddy.cn) | Tencent のデスクトップ AI アシスタント(CodeBuddy 内蔵) | 自動選択、未検証 |+| [OpenCode](https://github.com/anomalyco/opencode) | どのモデルサービスにもつながるオープンソースのターミナル型エージェント | 自動選択、未検証 |+| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | Google のオープンソースのターミナル型エージェント | 自動選択、未検証 |+| [pi](https://github.com/earendil-works/pi) | ミニマルで拡張できるターミナル型コーディングエージェント | 自動選択(pi 拡張)、未検証 |+| [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) | すべてがプラグインの DeepSeek のエージェント基盤 | 自動選択(dsh プラグイン)、未検証 |+| [Qwen Code](https://github.com/QwenLM/qwen-code) | Qwen のオープンソースのターミナル型エージェント | 自動選択、未検証 |+| [Cline](https://github.com/cline/cline) | VS Code・JetBrains・ターミナルで使えるオープンソースのコーディングエージェント | 自動選択、未検証 |+| [Kilo Code](https://github.com/Kilo-Org/kilocode) | VS Code・JetBrains・ターミナルで使えるオープンソースのコーディングエージェント | 自動選択、未検証 |+| [goose](https://github.com/aaif-goose/goose) | MCP で拡張できる、デスクトップとターミナルのオープンソースエージェント | 自動選択、未検証 |+| [Cherry Studio](https://github.com/CherryHQ/cherry-studio) | 多くのモデルにつながるオープンソースのデスクトップ AI チャット | 自動選択、未検証 |++これらのエージェントの設定手順は [INSTALL.md](INSTALL.md#other-agents)(英語)をご覧ください。ほかのエージェントを接続するには [ADAPTERS.md](ADAPTERS.md)(英語)をご覧ください。<p align="center"><sub><a href="CHANGELOG.md">変更履歴(英語)</a> · <a href="CONTRIBUTING.md">開発への参加(英語)</a> · <a href="LICENSE">MIT ライセンス</a></sub></p>diff --git a/docs/spec.md b/docs/spec.mdindex 6f63c03..4bb89a5 100644--- a/docs/spec.md+++ b/docs/spec.md@@ -364,7 +364,7 @@ v0.1 之前的阶段验收(阶段 0 的重建路线、代理路线 P2)都已2. Codex 和 Claude 的行为不变:原有单元测试和冒烟测试全过;各种勾选组合下改写结果和拆之前逐字节相同;模型自测不退化(gpt-6-sol,中英文)。3. 有对外的接入接口文档(英文)和契约测试;面板在文档里是可选的一节,新平台默认不接。4. 其他平台只接核心、不带面板:WorkBuddy、OpenCode、Gemini CLI、pi、Qwen Code、Cline、Kilo Code、goose、Cherry Studio 的请求经过引擎,之前各轮的图按自动选图省略,模型能按编号取回;DeepSeek Harness 用顶替官方插件的 dsh 插件,新一轮开始时卸载之前各轮的图。用户 2026-11-02 定不在本机实跑:按各平台的代码和文档写接入,用合成请求测试,README 的平台表标明没实测,等用户反馈。-5. README 开头改成多模态税的口径,删掉“为什么做这个”,底部有平台表(简介和接入情况);`ADAPTERS.md` 写各平台的接法和怎么加新平台。+5. README 用平实的工具写法(用户 2026-11-07 定:名字改回 Context Attachment Manager,不再用 FrameKeeper 和多模态税的口径),底部有平台表(简介和接入情况,没实测的标“未实测”,欢迎在用的人反馈);`ADAPTERS.md` 写各平台的接法和怎么加新平台。6. 安装:用户把 README 里那句话发给所在平台的 Agent,Agent 照 INSTALL.md 装对平台。平台由各平台给命令设的环境变量认出(`cam detect`),认不出或认出多个就问用户;只接核心的平台由 `cam connect <平台> --apply` 改设置(记下改了哪几项、原来是什么;不复制文件,因为里面常有 API key),`cam disconnect` 撤回,用户之后改过的设置不动。7. Codex 被换模型的工具(如 cc-switch)改写服务地址后,引擎重新接上,请求经过引擎发往用户新选的服务商;用户停用了插件就不再接。