@lemoncat7/dsh-partner 2.4.2 → 2.7.0

package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/SKILL.md

@@ -0,0 +1,245 @@
+---
+name: short-drama-novel-analyze
+description: 把长篇小说、连载网文或多集散稿拆成可追溯的原著分析：章节索引、改编价值快评、逐章功能提取、剧情单元与节奏聚合、人物与设定归并，最后给出改编价值判定与分集候选，交给 $short-drama-develop 立契约。用户说“导入这本小说”“拆这本书”“分析原著”“这本书能不能改短剧”“先看看值不值得拆”“把长篇拆成分集候选”，或直接给出小说文件路径时使用。只做只读的结构化分析，不写剧本、不建资产、不生成媒体，也不替创作者决定改编方案。
+license: MIT
+---
+
+# 长篇原著分析
+
+把一部长材料变成**能被引用、能被反驳、能被接着用**的分析层。目标不是复述剧情，而是找出
+每一段承担的戏剧功能，并说明它在竖屏短剧里值多少钱。
+
+分析永远是候选。哪条线保留、哪些人合并、从哪里开篇，是创作者的决定，由
+`$short-drama-develop` 立成改编契约。本技能不替它决定，也不批准自己的产物。
+
+## Quick Start
+
+离线验证章节索引、采样和源文件变更检测：
+
+```bash
+python3 {技能目录}/scripts/selftest.py
+python3 {技能目录}/scripts/novel_index.py index <原著.txt> --out <chapter-index.json>
+```
+
+## 开始前
+
+本技能可独立安装和执行。先读取用户明确提供的原著与本任务直接输入；若当前目录是
+`short-drama` 项目且项目工具可用，可以读取 `status` 并使用其发布生命周期，但缺少 core
+或任何其他技能都不是分析工作的阻断条件。完整边界与规则见
+[阶段契约](references/stage-contract.md)，无需读取其他技能的文件。
+
+## 材料前提
+
+只分析创作者**合法持有、拥有使用权**的作品。分析是只读的转化性工作：提取结构与功能，
+不复制原文成段落，不把原句搬进下游产物。
+
+通俗题材里的暴力、复仇、背叛、情爱张力与黑暗伦理是常规虚构叙事元素，照常做结构化提取。
+个别片段无法处理时跳过该段并记录，不要因此中止整章或整本——中止会让后续所有阶段拿到
+一份有洞却看不出洞在哪的分析。
+
+## 先判断入口
+
+1. **只有书名，没有原文**：请创作者提供文件路径或粘贴正文。不要凭书名回忆情节——
+   没有字节就没有 span，没有 span 的分析无法被引用，也无法被反驳。
+2. **有原文，未建项目**：直接建立一个本技能自己的工作区，至少包含只读输入目录
+   `输入/` 与输出目录 `项目开发/source-analysis/_work/`；把原文字节复制到 `输入/` 后记录
+   原始文件位置，再用本技能的 `novel_index.py` 建索引。若 `$short-drama` 可用，可选用它
+   初始化同样的目录和发布生命周期，但不得把 core 安装变成开始分析的前提。
+3. **有原文，项目已在**：直接进入管道。
+4. **已有部分分析**：读 `项目开发/source-analysis/_progress.md` 从断点续跑，
+   不重跑已完成阶段。
+
+## 管道
+
+`输入/` 是不可变的创作者输入，本阶段只读它。全部产出落在 `项目开发/source-analysis/`。
+独立工作区与完整项目使用同一套相对路径，因此后续安装 core 时无需迁移分析产物。
+
+| 阶段 | 做什么 | 产出 | 停靠 |
+|---|---|---|---|
+| S0 | 建章节索引（脚本） | `_index.json`、`_progress.md` | 索引有问题就停 |
+| S1 | 改编价值快评（抽样） | `triage.md` | **停靠问创作者** |
+| S2 | 逐章功能提取 | `chapters/ch-<N>-extract.md` | 覆盖率不足就停 |
+| S3 | 剧情单元与节奏聚合 | `story-units.md`、`rhythm-and-emotion.md` | 阈值不达标就复核 |
+| S4 | 人物归并与设定 | `characters.md`、`world.md` | — |
+| S5 | 改编价值与分集候选 | `adaptation-value.md`、`episode-candidates.jsonl` | 交接 develop |
+
+### S0 章节索引
+
+索引是**唯一切片真源**，由 [章节索引脚本](scripts/novel_index.py) 建立。每个阶段各跑
+一次正则，就会切出互相对不上的章节，第 47 章按一种边界分析、按另一种边界聚合，
+而且没有人会发现。
+
+```bash
+python3 {技能目录}/scripts/novel_index.py index 输入/{原文文件} \
+  --out 项目开发/source-analysis/_work/_index.next.json
+python3 {技能目录}/scripts/novel_index.py verify \
+  项目开发/source-analysis/_work/_index.next.json 输入/{原文文件}
+# 项目工具可用时可选：
+python3 {core 技能目录}/scripts/project_tool.py publish {项目根} \
+  --owner short-drama-novel-analyze --artifact-id source-analysis:index \
+  --output 项目开发/source-analysis/_index.json=项目开发/source-analysis/_work/_index.next.json \
+  --input 输入/{原文文件}
+```
+
+脚本识别阿拉伯数字与中文数字章号（含 千 / 两，覆盖千章以上连载），**只认一种编号单位**
+（章/回/节里出现最多的那个，其余记进 `ignored_heading_units`），只把**短的独立行**当标题
+（以章号开头的正文段落记进 `long_heading_lines_skipped`），剔除开头的目录块，
+按卷分段校验编号。它**不做编辑判断**——哪章重要、
+讲了什么，是后面阶段的事。
+
+`problems` 非空就停下报告，不要带着错表进 S1。常见四种：章号跳号（缺章或抓错标题）、
+同卷内重号、正文极少的章（多半抓到了目录残留或卷首页）、无法解析的章号。
+另外确认三个计数：`chapter_unit` 与 `ignored_heading_units`——一本用 `第N章` 分章、
+用 `第N节` 分小节的书应当看到 `chapter_unit: 章` 且 `节` 被记入忽略计数，反过来说明分章单位
+判断错了；`long_heading_lines_skipped` 明显偏大时，多半是这本书的章节标题确实很长，
+需要与创作者确认后手写边界。
+
+原文本身没有章节标题时索引会返回空表，此时与创作者确认按什么切分，把边界写进
+`_work/_index.next.json`，通过 `verify` 后再按上面的公开生命周期发布——手写的行也要带齐
+`sequence` / `line_start` / `line_end`，`verify` 会逐行检查并报出缺字段的行。
+
+改了原文必须重建索引，不能沿用旧 span。`verify` 核对编号、顺序与行号覆盖，所以插行删行会被报出来；
+但同行数的原地改写不会——那一步靠改原文的人自己重建，套件不比对字节。
+
+```bash
+python3 {技能目录}/scripts/novel_index.py verify \
+  项目开发/source-analysis/_index.json 输入/{原文文件}
+```
+
+### S1 改编价值快评
+
+回答**这本书值不值得花全量拆解的成本**。判据是全书的改编密度——`screen_ready` 单元占多少、
+`prose_only` 占多少、制作负担压在哪几段——所以快评横跨整本书，用脚本抽样：
+
+```bash
+python3 {技能目录}/scripts/novel_index.py sample \
+  项目开发/source-analysis/_index.json --count 12
+```
+
+抽样确定、可复现、首尾必取，跑第二次引用的是同一批章。按
+[改编价值快评](references/adaptation-triage.md) 写 `triage.md`，覆盖六件事：
+故事框架、三类判定比例、开篇替换点、制作负担量级、最大的三处改编风险、分集候选量级。
+第一行写覆盖率（脚本返回的 `coverage_ratio`），所有结论限于抽样范围。
+
+**这里停靠问创作者**：给出快评与全量拆解的预计耗时（按章数粗估），问是否继续。
+创作者一开始就明确说「一次跑完」时仍写 `triage.md`，但不停下等待——它是 S5 要回填
+对照的第一版假设。
+
+停靠时把 `_progress.md` 的状态写成 `paused_after_triage`，断点写「下一步：S2 逐章提取」。
+
+S1–S5 的 Agent 创作产物同样先写到 `source-analysis/_work/`，完成本阶段机械检查后再发布到
+上表中的正式路径。项目工具可用时用 `project_tool.py publish` 和稳定 artifact-id；独立运行时
+原子替换正式文件。不要用半成品覆盖 `_index.json`、`_progress.md`、`chapters/*.md` 或聚合产物。
+`_work/` 是候选工作区，不是权威分析层，也不进入交付包。
+
+**并发子代理写 `_work/`，主线程发布到正式路径**。子代理只落
+`_work/chapters/ch-<N>-extract.md`，主线程跑完机械自检后再发布到 `chapters/`。
+覆盖率闸门按正式路径 `chapters/` 匹配文件名——发布之前跑，每一章都会进
+`unmatched_files`，那不是缺陷，只是跑早了。
+
+`_progress.md` 每个阶段都会重写，而发布要求一个路径只有一个 owner，所以它用一个固定
+artifact-id：`source-analysis:progress`，owner 是 `short-drama-novel-analyze`，
+S0–S5 每次停靠都用同一个 id 重新发布。
+
+### S2 逐章功能提取
+
+按 [章节提取](references/chapter-extraction.md) 处理每一章。能并发子代理就分批并发
+（每批 5–8 章，等一批落盘再发下一批），不支持就串行——两条路径的写法要求和自检是同一份，
+只是速度不同。
+
+每章提取完落到 `chapters/ch-<N>-extract.md`，`<N>` 是索引里的 `sequence`，不是原文章号
+（多卷书的原文章号会重复，sequence 不会）。全部落盘后跑覆盖率：
+
+```bash
+python3 {技能目录}/scripts/novel_index.py coverage \
+  项目开发/source-analysis/_index.json 项目开发/source-analysis/chapters
+```
+
+`missing` 非空就补跑缺的章；`unmatched_files` 非空说明有文件名写歪了——它既不算覆盖，
+也不会被当成缺章，必须改名而不是重跑。**不要在覆盖率不足时进入 S3**——聚合会照样产出
+一份读起来完整的结果，而缺掉的章不会在任何地方留下痕迹。
+
+单章连续失败两次就标记跳过，写进 `_progress.md` 的失败记录，并在后续每一份聚合产物里
+注明该章缺失。失败可以接受，失败被藏起来不行。
+
+### S3 剧情单元与节奏
+
+从逐章提取聚合，不回头重读原文——原文已经在 S2 被读过一次，再读一次只会得到第二份互相
+矛盾的事实。按 [聚合与实体](references/aggregation-and-entities.md) 先识别故事框架
+（框架决定按什么切单元），再产出：
+
+- `story-units.md`：把情节点归成有始有终的单元，每个单元记录进入状态、冲突、代价与出去状态；
+- `rhythm-and-emotion.md`：关键信息如何逐章推进、情绪触动点的铺垫→释放→余波、
+  跨章伏笔与兑现。
+
+聚合完成后跑同一文件里的三条阈值自检（归属置信、覆盖率、重叠率）与散落情节兜底。
+阈值不是评分，是**边界模糊的信号**：重叠率过高说明两个单元其实是一个。
+
+### S4 人物与设定
+
+按 [聚合与实体](references/aggregation-and-entities.md) 归并人物（跨章去重、别名归一、
+分级），并从提及数据归纳世界规则、力量体系与势力。别名只有专名与有同指证据的绰号能合并，
+描述性称谓与头衔**永远不触发合并**。
+
+**人物归并是候选，不是资产**。 这里的人物条目带 `unresolved` 与来源引用，
+交给 `$short-drama-develop` 定改编决定、`$short-drama-write` 写进剧本之后，
+才由 `$short-drama-assets` 从已接受剧本建立真正的资产身份。绕过这条链直接建资产，
+等于让原著的人物表冒充剧本的出现证据。
+
+### S5 改编价值与分集候选
+
+这是本技能与通用拆书的分水岭。按 [改编价值](references/adaptation-value.md) 产出：
+
+- `adaptation-value.md`：哪些单元在竖屏短剧里能直接成立、哪些要换载体、哪些是纯文字快感
+  （内心戏、叙述性诡计、长铺垫）在画面上无法兑现；制作负担落在哪里。
+- `episode-candidates.jsonl`：按**局部戏剧结果与精确交接**切出的候选集，不按章号或字数
+  平均切。每条带来源 span、承担的功能、以及未决项。
+
+同时**回填快评**：S1 的哪几条判断被全量结果推翻了，写进 `adaptation-value.md` 的开头。
+一个抽样结论被证伪，比它被悄悄忘掉有用得多——下一本书的快评会因此更准。
+
+样例见 [分集候选样例](assets/episode-candidate.example.jsonl)。
+
+### 交接
+
+S5 完成后展示创作者可读的摘要，说明：拆了多少章、跳过哪些、分了多少个候选集、
+最大的三处改编风险、以及快评里被推翻的判断。然后交给 `$short-drama-develop`——
+由它把候选变成 `项目开发/adaptation-map.jsonl` 与改编契约。
+
+**本技能不写 `adaptation-map.jsonl`**，那是 develop 的产物。需要质量结论时交给独立的
+`$short-drama-review`（范围 `source_analysis`）。
+
+## 规则分级
+
+- **`structural_invariant`**：索引与 span 的可证明性、引用完整性、覆盖率。可由脚本阻断。
+- **`reviewed_invariant`**：功能提取是否忠于原文、归并是否保住戏剧作用等语义义务。
+- **`craft_default`**：通常有帮助的做法；创作者说明理由后可覆盖。
+- **`taste_option`**：从哪里开篇、保留哪条线等选择；不得单独阻断。
+
+不要用固定的章数配方、情节点数量或篇幅比例替代因果判断。
+
+## 产物与边界
+
+本技能只拥有 `项目开发/source-analysis/` 下的文件：`_index.json`、`_progress.md`、
+`chapters/*.md`、`triage.md`、`story-units.md`、`rhythm-and-emotion.md`、
+`characters.md`、`world.md`、`adaptation-value.md`、`episode-candidates.jsonl`。
+
+它不改写 `输入/`，不写 `项目开发/` 下其他技能的产物，不建资产、不写场景与台词、
+不写提示词、不生成媒体，也不签发终审结论。
+
+**不把原文成段复制进分析**。记录 locator、span 与去引用的功能摘要；需要证据时引用
+最短的必要片段。交付包不得把原始材料带出边界。
+
+## 语言
+
+分析产物是创作者读的：项目内跟随 `short-drama.json#/language`，独立运行时跟随用户使用的
+语言，不在本技能内硬编码语言。本技能不产生提示词正文，与
+`#/format/prompt_language` 无关。
+
+## 按需加载
+
+- **快评读哪些章、写哪六件事、怎么不冒充全量分析**：[改编价值快评](references/adaptation-triage.md)
+- **逐章提取写法、白描与叙事框架词的界线、机械自检、并发与串行**：[章节提取](references/chapter-extraction.md)
+- **故事框架、剧情单元、节奏情绪、人物归并、阈值与散落兜底**：[聚合与实体](references/aggregation-and-entities.md)
+- **改编价值评估、载体替换与分集候选切法**：[改编价值](references/adaptation-value.md)
+- **本阶段拥有什么、继承什么、不越权什么**：[阶段契约](references/stage-contract.md)

package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "长篇原著分析"
+  short_description: "把长篇小说拆成章节索引、剧情单元与可改编的分集候选清单"
+  default_prompt: "使用 $short-drama-novel-analyze 先给这本小说做改编价值快评，再决定要不要全量拆解。"

package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/assets/episode-candidate.example.jsonl

@@ -0,0 +1,3 @@
+{"record_type":"sources","schema_version":"1.0.0","sources":{"index":{"owner":"short-drama-novel-analyze","artifact":"项目开发/source-analysis/_index.json"},"original-source":{"owner":"creator","artifact":"输入/original-source.txt"}}}
+{"example_only":true,"destination":"项目开发/source-analysis/episode-candidates.jsonl","schema_version":"1.0.0-draft","record_type":"episode_candidate","candidate_id":"NVA-EPC-EXAMPLE-001","status":"candidate","source_ref":{"src":"original-source"},"index_ref":{"src":"index"},"story_units":["UNIT-EXAMPLE-03"],"chapter_range":{"sequence_start":14,"sequence_end":19},"screen_judgement":"needs_carrier","trope_tags":["信息差","反转打脸"],"entering_knowledge":"观众已知两人共用一份旧证据，但不知道其中一人已经改过它","promise_paid":"改动被第三方当场指出，怀疑从猜测变成具体指控","exit_pressure":"被指控者必须在下一次公开场合前决定认或不认","inherited_facts":["改动过的证据仍在对方手里","两人的合作关系尚未破裂"],"preserved_functions":["关系压力","信息不对称"],"carrier_change":{"original_carrier":"长段内心权衡","new_carrier":"第三方当众比对两份文件的可见动作","lost_or_changed":["读者原本先于角色知道改动，改编后观众与角色同时知道"]},"production_load":{"distinct_locations":2,"characters_in_frame":3,"readable_text_required":true,"notes":"证据文件的可读文字需与美术确认"},"unresolved":["第三方的立场在原文中前后不一致，待创作者裁定"],"creator_acceptance":{"status":"pending","decision_ref":null}}
+{"example_only":true,"destination":"项目开发/source-analysis/episode-candidates.jsonl","schema_version":"1.0.0-draft","record_type":"episode_candidate","candidate_id":"NVA-EPC-EXAMPLE-002","status":"candidate","source_ref":{"src":"original-source"},"index_ref":{"src":"index"},"story_units":["UNIT-EXAMPLE-04"],"chapter_range":{"sequence_start":20,"sequence_end":22},"screen_judgement":"screen_ready","trope_tags":["打脸"],"entering_knowledge":"观众已知指控成立，不知道被指控者手里还有一份未公开的记录","promise_paid":"记录被主动交出，代价是失去唯一的退路","exit_pressure":"退路没了，对手却仍未出手","inherited_facts":["记录已进入公开视野"],"preserved_functions":["代价","权力转移"],"carrier_change":null,"production_load":{"distinct_locations":1,"characters_in_frame":2,"readable_text_required":false,"notes":null},"unresolved":[],"creator_acceptance":{"status":"pending","decision_ref":null}}

