short-drama-novel-analyze

1# 长篇原著分析
2 
3从长材料中提取可追溯的戏剧功能，说明各段如何改变角色选择、信息、权力或关系，以及这些功能怎样用于竖屏短剧改编。
4 
5分析结果供创作者取舍：保留哪条线、合并哪些人、从哪里开篇，由创作者决定，再交给
6`$short-drama-develop` 写成改编契约。本技能不批准自己的产物。
7 
8## Quick Start
9 
10离线验证章节索引、采样和源文件变更检测：
11 
12```bash
13python3 {技能目录}/scripts/selftest.py
14python3 {技能目录}/scripts/novel_index.py index <原著.txt> --out <chapter-index.json>
15```
16 
17## 开始前
18 
19本技能可独立运行；若当前目录是 `short-drama` 项目且项目工具可用，可读取 `status` 并使用其发布生命周期。完整边界与规则见 [阶段契约](references/stage-contract.md)，无需读取其他技能的文件。
20 
21## 材料前提
22 
23只分析创作者**合法持有、拥有使用权**的作品。分析是只读的转化性工作：记录 locator、span 与去引用的功能摘要，不把原文成段复制进分析或下游产物；需要证据时只引用最短必要片段。交付包不得带出原始材料。
24 
25通俗题材里的暴力、复仇、背叛、情爱张力与黑暗伦理照常做结构化提取。个别片段无法处理时跳过该段并记录范围，不中止整章或整本。
26 
27## 先判断入口
28 
291. **只有书名，没有原文**：请创作者提供文件路径或粘贴正文，不凭书名回忆情节。
302. **有原文，未建项目**：建立只读输入目录 `输入/` 与输出目录 `项目开发/source-analysis/_work/`，把原文字节复制到 `输入/` 并记录原始位置，再用 `novel_index.py` 建索引（`$short-drama` 可用时可选用它初始化目录）。
313. **有原文，项目已在**：直接进入管道。
324. **已有部分分析**：读 `项目开发/source-analysis/_progress.md` 从断点续跑，不重跑已完成阶段。
33 
34## 管道
35 
36`输入/` 只读，全部产出落在 `项目开发/source-analysis/`。S1–S5 的产物均先写到 `source-analysis/_work/`（并发子代理只写 `_work/`），主线程完成本阶段机械检查后再原子替换或通过 `project_tool.py publish` 发布到正式路径。`_progress.md` 跨阶段共用固定 artifact-id `source-analysis:progress`。
37 
38| 阶段 | 做什么 | 产出 | 停靠 |
39|---|---|---|---|
40| S0 | 建章节索引（脚本） | `_index.json`、`_progress.md` | 索引有问题就停 |
41| S1 | 改编价值快评（抽样） | `triage.md` | **停靠问创作者** |
42| S2 | 逐章功能提取 | `chapters/ch-<N>-extract.md` | 覆盖率不足就停 |
43| S3 | 剧情单元与节奏聚合 | `story-units.md`、`rhythm-and-emotion.md` | 阈值不达标就复核 |
44| S4 | 人物归并与设定 | `characters.md`、`world.md` | — |
45…