@oh-story/dsh 0.1.9 → 0.1.11

package/lib/oh-story/skills/story-import/references/structure-mapping-long.md

@@ -1,10 +1,74 @@
-# 结构迁移映射规则（长篇）
+# 结构迁移（长篇）
 
-Phase 3-L 长篇结构迁移的详细映射规则和模板。将 `拆文库/{导入书名}/` 分析结果转换为 `{导入书名}/` 长篇项目结构。
+Phase 3-L 结构迁移只读本文件：按下方迁移步骤把 `拆文库/{导入书名}/` 分析结果转换为 `{导入书名}/` 长篇项目结构。篇幅、外部对标、目标平台、作者交代读导入记录（`{书目录}/.story/work/导入记录.md`），不回翻对话。追踪（`追踪/`）不在本时刻生成，逐章细纲在最后一步按批另起。
 
-> 短篇迁移规则见 `structure-mapping-short.md`。
+---
+
+## 迁移步骤
+
+### Step 1：创建项目骨架
+
+```
+{导入书名}/
+├── 设定/
+│   ├── 世界观/
+│   ├── 角色/
+│   └── 势力/
+├── 大纲/
+├── 正文/
+├── 追踪/
+│   └── 逐章记录/
+├── 对标/                       # 可选；仅在显式绑定外部对标时创建子目录
+└── 参考资料/
+```
+
+### Step 2：正文标准化
+
+将原文迁移到 `正文/`，统一命名 `第XXX章_章名.md`：识别章节分隔符、提取章节标题、补零对齐编号（第1章 → 第001章）、保留原文内容不变，规则见下方「正文标准化规则」。
+
+### Step 3：角色文件迁移
+
+将 `拆文库/{导入书名}/角色/{角色名}.md` 迁移到 `设定/角色/{角色名}.md`，按下方「角色文件迁移模板」补齐 story-long-write 角色模板字段。角色分级（沿用 story-long-analyze 标准）：
+
+| 等级 | 标准 | 迁移策略 |
+|------|------|---------|
+| 主角 | 出现章节 ≥50% + 推动主线 + 完整成长轨迹 | 完整迁移 |
+| 反派 | 与主角对立 + 推动核心冲突 + 明确动机 | 完整迁移 |
+| 核心配角 | 出现章节 ≥20% 或推动重要支线 | 完整迁移 |
+| 功能角色 | 出现章节 <20% + 作用有限 | 简化迁移 |
+
+### Step 4：关系文件迁移
+
+将 `拆文库/{导入书名}/角色/角色关系.md` 转换为 `设定/关系.md`，按下方「关系文件转换规则」的目标格式模板输出。
+
+### Step 5：同步世界观设定
+
+当前拆文契约按主题输出 `拆文库/{导入书名}/设定/世界观/*.md` 与 `设定/势力/*.md`，导入时原样同步；`世界观/` 必须有 `背景设定.md`，短小力量体系可并入。当前产物缺失时停止并提示修复 Stage 4；检查器确认的旧成果则从已有扁平设定转换到当前项目路径，标注来源，不回写或覆盖拆文库。规则见下方「世界观同步规则」。
 
-> **名称边界**：`{导入书名}` 是用户自己的待续写小说；`{对标书名}` 是另行选择的外部参考作品。两者的数据源必须分开，禁止把 `{导入书名}` 的拆文结果或项目 `设定/` 写入 `对标/`。
+### Step 6：题材定位生成
+
+从拆文报告中提取核心发现，生成 `设定/题材定位.md`（下方「题材定位生成」模板）。本书题材、核心梗、情绪与节奏摘要来自 `拆文库/{导入书名}/`，但这些字段不是对标登记。只有导入记录已明确绑定外部对标时，才追加「对标书清单 + 主对标书」段；主对标书最多 1 本，副对标 / 参考对标不限制数量。未绑定时省略整个对标登记段，不得用 `{导入书名}` 补位。导入记录里「作者交代」的偏好与红线同步写进模板的「作者已定」小节，续写时才看得到。
+
+后续如需快速概览，可另写「对标分析（派生概要）」表；该表不是权威 registry，不得替代 `主对标书` 与完整 `对标书列表`。所有登记项必须能回溯到对应 `拆文库/{对标书名}/`，不得引用本书根 `设定/`。
+
+### Step 7：对标结构化资产同步
+
+只处理导入记录里显式绑定的外部参考作品：把 `拆文库/{对标书名}/` 的结构化分析资产同步到项目引用视图 `{项目}/对标/{对标书名}/`，供 story-long-write 优先读取；映射见下方「对标引用视图同步规则」。没有绑定外部对标时跳过本步，不创建空目录；严禁使用 `拆文库/{导入书名}/` 或项目 `设定/` 作为复制源。
+
+- 已选外部对标缺 `剧情/节奏.md` 或 `剧情/情绪模块.md` → 导入报告里告诉作者「《{对标书名}》的拆文缺节奏和情绪资料，这本对标暂时用不上；重新拆一次（`/story-long-analyze`）补齐后再接入」，并停止该对标召回；不得用摘要或报告生成空壳。本书核心工程迁移不回滚。两份老权威产物都存在时正常同步，缺少本次新增内嵌字段不阻断。
+- 其它结构化子目录缺失 → 在导入完成报告里用白话提示，不阻塞项目创建。
+
+### Step 8：文风同步
+
+外部对标已通过 Step 7 校验时，把 `拆文库/{对标书名}/文风.md` 复制到 `{项目}/对标/{对标书名}/文风.md`。纯复制，不重新生成；未绑定外部对标时跳过。拆文库没有文风文件（analyze 未跑 Stage 6）→ 导入报告提示作者重跑 `/story-long-analyze` 后再同步，日更前文风缺失会被 fail-fast 拦截；项目对标已有旧文风文件 → 覆盖（最新拆文产物优先），在导入报告告知。
+
+### Step 9：大纲与卷纲（作者确认点）
+
+按下方「大纲反推规则」反推 `大纲/大纲.md`：原文有明确卷界直接按卷界分；没有时向作者展示候选卷划分，**等作者确认后**才写定卷级结构和 `大纲/卷纲_第X卷.md`，确认结果（或「按原文卷界」）写进导入记录的「卷划分」。`剧情/散落情节.md` 合并到相关卷纲或大纲附录。
+
+### Step 10：逐批反推细纲
+
+卷纲写定、本文件末尾的质量清单通过后，在导入记录勾「结构迁移」，再按 [outline-reverse.md](outline-reverse.md) 分批反推细纲。细纲时刻只读任务包，不再读本文件；建议作者新开对话说「继续导入」再开始第一批。
 
 ---
 
@@ -22,16 +86,11 @@ Phase 3-L 长篇结构迁移的详细映射规则和模板。将 `拆文库/{导
 | `剧情/{标题}.md` | `大纲/卷纲_第X卷.md` | 聚合为卷纲 |
 | `剧情/节奏.md` | `设定/题材定位.md`（节奏摘要） | 提炼已写部分的既有节奏，保留为本书导入基线；不复制到 `对标/` |
 | `剧情/情绪模块.md` | `设定/题材定位.md`（情绪摘要） | 提炼已写部分的读者需求与情绪引擎；不复制到 `对标/` |
-| `章节/第N章_摘要.md` | `大纲/细纲_第N章.md` | 反推细纲 |
+| `章节/第N章_摘要.md` | `大纲/细纲_第XXX章.md` | 逐批反推（[outline-reverse.md](outline-reverse.md)） |
 | — | `设定/题材定位.md` | 从拆文报告生成 |
-| — | `追踪/_tracking-state.json.imported_through_chapter` | 记录导入截止章 N；第 1..N 章不伪造日更记录 |
-| — | `追踪/伏笔.md` | 每个已实际埋设/回收的伏笔 ID 只保留一行当前状态 |
-| — | `追踪/_tracking-state.json.timeline` | 同一事件登记客观事实、读者认知与实际揭示状态；Markdown 时间线只做派生阅读视图 |
-| — | `追踪/时间线/作者真相.md`、`读者已知.md` | 由 `_tracking-state.json.timeline` 派生；读者视图不得泄露作者秘密 |
-| — | `追踪/角色状态/{角色名}.md` | 由 `character-state-reverse.md` 反推核心角色当前快照 |
-| — | `追踪/逐章记录/` | 创建空目录；导入章不伪造日更记录，续写从 N+1 章生成 |
 | `剧情/散落情节.md` | `大纲/大纲.md` 附录或对应卷纲 | 合并到相关卷的大纲 |
-| — | `追踪/上下文.md` | 由初始化事务生成续写状态卡（固定 7 栏），≤12288 字节 |
+
+旧拆文的目录或字段名与上表不同时，先建立一次“旧路径 → 当前目标”的来源映射，再按实际可读内容转换；不要为了改名复制出第二套拆文真源。`剧情/节奏.md`、`剧情/情绪模块.md` 或主题化设定缺失时，旧内容能支持的导入步骤照常执行，对应摘要写「未知/待增强」；只有用户要启用依赖这些资料的新对标召回时，才回到 story-long-analyze 做按需增强。
 
 ---
 
@@ -184,6 +243,25 @@ A<->B：关系类型 | 情感 | 描述（50-200字）| 演变轨迹
 
 > **不允许**用「每卷默认 20-40 章」机械切分原文无卷界的书。候选仅作参考，最终由用户拍板。
 
+#### 目标格式模板（大纲/大纲.md）
+
+与长篇写作的全书大纲同形，续写时直接接着用；导入只填有证据的项，其余写 `[待补充]`：
+
+```markdown
+# 大纲
+
+## 全书体量与阶段总览
+- 已写：第 1–{N} 章，约 {Y} 万字；{完本 | 连载中}
+- 阶段划分 / 全书情绪曲线 / 关键节点与钩子链：{从故事线分段反推；证据不足写 [待补充]}
+
+## 卷级大纲
+### 第一卷：{卷名}（约 {X} 万字，{Y} 章）
+- 功能：{从剧情分析推断}
+- 核心事件：{一句话}
+- 起始状态 → 结束状态：{从角色弧线推断}
+- 卷契约 / 终局储备 / 阶段边界：{有证据才写，否则 [待补充]}
+```
+
 ### 候选边界检测参考
 
 | 信号类型 | 示例 | 卷边界可能性 |
@@ -228,7 +306,7 @@ A<->B：关系类型 | 情感 | 描述（50-200字）| 演变轨迹
 - 契约风险：{契约安全 / 需补强 / 契约破坏；无法判断写 `[待补充]`}
 
 ## 剧情单元（反推）
-| 单元ID | 章节范围 | 单元节拍（铺垫→释放→反应层→衔接） | 主推线/战果 | 下一单元因果钩子 |
+| 单元ID | 章节范围 | 单元节拍（建立期待→尝试→加压/转向→决定性行动→兑现→余波） | 主推线/战果 | 下一单元因果钩子 |
 |------|---------|---------|-------|---------|
 | L{卷}-1 | {章X-Y} | {从爽点/情节点分布归纳} | {线} | {方式} |
 
@@ -256,72 +334,6 @@ A<->B：关系类型 | 情感 | 描述（50-200字）| 演变轨迹
 - 情节点分布 → 情绪弧线 + 剧情单元（反推）
 - 角色出场 → 人物弧线
 - 铺垫类情节点 → 伏笔
-
-### 细纲反推
-
-从每章摘要（`章节/第N章_摘要.md`）提取：
-
-| 摘要字段 | 细纲字段 | 转换方式 |
-|---------|---------|---------|
-| 关键事件 | 核心事件 | 直接复用 |
-| 章节字数 | 字数目标 + 字数口径 | 对原文章节运行 `storyctl.py wordcount measure`，写入 `actual` 与 `visible_chars_v1` |
-| 章节基调 / 情绪曲线 | 目标情绪 | 从摘要提取；缺失写 `[待补充]` |
-| 第一个情节点 | 章首钩子 | 只作为证据，设计目标标 `[待补充]` |
-| 爽点类情节点 | 爽点 | 从情节点类型推断；没有则写“无显性爽点 / [待补充]” |
-| 情节点起承转合 | 内容概括（起因/发展/转折/高潮/结尾） | 按情节点顺序归纳；证据不足写 `[待补充]` |
-| 主线/支线/任务线索 | 情节安排（主线/辅线/事件线/感情线/逻辑线） | 从剧情单元索引与摘要反推；无证据的辅线/感情线写“无”或 `[待补充]`，不得杜撰 |
-| 出场角色 / 关键物件 | 人物关系和出场顺序 | 按摘要出现顺序列出；关系变化只写有证据的“前 → 后”，缺失写 `[待补充]` |
-| 全部情节点 | 情节细化 / 情节点序列 | 按表格逐行写（# / 情节点 / 功能标签 / 执行边界）；功能或边界不明写 `[待补充]`，不反推逐点字数配额 |
-| 胜负/反转/收益损失 | 行动成本（可无）/收益归属 | 有明确证据才填写；行动成本可无、不硬造；否则 `[待补充]` |
-| 最后一个情节点 / 悬念类情节点 | 结尾设定和钩子 | 收束状态可归纳；章尾钩子设计目标标 `[待补充]` |
-
----
-
-## 角色状态反推
-
-由 character-state-reverse.md 反推，详见该文件。
-
----
-
-## 伏笔提取规则
-
-从情节点中识别潜在伏笔：
-
-### 识别模式
-
-| 情节点类型 | 伏笔可能性 | 提取方式 |
-|-----------|-----------|---------|
-| 铺垫 | 高 | 直接提取为伏笔 |
-| 信息揭示（部分） | 中 | 检查后续是否有呼应 |
-| 物品首次出现 | 中 | 检查后续是否有使用 |
-| 角色秘密 | 高 | 标记为角色伏笔 |
-| 未解决的悬念 | 高 | 从章尾标记提取 |
-
-### 状态推断
-
-- 铺垫点在后续章节有「揭示」或「解决」类情节点 → 标记「已回收」
-- 铺垫点无后续呼应 → 标记「已埋」
-- 半成品小说的最后几章铺垫 → 标记「已埋」，备注「接近断点」
-
----
-
-## 时间线提取规则
-
-### 时间标记识别
-
-从情节点和时间标记中提取：
-
-| 标记模式 | 示例 | 提取方式 |
-|---------|------|---------|
-| 明确日期 | "天元三年春" | 直接记录 |
-| 相对时间 | "三日后"、"半月后" | 推算绝对时间 |
-| 事件间隔 | "翌日"、"次日" | 连续标记 |
-| 季节标记 | "入冬"、"春暖花开" | 季节推断 |
-
-### 排序规则
-
-按章节顺序排列，同一章内按情节点序号排列。时间标记缺失时标注 `[推断]`。
-
 ---
 
 ## 题材定位生成
@@ -339,6 +351,9 @@ A<->B：关系类型 | 情感 | 描述（50-200字）| 演变轨迹
 - 核心梗：{一句话卖点}
 - 微创新点：{与同类题材的差异}
 
+## 作者已定
+- {导入记录「作者交代」里的偏好与红线、残稿决定，一条一行；没有写「无」}
+
 ## 核心梗三分法
 - 表层卖点：{读者一眼看到的吸引力}
 - 深层爽点：{持续追读的情绪驱动力}
@@ -410,7 +425,7 @@ A<->B：关系类型 | 情感 | 描述（50-200字）| 演变轨迹
 | `拆文库/{对标书名}/剧情/节奏.md` | `{项目}/对标/{对标书名}/剧情/节奏.md` | 日更选择 `rhythm_reference` 的必备权威文件；缺失则不登记该对标 |
 | `拆文库/{对标书名}/剧情/情绪模块.md` | `{项目}/对标/{对标书名}/剧情/情绪模块.md` | 日更选择 `selected_emotion_module` 的必备权威文件；缺失则不登记该对标 |
 | `拆文库/{对标书名}/剧情/*.md` | `{项目}/对标/{对标书名}/剧情/*.md` | 剧情单元、故事线、散落情节等剧情资产；与权威节奏/情绪文件冲突时以后者为准 |
-| `拆文库/{对标书名}/章节/*.md`（第N章_摘要.md + 黄金三章 第1-3章_深度拆解.md）| `{项目}/对标/{对标书名}/章节/*.md` | 匹配章证据，含「关键信息与扩写技法」 |
+| `拆文库/{对标书名}/章节/*.md`（第N章_摘要.md + 黄金三章 第1-3章_深度拆解.md）| `{项目}/对标/{对标书名}/章节/*.md` | 匹配章证据；摘要读取概要、关键事件、局面结果、涉及、状态变化与情节点序列（含类型、主题标签与基调），黄金三章另含深度写法 |
 | `拆文库/{对标书名}/角色/*.md` | `{项目}/对标/{对标书名}/角色/*.md` | 角色功能位、关系与反应层参考 |
 | `拆文库/{对标书名}/设定/` | `{项目}/对标/{对标书名}/设定/` | 世界观、势力、金手指等设定约束参考 |
 | `拆文库/{对标书名}/拆文报告.md` | `{项目}/对标/{对标书名}/拆文报告.md` | 人类可读摘要投影 |
@@ -418,25 +433,16 @@ A<->B：关系类型 | 情感 | 描述（50-200字）| 演变轨迹
 
 冲突规则：已登记外部对标的 `对标/{对标书名}/剧情/情绪模块.md` 和 `对标/{对标书名}/剧情/节奏.md` 是对标召回权威；`拆文报告.md`、`剧情/故事线.md` 只作为摘要投影。若摘要冲突，保留冲突说明并以权威文件为准；缺少任一权威文件时不生成半套对标视图，先修复该外部作品的拆文产物。
 
----
 
 ## 质量检查清单
 
-Phase 3-L 迁移完成后执行：
+迁移完成、进入逐批细纲前执行（不念给作者，没通过先修）：
 
 - [ ] 正文文件数 = 源文件章节数
 - [ ] 主要角色（主角 + 核心配角）文件已创建
 - [ ] 关系.md 非空
-- [ ] 大纲.md 有卷级结构
-- [ ] 每章细纲已生成
-- [ ] `_tracking-state.json.imported_through_chapter` 等于最后完整导入章
-- [ ] `追踪/伏笔.md` 每个 ID 至多一行，未来尚未埋设的设计没有混入
-- [ ] `_tracking-state.json.timeline` 已登记关键事实与读者认知，`读者已知.md` 无真相泄露
-- [ ] `追踪/角色状态/{角色名}.md` 已覆盖全部核心角色并对齐 `character-state-reverse.md`
-- [ ] 追踪/逐章记录/ 空目录已创建，且没有为导入章伪造日更记录
-- [ ] `追踪/上下文.md` 顶层恰好 固定 7 栏且 ≤12288 字节
-- [ ] `tracking_commit.py check` 通过，`_tracking-state.json` 与全部派生视图一致
+- [ ] 大纲.md 有卷级结构，每卷有卷纲且「剧情单元（反推）」表写了章节范围
 - [ ] 散落情节已合并到相关卷纲或大纲附录
-- [ ] 卷划分已经用户确认（原文无明确卷界时必检）
+- [ ] 卷划分已经用户确认（原文无明确卷界时必检），确认结果已写进导入记录
 - [ ] `拆文库/{导入书名}/` 未被复制到 `对标/`，本书未登记为自身对标
 - [ ] 若绑定外部对标，`拆文库/{对标书名}/` 与 `对标/{对标书名}/` 名称和来源一致，两个主产物均已同步；否则报告修复动作但不回滚本书工程

package/lib/oh-story/skills/story-import/references/structure-mapping-short.md

@@ -1,6 +1,17 @@
 # 结构迁移映射规则（短篇）
 
-Phase 3-S 短篇结构迁移的详细映射规则。将 `拆文库/{导入书名}/` 短篇拆文产物转换为 `{短篇标题}/` 短篇工程结构，供 `story-short-write` Phase 3 无缝接手续写。
+Phase 3-S 短篇结构迁移只读本文件和 [format-and-structure.md](format-and-structure.md)：将 `拆文库/{导入书名}/` 短篇拆文产物转换为 `{短篇标题}/` 短篇工程结构，供 `story-short-write` Phase 3 无缝接手续写。外部对标与作者交代读导入记录（`{书目录}/.story/work/导入记录.md`）。
+
+## 迁移步骤
+
+目标工程只有 `{短篇标题}/设定.md`（核心框架 + 本书续写基线）、`小节大纲.md`、`正文.md` 三个单文件，外加可选的 `对标/{对标书名}/`（仅外部对标引用视图：拆文报告、情节节点、写作手法）。**短篇工程与长篇完全不同**：正文是单文件、不切章，**不产** `追踪/`、`大纲/`、`正文/` 等长篇目录，迁移时严禁误建。
+
+1. **正文迁移**：将 `拆文库/{导入书名}/原文/` 的全文迁移为单文件 `{标题}/正文.md`，按 format-and-structure.md 规范化格式（小节标记 `###1.`、段间仅单换行、对话引号按项目/平台约定统一）。原文已是成稿，不重写内容，只规范格式。
+2. **设定生成**：从 `拆文报告.md`、`写作手法.md` 反推 `{标题}/设定.md`，含核心框架（对齐 story-short-write 核心框架：基本信息、一句话梗概、核心反转、情绪设计、人设速写）与本书续写基线（已写内容的故事结构、情绪节奏、核心反转机制、既有写作手法；这是本书内部上下文，不是对标摘要）两个区块，规则见下方「设定.md 反推规则」。导入记录里作者交代的偏好与红线一并写进续写基线。
+3. **小节大纲生成**：从 `情节节点.md` 的功能分段反推 `{标题}/小节大纲.md`，按开头段/铺垫段/升级段/反转段/结尾段映射，用 story-short-write 的固定 12 列表格，每节一行，填法见下方「小节大纲表格」。相关情节点可由同一动作链或对话同时兑现，不为凑数量拆成多个子事件；原文判断不出的格子写 `[待补充]`，不套用长篇完整章节蓝图。
+4. **外部对标引用视图（可选）**：仅当导入记录已显式绑定外部 `{对标书名}` 时，才把 `拆文库/{对标书名}/` 同步为 `{标题}/对标/{对标书名}/`；没有绑定则跳过。不得把 `拆文库/{导入书名}/` 整体复制进 `对标/`。
+
+迁完按文末质量检查清单自检，在导入记录勾「结构迁移」，直接进入 Phase 5 汇报。
 
 > 长篇迁移规则见 `structure-mapping-long.md`。
 
@@ -48,7 +59,7 @@ Phase 3-S 短篇结构迁移的详细映射规则。将 `拆文库/{导入书名
 - 标题：{导入书名}
 - 目标字数：{原文实际字数} 字
 - 目标平台：{从拆文报告提取，无则填 [待补充]}
-- 情绪目标：{从拆文报告「情感线/爆点分析」提取读者预期感受}
+- 目标情绪：{从拆文报告「情感线/爆点分析」提取读者预期感受}
 
 ### 一句话梗概
 {主角 + 困境 + 反转 + 情绪落点（从拆文报告故事核提取）}
@@ -108,20 +119,21 @@ Phase 3-S 短篇结构迁移的详细映射规则。将 `拆文库/{导入书名
 | 反转段 | 高潮（核心反转引爆） | 通常 1-2 个小节，情绪峰值 |
 | 结尾段 | 结局（收束/情绪落点） | 通常 1-2 个小节 |
 
-### 小节条目模板
+### 小节大纲表格
+
+`小节大纲.md` 用 story-short-write 的固定 12 列表格，每节一行，列名和顺序不改：
 
 ```markdown
-## 开头段
-
-### 小节 1
-- 核心事件：{从情节节点提取该分段的主要情节点}
-- 情绪目标：{对应情感曲线节点的情绪词}
-- 章首钩子：[待补充]
-- 章尾钩子：[待补充]
-- 参考字数：{按原文对应段落字数估算}
+| 结构段/五段功能 | 主事件 | 情节推进 | 情绪 | 人物/关系变化 | 因果/逻辑链 | 读者新获知什么 | 结尾承接/钩子 | 伏笔/物件 | 场景形态 | 对白作用 | 目标字数 |
+|---|---|---|---|---|---|---|---|---|---|---|---|
+| 开头 | 从情节节点提取的主要情节点 | 具体发生了什么{发现} -> 具体发生了什么{冲突} | 前状态→后状态 | 本节前后变化，或 无（本节改变：…） | 原因 → 行动 → 结果 → 后果 | [待补充] | [待补充] | [待补充] | [待补充] | [待补充] | 按原文该节实际字数 |
 ```
 
-> 钩子字段标 `[待补充]`——无法可靠提取，留给用户或续写时填写。
+- `结构段/五段功能` 填 开头/铺垫/升级/反转/结尾。
+- `情节推进` 每个推进单元带 `{对话}` `{冲突}` `{伏笔}` `{回忆}` `{发现}` `{递进}` 之一，有先后用 `->` 连接，按原文实际发生的写，不为凑数拆分。
+- 从原文判断不出的格子写 `[待补充]`，留给作者或续写时填写；不写 `{}` 模板占位。
+- `目标字数` 写原文该节实际字数，各节之和与 `设定.md` 的目标字数对得上。
+- 付费点在哪一节末能从原文认出来时，在该行 `结尾承接/钩子` 标「付费点」；认不出写 `[待补充]`。
 
 ### 小节数量推算
 

package/lib/oh-story/skills/story-import/references/tracking-initialization.md

@@ -2,7 +2,7 @@
 
 ## 初始化事务
 
-新书从第 0 章初始化。`story-import` 导入已有小说时把最后完整章写入 `last_chapter=N`；第 1..N 章不伪造日更记录，常规续写从 N+1 章开始。
+新书从第 0 章初始化：把下面的 JSON 写到 `{书目录}/.story/work/init.json`，跑 `{PYTHON} {skill 根}/scripts/tracking_commit.py init --project {书目录} --input {书目录}/.story/work/init.json`，成功后删掉临时文件。`story-import` 导入已有小说时把最后完整章写入 `last_chapter=N`；第 1..N 章不伪造日更记录，常规续写从 N+1 章开始。
 
 ```json
 {

package/lib/oh-story/skills/story-import/references/tracking-transaction.md

@@ -18,23 +18,26 @@ Markdown 只负责给作者和 Agent 阅读，工具不再反向解析 Markdown
 先按运行环境探测 Python 3 解释器（依次尝试 `python3`、`python`、`py -3`）。追踪事务脚本使用当前 skill 根目录；字数与章节闭环统一使用 `story-long-write` skill 根目录：
 
 ```text
-{PYTHON} {当前 skill 根}/scripts/tracking_commit.py init   --project {书项目根} --input {初始化事务.json}
+{PYTHON} {当前 skill 根}/scripts/tracking_commit.py init   --project {书项目根} --input {书项目根}/.story/work/init.json
 {PYTHON} {当前 skill 根}/scripts/tracking_commit.py check  --project {书项目根}
-{PYTHON} {story-long-write skill 根}/scripts/storyctl.py chapter check   --project {书项目根} --chapter {N}
-{PYTHON} {story-long-write skill 根}/scripts/storyctl.py chapter commit  --project {书项目根} --chapter {N} --input {逐章事务.json}
-{PYTHON} {story-long-write skill 根}/scripts/storyctl.py chapter accept-current-length --project {书项目根} --chapter {N} --input {逐章事务.json}
+{PYTHON} {当前 skill 根}/scripts/tracking_commit.py draft  --project {书项目根} --chapter {N}
+{PYTHON} {story-long-write skill 根}/scripts/storyctl.py chapter check   --project {书项目根} --chapter {N} [--min-chars {下限} --max-chars {上限}]
+{PYTHON} {story-long-write skill 根}/scripts/storyctl.py chapter commit  --project {书项目根} --chapter {N} --input {书项目根}/.story/work/第{NNN}章/tracking.json
+{PYTHON} {story-long-write skill 根}/scripts/storyctl.py chapter accept-current-length --project {书项目根} --chapter {N} --input {书项目根}/.story/work/第{NNN}章/tracking.json
 ```
 
 - `init`：只在 `_tracking-state.json` 不存在时执行，绝不覆盖已初始化项目。
-- `wordcount measure` / `wordcount checkpoint`：纯测量入口；不写正文、不写 tracking、不做语义判断。长篇正文流程一次写完整章，**不在章中调用测量**，长度由 `chapter check` 一次收口；这两个入口供导入、审查等其他场景使用。
-- `chapter check`：重新读取当前正文与细纲目标，返回确定性长度状态、现有 blocking quality、`state_revision` 和当前可执行动作，不保存 approval。`under` 不提供自动补写；`over` 额外返回一次净删型 `compress-once` 及进入内带/用户带所需的机器删除区间。
-- `chapter commit`：再次读取当前文件、重新计数并重跑 blocking quality；只接受用户带内章节，把简短字数记录与逐章事务一起原子提交。
-- `chapter accept-current-length`：只接受带外但 quality pass 的章节；接受动作发生时重新读取、重新计数并立即原子提交，不保存可陈旧的历史决议。
+- `draft`：按当前 state 把逐章事务预填到 `.story/work/第NNN章/tracking.json`（修订号、模式、章名、`context` 四项当前值），并输出各文本字段的字数上限与在场核心角色的当前快照。新章（append）调用方只填 `delta` 与有变化角色的快照；已提交章（revision）的 `delta` 与相关角色快照按该章现有逐章记录预填（伏笔、时间线取当前值），调用方在上面改成修订后的完整记录，不清空重写。
+- 作者字数范围：细纲可写一行 `字数范围：2000-2600`（作者明确给了上下限时）；本轮临时给的范围用 `--min-chars` / `--max-chars`（两者同给，优先于细纲）。`wordcount check` / `checkpoint` 与 `chapter check` / `commit` / `accept-current-length` 都认，给了就同时替代默认 ±12% 内部带与 ±15% 用户带，结果里 `band_source` 为 `author`，提交的字数记录多一项 `author_range`。
+- `wordcount measure` / `wordcount checkpoint`：纯测量入口；不写正文、不写 tracking、不做语义判断。长篇正文只在前组写完后由主会话带 `--project` 调用一次 `checkpoint`（目标与字数范围读细纲，见 workflow-chapter 步骤 6），整章长度由 `chapter check` 收口；`remaining_user_range` 按生效区间（作者区间或默认用户带）计算。
+- `chapter check`：重新读取当前正文与细纲目标，返回确定性长度状态、现有 blocking quality、`state_revision` 和当前可执行动作，不保存 approval。顶层 `status`：`ready`（可提交，exit 0）/ `needs_decision`（长度带外，按 `available_actions` 交作者，exit 0）/ `blocked`（有 blocking 正文问题，exit 1）/ `invalid`（正文为空等，exit 1）/ `tool_unavailable`（找不到 node 或检测脚本，见 `quality.tool_errors`，不是正文问题，exit 3）。参数错误或文件缺失输出 `story-chapter-error/v1`（`status: error`，exit 2）。`under` 不提供自动补写；`over` 额外返回一次净删型 `compress-once` 及回到生效区间所需的删除字数。`quality.semantic_advisories` 是语义类 advisory 条数（检测器标 `review: mechanical` 的不计）。
+- `chapter commit`：再次读取当前文件、重新计数并重跑 blocking quality；只接受生效区间内的章节，把简短字数记录与逐章事务一起原子提交。新章与修订都走它。
+- `chapter accept-current-length`：只接受带外但 quality pass 的章节；接受动作发生时重新读取、重新计数并立即原子提交，不保存可陈旧的历史决议。低于字数目标一半（`BELOW_ACCEPT_FLOOR`），或超长却还没做过那一次压缩（`COMPRESSION_REQUIRED`），都拒绝；作者明确拍板时加 `--force`。
 - `check`：严格验证 state schema、逐章记录连续性/规范名/体积、固定 7 栏、角色快照硬上限、派生文件集合，以及所有派生视图与 state 的逐字一致性。
 
 每本书由 `追踪/.tracking-commit.lock` 串行写事务，`expected_state_revision` 再拒绝基于旧状态构造的 stale transaction。两个不同事务并发时至多一个修订成功。字数记录也在锁内对当前正文和目标重新验证，正文或目标变化会让预先构造的记录直接失败。
 
-事务 JSON 是临时输入，不是项目产物：成功前必须保留；提交成功且紧随其后的 `check` 通过后立即删除，不能把 `init_transaction.json`、`chapter_*_transaction.json` 等输入长期留在书项目根目录。若文件写入失败，`_tracking-state.json` 尚未推进；修正环境后直接重跑**同一份** `commit`。append 重跑只接受内容完全相同的既有逐章记录，不维护 `dirty/pending/repair` 状态机。
+事务 JSON 是临时输入，不是项目产物：只写在书目录 `.story/work/` 下（逐章事务放 `.story/work/第NNN章/tracking.json`），不写系统 `/tmp`、书根、`大纲/` 或 `正文/`；成功前必须保留，提交成功后即可删除（`storyctl.py chapter commit` / `accept-current-length` 成功时自动删除该章目录；直接调用 `tracking_commit.py commit` 时由调用方删除。已有字数记录的章节正文或目标改过后，`tracking_commit.py commit` 拒绝修订事务，须走 `storyctl.py chapter commit`）——之后 `check` 失败按下文提交 `mode=revision` 新事务修复，不需要原事务。若文件写入失败，`_tracking-state.json` 尚未推进；修正环境后直接重跑**同一份** `commit`。append 重跑只接受内容完全相同的既有逐章记录，不维护 `dirty/pending/repair` 状态机。
 
 校验失败与写入失败处理方式不同：校验失败（字段非法、退役结构、容量超限）要按报错改事务本身，重跑同一份结果不变。派生视图被手改或外部改动导致 `check` 报 `derived view differs from _tracking-state.json` 时，重新提交**该章**的 `mode=revision` 事务让工具整份重建，`expected_state_revision` 取 `追踪/_tracking-state.json` 的 `state_revision` 字段——`check` 失败时只往 stderr 打 ERROR，不输出 JSON；不手改派生文件，也不删 `_tracking-state.json` 重来。手写出的逐章记录会让同章 `append` 永久报 `chapter delta N already exists with different content`——删掉那个手写文件后重跑原事务即可。
 
@@ -44,7 +47,7 @@ Markdown 只负责给作者和 Agent 阅读，工具不再反向解析 Markdown
 
 仅新书或导入初始化时，执行 `init` 前必须完整读取 [tracking-initialization.md](tracking-initialization.md)，按其中原始 JSON 与导入边界构造事务。已有项目续写直接使用下方逐章事务，不重复读初始化示例。
 
-调用方的逐章 JSON 不写 `wordcount`；正式入口 `chapter commit` 或 `chapter accept-current-length` 在提交当下生成并注入。最终 state 只为已提交章节保留 `metric / target / actual / status / resolution / body_sha256`，不保存 MEASURE/RESOLVE 事件、ID 链、policy fingerprint 或独立 chapter state。
+调用方的逐章 JSON 不写 `wordcount`；正式入口 `chapter commit` 或 `chapter accept-current-length` 在提交当下生成并注入。最终 state 只为已提交章节保留 `metric / target / actual / status / resolution / body_sha256`（生效了作者字数范围时另加 `author_range`），不保存 MEASURE/RESOLVE 事件、ID 链、policy fingerprint 或独立 chapter state。
 
 ## 逐章事务
 
@@ -119,12 +122,13 @@ Markdown 只负责给作者和 Agent 阅读，工具不再反向解析 Markdown
 - `character_snapshots` 中出现的角色视为核心复用角色，必须同时出现在 `character_changes`；已经建立快照的核心角色再次变化时必须提交新快照。
 - 角色快照的四个列表不限制条数，只限制单项长度和最终文件总字节：目标 ≤4096 字节，超过警告；硬上限 8192 字节，超过则在任何写入前拒绝。
 - 没有快照的角色变化视为临时角色，不建立状态文件；`context.active_character_names` 最多 6 人且必须已有当前快照。
+- `context.long_term_constraints` 最多 6 条：要加第 7 条先合并语义重叠项或请作者取舍，不自动删旧约束；永久生效的设定裁定进它，短期强承诺进 `next_chapter_commitments`，过程决策不进续写状态卡。
 - `context.long_term_constraints` 和 `context.continuity_risks` 是整份提交的当前值。凡是上一版有、本次没有的条目，必须逐条列进 `delta.retired_context_items`，否则工具在任何写入前拒绝——漏写不会被当成删除。实际退役的条目由工具写进本章逐章记录的 `## 本章退役登记`，随后仍可回查。
 - 不再复用的核心角色写进 `delta.retired_characters`：工具删除其当前快照与 `角色状态/{角色名}.md`，并在逐章记录留档。同一事务里不能既退役又提交快照，也不能退役仍列在 `context.active_character_names` 的角色。角色阵亡/退场这一章，把变化照写进 `character_changes` 即可，本章退役的角色不必再交一份马上要删的快照，逐章记录仍按核心角色标注。退役只表示不再进入热上下文，正文与逐章记录不受影响。
 - 两类退役都只能在 `mode=append` 提交。退役表示「从此刻起离开当前状态」，而修订事务的逐章记录属于被改写的旧章，落在那里会谎报退役发生的章节；`mode=revision` 必须原样重交当前全部上下文条目，需要退役就放到下一次 append。
 - `伏笔.md` 只呈现已经埋设过的当前状态。未来规划仍留在大纲。
 - `timeline_events.action` 可为 `upsert/delete`。`未揭示` 的 `reveal_chapter` 必须为 `null`；部分/完全揭示只能填写已经发生的实际章节。
-- `mode=revision` 时，逐章记录必须重算为修订后该章仍然成立的完整连续性记录；当前角色、伏笔、时间线和上下文则提交受影响对象截至最新已写章的当前值。
+- `mode=revision` 时，逐章记录必须重算为修订后该章仍然成立的完整连续性记录（用 `draft` 预填的草稿改，漏写的项会从记录里消失，工具在 stderr 警告被清空的栏目；原有的退役登记原样保留）；当前角色、伏笔、时间线和上下文则提交受影响对象截至最新已写章的当前值。
 - 修订导入截止章内的正文时，会新增或覆盖该章的逐章记录；`imported_through_chapter` 不变。
 
 ## 续写状态卡固定格式