AstraForge Studio —— 火山方舟 Doubao 系列模型的开源桌面创作客户端
一个很小但很烦的问题
火山方舟上的豆包生成模型这两年补得很齐：Seedance 做视频、Seedream 做图片、Seed3D 做三维资产。能力是够用的，但真正上手时会遇到一层摩擦——
想试一个视频创意，要么打开文档翻参数、写一段 Python 调接口，要么在控制台的体验页里点。前者每换一次分辨率就得改代码，后者参数给得有限，而且视频、图片、3D 分散在不同页面，来回切换。
更琐碎的是异步任务：视频和 3D 都是提交后返回 task id ，你得自己轮询状态、自己保存结果链接——那些链接还会过期。
AstraForge Studio 想解决的就是这一层摩擦：把三种生成能力放进同一个桌面应用，参数以表单形式给全，任务状态自动轮询，结果直接预览和下载。
三个工作台，一个窗口
顶部一键切换，三种模态各有独立工作区。
视频 · Seedance 2.0 系列
支持 Seedance 2.0 、2.0 Fast 、2.0 Mini 三个模型，四种生成模式：文生视频、图生视频（首帧）、图生视频（首尾帧），以及多模态参考——最多 9 张参考图 + 3 段参考视频 + 3 段参考音频混合输入。
分辨率、画面比例、时长（ 4–15 秒）、同步音频、固定摄像机、水印、返回尾帧，都是表单里的一项。提交后每 5 秒自动查询任务状态，成片直接在右侧内联播放，不用先下载再打开。任务排队太久也可以直接取消。
图片 · Seedream 系列
Seedream 5.0 Pro / 5.0 Lite / 4.5 / 4.0 。文生图、图生图、组图生成都在同一个面板里，参考图最多 14 张。尺寸从 1K 到 4K ，输出格式可选 PNG 或 JPEG ，还有随机种子、引导强度、提示词优化开关。生成结果以网格铺开，每张都能单独打开、下载、复制链接。
3D · Seed3D 2.0
丢一张物体图片进去，输出带纹理和 PBR 材质的三维资产。面数可选低/中/高（ 10 万 / 50 万 / 100 万面），格式支持 GLB 、OBJ 、USD 、USDZ——直接进 Blender 或者 AR 场景都行。
几个我们花了心思的细节
参数跟着模型能力走，而不是一股脑全给
这一点看不见，但用起来差别很大。方舟的文档里写得很清楚：1080p 只有 Seedance 2.0 支持，Fast 和 Mini 不支持；4k 同样仅限 2.0 ；而整个 2.0 系列都不接受 seed 参数。
很多简易封装会把所有参数一律塞进请求体，结果就是选了 Fast + 1080p ，提交后拿到一个语焉不详的报错。AstraForge Studio 按模型能力动态渲染选项——切到 Fast ，分辨率列表里就没有 1080p ；选中 2.0 系列，随机种子字段直接隐藏，请求里也不会带上它。
本地图片直接拖进去
参考图不需要先传到某个图床拿 URL 。所有图片输入框都支持点击选择本地文件，或者直接把图拖进去，应用会自动转成 Base64 data URL 提交。首帧、尾帧、3D 参考图还会显示缩略图——粘贴一长串 Base64 之后，至少能确认自己贴对了图。
密钥只留在本机
API Key 写入本地配置文件，权限设为 0600，不上传任何第三方。所有请求由 Electron 主进程直连火山方舟，既绕开了浏览器的 CORS 限制，也意味着密钥不经过渲染进程。
安全基线上，渲染进程关闭了 Node 集成、开启上下文隔离，页面配了 CSP ，应用内导航和新开窗口被拦截，外部链接一律交给系统浏览器打开。
结果不会悄悄丢
方舟返回的结果链接是有有效期的。应用会把最近 100 条生成记录存在本机——模型、提示词、状态、结果链接都在里面，随时可以翻出来重新打开或复制。常用参数也会记住，下次启动自动恢复。
开始使用
git clone https://github.com/dobest1024/AstraForgeStudio.git
cd AstraForgeStudio
npm install
npm start
国内下载 Electron 二进制可以先设镜像：
export ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/
启动后点右上角「 API 设置」填入火山方舟的 API Key 即可。没有 Key 的话，设置弹窗里有一个按钮直接跳转到方舟控制台的 API Key 管理页。
需要安装包的话，npm run package:mac 出 macOS Universal DMG ，npm run package:win 出 Windows x64 安装包。
关于这个项目
MIT 协议，代码全部开放：https://github.com/dobest1024/AstraForgeStudio
技术栈很朴素——Electron + 原生 JavaScript ，没有前端框架，没有构建步骤。主进程负责网络与文件，预加载脚本通过 contextBridge 暴露受限接口，渲染进程只管 UI 。想改点什么，clone 下来直接改就能跑。仓库配了 ESLint 与 Prettier ，CI 上会跑静态检查。
也说说现状：这是 0.1.0 ，一个能用但还年轻的版本。目前没有自动化测试，安装包未做代码签名（ macOS 首次打开需要在「隐私与安全性」里确认，Windows 可能触发 SmartScreen ）。批量队列、结果本地归档这些还没做。
如果你正好在用方舟的生成模型，欢迎试一试。有问题提 Issue ，有想法提 PR——仓库里有 Issue 和 PR 模板，贡献指南也写好了。
Select Language