@oh-story/dsh 0.1.15 → 0.1.17

package/lib/oh-story/skills/story-setup/SKILL.md

@@ -1,16 +1,16 @@
 ---
 name: story-setup
-version: 1.3.2
+version: 1.3.4
 description: "网文写作工具集基础设施部署与检查。为 Claude Code / OpenCode / Codex / Google Antigravity / ZCode / OpenClaw / Reasonix 提供内置适配；Web AI / 通用 Agent 可走 skills + AGENTS.md 文件模式。触发方式：/story-setup、$story-setup、「准备写书」「帮我搭一下环境」「配置写作项目」「检查写作环境」。"
 metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudecode"}}
 ---
 # story-setup：网文写作工具集基础设施部署
 
-你是写作基础设施部署器。将网文写作工具集部署到用户项目目录：已适配的 CLI 走专用 hooks/agents/config；NarraFork、Web AI、自定义 Agent 等环境走通用文件模式。
+你负责把网文写作工具集部署到用户项目目录：已适配的 CLI 使用专用 hooks/agents/config；NarraFork、Web AI、自定义 Agent 等使用通用文件模式。
 
-**执行铁律：不覆盖用户已有配置，合并而非替换。**
+**保留用户配置；受管文件按清单更新，共同维护的文件按管理块合并。**
 
-作者第一次部署的顺序：判断当前宿主 → 确认项目根 → 按宿主部署 → 验收 → 告诉作者下一步。本文件只写各宿主通用的流程；每个宿主专属的部署清单、算法、校验和安装报告提示在各自的部署文件里，**只读本次目标宿主的那一份**（见 Phase 2）。
+作者第一次部署的顺序：判断当前宿主 → 确认项目根 → 按宿主部署 → 验收 → 告诉作者下一步。本文件写公共流程；各宿主的部署清单、算法、校验和报告提示见 Phase 2 对应文件，**只读本次目标宿主的那一份**。
 
 ## 选择模式
 
@@ -21,14 +21,14 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 ## Phase 1：判断宿主与项目
 
-**先自检参考目录**：以正在执行的本 `SKILL.md` 所在目录为准，列出与它同级的 `references/` 下的子目录，核对下面 9 个名字是否都在**且都非空**——`agent-references`、`templates`、`opencode`、`codex`、`antigravity`、`zcode`、`openclaw`、`reasonix`、`generic`；同级 `references/deploy-*.md`（8 份宿主部署文件）、`scripts/merge-claude-settings.py`、`scripts/merge-codex-hooks.py`、`scripts/merge-antigravity-hooks.py`、`scripts/generate-antigravity-agents.mjs`、`scripts/deploy-antigravity-skills.py` 与 `scripts/copy-path-safety.py` 也必须存在（宿主部署步骤、Claude/Codex/Antigravity hooks 合并、Antigravity Skills 物化与 agent 生成、递归复制安全检查依赖它们）。有缺即 skill 包没装全，**立即停止，不写任何部署文件**，报告里区分「缺目录」「目录为空」和「缺脚本或部署文件」，并给修复指令：「story-setup 参考资料包不完整，缺 {路径}。按你的安装方式重装 oh-story-claudecode（命令行装的重跑 `npx skills add zenstory-ai/oh-story-claudecode -y -g`，marketplace / Plugin Management 装的在面板里重装），再执行 /story-setup。」
+**先自检参考目录**：以正在执行的本 `SKILL.md` 所在目录为准，列出与它同级的 `references/` 下的子目录，核对下面 9 个名字是否都在**且都非空**——`agent-references`、`templates`、`opencode`、`codex`、`antigravity`、`zcode`、`openclaw`、`reasonix`、`generic`；同级 `references/deploy-*.md`（8 份宿主部署文件）、`scripts/merge-claude-settings.py`、`scripts/merge-codex-hooks.py`、`scripts/merge-antigravity-hooks.py`、`scripts/generate-antigravity-agents.mjs`、`scripts/deploy-antigravity-skills.py`、`scripts/merge-project-instructions.py` 与 `scripts/copy-path-safety.py` 也必须存在（宿主部署步骤、Claude/Codex/Antigravity hooks 合并、Antigravity Skills 物化与 agent 生成、项目指令合并、递归复制安全检查依赖它们）。有缺即 skill 包没装全，**立即停止，不写任何部署文件**，报告里区分「缺目录」「目录为空」和「缺脚本或部署文件」，并给修复指令：「story-setup 参考资料包不完整，缺 {路径}。按你的安装方式重装 oh-story-claudecode（命令行装的重跑 `npx skills add zenstory-ai/oh-story-claudecode -y -g`，marketplace / Plugin Management 装的在面板里重装），再执行 /story-setup。」
 
 > 判据是「有没有 `SKILL.md`」：只看正在执行的 `SKILL.md` 同级的 `references/`。项目内 `.claude/skills/story-setup/`、`.codex/skills/story-setup/` 和 OpenCode 的 `skills/story-setup/` 只有 `references/agent-references/`、不含 `SKILL.md`，不会是执行目录，也不要拿它们核对。Antigravity / ZCode / OpenClaw / Reasonix / generic 的项目副本是整份 skill 拷贝、自带 `SKILL.md`，9 个子目录本就齐全，照常核对即可。
 
 1. 检查当前目录是否已部署过（存在 `.story-deployed`）
-   - `agents_version` 缺失、非整数或小于 `34` → 标记为待更新，继续执行当前部署
-   - `agents_version: 34` → 使用 AskUserQuestion 确认是否重新部署；提示里写明重新部署只用**当前本地 skill 包**刷新项目文件，要拿 skill 本身的新版本得先更新 oh-story-claudecode（`npx skills add` 或 marketplace），再回来重跑
-   - `agents_version` 大于 `34` → 当前 story-setup 比项目部署旧；停止以避免降级覆盖，提示先更新 oh-story-claudecode，不写任何部署文件
+   - `agents_version` 缺失、非整数或小于 `36` → 标记为待更新，继续执行当前部署
+   - `agents_version: 36` → 使用 AskUserQuestion 确认是否重新部署；提示里写明重新部署只用**当前本地 skill 包**刷新项目文件，要拿 skill 本身的新版本得先更新 oh-story-claudecode（`npx skills add` 或 marketplace），再回来重跑
+   - `agents_version` 大于 `36` → 当前 story-setup 比项目部署旧；停止以避免降级覆盖，提示先更新 oh-story-claudecode，不写任何部署文件
    - 同时读 `target_cli` 字段。**已部署项目以 sentinel 里的值为准**：非空时（逗号分隔的多端组合原样保留）这些端照常重新部署，不再让作者选；第 4 步仍判断当前宿主：判断出来且不在其中（作者换了软件）→ AskUserQuestion 问「这个文件夹之前是给 {已部署宿主名} 装的，你现在用的是 {当前宿主名}，要一起装上吗？」（「一起装上（推荐）」「只更新原来的」），选前者就加进 `target_cli`；判断不出不问。字段缺失或为空才走第 4-6 步。用户明确要求增删目标端时，用 AskUserQuestion 在现有值基础上改，改完的值写回 sentinel。
    - `target_cli` 不含 opencode、但项目里有 `.opencode/plugins/story-hooks.ts` 或 `.opencode/agents/`（多端部署时 OpenCode 曾被版本门拦下）→ 用 AskUserQuestion 问是否把 OpenCode 加回来；选加回则先过 [references/deploy-opencode.md](references/deploy-opencode.md) 的「部署前置」，通过后写回 `target_cli`
 2. 检查是否有书名目录（包含 `追踪/` 子目录的目录，或用户自定义结构）
