dsh-anthropic-image-clamp:多图 Claude 请求前的图片尺寸钳制

前言

在 DeepSeek Harness(DSH)里走 Anthropic Messages API 时,会话里一旦累计超过 20 张内联图片,Anthropic 会把「单边最大像素」从通常允许的 8000px 收紧到 2000px。DSH 本身会把附件归一化到 2048×2048 的像素预算(长边 8192px),手机截图一类的小图往往原样保留;历史消息里图片一多,后续请求就容易撞上这条限制,整段对话直接报错。下面介绍社区插件 dsh-anthropic-image-clamp,它在发往 api.anthropic.com 的请求发出前,对超尺寸的 base64 内联图做确定性缩小,避免上述错误。

这是什么

dsh-anthropic-image-clamp 是 DSH 的 host 插件,由 noahchalifour 维护,当前版本 0.1.0(MIT 许可证)。它针对的错误信息形如:

messages.N.content.M.image.source.base64.data: At least one of the image
dimensions exceed max allowed size for many-image requests: 2000 pixels

插件通过包装对 api.anthropic.com/v1/messages 的 fetch,在请求体里扫描内联 base64 图片;若长边超过配置的 maxDimension(默认 2000),则先缩小再发送,从而满足「多图请求」下的 2000px 单边上限。

核心功能

  1. 拦截 Anthropic Messages 请求:仅作用于发往 Anthropic API 的 messages 调用,在出站前改写图片 payload。
  2. 按长边钳制尺寸:默认 maxDimension 为 2000,与多图场景下的 API 限制对齐。
  3. 确定性结果与内容哈希缓存:同一图片内容多次出现在历史重发中时,缩小结果一致,有利于 prompt cache 仍按字节命中。
  4. 可配置主机与阈值:可通过 profile 里的 patch 覆盖 maxDimension 与 hosts 列表。

运行环境要求 Node >= 22(见仓库 package.json 的 engines 字段)。

安装与启用

安装命令来自仓库 README,需指定 profile(示例为 desktop):

dsh plugin --profile desktop add github:noahchalifour/dsh-anthropic-image-clamp

安装完成后 重启 DSH,host 插件的 fetch 包装才会生效。

如需调整钳制边长或限定拦截域名,在对应 profile 的 cordis.patch.yml 中覆盖插件配置,例如:

- id: anthropic-image-clamp
  config: { maxDimension: 1568, hosts: [api.anthropic.com] }

典型用法

日常用法即:在 desktop(或其它 profile)安装插件并重启,之后照常使用 Claude 模型;当会话历史内联图片超过 20 张时,出站请求中的大图会在插件层被缩小,而无需手动改附件或清空历史。

若你同时使用了 subscriptions-plugin 提供的 HTTP 代理,需注意 README 中的说明:经该代理转发的请求可能走 undici 自带的 fetch,不会经过本插件的包装。在未配置此类代理的机器上,行为与 README 描述一致。

适用场景与注意

适合谁:在 DSH 中长期使用 Claude、会话里经常附带截图或设计稿、且容易在长对话里积累大量内联图片的开发者或智能体搭建者。

权限与安全:插件以当前 DSH 进程的权限运行,会读取并改写发往 Anthropic 的请求体中的图片数据。安装前建议在 GitHub 仓库阅读源码与 LICENSE(MIT),确认符合你的合规要求。

生态说明:DSH 采用「一切皆插件」的扩展方式;社区目录 SkillHub 插件页 为独立站点,与 DeepSeek / 幻方无官方从属关系,并非官方应用商店。

结尾

dsh-anthropic-image-clamp 解决的是 DSH + Anthropic 多图会话下的 2000px 单边限制,用出站前的确定性缩小替代整段失败。目录与源码:

  • 目录页:https://www.skillhub.cn/plugins/noahchalifour/dsh-anthropic-image-clamp
  • GitHub:https://github.com/noahchalifour/dsh-anthropic-image-clamp
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye