Short Drama Novel Analyze skill

长篇原著分析

从长材料中提取可追溯的戏剧功能，说明各段如何改变角色选择、信息、权力或关系，以及这些功能怎样用于竖屏短剧改编。

分析结果供创作者取舍：保留哪条线、合并哪些人、从哪里开篇，由创作者决定，再交给 $short-drama-develop 写成改编契约。本技能不批准自己的产物。

Quick Start

离线验证章节索引、采样和源文件变更检测：

python3 {技能目录}/scripts/selftest.py
python3 {技能目录}/scripts/novel_index.py index <原著.txt> --out <chapter-index.json>

开始前

本技能可独立运行；若当前目录是 short-drama 项目且项目工具可用，可读取 status 并使用其发布生命周期。完整边界与规则见 阶段契约，无需读取其他技能的文件。

材料前提

只分析创作者合法持有、拥有使用权的作品。分析是只读的转化性工作：记录 locator、span 与去引用的功能摘要，不把原文成段复制进分析或下游产物；需要证据时只引用最短必要片段。交付包不得带出原始材料。

通俗题材里的暴力、复仇、背叛、情爱张力与黑暗伦理照常做结构化提取。个别片段无法处理时跳过该段并记录范围，不中止整章或整本。

先判断入口

1. 只有书名，没有原文：请创作者提供文件路径或粘贴正文，不凭书名回忆情节。
2. 有原文，未建项目：建立只读输入目录 输入/ 与输出目录 项目开发/source-analysis/_work/，把原文字节复制到 输入/ 并记录原始位置，再用 novel_index.py 建索引（$short-drama 可用时可选用它初始化目录）。
3. 有原文，项目已在：直接进入管道。
4. 已有部分分析：读 项目开发/source-analysis/_progress.md 从断点续跑，不重跑已完成阶段。

管道

输入/ 只读，全部产出落在 项目开发/source-analysis/。S1–S5 的产物均先写到 source-analysis/_work/（并发子代理只写 _work/），主线程完成本阶段机械检查后再原子替换或通过 project_tool.py publish 发布到正式路径。_progress.md 跨阶段共用固定 artifact-id source-analysis:progress。

阶段	做什么	产出	停靠
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 章节索引

各阶段共用 章节索引脚本 建立的章节边界，不各自重新切分。

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 输入/{原文文件}

独立运行时，将验证通过的 _work/_index.next.json 原子替换到正式的 _index.json，再进入 S1。

脚本识别阿拉伯数字与中文数字章号（含 千 / 两），只认一种编号单位（按 章、回、节 由粗到细，取最粗且至少出现两次的单位，其余记进 ignored_heading_units），只把短的独立行当标题（以章号开头的正文段落记进 long_heading_lines_skipped），剔除开头目录块并按卷分段校验编号。

problems 非空就停下报告，不带错表进 S1。常见五种：章号跳号、同卷内重号、正文极少的章（目录残留或卷首页）、无法解析的章号、第一章前有大段未归属文字（text_before_first_chapter，不含目录行；确认是楔子后在 _work/_index.next.json 开头手写一行从第 1 行起覆盖，source_number 留 null，其余 sequence 顺延加一再跑 verify）。另核对 chapter_unit 与 ignored_heading_units（防用 第N章 分章、第N节 分小节的书被反判），以及 long_heading_lines_skipped（明显偏大时与创作者确认是否长标题并手写边界）。

原文无章节标题时索引返回空表，与创作者确认切分方式后把边界（含 sequence / line_start / line_end）写入 _work/_index.next.json，通过 verify 后发布。改了原文必须重建索引（verify 查章号与行号覆盖，不查同行数原地改写）。

S1 改编价值快评

按 改编价值快评 用 novel_index.py sample --count 12 抽样评估改编密度并写出 triage.md（首行写 coverage_ratio，结论限于抽样范围）。写完后给出快评与全量拆解预计耗时，停靠问创作者是否继续（_progress.md 状态写 paused_after_triage，断点写「下一步：S2 逐章提取」）；创作者已声明「一次跑完」时仍写 triage.md 供 S5 回填对照，但不停靠。

S2 逐章功能提取

按 章节提取 提取每章到 chapters/ch-<N>-extract.md（<N> 为索引 sequence）。能并发子代理则每批 5–8 章并发，否则串行。全部落盘后检查覆盖率：

python3 {技能目录}/scripts/novel_index.py coverage \
  项目开发/source-analysis/_index.json 项目开发/source-analysis/chapters

先修正 unmatched_files 中的命名错误，再补跑 missing 章。单章连续失败两次先记入 _progress.md 继续提取其余章，S2 结束前统一补齐；仍有缺章时停在 S2 报告缺失范围，不进入 S3。

S3 剧情单元与节奏

从逐章提取聚合（事实或指代不清时按定位回查原文，不通读全书）。按 聚合与实体 先识别故事框架，再产出 story-units.md 与 rhythm-and-emotion.md（含按观众收益排名的爽点表），最后执行三条阈值自检与散落情节兜底。

S4 人物与设定

按 聚合与实体 归并人物（跨章去重、别名归一、分级）并归纳世界规则、力量体系与势力。人物归并条目带 unresolved 与来源引用，仅为供 $short-drama-develop 决策的候选；正式资产身份须等 $short-drama-write 写进剧本后由 $short-drama-assets 建立。

S5 改编价值与分集候选

按 改编价值 产出 adaptation-value.md（开头回填对照 S1 快评中印证或推翻的判断）与 episode-candidates.jsonl（按爽点分布、当集戏剧结果与精确交接切分，样例见 分集候选样例）。

交接

S5 完成后向创作者汇报拆解章数、跳过范围、候选集数、三处最大改编风险及快评对照结果，再交给 $short-drama-develop 生成 项目开发/adaptation-map.jsonl 与改编契约。需要独立审查时调用 $short-drama-review（范围 source_analysis）。

产物与边界

本技能只拥有 项目开发/source-analysis/ 下的阶段产物（见上表），不改写 输入/、不写其他技能产物、不签发终审结论；分析产物语言跟随 short-drama.json#/language（独立运行时跟随用户语言），详见 阶段契约。

按需加载

• 快评读哪些章、写哪六件事、怎么不冒充全量分析：改编价值快评
• 逐章提取写法、白描与叙事框架词的界线、机械自检、并发与串行：章节提取
• 故事框架、剧情单元、节奏情绪、人物归并、阈值与散落兜底：聚合与实体
• 改编价值评估、载体替换与分集候选切法：改编价值
• 本阶段拥有什么、继承什么、不越权什么：阶段契约