mangfufu/director-desk

DirectorDesk – 面向 AI 生成短片的 3D 预可视化

它是什么

• 一款桌面应用程序（Windows 和 Linux），可让您构建简单的 3D 场景、放置角色和道具、编排其动作以及设计摄像机运动。
• 生成的“参考视频”（或深度视频）可以与提示文本一起输入视频生成模型，将粗略的故事板转化为完整的 AI 生成短片。
• 包含一个 AI 导演助手，可以理解自然语言指令并自动设置场景、路线或镜头切换，也可以通过 MCP 桥接由外部代理（例如 Claude、Codex）驱动。

主要功能

功能	您可以做什么
场景构建	使用内置白色模型资源或导入 GLB/FBX/OBJ 模型；布置家具、道具和角色。
动作与编排	将内置或自定义动画拖放到时间线上；手绘运动路径；录制键盘控制的行走。
摄像机设计	多摄像机、POV、变焦、轨道移动、手持抖动、镜头畸变、景深、焦点拉动。
时间线编辑	分割、修剪、速度曲线、多选、自动吸附剪辑、历史快照。
导出	渲染普通彩色视频或灰度深度视频（对下游 AI 流水线有用）。
AI 集成	内置导演助手（自然语言提示）以及支持外部 MCP 代理以编程方式操作项目。
插件与扩展	安装社区插件以获取额外效果、导入/导出格式或自定义工具。
跨平台	原生 Windows 安装程序/ZIP 和 Linux AppImage/tar.gz；支持 WSL。

典型工作流程

1. 创建场景 – 从模板（夜晚街道、走廊、卧室等）或空白场景开始，并放置角色/道具。
2. 安排动作 – 在时间线上分配动画、绘制运动路径、设置摄像机位置。
3. 预览与导出 – 实时查看摄像机视图，然后为 AI 视频模型导出参考视频（或深度图）。
4. 与 AI 迭代 – 用自然语言描述更改；助手更新场景，或外部代理运行脚本化编辑。

安装

• Windows：从 Releases 页面下载安装程序或便携式 ZIP，然后运行 DirectorDesk.exe。
• Linux：下载 AppImage（使其可执行）或 tar.gz，然后运行 DirectorDesk。
• 应用会自动检查更新；AppImage 更新在重启时应用。

许可证

• 核心代码根据 MIT 许可证发布。第三方资源（动画、模型）保留其原始许可证，如 NOTICE.txt 中所列。

谁可能受益

• 需要快速故事板并带有逼真摄像机运动的 AI 生成短片或营销视频创作者。
• 构建结合 3D 预可视化与文本到视频模型的流水线的团队。
• 探索结构化场景数据（位置、深度图）如何提高视频生成质量的研究人员。

---

以上所有信息均直接取自仓库的 README。