Diffusion Studio：整条时间线写成一份 JSX，Agent 和你在同一个文件上轮流改，桌面版只出 macOS 和 Windows

它在链条上站在哪一层

它在这一层怎么做事

export default function Project() {
  return (
    <stage background="#161616" camera={[0.3, 0, 0, 0.3, 85, 150]}>
      <scene name="Intro" width={1920} height={1080} fill="black" active>
        <video src="b-roll/drone.mp4" start={0} end={6} width={1920} height={1080} />
        <text y={860} width={1920} textAlign="center" fontFamily="Inter" fontSize={96} start={1} end={5}>
          Hello
          <animation type="fade" duration={0.5} />
          <animation type="fade" phase="out" duration={0.5} />
        </text>
      </scene>
    </stage>
  );
}

你要给什么，它交回什么

• 一个项目文件夹：入口 TSX 加上 assets/ 里的素材。文件夹放在磁盘上任何位置都行，diffusion open 记一次路径，之后的工作就是编辑文件 7。
• 一台装得上桌面版的机器：macOS 12+ 且 M1 及以上，或者 Windows x64 11。
• 一个能连 MCP 的编码 Agent。官方列出 Claude Code、Codex、Cursor、VS Code 里的 Copilot、Antigravity、Gemini CLI、Devin，以及其它支持 MCP 的客户端 11。
• 用到 AI 动作时的积分。生成视频、图片、音频、语音，以及让模型理解素材、做转写，都从积分里扣 12。

• 一份还能继续改的工程。时间线的全部内容就写在那份 TSX 里，你和 Agent 改的是同一个文件，它改完你在界面里接着改 2。
• 成片导出。各档都不限次数、最高 4K、无水印 12。
• 对素材的理解结果。词级转写（带起止时间的 JSON）、标出静音区间的波形图、抽帧与 filmstrip，以及“这段素材里说了什么”的问答结果 7。

最短的上手路径与花费

1. 装桌面 app。macOS 上是 brew install --cask diffusionstudio/tap/editor，也可以从官网下载页取 macOS（Apple Silicon）与 Windows（x64）的安装包 11。
2. 在 app 的 Settings → MCP & CLI 里把你的 Agent 接上，app 会把自己的 MCP 服务端注册给它 11。
3. 装官方技能包：npx skills add diffusionstudio/skills -g -y --all。包里两个技能，editor 负责理解、生成与剪辑，watch 负责回答素材里有什么、某个镜头在第几分钟 1314。技能内容随 app 打包，路径是 Diffusion Studio.app/Contents/Resources/docs，所以它跟你装的版本一致。
4. diffusion open /path/to/project 打开或新建项目文件夹，然后就是改文件。工具面里没有把内容推进 app 的命令，回路是开一次、之后编辑源码 7。

会卡住的地方

• Linux 上接不了 Agent。 症状：桌面 app 装不上，工具面用不了。触发条件：你在 Linux 或容器、CI 里跑。现状：桌面版只支持 macOS 12+（M1 及以上）与 Windows x64，网页版能在 Linux 打开但接不上编码 Agent 工作流 11；请求 Linux 构建的 #40 从 2026 年 8 月 31 日开到现在仍是 open 15，两个打过包的 PR（#42、#58）都没合并，其中 #58 自己写明 Linux 上 mp4 导出缺 AAC 编码器 16。你能怎么办：把编辑器留在桌面机上，Linux 侧只做素材与流水线的其它环节，或者等那类补丁落地。
• Windows 现在踩在一串刚开的问题单上。 症状：从源码检出后 CLI 构建失败在 chmod 上、dapi 的命名管道握手一直完不成；场景的子节点不挂到父节点，capture 与渲染出的是空帧。触发条件：Windows 上从源码跑，或者用 dapi 驱动。现状：#82 与 #83 都由 alvarovegaromero 在 2026 年 9 月 26 日提交，当天仍是 open 1718；#75（dapi 出错时直接 abort，退出码本该是 1）2026 年 9 月 17 日开、open 19。你能怎么办：Windows 上先用装好的 app 与应用内的 Chat 标签，dapi 那条链路等问题单关掉之后再试。
• 每个工具都跑在 app 里。 症状：命令行只打一句启动提示然后以 1 退出，或者 dapi 报 not running。触发条件：app 没开，或者在无图形界面的环境里跑。现状：工具文档写明每个工具都运行在 app 内部、app 必须在跑，CLI 只是它的 MCP 服务端的客户端，diffusion open 是唯一会拉起 app 的命令 7；#60（diffusion-studio.sock 没被创建，app 在跑也报 not running）2026 年 9 月 5 日开、至今 0 条评论 20；#52（希望能在浏览器里跑起 app，好在 Codex、Cursor 这类浏览器 harness 里用）2026 年 9 月 2 日开，还是一条 feature request 21。你能怎么办：当前把它当成“桌面机上的编辑器加 Agent 驱动”，无人值守渲染这条路还没有官方入口。
• 导出有两处已知的丢帧与截尾。 症状：导出会间歇性地把画布大半冻在一帧旧画面上（节点 capture 不受影响）；在场景结束前结束的音频片段，尾巴被切掉。触发条件：导出。现状：#24 由 doruk-kavcioglu 在 2026 年 8 月 14 日提交、3 条评论 22，#65 在 2026 年 9 月 13 日提交 23，两条都还是 open；仓库里对应的修复 PR #67 与 #66 尚未合并。你能怎么办：导出后自己抽一帧、听一遍接缝，把“导出成功”和“画面正确”分开确认。
• 时间线缺一道护栏。 症状：轨道能被拖到负时间戳。触发条件：手动拖。现状：#55 在 2026 年 9 月 3 日开、2 条评论、open 24。你能怎么办：让 Agent 写 start / end 时校验非负，改完跑一次 diffusion check。
• 一处加固问题还没处理。 症状：shell.openExternal 接受任意 URL，Agent 写下的 markdown 里的相对链接会以 file:// 到达它。触发条件：打开 Agent 生成的 markdown。现状：#71 在 2026 年 9 月 17 日开、0 条评论、open，对应 PR #72 未合并 25。你能怎么办：等修复合并之前，别把不可信的 Agent 输出直接点开。
• 报告工具不给看日志。 症状：report 要求 Agent 先审它附上去的日志，却从不把日志显示出来。触发条件：用 report 开问题单。现状：#73 在 2026 年 9 月 17 日开、open，对应 PR #74 未合并 26。你能怎么办：开单之前自己跑一次 diffusion logs。
• 版本迭代快到文档与行为会错位。 症状：照着网上的旧文档写的命令，行为对不上。触发条件：你装的版本与文档写作时的版本不同。现状：仓库建了两个多月就攒下 608 次提交与 18 个 release，最近一版 v0.206.0 在 2026 年 9 月 24 日 1；官方技能包干脆写明文档随 app 打包、从 app 里读、别信记忆 13。你能怎么办：以你装的那一版为准。
• 维护面集中在一处。 症状：你撞到的 Windows 与导出问题，都要等同一个维护者回应。触发条件：把它放进长期依赖的基础设施。现状：608 次提交里 605 次来自 k9p5（Konstantin Paulus）、3 次来自 doruk-kavcioglu，仓库页面把贡献者列为 3 位（列表里还有一项 claude 账号，接口返回的两位与页面显示对不上）1。你能怎么办：自己留一份 fork，或者把它放在将来换得掉的位置上。

许可与真实成本

和之前几期放在一起看

今天该不该动手