@@ -48,6 +48,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
    - `openclaw.json`、`.openclaw/`，或 `AGENTS.md` 中的 OpenClaw 段（标题行含 `网文写作工具集（OpenClaw）`）→ `target_cli = openclaw`
    - `.reasonix/`、`reasonix-plugin.json`、`REASONIX.md`，或 `AGENTS.md` 中的 Reasonix 段（标题行含 `网文写作工具集（Reasonix）`）→ `target_cli = reasonix`
    - `AGENTS.md` 中的通用段（标题行含 `网文写作工具集（通用 Agent / Web AI）`）→ `target_cli = generic`
+   - `CLAUDE.md` / `AGENTS.md` 里的 `<!-- oh-story:{宿主} 开始` 管理块 → `target_cli` 含该宿主
 
    > 后三类只认各端**互斥**的标记：`skills/*/SKILL.md` 的 `metadata.openclaw` 不作 OpenClaw 信号（13 个 skill 都带，三条 skills-only 路径部署出的 `skills/` 一样）；`.agents/skills/` 由 Antigravity、Codex 与 Reasonix 共用，也不单独作准。
 6. 定下 `target_cli`：
@@ -59,9 +60,9 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 ## Phase 2：部署基础设施
 
-整个 Phase 2 幂等：目录复制、文件写入和各宿主部署文件里的合并算法重复执行结果一致。因环境原因（工具不可用、权限被拒、网络失败）中途失败时，直接从头重跑本 Phase，不需要先清理半成品；`create only if absent` 的用户状态文件（见各部署清单的 Owner class）不会被二次覆盖。
+Phase 2 幂等：复制、写入与各宿主合并重复执行结果一致。受管目录中只覆盖 oh-story 自己的 13 个 skill、7 个助手、hook 与规则文件，保留同目录里作者自己的文件；不覆盖书稿、设定、大纲、追踪和 `.active-book`。工具、权限或网络问题中断后，从头重跑即可，不另清理半成品；`create only if absent` 的用户状态文件（见清单 Owner class）不会被覆盖。
 
-**两列基准目录不同**：部署清单里 `Source path` 相对正在执行的这份 skill 包，`Target path` 相对用户项目根。执行每一行（以及各宿主部署算法里的每个递归复制步骤）之前，先把通配符具体化为单个源/目标，再用本 `SKILL.md` 同级的 `scripts/copy-path-safety.py` 检查。该脚本按 `Path.resolve` / `realpath` 语义跟随已有 symlink，并在两侧都存在时用 `samefile` 核对文件系统对象；**只转绝对路径或比较字符串不算检查完成**。读取其 JSON：`status: same` 时 no-op，禁止复制；仅 `copy_allowed: true` 时可以复制；`source_missing`、`unsafe_target_within_source` 或 `filesystem_identity_error` 必须停止该步骤并报告。无法运行脚本时只能用当前环境的文件系统 API 做完全相同的 canonical realpath、same-object 与 target-descendant 检查；无法确认就停止，不得尝试复制。OpenClaw / Reasonix / generic 的项目副本是整份 skill 拷贝，重跑时执行的就是项目里那份；Reasonix / Codex 还可能经 `.agents/skills → ../skills` symlink 加载，路径文本不同也可能指向同一目录，照字面复制会把目录嵌进自身并撑满磁盘。
+**两列基准目录不同**：`Source path` 是包内来源，story-setup 内的路径以当前 `SKILL.md` 所在目录定位；`Target path` 相对用户项目根。执行每一行（以及各宿主部署算法里的每个递归复制步骤）之前，先把通配符具体化为单个源/目标，再用本 `SKILL.md` 同级的 `scripts/copy-path-safety.py` 检查。该脚本按 `Path.resolve` / `realpath` 语义跟随已有 symlink，并在两侧都存在时用 `samefile` 核对文件系统对象；**只转绝对路径或比较字符串不算检查完成**。读取其 JSON：`status: same` 时 no-op，禁止复制；仅 `copy_allowed: true` 时可以复制；`source_missing`、`unsafe_target_within_source` 或 `filesystem_identity_error` 必须停止该步骤并报告。无法运行脚本时只能用当前环境的文件系统 API 做完全相同的 canonical realpath、same-object 与 target-descendant 检查；无法确认就停止，不得尝试复制。OpenClaw / Reasonix / generic 的项目副本是整份 skill 拷贝，重跑时执行的就是项目里那份；Reasonix / Codex 还可能经 `.agents/skills → ../skills` symlink 加载，路径文本不同也可能指向同一目录，照字面复制会把目录嵌进自身并撑满磁盘。
 
 **部署前清理自嵌套残留**：`{.claude,.codex,.zcode}/skills/story-setup/references/agent-references/` 与项目根 `skills/story-setup/references/agent-references/` 里若多出 `agent-references/` 层（可能嵌了多层），以及 `skills/story-setup/skills/`，整段删掉再部署，并在安装报告里列出删掉的路径。
 
@@ -80,23 +81,22 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 | `reasonix` | [references/deploy-reasonix.md](references/deploy-reasonix.md) |
 | `generic` | [references/deploy-generic.md](references/deploy-generic.md) |
 
-多端部署时几个宿主共用根 `AGENTS.md`，按下方「AGENTS.md 合并策略」合并成一份；某一端被自己的前置条件拦下（如 OpenCode 版本门、Antigravity 缺 Node）时，按该端部署文件的规定处理，其他端照常部署。
+多端部署时几个宿主共用根 `AGENTS.md`，各占一个管理块（见下方「项目指令合并」）；某一端被自己的前置条件拦下（如 OpenCode 版本门、Antigravity 缺 Node）时，按该端部署文件的规定处理，其他端照常部署。
 
 ### Step 2：创建部署标记
 
-- 创建 `.story-deployed` 文件（sentinel file）
+- 仅为本次成功部署的目标创建或更新 `.story-deployed`（sentinel file）；全部目标停止时保留旧标记，不创建新标记。
 - 写入以下字段（YAML `key: value` 格式，hook 用 `references/templates/hooks/lib/sentinel.sh` 读取）：
   ```
   deployed_at: <date -u +"%Y-%m-%dT%H:%M:%SZ">
-  agents_version: 34
-  setup_skill_version: 1.3.2
+  agents_version: 36
+  setup_skill_version: 1.3.4
   target_cli: claude-code（或 opencode、codex、antigravity、zcode、openclaw、reasonix、generic，或其任意组合）
   resolver_strategy: project-local-skill-reference
   references_dir: .claude/skills/story-setup/references/agent-references（Codex 写 .codex/skills/...；Antigravity 写 .agents/skills/...；ZCode 写 .zcode/skills/...；OpenCode / OpenClaw / Reasonix / generic 写 skills/...；多端用逗号分隔）
   ```
 - 此文件供 session-start.sh 和写作 skill 检测部署状态，避免重复提示
 - 宿主部署文件里「部署标记补充」要求的额外标记一并创建（如 Claude Code 的重启确认标记）
-- 如果 `.story-deployed` 已存在但 `agents_version` 缺失、非整数或小于 `34`，按本次流程更新 hooks/agents/rules/reference bundle（具体变更见 `UPGRADING.md`）；大于 `34` 时已在 Phase 1 停止，不得降级覆盖
 
 ## Phase 3：验证安装
 
@@ -104,7 +104,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 1. 对 `target_cli` 里的每个宿主，执行其部署文件的「验证」一节。
 2. 验证部署标记：
