工具图像修复 Anonymousnake/dsh-cline-pass-toolimage-fix

dsh-cline-pass：工具结果图像从未到达模型

针对 dsh-cline-pass 提供商上由工具（harness 的 read_image）产生的图像的即插即用修复。用户附加的图像本来就能正常工作；由工具调用返回的图像在请求序列化期间被静默丢弃，因此模型只能读到文本信封（image/png image, 754x547 px, 17193 bytes），背后没有任何像素。

简体中文说明见下方。

根本原因

dsh-cline-pass/lib/adapter.js，serializeMessages()。工具结果被仅按文本展平为 OpenAI 的 role:"tool" 消息：

content: flattenText(result.content) || '(no output)'

read_image 返回 [{type:'text'}, {type:'image', attachment:{...}}] （dsh-tool-fs → imageReadContent()），因此 image 块从未到达传输层。
role:"user" 路径没有问题，这就是为什么只有工具产生的图像受到影响。

为什么图像不能搭载在工具消息内部

针对 Cline Pass 端点、同一合成样本、三种传输形态进行测量：

| 形态 | 结果 |
| 用户消息内的 image_url | 模型描述该图像 |
| role:"tool" 内容数组内的 image_url | 模型回答 NO_IMAGE |
| 在工具消息之后将图像提升到用户消息中 | 模型描述该图像 |

因此网关会忽略 role:"tool" 上的图像部分。修复方案是将它们提升出来，而不是试图让工具消息承载它们。

修复

serializeMessages() 中有两处改动，外加一个新辅助函数：

1. toolResultImageParts(result, images) 遍历工具结果（递归地），并将每个嵌套的 image 块具体化为 image_url data URI。无法解析的引用会抛出 UNSUPPORTED_CONTENT，与现有行为一致。
2. serializeMessages() 记录 tool-call id → name 的映射，保持工具消息仅含文本，并追加一条用户消息，携带该步骤提升出的图像，每个都标注为 Image returned by the tool call ():。

纯文本历史记录和用户附加的图像与之前走完全相同的路径。

应用

node apply-fix.mjs # patches every profile holding the plugin
node apply-fix.mjs --dry-run # report only

该脚本仅重写随附的 0.1.1 版 adapter.js（通过 SHA-256 13927d66… 匹配），将其备份到原文件旁边，并在验证失败时回滚。
任何其他修订版本只会被报告，不会被改动——请改用补丁：

git apply adapter-toolimage.patch # inside dsh-cline-pass/lib

然后重启 dsh web：插件代码在启动时加载，没有宿主插件 HMR。
dsh plugin update dsh-cline-pass 会覆盖此修复；之后请重新应用。

验证

node repro/generate-sample.mjs repro/sample.png # synthetic sample, no real documents
set CLINE_PASS_API_KEY=sk_...
node repro/probe.mjs

形态 A 和 C 必须描述该样本（三条色带）；形态 B 预期会回答 NO_IMAGE——这种不对称正是整个 bug 所在。

文件

| 路径 | 内容 |
| files/adapter-0.1.1.orig.js | 未修改的随附适配器（0.1.1） |
| files/adapter-0.1.1.fixed.js | 已修补的适配器 |
| adapter-toolimage.patch | 针对 0.1.1 的统一 diff |
| apply-fix.mjs | 安装 / 验证 / 回滚 |
| repro/probe.mjs | 三种形态的复现 |
| repro/generate-sample.mjs | 构建合成示例 PNG |

上游状态

已发布的包（最新 0.1.1）仍然存在该 bug。其 npm 元数据中没有 repository 字段，因此没有可提交 pull request 的上游仓库——本仓库取而代之，作为分发点。

已知限制

dsh-cline-pass 没有请求图像预算：历史记录中的每张图像都会被重新编码进每个请求体。包含大量图像的长时间会话会相应地增长。此处不予讨论。

中文说明

现象：模型 cline-pass/* 下调用 read_image 读图，工具成功返回 image/png image, 754x547 px,但模型只拿到这段文字元数据,看不到图像内容;用户自己贴图正常。

根因：dsh-cline-pass/lib/adapter.js 的 serializeMessages() 把工具结果压成 role:"tool" 消息时只取文本（flattenText(result.content)），read_image 返回的 image 块被丢在这一步。

为什么不能塞进 tool 消息：实测网关会忽略 role:"tool" 里的 image_url（模型回 NO_IMAGE），放进 user 消息才可见。所以修复采取"把工具产出的图提升为紧随其后的 user 消息"。

应用：node apply-fix.mjs，然后重启 dsh web（无 host 插件 HMR）。
dsh plugin update 会覆盖，升级后重打一次。

License

MIT. The patched files are derivative works of dsh-cline-pass (MIT, © its authors).