前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在使用本地模型进行开发或工作流编排时，往往需要接入外部能力。doubao-dsh-plugin 正是为了解决“如何在 DSH 中无缝调用豆包模型能力”这一问题而生。
该插件通过本地运行的 Doubao Relay（Quicker 转发），为 DSH 注入 doubao_ask 工具，支持联网搜索、图片生成、多模态识图，并具备“粘贴图片转本地路径”的浏览器端捕获能力。
前置要求：Doubao Relay¶
本插件的所有能力（搜索、生图、识图）都依赖本地 Doubao Relay 的 OpenAI 兼容接口实现。插件本身不包含 Relay，需由 Quicker 软件将本地网页版豆包转发为 API 调用。
搭建步骤如下：
- 安装 Quicker 软件。
- 下载共享动作（点击获取）。
- ⚠️ 注意：该动作年久未更新，需手动替换代码。在 Quicker 中右键动作选择“编辑”，找到“运行 C# 代码”步骤，将
c#code.txt中的代码整体替换到脚本代码区，保存后重新运行动作。此时 Relay 将监听127.0.0.1:56666。
若未启动 Relay，工具调用会报错。
安装与启用¶
使用官方提供的 npm 一键安装命令：
dsh plugin --profile web add doubao-dsh-plugin
安装完成后，必须重启 harness 才能生效。客户端 bundle 会在启动时自动扫描装配。
核心功能¶
- 工具注入：注册
doubao_ask工具，模型启动后即可直接看到该工具。 - 联网搜索与生图：支持实时搜索和生成图片，图片以 Markdown 链接形式在对话中展示。
- 多模态识图：支持传入 URL、base64 或本地文件路径进行识图。若本地图片超过 512KB，会自动压缩至 800px 宽再发送。
- 粘贴图片转路径（paste-to-path）：这是本插件的特色功能。在浏览器端拦截
paste事件，将图片字节保存为私有临时文件（路径格式类似<temp>/doubao-dsh-paste/p-*/paste<ext>），并将路径文本插入输入框。纯文本模型不会触发“模型不支持图片”的准入拦截，模型看到路径后会调用doubao_ask并将image参数设为该路径。 - 图片去重与输出：自动折叠重复的图片链接，优先保留原图变体，输出结构化的
images字段。 - 日志记录：完整记录请求、响应等信息。
参数说明¶
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| query | string | 是 | 要搜索或询问的问题 |
| image | string | 否 | 图片路径（URL / data URL / 本地路径） |
| system | string | 否 | 额外系统指令 |
| timeoutMs | number | 否 | 超时毫秒数，默认 90000 |
使用方式¶
- 直接识图：直接将图片粘贴到输入框。浏览器捕获图片，保存为本地路径，模型随后调用工具识图。首次识图约需 15~20 秒（受 Relay 响应速度影响）。
- 指令交互：在对话中直接要求“搜索 X”或“生成一张 X 的图”，模型会自动调用本工具。
注意事项¶
- 该插件以 DSH 进程的权限运行，安装前请检查源码与许可证。
- 客户端代码在浏览器端运行，复用了 modlens 的验证实现逻辑。
- 每次请求会强制开启新的对话（
new_conversation）。
