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): streamline FrameKeeper introduction
chipfighterf484db64d4f4
diff --git a/README.md b/README.mdindex 09ad8ea..35485f9 100644--- a/README.md+++ b/README.md@@ -2,87 +2,67 @@<img src="plugin/assets/logo.png" width="96" height="96" alt=""></p>-<h1 align="center">Context Attachment Manager</h1>+<h1 align="center">FrameKeeper</h1>-<p align="center"><b>Stop paying the multimodal tax.</b><br>Automatic context management for images: install it and forget it. Earlier images step aside, and the model pulls back the one it needs.<br>Works with Codex, Claude Code, WorkBuddy, OpenCode, Gemini CLI and more agents.</p>+<p align="center"><b>Stop paying the multimodal tax.</b><br>Automatic multimodal context management for your AI agent.<br>Install it, keep working, and let the model manage its images.</p><p align="center">- <a href="https://github.com/chipfighter/context-attachment-manager/actions/workflows/ci.yml"><img src="https://github.com/chipfighter/context-attachment-manager/actions/workflows/ci.yml/badge.svg" alt="CI"></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>+ <a href="https://github.com/chipfighter/framekeeper/releases"><img src="https://img.shields.io/github/v/release/chipfighter/framekeeper?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">- <img src="https://img.shields.io/badge/Codex%20desktop-26.1013-339CFF" alt="Tested on Codex desktop 26.1013">- <img src="https://img.shields.io/badge/Claude%20Desktop-Claude%20Code%202.1.299-D97757" alt="Tested in Claude Desktop with Claude Code 2.1.299"><a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License: MIT"></a>+ <a href="CONTRIBUTING.md"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen" alt="PRs welcome"></a></p><p align="center"><b>English</b> · <a href="README_CN.md">简体中文</a> · <a href="README_JA.md">日本語</a></p>-<p align="center">- <img src="docs/images/loop.gif" alt="The panel on a task of period-drama keyframes. Turning on Auto-select grays out the earlier images one by one, and the next request drops from 7.5 MB to 1.7 MB, 77% less." width="100%">-</p>--<p align="center">- <img src="docs/images/hero.png" alt="Three views of the panel on a task of period-drama keyframes. Auto-select: the model manages its own images, and the card shows the next request at 1.7 MB instead of 7.5 MB. Search: typing best face finds the close-up the user called the best face three turns ago. Preview: that close-up shown full size." width="100%">-</p>--## The multimodal tax--Use a multimodal model in any agent and the images pile up. The model remembers nothing between turns, so every request sends the whole chat again, every earlier image included. A dozen images in, each message uploads tens of megabytes: the chat gets slower and pricier, then keeps reconnecting and never gets through. The way out is a new chat, and everything you built up is gone.--That price, paid again and again for old images, is the multimodal tax.--## Where you pay it--- **Generating images in a chat**: keyframes, posters, product shots, several a turn.-- **Reading scanned PDFs**: every page is an image.-- **Letting AI drive a computer or a browser**: a screenshot every step.-- **Talking about photos, screenshots and charts**: a few turns, a pile of images.--## What it does--- **The model manages its own images.** Earlier images stay out of your messages, and when the model needs one, it pulls that one back by itself. Nothing to set up. Pin the ones that matter, like a character reference, and they go with every message.-- **Find any image by what you remember.** Search "best face" or "rainy night", filter by place, or browse by turn. Click one to see it full size (the panel in Codex and Claude Desktop).-- **It remembers every image.** The model quietly notes what each image shows and what you said about it ("too dark", "best face"). Even far into a long chat, or after the chat is compacted, it picks the right one.-- **Your chat stays light.** No more slowdowns or endless reconnecting. In a 15-image task, a request that carried 24.9 MB went out at 212 KB.--## Watch the 30-second tour-https://github.com/user-attachments/assets/aeec27c0-c56a-4775-bcc8-981d5e9a0d45-[简体中文视频](README_CN.md#30-秒了解这个插件)+[简体中文视频](README_CN.md)-## How to use+## Made for multimodal work-- **Codex**: open **Context Assets** in a task's side panel.-- **Claude Desktop**: in the Code tab, the panel opens by itself next to your conversation once there are images. Type `/cam` to bring it back.+Old images travel through your conversation again and again. That growing burden is the multimodal tax. FrameKeeper manages them automatically, wherever your AI works with images:-Then just keep chatting. From the start, the model picks earlier images on its own; to pin one, click it and check **Send every turn**. To choose yourself, turn off **Auto-select** at the bottom of the panel.+- **Image and video creation**: character references, storyboards, keyframes, posters and product shots.+- **Reading documents**: scanned PDFs, page images and visual references.+- **Computer and browser use**: screenshots from every step of an agent's work.+- **Everyday multimodal chats**: photos, screenshots, charts and diagrams.-Using a gateway? Compatible Codex and Claude Code endpoints can use image management too. Requests continue to the endpoint you configured, with the client's model and credentials. The gateway must support the client's API format, image inputs and tool calls; see [endpoint support](INSTALL.md#custom-endpoints).+**Install it and keep working.** Auto-select is on by default: earlier images step aside, and the model brings back the ones it needs. It works as you chat, even if you never open the panel.## Install-Paste this to your agent (Codex, Claude Desktop's Code tab, or any agent in [Works with](#works-with)). It finds out which agent it runs in and installs for that one:+Send this to your agent. It identifies its platform and installs the right setup:```text-Install the Context Attachment Manager plugin for me, following https://github.com/chipfighter/context-attachment-manager/blob/main/INSTALL.md+Install FrameKeeper for me, following https://github.com/chipfighter/framekeeper/blob/main/INSTALL.md```-Then restart the agent (in Claude Desktop, start a new session). To install or uninstall it yourself, see [INSTALL.md](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).++## 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%">+</p>++- **Find an image** by a detail or a comment you remember, like "rainy night" or "best face".+- **Keep a reference in view**: open an image and check **Send every turn**.+- **Choose images yourself**: turn off **Auto-select** and pick what goes with your next message.++In **Codex**, open **Context Assets** in the task's side panel. In **Claude Desktop's Code tab**, the panel opens automatically when there are images; type `/cam` to bring it back.## Privacy-Everything stays on your computer. The plugin sends nothing anywhere beyond the requests Codex and Claude already make.+FrameKeeper 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 ran a short-drama keyframe chat in Codex with and without the plugin: nine keyframes, about 32 MB of images. Without the plugin, every time Codex had to send the whole chat again (after a restart, and right after compacting it), the request was 42 MB and never got through. With the plugin, the same request was 0.12 MB, and in this test the model picked the right image both before and after compacting. The method, the numbers and how to run it yourself are in [eval](eval/README.md).--We also ran a longer task in Claude Code: 51 images, compacted twice, then forked. With and without the plugin the model found nearly every image (19 or 20 of 20 questions), because the images were files on disk it could read again; in a chat this short the plugin cost about 30% more. Details are in the [long-task eval](eval/long-task/README.md).+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.## Works with-The plugin's core knows no platform; each one gets a thin adapter. The panel is in Codex and Claude Desktop; on the other agents, auto-select works on its own and the model still pulls back any image by its id.+Auto-select works across the agents below. Codex and Claude Desktop also include the panel.| Agent | What it is | Support ||---|---|---|@@ -100,6 +80,6 @@ The plugin's core knows no platform; each one gets a thin adapter. The panel is| [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) |-To install on any of them, paste the sentence in [Install](#install) to that agent; how each one is connected is in [INSTALL.md](INSTALL.md#other-agents). Something off? [Open an issue](https://github.com/chipfighter/context-attachment-manager/issues).+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).<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 6ebe765..cf8e38b 100644--- a/README_CN.md+++ b/README_CN.md@@ -2,87 +2,67 @@<img src="plugin/assets/logo.png" width="96" height="96" alt=""></p>-<h1 align="center">Context Attachment Manager</h1>+<h1 align="center">FrameKeeper 帧管家</h1>-<p align="center"><b>别再交多模态税。</b><br>多模态上下文的自动管理工具:装上就不用管,之前的图自动让位,模型要哪张取哪张。<br>Codex、Claude Code、WorkBuddy、OpenCode、Gemini CLI 等 Agent 平台都能接。</p>+<p align="center"><b>别再交多模态税。</b><br>给你的 Agent 用的多模态上下文自动管理工具。<br>装上照常用,图片交给模型自己管理。</p><p align="center">- <a href="https://github.com/chipfighter/context-attachment-manager/actions/workflows/ci.yml"><img src="https://github.com/chipfighter/context-attachment-manager/actions/workflows/ci.yml/badge.svg" alt="CI"></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">- <img src="https://img.shields.io/badge/Codex%20desktop-26.1013-339CFF" alt="在 Codex 桌面版 26.1013 上实测">- <img src="https://img.shields.io/badge/Claude%20Desktop-Claude%20Code%202.1.299-D97757" alt="在 Claude 桌面版(Claude Code 2.1.299)上实测">- <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="许可证:MIT"></a>+ <a href="https://github.com/chipfighter/framekeeper/releases"><img src="https://img.shields.io/github/v/release/chipfighter/framekeeper?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>+ <a href="CONTRIBUTING.md"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen" alt="PRs welcome"></a></p><p align="center"><a href="README.md">English</a> · <b>简体中文</b> · <a href="README_JA.md">日本語</a></p>-<p align="center">- <img src="docs/images/loop-zh.gif" alt="面板上是一个古装短剧关键帧的任务。打开自动选图,之前的图一张张变灰,下一条请求从 7.5 MB 降到 1.7 MB,省 77%。" width="100%">-</p>--<p align="center">- <img src="docs/images/hero-zh.png" alt="面板的三个画面,任务是古装短剧的关键帧。自动选图:模型自己管理图片,卡片显示下一条请求约 1.7 MB,全部发送要 7.5 MB。凭印象找图:搜索“最好”,找到三轮前用户说脸最好的那张特写。预览:这张特写的大图。" width="100%">-</p>--## 什么是多模态税--在任何 Agent 平台上用多模态模型,图都会越攒越多。模型不记事,每一轮请求都要把整段对话连同之前所有的图重新发一遍。图攒到十几张,发一条消息就要上传几十 MB:越聊越慢,越聊越贵,最后一直重连、发不出去,只能新开对话,前面攒下的东西全丢。--这笔为旧图反复付出的代价,就是多模态税。--## 哪些时候在交--- **在对话里生图、改图**:关键帧、海报、商品图,一轮就是好几张。-- **读扫描版 PDF**:每一页都是一张图。-- **让 AI 控制电脑或浏览器**:每走一步就是一张截图。-- **跟模型聊照片、截图、图表**:聊几轮就是一堆。--## 能做什么--- **模型自己管理图片。** 之前的图不再跟着每条消息重发,要用哪张,模型自己把那一张取回来,什么都不用设置。要紧的图,比如角色参考图,可以固定成每条消息都带上。-- **凭印象找图。** 搜“脸最好”或者“雨夜”,按地点筛选,或者按轮翻看,点开就是大图(Codex 和 Claude 桌面版的面板)。-- **每张图它都记得。** 模型会悄悄记下每张图画的是什么,以及你对它说过什么(“太暗”“这张脸最好”)。聊得再久,对话压缩过,它照样拿对图。-- **对话一直轻快。** 不再越聊越慢、反复重连。一个 15 张图的任务里,原本 24.9 MB 的请求,发出去只有 212 KB。--## 30 秒了解这个插件-https://github.com/user-attachments/assets/b9767a20-8ca4-4a33-86bc-5e0a16a2ed13-[English video](README.md#watch-the-30-second-tour)+[English video](README.md)-## 怎么用+## 为各种多模态场景而生-- **Codex**:在任务的侧边面板里打开**上下文素材**。-- **Claude 桌面版**:在 Code 标签页里,对话里有了图,面板就自己在对话旁边打开。输入 `/cam` 可以随时再打开。+旧图跟着对话一遍遍重发,越积越多,这份负担就是多模态税。FrameKeeper 自动管理这些图片,凡是 AI 需要看图的工作,都用得上:-然后照常聊天就行。一开始,模型就会自己挑之前的图;想固定某张,点开它,勾上**每轮都发**。想自己选,就关掉面板底部的**自动选图**。+- **图片和视频创作**:角色参考、分镜、关键帧、海报、商品图。+- **阅读文档**:扫描版 PDF、页面截图、图像资料。+- **操作电脑和浏览器**:Agent 每一步操作留下的截图。+- **日常多模态对话**:照片、截图、图表、示意图。-使用中转站时,兼容 Codex 或 Claude Code 的服务地址也能管理图片。请求仍发给你配置的服务,沿用客户端的模型和认证方式。中转站需要支持对应接口、图片输入和工具调用,详见 [服务地址支持范围](INSTALL.md#custom-endpoints)(英文)。+**装好以后,照常使用就行。** 自动选图默认开启,之前的图自动让位,模型要哪张就取回哪张。不打开面板、不手动挑图,它也在工作。## 安装-把这句话发给你的 Agent(Codex、Claude 桌面版的 Code 标签页,或者[支持的平台](#支持的平台)里的任何一个)。它会先认出自己在哪个平台,再装对应的那一份:+把这句话发给你的 Agent,它会认出自己所在的平台,完成对应的安装:```text-帮我安装 Context Attachment Manager 插件,按这里的说明来:https://github.com/chipfighter/context-attachment-manager/blob/main/INSTALL.md+帮我安装 FrameKeeper 插件,按这里的说明来:https://github.com/chipfighter/framekeeper/blob/main/INSTALL.md```-装好后重启这个 Agent(Claude 桌面版是新建一个会话)。想自己动手安装或卸载,看 [INSTALL.md](INSTALL.md)(英文)。+装好后重启 Agent(Claude 桌面版是新建一个 Code 会话)。查看[支持的平台](#支持的平台),或阅读[安装、更新和卸载说明](INSTALL.md)(英文)。++## 想自己掌控时,打开面板++<p align="center">+ <img src="docs/images/hero-zh.png" alt="FrameKeeper 面板:自动管理之前的图片,凭印象搜索,点开预览大图。" width="100%">+</p>++- **凭印象找图**:搜“雨夜”或“脸最好”,按记得的特征和评价找回来。+- **固定重要参考**:点开图片,勾上**每轮都发**。+- **自己选择图片**:关掉**自动选图**,决定下一条消息带哪些图。++**Codex**:在任务的侧边面板里打开**上下文素材**。**Claude 桌面版的 Code 标签页**:有了图,面板就会自动打开;输入 `/cam` 可以再打开。## 隐私-所有东西都留在你自己的电脑上。除了 Codex 和 Claude 本来就要发的请求,插件不往任何地方发数据。+FrameKeeper 在本机运行。原始图片和对话记录保留在你的电脑上,请求仍发给 Agent 原本使用的服务。## 效果测试-我们在 Codex 里拿一段短剧关键帧的对话,比较了装插件和不装插件:9 张关键帧,图片一共约 32 MB。不装插件时,只要 Codex 需要把整段对话重新发一遍(重启之后、压缩对话之后),请求就有 42 MB,一次也没发出去。装了插件,同样的请求只有 0.12 MB,这次测试里压缩前后模型都找对了图。测试方法、数据和自己复现的步骤见 [eval](eval/README_CN.md)。--我们还在 Claude Code 里跑了一段更长的任务:51 张图,压缩两次再分叉。装不装插件,模型都几乎找对了每张图(20 题答对 19 或 20 题),因为图都是磁盘上的文件,模型能再读一遍;在这么短的对话里,装插件多花约三成费用。详见[长任务评测](eval/long-task/README_CN.md)。+我们在 Codex 和 Claude Code 里测试了多图对话,包括聊很久、压缩对话之后再找回之前的图。结果和复现步骤见 [Codex 对比评测](eval/README_CN.md)与 [Claude Code 长任务评测](eval/long-task/README_CN.md)。## 支持的平台-插件的核心不认平台,每个平台只有一层薄薄的接入。面板只在 Codex 和 Claude 桌面版上有;其他平台装上后自动选图,模型照样按编号取回原图。+下面的平台都能自动选图,Codex 和 Claude 桌面版还提供面板。| 平台 | 简介 | 接入情况 ||---|---|---|@@ -100,6 +80,6 @@ https://github.com/user-attachments/assets/b9767a20-8ca4-4a33-86bc-5e0a16a2ed13| [Cherry Studio](https://github.com/CherryHQ/cherry-studio) | 开源的桌面 AI 聊天客户端,能接多家模型 | 自动选图,新接入,欢迎反馈 || **你的 Agent** | 写一层薄薄的接入,核心一行不用改 | 提个 PR,把你的平台加到这里:[接入说明](ADAPTERS.md)(英文) |-在哪个平台上装,就把[安装](#安装)里那句话发给那个平台的 Agent;各平台具体改了什么,见 [INSTALL.md](INSTALL.md#other-agents)(英文)。用下来有问题,欢迎[提 issue](https://github.com/chipfighter/context-attachment-manager/issues)。+想接入自己的 Agent?按[接入说明](ADAPTERS.md)(英文)提个 PR,把你的平台加到这里,一起让更多人看到。安装步骤见 [INSTALL.md](INSTALL.md#other-agents)(英文)。<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 55a1d96..9ac4aed 100644--- a/README_JA.md+++ b/README_JA.md@@ -2,89 +2,67 @@<img src="plugin/assets/logo.png" width="96" height="96" alt=""></p>-<h1 align="center">Context Attachment Manager</h1>+<h1 align="center">FrameKeeper</h1>-<p align="center"><b>マルチモーダル税は、もう払わない。</b><br>画像コンテキストの自動管理ツール。入れたら後は任せるだけで、以前の画像は自動で外れ、必要な画像はモデルが取り出します。<br>Codex、Claude Code、WorkBuddy、OpenCode、Gemini CLI などのエージェントに対応。</p>+<p align="center"><b>マルチモーダル税は、もう払わない。</b><br>AI エージェントのためのマルチモーダルコンテキスト自動管理ツール。<br>インストールしたら、画像の管理はモデルに任せて、いつもどおり使うだけ。</p><p align="center">- <a href="https://github.com/chipfighter/context-attachment-manager/actions/workflows/ci.yml"><img src="https://github.com/chipfighter/context-attachment-manager/actions/workflows/ci.yml/badge.svg" alt="CI"></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>+ <a href="https://github.com/chipfighter/framekeeper/releases"><img src="https://img.shields.io/github/v/release/chipfighter/framekeeper?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">- <img src="https://img.shields.io/badge/Codex%20desktop-26.1013-339CFF" alt="Codex デスクトップ版 26.1013 で動作確認">- <img src="https://img.shields.io/badge/Claude%20Desktop-Claude%20Code%202.1.299-D97757" alt="Claude Desktop の Claude Code 2.1.299 で動作確認">- <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="ライセンス:MIT"></a>+ <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="MIT ライセンス"></a>+ <a href="CONTRIBUTING.md"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen" alt="PRs welcome"></a></p><p align="center"><a href="README.md">English</a> · <a href="README_CN.md">简体中文</a> · <b>日本語</b></p>-<p align="center">- <img src="docs/images/loop.gif" alt="時代劇のキーフレームを扱うパネル。Auto-select をオンにすると以前の画像が順にグレーになり、次のリクエストが 7.5 MB から 1.7 MB へ、77% 小さくなります。" width="100%">-</p>--<p align="center">- <img src="docs/images/hero.png" alt="パネルの 3 つの表示例。自動選択では、すべての画像を送ると 7.5 MB のリクエストが約 1.7 MB に。検索では best face と入力して、以前いちばん良い顔だと評価した画像を探せます。プレビューでは、その画像を大きく表示できます。" width="100%">-</p>--## マルチモーダル税とは--どのエージェントでもマルチモーダルモデルを使えば、画像はたまっていきます。モデルはターンをまたいで記憶しないため、毎回のリクエストで会話全体を、以前の画像もすべて含めて送り直します。画像が十数枚になると、1 通ごとに数十 MB をアップロードすることになり、会話は遅く、高くなり、やがて再接続を繰り返して送れなくなります。新しい会話を始めれば送れますが、それまで積み重ねた内容は失われます。+https://github.com/user-attachments/assets/aeec27c0-c56a-4775-bcc8-981d5e9a0d45-古い画像のために何度も払うこのコストが、マルチモーダル税です。+[英語版の動画](README.md) · [中国語版の動画](README_CN.md)-## 払っている場面+## さまざまなマルチモーダル作業に-- **会話の中で画像を生成・修正する**:キーフレーム、ポスター、商品画像など、1 ターンで何枚も。-- **スキャンした PDF を読ませる**:1 ページが 1 枚の画像です。-- **AI にパソコンやブラウザーを操作させる**:1 ステップごとにスクリーンショット。-- **写真・スクリーンショット・グラフについて話す**:数ターンで画像の山に。+古い画像が会話の中で何度も送り直され、負担が積み重なる。それがマルチモーダル税です。FrameKeeper は画像を自動で管理し、AI が画像を見るさまざまな作業に役立ちます。-## できること+- **画像・動画の制作**:キャラクターの参考画像、絵コンテ、キーフレーム、ポスター、商品画像。+- **文書を読む**:スキャンした PDF、ページ画像、図版資料。+- **パソコンやブラウザーの操作**:エージェントが操作のたびに見るスクリーンショット。+- **日常のマルチモーダル会話**:写真、スクリーンショット、グラフ、図解。-- **モデルが画像を自分で管理。** 過去の画像を毎回送り直さず、必要な画像だけをモデルが取り出します。特別な設定は不要です。キャラクターの参考画像など、常に見てほしい画像は毎回送るように固定できます。-- **覚えていることから画像を検索。** 「いちばん良い顔」「雨の夜」などで検索したり、場所で絞り込んだり、会話のターンごとに画像を探したりできます。クリックすると大きなプレビューが開きます(Codex と Claude Desktop のパネル)。-- **会話を圧縮した後も画像を探せる。** モデルは、画像の特徴とあなたの感想(「暗すぎる」「この顔がいちばん良い」など)を、会話の本文には表示せずに記録します。長い会話でも、会話を圧縮した後でも、必要な画像を探す手がかりになります。-- **会話の送信量を削減。** 画像が 15 枚あるタスクのテストでは、24.9 MB あったリクエストが 212 KB になりました。+**インストールしたら、いつもどおり使うだけ。** 自動選択は最初からオン。以前の画像は自動で外れ、必要な画像だけをモデルが取り出します。パネルを開いたり、画像を手で選んだりしなくても働きます。## インストール-次の文をお使いのエージェント(Codex、Claude Desktop の **Code** タブ、または[対応エージェント](#対応エージェント)のいずれか)に送ってください。エージェントは自分がどれかを確かめてから、それに合わせてインストールします。+次の文をお使いのエージェントに送ってください。実行中のプラットフォームを確認し、それに合わせてインストールします。```text-次の手順に従って、Context Attachment Manager プラグインをインストールしてください:https://github.com/chipfighter/context-attachment-manager/blob/main/INSTALL.md+次の手順に従って、FrameKeeper をインストールしてください:https://github.com/chipfighter/framekeeper/blob/main/INSTALL.md```-インストール後はエージェントを再起動してください(Claude Desktop では **Code** タブで新しいセッションを始めてください)。手動でのインストール、更新、アンインストールの手順は、共通の [INSTALL.md](INSTALL.md)(英語)にあります。+インストール後はエージェントを再起動してください(Claude Desktop では新しい Code セッションを始めてください)。[対応エージェント](#対応エージェント)、[インストール・更新・アンインストールの手順](INSTALL.md)(英語)もご覧ください。-## パネルを開く+## 自分で選びたいときは、パネルで-- **Codex**:タスクを開き、右上の **Toggle side panel** でサイドパネルを表示します。**+** から新しいタブを開き、**Plugins and MCPs** の **Context Assets** を選んでください。見つからない場合は、Codex を一度再起動してください。-- **Claude Desktop**:**Code** タブの会話に画像があると、会話の隣にある内蔵ブラウザーでパネルが自動的に開きます。もう一度開きたいときは `/cam` を入力して送信してください。新しいセッションの最初のメッセージが `/cam` の場合、入力欄にコマンドが存在しないと表示されることがありますが、そのまま送信できます。--パネルは英語・簡体字中国語・日本語に対応し、Codex または Claude Desktop の言語設定に合わせて表示されます。左上の会話名は言語を切り替えても変わりません。以下では共通の操作名が分かるよう、英語名に日本語の説明を添えています。--## Auto-select と Send every turn--新しいタスクやセッションでは、**Auto-select**(画像の自動選択)が最初からオンになっています。そのまま会話を続ければ、以前のターンの画像は必要なときだけモデルが取り出します。--キャラクターの参考画像などを毎回見てほしい場合は、画像をクリックしてプレビューを開き、**Send every turn**(毎ターン送信)にチェックを入れてください。チェックした画像は毎回送られ、それ以外の過去の画像はモデルが必要に応じて取り出します。チェックしていない画像がグレーで表示されていても、削除されたわけではありません。--送る画像を自分で選びたい場合は、パネル下部の **Auto-select** をオフにしてください。手動モードでは、プレビューの **Send**(送信)のチェックで、その画像を次のメッセージから送るかどうかを切り替えられます。変更はすぐに保存され、元の画像や会話履歴はそのまま残ります。+<p align="center">+ <img src="docs/images/hero.png" alt="FrameKeeper のパネル:過去の画像を自動管理し、覚えている特徴から検索して、大きくプレビューできます。" width="100%">+</p>-画像を探すには、検索欄に覚えている特徴や当時の感想を入力してください。場所での絞り込みや、ターンごとの一覧も使えます。プレビューは画像の外側をクリックするか、**Esc** キーで閉じられます。+- **覚えていることから検索**:「雨の夜」「いちばん良い顔」など、画像の特徴や感想で探せます。+- **大切な参考画像を固定**:画像を開き、**Send every turn**(毎ターン送信)にチェックを入れます。+- **送る画像を自分で選択**:**Auto-select**(自動選択)をオフにして、次のメッセージに含める画像を選びます。-独自のゲートウェイを使う場合も、Codex または Claude Code と互換性のある接続先で画像を管理できます。リクエストは設定済みの接続先に送られ、クライアントのモデルと認証情報を引き継ぎます。接続先には、クライアントの API 形式、画像入力、ツール呼び出しへの対応が必要です。詳しくは [接続先の対応範囲](INSTALL.md#custom-endpoints)(英語)をご覧ください。+**Codex** ではタスクのサイドパネルから **Context Assets** を開きます。**Claude Desktop の Code タブ**では画像があると自動で開き、`/cam` で再び開けます。## プライバシー-元の画像や会話履歴は自分のコンピューターに残ります。Codex や Claude が通常行うリクエスト以外に、プラグインがデータを外部へ送ることはありません。+FrameKeeper はローカルで動作します。元の画像と会話履歴は自分のコンピューターに残り、リクエストはエージェントが元から使っているサービスに送られます。## 効果の検証-Codex で短編ドラマのキーフレーム 9 枚、合計約 32 MB の画像を使い、プラグインの有無を比較しました。プラグインなしでは、再起動後や会話の圧縮直後に会話全体を再送するとリクエストが 42 MB になり、送信できませんでした。プラグインありでは同じリクエストが 0.12 MB になり、このテストでは会話の圧縮前後とも必要な画像を正しく選べました。検証方法、結果、再現手順は [eval](eval/README.md)(英語)をご覧ください。+Codex と Claude Code で画像の多い会話をテストし、長い会話や会話の圧縮後に以前の画像を取り出す動作も確認しました。結果と再現手順は [Codex の比較検証](eval/README.md)と [Claude Code の長期タスク検証](eval/long-task/README.md)(英語)をご覧ください。## 対応エージェント-プラグインのコアはどのエージェントにも依存せず、エージェントごとに薄い接続層があるだけです。パネルは Codex と Claude Desktop のみで、ほかのエージェントでは自動選択がそのまま働き、モデルは番号で元の画像を取り出せます。+以下のエージェントで自動選択が使えます。Codex と Claude Desktop にはパネルもあります。| エージェント | 概要 | 対応状況 ||---|---|---|@@ -102,6 +80,6 @@ Codex で短編ドラマのキーフレーム 9 枚、合計約 32 MB の画像| [Cherry Studio](https://github.com/CherryHQ/cherry-studio) | 多くのモデルにつながるオープンソースのデスクトップ AI チャット | 自動選択、新規対応、フィードバック歓迎 || **あなたのエージェント** | 薄い接続層を書くだけで、コアは変更不要 | PR を送って、ここに追加してください:[ADAPTERS.md](ADAPTERS.md)(英語) |-どのエージェントでも、[インストール](#インストール)の文をそのエージェントに送ればインストールできます。各エージェントで何を変更するかは [INSTALL.md](INSTALL.md#other-agents)(英語)にあります。問題があれば [issue](https://github.com/chipfighter/context-attachment-manager/issues) でお知らせください。+お使いのエージェントも接続しませんか?[接続層の作り方](ADAPTERS.md)(英語)を参考に PR を送り、この一覧に追加してください。設定手順は [INSTALL.md](INSTALL.md#other-agents)(英語)をご覧ください。<p align="center"><sub><a href="CHANGELOG.md">変更履歴(英語)</a> · <a href="CONTRIBUTING.md">開発への参加(英語)</a> · <a href="LICENSE">MIT ライセンス</a></sub></p>