-   - 检查 `.story-deployed` 是否存在且包含时间戳、`agents_version: 34`、`setup_skill_version: 1.3.2`、`target_cli`、`resolver_strategy`、`references_dir`
+   - 检查 `.story-deployed` 存在，字段齐全，版本号与 Step 2 的字段块一致
 3. 输出安装报告。读者是不懂编程的作者，按这个顺序写：
    - **先写「现在可以做什么」**：用写书的话列本次部署后真正可用的事（如「可以开新书、续写：说 /story-long-write」「可以拆一本对标书」），端的限制如实翻译（如「这个工具里审稿由我一个人完成，没有分工助手」）。
    - **再写「你还需要做的事」**：逐条可照做，如「新开一个会话」「在 Codex 里打开 /hooks，把 oh-story 的几条信任一下」「先安装 Node」；没有就写「无需其他操作」。这两段不出现脚本名、字段名、状态名或文件路径；各宿主部署文件「安装报告必须提示」的内容先翻译进这两段。
@@ -114,30 +114,23 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 ## 模板占位符
 
-| 占位符 | 替换规则 | 示例 |
-|--------|----------|------|
-| `{项目名}` | 用户项目名称或目录名 | 《剑来》、《暗卫》 |
-| `{书名}` | 书名目录名（与目录一致） | 与 `{项目名}` 相同，或用户自定义 |
-| `{目标平台}` | 目标发布平台 | 起点、番茄、晋江、知乎盐言 |
-| `{作者名}` | 用户笔名或昵称 | 未指定时用「作者」 |
+只替换 `{项目名}`：用作者给的书名或项目名，没给就用当前目录名，去掉花括号。模板里其余花括号写法（如 `{书名}/正文/`）表示「任意一本书的目录」，原样保留。
 
-替换时去掉花括号。如果用户未指定项目名，用当前目录名。未指定的占位符保留原样不替换。CLAUDE.md 的合并策略在 Claude Code 部署文件里。
+## 项目指令合并（CLAUDE.md / AGENTS.md）
 
-## AGENTS.md 合并策略（OpenCode / Codex / ZCode / OpenClaw / Reasonix / generic）
+每个宿主在项目指令文件里占一个管理块：`<!-- oh-story:{宿主} 开始 … -->` 到 `<!-- oh-story:{宿主} 结束 -->`，块里是渲染后的模板；Claude Code 写 `CLAUDE.md`，其余宿主共用根 `AGENTS.md`。按 `python3` → `python` → `py` 的顺序探测出可用的 Python 记为 `PYBIN`，运行：
 
-用户已有 AGENTS.md 时，按 marker/section 合并：
-1. 优先识别 story-setup 管理块标记（如果旧项目已有标记，只替换标记内内容）
-2. 无标记时，读取用户现有 AGENTS.md，按 `##` 标题切分为 section map
-3. OpenCode 使用 `skills/story-setup/references/opencode/AGENTS.md.tmpl`；Codex 使用 `skills/story-setup/references/codex/AGENTS.md.tmpl`；ZCode 使用 `skills/story-setup/references/zcode/AGENTS.md.tmpl`；OpenClaw 使用 `skills/story-setup/references/openclaw/AGENTS.md.tmpl`；Reasonix 使用 `skills/story-setup/references/reasonix/AGENTS.md.tmpl`；通用 Web AI / 其他 Agent 使用 `skills/story-setup/references/generic/AGENTS.md.tmpl`
-4. 模板中的标准 section（Skill 路由表、文件结构、协作规则、与作者协作、Compact 后恢复上下文；模板有而用户文件没有的 section 直接补入）覆盖同名 section；用户独有 section 保留
-5. 多端同时部署时，Codex/OpenCode/ZCode/OpenClaw/Reasonix/generic 共同可用的通用段落只保留一份；工具特有说明以小节区分，避免互相覆盖
+```text
+"$PYBIN" "{story-setup skill目录}/scripts/merge-project-instructions.py" --host {宿主} --template {该宿主模板} --existing {项目指令文件} --output {项目指令文件} --project-name {项目名}
+```
 
-## 重新部署
+规则（无法运行脚本时照此手工合并）：
+1. 文件不存在或为空 → 只写这一块。
+2. 已有本宿主的块 → 整块替换；块外文字和别的宿主的块一字不动。
+3. 没有本宿主的块、但块外有旧版「网文写作工具集」标题行（旧部署）→ 删掉本宿主的旧标题行、引言及与模板同名的节（含已退役的「协作规则」；「Skill 路由表」「文件结构」「写作约束」只在内容带 oh-story 痕迹时才删），在原位置写入这一块；作者自己的节保留在块外。已有别的宿主的块、块外没有旧标题行时，只删本宿主独有的节（如「Codex 项目约定」）。
+4. 以上都不是 → 把这一块追加到文件末尾。
 
-- `.story-deployed` 不存在 → 全新安装，Phase 2 全部执行
-- `.story-deployed` 存在且 `agents_version: 34` → 提示已部署，AskUserQuestion 确认是否重新部署；提示里写明重新部署只用当前本地 skill 包刷新项目文件，skill 本身的更新走 `npx skills add` 或 marketplace
-- `.story-deployed` 存在但 `agents_version` 缺失、非整数或小于 `34` → 提示需要更新，重新执行 Phase 2 覆盖 agents/hooks/rules/reference bundle，CLAUDE.md / AGENTS.md / settings.local.json / .codex/hooks.json / `.agents/hooks.json` / .zcode/config.json 走合并策略
-- `.story-deployed` 存在且 `agents_version` 大于 `34` → 当前 skill 版本过旧，停止并提示先更新 oh-story-claudecode；不覆盖项目中的更新部署
+把脚本输出的旧节名写进安装报告的「部署明细」。
 
 ---
 
@@ -147,7 +140,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 |------|------|
 | references/deploy-*.md | 8 份宿主部署文件：各自的部署清单、算法、验证与安装报告提示，按 Phase 2 Step 1 只读目标宿主那份 |
 | [references/diagnostics.md](references/diagnostics.md) | 仅检查模式 |
-| UPGRADING.md | 各版本升级要点 |
+| UPGRADING.md | 写给作者：各版本要不要重跑、哪些旧数据要迁移 |
 
 ---
 

package/lib/oh-story/skills/story-setup/references/agent-references/agent-quality.md

@@ -1,6 +1,6 @@
 # Agent 通用质量核心
 
-> 只放长篇与短篇都成立的判断。审查时必须再按 `agent-reference-profiles.md` 加载当前 profile 的质量覆盖文件；本文件不提供篇幅、密度或揭示位置阈值。
+> 本文件提供跨体裁判断；审查时必须按 `agent-reference-profiles.md` 加载当前 profile 的质量覆盖，篇幅、密度和揭示位置由该 profile 判断。
 
 ## 叙事单元推进
 
@@ -15,7 +15,7 @@
 - [ ] 每个场景有目标、阻碍和结束后的状态变化。
 - [ ] 设定跟着行动、冲突或证据出现，没有连续说明文。
 - [ ] 人物在选择、行动或承受后果，不是连续几段重复感觉同一情绪。
-- [ ] 新概念数量与当前场景的理解负荷匹配；必要概念给可验证的使用边界。
+- [ ] 新概念数量与当前场景的理解负荷匹配；必要概念交代可核对的适用条件。
 
 ## 语言与格式
 
@@ -26,7 +26,7 @@
 
 ## 五维评分
 
-每个维度 0–100 分。分数必须附证据和失败影响，不凭整体印象打分。
+每个维度 0–100 分，须附证据及问题影响，不凭整体印象打分。
 
 ### 核心一致度
 

