自主成片：dir 指令体系
37-导演台 · 2026-10-12 · 4.9 KB
本卷重点：导演台的自主 AI 是怎么用 dir.* 指令一步步把片子做出来的，以及"自主"到底靠什么机制成立。
本专题手工维护（2026-10-12 建）。
⛔ 指令的权威清单永远在控制台里：敲 dir.sys.help（本文只讲族与链路的心智，不抄全清单 —— 抄了就会过期 ✗）
一、先分清两条通道（⛔ 混了就会"发了没反应"）
**dir.（导演台通道）* | **uc_do_（MCP 工具通道）* | |
|---|---|---|
| 给谁用 | 应用内导演台的自主 AI | 内置助手 / 外部 MCP 客户端 |
| 在哪生效 | 导演台控制台 | 画布与 MCP 客户端 |
| 关键口径 | **"导演台的事一律用 dir."* | 那族是画布的工具 |
原话口径：导演台里没有"导演台工具" ⇒ 你发出去的"工具调用"不会被解析 ✗
⇒ 在导演台干活，就**只用dir.*；离开导演台（走 MCP）才用uc_do_*✓
二、dir 指令体系：一份注册表，12 个功能族
同一份注册表同时服务三种模式与三种消费者（用户自主 / 聊天·AI 自主 / 帮助与自动补全）⇒ ⛔ 不存在"两套文档漂移" ✓
| 族 | 管什么 | 代表指令 |
|---|---|---|
计划 dir.plan.* | 建集、加载、归档、进度、审计、快照 | dir.plan.create（唯一"新建"入口）· dir.plan.progress · dir.plan.validate |
纲领 dir.bible.* | 导演全局设定（创作前必读） | dir.bible.get · dir.bible.set · dir.bible.check |
资产 dir.asset.* | 资产建卡 / 改 / 生成媒体 / 清单 | dir.asset.add · dir.asset.gen · dir.asset.states.* |
分镜 dir.shot.* | 分镜增删改、引用、清单读写 | dir.shot.catalog.write · dir.shot.add（唯一落库门） |
引擎 dir.engine.* | 选型、逐镜提示词、预检 | dir.engine.add · dir.engine.genprompt · dir.engine.preflight |
执行 dir.run.* | 调度逐镜生成、批处理、停止、状态 | dir.run.engine · dir.run.auto · dir.task.list（回执渠道） |
产出 dir.out.* | 产物清单、合并队列 | dir.out.list · dir.out.enqueue · dir.out.merge |
项目文件 dir.project.* | 大纲/故事/剧本/资产/清单读写、项目根、台账 | dir.project.read · dir.project.append · dir.project.new |
批阅 dir.review.* | 求放行、回炉、裁决 | dir.review.submit（AI 唯一求放行入口）· dir.review.judge（仅人） |
知识库 dir.kb.* | 失败记录、工单收口 | dir.kb.fail · dir.kb.tick |
技能 dir.skill.* | 技能增删改查 | dir.skill.list · dir.skill.add |
系统 dir.sys.* | 帮助、模式、静默授权、撤销 | dir.sys.help（权威清单）· dir.sys.mode · dir.sys.silent |
⚠ 族数与条数会随版本演进 ⇒ 以 dir.sys.help 现查为准 ✓
三、★ 自主成片的推进链路（按阶段）
总原则：一次只推进一个明确阶段（⛔ 不要一把梭 ✗）—— 每阶段"读现状 → 改 → 请人放行 → 看回执" ✓
⚠ 前提：自主 AI 跑在文本大模型上（与画布 AI 助手共用同一个模型选择）⇒
没配模型 ⇒ 它没有"脑子"可推进（先在「设置 → API 服务商」配 Key，或用「WorkBuddy 积分通道」免 Key 通道 ✓）
阶段 0 · 读懂现状（创作前必读 = 第 0 道门）
dir.project.status → dir.project.read（大纲/故事/剧本）
→ dir.plan.status · dir.bible.get · dir.asset.list · dir.shot.list
⇒ 产出：知道哪一集、计划到哪、缺什么 ⇒ 再决定"这一轮做什么" ✓
阶段 1 · 立纲领（设定）
dir.bible.check（查齐全度 + 可写字段）→ dir.bible.set <字段>=<值> → dir.review.submit（请人放行）
⇒ AI 可自主起草，人负责修改与审批放行 ✓
阶段 2 · 产资产（"演员与布景"就位）
dir.asset.list / dir.asset.templates → dir.asset.add（纲领门 + 名单越界门）
→ dir.asset.gen <资产名>（建节点→跑→取产物→回填 url/fileName/kind）
→ dir.review.submit asset <名>（人放行）
⇒ ⚠ 资产必须先就位：分镜的 refs 只能引用已存在的资产 ✓
阶段 3 · 写分镜（先清单、后落库）
dir.shot.catalog.write（整份清单）→ dir.review.submit shotlist（人放行）
→ dir.shot.add（**唯一落库门**：要求清单/材料齐）
⇒ 好处：先审清单再落库，避免"一镜一改"反复折腾 ✓
阶段 4 · 建引擎 ＋ 逐镜提示词
dir.engine.add（⚠ **导演台刻意只开放海螺系**：hailuo-gen / hailuo-ref 二选一
—— 自主 AI 全程只许这两支；其余 kind 属**画布侧**（用户自定义引擎）✓）
→ dir.engine.genprompt <id> --mode ai （逐镜生成提示词；自主模式下**不许直接塞文本**）
→ dir.engine.preflight <id>（逐镜 dry-run 预检）
→ dir.review.submit engine（人放行）
⇒ ⚠ 提示词一律走"生成"通道：自主 AI 禁用手写文本参数 ⇒ 防止绕开规范 ✓
阶段 5 · 跑（受理即返回）
dir.run.engine <id> [--shot N] ← 单镜重跑/补镜也走它
dir.run.auto（批处理：只补失败/未完成，或全部重跑）
⇒ ⛔ 跑起来别等：指令受理即返回，真实进度与结论写进任务台账 ⇒ 用 dir.task.list 取 ✓
阶段 6 · 收与交
dir.run.status / dir.task.list（确认各引擎结束）
→ dir.out.enqueue（选段进合并队列）→ dir.out.merge（≥2 段 ⇒ 合成一段）
失败路径：dir.review.list → dir.review.claim（认领）→ 修 → dir.review.report（回报）
四、★ "自主"体现在哪（设计特色）
| # | 机制 | 为什么这样设计 |
|---|---|---|
| 1 | 受理即返回 ＋ 任务台账 | 长任务（逐镜出片）不阻塞 AI ⇒ 它可以边等边推进别的阶段，而不是干等 ✓ |
| 2 | 门链只对自主 AI 生效 | 判据是"模式是 auto 且不是人操作" ⇒ 人自己动手不用排队，AI 才守规矩 ✓ |
| 3 | 静默权按"蓝图归属" | AI 的静默只覆盖它自己那份蓝图；一旦触碰人的创作 ⇒ 必须有人点头 ✓ |
| 4 | 自主回炉循环 | 扫待办（dir.review.list 顶部"该你回炉"）→ claim 认领 → 执行 → report 回报 → 停手等人放行 ✓ |
| 5 | alwaysSilent（永远直接执行） | 只发给"不碰用户创作、又是必须发生"的指令（如失败记录、工单收口）⇒ 让它无摩擦落地 ✓ |
| 6 | escalateFlag 抬级 / dryFlag 预演 | 一个布尔参数就能把危险动作抬到需人确认；预演开关则不改数据、降级放行 ✓ |
| 7 | 能力边界硬拦 | 自主模式只许两类海螺引擎；沙箱跑不了的节点交给人 ⇒ 不给 AI 留"越界试试"的口子 ✓ |
| 8 | 能判定的不交给自觉 | 结构/引用/提示词段数这类可判定的事交给校验与预检，不指望模型"记得住" ✓ |
五、自主 AI 的三条纪律（照做能少踩坑）
- 创作前必读：任何改动前先读现状（纲领/资产/分镜）⇒ 否则必撞"引用不存在""越名单" ✗
- 一次一个阶段：读→改→请放行→看回执，⛔ 别连跳三步 ✓
- 跑起来就查台账：
dir.task.list是唯一的结论渠道（⛔ 别凭猜 ✗）
六、怎么"现查"（别背清单）
| 想知道 | 怎么办 |
|---|---|
| 有哪些指令、某个指令怎么用 | 控制台敲 dir.sys.help（可分组、可单个问）✓ |
| 某阶段的标准做法与规则 | dir.shot.catalog.get --rules（分镜书写规则）· dir.engine.doc（引擎说明书） |
| 跑完的结果 | dir.task.list ✓ |
| 目录/引用/提示词的硬规则 | dir.engine.preflight 的返回（每条带依据与修法）✓ |
想看 MCP 侧（外部客户端）怎么走同一件事 ⇒ 见《MCP 指南》卷的「标准作业流程（SOP）」与「调用规范」✓
来源：E:/workbuddyProj/unlimitCanvas/ai_manual/director_studio/03-自主成片（dir 指令体系）.md