豆包工作室 Doubao Studio

豆包工作室是一款面向 AI 内容创作者的 Windows 桌面工作台。它在一个应用中管理多个独立豆包账号，并将提示词、参考素材、视频参数、任务调度、生成等待、产物提取和批量下载串成可追踪、可暂停、可恢复的生产流程。

项目重点不是替代豆包网页，而是在保留原始网页操作能力的同时，为重复生产工作增加任务队列、多账号隔离、状态记录和产物管理。

从 v2.0 开始，工作台以“项目”为一级组织单位。每个项目拥有独立的任务、CSV 批次、运行历史和产物视图，适合同时管理多个内容主题或客户交付。

本项目是社区开发的非官方工具，与字节跳动或豆包官方无隶属关系。使用时请遵守豆包服务条款、内容规范和所在地法律法规。

核心能力

项目化工作空间

• 顶部项目切换器用于创建和切换项目。
• 旧版本任务自动迁移到“默认项目”。
• 任务列表、CSV 批次和产物中心按当前项目隔离。
• 项目概览显示完成率、任务数、批次数和历史产物。
• 支持导出不含网页登录信息和远程产物地址的项目包。

多账号工作区

• 每个账号使用独立 Electron Session，隔离 Cookie、登录状态和网页存储。
• 支持账号置顶、搜索、刷新、运行状态和健康状态展示。
• 根据任务负载、连续失败、冷却状态和 Seedance 预测额度智能分配账号。
• 检测额度耗尽、人工验证和登录异常后自动降低账号调度优先级。
• 支持暂停账号调度和手动冷却 30 分钟。
• 不可用账号上的排队任务可迁移到其他健康账号。

多模式任务生产

• 支持对话、图片、视频和音乐任务。
• 视频任务支持 Seedance 2.0、Fast、Mini，及常用画面比例和时长。
• 支持多张参考图片、参考音频和完整配置编辑重跑。
• 每次启动或重跑任务前创建新对话，减少不同任务之间的上下文污染。
• 可保存完整任务模板，复用提示词、模式、素材和视频配置。

批量变量

提示词中可以使用 {{变量名}}，变量区每行表示一组任务：

一支 {{产品}} 放在 {{场景}}，电影感产品广告，柔和自然光

产品=保温杯;场景=客厅
产品=咖啡杯;场景=办公室

添加后会生成两条独立任务。多个基础提示词仍可使用 %%%%%%%%%% 分隔。

可恢复自动化

任务不再只有简单的“运行中”。系统会持久化以下阶段：

flowchart LR
    A[等待执行] --> B[准备账号]
    B --> C[创建新对话]
    C --> D[切换模式]
    D --> E[配置参数]
    E --> F[上传素材]
    F --> G[填写提示词]
    G --> H[提交任务]
    H --> I{是否触发验证}
    I -- 是 --> J[等待人工验证]
    J --> C
    I -- 否 --> K[生成中]
    K --> L[识别并绑定产物]
    L --> M[完成]

• 保存运行 ID、输入快照、运行次数、当前阶段、阶段说明和心跳时间。
• 可立即暂停长时间视频等待，不必等到超时。
• 程序意外退出后，未完成任务会恢复为“已暂停”，可重新执行。
• 人工验证完成后会重新创建对话、上传素材并再次提交。
• 对额度、会员、人脸素材、审核、网络、页面变化和产物缺失进行分类记录。
• 主进程使用原子任务锁，阻止重复点击、热更新和竞态造成重复执行。
• 最近 20 次运行记录保留结果、错误类型和实际耗时。

视频生成与 15 秒模式

• 自动确认模型、比例和时长，减少下拉菜单选择失败。
• 15 秒视频通过可控制的请求补丁实现，自动任务和手动网页操作均可使用。
• 视频生成可以长时间等待，同时支持随时暂停和手动提取。
• 识别明确的额度不足、会员限制、人脸限制和生成失败提示，停止无意义等待。

15 秒模式依赖豆包当前网页请求结构，豆包更新后可能需要同步适配。

产物与下载