package/lib/oh-story/skills/story-setup/references/agent-references/agent-reference-profiles.md

@@ -1,6 +1,6 @@
 # Agent 参考资料 Profile 契约
 
-> 本文件是 story-architect 的唯一资料清单。story-architect 自身只描述任务能力，不复制文件清单。每次任务选择 `long` 或 `short` 后，只能加载 `Common + 当前 profile`；表外文件即使存在也不读取。其他 agent 按各自模板的参考表读取，只用本文件的 long / short 选择规则和质量覆盖表。
+> 本文件是 story-architect 的唯一资料清单，agent 模板不重复列出。任务包未覆盖的问题选择 `long` 或 `short` 后，只加载 `Common + 当前 profile`；不自行加读表外文件，表内索引点名的题材卡按索引读取。其他 agent 按自身模板读取，沿用这里的 long / short 选择规则和质量覆盖。
 
 ## 选择规则
 
@@ -17,21 +17,21 @@
 |---|---|
 | [agent-quality.md](agent-quality.md) | 审查、评分或交付前检查；只提供跨体裁质量核心，必须同时加载当前 profile 的质量覆盖 |
 | [genre-readers.md](genre-readers.md) | 判断目标读者、平台与期待 |
-| [emotional-arc-design.md](emotional-arc-design.md) | 设计或审查情绪弧线、期待管理与兑现 |
-| [plot-core-methods.md](plot-core-methods.md) | 卡文、剧情循环失效、五步高潮、过渡或日纲缺推进；short 只取与总篇幅兼容的方法 |
+| [plot-core-methods.md](plot-core-methods.md) | 排或审细纲、小节大纲：目标情绪与主角选择、爽点六类、高潮构建、过渡章、开篇噱头；short 只取与总篇幅兼容的方法 |
 
 ## Long profile
 
 | 文件 | 读取条件 |
 |---|---|
-| [long-genre-catalog.md](long-genre-catalog.md) | 长篇题材定位或框架速查 |
-| [long-genre-mechanics.md](long-genre-mechanics.md) | 提炼长篇核心梗、循环机制、事业线或金手指 |
+| [long-genre-catalog.md](long-genre-catalog.md) | 长篇男频题材定位或框架速查 |
+| [female-audience-writing.md](female-audience-writing.md) | 女频长篇的题材框架、读者需求与简介；女频只读本文件，不读题材目录 |
+| [long-genre-mechanics.md](long-genre-mechanics.md) | 提炼长篇核心梗、设计金手指或微创新 |
 | [genre-prose-cards.md](genre-prose-cards.md) | 确定长篇题材声线与长线约束 |
-| [outline-methods.md](outline-methods.md) | 建大纲、卷纲或章节蓝图 |
-| [outline-conflict.md](outline-conflict.md) | 主支线、AB 线与冲突结构 |
-| [outline-rhythm.md](outline-rhythm.md) | 连载节奏、升级感与跨章兑现 |
-| [opening-design.md](opening-design.md) | 新书开篇或黄金三章 |
-| [long-emotional-methods.md](long-emotional-methods.md) | 设计跨章剧情单元的情绪发动机与兑现链 |
+| [character-relations.md](character-relations.md) | 本书有感情线：只读「感情线阶段」 |
+| [outline-methods.md](outline-methods.md) | 讨论或审查卷结构：读「卷纲排法」；没有主对标再读「八节点故事结构」，有自创单元读「情绪模块公式」，换地图读「换地图」 |
+| [opening-design.md](opening-design.md) | 新书开篇或前 3 章细纲：只读「开篇规划」 |
+| [emotional-arc-design.md](emotional-arc-design.md) | 设计或审查卷、剧情单元的情绪弧线：只读「六种弧线速查」 |
+| [long-emotional-methods.md](long-emotional-methods.md) | 设计感情桥段：三板斧、拉扯节奏与失败模式 |
 | [long-chapter-hooks.md](long-chapter-hooks.md) | 设计章首/章尾与跨章期待，不采用固定百字配额 |
 | [long-suspense.md](long-suspense.md) | 编排短期、中期、远期悬念与回收周期 |
 | [long-reversal.md](long-reversal.md) | 设计单元、卷级或全书反转，不采用全文百分比铁律 |
@@ -44,12 +44,10 @@ Long profile 禁止读取 `short-*` 文件，不得采用“6 章”“每节 50
 | 文件 | 读取条件 |
 |---|---|
 | [short-genre-formulas.md](short-genre-formulas.md) | 需要短篇题材结构骨架时 |
-| [short-paragraph-hooks.md](short-paragraph-hooks.md) | 设计段落留存、付费断点与小节内钩子 |
-| [short-chapter-hooks.md](short-chapter-hooks.md) | 设计节首/节尾钩子与高密度接力 |
-| [short-emotional-methods.md](short-emotional-methods.md) | 设计单篇内的羁绊、撕裂、拉扯与余韵 |
-| [short-suspense.md](short-suspense.md) | 编排主悬念、副悬念、节间钩子和全文回收 |
-| [short-reversal.md](short-reversal.md) | 设计短篇线索、误导、揭示位置与两层反转 |
+| [short-chapter-hooks.md](short-chapter-hooks.md) | 设计节尾、节首、段落钩子、付费断点与全文悬念 |
+| [short-emotional-methods.md](short-emotional-methods.md) | 设计单篇内的羁绊、撕裂、拉扯与余韵，选整篇弧线与转折位置 |
+| [short-reversal.md](short-reversal.md) | 设计短篇线索、误导与揭示；两层反转按所选方案使用 |
 | [short-quality.md](short-quality.md) | 审查全文密度、付费点、反转证据链和结尾兑现 |
 
-Short profile 禁止读取 `long-*`、`outline-*`、`opening-design.md` 或 `genre-prose-cards.md`；不得把卷级、日更或跨十几章指标当硬门槛。
+Short profile 禁止读取 `long-*`、`outline-*`、`opening-design.md`、`emotional-arc-design.md`、`female-audience-writing.md` 或 `genre-prose-cards.md`；不得把卷级、日更或跨十几章指标当硬门槛。
 

package/lib/oh-story/skills/story-setup/references/agent-references/banned-words.md

