@oh-story/dsh 0.1.3 → 0.1.5

package/lib/drama/skills/short-drama/SKILL.md

@@ -1,153 +1,146 @@
 ---
 name: short-drama
-description: 基于文件系统初始化、继续和交付短剧或漫剧项目，并提供面向创作者的本地 Dashboard；也负责项目级制作形态、视觉方向和 Look Development 路由。用户提出“创建/继续短剧项目”“看进度/下一步”“做 Look Development”“打开 dashboard/短剧创作台”“导出制作资料”，或任务跨多个环节而需要判断负责技能时使用；明确的写作、资产、提示词、分镜或审查请求由对应子 skill 直接处理。
+description: 基于文件系统初始化和继续短剧或漫剧项目，提供 creator-first 五文档路由、本地 Dashboard、制作形态与 Look Development 决策。用户提出“创建/继续短剧项目”“看进度/下一步”“做 Look Development”“打开 dashboard/短剧创作台”“导出制作资料”，或任务跨多个创作阶段时使用；明确的写作、资产、提示词、分镜或审查请求由对应子 skill 直接处理。
 license: MIT
 ---
 
 # 短剧创作路由
 
-本技能负责找到项目、显示当前状态并把工作交给正确的创作技能，不代写各阶段内容。
+本技能负责项目初始化、跨阶段路由、制作形态与 Dashboard。各阶段正文由对应 owner 完成。
 
 ## Quick Start
 
-先离线确认本技能被单独复制后仍能初始化、读取和保护项目路径：
+所有项目统一使用 [creator-first 工作流](references/creator-workflow.md)：每集按需维护
+`剧本.md`、`视觉设定.md`、`分镜.md`、`图片提示词.md`、`视频提示词.md`，不建立并行的结构化创作真相。
+具体写法见 [五份创作文档](references/creator-documents.md)。
+
+## 路由
+
+| 用户要做什么 | owner / 行为 |
+|---|---|
+| 开发点子、系列承诺、改编和分集地图 | `$short-drama-develop`，仅在用户需要时 |
+| 已有多集完整剧本/散稿识别分集 | `$short-drama-develop` 按实际边界建立临时索引 |
+| 分析长篇原著 | `$short-drama-novel-analyze`，仅在用户需要时 |
+| 写或改单集剧本 | `$short-drama-write` → `剧本.md` |
+| 拆人物、造型、地点、道具 | `$short-drama-assets` → `视觉设定.md` |
+| 写资产图片提示词 | `$short-drama-image-prompts` → `图片提示词.md` |
+| 做镜头和冻结关键帧 | `$short-drama-storyboard` → `分镜.md` |
+| 写视频/时间线音乐提示词 | `$short-drama-video-prompts` → `视频提示词.md` |
+| 实际生成媒体 | `$short-drama-produce`，先预览，再显式确认，最后运行 |
+| 审稿或校验 | `$short-drama-review`，仅在用户点名时 |
+| 初始化、Dashboard、归档点名文档 | 本技能 |
+
+`项目开发/` 中的长材料分析与分集索引是可选分析工作区，不参与单集布局判定；写任何一集仍只维护
+该集的五份 creator-first Markdown。
+
+现成剧本可直接拆资产；已有视觉事实可直接写图片提示词或分镜；已有分镜可直接写视频提示词。
+不要为补齐名义流水线伪造上游。
+
+## 执行请求
+
+1. 找到用户给出的项目或资料，只读当前任务的直接输入。
+2. 把用户点名的完整范围交给相应 owner；批次只控制上下文，自动续跑。
+3. 只有真实创作分叉才询问；不要拿 schema、目录、事务或检查器询问创作者。
+4. 范围完成后一次回报完成内容、关键决定、真实未决项和可选下一步。
+5. 不自动开始用户没点名的审查、归档或生产。
+6. 请求横跨视觉设定、图片提示词、分镜或视频提示词时，结束前按当前五文档做一次视觉依赖对账；
+   不因图片提示词和分镜可并行，就把后完成的一支留在另一支的旧引用之外。
+7. 视频提示词请求遇到「输入参考图：无」或仍带「待补参考图」时，先路由分镜 owner 检查项目已有图片并刷新绑定。有匹配图就同请求续跑；有必要图缺失就列表停下。
+   只有用户明确选择文生视频才允许无图续跑，不把“没有手工指定”当成这个选择。这一轮如果镜头还缺「视觉依据」，
+   同时按已成稿的冻结关键帧回填；两条依据描述同一格画面，不要只补一条。
+8. 用户在会话里点名目标视频模型（“按 MiniMax H3 写”“用 Seedance 2.5”）而 `short-drama.json` 的
+   `production_profile` 还是 `unset` 时，先把这个选择连同它带来的原生时长、参考方式和正文语言写进档案，
+   再继续下游阶段。会话里的一句点名不落到档案上，下一轮就会退回通用路径，方言和时长要重猜。
+
+## 初始化与 Dashboard
+
+需要项目配置时运行：
 
 ```bash
-python3 {技能目录}/scripts/selftest.py
 python3 {技能目录}/scripts/project_tool.py init ./my-drama --title "示例短剧"
 ```
 
