前言¶

在 DSH（DeepSeek Harness）里做智能体时，配图往往要单独接一套文生图 API：要申请密钥、对账计费，还要自己处理落盘与比例参数。若你本来就有腾讯元宝账号，更希望「提示词 → 多张 PNG 落盘」走元宝网页版（混元 Hy Image）的真实能力，而不是再维护一条 HTTP 集成，可以把 dsh-yuanbao-t2i 挂进本地 DSH profile。下面介绍它是什么、怎么装、怎么在会话里调用。

这是什么¶

dsh-yuanbao-t2i 是社区维护的 DSH 本地插件（维护者 lm846802297-bit，GitHub 仓库 lm846802297-bit/dsh-yuanbao-t2i，在 SkillHub 插件目录 分类为「联网工具」）。当前发布版本为 v0.10.7（以仓库 package.json 与目录页为准），许可证 MIT。

插件通过 patchright 驱动真实浏览器访问 yuanbao.tencent.com，复用你自己账号的登录会话（首次需微信扫码，会话保存在本地 profile）。它向智能体暴露工具 yuanbao_t2i（文生图 / 图生图）和 yuanbao_t2i_styles（检索元宝官方画风模板），并在 DSH 设置 → 插件 提供设置卡，用于配置输出目录与是否去水印。

性质上这是自动化浏览器操作，不是腾讯官方 SDK。频繁调用可能触发平台风控，使用前请自行阅读元宝服务条款并评估账号风险。

核心功能¶

文生图与图生图¶

• 工具 yuanbao_t2i：传入中文 prompt，插件弹出或复用浏览器，请求元宝 /api/chat/ 的 SSE，从 type=replace 帧的 multimedias[] 取图，下载后以 PNG 落盘（单次通常 4 张）。
• 传入 refImages（本地路径、URL 或文件夹，最多 5 张）即走图生图：参考图由元宝前端上传控件处理，插件不做签名。
• 从 v0.7.0 起，imageRatio、imageResolution、imageModel 会操作元宝「AI 生图」界面的真实控件，协议落点在 extra.image_gen_param；默认比例为 16:9（若需要旧版竖版默认，可显式传 imageRatio: "3:4"）。

画风预设¶

• v0.8.0 起支持 style 参数：从元宝官方模板库的 image2image 类模板（README 称 1000+ 条画风类模板）取完整画风描述，剥掉比例与指令前缀后拼到你的提示词后。
• 用 yuanbao_t2i_styles 按关键词检索画风名；模板列表首次联网拉取并缓存到 ~/.dsh/yuanbao-t2i-templates.json（约一周刷新）。

插件设置卡与落盘¶

• 设置 → 插件 → dsh-yuanbao-t2i → 生成设置：可设输出目录（v0.5.1 起 Windows 上可用「选择目录…」按钮）、是否生成后自动去水印。
• 配置写入 ~/.dsh/yuanbao-t2i-config.json；未指定 outDir 时，界面留空则默认 ~/.dsh/yuanbao-t2i-out。
• 同一浏览器 profile 不能并行打开，插件内部对调用串行化。

可选去水印（LaMa）¶

• 右下角「元宝 AI生成」水印默认不去除；开启 removeWatermark 或设置卡开关后，使用 Big-LaMa（wmEngine 仅支持 lama；telea 已于 v0.5.0 下架）。
• v0.10.0 起撤下用户侧的「修复范围」开关：掩膜由引擎内部 auto 自适应（紧贴字形 tight 与整块矩形 rect 之间自动选路，含残痕自检）。排障时可设环境变量 DSH_WM_MASK=tight 或 rect。
• 去水印需额外 Python 依赖：pip install torch simple-lama-inpainting（可用 DSH_LAMA_PYTHON 指定解释器）。失败时 v0.8.1 起返回字段 watermarkError，避免静默保留带水印原图。

安装与启用¶

本插件是 DSH 的 bundle + dual-face 包（宿主半 lib/plugin.js，浏览器半 client.js），按 README 挂到 profile 的 vendor/，而不是一条通用的 dsh plugin add 命令。步骤如下。

1. 将仓库放到 profile 的 vendor/ 下，例如
   C:/Users/<你>/.dsh/profiles/desktop/vendor/yuanbao-t2i
2. 安装 Node 依赖（仅 patchright@1.62.3；首次运行会下载 Chromium）：

cd <profile>/vendor/yuanbao-t2i
npm install

3. 在 profile 的 package.json 中登记依赖与 bundle：

{
  "dependencies": { "dsh-yuanbao-t2i": "link:vendor/yuanbao-t2i" },
  "dsh": { "profile": { "bundles": ["dsh-yuanbao-t2i"] } }
}

4. 把包链接进 profile 的 node_modules（Windows 示例）：

mklink /J node_modules\dsh-yuanbao-t2i ..\vendor\yuanbao-t2i

5. 完全退出并重启 DSH Desktop，以加载宿主半与浏览器半。注意：仅在本机 Settings → Plugins 里关闭再打开插件不能替换已 import 的 lib/*.js；修改宿主侧 JS 后必须重启 DSH。

已在 vendor/yuanbao-t2i 安装过的，原地升级：

cd <profile>/vendor/yuanbao-t2i
git pull
npm install

改 lib/wm_lama.py 无需重载；改 client.js 刷新页面即可。

升级时注意破坏性变更：v0.9.0 移除 seed 参数；v0.10.0 移除 wmMask 参数与界面选项（调用里若仍传会被参数校验拒绝，配置文件中的 wmMask 会被静默忽略）。

典型用法¶

在会话中让模型调用工具即可。README 中的示例如下。

文生图：

用元宝生图：一座哥特式教堂，雨夜，雾气，油画质感，竖构图

图生图：

用元宝图生图：基于这张参考图，改成夜晚场景，增加雾气效果
（附上参考图路径：D:/art/scene_bg.png）

套用画风：

用元宝图生图：基于这张参考图，套用画风「复古岩彩风」
（附上参考图路径：D:/art/scene_bg.png）

常用参数摘要（完整表见 README「用法」一节）：

返回包括图片绝对路径、rawFiles（未去水印原图路径）、实际使用的参数；去水印失败时关注 watermarkError。

适用场景与注意¶

适合谁： 已在用 DSH 编排智能体、有元宝账号、希望文生图 / 图生图与画风模板与网页版能力对齐，且接受本地浏览器自动化与串行调用的开发者。

安装前请知悉：

• 插件以当前 DSH 进程权限运行，会读写本地 profile、输出目录与缓存；安装前应自行审阅 仓库源码 与 MIT 许可证。
• SkillHub 等社区目录与 DeepSeek / 幻方无官方从属关系，插件亦非腾讯官方产品。
• 去水印为可选后处理，纸纹、白底图上仍可能有轻微修补痕；默认关闭更稳妥。
• 元宝页面改版时，水印 ROI 等可通过 DSH_WM_ROI 等环境变量调整（见 README「环境变量」）。

结尾¶

dsh-yuanbao-t2i 把元宝网页版的文生图、图生图、官方画风模板和可控比例落盘，封装成 DSH 工具与设置卡，适合不想单独维护生图 API 链路的本地智能体场景。目录与文档入口：

• 插件目录：https://www.skillhub.cn/plugins/lm846802297-bit/dsh-yuanbao-t2i
• GitHub：https://github.com/lm846802297-bit/dsh-yuanbao-t2i