@@ -1,151 +1,61 @@
-# AI味禁用词与句式表
-
-> 表达默认值服从 [style-resolution.md](style-resolution.md)；文件结构与事实约束不豁免。
-
-<!-- 同名副本×6 字节同步，改动后跑 scripts/check-shared-files.sh -->
-
-## 默认优先检查的句式（先对照本书文风）
-
-写网文最毒的 AI 句式，作者一旦养成就会反复出现。以下是优先检查的句式：
-
-| 毒级 | 句式 | 错误例 | 修法 |
-|------|------|--------|------|
-| ★★★★★ | "不是A，（而）是B" / "不是A，不是B，（而）是C"（"而"可省略，省掉也算命中）| "他不是冷漠，而是绝望" | 直接写 B 或用更自然的表达 |
-| ★★★☆☆ | 跨段「不是A。/也不是B。/只是C。」 | 「不是嚎啕大哭。/也不是扯着嗓子喊不舍。/只是一个人走远了……」 | 语义复核；重复提纲或拖慢画面时压成 C，有辩解/悬念排除功能可保留 |
-| ★★★★ | "，带着……" 万能状语 | "他笑了一下，带着一丝不易察觉的嘲讽" | 删掉状语留主句，或换具体动作 |
-| ★★★★ | 无情绪声线："声音不大，却带着……" / "语气毫无波澜" / "平静无波" / "声音平直/平平/听不出情绪" | "她声音不大，却带着不容置疑的力量" | 直接写台词内容、声音特征或动作 |
-| ★★★★ | "他/她知道……" | "他知道这一切都来不及了" | 用行为展示认知 |
-| ★★★ | "仿佛/犹如/宛若……一般" | "仿佛能穿透一切一般" | 删掉或白描 |
-| ★★★ | "眼中闪过一丝……" / "嘴角勾起一抹……" | "眼中闪过一丝悲伤" | 删掉；写他当场说的话或做出的决定 |
-| ★★★ | "心中涌起一股……" / "心头一震" | "心中涌起一股暖流" | 写它改变了什么：选择、台词、物件或后果 |
-| ★★★ | 抽象命运/开端收束："命运……棋局/獠牙" / "这一刻终于明白" / "反击才刚刚开始" | "命运终于露出獠牙；属于他的反击才刚刚开始" | 回到角色当下可见的文件、动作、对话或物理后果 |
-| ★★ | 章末预告 "他不知道的是……" | "他不知道的是，更大的风暴即将来临" | 用具体钩子物件/事件收束，避免空泛预告 |
-
-> ★★★★★ 命中一处就要改；轻/中/重分档只按去 AI 味诊断的密度指标定。
-
-`check-ai-patterns.js` 的 `formulaic-parallelism` 还会提示「至于X不X，怎么X」和同动词「不V A，不V B」。这两类可能是功能性口语，因此只做 advisory；Gate B 必须连同台词读语境复核，若只是复述细纲/前文就压成一次判断，不能因 hook 豁免台词而跳过。
-
-**标点**：正文（含叙述和对话）禁用破折号 `——`/`—`、双连字符 `--` 和省略号停顿，改用句号、逗号、短句或动作断句；不设置对话破折号例外。盐言「」引号不在此列。
-
----
-
-## 一级禁用词（出现即替换）
-
-> 什么词进一级：只收真人语料里几乎不出现、AI 特有的词。真人高频使用的自然副词和虚词不进一级，走二级密度控制。
-
-### 情态类
-仿佛、犹如、宛若、如同、一丝、一抹、些许、几分、隐约、毫无征兆、几不可闻、微不可察
-
-### 动作类
-深吸一口气、不禁
-
-### 表情类
-眼中闪过、嘴角勾起、眉头微皱、眉眼低垂、瞳孔微缩、瞳孔收缩、瞳孔一缩、指节泛白、眼神锐利、目光锐利
-
-### 心理类
-心中一动、心头一震、心下了然、心中暗道、心底泛起、不由得、心中一凛
-
-### 判断类
-不容置疑、不容置喙、不易察觉、显而易见、毫无疑问、不可否认、前所未有
-
-### 形容类
-坚定、闪烁着光芒、狡黠、深邃、凛冽、冰冷
-
-### 过渡类
-不由自主、情不自禁、自然而然、话锋一转
-
-## 二级禁用词（高频出现时替换）
-
-### 语境敏感词（仅高频或偷懒时处理）
-突然、陡然、骤然、猛然、好像、似乎、瞬间、猛地、死死地（角色口语、真实突发、时间压缩、视角不确定时可保留；用同义变体轮换规避重复不算豁免，按同一个词计密度）
-
-### 弱化副词（密度控制）
-缓缓、微微、轻轻、淡淡（每千字合计 ≤3；这四个词同时计入 `cliche-density-tic` 的套词密度统计；孤立自然使用可保留，成串出现或每个动作都垫一个时才替换）
-
-### 书面腔 → 口语化
-
-| 书面腔 | 口语化替换 |
-|--------|-----------|
-| 瓦解 | 消失 / 散了 / 没了 |
-| 无名火 | 烦躁 |
-| 往我心上捅刀子 | 心烦意乱 |
-
-### 总结句式
-- "他/她终于明白..."
-- "他/她这才意识到..."
-- "这一刻，他/她终于明白/意识到..."
-- "从这一刻开始..."
-- "属于X的反击/复仇/故事，才刚刚开始"
-- "命运/宿命 + 齿轮/棋局/獠牙/改写/安排"
-- "此刻，他/她..."
-- "一切...都..."
-- "原来..."
-
-### 排比句式
-- 连续3句以上相同结构的排比
-- "有的...有的...有的..."
-- "一边...一边...一边..."
-
-### 升华句式
-- "这一刻..."
-- "他知道..."
-- "她明白..."
-- "这就是..."
-
-## 禁用句式模板
-
-| 句式 | 示例 | 问题 |
-|------|------|------|
-| "不是A，而是B" | "他不是冷漠，而是绝望" | 最毒；直接写 B |
-| "...，带着..." | "他说，带着一丝无奈" | 万能状语 |
-| "声音不大，却带着……" | "她声音不大，却带着不容置疑的力量" | AI 最爱声音描写 |
-| "仿佛能...一般" | "仿佛能穿透一切一般" | 文言腔 |
-| 对话标签密度过高/公式化标签 | "好的，他说道" | 普通"说"可保留；高频或公式化时处理 |
-| "他/她感到..." | "她感到一丝失落" | 告诉而非展示 |
-| "他/她意识到..." | "他意识到事情不对" | 直接告知 |
-| "眼中闪过一丝XX" | "眼中闪过一丝悲伤" | 模板化 |
-| "嘴角勾起一抹XX" | "嘴角勾起一抹冷笑" | 模板化 |
-| "心中涌起一股XX" | "心中涌起一股暖流" | 模板化 |
-| "取而代之的是" | "笑容消失，取而代之的是冰冷" | AI 过渡模板；直接写新状态 |
-| "淬了/淬着X" | "眼里淬了毒" | AI 通感套路；写动作或台词 |
-| "显得（有些）X" | "他显得有些兴奋" | 告诉而非展示 |
-| "心底/心里某个地方+软" | "心里某个地方软得一塌糊涂" | 言情套句；写动作 |
-| "（浑身）散发着一股X气息/气场" | "浑身散发着一股生人勿近的气息" | 万能气场描写；写旁人的反应 |
-| "命运/宿命 + 齿轮/棋局/獠牙/改写/安排" | "命运终于露出獠牙" / "早已布好的棋局" | 抽象作者总结；改成角色当下撞见的文件、动作、对话、物理后果 |
-| "这一刻终于明白/从这一刻开始/才刚刚开始" | "这一刻，他终于明白" / "反击才刚刚开始" | AI 收束腔；删总结，用动作或未解决问题收尾 |
-
-## 比喻分类（默认复核，不默认全删）
-
-带"像/如/仿佛/犹如/宛若"的比喻不是一律 AI。真正高风险的是：成片堆叠、套用万能文学比喻、用精致比喻替代剧情推进，或在段尾替读者总结意义。本表用于识别需要复核的比喻类型：
-
-| 比喻类别 | 例 | 处理 |
-|---------|----|------|
-| 生活/角色化 | "像一头被抛弃的野狗" | 若贴角色视角、能传递信息或情绪，可保留 |
-| 物品/现象类 | "像一把刀" "脸色惨白得像这漫天的雪" | 普通功能性比喻可留；模板化或重复时改白描 |
-| 状态类（陈词滥调） | "梨花带雨" "如沐春风" | 优先删或改成具体动作/表情 |
-| 抽象类 | "像命运的齿轮" "像上辈子的尘埃" | 高风险，优先落回动作、物件、声音、后果 |
-| 假设类 | "力道大得像是要把骨头捏碎" | 若是角色身体感知可留；夸张堆叠时改事实后果 |
-
-处理原则：先看功能，再看密度。保留最能传递信息或情绪的一两个，其余改为直接描述、动词、名词、作用、结果或事实；不要把删掉的比喻替换成另一批新比喻。例 "脸色惨白得像这漫天的雪" 若只是套话 → "脸色惨白"；若雪景正在压迫角色，可保留或改成角色当下看到的具体画面。
-
-> `metaphor-density-tic` 是 advisory：提示通读复核，不是 blocking；生活化、角色化、单个有功能的比喻可以保留。
-
-## 替换策略速查
-
-| 原文类型 | 替换方法 | 示例 |
-|----------|----------|------|
-| 抽象情绪词 | 先看上下文是否已成立；再选选择、台词、物件、后果或一句直写 | “紧张”若不影响下一步可直写或删；若导致签名作废，就写作废的结果 |
-| "感到XX" | 删除“感到”后按场景决定是否还要情绪句 | “他感到愤怒”可写“他火了”，也可直接写他撤回报价；不要默认换成攥拳 |
-| 形容词堆砌 | 白描手法 | "美丽动人的笑容" → "她笑了" |
-| 书面表达 | 口语化 | "不容置疑" → "就是" |
-| 解释性描写 | 留白 | "他因为害怕而..." → "他退后一步" |
-| 连续排比 | 保留最强一条 | 3 句排比留 1 句 |
-| 总结升华句 | 直接删除 | "这一刻，她终于明白了..." → 删 |
-| "不是A，而是B" | 直接写 B 或更自然的表达 | "他不是冷漠，而是绝望" → 直接写 B |
-| 多余修饰（形容词/定语/量词/指示代词） | 删 | "白色的药片" → "药片"；"手里那截链子" → "链子"；"飞驰的汽车" → "车" |
-
-**替换不复用**：右列是方向示例，不是标准答案。同一禁用词在一章内多次命中时，各处给不同的具体化写法；同一个替换写法反复出现（每次都「垂下眼」、每个动作都补「了一下」），替换产物本身就成为新的模板指纹。
-
-**套词密度优先处理**：`check-ai-patterns.js` 报 `cliche-density-tic` 时，说明禁用词不是零星误用，而是聚成了模板腔。处理顺序不是同义词替换，而是先删抽象总结，再把情绪/判断落到角色当下可见的动作、物件、对话和具体后果。
-
-**套式反应逐处删除测试**：`stock-reaction-tic` 报警时，不代表禁止身体描写。逐处问：删掉后信息、选择、关系、物件或动作结果是否受损？无损就删，不把“指尖轻叩”换成“目光微沉”。伤势、动作失败、人物习惯或情节后果明确时可以保留。
+# AI 味词句信号索引
+
+> 这里列的是需回到上下文判断的信号，不是出现即错的禁词。表达服从 [style-resolution.md](style-resolution.md)；不据词频判断作者身份，不以清零为目标。具体修法由调用方加载的方法文件承担。
+
+## 句式与组织信号
+
+| 信号 | 可检索形式 | 需确认的语义问题 |
+|---|---|---|
+| 否定翻转 | 不是 A，（而）是 B；不是 A，不是 B，（而）是 C／只是 C；没有 X，没有 Y，只有 Z | 是否先否定无人在意的靶子，再宣布结论？纠错、辩解和排除猜测也可能需要对比 |
+| 工整并列 | 跨段“不是／也不是／只是”；有的……有的……；一边……一边……；至于 X 不 X，怎么 X；不 V A，不 V B | 是否重复同一意思或照抄提纲字段？排比也可承担递进与人物声线 |
+| 万能状语、声线 | ，带着……／带着一丝……；声音不大，却带着……；语气毫无波澜；平静无波；声音平直／平平／听不出情绪；平静得像在念…… | 是否只贴抽象态度，没有可辨的说话内容或声音信息？ |
+| 引号强调 | “机会”“答案”“蜕变”等普通词反复加引号 | 是否虚造术语或替读者划重点？引用、代号、场内消息与反讽另判 |
+| 解释结论链 | 这意味着；真正重要的是；之所以……是因为；正是因为；由此可见；他／她终于明白；他／她这才意识到；此刻，他／她……；这是最好的选择；所有人都会记住这一刻 | 是否重复读者已得到的意思，或把必要过程概括掉？ |
+| 意义膨胀、万能结论 | 意义深远；可谓；未来可期；前途无量；充满希望；一切……都……；这就是…… | 是否只扩大分量、宣布前景，没有具体影响或下一步？ |
+| 抽象收束、预告 | 命运／宿命／注定＋齿轮／棋局／獠牙／改写／安排；这一刻终于明白；从这一刻开始；属于 X 的反击／复仇／故事才刚刚开始；他／她不知道的是；殊不知；多年以后；冥冥之中；仿佛预示着 | 是否只宣告分量，或越过本次揭露边界？回顾、全知与题材承诺按文风判断 |
+| 隐性盖章、点破潜台词 | 关切得恰到好处；笑得恰如其分；不多不少；那点笑她看得分明；谁都看得出他在撒谎；演得真好；这出戏她看过一遍；他就是这样薄情的人；像在宣判一件早已定好的事；像看一件死物 | 是否替读者把伪装、潜台词或人物性质提前判定？区分角色带偏见的认识与叙述者断言 |
+| 告知与气场模板 | 他／她知道……；他／她感到……；他／她意识到……；显得（有些）X；淬了／淬着 X；心底／心里某个地方＋软；（浑身）散发着一股 X 气息／气场 | 是否只贴感受与人物标签？准确直写、有来源的认知和角色特有感受可留 |
+| 电报体、动作清单 | 连续孤立短句；抬手、取过、放下、转身；动作后反复“了下／了一下” | 是否丢失动作方向、对象和连接，或把无关步骤全部拍出？ |
+| 论述腔、公文腔 | 不难看出、事实上、综上所述、于是乎、与此同时、因而、然而、此刻、机制、结构、逻辑、体系、基于、当前、进一步、深入、推进、落实、从而、诚然、不得、须、未、已然 | 是否与人物、年代和载体语域不合，或每段都先总结再解释？公告、规则和职业表达可有意采用 |
+
+## 套词与套式反应信号
+
+以下组合在跨场景机械复现、成片堆叠或只替情绪贴标签时优先复核；孤立出现不判错。
+
+| 类别 | 检索词例 |
+|---|---|
+| 弱化与装饰 | 微微、淡淡、缓缓、轻轻、一丝、一抹、些许、几分、隐约、微不可察、几不可闻、毫无征兆 |
+| 通用反应 | 深吸一口气、不禁、眼中闪过、嘴角勾起、嘴角微扬、脸色一变、眉头微皱、眉眼低垂、瞳孔微缩、瞳孔收缩、瞳孔一缩、指节泛白、指尖轻叩、攥紧袖口、袖口里攥紧、目光移开、眼神锐利、目光锐利、目光如炬、头皮发紧、眼皮一跳、心口一沉、胃里翻涌 |
+| 通用心理 | 心头一震、心中一动、心下了然、心中暗道、心底泛起、心中一凛、不由得、心中涌起一股暖流、心中涌起一股难以名状的情感、心里某个地方软得一塌糊涂 |
+| 空泛定性 | 不容置疑、不容置喙、不易察觉、显而易见、毫无疑问、不可否认、前所未有、坚定、闪烁着光芒、狡黠、深邃、凛冽、冰冷、散发着一股生人勿近的气息 |
+| 模板比喻 | 仿佛／犹如／宛若……一般；仿佛、犹如、宛若、宛如、如同、如潮水般、像潮水般、如闪电般、仿佛春风、犹如疾风骤雨、仿佛能穿透一切一般、像命运的齿轮、像上辈子的尘埃、像在宣判、眼里淬了毒、梨花带雨、如沐春风 |
+| 自动过渡与书面表达 | 映入眼帘、只见、此时此刻、不由自主、情不自禁、自然而然、话锋一转、取而代之的是、瓦解、无名火、往我心上捅刀子 |
+| 语境敏感词 | 突然、陡然、骤然、猛然、瞬间、猛地、死死地、好像、似乎；沉声道、淡淡地说；扯了下、停了一下、拍了两下、松了半圈 |
+
+“她感到”“意识到”“知道”“原来”可以准确表达感受、判断和发现；“仿佛／好像／似乎”可以限定视角置信度；“坚定／冰冷／深邃”可以是准确描述。“突然／瞬间／猛地”也可能承担真实突发或时间压缩。只凭这些词不能认定告知式心理、模板比喻或偷懒。
+
+## 复合样本
+
+例句展示组合风险，不是合格与不合格的标准答案；判断及改法仍按三层方法，不能照例句新增动作、改变人物态度或一律拆短。
+
+| 观察对象 | 例句或模板 | 回到语境核对 |
+|---|---|---|
+| 否定、状语与声线 | “他不是冷漠，而是绝望”“他笑了一下，带着一丝不易察觉的嘲讽”“他说，带着一丝无奈”“她声音不大，却带着不容置疑的力量”“好的，他说道” | 对比是否有纠错对象，状语与标签是否机械复现；普通“说”不用替换成动作 |
+| 跨段铺排与预告 | “不是嚎啕大哭。／也不是扯着嗓子喊不舍。／只是一个人走远了……”“他不知道的是，更大的风暴即将来临”“命运终于露出獠牙；属于他的反击才刚刚开始”“早已布好的棋局” | 是否反复铺垫同一意思、空泛宣告或越过揭露边界；排除猜测与题材承诺另判 |
+| 告知、反应与过渡 | “他知道这一切都来不及了”“她感到一丝失落”“他感到愤怒”“他意识到事情不对”“眼中闪过一丝悲伤”“嘴角勾起一抹冷笑”“他显得有些兴奋”“浑身散发着一股生人勿近的气息”“笑容消失，取而代之的是冰冷” | 判断是否需要直写，反应与新状态是否已经由上下文表达 |
+| 反复呈现同一瞬间 | “林父低着头，左手把文书压住，右手拿笔，往纸上落。”／“手从肘到腕都在抖。”／“笔尖在纸上停了停，写了一横，又停。那个"林"字的撇写歪了。” | 多段是否反复重拍同一动作；手抖、落笔失败也可能是必要体验，不能只留动作梗概 |
+| 场景氛围 | “阳光透过窗帘的缝隙洒进来，在地板上投下斑驳的光影。空气中弥漫着淡淡的花香，仿佛整个世界都沉浸在一片宁静祥和的氛围中。” | 景物是否与此刻行动、视角或情绪有关，还是可移到任意场景 |
+| 天气套写 | “天空阴沉沉的，乌云密布，仿佛随时都会下起倾盆大雨。凛冽的寒风呼啸而过，带着一丝刺骨的寒意。” | 是否叠加同一寒冷、阴沉信息；天气也可能改变行动条件 |
+| 打斗套写 | “他的拳头犹如疾风骤雨般猛烈，每一击都蕴含着不容置疑的力量。对手的瞳孔微微收缩，显然没有预料到如此凌厉的攻势。” | 力量与反应是否只被定性，攻防过程、失误与后果是否缺失 |
+| 哲理、翻页与感慨收尾 | “他站在窗前，望着远方的天际线，终于明白了生活的真谛：有时候，放手才是最好的选择。”“这一刻，一切都变了。她知道，从今以后，她的人生将翻开崭新的一页。”“这一夜，注定无人入眠”“人生就是这样……”“岁月如流水般悄然流逝……” | 是否重复总结，或确实呈现本书允许的新认识、时间变化与余韵 |
+| 修饰、排比与意义尾巴 | “他看着她的眼睛，看着她的嘴唇，看着她微微颤动的睫毛，心中涌起一股难以名状的情感。”“当他终于推开那扇沉重的木门时，映入眼帘的是一间昏暗的房间，空气中弥漫着陈旧的气息，墙角堆满了落满灰尘的箱子。”“她喜欢春天的花朵，喜欢夏天的阳光，喜欢秋天的落叶，喜欢冬天的白雪。每一个季节都有它独特的美。” | 信息是否重复，末句是否替读者点题；不要因长句、修饰或排比形式本身删掉有效感受 |
+| 温和请求、完整解释与笼统反应 | “我觉得你这样做不太合适，能不能考虑一下我的感受？”“其实我这样做是有原因的，因为当时的情况非常复杂……”“所有人都震惊了，不敢相信自己的耳朵。”“她很害怕，不知道该怎么办，只能等着事情过去。” | 是否所有人都用同一套说法，关键交锋或选择是否被概括；不能把请求改辱骂、解释改挑衅，或凭空补锁门、录音与群体动作 |
+| 比喻的功能边界 | “像一头被抛弃的野狗”“像一把刀”“脸色惨白得像这漫天的雪”“力道大得像是要把骨头捏碎” | 生活化、物品、环境与身体感知比喻均可能有效；看是否传递角色特有信息，不按类别全删 |
+| 二修伪自然 | “手里拿着刀，他冲了上去”；连续“伸手拿起、取过、挑开、放下、转身”；强加口误、脏话、每句换行或对话占比 | 一次伴随动作前置不等于油腻；检查是否机械套用另一种句法、流程或格式 |
+| 替换的误改风险 | “美丽动人的笑容”“白色的药片”“手里那截链子”“飞驰的汽车”“他因为害怕而……”；垂下眼、目光微沉、攥拳 | 修饰、指示与原因可能承担区分、承接或动作条件；不能仅为去词删成信息残缺，也不能把每个情绪词换成同一微动作 |
+
+## 使用边界
+
+脚本提示只供定位，不能替代语义结论。是否构成问题、如何修复及获准保留，由本次方法与文风裁决确定。
+
+标点、句长、段落疏密和对话占比均不在此设置统一指标。不通过同义词轮换、错误用字、英文点省略号或机械补动作规避提示。

