[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-96164":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":14,"stars7d":14,"stars30d":15,"stars90d":14,"forks30d":14,"starsTrendScore":14,"compositeScore":16,"rankGlobal":9,"rankLanguage":9,"license":17,"archived":18,"fork":18,"defaultBranch":19,"hasWiki":18,"hasPages":18,"topics":20,"createdAt":9,"pushedAt":9,"updatedAt":21,"readmeContent":22,"aiSummary":23,"trendingCount":14,"starSnapshotCount":14,"syncStatus":24,"lastSyncTime":25,"discoverSource":26},96164,"director-desk","mangfufu\u002Fdirector-desk","mangfufu","AI 短剧白模预演与摄影机调度工具",null,"JavaScript",139,41,121,0,13,4.87,"MIT License",false,"main",[],"2026-09-21 02:04:30","# 导演台 · DirectorDesk\n\n面向 AI 短剧和视频创作的三维预演工具。搭场景、排走位、设计运镜，再导出参考视频。可以手动制作，也可以让内置 AI 助手或外部 MCP Agent 直接操作当前工程。\n\n[下载 Windows 版](https:\u002F\u002Fgithub.com\u002Fmangfufu\u002Fdirector-desk\u002Freleases\u002Flatest) · [配套 skill](https:\u002F\u002Fgithub.com\u002Fmangfufu\u002Fdirector-desk\u002Freleases\u002Flatest) · [MIT License](LICENSE)\n\n![0.4.2 光影舞台：布景与摄影机并排预览，下方编排动作和切镜](docs\u002Fimages\u002Fworkspace.jpg)\n\n## 场景与运镜演示\n\n以下动图全部来自软件内置模板的实际摄影机输出，按原速播放，仅降低分辨率和帧率；空房间截取前 8 秒。打开“新建工程 \u002F 模板”即可继续编辑；空白场地也保留供自由搭建。\n\n| 光影舞台 · 冷暖布光、环绕与变焦 | 悬疑长廊 · 希区柯克变焦 |\n| --- | --- |\n| ![光影舞台实际运镜](docs\u002Fimages\u002Flight-stage.gif) | ![悬疑长廊：主体大小稳定，背景空间变化](docs\u002Fimages\u002Fdolly-hall.gif) |\n| 夜街追逐 · 双人奔跑、手持晃动与广角畸变 | 卧室 · 四人调度、窗光与床头暖灯 |\n| ![夜街追逐实际运镜](docs\u002Fimages\u002Fneon-chase.gif) | ![卧室四人调度](docs\u002Fimages\u002Fbedroom.gif) |\n| 空房间 · 窗光、木地板，留空布置 | 林地空地 · 树群、步道与双人调度 |\n| ![空房间场景预览](docs\u002Fimages\u002Froom.gif) | ![林地空地人物与摄影机运动](docs\u002Fimages\u002Fpark.gif) |\n| 街道 · 黄昏商铺、人行道与路灯 | 庭院 · 门架、格栅凉棚与台阶平台 |\n| ![黄昏街道预览](docs\u002Fimages\u002Fstreet.gif) | ![庭院场景预览](docs\u002Fimages\u002Fcourtyard.gif) |\n\n\u003Cdetails>\n\u003Csummary>查看模板选择界面\u003C\u002Fsummary>\n\n![新版场景模板选择界面](docs\u002Fimages\u002Ftemplates.jpg)\n\n\u003C\u002Fdetails>\n\n![0.4.3 流光空间：粒子、薄膜、形变与光学材质的实际摄影机输出](docs\u002Fimages\u002Fabstract-stage.png)\r\n\r\n## 能做什么\n\n| 功能 | 用法 |\n| --- | --- |\n| 白模搭景 | 人物、动物、家具、建筑、道路和道具；调整尺寸、颜色与位置，支持物体吸附 |\n| 仅几何体 | 用 16 种几何形状组合、命名、上色，快速表达空间；精细模型模式按需检索资产 |\r\n| 模型与动作导入 | 导入 GLB\u002FglTF、FBX、OBJ 模型；导入骨架动作或收藏模型自带动作，加入用户动作库 |\n| 人物调度 | 走位路径、基础动作、群演和手持道具绑定；用键盘操控白模并录制路径 |\n| 摄影机 | 同场景真实取景，多机位路径、视线、跟随、POV 和切镜 |\n| 运镜与镜头效果 | 运镜预设、希区柯克变焦、手持晃动、畸变、景深与对焦 |\n| 灯光 | 摆放灯光，调整颜色、强度和阴影，编排环境与灯光关键帧 |\n| 图片与视频材质 | 在模型表面贴图或播放视频，裁剪、平铺、调整透明度；也可用聚光灯投影 |\r\n| 抽象元素 | 粒子、光环、丝带、文字、影响区域、形变和局部空间扭曲，支持关键帧 |\r\n| 镜面与门户 | 平面镜像和另一台摄影机的实时画面 |\r\n| 时间轴与曲线 | Ctrl 多选、整组移动与延长、分割、删除和时间范围选择；用曲线控制加速、减速与停顿 |\r\n| 多场戏接拍 | 同工程管理独立戏段，从上一段末帧继承场景与人物状态 |\n| 导出 | 单场或批量导出视频、修改输出文件名，保存工程与素材包；可选人物名称标签 |\n| AI 协作 | 内置助手和 MCP Agent 按需查询空间、编辑当前工程；选中人物、片段或时间范围后交给 AI 局部调整 |\r\n| 提示词与技能 | 每场保存配套视频提示词；导入、下载和启停自定义技能，支持离线生成工程 |\n\n\u003Cdetails>\n\u003Csummary>查看灯光与摄影机设置\u003C\u002Fsummary>\n\n![光影舞台：直接调整灯光强度、颜色和阴影](docs\u002Fimages\u002Flighting.jpg)\n\n![悬疑长廊：摄影机取景与参数](docs\u002Fimages\u002Fcamera-path.jpg)\n\n\u003C\u002Fdetails>\n\n## 让 AI 直接操作\n\n**内置导演助手**：配置模型渠道，用自然语言提出搭景、走位和镜头调整要求。助手窗口可拖动、缩放和收起，支持执行与讨论模式。\n\n![新版导演助手：光影舞台中的任务输入示例，尚未发送](docs\u002Fimages\u002Fai-assistant.jpg)\n\n**外部 MCP Agent**：在桌面版的 **AI → MCP 连接** 中启用服务、复制连接配置。让支持 MCP 的 Agent 读取内置 `director_skill`，即可查询指定时刻的位置、理解空间关系并编辑当前工程。成功修改可以定位查看，也可以撤销。 可选择 Claude Code、Claude Desktop、通用 HTTP 或 stdio 配置；stdio 桥接随软件提供，无需另装 Node.js。连接方式见 [MCP 使用说明](docs\u002Fmcp-clients.md)。\r\n\n**自定义技能**：在 **AI → 技能** 导入自己的 SKILL.md 或技能文件夹，也可从公开 GitHub 技能目录下载，自由启用、停用和更新。技能保存在本机，软件升级保留用户技能。\n\n配套 [skill 与离线工具](skills\u002Fdirector-desk\u002F) 随软件提供，也可独立下载；没有 MCP 时，Agent 仍可生成可导入网页版本的 .director 工程文件。\n\n## 开始使用\n\n1. 从 [Releases](https:\u002F\u002Fgithub.com\u002Fmangfufu\u002Fdirector-desk\u002Freleases\u002Flatest) 下载 Windows 安装包或免安装 ZIP。\n2. 安装后启动，或完整解压 ZIP 后运行 DirectorDesk.exe。\n3. 选择场景模板，摆放人物与道具，在时间轴上编排动作和镜头。\n4. 播放预览，导出参考视频；点击戏段旁的“提示词”查看、编辑或导出文案。\n\n齿轮设置中可配置默认工程与导出目录。导出时选择“批量戏段”，勾选需要的戏段并修改文件名，各段沿用自己的画幅、时长和切镜。\n\n“用户动作库”支持预览、命名、搜索和骨架映射，可跨工程使用。已应用动作的源素材随工程保存，删除本机收藏不影响已有工程。\n\nWindows 版启动时检查网站和 GitHub 的最新正式版本，也可手动检查。安装版支持下载后重启安装；免安装版下载新版 ZIP。\n\n## 本地开发\n\n准备 Node.js 24+ 和 npm：\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fmangfufu\u002Fdirector-desk.git\ncd director-desk\nnpm ci\nnpm run dev\n```\n\n按终端显示的地址打开网页。构建网页和 Windows 桌面版：\n\n```bash\nnpm run build\nnpm run desktop:pack\n```\n\nmacOS（Apple Silicon）构建 DMG：\n\n```bash\nnpm run desktop:pack:mac\n```\n\n网页产物位于 `dist\u002F`，桌面交付文件位于 `release\u002F`（Windows 为 `DirectorDesk-Setup-\u003C版本>.exe`，macOS 为 `DirectorDesk-\u003C版本>-arm64.dmg`）。桌面构建使用本机 Chrome，可通过 `CHROME_PATH` 指定浏览器。macOS 包未做签名和公证，首次打开如被 Gatekeeper 拦截，请右键点击应用选择“打开”；macOS 版暂不支持应用内自动更新，请从发布页下载新版本。\n\n发布 Windows GitHub Release 时，将构建生成的 `release\u002Flatest.yml` 与同版本安装包一起上传，保留文件名。更新客户端按清单校验下载包；缺少清单的历史 Release 仍可检测版本并打开下载页。\n\n| 目录 | 内容 |\n| --- | --- |\n| `src\u002F` | 场景、编辑器、动画、渲染和共用自动化工具 |\n| `desktop\u002F` | 桌面入口、AI 协议、MCP 服务和更新客户端 |\n| `skills\u002Fdirector-desk\u002F` | 技能说明与离线工程工具 |\n| `scripts\u002F`、`tests\u002F` | 构建与验证工具 |\n\n## 许可证\n\n项目自有代码采用 [MIT](LICENSE) 许可证。第三方依赖和动作素材保留各自许可，内置动作来源见 [NOTICE](src\u002Fanimation\u002Flibrary\u002FNOTICE.txt)。\n","DirectorDesk 是一款面向 AI 短剧与视频创作的三维预演工具，支持白模搭景、人物走位调度、多机位运镜编排及灯光\u002F镜头效果设计，并可导出参考视频。核心功能包括几何体快速建模、GLB\u002FFBX 模型与动作导入、时间轴关键帧编辑、希区柯克变焦与手持晃动等专业运镜模拟，以及内置 AI 导演助手和 MCP 协议外部 Agent 协作能力。适用于短剧分镜预演、AIGC 视频前期策划、影视教学演示及独立创作者的低成本可视化脚本验证场景。",2,"2026-09-11 02:30:08","CREATED_QUERY"]