@oh-story/dsh 0.1.15 → 0.1.16

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

@@ -6,11 +6,10 @@ license: MIT
 
 # 长篇原著分析
 
-把一部长材料变成**能被引用、能被反驳、能被接着用**的分析层。目标不是复述剧情，而是找出
-每一段承担的戏剧功能，并说明它在竖屏短剧里值多少钱。
+从长材料中提取可追溯的戏剧功能，说明各段如何改变角色选择、信息、权力或关系，以及这些功能怎样用于竖屏短剧改编。
 
-分析永远是候选。哪条线保留、哪些人合并、从哪里开篇，是创作者的决定，由
-`$short-drama-develop` 立成改编契约。本技能不替它决定，也不批准自己的产物。
+分析结果供创作者取舍：保留哪条线、合并哪些人、从哪里开篇，由创作者决定，再交给
+`$short-drama-develop` 写成改编契约。本技能不批准自己的产物。
 
 ## Quick Start
 
@@ -40,7 +39,7 @@ python3 {技能目录}/scripts/novel_index.py index <原著.txt> --out <chapter-
 ## 先判断入口
 
 1. **只有书名，没有原文**：请创作者提供文件路径或粘贴正文。不要凭书名回忆情节——
-   没有字节就没有 span，没有 span 的分析无法被引用，也无法被反驳。
+   取得原文后才能建立章节范围和可追溯的引用。
 2. **有原文，未建项目**：直接建立一个本技能自己的工作区，至少包含只读输入目录
    `输入/` 与输出目录 `项目开发/source-analysis/_work/`；把原文字节复制到 `输入/` 后记录
    原始文件位置，再用本技能的 `novel_index.py` 建索引。若 `$short-drama` 可用，可选用它
@@ -65,9 +64,7 @@ python3 {技能目录}/scripts/novel_index.py index <原著.txt> --out <chapter-
 
 ### S0 章节索引
 
-索引是**唯一切片真源**，由 [章节索引脚本](scripts/novel_index.py) 建立。每个阶段各跑
-一次正则，就会切出互相对不上的章节，第 47 章按一种边界分析、按另一种边界聚合，
-而且没有人会发现。
+各阶段共用 [章节索引脚本](scripts/novel_index.py) 建立的章节边界，不各自重新切片。
 
 ```bash
 python3 {技能目录}/scripts/novel_index.py index 输入/{原文文件} \
@@ -81,6 +78,8 @@ python3 {core 技能目录}/scripts/project_tool.py publish {项目根} \
   --input 输入/{原文文件}
 ```
 
+独立运行时，将验证通过的 `_work/_index.next.json` 原子替换到正式的 `_index.json`，再进入 S1；不依赖可选的 core 发布命令。
+
 脚本识别阿拉伯数字与中文数字章号（含 千 / 两，覆盖千章以上连载），**只认一种编号单位**
 （章/回/节里出现最多的那个，其余记进 `ignored_heading_units`），只把**短的独立行**当标题
 （以章号开头的正文段落记进 `long_heading_lines_skipped`），剔除开头的目录块，
@@ -133,9 +132,7 @@ S1–S5 的 Agent 创作产物同样先写到 `source-analysis/_work/`，完成
 `_work/` 是候选工作区，不是权威分析层，也不进入交付包。
 
 **并发子代理写 `_work/`，主线程发布到正式路径**。子代理只落
-`_work/chapters/ch-<N>-extract.md`，主线程跑完机械自检后再发布到 `chapters/`。
-覆盖率闸门按正式路径 `chapters/` 匹配文件名——发布之前跑，每一章都会进
-`unmatched_files`，那不是缺陷，只是跑早了。
+`_work/chapters/ch-<N>-extract.md`，主线程机械自检后发布到 `chapters/`，再检查正式目录的覆盖率。
 
 `_progress.md` 每个阶段都会重写，而发布要求一个路径只有一个 owner，所以它用一个固定
 artifact-id：`source-analysis:progress`，owner 是 `short-drama-novel-analyze`，