package/lib/oh-story/skills/story-setup/references/agent-references/benchmark-style-load.md

@@ -4,7 +4,7 @@
 
 ## 流程
 
-加载对标书的情绪模块 + 节奏索引 + 文风 + 按本章情绪/基调匹配可参考章节 + 原文锚点片段。
+加载对标书的情绪模块、节奏索引和文风，按本章情绪/基调选择参考章与原文锚点片段。
 
 1. **解析输入**：项目目录 + 本章情绪/基调 + （可选）本章爽点类型 + （可选）本章目标字数
 2. **主对标书选择**：
@@ -15,10 +15,10 @@
    - **登记的主对标按步骤 3 探不到书目录**（目录下探不到任何文件）→ 返回 `gaps.benchmark_book_missing: true` 与 `expected_path`（原样写入实际探测的完整路径，供核对拼写），`results` 置空**停止**；不得改用其他书，也不得走下面的缺失回退。**书目录存在但缺 `文风.md` 不属于本情形**——照常进入步骤 4-6，由步骤 6 归类为 `profile_missing`
    - 若字段缺失或已忽略 → `Glob 对标/*/**/*`，从命中文件所属的书目录（`对标/` 下的第一层目录，排除当前作品）取字典序第一个，并在 `gaps.main_benchmark_unspecified: true` 提示主对标书未指定；**枚举条件是书目录下有文件，不是有 `文风.md`**——缺文风但资料完整的候选仍算命中
    - 若排除后无命中，继续向上找工作区根下的 `拆文库/*/**/*`，同样排除当前作品；仍无 → 返回 `gaps.no_benchmark: true`，`results` 置空，**不报错、不继续读文风**
