@oh-story/dsh 0.1.8 → 0.1.10

package/lib/oh-story/skills/story-long-write/references/project-files.md

@@ -0,0 +1,110 @@
+# 项目文件与产物协议
+
+#### 项目文件结构
+
+需落盘时在用户指定目录按下表组织；只讨论不建工程，仅规划只创建本次产物所需目录，不为凑齐目录树生成正文或追踪：
+
+```
+{书名}/
+├── 设定/
+│   ├── 世界观/
+│   │   ├── 背景设定.md        # 时代背景、地理、历史
+│   │   ├── 力量体系.md        # 修炼/能力/等级体系
+│   │   └── ...
+│   ├── 角色/
+│   │   ├── 沈栀.md            # 每个人物一个文件，文件名用角色名
+│   │   └── ...
+│   ├── 势力/
+│   │   ├── 天机阁.md          # 每个势力/组织一个文件
+│   │   └── ...
+│   ├── 关系.md                # 角色关系映射
+│   ├── 题材定位.md            # 题材核心梗+对标分析+终局底牌/升级台阶（防写无可写）
+│   └── 题材正文提示卡.md       # 题材正文核心：边界/期待/爽点/节奏/禁漂移
+├── 大纲/
+│   ├── 大纲.md                # 全书卷级结构
+│   ├── 卷纲_第一卷.md         # 每卷一个：对标结构坐标+剧情单元+情绪弧线(含章节定位)+人物弧线+伏笔+反转
+│   └── 细纲_第001章.md        # 每章一个：章节定位+事件+钩子(按章节定位,章首/章尾/段落级)+爽点+悬念
+├── 正文/
+│   ├── 第001章_章名.md
+│   └── ...
+├── 对标/                          ← 拆文产出的结构化资产
+│   └── {对标书名}/
+│       ├── 原文/
+│       │   ├── 第001章_章名.md
+│       │   └── ...
+│       ├── 角色/                  ← 从拆文库/结构化输出同步
+│       │   └── {角色名}.md
+│       ├── 剧情/                  ← 从拆文库/结构化输出同步
+│       │   ├── {剧情单元名}.md
+│       │   ├── 故事线.md
+│       │   ├── 节奏.md             # 关键信息推进 + 情绪触动点 + 爆发节奏（权威节奏索引）
+│       │   └── 情绪模块.md         # 读者需求/情绪引擎 + 可复现模块（权威模块索引）
+│       ├── 设定/                  ← 从拆文库/结构化输出同步
+│       │   ├── 世界观/             ← 按主题拆分到子目录
+│       │   │   ├── 背景设定.md
+│       │   │   ├── 力量体系.md
+│       │   │   ├── 地理.md
+│       │   │   └── 金手指.md
+│       │   └── 势力/
+│       │       └── {势力名}.md
+│       └── 拆文报告.md
+├── 追踪/
+│   ├── _tracking-state.json        ← 唯一结构化权威状态
+│   ├── 上下文.md                  ← 派生续写状态卡（固定 7 栏），≤12KB
+│   ├── 逐章记录/第NNN章.md          ← 未来相关紧凑记录，≤3072 字节
+│   ├── 角色状态/{角色名}.md         ← 派生核心角色当前快照
+│   ├── 伏笔.md                    ← 派生伏笔当前视图
+│   └── 时间线/{作者真相.md,读者已知.md}
+├── 参考资料/
+│   └── {topic}.md             # story-researcher 输出的研究资料
+├── .story/work/第NNN章/        ← 本章临时文件（分组 segment、prompt 留档、事务 JSON），提交后自动删除
+```
+
+**产物映射表**（创建模板详见 [references/artifact-protocols.md](artifact-protocols.md)）：
+
+| 文件 | 粒度 | 创建阶段 | 读取时机 |
+|------|------|---------|---------|
+| 设定/关系.md | 全书 | Phase 2 | 按需：story-explorer relationship 查询、story-review 查设定（不在每章写作回路里逐章读） |
+| 设定/题材定位.md（含 `主对标书` 字段，多对标时必填） | 全书 | Phase 2 | Phase 3 大纲、每卷开始前、Phase 4 写前召回 |
+| 设定/题材正文提示卡.md | 全书/题材 | Phase 2（缺失则 Phase 4 写前即时生成） | Phase 4 每章写作前：按 `genre-prose-cards.md` 索引匹配后读取 `genre-prose-cards/` 目录对应单题材卡优先、`style-genre-modules.md` 通用模块兜底，与通用正文要求、情绪/节奏召回和文风一起组装 prompt |
+| 设定/角色/{角色名}.md、设定/势力/{名}.md | 角色/势力 | Phase 3 细纲后增量补全（首批含主角/主要角色） | Phase 4 状态筛选/写作 |
+| 设定/文风.md（自定义文风·优先级最高） | 本书 | 用户自写（Claude Code 可代写）；导入/拆解不覆盖 | Phase 4 每章写作前：含实质内容则取代对标文风作权威风格基 |
+| 对标/{书名}/文风.md | 对标书 | analyze Stage 6 输出 → story-import 显式绑定或本 skill 首次引用时同步 | Phase 4 每章写作前（文风召回；有自定义文风时降为参考/句长兜底） |
+| 大纲/卷纲_第X卷.md | 卷 | Phase 3 | **一律走取段器 `outline_view.py --unit/--contract/--toc`，不整读**（见「路径与术语约定」）；段位契约与 checker 见 artifact-protocols.md |
+| 追踪/_tracking-state.json | 全书 | 首次写正文前初始化（规划阶段不建） | 唯一结构化权威，不进正文 prompt；每章运行 `tracking_commit.py check` 读取章号和修订号 |
+| 追踪/伏笔.md | 全书当前视图 | 与 state 同时初始化 | 续写状态卡缺项时按 ID 定点查询；每 ID 只一行 |
+| 追踪/时间线/{作者真相.md,读者已知.md} | 全书当前事实/认知派生视图 | 与 state 同时初始化 | 按作者真相或读者认知的实际问题选择视图 |
+| 对标/{书名}/拆文报告.md | 对标书 | 用户手动+analyze | Phase 2 核心设定、Phase 3 大纲、Phase 4 写作 |
+| 追踪/逐章记录/第NNN章.md | 章 | Phase 4 每章事务 | 日更不读；目标 ≤1536 字节、硬上限 3072 字节，按需查询历史原因 |
+| 追踪/上下文.md（续写状态卡，≤12KB） | 全书当前状态 | 与 state 同时初始化 | 日更每章整份读；由事务工具整份重建，固定 7 栏 |
+| 参考资料/{topic}.md | 按需 | Phase 4（story-researcher 输出） | Phase 4 后续章节写作时复用 |
+| 追踪/角色状态/{角色名}.md | 核心角色 | 首次进入正文或导入初始化 | 久别角色按名读取一个小快照；目标 ≤4096 字节、硬上限 8192 字节；静态人设仍读 `设定/角色/` |
+| 对标/{书名}/角色/{角色名}.md | 对标书 | analyze 输出 | Phase 4 模块召回（角色参考） |
+| 对标/{书名}/剧情/{剧情单元名}.md | 对标书 | analyze 输出 | Phase 3 卷纲选段与细纲成批（剧情单元卡「对标剧情参照」）、Phase 4 模块召回（剧情模块参考） |
+| 对标/{书名}/剧情/情绪模块.md | 对标书 | analyze Stage 3 输出 → story-import 显式绑定或本 skill 首次引用时同步 | Phase 2 核心设定、Phase 3 大纲、Phase 4 每章写作前（读者需求 / 情绪引擎、可复现模块选择） |
+| 对标/{书名}/剧情/节奏.md | 对标书 | analyze Stage 3 输出 → story-import 显式绑定或本 skill 首次引用时同步 | Phase 3 大纲、Phase 4 每章写作前（关键信息推进、情绪触动点、爆发节奏参考） |
+| 对标/{书名}/设定/*.md | 对标书 | analyze 输出 | Phase 2 设定参考、Phase 4 世界观约束 |
+
+**缺失文件处理**：先按进度、报告总章数与逐章覆盖识别资料代际；当前契约缺项时显式修复，不拼装降级结果：
+1. **角色状态文件缺失** → 当前协议项目先运行 `tracking_commit.py check`，再重跑产生该状态的完整事务；已有正文但 `_tracking-state.json` 缺失时重新 `/story-import`。不得从前文临时推断后直接手写快照。
+2. **角色、普通剧情单元或设定等非主产物子目录缺失** → 按「对标书路径查找」查找项目视图与根目录数据源，仍缺失则跳过该可选模块。本条不适用于 `剧情/情绪模块.md` 和 `剧情/节奏.md`。
+3. **当前契约的 `剧情/情绪模块.md` / `剧情/节奏.md` 缺失** → 写前准备必须停下，设置 `missing_primary_contract: true` 并给出 `repair_action`：重跑 `/story-long-analyze` Stage 3+ 或重新 `/story-import`，不得用摘要文件假装已召回权威模块。
+4. **有对标书但 `文风.md` 缺失** → 若有 `设定/文风.md`（含实质内容）走自定义文风模式继续；否则日更文风召回 fail-fast，提示先运行 `/story-long-analyze` Stage 6 并 `/story-import` 同步。**完全无对标项目**则跳过文风召回、不阻塞（有 `设定/文风.md` 时用它写作）。情绪/节奏轴（`missing_primary_contract`）独立，自定义文风模式不豁免其 fail-fast。
+5. **伏笔/时间线文件缺失** → 视为当前语义检查点损坏，停止写正文；先运行 `tracking_commit.py check`，再用事务修复。卷纲/大纲中的计划不能代替已发生事实的当前检查点。
+6. **`设定/题材正文提示卡.md` 缺失** → 不阻塞；写前从 `设定/题材定位.md` 精确匹配 `references/genre-prose-cards.md` 索引，并只读取 `references/genre-prose-cards/` 中对应题材单卡（高/中/低置信照原卡标注），无命中再用 `references/style-genre-modules.md` 通用流派模块即时生成短 `genre_prose_card`。只有 `设定/题材定位.md` 也缺失时，退回细纲和目标平台做低置信题材卡，并在意图确认写明。
+
+**对标分析权威优先级（权威读取顺序）**：
+1. `剧情/情绪模块.md` 是读者需求 / 情绪引擎、爽文套路框架、可复现模块和重组指南的权威来源。
+2. `剧情/节奏.md` 是关键信息推进、章节扩写技法聚合、情绪触动点和爆发节奏的权威来源。
+3. `文风.md` 只管句长、标点、对话潜台词、原文锚点等风格；它不能覆盖情绪模块或节奏意图。**自定义文风 `设定/文风.md`（用户自写、不被导入/拆解覆盖）优先级高于对标 `文风.md`**：含实质内容时作权威风格基，对标文风降为参考与句长数值兜底；句长、停顿标点、视角与修辞按 `references/style-resolution.md` 裁决；段间空行等文件结构仍按交付协议，不把通用表达禁令称为硬安全线。
+4. `章节/第K章_摘要.md` 是具体章节证据，用来校验和补足权威索引，不反向覆盖 `情绪模块.md` / `节奏.md`。
+5. `拆文报告.md`、`剧情/故事线.md` 是投影/摘要；若与 `剧情/情绪模块.md` 或 `剧情/节奏.md` 冲突，写作以两个权威文件为准，并在写前准备 `gaps.conflict` 记录冲突来源。
+6. **公共灵感召回**（工作区有 `灵感库/` 时）按任务标签选 Top 3–8 张 active CBA；不传 IA/NM，不把灵感卡当风格样本；灵感卡只影响设计选择，与上述权威文件或细纲事实冲突时以后者为准。
+
+**文件组织原则：**
+- **人物一个一个文件**：`角色/角色名.md`，方便按需读取
+- **势力一个一个文件**：`势力/势力名.md`，组织/门派/家族/国家等
+- **世界观按主题拆分**：背景、力量体系、社会结构等各自独立
+- **细纲一章一个文件**：`细纲_第XXX章.md`，含钩子设计，与正文一一对应
+- **正文按章拆分**：每章一个文件，`第XXX章_章名.md`
+- 每章写完直接写入 `正文/` 目录，不要先输出到对话

package/lib/oh-story/skills/story-long-write/references/reader-contract-and-progression.md

@@ -1,15 +1,23 @@
 # 读者契约与终局储备
 
-本文件是 `story-long-write` 关于读者契约、主角代理权（叙事能动性/主导性）、利益安全与阶段推进的权威参考文件。相关洞察由授权社区样本提炼而来；样本多数是问题帖/避坑帖，属于非统计共识，也不能替代具体题材、平台和对标书判断。
+本文件是 `story-long-write` 关于读者契约、主角代理权（叙事能动性/主导性）、利益安全与阶段推进的权威参考文件。洞察来自授权社区的避坑样本，是经验共识，不替代具体题材、平台和对标书判断。
 
 **安全边界**：本文件不得包含来源站点隐私数据、访问凭证、cookies、tokens、请求签名、私有标识符，或任何能反推出私域账号/请求环境的信息。
 
+## 0. 契约四问（排纲、写正文、批末核对只用这四问）
+
+1. 主角是不是靠自己的选择挣到了结果？（因果权 + 结算权，拿不准过「关键节点四问」）
+2. 核心收益或高光有没有被配角、机构或巧合无交换地拿走？（期待所有权、利益安全）
+3. 有没有动用本阶段还不该解锁的终局底牌，或把某条升级线顶到天花板？（终局储备、透支两问）
+4. 旧期待付了利息没，又给读者留了什么期待？新地图、新机构、新谜团有没有被拿来逃避旧承诺？（期待债、换书债）
+
+四问都过＝契约安全；有一问勉强但能靠铺垫/交换/成本补上＝需补强；补不上＝契约破坏。答不上来的那问再读下面对应小节。
+
 ## 1. 核心概念
 
 ### 读者契约
 - 读者契约 = 开篇、题材、主角配置、叙事口吻共同许诺的阅读快感。
 - 写作前先确认：读者是来看主角解决问题、见证团队群像、看导师托举后辈，还是看制度合作建设？不同契约下同一情节风险不同。
-- 题材边界先于单条禁忌：政府、宗门总部、跨国组织、多国公司等高层级机构一出现，可能开启制度/势力范围情节线；先检查本书是否从开篇承诺了这种玩法。
 
 ### 主角代理权：因果权 + 结算权
 - 主角代理权首先看**因果权 + 结算权**，不看出场时长，也不要求主角永远亲自动手或垄断每个镜头。
@@ -23,7 +31,7 @@
 - 群像、导师或制度合作可把期待所有权明确给团队成员/学生/机构角色；关键是预先承诺、按约结算，而非事后解释抢戏合理。
 
 ### 关键节点四问
-大纲、正文与审查遇到关键节点时统一问；答案可以指向主角，也可以指向本卷已承诺的其他所有者，不要求主角亲自完成每个动作：
+第一问拿不准时逐条问（可指向本卷已承诺的其他所有者）：
 1. 谁决定事情为什么发生/如何进入？
 2. 谁作出不可替代的关键选择？
 3. 谁承担或选择关键后果？
@@ -57,7 +65,7 @@
 1. 是否动用了本阶段还不该解锁的终局底牌（宿敌了结、终极真相、身份终点、金手指触顶）？
 2. 是否让某条升级线逼近天花板、后面没台阶接？
 
-任一为“是” = 真正的透支预警 → 回退或改纲；两者皆否，多线齐涨放行。这套判定是经验法则，档位与里程碑按本书题材、平台与对标调整，不是硬门槛。
+任一为“是” = 真正的透支预警 → 回退或改纲；两者皆否，多线齐涨放行。档位与里程碑按本书题材、平台与对标调整，不是硬门槛。
 
 ### 合理化债务
 - 解释成本用于说明机构响应/接管、保密、资源调动、跨区执法、组织协作等为什么成立。

package/lib/oh-story/skills/story-long-write/references/reference-index.md

@@ -0,0 +1,86 @@
+# 长篇参考资料索引
+
+## 参考资料索引
+
+按场景加载 workflow，以下技法按需补充。
+
+### Phase 1：选题方向
+
+| 场景 | 加载文件 |
+|------|---------|
+| 确定题材类型 | `references/long-genre-catalog.md` |
+| 判断市场方向 | `references/genre-readers.md` |
+| 特殊题材考量 | `references/plot-special-topics.md` |
+| 女频长篇（题材/文案/平台/感情线） | `references/female-audience-writing.md` |
+
+### Phase 2：核心设定
+
+| 场景 | 加载文件 |
+|------|---------|
+| 设定人物 | `references/character-basics.md` |
+| 设计关系 | `references/character-relations.md` |
+| 题材框架与定位 | `references/long-genre-catalog.md` + `references/long-genre-mechanics.md` |
+| 创建 artifact | `references/artifact-protocols.md` |
+| 读者契约与主角高光 | `references/reader-contract-and-progression.md` |
+
+### Phase 3：大纲搭建
+
+| 场景 | 加载文件 |
+|------|---------|
+| 搭建大纲 | `references/outline-methods.md` |
+| 设计矛盾与结构 | `references/outline-conflict.md` |
+| 深度结构设计 | `references/outline-structure-theory.md` |
+| 节奏与升级感 | `references/outline-rhythm.md` |
+| 小纲与卡文 | `references/plot-core-methods.md` |
+| 选择叙事框架 | `references/plot-frameworks.md` |
+| 题材结构 | `references/genre-prose-cards.md` 索引 + `references/genre-prose-cards/` 单题材卡 |
+| 黄金三章 | `references/opening-design.md` |
+| 情绪弧线 | `references/emotional-arc-design.md` |
+| 契约/终局储备/剧情单元契约四问 | `references/reader-contract-and-progression.md` |
+| 反转设计 | `references/long-reversal.md` |
+| 细纲结构验收 | `scripts/check-outline-contract.js`（新建/补建后跑，只判字段与表结构） |
+
+### Phase 4：正文写作
+
+| 场景 | 加载文件 |
+|------|---------|
+| 章节钩子 | `references/long-chapter-hooks.md` |
+| 悬念设计 | `references/long-suspense.md` |
+| 题材正文提示卡 / 题材分类卡 | `references/genre-prose-cards.md` 索引 + `references/genre-prose-cards/` 单题材卡目录（按题材分类优先） + `references/style-genre-modules.md`（通用流派补充） |
+| 打斗/装逼 | `references/style-combat-face.md` |
+| 写作技法 | `references/style-craft.md` |
+| 商业创作核心方法 | `references/commercial-core-methods.md` |
+| 对话 | `references/dialogue-mastery.md` |
+| 人物深化 | `references/character-design-methods.md` |
+| 情绪技法 + 叙事单元 | `references/plot-emotion-system.md` + `references/emotional-methods.md` |
+| 写作技法全程参考 | `references/writing-craft.md` |
+| 格式 | `references/long-format.md`（章节、段落、对话、标点与工程元信息） |
+| 当前剧情单元与契约校准 | `references/reader-contract-and-progression.md` |
+
+### Phase 5：质量检查
+
+| 场景 | 加载文件 |
+|------|---------|
+| 质量检查 | `references/long-chapter-quality.md` + `references/reader-contract-and-progression.md` |
+| 禁用词扫描 | `references/banned-words.md` |
+| AI句式脚本复扫 | `scripts/check-ai-patterns.js` |
+| 去AI味 | `references/anti-ai-writing.md` |
+
+### 按主题快速定位（横切主题）
+
+有些主题横跨多个阶段、散在多个文件里。下表给每个主题一个**权威文件**（先读它，通常够用），配套文件只在需要那个角度时再加载。括号是该文件里对应的小节。
+
+| 主题 | 权威文件（先读） | 配套文件（按角度补充） |
+|------|-----------------|----------------------|
+| 爽点（按意图分流） | **`references/plot-emotion-system.md`**（爽点设计体系：本质/六种类型/倒推法——"怎么设计爽点"先读这个） | 翻盘/高潮式爽点→`references/plot-core-methods.md`（假胜→崩解）· 打脸/装逼释放→`references/style-combat-face.md`· 题材声线与长线约束→`references/genre-prose-cards.md`· 爽文循环/多层→`references/outline-methods.md`·`references/outline-conflict.md` |
+| 情绪模块 | **`对标/{书名}/剧情/情绪模块.md`（项目/书级权威）**；无对标或设计新模块时再读 `references/plot-emotion-system.md` | `references/outline-rhythm.md` 只作理论参考；不得覆盖对标书权威模块 |
+| 节奏 | **`对标/{书名}/剧情/节奏.md`（项目/书级权威）**；无对标或设计新节奏时再读 `references/outline-rhythm.md` | `references/plot-core-methods.md` 只作理论参考；不得覆盖对标书权威节奏 |
+| 高潮 | **`references/plot-core-methods.md`**（高潮构建公式：蓄能→假胜→崩解） | `references/outline-rhythm.md`（高潮分类与反推）· `references/outline-methods.md`（八节点故事结构：结构定位） |
+| 金手指 | **`references/plot-special-topics.md`**（金手指拆分理解与战力防崩 + 进阶设计） | `references/outline-conflict.md`（金手指与身份：四点统一） |
+| 感情线 | **`references/character-relations.md`**（好感度体系/四阶段 + 男女频差异） | `references/outline-conflict.md`（感情线设计）· `references/style-combat-face.md`（后宫文女主 / 男频极简爱情线构型）· `references/plot-special-topics.md`（爱情线提纯策略） |
+| 反转 | **`references/long-reversal.md`**（单元/卷级/全书反转、铺垫、有效性自检） | `references/plot-core-methods.md`（假胜：先给希望再击碎） |
+| 人物 | **`references/character-basics.md`**（主角/配角/反派/动机模板速填） | `references/character-design-methods.md`（三层标签反差/九维深化）· `references/character-relations.md`（关系类型/感情线） |
+| 女频写作 | **`references/female-audience-writing.md`**（女频长篇：核心原则/文案/题材/感情线长线/平台） | `references/genre-readers.md`（读者心理/平台差异）· `references/character-relations.md`（感情线总框架） |
+| 去AI味 | **`references/anti-ai-writing.md`**（AI指纹/核心规则/Show Don't Tell） | `references/banned-words.md`（禁用词扫描）· `references/long-chapter-quality.md`（成稿检查） |
+
+---

package/lib/oh-story/skills/story-long-write/references/style-combat-face.md

@@ -17,7 +17,7 @@
 | 写新媒体/短平快装逼 | 新媒体写作与题材套路 |
 | 搭建装逼舞台 | 舞台搭建法 |
 | 打脸写了但不爽 | 检查：爽点释放到位法则 + 前置小无敌准备了吗 + 对手层级够不够 |
-| 战斗场景枯燥/流水账 | 检查：战斗描写三板斧 + 情绪调动三阶法 + 缺少感官细节和身体反应 |
+| 战斗场景枯燥/流水账 | 检查：战斗描写三板斧 + 情绪调动三阶法 + 攻防选择、伤势和动作后果是否清楚 |
 
 ## 指令语气
 

package/lib/oh-story/skills/story-long-write/references/style-craft.md

@@ -17,7 +17,7 @@
 
 ## 指令语气
 
-本文件以"操作指令"语气书写。所有规则都是**必须遵守**的写作约束。遇到冲突时：镜头式写作法的规则 > 基础技巧 > 认知类参考。
+本文件是默认技法库，按 [style-resolution.md](style-resolution.md) 服从当前请求、本书文风和 active 作者偏好；镜头法、视角和句长建议不作跨文风验收线。
 
 ---
 
@@ -109,12 +109,12 @@
 
 ## 镜头式写作法
 
-忘掉全知视角，你是跟在主角身后的摄像机。读者只能看到主角看到的东西。
+采用限知镜头法时，跟随主角感知；本书选有限全知或多视角时按文风执行，不将授权的视角切换判错。
 
 ### 核心原则
-1. 只写能看到/听到/闻到/摸到的，不写"他心里想""他感到"
+1. 只写主角能看到/听到/闻到/摸到的，不切他人内心，不写作者解说
 2. 每句对话都要推进剧情、塑造人物、或传递信息
-3. 动作代替描述："他很紧张" -> "他的手在抖"
+3. 情绪可以直写；要补足信息时优先选择、台词、物件或后果，不默认换成身体动作
 4. 手机屏幕优先：按动作/信息变化换行，读起来卡时拆段；拆的是段落，叙述句仍以逗号长句为主（句长标准见 anti-ai-writing.md 规则 3）
 
 ### 高危清单
@@ -137,8 +137,7 @@
 
 | 禁用 | 替代 |
 |------|------|
-| 他感到紧张 | 他的手在抖 |
-| 她很伤心 | 她转过身，肩膀微微颤动 |
+| 他感到一阵悲伤（无落点） | 删掉，或写他此刻做不成的那件事 |
 | 高频公式化对话标签 | 用动作、语气或上下文承接；普通“说”可保留 |
 | 他深吸一口气 | 他把烟摁灭在烟灰缸里 |
 | 她眼中闪过一丝惊讶 | 她的手停在了半空 |
@@ -175,17 +174,9 @@
 ### 核心分类
 - **画面感**：人+环境（静/动），如高清摄像机忠实记录
 - **思想**：计划/目标/吐槽/揣测/分析等内心活动
-- **情绪**：藏在画面感与思想之中，不直接写出来
+- **情绪**：可直写，也可藏在画面与思想里；落地判断见 `writing-craft.md` 第 1 节
 - **旁白**：身世背景/设定/人物关系/回忆，尽可能简洁
 
-### 情绪表达层级（由低到高）
-1. 最低：直接写"xx愤怒/伤心/快乐"——告诉情绪，读者感受不到
-2. 低：用思想"xx暗骂"
-3. 中：用神态"xx脸色铁青"
-4. 高：用动作"xx猛地攥紧拳头，指甲掐进肉里"
-
-核心：离底层情绪越远的表达越高级 = 侧面描写。
-
 ### 环境交互（环境描写核心）
 没有交互的环境描写不值得写。
 - 物理交互：梨花飘到鼻尖打喷嚏 / 雪山瑟瑟发抖 / 河水洗脸
@@ -237,7 +228,7 @@
 
 ---
 
-## 文笔的本质与层级
+## 文笔的本质
 
 ### 三项输出检查
 - **选材**：目标读者、题材边界、核心卖点是否清楚。
@@ -246,17 +237,6 @@
 
 如果正文问题来自选材或剧情设计，不要只润色句子；回到对应 artifact 修正。
 
-### 表达情绪的层级（由低到高）
-
-| 层级 | 写法 |
-|------|------|
-| 最低 | 直接写"xx愤怒" |
-| 低 | 用思想"xx暗骂" |
-| 中 | 用神态"脸色铁青" |
-| 高 | 用动作"猛地攥紧拳头，指甲掐进肉里" |
-
-核心：不写情绪本身，写情绪引发的外在表现。
-
 ---
 
 ## 视角选择与叙事
@@ -336,12 +316,12 @@
 - [ ] **段落控制**：按动作/信息变化断段，读起来不卡
 - [ ] **高危词扫描**：少用"仿佛/犹如/一丝/不禁/眼中闪过/嘴角勾起"等模板化表达
 - [ ] **高危句式扫描**：公式化对话标签/"他感到"/"带着一丝XX"等不要过量
-- [ ] **情绪展示**：关键情绪节点没有直接写"他愤怒/伤心/紧张"，用动作/神态替代；低强度过场情绪允许一笔直写，不必处处外化
+- [ ] **情绪落地**：按 `writing-craft.md` 第 1 节检查，允许准确直写，不为情绪词强配动作或神态
 - [ ] **对话有效性**：每句对话至少推进剧情/塑造人物/制造张力之一
 - [ ] **五感调动**：每个场景至少调动2种以上感官
 - [ ] **环境交互**：环境描写有角色交互，不是空镜头
 - [ ] **镜头感**：每段有明确拍摄对象，远景/中景/近景/特写交替
 - [ ] **水分检查**：删掉任意一段后读者是否困惑——不困惑则该段多余
-- [ ] **视角一致**：没有全知叙述/上帝视角/心理分析混入
+- [ ] **视角一致**：符合本书选定的叙述姿态，没有未经授权的信息泄露
 - [ ] **节奏交替**：叙述默认是逗号长句（句长标准见 anti-ai-writing.md 规则 3），短句只作偶尔的孤立重拍、用完回到逗号长句；忌通篇同长度，也忌机械长短交替；快慢场景交替
 - [ ] **代入感**：主角目标清晰、行为可理解、叙事立场站在主角一侧

package/lib/oh-story/skills/story-long-write/references/style-genre-modules.md

@@ -166,7 +166,7 @@
 ### 关键技法
 - 恐惧要升级（不能一直同一个强度）
 - 限制信息来源（断电、断信号、独自一人）
-- 用生理反应代替直接描写恐惧
+- 恐惧可落在危险线索、选择和行动受阻上，也可直写；生理反应有实际作用时再用
 - 安全感的短暂回归让下一波恐怖更猛
 
 ---

package/lib/oh-story/skills/story-long-write/references/style-resolution.md

@@ -0,0 +1,27 @@
+# 文风与参考冲突裁决
+
+写正文、改写、去 AI 味和审稿都先做这一步；inline 与 agent 用同一份裁决。无需另建画像或要求作者填写配置。
+
+## 按维度取值，不把整份文件互相覆盖
+
+表达选择按以下顺序取第一个明确、适用的要求：**当前请求 > 本书文风/设定 > 本书 active 作者记忆 > 题材、流程、全局 active 记忆 > 主对标文风 > 题材包与通用 references 默认值**。未声明的维度才向下补齐；本书例外不撤销全局习惯，临时要求不写回长期记忆。
+
+句长、视角、标点、对话落法、情绪直写、修辞、叙述者评论和收尾方式都是表达维度。reference 中的“必须”“禁用”“最高优先级”、示例和检测阈值不使默认写法升级为作者不可覆盖的规则。主对标的低置信观察不压过作者的明确选择。
+
+事实与表达分开裁决：文风不能改变细纲事件、已知事实、信息揭露边界、用户字数范围、改写范围、文件结构或追踪协议；有限全知允许换视角，不等于可提前揭底。转限知时可暂不叙述该人物无从得知的信息，事实本身不变；不得补出“早已知道”“后来发现”或新观察经历来保全原文信息。审稿照常评价因果、可读性与情绪效果，不能仅因使用了作者选定的写法就判错，也不能因为作者喜欢就忽略真实缺陷。
+
+## 加载与传递
+
+1. 从本次正文路径确定书目录（长篇为 `正文/` 的父目录，短篇为 `正文.md` 所在目录）。读该书 `设定/文风.md`；短篇同时读 `设定.md` 的文风约定。无文件就继续，不创建占位文件、不猜其他书。文风无最低字数限制，一句可执行的偏好也有效；空白、纯标题、待补充不算。
+2. `_文风摘要.md` 只能辅助定位，不能独立替代全文。当前会话已读全文时无需反复读；摘要与全文不一致用全文，不让旧摘要压过作者的新修改。
+3. 作者记忆 query 显式传当前书名、已知题材和流程以及需要的 kind，避免只取到 global。只用 active；同一维度窄范围覆盖宽范围，不拼成同时满足的清单。无法判定的同范围冲突才问作者，已能按优先级解决的不询问。
+4. 在现有 prompt 填 `style_resolution`：本次生效的表达要求及来源、被覆盖的默认条款、必须保留的事实/信息边界；只列与任务有关的冲突，无冲突可写“按本书文风”。原样传给正文、去味和文字 reviewer，并传文风全文路径。同一批次复用，当前请求或文风变动时更新。单独调用去味/审稿也执行本步骤，不能靠上一次会话的记忆。
+
+## 检测器如何服从裁决
+
+检测器不理解作者意图。保留现有默认检查；明确采用且有功能的命中，复用**书目录**下的 `.deslop-whitelist`：UTF-8，一行一个原文字面片段，空行和以 `#` 开头的整行注释忽略，不支持正则或通配符。不向父目录找，避免跨书继承。
+
+- 本书文风明确允许某种停顿标点时，可登记 `——` 或 `……`；具体修辞登记完整的获准原句，不能登记“不是”“没有”等泛词来关闭整类检查。
+- 每项用上一行 `# 来源：…；用途：…` 说明当前请求或文风依据。只为执行作者已明确的选择登记，不因脚本报警自动放行。当前请求禁止某写法时移除相冲突的豁免；一次性保留只登记该句，不推断长期习惯。
+- 深扫、标点整理和写后/下一章检查读取同一白名单。豁免只影响对应字面片段的风格检查；同一行其他问题照报，事实、字数、占位、工程词、截断和文件结构检查不豁免。
+- 所选 Gate 仍执行：检查该写法是否重复、冗余、破坏节奏或越过信息边界；有这些具体问题才改。裁决与发现可简短写在正常交付报告中，不写进小说正文。

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

@@ -0,0 +1,31 @@
+# 追踪初始化事务
+
+## 初始化事务
+
+新书从第 0 章初始化。`story-import` 导入已有小说时把最后完整章写入 `last_chapter=N`；第 1..N 章不伪造日更记录，常规续写从 N+1 章开始。
+
+```json
+{
+  "schema_version": 1,
+  "book_title": "让你管账号，你高燃混剪炸全网",
+  "last_chapter": 0,
+  "context": {
+    "position": {
+      "volume": "第一卷·军宣整顿",
+      "volume_start_chapter": 1,
+      "story_time": "江晨到火箭军文工团报到前",
+      "scene": "火箭军文工团"
+    },
+    "long_term_constraints": ["军宣爽点要用作品效果和围观反应链兑现，不能只靠系统播报"],
+    "active_character_names": [],
+    "continuity_risks": [],
+    "recent_chapters": [],
+    "next_chapter_commitments": ["让江晨报到，并落下五天百万粉的新手任务"]
+  },
+  "character_snapshots": {},
+  "foreshadow": [],
+  "timeline_events": []
+}
+```
+
+导入初始化时直接传入当前核心角色快照、伏笔当前行、时间线事件和固定 7 栏状态输入。阶段/卷级回看按需查询正文，不作为每章强一致追踪产物。

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

@@ -18,24 +18,25 @@ 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 wordcount checkpoint --file {前半段临时文件} --target {目标} --chapter {N}
+{PYTHON} {当前 skill 根}/scripts/tracking_commit.py draft  --project {书项目根} --chapter {N}
 {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} {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 checkpoint`：纯测量；返回当前实际字数、用户带与剩余用户区间，不写正文、不写 tracking、不做语义判断。每章最多调用一次。
-- `chapter check`：重新读取当前正文与细纲目标，返回确定性长度状态、现有 blocking quality、`state_revision` 和当前可执行动作，不保存 approval。`under` 不提供自动补写；`over` 额外返回一次净删型 `compress-once` 及进入内带/用户带所需的机器删除区间。
+- `draft`：按当前 state 把逐章事务预填到 `.story/work/第NNN章/tracking.json`（修订号、模式、章名、`context` 四项当前值），并输出各文本字段的字数上限与在场核心角色的当前快照；调用方只填 `delta` 与有变化角色的快照。
+- `wordcount measure` / `wordcount checkpoint`：纯测量入口；不写正文、不写 tracking、不做语义判断。长篇正文只在前组写完后由父流程调用一次 `checkpoint`（见 workflow-chapter 步骤 6），整章长度由 `chapter check` 收口。
+- `chapter check`：重新读取当前正文与细纲目标，返回确定性长度状态、现有 blocking quality、`state_revision` 和当前可执行动作，不保存 approval。`under` 不提供自动补写；`over` 额外返回一次净删型 `compress-once` 及回到内部区间或作者给定区间所需的删除字数。
 - `chapter commit`：再次读取当前文件、重新计数并重跑 blocking quality；只接受用户带内章节，把简短字数记录与逐章事务一起原子提交。
 - `chapter accept-current-length`：只接受带外但 quality pass 的章节；接受动作发生时重新读取、重新计数并立即原子提交，不保存可陈旧的历史决议。
 - `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` 时由调用方删除）——之后 `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`——删掉那个手写文件后重跑原事务即可。
 
@@ -43,33 +44,7 @@ Markdown 只负责给作者和 Agent 阅读，工具不再反向解析 Markdown
 
 ## 初始化事务
 
-新书从第 0 章初始化。`story-import` 导入已有小说时把最后完整章写入 `last_chapter=N`；第 1..N 章不伪造日更记录，常规续写从 N+1 章开始。
-
-```json
-{
-  "schema_version": 1,
-  "book_title": "让你管账号，你高燃混剪炸全网",
-  "last_chapter": 0,
-  "context": {
-    "position": {
-      "volume": "第一卷·军宣整顿",
-      "volume_start_chapter": 1,
-      "story_time": "江晨到火箭军文工团报到前",
-      "scene": "火箭军文工团"
-    },
-    "long_term_constraints": ["军宣爽点要用作品效果和围观反应链兑现，不能只靠系统播报"],
-    "active_character_names": [],
-    "continuity_risks": [],
-    "recent_chapters": [],
-    "next_chapter_commitments": ["让江晨报到，并落下五天百万粉的新手任务"]
-  },
-  "character_snapshots": {},
-  "foreshadow": [],
-  "timeline_events": []
-}
-```
-
-导入初始化时直接传入当前核心角色快照、伏笔当前行、时间线事件和固定 7 栏状态输入。阶段/卷级回看按需查询正文，不作为每章强一致追踪产物。
+仅新书或导入初始化时，执行 `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。