• 产物绑定任务运行 ID、账号、豆包对话地址、发现时间和来源。
• 重新运行不会删除历史产物记录。
• 手动提取旧任务时，会先打开该任务对应的豆包对话，避免抓取其他任务的视频。
• 下载任务保留完成状态、文件大小、失败原因和保存位置。
• 下载失败项可以在“下载记录”中重试。
• 视频原始地址提取采用多通道候选检测，但不保证任何时候都能获得无水印版本。

产物中心

• 汇总所有任务历次运行产生的图片、视频和文件。
• 按提示词、任务 ID、类型和地址有效性筛选。
• 对远程地址执行轻量有效性检测，区分有效、过期和不可用。
• 显示产物是否已经下载到本地。
• 支持预览、重新下载和返回产物对应的豆包对话。

视频产物解析与下载增强

• 视频产物解析支持多策略回退：捕获响应、播放信息、平台下载信息、对话结构化扫描和页面回退。
• 对话扫描发现新视频 ID 后，会在剩余等待预算内回补 API 查询，减少“页面已生成但未找到产物”的情况。
• 候选产物按任务会话和视频 ID 进行绑定，无法证明归属时不会误绑定旧视频，并支持手动提取兜底。
• 自动解析和手动提取均支持取消；下载前校验 HTTP 状态、响应内容和媒体类型，并对常见失败原因分类提示。
• 原始地址与普通播放地址分开标记，不把普通播放地址误报为无水印原始文件。

CSV 批次与基础工作流

• 从 CSV 批量导入提示词、模式、视频模型、时长、比例、素材和账号。
• 使用 depends_on 指定前置 CSV 行号，多个行号使用 | 分隔。
• all_done 要求所有前置任务成功；all_finished 允许前置任务失败后继续。
• 任务批次页面汇总总数、进度、运行、排队和失败数量。
• 可对整个批次中的失败任务一键重新排队。

CSV 模板见 examples/tasks-template.csv。

页面适配系统

• 当前适配器和规则包具有独立版本号。
• 兼容性自检检查输入框、提交控件、视频入口、模型、时长、比例、上传和产物识别。
• 自检报告脱敏保存在本地，最多保留最近 50 份。
• 支持导入受限 JSON 规则包，不执行规则包中的脚本。
• 新规则安装前保存旧版本，可通过工具栏一键回退。

适配规则示例见 examples/adapter-rules.json。

日志、备份与发布

• 运行日志按信息、警告和错误分级，支持任务和错误关键词搜索。
• 完整备份包含项目、账号配置、任务、下载、诊断、日志和应用设置，不包含 Cookie。
• 支持备份恢复与 JSON 数据完整性检查。
• 应用内可查询 GitHub 最新 Release。
• GitHub Actions 自动执行类型检查、构建和 Windows 标签发布。

Agent 能力协议与平台化接口

• 新增 Capability API Schema v1，统一描述能力清单、异步任务、任务事件、产物和结构化错误。
• 为未来的 Agent、CLI 和 MCP 接入定义稳定边界，外部调用可围绕不透明的 taskId、requestId、事件序号和 artifactId 进行集成。
• requestId 支持当前服务进程内幂等；响应丢失时可按 requestId 查询任务，避免盲目重复提交。
• 公共协议不暴露 Cookie、Session、Webview、DOM、Zustand、豆包内部 URL 或本地绝对路径。
• v1 Schema 使用开放字符串枚举，客户端应忽略无法识别的新状态，为后续能力扩展保留兼容性。
• Schema 文件位于 schemas/capability/v1/，设计说明见 docs/architecture/capability-api-schema.md。

界面结构

• 顶部工具栏：全部暂停/继续、批量下载、下载记录、运行统计、诊断导出和设置。
• 账号列表：账号切换、健康状态、Seedance 额度预测和运行详情。
• 任务调度区：添加、编辑、指派、启动、暂停、重跑、产物提取和批量下载。
• 网页工作区：显示每个账号独立的豆包网页，可在自动化外继续手动操作。

环境要求