-3. **对标书路径查找（只判书目录有效性，不判文风）**：优先探 `{项目}/对标/{书名}/**/*`，回退探 `拆文库/{书名}/**/*`（向上找到工作区根，再下钻拆文库）；探针是目录下的任意文件——Glob 不接受纯目录模式，`{书名}/` 恒返回空。任一处命中文件即视为书目录有效，进入步骤 4；两处都无命中才是 `benchmark_book_missing`。**不得用 `文风.md` 兼作目录存在性探针**——那会把「书在但缺文风」误判成「书不存在」，吞掉步骤 6 的 `profile_missing` 与调用方的 `custom_style` 降级分支
+3. **对标书路径查找（只判书目录有效性，不判文风）**：优先探 `{项目}/对标/{书名}/**/*`，回退探 `拆文库/{书名}/**/*`（向上找到工作区根，再下钻拆文库）；探针是目录下的任意文件——Glob 不接受纯目录模式，`{书名}/` 恒返回空。任一处命中文件即视为书目录有效，进入步骤 4；两处都无命中才是 `benchmark_book_missing`。**不得用 `文风.md` 兼作目录存在性探针**，缺文风由步骤 6 返回 `profile_missing`，调用方再按 `custom_style` 处理
 4. **主产物探针与资料代际**：
    - 先探 `{对标书路径}/剧情/情绪模块.md` 和 `{对标书路径}/剧情/节奏.md`，两者都存在才进入当前权威召回。
