Diffusion Studio本地构建完整指南Monorepo搭建、开发调试与桌面端打包【免费下载链接】editorAn open-source video editor built for agents. Edits become code, code becomes video.项目地址: https://gitcode.com/gh_mirrors/editor94/editorDiffusion Studio 是一款专为 AI Agent 打造的开源视频编辑器核心理念是编辑即代码代码即视频——你在时间线上做的每个改动都会写回真实的 SolidJS 代码。本文带你完成 Diffusion Studio 本地构建的完整流程从零搭建 Monorepo 开发环境、启动开发调试再到打包出可分发的桌面端安装包。一、动手之前看懂 Monorepo 结构Diffusion Studio 采用 npm workspaces 管理整个仓库package.json 中只声明了两个工作区apps/*—— 可直接运行的三个应用packages/*—— 被应用共享的 8 个核心库路径包名职责apps/webdiffusionstudio/web编辑器 UISolid Viteapps/desktopdiffusionstudio/desktopElectron 桌面壳apps/clidiffusionstudio/clidapi命令行工具packages/runtimediffusionstudio/runtime无头编辑器运行时ECS 世界、媒体解码packages/jsxdiffusionstudio/jsx创作 API元素词汇表与生成式资源packages/reconcilerdiffusionstudio/reconciler把项目代码调和到运行时实体树packages/assets/encoder/koota-solid/agent-chat/dapi—资产库、离线编码、Solid 绑定、Agent 聊天、MCP 工具更详细的说明见 README.md 的 Repository layout 一节。理解这张地图后你后面每一步构建命令都能对号入座。二、前置要求与一键安装 环境要求很简单只需Node 20 与 npm。git clone https://gitcode.com/gh_mirrors/editor94/editor cd editor npm install cp apps/web/.env.example apps/web/.env两个容易踩的坑.env是必需的。apps/web/.env.example 提供了一份可直接使用的默认值复制为apps/web/.env后应用才能运行打包桌面端时 vite.config.ts 还会强制校验VITE_SUPABASE_URL与VITE_SUPABASE_ANON_KEY是否存在缺失会直接报错。npm install末尾会自动执行patch-package把 patches/ 里的补丁应用到第三方依赖上属正常现象。三、开发调试一条命令启动完整工作流安装完成后最常用的一条命令是npm run dev它实际调用的是 scripts/dev-desktop.mjs内部串起了四个步骤构建 CLI保证链接进 PATH 的dapi与 App 内无头服务代码一致启动 Vite 开发服务器http://localhost:5173端口固定为 5173并自动清理由上次崩溃残留的旧 Vite 进程避免端口被占用报错等待服务器就绪后构建桌面壳esbuild 打包main.js/preload.js/agent-host.mjs用electron-forge start启动 Electron加载 5173 端口的页面。按Ctrl-C会优雅终止整棵进程树。Vite 侧开启了Cross-Origin-Opener-Policy等响应头这是 WebGPU 与共享内存特性所必需的见 apps/web/vite.config.ts。如果只想调 Web 端、不起 Electron可以改用npm run dev:web_v1四、让 dapi CLI 跟随最新代码桌面端内置的 MCP 工具与独立的dapiCLI 共用一套实现。想让终端里的dapi始终指向本地构建产物只需链接一次以 macOS/Homebrew 为例npm run symlink:create --workspacediffusionstudio/cli链接指向的是 CLI 构建产物而npm run dev每次启动都会重新构建它因此dapi永远运行最新代码。细节见 apps/cli/package.json。五、桌面端打包从源码到 DMG 安装包开发调试满意后就可以打正式包了npm run makeapps/desktop/package.json 中的make脚本依次执行阶段命令作用1. 类型检查npm run check全工作区tsc --noEmit2. 打包主进程build:main/build:preloadesbuild 输出 CJS 产物到dist/3. 构建 Web 前端build:webVite 以--mode desktop输出到apps/desktop/web/4. 资源暂存stage:cli/stage:runtime/stage:docs把dapi、运行时与文档放入Resources/随应用分发5. 制作安装包electron-forge make由 forge.config.ts 驱动 MakerDMG / MakerZIP最终会产出形如Diffusion-Studio-arm64.dmg的安装包拖拽式安装界面长这样 关于签名配置了APPLE_ID、APPLE_PASSWORD、APPLE_TEAM_ID三个环境变量时会执行公证本地自测可用SKIP_SIGN1跳过签名。六、版本发布与日常质量检查发布新版本只需一条命令scripts/release.mjs 会同步更新根目录与三个应用包的版本号、刷新 lockfile并提交并打上vX.Y.Z标签npm run release patch推送到远端含 tag后即可触发后续的发布工作流。日常提交前建议跑一遍质量检查三件套npm run check # 全工作区类型检查 npm run lint # 全工作区 ESLint npm run test # 运行各工作区测试七、常用命令速查表命令场景npm install首次安装依赖自动打补丁npm run dev一键启动桌面端开发npm run dev:web_v1仅启动 Web 开发服务器npm run build构建 Web 生产包npm run make构建并制作桌面安装包npm run release patch\|minor\|major升版 打 tag至此你已经掌握了 Diffusion Studio 本地构建的完整链路Monorepo 环境搭建、开发调试与桌面端打包。剩下的就是打开编辑器让 Agent 帮你剪一支真正的视频了。【免费下载链接】editorAn open-source video editor built for agents. Edits become code, code becomes video.项目地址: https://gitcode.com/gh_mirrors/editor94/editor创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考