package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/references/adaptation-triage.md

@@ -0,0 +1,116 @@
+# 改编价值快评
+
+## 目录
+
+- [产出什么](#产出什么)
+- [抽样怎么取](#抽样怎么取)
+- [写六件事](#写六件事)
+- [开篇替换点](#开篇替换点)
+- [结论限于抽样范围](#结论限于抽样范围)
+- [停靠与交接](#停靠与交接)
+
+## 产出什么
+
+一份 `triage.md`，回答**这本书值不值得花全量拆解的成本**。
+
+它是一份可以被后面推翻的假设：S5 拿全量结果回来对照它，被推翻的判断写进
+`adaptation-value.md` 开头。
+
+## 抽样怎么取
+
+由脚本取，不手挑：
+
+```bash
+python3 {技能目录}/scripts/novel_index.py sample \
+  项目开发/source-analysis/_index.json --count 12
+```
+
+抽样等距、首尾必取、结果确定。跑第二次引用的是同一批章，S5 回填对照才说得清哪条判断错了。
+
+默认 12 章。书特别长或框架复杂时调大 `--count`，调大要写进快评。抽到的章正文极少
+（索引里 `char_count` 很小）时往后顺延一章并记录——那多半是卷首页，不是内容。
+
+快评只判断**功能与载体**：不写完整情节点表，不写人物表，不产出 `chapters/` 下的文件。
+逐章提取的格式要求见 [章节提取](chapter-extraction.md)，这一步不套用。
+
+## 写六件事
+
+`triage.md` 固定六段，缺一段不算快评。
+
+### 1. 故事框架
+
+从 [聚合与实体](aggregation-and-entities.md) 的框架表里选一个：升级流 / 复仇线 /
+单元剧 / 多线交织 / 蜕变成长。框架决定后面按什么切单元，也决定这本书按集切的难度——
+单元剧与短剧的集结构最贴合，多线交织在竖屏里最贵。
+
+抽样判不出来时写「抽样不足以判断框架」并说明原因。
+
+### 2. 三类判定比例
+
+对抽到的每一章，判断它承担的功能属于哪一类（定义见 [改编价值](adaptation-value.md)）：
+
+| 判定 | 含义 |
+|---|---|
+| `screen_ready` | 功能由可见行动、可听对白或空间关系承担 |
+| `needs_carrier` | 功能成立，但当前载体是文字专属 |
+| `prose_only` | 功能依赖读者与叙述者的关系，屏幕上无法兑现 |
+
+写出三类各占抽样里的多少章。这是快评里唯一给数字的一段，其余用文字判断。
+`prose_only` 过半时直接说明：全量拆解大概率只会把同一个结论算得更精确。
+
+### 3. 开篇替换点
+
+见下一节。
+
+### 4. 制作负担量级
+
+抽样里出现的：最多几人同框、需要多少个不重复空间、有没有群戏 / 动作 / 特效 /
+可读文字 / 跨时间造型变化。给量级，不给预算表。
+
+按已接受的制作形态估；形态未定时按两种形态各给一句，不替创作者选。
+
+### 5. 三处最大改编风险
+
+具体到抽到的哪一章、哪个功能。写「改编难度较大」对任何一本书都成立，
+因此对这一本没有信息。
+
+### 6. 分集候选量级
+
+按抽样里的戏剧结果密度给一个量级（例如「约 20–30 集」），并写清这是从 N/M 章推出来的。
+集数由创作者与 `$short-drama-develop` 定，这里给的是量级。
+
+## 开篇替换点
+
+回答一个问题：**如果这本书改成短剧，第 1 集从哪里开始**？
+
+找**第一个可见的、有代价的、当场发生的转折**——主角第一次做出会付出代价的选择，
+且这个选择能被拍出来而不是被想出来。它通常不在第一章。写清三条：
+
+- 落在第几章（用索引的 `sequence`）；
+- 它之前的内容里，哪些是观众必须知道的，可以怎样在开场后补进去；
+- 哪些是原著读者需要、短剧观众不需要的。
+
+抽样里没有这样的转折时，写「抽样内未见可用的开篇替换点」，并列进第 5 段的风险。
+
+## 结论限于抽样范围
+
+`triage.md` 第一行写覆盖率，用脚本返回的 `coverage_ratio` 与 `total_chapters`：
+
+```markdown
+> 本快评基于抽样：读了 340 章中的 12 章（3.5%），章号见下表。结论是假设，不是结论。
+```
+
+三条：
+
+- **只用读过的章做证据**。 需要提到抽样外的内容时写「抽样未覆盖」。
+- **比例的分母是抽样章数**，在文里写出来。
+- **候选集条目是 S5 的产物**，快评给量级即可。
+
+## 停靠与交接
+
+快评写完后向创作者报告：覆盖率、六段结论、全量拆解的预计耗时（按章数粗估）、
+以及一句直给的建议（值得拆 / 不值得拆 / 拆但先砍掉某几卷）。
+
+然后停下等待。`_progress.md` 状态写 `paused_after_triage`，断点写「下一步：S2 逐章提取」。
+
+创作者一开始就说「一次跑完」时不停靠，`triage.md` 仍然要写——S5 要拿全量结果回填对照它。

package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/references/adaptation-value.md

@@ -0,0 +1,124 @@
+# 改编价值与分集候选
+
+## 目录
+
+- [这一步在回答什么](#这一步在回答什么)
+- [三类判定](#三类判定)
+- [载体替换](#载体替换)
+- [制作负担](#制作负担)
+- [桥段标签](#桥段标签)
+- [分集候选](#分集候选)
+- [回填快评](#回填快评)
+- [交给 develop 之前](#交给-develop-之前)
+
+## 这一步在回答什么
+
+前面几步产出的是「这本书是怎么运转的」。这一步回答的是**「这本书里有多少东西能在竖屏
+短剧里成立」**——这是拆书和改编分析的分水岭，也是本技能存在的理由。
+
+判定对象是**剧情单元**，不是章，也不是情节点。判定的原始依据是 S2 每章写下的
+[载体记录](chapter-extraction.md#载体记录)：通道栏走可见行动或对白的，多半能直接成立；
+走心理叙述或叙述者旁白的，需要换载体或根本换不了。
+
+## 三类判定
+
+每个单元落进且只落进一类：
+
+| 判定 | 含义 | 后续 |
+|---|---|---|
+| `screen_ready` | 功能由可见行动、可听对白或空间关系承担 | 直接进候选集 |
+| `needs_carrier` | 功能成立，但当前载体是文字专属 | 必须写出新载体，否则降级 |
+| `prose_only` | 功能依赖读者与叙述者的关系，屏幕上无法兑现 | 明说放弃了什么 |
+
+`prose_only` 的典型：长段内心权衡、叙述性诡计（读者被叙述视角欺骗，而镜头做不到同样的
+隐瞒）、靠信息密度堆出的爽感、以及需要读者记住三十章前一个细节才成立的回扣。
+
+**不要把 `prose_only` 悄悄改写成 `needs_carrier`**。 承认放弃比假装能拍便宜得多——
+假装的代价会在分镜阶段才暴露，那时整条链都已经建在上面。
+
+## 载体替换
+
+`needs_carrier` 的单元逐个写：
+
+- **原载体**：功能现在靠什么承担（抄 S2 载体记录里的通道栏）；
+- **新载体**：可见行动 / 物证 / 空间关系 / 对白策略 / 第三方反应，任选但要具体；
+- **保住了什么**：功能清单，逐项对上；
+- **改变或失去了什么**：不写「无」。总有东西变了，写不出来说明还没想清楚。
+
+替换的检验标准只有一条：**观众不需要旁白就能知道发生了什么**。需要旁白解释的替换，
+是把文字问题搬到了画面上，不是解决。
+
+## 制作负担
+
+按已接受的制作形态估，不设跨项目阈值。逐单元记：需要几个人物同框、需要哪些不重复的
+空间、有没有群戏、动作或特效、可读文字、跨时间的造型变化。
+
+这不是预算表，是**改编排序的依据**：同样是 `screen_ready`，负担低的单元先进候选集。
+
+## 桥段标签
+
+给每个单元打桥段标签，命中就标，逗号分隔。标签的用处是让 `$short-drama-develop`
+能按题材检索，也让重复的桥段一眼可见——同一个桥段在一本书里出现五次，
+改编时要么是卖点，要么是拖沓，这个判断需要先能数出来。
+
+| 题材 | 常见桥段 |
+|---|---|
+| 都市/言情 | 打脸、扮猪吃虎、马甲掉落、先婚后爱、追妻火葬场、破镜重圆、替身、契约婚姻、萌宝助攻 |
+| 玄幻/修仙 | 废柴逆袭、越级战斗、夺宝、护短打脸、绝境翻盘、机缘逆天 |
+| 历史/种田 | 先知先觉、改变历史、科举经商崛起、攒钱起家 |
+| 悬疑/无限 | 信息差、反转打脸、规则怪谈、身份揭穿、复盘解谜 |
+| 系统流 | 任务奖励、签到、面板升级、强制任务、积分兑换 |
+| 重生/穿越 | 前世复仇、改命、身份调换、双重生、未卜先知 |
+| 世情/家庭 | 极品亲戚、偏心打脸、维权反击、自我觉醒 |
+
+这是**可扩展的种子表，不是封闭枚举**。不在表内但本书确有的桥段照实写；
+凑不出标签就留空，不硬凑。
+
+## 分集候选
+
+按**局部戏剧结果与精确交接**切，不按章号、字数或平均分配。一个候选集必须能回答：
+
+1. 进入时观众已经知道什么；
+2. 本集内兑现了哪一部分承诺（不能一条都不兑现）；
+3. 出去时留下的具体决定、危险或问题是什么；
+4. 下一集必须继承哪些事实。
+
+只留钩子、不兑现任何承诺的集，观众会在第三集停——这是分集候选里最常见的错。
+
+每条候选写进 `episode-candidates.jsonl`，字段见
+[分集候选样例](../assets/episode-candidate.example.jsonl)。每条都带：来源单元与章号区间、
+承担的功能、判定类别、桥段标签、未决项、以及 `creator_acceptance: pending`。
+
+**集数不由本技能决定**。 候选可以多于、也可以少于创作者设定的集数；差多少要明说，
+由创作者与 `$short-drama-develop` 决定合并还是拆分。
+
+## 回填快评
+
+`adaptation-value.md` 开头写一段**快评对照**：S1 的 `triage.md` 里哪几条判断被全量结果
+推翻了，以及为什么。逐条对上六段：故事框架、三类判定比例、开篇替换点、制作负担量级、
+三处风险、分集量级。
+
+**其中「三类判定比例」两边的判定对象不同**：S1 抽样判的是章，S5 判的是剧情单元，
+两者之间没有换算，也不该造一个——一个单元里的章可以分属不同类别，按章数加权回推
+只会得到一个看起来精确的假数字。这一条按方向对照即可：抽样说「多数章走心理叙述」，
+全量结论若是「多数单元需要换载体」，就是印证；若方向相反，写清是抽样偏了还是
+全书后段变了。其余五段仍逐条对上。
+
+抽样结论被证伪不是失误，是抽样这一步在起作用。写出来才有两个用处：创作者知道
+「当时那个建议是基于什么」，下一本书的快评知道该往哪个方向修正。
+
+全部命中时也写一句，别留空——一份从不出错的快评，多半是没有被认真对照过。
+
+## 交给 develop 之前
+
+自检五条：
+
+- 每个 `screen_ready` / `needs_carrier` 单元都能在候选集里找到落点，或明确说明为什么没有；
+- 每条候选的功能都能回溯到某个单元、某条情节点的白描；
+- 硬事实（等级、数值、出场章、谁说的话）都能回到白描或原文，回不到的已改成「原文未明确」；
+- `prose_only`、被跳过的章与散落清单都出现在交接摘要里，不只是躺在某个文件深处；
+- 没有把本技能的判定写成结论——它们是候选，等创作者接受。
+
+交接摘要给创作者读，说清：拆了多少章、跳过哪些、多少单元分别落进三类、
+切出多少候选集、最大的三处改编风险、快评里被推翻的判断。风险要具体到单元，
+不写「改编难度较大」。

package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/references/aggregation-and-entities.md

@@ -0,0 +1,155 @@
+# 聚合与实体
+
+## 目录
+
+- [先识别故事框架](#先识别故事框架)
+- [剧情单元](#剧情单元)
+- [单元粒度](#单元粒度)
+- [阈值自检](#阈值自检)
+- [散落情节兜底](#散落情节兜底)
+- [节奏与情绪](#节奏与情绪)
+- [人物归并](#人物归并)
+- [设定归纳](#设定归纳)
+
+聚合只读 S2 的逐章提取，**不回头重读原文**。原文在 S2 已经被读过一次；再读一次得到的
+不是补充，是第二份互相矛盾的事实。需要核对某条硬事实时回查具体那一条白描，
+而不是重新通读。
+
+## 先识别故事框架
+
+框架决定按什么切单元。先判框架再切，能省掉一整轮返工。
+
+| 框架 | 特征 | 切单元的依据 | 改编提示 |
+|---|---|---|---|
+| 升级流 | 等级/境界体系清晰，按阶段推进 | 按等级阶段 | 阶段边界天然是集边界 |
+| 复仇线 | 核心矛盾明确，目标驱动 | 按复仇对象或阶段 | 每个对象一个小高潮，适配短剧 |
+| 单元剧 | 每卷独立故事，弱连续性 | 按单元 | 与短剧的集结构最贴合 |
+| 多线交织 | 多视角/多时间线 | 按线索切，交叉点单独标记 | 竖屏里最贵：观众要记住的人最多 |
+| 蜕变成长 | 主角内在变化为主线 | 按成长阶段 | 内在变化要找到外部载体才成立 |
+
+判定方法：扫全部章节概要 + 首尾各三章的提取。判不出来时写「框架不明确」并说明原因，
+不硬套——套错框架会让后面每一个单元都切在错的地方。
+
+框架识别的结论写进 `story-units.md` 开头，并与 S1 `triage.md` 里的框架判断对照：
+不一致时写清哪一个错了、为什么。
+
+## 剧情单元
+
+一个单元记录六项：
+
+| 字段 | 写什么 |
+|---|---|
+| 标题 | 15 字以内 |
+| 章节范围 | 用索引的 `sequence` 起止 |
+| 进入状态 | 单元开始时，谁知道什么、谁有什么筹码 |
+| 核心冲突 | 具体的对抗对象 + 具体的冲突事件 |
+| 代价 | 这个单元里谁付出了什么，不写「无」 |
+| 出去状态 | 单元结束时改变了什么，下一个单元必须继承哪些事实 |
+
+进入状态与出去状态必须能对接：上一个单元的出去状态就是下一个的进入状态。
+对不上说明中间漏了一个单元，或者边界切错了。
+
+## 单元粒度
+
+| 粒度 | 例子 | 问题 |
+|---|---|---|
+| 过细 | 「获得神器」（1–2 章） | 这是事件，不是单元 |
+| 过粗 | 「主角的成长之路」（1–100 章） | 这是主题，不是单元 |
+| 合适 | 「家族觉醒与传承认知」（1–6 章） | 有独立目标、冲突、角色群和完整弧线 |
+
+一个单元必须同时满足四条：有独立且可衡量的戏剧目标；有具体的对抗力量；有本单元特有的
+核心角色（可与其他单元共享部分角色）；有自己的紧张—缓和节奏。
+
+四条里缺一条，它多半是另一个单元的**阶段**，降级处理即可，不必单独建条。
+
+## 阈值自检
+
+聚合后跑三条。它们不是评分，是**边界模糊的信号**：
+
+| 指标 | 参考值 | 算法 | 不达标怎么办 |
+|---|---|---|---|
+| 归属置信 | ≥ 0.85 | 有明确归属的情节点 / 单元内情节点总数 | 低于线的单元标「待复核」，不删 |
+| 覆盖率 | 85%–95% | 已归类情节点 / 总情节点数 | < 85% 走散落兜底；> 95% 复核是否过度归并 |
+| 重叠率 | ≤ 35% | 跨单元共享的情节点 / 总情节点数 | > 35% 说明两个单元其实是一个，考虑合并 |
+
+「有明确归属」指这条情节点服务于本单元的戏剧目标或对抗力量，而不只是恰好落在本单元的
+章节范围内。按连续章节切分时，若把「落在范围内」当作归属，这个比值恒等于 1，指标失去
+意义——所以逐条判的是**它推动的是不是这个单元的那件事**，跨单元共享的情节点计入重叠率
+而不计入本单元的分子。
+
+**小体量素材的例外**：不足 30 章、单主线连续叙事的材料按时序切分时，覆盖率天然接近
+100%、散落接近 0，这是线性结构的正常结果，不是过度归并。此时复核的重点是
+「有没有把两条剧情硬并进同一个单元」，不是把数字压到 95% 以下。
+
+不要为了凑阈值人为拆分或合并单元。数字对不上时先怀疑边界，再怀疑数字。
+
+## 散落情节兜底
+
+覆盖率不足时执行，目的是**不丢情节点**，不是把每个点都塞进某个单元：
+
+1. 算孤立比例。低于 5% 直接标「少量散落」，不再处理。
+2. 收集未归类的情节点。
+3. 按角色重叠、地点重叠、因果关系三条线索判相关性：强相关归入并标 `[孤立归入]`；
+   中等相关归入并标 `[低置信归入]` 待复核；弱相关**不强行归入**。
+4. 弱相关的按主题聚类，聚出 5 个以上情节点才形成候选单元并标 `[聚类生成]`。
+5. 仍无法归类的写进 `story-units.md` 末尾的散落清单，按章排列并注明原因。
+
+**宁可留在散落清单里，也不要塞进不相关的单元**。 塞进去之后，那个单元的进入/出去状态
+就会带上一条对不上的事实，而它在下游看起来和真事实一模一样。
+
+## 节奏与情绪
+
+`rhythm-and-emotion.md` 写三件事，全部要能回指到章或情节点：
+
+- **关键信息推进**：某条信息何时进入读者视野 → 如何被延迟、误导或验证 → 何时爆发 →
+  余波与新钩子。
+- **情绪触动点索引**：每个触动点落在哪一章、由哪条情节点承担。
+- **长间隔说明**：连续 3 章以上没有触动点时，写清作者用什么维持期待。
+  改编时这些长间隔就是要合并或砍掉的段落——短剧没有这个耐心。
+
+回指不到章或情节点的条目删掉，不要保留无源断言。
+
+## 人物归并
+
+跨章去重时，**一人一实体**：无法确定两个称谓是否指同一人，就分开建两条，不合并。
+合并错了的代价不对称——两个人被并成一个，之后每一条关于「他」的事实都可能属于另一个人，
+而这种错在文本里几乎看不出来。
+
+别名分四类，只有前两类能触发合并：
+
+| 类型 | 定义 | 可合并 | 例 |
+|---|---|---|---|
+| 专名 | 全名、常用名 | 是 | 「顾禾」「顾小禾」 |
+| 绰号 | 外号，须有同指证据 | 是（证据充分时） | 「城东那位」经文中点明即为某人 |
+| 描述性称谓 | 按外形或角色描述 | **否** | 「红衣女子」「随从」 |
+| 头衔职务 | 泛指某个职位的称呼 | **否** | 「护卫队长」「家主」 |
+| 姓氏＋头衔 | 带姓氏或名的称呼 | 是（证据充分时） | 「周团」「钟记者」「齐军长」 |
+
+绰号与姓氏＋头衔的合并都需要可指出的同指证据：同位说明、括号别名、上下文明确指代、
+文中改名。「读起来像同一个人」不是证据。
+
+**姓氏＋头衔单列一类，因为中文叙事里它常常是最主要的称呼方式**。「周团」「钟记者」
+出现频次可能远高于全名，而它们带着姓氏，指向性与绰号相当——按「头衔职务」一律禁止合并，
+一部书会留下十几条重复实体。真正不可合并的是**不带姓名的泛指**：「护卫队长」「家主」
+可以先后由不同人担任，同一部书里换了人也看不出来。
+
+判据是：去掉头衔后还剩不剩一个姓或名。剩，按证据判；不剩，不合并。
+
+分级按戏份，不按喜好：出场章数占比、是否推动主线、是否有独立动机与变化。
+每条人物记 `unresolved`（未定的指代、矛盾的描述）与来源引用。
+
+**归并结果是候选，不是资产**。资产身份由 `$short-drama-assets` 从已接受剧本建立。
+
+## 设定归纳
+
+从提及数据归纳世界规则、力量体系与势力，不从记忆或同题材惯例补。
+
+- 力量体系：名称、层级、晋升方式；原文没写清的层级写「原文未明确」。
+- 地理：分布、主要区域、关键地点。
+- 势力：门派/组织/家族/国家，各自的目标与彼此的关系。
+- 特殊设定：区别于现实的规则。
+
+相互依赖、共同起作用的设定合并成一条（例如「戒指 + 里面的残魂」是一个整体，
+不拆成两条）；只有完全独立、互不依赖的才分开。
+
+每条设定标注它出现在哪几章。标不出来的设定，多半是从题材惯例里补出来的，删掉。