doubao-image-studio：豆包 AI 生图的原生画廊管理与高清无水印导出工具

doubao-image-studio 界面

官方信息

项目名称	豆包生图助手 Doubao Image Studio（Doubao Image Assistant）
仓库地址	https://github.com/abc-kkk/doubao-image-studio
官方网站	豆包官网｜ Releases 下载
最新更新时间	2026-04-06
项目定位	面向豆包网页版 AI 绘图的原生桌面辅助工具（Tauri + 浏览器扩展），提供画廊管理、本地持久化、高清无水印原图导出与本地 API 调用能力

项目背景

用豆包网页版生图的人，多半都遇到过三个痛点：右下角自带水印、网页端保存的图被压缩不清、生成历史散落在对话里难以回看和复用。豆包生图助手（Doubao Image Studio）就是开发者 abc-kkk 为解决这些问题而写的开源工具。

它不是一个单纯的浏览器油猴脚本，而是一个 Tauri（Rust）原生桌面应用 + 浏览器扩展 的组合：浏览器扩展负责在豆包网页里拦截、捕获生成的图片资源，桌面端应用负责通过本地 WebSocket（端口 8081）实时接收这些图片，并用内置 SQLite3 数据库做本地持久化。生成的图会自动出现在桌面端的画廊里，下次离线也能翻看。

对开发者来说，它还内置了一个 Express 本地代理服务，把豆包的生图能力包装成本地 HTTP API，方便接入 Python 自动化脚本、群机器人或自己的效率流。整个项目使用 React + TypeScript + Vite + Tailwind 做前端，Rust(Tauri) 做桌面壳，better-sqlite3 做存储。

核心特性

原生 UI 体验：极简积木（Jimeng）风格，适配 macOS 标题栏悬浮设计。
实时同步：浏览器与桌面端通过本地 WebSocket（8081）无缝同步，图生成即显示。
本地持久化：内置 SQLite3，提示词与生成结果永久保存，支持离线翻阅。
高清无水印：直接下载/保存高清、无水印原图，保留每一处细节。
API 调用支持：内置 Express 代理，可通过本地 HTTP API 调用生图能力，便于二次开发。
全能画廊：一键复用提示词、设为参考图、批量预览与本地管理。
图片处理：集成原生图片压缩工具，可预览压缩前后效果。
自动打包：基于 GitHub Actions 自动产出 Windows .exe / macOS .dmg。

环境要求

操作系统：Windows 10+ 或 macOS（Apple Silicon / Intel）。
浏览器：Chrome / Edge（需安装配套扩展）。
网络：能访问豆包官网 www.doubao.com。
本地端口：桌面端需占用 8081（WebSocket）与 Express 代理端口，请确保未被占用。
自行编译开发（可选）：Node.js 18+、Rust 工具链、pnpm/npm。

详细部署步骤

第一步：下载桌面端安装包

前往 Releases 页面，根据系统下载：

# macOS：下载 .dmg，双击后把应用拖入 Applications
# Windows：下载 .exe 或 .msi，双击按向导安装

# 验证安装（macOS）
open /Applications/豆包生图助手.app

# Windows 安装后从开始菜单启动

第二步：安装浏览器扩展（开发者模式加载）

桌面端需要配合浏览器扩展才能捕获豆包网页里的图片。

# 1. 从 Releases 下载扩展压缩包并解压
#    解压后目录里应包含 doubao-extension/dist 文件夹

# 2. 打开 Chrome/Edge，地址栏输入：
chrome://extensions/

# 3. 打开右上角“开发者模式”开关

# 4. 点击“加载已解压的扩展程序”，选择 doubao-extension/dist 文件夹

# 5. 扩展列表里确认该扩展状态为已启用

安装完成后，扩展图标旁应显示 Connected（已连接桌面端）。若显示未连接，先启动桌面端应用再刷新扩展。

第三步：联调验证

启动"豆包生图助手"桌面应用。
在浏览器打开 https://www.doubao.com/ 并登录你的豆包账号。
输入一段生图提示词，例如"赛博朋克风格的雨夜街道，8K"。
图片生成后，桌面端画廊应自动出现该图，且对应的提示词一并保存。
右键画廊里的图片，选择"保存原图"，即可得到无水印高清大图。

第四步：使用本地 API（开发者）

桌面端内置 Express 代理，把豆包生图能力暴露为本地接口。先在桌面端设置里开启"本地 API"，然后即可：

# 示例：通过本地 API 触发一次生图（具体字段以项目 README 为准）
curl -X POST http://localhost:8081/api/generate \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "一只穿宇航服的橘猫，卡通风格"
  }'

# Python 接入示例
import requests
resp = requests.post(
    "http://localhost:8081/api/generate",
    json={"prompt": "极简风格的远山日出插画"}
)
print(resp.json())

第五步：从源码运行（可选）

git clone https://github.com/abc-kkk/doubao-image-studio.git
cd doubao-image-studio

# 安装前端依赖
npm install
cd server && npm install && cd ..

# 启动 Tauri 开发模式
npm run tauri dev

常见坑与解决办法

扩展显示 Not Connected：桌面端没启动，或 8081 端口被占用。换端口前先 lsof -i:8081 查占用。
画廊收不到图：确认扩展是"已解压加载"且处于启用状态；豆包页面需刷新一次让扩展注入。
保存的图仍有水印：务必用画廊里的"保存原图"，而不是豆包网页自带的下载按钮。
macOS 提示损坏：系统设置 → 隐私与安全性 → 仍要打开。
免责声明：本工具仅供个人学习与技术交流，请遵守豆包服务条款，勿用于商用侵权。

使用方法示例

在豆包里批量生成一组"四季插画"，每生成一张桌面画廊就多一张。挑出满意的，点"设为参考图"再让豆包二次创作；需要发给团队时，用"一键打包下载"把整个会话的图导出。写公众号时，直接从画廊拖出无水印原图即可，省去手动去水印的工序。

常见问题 FAQ

Q1：它会保存我的豆包账号密码吗？
A：不会。扩展只运行在浏览器页面里，账号仍在你自己浏览器登录态中，工具不收集凭证。

Q2：生成的图存在哪里？
A：存于桌面端内置 SQLite 数据库与本地图片目录，离线可查。

Q3：支持 Linux 吗？
A：官方 Release 主要提供 Windows 与 macOS；Linux 可按 README 用 Tauri 自行编译。

Q4：API 需要自己的 Key 吗？
A：不需要。本地 API 走的是你浏览器里已登录的豆包会话，不额外收费。

跳转链接

GitHub 仓库：https://github.com/abc-kkk/doubao-image-studio
Releases 下载：https://github.com/abc-kkk/doubao-image-studio/releases
豆包官网：https://www.doubao.com/