-   - 任一未命中时直接按下面两项返回并停止准备；`schema_version` 不参与新旧判断。两份老权威产物都存在时正常召回，缺少因果、双时间线或三维节奏等新增内嵌字段不阻断。
+   - 任一未命中时直接按下面两项返回并停止准备；`schema_version` 不参与新旧判断。两份主产物都存在时正常召回，缺少因果、双时间线或三维节奏等新增内嵌字段不阻断。
    - 缺 `剧情/情绪模块.md` → `gaps.missing_primary_contract: true`、`gaps.module_missing: true`，`repair_action` 写“重跑 /story-long-analyze Stage 3，补齐情绪模块”。
    - 缺 `剧情/节奏.md` → `gaps.missing_primary_contract: true`、`gaps.rhythm_missing: true`，`repair_action` 写“重跑 /story-long-analyze Stage 3，补齐节奏索引”。
 5. **当前权威召回**：
@@ -31,11 +31,11 @@
    - 检查「生成记录」里的 `文风可用：否` → 返回 `gaps.profile_degenerate: true`，后续不把文风作为强约束
 7. **可用性检查（只读可执行）**：
    - 本 agent 只有 `Read/Glob/Grep`，不能调用 Bash/stat。
-   - 只读取文风文件「生成记录」：若写有 `文风可用：否`、`需重生`、`原文缺失` 等标记 → `gaps.profile_stale: true` 或 `gaps.profile_degenerate: true`，并在 `stale_reason` 写明原因。
-   - 不做文件时间比较；默认 `profile_stale: false`。
+   - 只读取文风文件「生成记录」：若明确写有 `文风可用：否` 或 `需重生` 等不可用标记 → `gaps.profile_stale: true` 或 `gaps.profile_degenerate: true`，并在 `stale_reason` 写明原因。
+   - 原文文件缺失但已有有效锚点时不据此判不可用。不做文件时间比较；没有明确过期说明时 `profile_stale: false`。
 8. **章节基调候选集**：
    - `Glob {对标书路径}/章节/*_摘要.md`
-   - 对每个文件 `Grep -hE '基调：(紧张|轻松|悲伤|热血|爽|甜|温馨|恐怖|压抑|其他)'`（**全角冒号**，不锚定行首）拿到该章所有情节点基调
+   - 用 Grep 工具按正则检索每个文件（下式是检索条件，不执行 shell）`Grep -hE '基调：(紧张|轻松|悲伤|热血|爽|甜|温馨|恐怖|压抑|其他)'`（**全角冒号**，不锚定行首）拿到该章所有情节点基调
    - 章基调聚合：众数；并列时按 grep 输出顺序取最早
    - 候选集 = 章基调 == 本章情绪/基调的章节列表
 9. **相近基调兜底**（完全没有同基调章节时）：
@@ -44,7 +44,7 @@
    - 仍空 → `gaps.tone_match_failed: true`，跳过匹配章节读取，但仍返回整书文风、`selected_emotion_module` 和 `rhythm_reference`。
 10. **多候选章节选择规则**（候选集多章时）：
    - L1 爽点类型最强匹配（调用方提供爽点字段时，对每个候选章读 `_摘要.md` 的「关键事件」判断）
-   - L2 摘要情节点数 / 可读到的原文章节估算长度最接近本章目标字数（如提供）；本 agent 不用 Bash 统计，拿不到原文长度时跳过 L2，不得把摘要文件字数当原文字数
+   - L2 可读到的原文章节长度最接近本章目标字数（如提供）；本 agent 不用 Bash 统计，只用索引或已有资料注明的原文章长，拿不到时跳过 L2，不用情节点数或摘要字数代替
    - L3 章节号最小
 11. **读匹配章节资料**：
    - 先 `Read {对标书路径}/章节/第K章_摘要.md`，提取本章基调序列、关键事件、爽点/情绪节点
@@ -56,11 +56,11 @@
     - 从文风文件 `## 原文锚点片段` 段读出所有按基调标注的片段
     - 按本章情绪/基调选 1-2 段（精确匹配优先，无则取相近基调）
     - 完整传递 300-500 字原文（不要截断/概括）
-13. **返回结构化 JSON**
+13. **返回结构化 JSON**：`source_files` 只列本次实际读取的文件，示例路径按本次来源替换
 
 ## 缺失即停与降级
 
-- 缺两个老权威主产物（`剧情/情绪模块.md`、`剧情/节奏.md`）时返回 `missing_primary_contract` 与 `repair_action`，停止准备。
+- 两份主产物（`剧情/情绪模块.md`、`剧情/节奏.md`）中任一缺失时，返回 `missing_primary_contract` 与 `repair_action`，停止准备。
 - 登记的主对标书目录探不到时返回 `benchmark_book_missing` 与 `expected_path`，不换书。
 - 书目录在、缺 `文风.md` 归 `profile_missing`，由调用方按 `custom_style` 决定继续或停止。
 
@@ -72,7 +72,7 @@
   "results": {
     "style_profile_path": "对标/{书名}/文风.md",
     "style_profile_summary": "<≤200字 提取核心：标点习惯 + 对话技法 + 情绪交替模式>",
-    "selected_emotion_module": "<从 剧情/情绪模块.md 选出的读者需求/触发器/戏剧单元/可复现骨架；缺失时为 null>",
+    "selected_emotion_module": "<从 剧情/情绪模块.md 选出的读者想看什么/情绪链/戏剧单元/可替换项/不可照搬；缺失时为 null>",
     "rhythm_reference": "<从 剧情/节奏.md 选出的关键信息推进/情绪触动点/爆发节奏/冷却参考；缺失时为 null>",
     "module_source_path": "对标/{书名}/剧情/情绪模块.md",
     "rhythm_source_path": "对标/{书名}/剧情/节奏.md",