• Windows 10/11 x64
• Node.js 24（使用 pnpm 11 时推荐）
• pnpm 9 或更高版本
• 可正常访问豆包网页的网络环境
• 每个账号需在独立网页工作区中自行完成登录

安装与启动

git clone https://github.com/dorakoo/doubao-studio.git
cd doubao-studio
pnpm install
pnpm run dev

开发启动器会优先使用 5173。端口被占用时会自动选择后续空闲端口，并让 Electron 加载正确地址。

基本使用

1. 点击账号列表右上角的 +，为账号填写便于识别的名称。
2. 在右侧豆包网页中完成登录，每个账号只需在自己的工作区登录。
3. 点击“添加任务”，选择对话、图片、视频或音乐模式。
4. 视频任务配置模型、时长、比例，可添加参考图片和音频。
5. 输入提示词；批量任务用 %%%%%%%%%% 分隔，或使用变量区展开。
6. 开启“自动指派”，或手动为任务选择账号。
7. 启动任务后，可在任务条目和详情页查看实时阶段。
8. 完成后预览或提取产物，通过顶部下载按钮批量保存。
9. 大批量任务可点击任务区的 CSV 按钮，导入模板格式的任务文件。
10. 豆包页面更新后，从“更多”运行兼容性自检并查看具体异常控件。
11. 从顶部“更多”进入项目概览、运行日志、完整备份和更新检查。

常用命令

数据与隐私

• 账号会话由 Electron 按账号分区存储，不会提交到 Git。
• 任务、账号状态和下载记录保存在 Electron 用户数据目录的 DoubaoStudioData 中。
• JSON 数据采用临时文件写入，并保留 .bak 备份供损坏时恢复。
• 诊断包会隐藏提示词正文、完整素材路径和产物 URL。
• 请勿在 Issue、日志或截图中公开 Cookie、Token、个人账号信息或私有素材。

常见问题

Port 5173 is already in use

新版 pnpm run dev 会自动选择空闲端口。若仍看到旧错误，请确认代码已更新，并关闭旧版本遗留的开发进程。

视频一直等待

视频可能仍在生成，也可能被额度、会员、人脸或审核提示阻断。新版会检测常见阻断信息；也可直接暂停任务，稍后通过“提取视频”重新检查对应对话。

机器人验证完成后任务没有生成

保持任务处于“等待验证”，手动完成验证。系统检测验证消失后会重新建立对话、恢复素材和配置并再次提交。

下载到错误的视频

优先从任务详情进入“提取视频”。新版会根据保存的对话地址返回原任务页面，再绑定发现的产物。

豆包更新后按钮识别失效

网页自动化依赖豆包当前 DOM 和交互结构。请导出脱敏诊断包，并在 Issues 中附上现象、阶段和相关日志。

项目结构

main/                       Electron 主进程、IPC 与本地数据
main/ipc/projects.ts         项目管理与默认项目迁移
main/ipc/system.ts           日志、备份、完整性与更新检查
src/components/             账号、任务、浏览器、下载和设置界面
src/automation/             执行协调器、任务锁客户端和页面适配规则
src/store/                  Zustand 账号与任务调度状态
src/types/                  任务、账号、产物和 Electron API 类型
src/utils/doubaoBridge.ts   豆包网页交互与产物提取适配层
src/utils/taskRuntime.ts    自动化错误分类
scripts/dev.mjs             动态端口开发启动器

参与开发

1. Fork 本仓库并从 main 创建功能分支。
2. 保持修改聚焦，避免提交账号数据、构建产物和生成视频。
3. 提交前运行 pnpm run ts-check 和 pnpm run build。
4. 对豆包页面适配的修改，请说明使用的页面模式、模型、比例和复现步骤。

路线图

• Excel 批量任务导入与可视化字段映射
• 项目包导入与跨设备同步
• 将 Webview 执行生命周期进一步迁移到主进程服务
• 图片生成到视频生成的自动素材传递
• 敏感数据本地加密
• 远程适配规则签名与自动更新
• 安装包签名、差分更新与失败回滚

完整版本变化见 CHANGELOG.md。

License

本项目使用 MIT License。