用量看板出现在 · 后台收录

image-diet 图片瘦身

图片进入上下文前把长边压到 1280px,省下约六成图片 token。

image-diet 图片瘦身 · 效果预览 · 示意示意
> 给订单列表加上分页
⏺ 我先看看列表组件。
⏺ 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 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)。
  • 不处理粘贴到提示框的图片。