-创作者可读内容使用 `short-drama.json#/language`；交给图片或视频生成器的提示词正文使用
-`#/format/prompt_language`。两者互不推断，详见
-[contract-and-ownership.md](references/contract-and-ownership.md#output-language-contract)。
-
-## 每次请求的起点
-
-1. 使用用户给出的路径，或从当前目录向上寻找最近的 `short-drama.json`。
-2. 运行 `status`，只读完成当前任务所需的直接输入，不批量加载整个项目。
-3. 按用户眼下要完成的工作路由；未安装的阶段技能只影响对应路由，不阻断其他工作。
-4. 明确的单阶段任务直接交给独立安装的对应技能，按创作者要的那一步做。
-
-统一预检见 [runtime-preflight.md](references/runtime-preflight.md)，创作入口见
-[creator-workflow.md](references/creator-workflow.md)，所有权见
-[contract-and-ownership.md](references/contract-and-ownership.md)。
+直接输入已经确认创作者说明语言、提示词语言、画幅、集数或单集目标时长时，首次 `init` 就带上对应的
+`--language`、`--prompt-language`、`--aspect-ratio`、`--episode-count`、`--target-seconds`；只省略
+未确认项，不让 Brief 中的确定事实留成配置里的 `null`。写入已确认的生产档案时，状态统一为
+`accepted`；`unset` 只表示尚未决定，不另造中间状态。
+`init` 只建立配置和空目录；第一次创作时再把文档写入 `剧集/<EP>/`，不预建空文件。
+项目已经建好、用户之后才定下目标视频模型时，把选择写进档案，并同时展示它对时长区间、参考方式和
+正文语言的影响。档案只接受已发布并已接受的创作者决策，所以是三步，不是一步。先写一行决策记录
+（`accepted_value` 就是要落进 `choices` 的对象本身，不要再包一层 `choices`）：
+
+```jsonl
+{"decision_id":"CD-H3","status":"accepted","target_locators":[{"src":"short-drama","field":"/creator_authority/production_profile/choices"}],"accepted_value":{"target_video_model":"minimax-h3","video_prompt_dialect":"minimax-h3","video_prompt_language":"en","native_duration_seconds":{"min":4,"max":15},"supported_generation_modes":["text","first_frame","first_last_frame","reference"],"audio_generation":"same_pass"}}
+```
 
-## 意图路由
+再发布、接受、写入：
 
-| 创作者意图 | 路由 |
-|---|---|
-| 开发点子、系列承诺、改编和分集地图 | `$short-drama-develop` |
-| 导入已有多集完整剧本/散稿并生成或补分集地图 | `$short-drama-develop` 按文件实际结构建立索引，每次只读当前集并续跑 |
-| 判断长篇是否值得改、建立原文索引 | `$short-drama-novel-analyze` |
-| 写或改单集契约、节拍、剧本 | `$short-drama-write` |
-| 拆人物、造型、地点、道具和状态 | `$short-drama-assets` |
-| 写人物、地点、道具和 Look Development 图片提示词 | `$short-drama-image-prompts` |
-| 做覆盖设计、镜头和冻结关键帧 | `$short-drama-storyboard` |
-| 写动作、表演、运镜、声音视频提示词 | `$short-drama-video-prompts` |
-| 写主题曲/配乐意图或校验时间线音乐规格 | `$short-drama-video-prompts`，歌词必须由创作者提供并接受 |
-| 按已确认规格实际生成图片、视频、TTS 或时间线音乐 | `$short-drama-produce` 先展示本次 job，得到明确确认后才执行 |
-| 定制作形态、视觉方向或 Look Development 路径 | `$short-drama` |
-| 校验、审稿或发修订请求 | `$short-drama-review` |
-| 打开创作台、看内容和进度 | `$short-drama dashboard` |
+```bash
+python3 {技能目录}/scripts/project_tool.py publish <project> --owner short-drama \
+  --artifact-id AR-PROFILE --output "创作者决策/production-profile.jsonl=输入/profile.jsonl"
+python3 {技能目录}/scripts/project_tool.py accept <project> --artifact-id AR-PROFILE --decision accepted
+python3 {技能目录}/scripts/project_tool.py set-authority <project> \
+  --field /creator_authority/production_profile/choices \
+  --decision-ref "创作者决策/production-profile.jsonl#CD-H3"
+```
 
-用户的明确意图优先。Look Development 是可选分支；资产图片提示词和分镜在资产确认后可以
-并行，不互相等待。需要把已接受的视觉方向变成可比较的代表帧时，读
-[look-development.md](references/look-development.md)。
+各字段取值由命中的模型方言给出：`$short-drama-video-prompts` 的 MiniMax H3 / Seedance 方言文件都写了
+推荐档案。写完用 `status` 复核 `video_model_profile` 是否已经出现。
 
-**产物可以直接入场**。 上游的可选环节缺失不构成阻塞：现成剧本可直接进入资产；已接受资产
-可直接进入资产图片提示词；已接受剧本加资产可直接进入分镜；已接受镜头与关键帧可直接进入
-视频提示词。只补建对应技能拥有的、确实缺少的必要产物，绝不倒补虚构的创作简报或系列大纲。
+项目定位与安全写入见 [运行预检](references/runtime-preflight.md)。用户明确要求 Dashboard 时运行：
 
-**请求含糊时不要追问技术细节**。 遇到"帮我把这集做完"这类请求，先展示当前的创作者可读
-状态，再给出不超过三个有意义的动作，优先能解开当前交付阻塞的那个；不要拿 schema、事务或
-存储格式去问创作者。
+```bash
+python3 {技能目录}/scripts/dashboard_server.py --workspace <workspace> --port 0 --detach --open
+```
 
-## 有界续跑
+`--detach` 让服务进程脱离当前 shell 独立运行，会话结束、终端关闭或智能体退出都不会带走它；
+链接因此在整个创作期间保持有效。运行中的地址、端口和 pid 记录在
+`<workspace>/.short-drama/dashboard.json`（仅本人可读），日志在同目录 `dashboard.log`：
 
-全链预览或“继续”每轮只授权一个 owner 的一个有界工作单元。写作、资产、图片提示词、分镜和
-视频提示词按各自「每轮的工作单元」分批工作；完成当前批次后报告已覆盖范围、剩余范围与
-下一步，并把控制权交还创作者。下一阶段、审查和生产各自需要明确的后续请求；生产还要先展示
-准确 job 并取得确认。
+```bash
+python3 {技能目录}/scripts/dashboard_server.py --workspace <workspace> --status   # 打印当前链接
+python3 {技能目录}/scripts/dashboard_server.py --workspace <workspace> --stop     # 停止
+```
 
-审查尽量交给没有参与该版本创作的 reviewer，以减少自证偏差；运行环境不支持隔离上下文时，
-如实标注为自检即可。CLI 只记录 verdict、reviewer 标签和备注，不收集或伪造上下文证明。
-Reviewer 给出证据和修改请求，内容仍由原 owner 修改。
+同一 workspace 已有在跑的 Dashboard 时，再次启动只会打印同一个链接，不再开第二个端口；确实要换
+端口或换令牌时加 `--restart`。不加 `--detach` 时行为不变：前台运行，Ctrl-C 结束。
 
-## 初始化
+Dashboard 展示和编辑创作文件，不负责工作流编排或媒体生产。
 
-没有项目且用户要初始化时：
+## 项目级创作决定
 
-1. 确定标题、项目语言、提示词语言、画幅和路径；集数或时长未知就留空。
-2. 运行 `init` 建立最小目录和空状态，不覆盖现有文件。
-3. 将制作形态与视觉方向保持为 `unset`，告诉创作者下一个最有用的选择。
-4. 创作者定下形态、方向、播放面或集长目标后，把这条决定发布并接受为一条创作者决策记录，
-   再用 `set-authority` 写回 `short-drama.json`，让下游读到已 `accepted` 的值。
+制作形态、视觉方向、播放面和集长目标确实约束多个阶段时，展示选择及影响后由用户决定。
+Look Development 是可选分支，不是进入图片提示词或分镜的固定门槛。
 
-初始化不自动生成故事、剧本或资产设定。
+按问题只读取一份相关知识：
 
-## 本地 Dashboard
+- 规则分级与 owner 路由：[规则与路由索引](references/knowhow-index.md)
+- 输出语言、稳定 ID、所有权与安全边界：[契约与所有权](references/contract-and-ownership.md)
+- 实拍、二维、三维、水墨、Q 版、国漫的形态差异：[制作形态](references/production-form-profiles.md)
+- 需要比较代表帧时：[Look Development](references/look-development.md)
+- 参考图能控制什么：[参考角色](references/reference-roles.md)
+- 遮挡、延迟揭示和观众知情时机：[观众揭示](references/audience-reveal.md)
+- 母版、补拍和替代版的职责：[补拍与替代](references/pickup-and-alternate.md)
 
-Dashboard 是项目内容的轻量展示与有限文本编辑层，核心能力仍在各 skill 中。当用户调用
-`$short-drama dashboard` 时：
+## 生产与交付边界
 
-1. 项目存在时读取 `status`；浏览普通目录时直接使用该目录。
-2. 项目内启动时用项目根作为 workspace；否则使用用户给出的容器目录或当前目录。
-3. 从本技能安装目录运行：
+外部生产永远保留 `preview -> explicit confirm -> run`。归档只复制用户点名的当前文档和成品，排除
+私有输入、凭据、绝对路径与隐藏运行状态；不为归档补造审批、哈希或第二套内容。
 
-   ```text
-   python3 <short-drama-skill-dir>/scripts/dashboard_server.py --workspace <workspace> --port 0 --open
-   ```
+用户问“做完了怎么导出/交付给我”时，用 `export` 打包当前状态：
 
-4. 回报脚本打印的完整回环地址与停止方式，并保持进程运行。
+```bash
+python3 {技能目录}/scripts/project_tool.py export <project> --out <项目外目录>
+```
 
-Dashboard 只读取 workspace 内的文件；密钥、生产 adapter 与工作流编排都在它之外。它按项目
-和剧集展示正文、结构化卡片以及已有图片/音频/视频；保存只表示保存文件，不代表创作者确认。
-每次启动使用独立本机会话，项目 API 只接受该会话。参数与安全边界见
-[lifecycle-commands.md](references/lifecycle-commands.md#dashboard-启动)。
+它把每集现有的五份创作文档和 `剧集/<EP>/制作成果/` 复制到 `--out`，附 `manifest.json` 与
+`checksums.sha256`，并排除 `输入/`、`交付/` 和 `.short-drama/`。只要一部分时加
+`--episode EP001`（可重复）；只要文字时加 `--no-media`；覆盖旧目录加 `--overwrite`。
+`--out` 必须在项目之外。
 
-## 项目命令
+`export` 是**当前状态快照**，manifest 里 `asserts_approval` 恒为 `false`：它不声称任何审查或
+创作者接受。需要带审批证据的正式交付包仍然只有 `package`/`verify` 那条路径。
 
-从本技能安装目录调用 `scripts/project_tool.py`：
+## 安装维护
 
-| 命令 | 用途 |
-|---|---|
-| `init` | 初始化最小项目 |
-| `status` | 显示项目与产物状态 |
-| `publish` | 原子发布一项产物并记录它的直接输入 |
-| `accept` | 记录创作者接受或拒绝当前版本 |
-| `review` | 记录当前版本的复核结论 |
-| `set-authority` | 把已接受的创作者决策写回制作形态、视觉方向、播放面或集长目标 |
-| `package` | 打包当前已确认且复核通过的文本/JSON |
-| `verify` | 用交付校验和检查打包结果是否被改动 |
-
-完整示例见 [lifecycle-commands.md](references/lifecycle-commands.md)。单文件发布用临时文件与
-原子替换完成。
-
-## 状态与修订
-
-对创作者只使用六种状态：
-
-- `draft`：尚未发布；
-- `needs_confirmation`：等待创作者决定；
-- `accepted`：创作者已接受；
-- `revise`：创作者或 reviewer 要求修改；
-- `approved`：当前版本已确认且复核通过；
-- `update_needed`：输出或某个直接输入已经变化，需要重新发布。
-
-状态在读取时核对当前文件，不把过期传播写回整个项目。修订时只说明负责技能、语义变化、
-直接受影响的产物和下一步；重新发布会清除该产物旧的接受与复核结果，不触碰无关产物。
-除非诊断需要，不向创作者显示内部 hash 或原始状态文件。
-
-## 交付
-
-先由 `$short-drama-review` 复核，再用 `package` 打包。包内只收录明确选择的、当前状态为
-`approved` 的文本和 JSON，并记录有意省略项；二进制媒体、非公开输入、机器状态、绝对路径、
-凭据和未批准草稿不进入文本交付包。`verify` 检查清单、校验和及未登记新增文件。
-
-## 边界
-
-- 图片、视频和 TTS 生产只由 `$short-drama-produce` 在展示准确 job 并取得本次明确确认后执行；
-  其他技能不直接调用生成服务。
-- 运行时不检索外部或非公开生产来源。
-- 不把别处案例提升为项目定律。
-- 语义冲突不静默修复；不明外部改动由创作者选择保留或重做。
+只有安装、升级或排障时运行 `python3 scripts/selftest.py`。

package/lib/drama/skills/short-drama/references/audience-reveal.md

@@ -1,74 +1,21 @@
 # 观众此刻可以知道什么
 
-背影、腿部入画、门缝、画外声、浅景深和遮挡不只是画面风格。它们同时决定观众**何时**
-知道一个人是谁、看见那张字条、或者发现门后有人。
+背影、门缝、画外声、浅景深和遮挡会决定观众何时知道一个人是谁、看见证据或发现门后有人。
+需要同时防两种错：该给的信息被漂亮构图挡住；不该给的信息被镜头提前泄露。
 
-这件事容易被当成构图偏好处理，于是出两种错，而且两种都不会被"这镜好看吗"抓到：
+## 一条事实一条判断
 
-- 本镜本来要交代证据，却被一个漂亮的遮挡挡住了——**该给的没给**；
-- 剧本只允许观众先看到鞋和停步位置，结果正脸提前露出来——**不该给的给了**。
+对每个有揭示时机的事实，在对应 `SHOT-...` 下写清：
 
-所以每个镜头要按**事实**分开记录可见性，而不是给整镜写一句"稍后揭示"。
+- **事实来源**：来自哪个场景 ID、对白、动作或画面文字；
+- **本镜权限**：现在展示，还是暂时扣住；
+- **可见/可听载体**：观众具体能看到或听到什么；
+- **释放时机**：若暂时扣住，在哪个可见事件后释放；
+- **保护方法**：靠遮挡、景深、画外声、光线或构图怎样实现；
+- **戏剧理由**：为什么这个时机改变理解或压力。
 
-## 一条记录只管一个事实
+同一镜头里“来者认识主角”和“来者是谁”是两件事：可以让旧称呼先从画外传来，同时让来者的脸
+留在暗处。揉成一句“稍后揭示”，下游就无法分别处理声音和身份。
 
-这些记录写在镜头的 `audience_visibility[]` 里（字段属于 storyboard 的 shot 记录）。
-
-同一个镜头里，"这人是谁"和"他手里有什么"是两件独立的事，可以有完全不同的揭示条件。
-揉成一句，下游就只能一起放或一起收——所以 `audience_visibility` **按事实分条**，
-不是每镜一条。
-
-每条记录写清五项：
-
-| 字段 | 回答什么 |
-|---|---|
-| `fact` | 这条管的是哪一个具体事实 |
-| `source_ref` | 这个揭示义务来自剧本的哪一段 |
-| `permission` | 现在就给（`show_now`）还是先扣住（`withhold_now`） |
-| `carrier` | 观众此刻能看见或听见的是什么 |
-| `reveal_trigger` / `protection_method` / `rationale` | 什么时候放、靠什么扣住、为什么 |
-
-### 合成示例
-
-一个镜头里，观众要听见有人叫出主角的旧称呼（说明来者认识他），但**不能**看到来者的脸。
-
-`audience_visibility` 所在的 `shots.jsonl` 在第一行声明本文件引用到的上游快照：
-
-```json
-{"record_type":"sources","schema_version":"1.0.0","sources":{"screenplay":{"owner":"short-drama-write","artifact":"剧集/EP001/screenplay.md"}}}
-```
-
-数组里每条只写快照键和记录 ID：
-
-```json
-[
-  {
-    "fact": "来者认识主角的旧身份",
-    "source_ref": {"src": "screenplay", "record_id": "BLK-EP001-SC003-A02"},
-    "permission": "show_now",
-    "carrier": "画外一声旧称呼，主角闻声停手",
-    "reveal_trigger": "对方开口",
-    "rationale": "本镜必须让观众意识到主角被认出来了"
-  },
-  {
-    "fact": "来者是谁",
-    "source_ref": {"src": "screenplay", "record_id": "BLK-EP001-SC003-A05"},
-    "permission": "withhold_now",
-    "carrier": "只有门框边的一只手和影子",
-    "protection_method": "来者留在景深之外，不进正面光",
-    "reveal_trigger": "下一场推门进屋时",
-    "rationale": "身份揭示是场末的转折，提前露脸会让那一下失效"
-  }
-]
-```
-
-两条各有各的条件：**声音放，脸扣住**。写成一条就做不到这件事。
-
-## 不是"神秘感越多越好"
-
-扣住信息本身没有价值，它只在为后面某个具体时刻服务时才有价值。所以
-`withhold_now` 必须写出 `reveal_trigger`——说不出什么时候放，就说明这不是设计，
-只是没想清楚。
-
-审查时同时核对两侧：原文此刻**允许**透露什么，以及本镜**必须**传达什么。
-只评价构图是否漂亮的审查，抓不到这类缺陷。
+扣住信息本身没有价值；说不出何时释放，就说明还没完成设计。审查时同时核对原文此刻允许透露什么，
+以及本镜必须让观众明白什么。

package/lib/drama/skills/short-drama/references/contract-and-ownership.md

@@ -1,94 +1,43 @@
-# Contract And Ownership
+# 契约与所有权
 
-## Contents
-
-1. Project flow
-2. Runtime path ownership
-3. Output language contract
-4. Stable identities and references
-5. Rule classes
-6. Trust and file safety
-
-## Project flow
+## 工作流不是瀑布
 
 ```text
-development? -> screenplay -> assets -> image prompts
-                         \-> storyboard -> video prompts
-                         \-> confirmed production -> review -> delivery
+开发? -> 剧本 -> 视觉设定 -> 图片提示词
+                    \-> 分镜 -> 视频提示词
+                    \-> 明确确认后的媒体生产
 ```
 
-This is a routing map, not a mandatory waterfall. Direct entry is valid, and Look Development is optional.
-Each artifact records only the project files it directly read. There is no recursive stale-propagation graph.
-
-## Runtime path ownership
-
-`project_tool.py` does not contain a registry mapping business paths to skill names. The first published artifact
-claims its output paths in project state, and another artifact cannot silently overwrite those paths. Input,
-delivery and machine-state roots remain protected regardless of owner name.
+可以从任一已有材料直接进入；Look Development 和审查都按需发生。每个 owner 只修改自己的 Markdown，
+引用上游可见事实，但不静默改写它们。
 
-Each skill's own stage contract describes its semantic responsibility. An artifact may project another artifact's
-facts but may not silently redefine them. A reviewer requests changes; the responsible skill edits its source.
+## 输出语言
 
-## Output language contract
-
-| Field | Governs | Default |
+| 内容 | 有项目配置时 | 独立任务默认 |
 |---|---|---|
-| `short-drama.json#/language` | creator-facing artifacts, findings, status and Dashboard | `zh-CN` |
-| `short-drama.json#/format/prompt_language` | copyable image/video prompt bodies | `en` |
-
-Creator-facing prose follows `language`. Prompt bodies follow `prompt_language`. Depicted speech and on-screen text
-come from accepted story/asset facts, not from either description-language setting.
-
-## Stable identities and references
+| 创作者可读说明与审查 | `short-drama.json#/language` | 用户当前语言 |
+| 图片、关键帧的可复制正文 | `short-drama.json#/format/prompt_language` | `en` |
+| 视频的可复制正文 | 目标视频模型档案的 `production_profile.choices.video_prompt_language`；未声明时回退 `format.prompt_language` | 根据目标视频模型确认；未声明时使用用户当前语言 |
 
-Use stable IDs such as `EP001`, `SC001`, `BLK-...`, `CHAR-...`, `LOOK-...`, `LOC-...`, `PROP-...`,
-`SHOT-...`, `KEY-...` and `MOTION-...`. Display names may change without changing identity.
-
-For cross-artifact references, a file declares each upstream snapshot once, and every reference names that
-declaration plus the record it points at.
-
-A `.jsonl` file declares them on its first line:
-
-```json
-{"record_type":"sources","schema_version":"1.0.0","sources":{"screenplay-index":{"owner":"short-drama-write","artifact":"剧集/EP001/screenplay-index.jsonl"}}}
-```
-
-A `.json` file uses a top-level `"sources"` object with the same entries. A reference is then:
-
-```json
-{"src": "screenplay-index", "record_id": "BLK-EP001-SC001-A01", "field": "/text"}
-```
+创作者说明、通用提示词语言和视频模型提示词语言互相独立；画面中的对白和可读文字来自剧本/视觉事实，
+不由描述语言推断。
 
-`sources` keys are short, lowercase and derived from the artifact filename; each is unique and stable inside its
-file, and one artifact is declared under one key. `owner` and the project-relative `artifact` identify authority.
-`record_id` and `field` are optional selectors, and a reference pointing at a whole artifact keeps `src` alone.
-`authority` (`accepted` or `candidate`) belongs to the individual reference, because one snapshot can be read at
-different authority levels by different references. Do not copy whole authoritative values into consumers, and do
-not create self-references. A `sources` entry names the artifact the file was written against by `owner` and
-`artifact` only — no digest. Bytes are compared by the tool, in lifecycle state and delivery checksums, and that is not
-user-supplied lifecycle evidence and does not drive transitive invalidation.
+## 稳定身份与引用
 
-## Rule classes
+创作文档条目使用创作者可见的稳定 ID：`EP001-SC001`、`IMG-...`、`SHOT-...`、`MOTION-...`。其中 `IMG-...` 专属《图片提示词.md》的提示词标题，不代表已有图片。显示名可以改变，身份不因此改变。跨文档条目引用直接写这些 ID；不写哈希、内部路径、隐藏状态或第二套 record ID。
 
-- `structural_invariant`: locally provable; a script may block.
-- `reviewed_invariant`: semantic obligation; a reviewer may request revision.
-- `craft_default`: usually useful, but creator intent may override it.
-- `taste_option`: present alternatives; never block by itself.
+真实输入参考图不是图片提示词条目，所以每张图使用独立稳定的 `REF-...` 槽位，槽位内写显式顺序、可见项目相对路径、中文名称、用途和控制范围。它不使用 `IMG-...`；路径只用 `/` 分隔，不写绝对路径、Windows 盘符/网络路径或项目外路径。
 
-Word counts, shot counts, emotional curves and patterns seen elsewhere are not structural invariants unless the
-creator explicitly chose them as format constraints.
+## 规则分级
 
-## Trust and file safety
+- `structural_invariant`：本地可证明的引用、ID、算术或显式矛盾；
+- `reviewed_invariant`：需要结合语义证据判断的义务；
+- `craft_default`：通常有效，但创作者可以说明理由覆盖；
+- `taste_option`：表达选择，不能单独阻断。
 
-Deterministic suite scripts do not make outbound connections. Confirmed production may launch a project-external,
-locally configured adapter without a shell; that adapter owns any provider SDK/API access and reads credentials from
-its environment or system store. Released skills do not retrieve external or private production sources at runtime.
-Do not ship private identifiers, plot passages, prompt sentences, URLs, user data or credentials.
+字数、镜头数、情绪曲线和案例配方不是通用结构门槛。
 
-Creator input under `输入/` is immutable to publication commands. Machine state lives under `.short-drama/` and
-delivery under `交付/`; neither is an owner publication target. Text/JSON publication validates all sources before
-writing and replaces each target atomically under one project lock. A crash cannot expose a partially written file;
-rerun the command to continue. Unknown external edits are never silently overwritten.
+## 信任与文件安全
 
-Legacy v0.3 state remains readable. The next state-changing command rewrites only the compact artifact record; old
-transaction and propagation fields are not carried forward.
+普通创作不联网。实际媒体生产只允许项目外 adapter 读取环境凭据，并始终经过
+`preview -> explicit confirm -> run`。不要把私有输入、凭据、绝对路径或非公开观察写入可交付文档。