dsh-doubao-image

豆包网页版 AI 生图 Agent 原生工具插件（Doubao Web AI Image Generation Agent Tool Plugin for DeepSeek Harness）

dsh-doubao-image 为 DeepSeek Harness (DSH) 提供免 API Key、基于真实浏览器会话的 豆包网页版（doubao.com）AI 文生图原生工具能力。安装后，Agent 将自动获得 doubao_generate_image 与 doubao_image_status 两个原生工具：当你向 Agent 提出任何画图、制作海报、生成文章封面或配图需求时，Agent 会直接调用工具操控 Tabbit 浏览器中的豆包网页版完成生成，并自动优选下载 2730×1536（2.7K）wm0 无水印超清原图 落盘及注入当前对话。

---

🏗️ 工作流架构

flowchart LR
  subgraph Agent["DeepSeek Harness Agent"]
    U["用户自然语言画图指令"] --> T["调用原生工具<br/>doubao_generate_image"]
  end

  subgraph Studio["Tabbit 浏览器 · 豆包网页版自动化"]
    T --> M["自动检测登录态 &<br/>切换极速『豆包』生图模式"]
    M --> P["注入比例/风格增强 Prompt<br/>提交 Seedream 5.0 渲染"]
    P --> F["按 /rc_gen_image/ 哈希去重<br/>优选 cgen_wm0 无水印 2.7K 原图"]
  end

  subgraph Output["本地落盘与多模态回传"]
    F --> D["Node.js 携带 Referer 下载原图<br/>保存至 doubao_images/"]
    D --> A["注入 ctx.attachments<br/>对话内直接渲染超清大图"]
  end

  style Agent fill:#e3f2fd,stroke:#1565c0,color:#0d47a1
  style Studio fill:#fff8e1,stroke:#ff8f00,color:#e65100
  style Output fill:#e8f5e9,stroke:#2e7d32,color:#1b5e20

---

✨ 核心特性

1. 原生 Agent 工具调用（doubao_generate_image & doubao_image_status）
   • 无需手动操作繁琐面板，直接对 Agent 说出画图需求（如：“帮我用豆包生成一张 16:9 赛博朋克风格的机械橘猫封面图”），Agent 即会自动调用 doubao_generate_image 工具。
   • 支持 1:1、16:9、9:16、4:3、3:4、3:2、2:3、21:9 全画幅比例，内置 cinematic-cg（电影级 CG）、photorealistic（写实摄影）、cyberpunk（赛博朋克）、chinese-ink（国风水墨）、anime（动漫二次元）、3d-isometric（3D 盲盒潮玩）、minimal-editorial（极简插画）等风格预设。
2. 自动优选 cgen_wm0 2730×1536 无水印原图
   • 自动过滤渐进式模糊缩略图（-cthumb）、静态图标（/rc/icon/）与历史缓存图片；
   • 按 /rc_gen_image/<hash> 唯一内容键自动去重，并智能优选豆包画布底层的 cgen_wm0.png / cgen_wm0.webp 2730×1536 纯净无水印原图（告别右下角水印与模糊缩略图）。
3. 自动模式切换与全链路防呆
   • 自动检测并关闭豆包网页版「下载豆包电脑版」等推广弹窗；
   • 若检测到当前处于耗时的「豆包·工作（云电脑）」模式，自动切换回极速「豆包」标准对话模式（约 20~25 秒即可出图）；
   • 若豆包网页尚未登录，自动呼出扫码/飞书登录窗口并截图返回给用户。

---

🖼️ 实机运行效果

1. 由 doubao_generate_image 自动提取的 2730×1536 无水印超清原图

2. Tabbit 浏览器豆包网页版自动化生图现场

---

📦 安装方式

# 方式一：通过 npm 官方源一键安装（推荐）
dsh plugin add dsh-doubao-image

# 方式二：针对 Desktop 桌面端 Profile 安装
dsh plugin --profile desktop add dsh-doubao-image

# 方式三：本地源码链接安装
dsh plugin --profile desktop add link:/path/to/dsh-doubao-image

---

🛠️ 注册的 Agent 工具参数说明

doubao_generate_image

参数名	类型	必填	默认值	说明
prompt	string	是	-	画面主体、构图、光影、材质与氛围的详细描述
aspectRatio	string	否	"16:9"	画面比例：1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9
style	string	否	"auto"	视觉风格预设（如 cinematic-cg, cyberpunk, chinese-ink, photorealistic, anime, 3d-isometric, minimal-editorial）
negativePrompt	string	否	""	需要避免出现的画面元素
outputDir	string	否	"doubao_images"	原图下载保存目录（相对路径基于当前工作区解析）
filenamePrefix	string	否	"doubao"	保存文件名前缀
maxImages	integer	否	4	单次最多提取保存的生成图数量（1~4）
newConversation	boolean	否	false	是否在发送前点击开启新对话
keepTab	boolean	否	true	生图完成后是否保留豆包标签页以便连续追问改图

doubao_image_status

参数名	类型	必填	默认值	说明
openLoginIfNeeded	boolean	否	true	若豆包网页未登录，是否自动在 Tabbit 中打开登录弹窗并截图

---

⚙️ 插件配置项（Settings -> Plugins）

配置项	类型	默认值	说明
enabled	boolean	true	是否启用豆包网页生图工具插件
tabbitCliPath	string	""	tabbit-cli 路径（留空自动解析 ~/.local/bin/tabbit-cli）
doubaoUrl	string	"https://www.doubao.com/chat/"	豆包网页版入口地址
taskName	string	"Doubao AI Image Studio"	Tabbit 浏览器中的任务标签组名称
defaultAspectRatio	string	"16:9"	默认生图画面比例
defaultStyle	string	"auto"	默认视觉风格预设
outputDir	string	"doubao_images"	高清原图本地保存目录
timeoutMs	number	120000	单次生图最大等待毫秒数（30000~180000）
keepTab	boolean	true	生图完成后是否保留豆包标签页供后续连续追问
injectSystemPrompt	boolean	true	是否向 System Prompt 注入豆包生图工具指引

---

🧪 运行测试

node --test test/*.test.js

📄 License

MIT © xt765