director-desk git:20260912.f841ca9A

Immutable. This exact content is served forever at /api/v1/blob/bda84d057033a414.

---
name: director-desk
description: 使用导演台工具编辑白模预演，或生成可导入的 .director 工程。适用于布景、走位、运镜和预演检查；纯分镜文案或图像生成不使用。
---

# 导演台

默认编辑用户当前工程的当前戏段，沿用已有对象；只有用户要求新建、复制或接拍时另建。仅讨论时不修改工程。

## 选择入口

- **已连接工具**：用 `director_skill` 读取软件当前的核心操作说明；当前对话已有同版本说明时复用，`knownVersion` 可确认是否变化。新对话重新读取，不依赖其他 Agent 的学习状态。按任务需要读它指向的附件，不先读完所有文档。
- **网页版或未连接 MCP**：直接制作可导入的 `.director` 文件，先读[工程格式与离线工具](references/project-format.md)。自包含 `scripts/project-tool.mjs` 使用 Node.js 22+，无需安装源码、联网或 API key。无脚本环境可按[最小工程](assets/minimal.director)生成，说明未自动校验。
- **旧版在线工具没有技能入口**：使用[核心操作说明](references/online-workflow.md)；不认识附件 path 时，直接读随包对应文件。

## 按任务读取

| 需要 | 说明 |
| --- | --- |
| 对象、动作、选区、空间、接拍及交付 | [编辑约定](references/editing.md) |
| 设计位置／视线运动、速度曲线、镜头效果和灯光 | [镜头与灯光](references/camera.md) |
| 图片视频表面、粒子、形变等 | [媒体与抽象元素](references/media.md) |
| 完成戏段后的配套生成提示词 | [提示词写作](references/prompt-writing.md) |

每场戏及分镜完成后，默认把配套提示词保存到该段 `production.promptText`；统一引用 `@视频1`，遵守实际入画和空间调度。用户只改软件设置或明确不要提示词时不附加生成。格式在需要写作时读取，不先加载所有示例。

离线编辑同样保留原有戏段、资源和未改字段。交付 `.director` 后说明在网页版「打开」导入；结构校验不能代替画面检查。连接凭据、API 密钥与本机私有目录不写入工程或提示词。