@@ -155,17 +152,14 @@ python3 {技能目录}/scripts/novel_index.py coverage \
   项目开发/source-analysis/_index.json 项目开发/source-analysis/chapters
 ```
 
-`missing` 非空就补跑缺的章；`unmatched_files` 非空说明有文件名写歪了——它既不算覆盖，
-也不会被当成缺章，必须改名而不是重跑。**不要在覆盖率不足时进入 S3**——聚合会照样产出
-一份读起来完整的结果，而缺掉的章不会在任何地方留下痕迹。
+先检查 `unmatched_files`：命名错误的提取文件不计入覆盖，对应章仍会列入 `missing`；先更正文件名，再补跑真正缺失的章。
+**覆盖率不足时不进入 S3**。
 
-单章连续失败两次就标记跳过，写进 `_progress.md` 的失败记录，并在后续每一份聚合产物里
-注明该章缺失。失败可以接受，失败被藏起来不行。
+单章连续失败两次，先记录到 `_progress.md`，继续提取其他章。S2 结束后补齐失败章；仍有缺章时停在 S2，报告缺失范围，不进入全量聚合。
 
 ### S3 剧情单元与节奏
 
-从逐章提取聚合，不回头重读原文——原文已经在 S2 被读过一次，再读一次只会得到第二份互相
-矛盾的事实。按 [聚合与实体](references/aggregation-and-entities.md) 先识别故事框架
+从逐章提取聚合；事实或指代不清时按定位定点回查原文，不重新通读全书。按 [聚合与实体](references/aggregation-and-entities.md) 先识别故事框架
 （框架决定按什么切单元），再产出：
 
 - `story-units.md`：把情节点归成有始有终的单元，每个单元记录进入状态、冲突、代价与出去状态；
@@ -173,13 +167,13 @@ python3 {技能目录}/scripts/novel_index.py coverage \
   跨章伏笔与兑现，以及按观众收益排名的爽点表。
 
 聚合完成后跑同一文件里的三条阈值自检（归属置信、覆盖率、重叠率）与散落情节兜底。
-阈值不是评分，是**边界模糊的信号**：重叠率过高说明两个单元其实是一个。
+阈值是边界复核信号；重叠率偏高时，先区分多线交叉与边界重叠，再判断是否合并。
 
 ### S4 人物与设定
 
 按 [聚合与实体](references/aggregation-and-entities.md) 归并人物（跨章去重、别名归一、
-分级），并从提及数据归纳世界规则、力量体系与势力。别名只有专名与有同指证据的绰号能合并，
-描述性称谓与头衔**永远不触发合并**。
+分级），并从提及数据归纳世界规则、力量体系与势力。专名、绰号及“姓氏＋头衔”只有在同指证据充分时才能合并；
+泛指的外貌称谓或职务不触发合并。
 
 **人物归并是候选，不是资产**。 这里的人物条目带 `unresolved` 与来源引用，
 交给 `$short-drama-develop` 定改编决定、`$short-drama-write` 写进剧本之后，
@@ -195,14 +189,13 @@ python3 {技能目录}/scripts/novel_index.py coverage \
 - `episode-candidates.jsonl`：按**爽点分布、局部戏剧结果与精确交接**切出的候选集，不按章号
   或字数平均切。每条带来源 span、承担的功能、承接的爽点以及未决项。
 
-同时**回填快评**：S1 的哪几条判断被全量结果推翻了，写进 `adaptation-value.md` 的开头。
-一个抽样结论被证伪，比它被悄悄忘掉有用得多——下一本书的快评会因此更准。
+同时**回填快评**：把 S1 中被全量结果推翻的判断及原因写进 `adaptation-value.md` 开头。
 
 样例见 [分集候选样例](assets/episode-candidate.example.jsonl)。
 
 ### 交接
 
-S5 完成后展示创作者可读的摘要，说明：拆了多少章、跳过哪些、分了多少个候选集、
+S5 完成后向创作者说明：拆了多少章、跳过哪些、分了多少个候选集、
 最大的三处改编风险、以及快评里被推翻的判断。然后交给 `$short-drama-develop`——
 由它把候选变成 `项目开发/adaptation-map.jsonl` 与改编契约。
 

package/lib/drama/skills/short-drama-novel-analyze/references/adaptation-triage.md

@@ -13,8 +13,7 @@
 
 一份 `triage.md`，回答**这本书值不值得花全量拆解的成本**。
 
-它是一份可以被后面推翻的假设：S5 拿全量结果回来对照它，被推翻的判断写进
-`adaptation-value.md` 开头。
+S5 用全量结果核对这份快评，并把被推翻的判断写进 `adaptation-value.md` 开头。
 
 ## 抽样怎么取
 
@@ -25,7 +24,7 @@ python3 {技能目录}/scripts/novel_index.py sample \
   项目开发/source-analysis/_index.json --count 12
 ```
 
-抽样等距、首尾必取、结果确定。跑第二次引用的是同一批章，S5 回填对照才说得清哪条判断错了。
+默认抽样等距、首尾必取、结果确定，S5 可据此回填对照；自定 `--count 1` 时只取首章。
 
 默认 12 章。书特别长或框架复杂时调大 `--count`，调大要写进快评。抽到的章正文极少
 （索引里 `char_count` 很小）时往后顺延一章并记录——那多半是卷首页，不是内容。
@@ -55,7 +54,7 @@ python3 {技能目录}/scripts/novel_index.py sample \
 | `needs_carrier` | 功能成立，但当前载体是文字专属 |
 | `prose_only` | 功能依赖读者与叙述者的关系，屏幕上无法兑现 |
 
-写出三类各占抽样里的多少章。这是快评里唯一给数字的一段，其余用文字判断。
+写出三类各占抽样里的多少章，分母统一为实际阅读的抽样章数。
 `prose_only` 过半时直接说明：全量拆解大概率只会把同一个结论算得更精确。
 
 ### 3. 开篇替换点

package/lib/drama/skills/short-drama-novel-analyze/references/adaptation-value.md

@@ -13,8 +13,7 @@
 
 ## 这一步在回答什么
 
