image-diet 图片瘦身
图片进入上下文前把长边压到 1280px,省下约六成图片 token。
> 给订单列表加上分页
⏺ 我先看看列表组件。
⏺ Read(screenshot.png)
⎿ image-diet: shrank image from 2880x1800 to 1280x800 to save context.
⎿ For full resolution, copy the file to a name containing ".full."(示意)
后台运行,无界面。这里显示的是示意日志。
❯
示意。实际效果取决于 Mod、终端和运行环境。
安装
/plugin marketplace add sergical/claude-plugins
/plugin install image-diet@sergical
/reload-plugins在 Claude Code 会话里逐行执行这些命令。
claude plugin marketplace add sergical/claude-plugins
claude plugin install image-diet@sergical然后在会话里执行 /reload-plugins,或开一个新会话。
请帮我安装 Claude Code Mod「image-diet 图片瘦身」(https://github.com/sergical/claude-plugins)。安装前先阅读仓库 README 的 Security 和 Requirements 部分,告诉我它会读写哪些内容、运行什么命令、是否联网,以及对 Claude Code 版本、系统和终端的要求。确认没有问题后,运行 claude plugin marketplace add sergical/claude-plugins 和 claude plugin install image-diet@sergical 完成安装,最后提醒我在会话里执行 /reload-plugins。把这段话发给 Claude Code,它会先读原作者说明再安装。
git clone https://github.com/sergical/claude-plugins
cd claude-plugins
claude --plugin-dir ./plugins/image-diet克隆仓库后用 --plugin-dir 在本地会话中试用。
它会碰什么
据原作者说明,收录时核对;可用 claude plugin validate 自行检查。
读取
有读取 Read 和 MCP 工具返回的图片,以及 IMAGE_DIET_* 环境变量。
写入文件
有缩放时在临时目录写入图片副本,结束即删除;不改动原文件。
运行命令
有运行 sh 脚本,调用 sips(macOS)或 ImageMagick(Linux)缩放图片。
联网
有改写发给模型的图片,并在工具结果里附加尺寸说明;自身不发网络请求。
介绍
image-diet 是 Claude Code 的 function hooks Mod,在大图进入 Claude 上下文之前先把它缩小。截图很贵,一张 2000px 的截图要 3000–4800 个 token。
- Read 工具:长边超过 1280px 的 PNG 或 JPEG 先缩小再交给 Claude。
- MCP 工具:任何
mcp__*工具结果里的图片(浏览器截图、Figma 等)同样处理。 - 跳过点击类工具:名字含
computer、cua、browser_batch的工具不处理,否则点击坐标会错位。 - 告诉 Claude:每次缩小都附一句原尺寸和新尺寸;文件名含
.full.的不缩小,需要细节时可复制成这种名字再读。 - 安全失败:缩小失败时照常给原图。粘贴进提示框的图片不处理。
作者用 Opus 5.5 测了六类截图,1280px 时全部答对,图片 token 从 3240 降到 1334。可用 IMAGE_DIET_MAX_EDGE 调尺寸。macOS 用自带 sips,Linux 需 ImageMagick。需要 Claude Code 2.1.287 或更新版本。
适合谁
- 经常让 Claude 读截图、用浏览器 MCP 做网页检查的人
运行要求
- Claude Code ≥ 2.1.287
- macOS 使用自带 sips;Linux 需安装 ImageMagick(magick)。
- 不处理粘贴到提示框的图片。