原生 DSH 插件，用 Chrome DevTools Protocol 把豆包桌面端变成 agent 的出图工具——无水印原图直接落到工作区，但只支持 Windows、紧贴界面且受额度限制。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-11-13
许可证
作者未说明
01它能帮你完成什么？
在 DeepSeek Harness 会话里出图，且不需要图像 API Key
豆包桌面端手上那张 2K 级无水印原图，下载到会话工作区的 `doubao-images/` 目录
Windows 上已经装了豆包桌面版、又不想按张付费的 DSH 用户
用一张参考图改图（P 图 / 图生图）
把参考图塞进豆包隐藏的文件输入框、上传完再发指令后得到的新图
想在 agent 里直接迭代一张现成图（水彩风、换风格）的用户
在同一个对话里批量出一小组图
同一对话里排队跑的 2~6 张图，最后统一归档一次，额度用完的每一条都会带标记
要做同一角色或同一主题系列图、不想反复切对话的人
02如何接入 DeepSeek Harness？
前置条件
- 豆包桌面版已安装并登录，主程序在 `D:\Doubao\app\Doubao.exe`（不是 launcher 的 `D:\Doubao\Doubao.exe`）
- Node.js 22+ —— DSH 运行时自带，插件用它跑子进程
- Windows：默认路径与快捷方式改法都是 Windows 专用的
安装步骤
- 01
运行 `dsh plugin --profile desktop add "link:D:\dsh-plugins\dsh-doubao-painter"` —— 这一步会把依赖写进 package.json，并自动把插件加进 `dsh.profile.bundles`
$ dsh plugin --profile desktop add "link:D:\dsh-plugins\dsh-doubao-painter"
- 02
如果 bundles 里没自动出现，手动在 `~/.dsh/profiles/desktop/package.json` 里加一行 `"dsh-doubao-painter"`
- 03
重启 DeepSeek Harness —— profile 的配置树只在启动时组装
- 04
让豆包带 `--remote-debugging-port=9225` 启动，或者改快捷方式让它以后都这样启动
验证接入成功
- 问 agent「豆包在线吗」，它会调用 `doubao_status` 自检并回报
- 排障兜底：`node tools\paint.mjs "test" --json` 会打印真实报错
03DSH 适配与能力边界
原生 DSH 插件：`lib/index.js` 是一个 cordis 插件壳，注册 doubao_paint 与 doubao_status 两个工具；用 `dsh plugin --profile desktop add "link:..."` 安装，由 profile 的 bundle 列表加载
doubao_paint 工具
一条提示词；图生图时给 `ref_images`；批量时给 `prompts` 数组→`{ files: ["<工作区>/doubao-images/doubao-....png"], seconds }`，文件就是下载好的原图
会操作豆包桌面窗口：开对话、输入提示词、点开图片把 PNG 写进会话工作区的 `doubao-images/`消耗你豆包账号的每日免费出图额度doubao_status 自检
对 agent 那句「豆包在线吗」给出在线 / 离线结论，第一次出图前就能看出环境是否就绪
CDP 桥（lib/bridge.mjs）
带 `--remote-debugging-port=9225` 启动的豆包，在 `127.0.0.1:9225` 暴露 Chrome DevTools Protocol→新对话、插入提示词、轮询 DOM 等图出现，最后下载 `cgen` 原图 URL
除非关掉会话复用，否则会在你的豆包账号里建对话把复用的 conversation id 记到 `~/.dsh/doubao-session.json`命令行兜底（`tools/paint.mjs`）
提示词参数，可加 `--ref <path>`、`--out`、`--json` 或 `--stdin-json`→在 shell 里拿到同样的图片，需要时输出机器可读 JSON
走同一个 CDP 桥，因此也操作同一个豆包窗口随包的豆包技能脚本（`tools/skill.mjs`、`tools/video.mjs`）
`%LOCALAPPDATA%\Doubao\User Data\Default\.doubao\agent_mode\workspace\.skills\` 下的本地技能目录→列出 112 个技能（47 个带脚本）；视频下载加转 mp3 可在本地跑，不消耗对话额度
会在你机器上跑豆包自带的沙箱 Python生图与云端媒体脚本在本地跑不通，需要豆包运行时注入的凭证
04适合谁？何时不该用？
适合
- Windows 上已经装了豆包桌面版、又不想按张付费的 DSH 用户
- 想在 agent 里直接迭代一张现成图（水彩风、换风格）的用户
- 要做同一角色或同一主题系列图、不想反复切对话的人
不适合
- 它通过 CDP 驱动 Windows 版豆包桌面端，默认可执行文件路径、快捷方式改法和整条链路都是 Windows 专用的；豆包必须带 `--remote-debugging-port` 启动，已经在普通模式下运行的实例要先完全退出（托盘 → 退出）。
- 它贴着豆包的界面工作：任务进行中会在你的窗口里点开图片预览、开新对话，并用文件锁保证同一时刻只跑一个任务；豆包一改 DOM 或 CDN 模板名就可能坏，修复点在 `lib/bridge.mjs` 的选择器里。
- 出图吃的是你豆包账号的每日免费额度，不是 API Key；额度用完时批量会提前收工并给每条打标记，而且一次返回几张由豆包自己决定。
05兼容性、维护与安全提示
- 它通过 CDP 驱动 Windows 版豆包桌面端，默认可执行文件路径、快捷方式改法和整条链路都是 Windows 专用的；豆包必须带 `--remote-debugging-port` 启动，已经在普通模式下运行的实例要先完全退出（托盘 → 退出）。
- 它贴着豆包的界面工作：任务进行中会在你的窗口里点开图片预览、开新对话，并用文件锁保证同一时刻只跑一个任务；豆包一改 DOM 或 CDN 模板名就可能坏，修复点在 `lib/bridge.mjs` 的选择器里。
- 出图吃的是你豆包账号的每日免费额度，不是 API Key；额度用完时批量会提前收工并给每条打标记，而且一次返回几张由豆包自己决定。
- 拿到无水印原图不等于免除标识义务：对外发布的 AI 生成内容仍要按相关规定做显著标识，README 也明确说它解决的是素材被平台 logo 污染，而不是绕过标识。
快照中未声明许可证（README 末尾只有一行 `MIT`）· 无 release · 仅 README 证据，未做安全审计
06常见问题
在 DeepSeek Harness 里怎么装 dsh-doubao-painter？
运行 `dsh plugin --profile desktop add "link:D:\dsh-plugins\dsh-doubao-painter"`，它会把依赖写进 package.json 并把插件加进 `dsh.profile.bundles`。如果 bundle 列表没自动带上，就在 `~/.dsh/profiles/desktop/package.json` 里手动加 `"dsh-doubao-painter"`，然后重启 DeepSeek Harness——profile 的配置树只在启动时组装。
它会往 DSH 工作区写什么？
生成的图落在会话工作区的 `doubao-images/`（`outSubdir` 默认值），工具返回文件路径。工作区之外只留一个小状态文件 `~/.dsh/doubao-session.json`，存它复用的 conversation id；删掉这个文件，下次就会新建一个豆包对话。
为什么豆包必须带调试端口启动？
插件通过 Chrome DevTools Protocol 在 `127.0.0.1:9225` 上跟这个 Electron 客户端通信。从快捷方式正常启动的实例没有这个端口，所以 README 给了把快捷方式 Target 改成 `D:\Doubao\app\Doubao.exe` 并加 `--remote-debugging-port=9225` 的做法。如果豆包已经在普通模式下运行，先从托盘完全退出，否则新实例抢不到端口。
这是接口集成还是界面自动化？
是对真实客户端的 CDP 自动化：开对话、往 ProseMirror 输入框插提示词、轮询 DOM 等图出现、点开图片拿到 `cgen` 原图 URL 再下载。所以它既不需要 API Key、也不按张付费，代价是豆包改版就可能坏，而且同一时刻只跑一个任务（用文件锁串行）。
拿回来的图可以直接对外发布吗？
插件拿的是豆包那份没有平台水印的版本，但 README 的合规提醒仍然成立：对外发布的 AI 生成内容要按所在地区规则做显著标识，这个义务插件不替你解除。另外它消耗的是豆包账号的每日免费出图额度，一次返回几张也由豆包决定。
07相关的 DSH 工作流
modlens
作者 liustack
The first vision plugin for DeepSeek Harness, and the vision bridge for every text-only coding agent. Paste an image, get structured JSON evidence (OCR, layout, semantics). | 全网最强 DeepSeek Harness 外挂视觉插件，为 DeepSeek、GLM 等纯文本模型外挂视觉能力，粘贴图片即得结构化 JSON 证据（OCR、版面、语义）。
dsh-image-gen
作者 shanliuling
可在对话内生成、编辑、对比图像；内置 500 + 提示词、图库、多模型工作流，支持 ComfyUI。AI image studio for DeepSeek Harness — generate, edit & compare images in chat, with 500+ prompts, gallery, multi-model workflows and ComfyUI.
dsh-vision-router
作者 ysr666
为纯文本 DeepSeek Harness 智能体提供「视觉」能力，内置免密钥视觉链路与像素级视觉工具，一条命令安装，无需 Python。
agent-vision-toolkit
作者 anionex
为纯文本模型"看图“设计更好的视觉工具箱和技能，支持多图理解，图片问答，前端UI还原、GUI 自动化等，并可选无缝接入多个主流agent，直接识别粘贴图片｜ A vision toolkit and skill designed for text-only llms — image Q&A, long-screenshot OCR, frontend UI restoration, and GUI automation, with optional seamless integration for Codex, Claude Code, Pi, Oh My Pi, and OpenCode
08数据与来源
把本机 **豆包桌面客户端**的生图能力接进 DeepSeek Harness：
lib/index.js cordis 插件壳：注册 doubao_paint / doubao_status
dsh plugin --profile desktop add "link:D:\dsh-plugins\dsh-doubao-painter"
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-11-13。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。