-前面几步产出的是「这本书是怎么运转的」。这一步回答的是**「这本书里有多少东西能在竖屏
-短剧里成立」**——这是拆书和改编分析的分水岭，也是本技能存在的理由。
+本阶段根据前面的功能提取，判断哪些剧情单元能直接用于竖屏短剧，哪些需要换载体，哪些应舍弃。
 
 判定对象是**剧情单元**，不是章，也不是情节点。判定的原始依据是 S2 每章写下的
 [载体记录](chapter-extraction.md#载体记录)：通道栏走可见行动或对白的，多半能直接成立；
@@ -30,8 +29,8 @@
 | `needs_carrier` | 功能成立，但当前载体是文字专属 | 必须写出新载体，否则降级 |
 | `prose_only` | 功能依赖读者与叙述者的关系，屏幕上无法兑现 | 明说放弃了什么 |
 
-`prose_only` 的典型：长段内心权衡、叙述性诡计（读者被叙述视角欺骗，而镜头做不到同样的
-隐瞒）、靠信息密度堆出的爽感、以及需要读者记住三十章前一个细节才成立的回扣。
+长段内心权衡、叙述性诡计、信息密度带来的爽感或远距离回扣，都需要先判断能否保住其功能。
+能用行动、对白、物证或信息释放顺序承载时归 `needs_carrier`；功能确实依赖读者与叙述者的关系、且找不到可行载体时才归 `prose_only`。
 
 **不要把 `prose_only` 悄悄改写成 `needs_carrier`**。 承认放弃比假装能拍便宜得多——
 假装的代价会在分镜阶段才暴露，那时整条链都已经建在上面。
@@ -45,8 +44,7 @@
 - **保住了什么**：功能清单，逐项对上；
 - **改变或失去了什么**：不写「无」。总有东西变了，写不出来说明还没想清楚。
 
-替换的检验标准只有一条：**观众不需要旁白就能知道发生了什么**。需要旁白解释的替换，
-是把文字问题搬到了画面上，不是解决。
+替换后核对观众能否通过新载体感知原功能。旁白可以提供画外信息，但不能代替本应可见的行动、关系变化或兑现。
 
 ## 制作负担
 
@@ -111,10 +109,7 @@
 全量结论若是「多数单元需要换载体」，就是印证；若方向相反，写清是抽样偏了还是
 全书后段变了。其余五段仍逐条对上。
 
-抽样结论被证伪不是失误，是抽样这一步在起作用。写出来才有两个用处：创作者知道
-「当时那个建议是基于什么」，下一本书的快评知道该往哪个方向修正。
-
-全部命中时也写一句，别留空——一份从不出错的快评，多半是没有被认真对照过。
+快评全部得到印证时也写明对照结果。
 
 ## 交给 develop 之前
 

package/lib/drama/skills/short-drama-novel-analyze/references/aggregation-and-entities.md

@@ -11,13 +11,11 @@
 - [人物归并](#人物归并)
 - [设定归纳](#设定归纳)
 
-聚合只读 S2 的逐章提取，**不回头重读原文**。原文在 S2 已经被读过一次；再读一次得到的
-不是补充，是第二份互相矛盾的事实。需要核对某条硬事实时回查具体那一条白描，
-而不是重新通读。
+聚合以 S2 的逐章提取为输入。核对硬事实时先回查对应白描，证据不足再按定位回读原文片段，不重新通读全书。
 
 ## 先识别故事框架
 
-框架决定按什么切单元。先判框架再切，能省掉一整轮返工。
+先识别故事框架，再按相应的目标与冲突切分剧情单元。
 
 | 框架 | 特征 | 切单元的依据 | 改编提示 |
 |---|---|---|---|
@@ -70,7 +68,7 @@
 |---|---|---|---|
 | 归属置信 | ≥ 0.85 | 有明确归属的情节点 / 单元内情节点总数 | 低于线的单元标「待复核」，不删 |
 | 覆盖率 | 85%–95% | 已归类情节点 / 总情节点数 | < 85% 走散落兜底；> 95% 复核是否过度归并 |
-| 重叠率 | ≤ 35% | 跨单元共享的情节点 / 总情节点数 | > 35% 说明两个单元其实是一个，考虑合并 |
+| 重叠率 | ≤ 35% | 跨单元共享的情节点 / 总情节点数 | > 35% 复核是多线交叉还是边界重叠，再判断是否合并 |
 
 「有明确归属」指这条情节点服务于本单元的戏剧目标或对抗力量，而不只是恰好落在本单元的
 章节范围内。按连续章节切分时，若把「落在范围内」当作归属，这个比值恒等于 1，指标失去
@@ -139,7 +137,7 @@
 合并错了的代价不对称——两个人被并成一个，之后每一条关于「他」的事实都可能属于另一个人，
 而这种错在文本里几乎看不出来。
 
-别名分四类，只有前两类能触发合并：
+称谓分五类，表中标“可合并”的三类仍须有同指证据：
 
 | 类型 | 定义 | 可合并 | 例 |
 |---|---|---|---|

package/lib/drama/skills/short-drama-novel-analyze/references/chapter-extraction.md

@@ -36,6 +36,9 @@
 P1 类型 | 白描 | 涉及：称谓、物件、地点 | 功能：这一步改变了什么
 ```
 
+`P<n>` 在每章内编号；跨章引用时同时给出 `ch-<N>`，避免把不同章的同号情节点混为一条。
+文件记录原著路径及本章索引范围，每条结论附具体原文行号；情节点的定位可写在白描段中，保持四段顺序。
+
 - **`P<n>` 与类型之间是一个半角空格**，类型与 `|` 之间也是。下游按这个字面形状 grep，
   写成全角空格或不写空格，这一行就不算情节点——**这是最常见的一处格式漂移**。
 - **类型**取自：`行动`、`对话`、`信息`、`转折`、`铺垫`、`兑现`、`状态`。
@@ -50,8 +53,7 @@ P1 类型 | 白描 | 涉及：称谓、物件、地点 | 功能：这一步改
 
 ## 白描与叙事框架词
 
-白描是这条情节点的主要证据——后面每一次事实回查都落在它上面。所以它只能写
-**原文写出来的可观察事实**：不写心理断言，不写作者意图，不用叙事框架词概括。
+白描供后续阶段回查事实，只写**原文已有的可观察事实**：不补心理断言、作者意图或叙事框架概括。
 
 | 禁止 | 正确 |
 |---|---|
@@ -94,8 +96,7 @@ P1 类型 | 白描 | 涉及：称谓、物件、地点 | 功能：这一步改
 
 ## 机械自检
 
-落盘后由主线程直接跑，命中即判失败，不依赖子代理自报。这些检查存在的理由是
-下游会按同样的字面形状 grep：格式漂一个字符，聚合阶段就会静默漏掉整章。
+落盘后由主线程按下列格式检查，不依赖子代理自报。失败项修正后再发布。
 
 ```bash
 F=项目开发/source-analysis/chapters/ch-${N}-extract.md
@@ -110,15 +111,10 @@ awk '/^## 载体记录/{f=1;next} /^## /{f=0} f&&/^\|/{n++} END{print n+0}' "$F"
   本身就占 2 行——按 2 计的话，一张空表照样过闸。**这一条也必须只数「载体记录」小节内的
   表格行**：数全文的 `|` 行会把「出场人物」表算进来，同样让空载体表蒙混过关。
 - 白描段计数少于 `$P`：有情节点缺白描，或字段顺序、分隔符不对。
-- 功能段计数少于 `$P`：有情节点没回答改变了什么。注意全角冒号——半角会漏。
-  这一条只数情节点行第四段里的 `功能：`：早先的写法数的是全文任何位置的这四个字符，
-  于是正文里提一句「功能」就会让计数超过 `$P`，把一份合规的提取判成失败。
+- 功能段计数少于 `$P`：有情节点缺功能说明，或没使用全角冒号。只统计情节点第四段的 `功能：`。
 - 类型超出枚举：自造类型会让 S3 的归类整段落空。
-- 载体表行数少于 2：表头加至少一行数据。只核对表头存在，是数不出「表里一条记录都
-  没有」的——而 S5 判定 `needs_carrier` 要的正是那些数据行。
 
-文件名由 S2 的覆盖率闸门按字面匹配，写歪一个字符会进 `unmatched_files`——
-那既不算覆盖也不算缺章，改名即可，不必重跑。
+S2 覆盖率检查按文件名匹配。命名不符时，文件进入 `unmatched_files`，对应章仍列入 `missing`；先更正命名再检查，避免重复提取。
 
 ## 并发与串行
 
@@ -140,5 +136,5 @@ awk '/^## 载体记录/{f=1;next} /^## /{f=0} f&&/^\|/{n++} END{print n+0}' "$F"
 | 机械自检不过 | 带上失败项重写本章 1 次 |
 | 重试仍失败 | 标记 `⚠️ 跳过`，写入 `_progress.md` 失败记录 |
 
-单章失败不阻断管道。但**跳过的章必须出现在每一份继承它的聚合产物里**——
-一份看起来完整、实际缺了第 47 章的分析，比一份明说缺章的分析危险得多。
+单章失败时继续提取其余章，并保留失败记录；S2 结束后补齐缺章，覆盖不足时停止，不进入 S3。
+章内个别片段跳过时，逐章提取及继承该缺口的聚合产物均须说明范围。

package/lib/drama/skills/short-drama-novel-analyze/references/stage-contract.md

@@ -7,12 +7,9 @@
 - [材料授权与只读转化](#材料授权与只读转化)
 - [本阶段规则](#本阶段规则)
 
-本文件是本技能的自包含契约：预检、所有权、材料边界与规则表都在这里，
-不需要读取其他技能的文件。
-
 ## 独立运行与项目集成
 
-本技能可以单独安装并运行；下面几条说明项目工具存在时怎样集成。
+本技能可独立运行；项目工具可用时按下列方式集成。
 
 1. **读取直接输入**：只读取用户明确提供或当前任务实际需要的文件，不批量加载整个项目。
 2. **可选项目集成**：若存在 `short-drama.json` 且 core 项目工具可用，可以运行
@@ -31,8 +28,7 @@
   `adaptation-map.jsonl`（`$short-drama-develop` 拥有）；不建资产身份；不写场景、台词、
   分镜与提示词；不生成媒体；不批准自己的产物。
 
-分析层与决策层分开的理由很直接：**分析可以被推翻，契约不能**。把两者写进同一份文件，
-创作者就再也无法只推翻分析而保留已确认的改编承诺。
+分析记录证据和候选判断，改编契约记录创作者已确认的承诺。分开保存后，推翻分析不会自动撤销已确认的决定。
 
 ## 材料授权与只读转化
 
@@ -56,7 +52,7 @@
 | NVA-05 | structural_invariant | A sampled stage states its own coverage and confines every claim to the chapters it read. |
 | NVA-06 | reviewed_invariant | A function summary states what a passage does to character choice, information, power or relationship, not what happens in it. |
 | NVA-07 | reviewed_invariant | Hard facts — levels, counts, distances, who said what, which chapters a character appears in — trace back to a description line or the source; an unsupported one is written as unstated, never filled in by plausibility. |
-| NVA-08 | reviewed_invariant | Character merges preserve dramatic role, knowledge scope, relational position and causal bridge; only proper names and evidenced nicknames may merge, never descriptors or titles. |
+| NVA-08 | reviewed_invariant | Character merges preserve dramatic role, knowledge scope, relational position and causal bridge. Proper names, nicknames and name-plus-title forms may merge with evidence of shared identity; generic descriptors or titles alone never establish identity. |
 | NVA-09 | reviewed_invariant | Adaptation value distinguishes what the screen can show from what only prose can deliver, and names the new carrier for each function it keeps. |
 | NVA-10 | reviewed_invariant | Episode candidates are cut on local dramatic result and precise handoff, not on chapter count or word budget. |
 | NVA-11 | craft_default | Triage a deterministic spread of chapters across the whole book and stop for the creator before committing to a full pass. |

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

@@ -6,8 +6,8 @@ license: MIT
 
 # 确认后生产
 
-本技能只负责把已经写好的生产规格安全送到运行环境配置的 adapter。图片提示词仍归
-`$short-drama-image-prompts`，视频提示词归 `$short-drama-video-prompts`，台词与录音表归
+本技能把已经写好的生产规格送到运行环境配置的 adapter。图片提示词归
+`$short-drama-image-prompts`，视频提示词归 `$short-drama-video-prompts`，台词归
 `$short-drama-write`，声音身份归 `$short-drama-assets`。
 
 ## Quick Start
@@ -21,15 +21,20 @@ license: MIT
 在自己的工具里出图再放进项目同样成立，图片始终不进项目时走分镜的 `PLAN-...`；
 产出落在 `剧集/<EP>/制作成果/images/` 后，分镜 owner 才能把它绑成 `用途：起始帧` 的 `REF-...`。存在真实参考图时，
 还必须逐张填写 `reference_bindings` 的槽位、顺序、路径、中文名、用途以及允许/禁止控制范围；
-内置视频 adapter 把这里的 `用途` 字段读成供应商自己的 role，只接受它公布的取值
+建立 job 时按当前文档的 `用途` 选择供应商 role，写入 `reference_bindings[].role`；
+内置视频 adapter 读取这个 role，只接受已实现的取值
 （MiniMax 为 `first_frame`/`last_frame`/`reference_image`/`reference_video`/`reference_audio`，
-Seedance 为三个 `reference_*`）；带参考图却没有绑定的 job 会直接失败，不替它猜一个 role。
+Seedance 也接受这五种 role，具体组合依账号配置的型号而定）；带参考图却没有绑定的 job 会直接失败，不猜测 role。
 本地图片由内置 adapter 按 base64 data URI 直接送出，不需要自建上传服务。
 `MOTION-*` 的「参考音频」行同样逐条进 `reference_bindings`，排在图片之后、role 固定为 `reference_audio`、`character` 照抄该行的 `角色`；
 adapter profile 没有声明接受 `reference_audio` 时 `run` 在提交前失败，见
 [adapter-contract.md](references/adapter-contract.md#adapter-config)。
-条目的「输入参考图」写成 `PLAN-...` 时，那些图片在创作者自己的工具里，项目内没有文件可送：
-`prepare` 直接失败并说明先把真实文件放进项目、改写成 `REF-...`，不拿计划当输入，也不静默丢掉参考。
+需要把条目中的 `PLAN-...` 图片作为生成输入时，`prepare` 会要求先把真实文件放进项目、改写成
+`REF-...`。直接从 `分镜.md` 绘制该 SHOT 自身首帧时，选择器可跳过 PLAN 槽位，因为本次生成
+使用冻结关键帧正文，不发送创作者在项目外准备的那些图片；已有 REF 绑定仍须逐项一致。
+这项豁免要求跳过 PLAN 后剩余 REF 的顺序仍从 1 连续；否则先交分镜 owner 调整源声明顺序，
+不能只在 job 中重编号。生产接口还要求参考路径唯一：创作上同一图片可有两个用途槽位，但同路径
+双槽目前不能提交。由负责技能与创作者决定修订参考职责或等待接口支持，不在 job 中擅自合并或漏槽。
 `references` 可以省略并由绑定顺序生成，也可以作为相同顺序的显式镜像。输出放在
 `剧集/<EP>/制作成果/`；这个 job 是生产工具的临时输入，不是第六份创作文档：
 
@@ -56,12 +61,9 @@ job、prompt、参数、输出路径或直接输入任一变化，旧确认立
 当前已确认 job 是本轮唯一工作单元；运行结束后回报结果并交还控制权，不自动准备下一批或启动审查。
 
 `分镜.md` 的「输入参考图」路径只是创作阶段的可读依据与使用意图，不是生产输入快照。进入生产时，
-creator-first job 必须从 `图片提示词.md` 或 `视频提示词.md` 的对应条目建立绑定；`prepare` 展示的
+creator-first job 必须从拥有提示词的 `图片提示词.md`、`分镜.md` 或 `视频提示词.md` 对应条目建立绑定；`prepare` 展示的
 `reference_bindings`、`references` 与已确认 job 才是本次 adapter 实际读取哪些文件字节、各自允许
-影响什么的权威。非 creator 的结构化规格可不填 `source_entry`/`reference_bindings`，继续只使用显式
-`references`；但新的 image/video job 只要 `source` 指向 canonical `图片提示词.md` 或
-`视频提示词.md` 就强制使用对应 selector，不能靠省略字段降级绕过。升级前已经 prepare 并落盘的
-旧 job 仍可按原指纹读取。
+影响什么的权威。image/video job 从对应的当前创作文档建立，使用匹配的 selector，不能靠省略字段绕过。
 新生产结果不自动回填或刷新分镜；需要把它改为后续输入时，由分镜 owner 修订文档，再建立新 job
 并重新预览、确认。
 
@@ -95,15 +97,16 @@ python3 <本技能目录>/scripts/production_tool.py audit <project>
   冻结关键帧正文，加上必要参考图和明确的输出尺寸/数量；creator-first job 使用 `source_entry`
   锁定这一条。资产板走 `IMG-*`，某一镜的起始画面走 `SHOT-*`；两者不互相替代。
 - **video**：读取 `视频提示词.md` 的当前 `MOTION-*` 可复制正文，并核对 `分镜.md` 中对应镜头、
-  冻结关键帧、时长与画幅；creator-first job 使用 `source_entry` 锁定这一条。连续段选择从上一段
-  生成结果续接时，下一段 job 同时绑定上一段实际视频和从该视频取得的实际尾帧，并保留
-  `continuity_video`、`actual_tail_frame` 的不同职责；供应商 role 由目标模型 adapter 翻译。H3 的这组
-  输入统一译为 `reference_video + reference_image`，不能混成 `reference_video + first_frame`；不以
-  计划尾帧或文字描述代替真实文件。
+  冻结关键帧、时长与画幅；creator-first job 使用 `source_entry` 锁定这一条。续接方法需要上一段
+  实际视频和从该视频取得的实际尾帧，分别承担动作/声音连续与新段可见起点；H3 的供应商组合为
+  `reference_video + reference_image`。当前 creator-first 来源选择器只解析图片与角色参考音频，
+  尚不能声明续接视频，因此这条内置生产路径不能提交续接段。报告接口缺口并保留已选路线，
+  不省略来源选择器、不拿计划尾帧冒充真实输入，也不擅自改为独立文生视频。
 - **tts**：从 `剧本.md` 读取原句与表演要求，声音参考由用户或现有媒体明确提供。不得在生产 job
-  中改词，也不为 TTS 新建第六份创作文档。表演要求来自这句台词的括注和上下文：执行端接受自然语言语气时，
-  写成一句语气说明放在台词前（「憋屈地压低声音，咬着牙应一声：是。」），同一角色每句挂同一段参考音色；
-  只接受枚举情绪时映射到最近的一档，再用强度、音调细调。只给音色、不给语气时，短剧台词会念成播音腔。
+  中改词，也不为 TTS 新建第六份创作文档。表演要求来自这句台词的括注和上下文。外部执行端若把
+  prompt 解释为含表演指令的输入，可在台词前写一句语气说明（「憋屈地压低声音，咬着牙应一声：是。」）；
+  支持参考音色时，同一角色每句使用同一段已接受参考。内置 MiniMax Speech 把 prompt 逐字作为台词，
+  因此只放原句，以同一已选 `voice_id` 保持角色声音，再把表演要求映射到支持的情绪、语速、音量和音调参数。
 - **music**：读取 `视频提示词.md` 中创作者已确认的时间线音乐章节；主题曲使用已确认歌词，纯配乐
   不携带歌词。供应商不能精确承诺时长时，生成源音轨后仍由 `$short-drama-edit` 按文档里的混音意图完成落点、
   循环、淡入淡出和对白 ducking。
@@ -113,7 +116,7 @@ python3 <本技能目录>/scripts/production_tool.py audit <project>
 
 ## Adapter 边界
 
-adapter 配置必须在项目外，只包含 argv 命令和超时；凭据由 adapter 自己从进程环境或系统凭据
+adapter 配置必须在项目外，包含 argv 命令、超时和可选的 `reference_roles`；凭据由 adapter 从进程环境或系统凭据
 存储读取。项目 job、确认记录、运行记录和 Dashboard 都不得保存密钥。
 
 脚本以 JSON stdin 调用 argv 数组，不使用 shell，不拼接命令。adapter 返回本地临时文件；工具只
@@ -124,42 +127,40 @@ adapter 配置必须在项目外，只包含 argv 命令和超时；凭据由 ad
 引用语义说明（中文名、用途、允许控制与不得控制范围）；不会把槽位名误当成要渲染进画面的文字。
 外部 adapter 也必须保留这组语义或明确拒绝，不能只上传文件而静默丢失控制边界。
 
-本技能可选提供四个 stdlib adapter，均通过项目外 adapter config 选择，凭据只从运行环境读取：
+本技能提供五个可选的 stdlib adapter，均通过项目外 adapter config 选择，凭据只从运行环境读取：
 
 - [Seedance](references/providers/seedance.md)：模型/Endpoint ID 必须由账号显式配置；compiler 支持
-  官方图片、视频和音频参考 role，内置 runtime 未配置可信上传时仍拒绝本地参考文件。
+  图片、视频和音频参考 role，本地参考文件由内置 runtime 编码为 data URI 发送。
 - [GPT Image 2](references/providers/gpt-image-2.md)：无参考图走 generation，有参考图走 edit；
   固定高保真引用并校验尺寸、格式与透明背景限制。
 - [MiniMax Music](references/providers/minimax-music.md)：使用 `music-3.0` 与 hex 结果，区分主题曲
   和纯配乐，不伪造时长请求字段。
 - [MiniMax 语音](references/providers/minimax-speech.md)：`tts` 模态；模型与 `voice_id` 都必须
-  由账号与文档显式给出，不内置音色清单。只从预置音色合成，不做声音克隆——克隆是授权问题，
-  创作者授权的参考录音按普通创作者输入走 `输入/`。
+  由账号与文档显式给出，不内置音色清单。只从预置音色合成，不做声音克隆；创作者授权的参考录音
+  按普通创作者输入放在 `输入/`，不能据此声称本适配器会读取或克隆它。
 - [MiniMax H3 视频](references/providers/minimax-h3-video.md)：模型 ID、分辨率集合与时长区间必须
-  由账号显式配置；提示词进 `content` 的 text 项，参考图按显式 role 绑定，本地参考在没有可信上传时
-  fail closed。该模型与画面同一次生成声音，写法影响见视频提示词技能的目标模型能力档案。
+  由账号显式配置；提示词进 `content` 的 text 项，本地参考按显式 role 绑定并编码为 data URI。
+  该模型与画面同一次生成声音，写法影响见 `$short-drama-video-prompts` 的目标模型能力档案。
 
-这些 adapter 是已验证请求契约，不是账号可用性或生成质量保证；正式生产仍必须通过上面的本次
-确认闸门，并由审查 Skill 判断产物质量。
+这些 adapter 实现本文列出的请求契约；账号可用性需由部署方核实，生成质量需另行观察和审查。
+正式生产仍须经过本次预览后的明确确认。
 
 仓库自带 `fixture_adapter.py` 只用于离线测试，不代表真实生成质量或默认生产 adapter。
 
 ## 中断不等于要重跑
 
-视频任务在**提交那一刻**就已经计费，不是在拿到结果时。提交之后的一切——轮询几分钟、下载——
-都可能被进程被杀、断网、机器休眠打断。内置 adapter 因此在拿到供应商任务 ID 的第一时间就把它
-写进 `handle_path`（早于第一次轮询），这个路径不随本次尝试一起删除。
+异步视频任务提交后就可能产生费用；轮询和下载中断不代表供应商没有执行。内置 adapter 在拿到
+供应商任务 ID 后、第一次轮询前将其写进 `handle_path`，这个路径在本次尝试结束后保留。
 
-于是中断之后有三条确定的动作，不必再花一次钱：
+中断后按以下顺序恢复：
 
 1. `audit` 会把带着任务 ID 的未完成尝试报成 `orphaned_provider_job`，
    `action` 是 `collect_before_retry`；
 2. `collect` 用那个 ID 取回结果并把这次尝试标成成功；
-3. 只有在 `collect` 也确认那边确实失败之后，才走重新确认与重投的老路。
+3. 只有确认原任务已终态失败、无需继续取回时，才为重投重新预览和确认；暂时无法轮询或下载仍应先排查取回路径。
 
-**不要在 `audit` 报出 `orphaned_provider_job` 时直接重投**——那是在为同一个镜头付第二次钱。
-`collect` 不走确认闸门是有意的：闸门防的是意外花钱，而 collect 不花钱；
-如果它也要求重新确认，那么中断之后最省事的路径就变成再付一次，正好是闸门要防的事。
+`audit` 报出 `orphaned_provider_job` 时先 collect。它只轮询和下载既有任务，不提交新生成请求，
+因此不消费新的生产确认；重投仍需重新确认。
 
 ## 结果与复核
 
@@ -167,12 +168,12 @@ adapter 配置必须在项目外，只包含 argv 命令和超时；凭据由 ad
 多任务或重试后先运行 `audit`：终态失败按 `retryable` 路由，重试仍须新的明确确认；输出缺失或
 文件的哈希或大小不再等于运行记录时，先复核当前字节或重新生产。`repeated_content` 只是成本与诊断信号，
 不能自动判定同文重试合理或不合理；`running_attempt` 是未决运营状态，audit 必须返回 attention。
-失败按三路走。超时、限流、服务端错误这类技术失败可做有上限重试。失败信息点名了被拒的是哪
-一项输入——提示词文本、参考图或音频——就先改那一项再投：文本被拒改写那一句，把「一拳砸在
-对方脸上，血顺着下巴滴」换成「一拳挥空，对方侧身避开，桌上的杯子被带倒」；参考图被拒换一张
-构图与角色一致、画面本身合规的图；音频被拒重录那句台词。改动写进新的 job 重新 prepare，让创
-作者在预览里看到改的是哪一项再确认；原样重投的那次确认不产生修复，只产生一笔费用。重复内容
-缺陷回到对应 prompt/spec owner。
+技术失败先排除仍可 collect 的已提交任务，再按 `retryable` 决定是否建议有上限的重投，每次重投仍须新确认。
+失败证据若能定位被拒的提示词、参考图或音频，就把证据交给对应负责技能；证据不足时先核实，
+不猜测被拒原因。生产技能不得把「一拳砸在对方脸上，血顺着下巴滴」擅自换成
+「一拳挥空，对方侧身避开，桌上的杯子被带倒」：这已改变来源动作。文本、参考图或录音的修改
+由负责技能完成并交创作者接受，再从更新后的文档建立 job，重新 prepare、展示变化并确认。
+重复内容缺陷同样回到对应 prompt/spec 负责技能。
 生产结束后不自动进入剪辑。素材要装配成成片时由用户点名 `$short-drama-edit`；它只取舍已有帧，
 不回头改本阶段的 job，也不生成新素材。
 如需质量复核，报告可把已有结果另行交给 `$short-drama-review`；不要在生产调用中自动启动复核。

package/lib/drama/skills/short-drama-produce/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
   display_name: "短剧生产"
-  short_description: "确认后安全执行图片、视频和语音生产任务，并保留可审计运行记录"
+  short_description: "预览并确认后执行图片、视频、语音和音乐生产任务，保留运行记录"
   default_prompt: "Use $short-drama-produce to preview a bounded media job, request explicit confirmation, then execute it safely."

package/lib/drama/skills/short-drama-produce/references/adapter-contract.md

@@ -1,5 +1,10 @@
 # Adapter Contract
 
+The bundled provider compilers accept video-reference roles, but the current creator-first Markdown
+source selector declares only image references and character voice references. It cannot bind a previous
+video for continuation. Keep that route unsubmitted until the source interface supports both actual
+video and tail-frame inputs; do not omit the source selector to bypass this boundary.
+
 ## Job file
 
 ```json
@@ -37,12 +42,12 @@
   canonical `剧集|episodes/<EP>/` creator document, matched to that document:
   `图片提示词.md` takes `IMG-*` (image), `视频提示词.md` takes `MOTION-*` (video),
   and `分镜.md` takes `SHOT-*` (image, whose prompt is the shot's
-  `### 冻结关键帧提示词` body rather than `### 可复制提示词`). A new image/video job pointing to either canonical filename must
+  `### 冻结关键帧提示词` body rather than `### 可复制提示词`). A new image/video job using one of these canonical sources must
   provide the matching selector; an arbitrary Markdown file cannot impersonate a
   creator source. `prepare` selects that section and requires `prompt` to exactly
   equal its copyable prompt after Markdown quote markers are removed.
 - `reference_bindings`: zero to sixteen ordered semantic bindings. Every entry has
-  exactly `slot_id`, contiguous `order`, project-relative `path`, Chinese `label`,
+  `slot_id`, contiguous `order`, project-relative `path`, Chinese `label`,
   non-empty `role`, and non-empty `may_control` / `must_not_control` lists. When
   `source_entry` is present, these fields must exactly match that entry's
   `参考` (IMG) or `输入参考图` (SHOT/MOTION) declaration (except `role`, which is
@@ -54,9 +59,9 @@
   the creator document, not this schema, is the authority on. This schema keeps
   `role` free-form because an external adapter names its own inputs, but the
   bundled video adapters read it as the provider's own role and accept only
-  their published vocabulary: `first_frame`, `last_frame`, `reference_image`,
-  `reference_video`, `reference_audio` for MiniMax, and the three `reference_*`
-  values for Seedance. A video job carrying references without bindings fails
+  their implemented vocabulary: `first_frame`, `last_frame`, `reference_image`,
+  `reference_video`, and `reference_audio` for both MiniMax and Seedance.
+  Supported combinations still depend on the configured model. A video job carrying references without bindings fails
   closed there rather than having a role guessed for it.
   A `MOTION-*` entry's `参考音频` line binds after the pictures: its slots follow
   the `输入参考图` bindings in audio `顺序`, continuing the job's `order`, each with
@@ -64,6 +69,17 @@
   slots may use that role. Leaving a declared voice or its character out, or swapping
   characters, fails `prepare`. Adapters must preserve this character binding; bundled
   compilers derive the voice label from `character`, not the free-form asset `label`.
+  For a job rendering a SHOT's own start frame, `prepare` may omit the creator-supplied
+  `PLAN-...` slots because those external pictures are not this job's inputs;
+  the declared real `REF-...` files must still match, and their remaining order must be
+  contiguous from 1. If skipping PLAN leaves gaps, the storyboard owner first revises
+  the source declaration; renumbering the job alone fails source matching.
+  Binding paths must also be unique. Two creative slots may describe different uses of
+  one picture, but this interface cannot submit both with the same path. Have the owning
+  skill and creator decide whether to revise the reference duties or wait for interface
+  support; do not silently merge or omit slots in the job.
+  A job that needs to send the PLAN
+  pictures instead must first bind actual project files as REF slots.
 - `references`: zero to sixteen current project files actually sent to production.
   It may be omitted when `reference_bindings` is present, in which case the paths
   are derived in binding order. If both are present, they must match exactly.
@@ -79,11 +95,7 @@
 
 `prepare` records internal digests of source/reference bytes and returns the exact confirmation phrase. Callers never
 calculate those digests. A changed input requires prepare and confirmation again.
-Jobs already prepared and stored before this contract remain readable under their
-original fingerprint. New non-creator structured jobs remain valid without
-`source_entry` and `reference_bindings`; they still receive the existing
-path/digest/confirmation checks. A `music` job may continue to use the timeline
-music section of canonical `视频提示词.md` without pretending that section is a
+A `music` job uses the timeline music section of canonical `视频提示词.md` without pretending that section is a
 `MOTION-*` entry; other new image/video jobs using canonical creator paths must use
 their matching selector.
 
@@ -106,10 +118,10 @@ Keep this file outside the project:
 let the adapter read its environment or operating-system credential store.
 
 A profile may add `"reference_roles": [...]`, the roles its configured model accepts. When present,
-`run` refuses any binding whose role is not listed. A `reference_audio` binding always needs it:
-a model without an audio input can drop the voice without an error. Either way `run` stops before
-the confirmation is spent or the adapter starts. List `reference_audio` only for a model you know
-accepts reference audio.
+`run` refuses any binding whose role is not listed. A `reference_audio` binding always requires
+that declaration, so an unsupported model cannot silently drop a voice. A role rejection happens
+before confirmation is consumed or the adapter starts. List `reference_audio` only for a model
+known to accept reference audio.
 
 ## Capability sources
 
@@ -123,21 +135,22 @@ The adapter receives one UTF-8 JSON document as raw stdin bytes. Read the
 binary stream (for example `json.load(sys.stdin.buffer)`) rather than relying
 on the machine locale. The document contains the confirmed job plus:
 
-- `run_id`: unique attempt ID;
-- `project_root`: local absolute path to a private, run-scoped snapshot containing
+- `run_id`: the original attempt's unique ID, also reused when collecting that attempt;
+- `project_root`: on a run call, the local absolute path to a private, run-scoped snapshot containing
   the exact confirmed `source` and `references`. It is not the live creator
   project and is deleted after the attempt.
 - `output_root`: empty private, run-scoped staging directory owned by the
   production tool. Every adapter output source must be a direct regular-file
   child of this directory. The whole directory is deleted after success or
   failure.
-- `handle_path`: absolute path where the adapter records the provider's task id
+- `handle_path`: on a run call, the absolute path where the adapter records the provider's task id
   **as soon as it has one, before it starts polling** — write
   `{"provider_job_id": "<id>"}`, atomically. Unlike `output_root` this path
   survives the attempt.
 - `collect_provider_job_id`: present only on a collect call. When it is set the
   adapter must **not submit anything**; it polls and downloads that existing
-  task and returns its outputs as usual.
+  task and returns its outputs as usual. A collect call has no input snapshot or
+  `project_root`; it must not reopen the source or reference files.
 
 ## Recovering a submitted task
 

package/lib/drama/skills/short-drama-produce/references/providers/gpt-image-2.md

@@ -9,7 +9,7 @@ Adapter command:
 Required environment: `OPENAI_API_KEY`. `OPENAI_BASE_URL` optionally overrides the default
 `https://api.openai.com/v1` and must remain HTTPS.
 
-The job must have modality `image` and exactly one output. With no references, the adapter sends JSON to
+The job must use modality `image` and have exactly one output. With no references, the adapter sends JSON to
 `POST /images/generations`. With one to sixteen references, it sends an `image[]` multipart edit to
 `POST /images/edits`. The model is always `gpt-image-2`, `n` is always one, and the single returned `b64_json` image is
 written to a private temporary file.