@oh-story/dsh 0.1.16 → 0.1.17

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

@@ -1,6 +1,6 @@
 ---
 name: story-setup
-version: 1.3.3
+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"}}
 ---
@@ -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` 缺失、非整数或小于 `35` → 标记为待更新，继续执行当前部署
-   - `agents_version: 35` → 使用 AskUserQuestion 确认是否重新部署；提示里写明重新部署只用**当前本地 skill 包**刷新项目文件，要拿 skill 本身的新版本得先更新 oh-story-claudecode（`npx skills add` 或 marketplace），再回来重跑
-   - `agents_version` 大于 `35` → 当前 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,7 +60,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 ## Phase 2：部署基础设施
 
-Phase 2 幂等：复制、写入与各宿主合并重复执行结果一致。工具、权限或网络问题中断后，从头重跑即可，不另清理半成品；`create only if absent` 的用户状态文件（见清单 Owner class）不会被覆盖。
+Phase 2 幂等：复制、写入与各宿主合并重复执行结果一致。受管目录中只覆盖 oh-story 自己的 13 个 skill、7 个助手、hook 与规则文件，保留同目录里作者自己的文件；不覆盖书稿、设定、大纲、追踪和 `.active-book`。工具、权限或网络问题中断后，从头重跑即可，不另清理半成品；`create only if absent` 的用户状态文件（见清单 Owner class）不会被覆盖。
 
 **两列基准目录不同**：`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 加载，路径文本不同也可能指向同一目录，照字面复制会把目录嵌进自身并撑满磁盘。
 
@@ -80,7 +81,7 @@ Phase 2 幂等：复制、写入与各宿主合并重复执行结果一致。工
 | `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：创建部署标记
 
@@ -88,15 +89,14 @@ Phase 2 幂等：复制、写入与各宿主合并重复执行结果一致。工
 - 写入以下字段（YAML `key: value` 格式，hook 用 `references/templates/hooks/lib/sentinel.sh` 读取）：
   ```
   deployed_at: <date -u +"%Y-%m-%dT%H:%M:%SZ">
-  agents_version: 35
-  setup_skill_version: 1.3.3
+  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` 缺失、非整数或小于 `35`，按本次流程更新 hooks/agents/rules/reference bundle（具体变更见 `UPGRADING.md`）；大于 `35` 时已在 Phase 1 停止，不得降级覆盖
 
 ## Phase 3：验证安装
 
@@ -104,7 +104,7 @@ Phase 2 幂等：复制、写入与各宿主合并重复执行结果一致。工
 
 1. 对 `target_cli` 里的每个宿主，执行其部署文件的「验证」一节。
 2. 验证部署标记：
-   - 检查 `.story-deployed` 是否存在且包含时间戳、`agents_version: 35`、`setup_skill_version: 1.3.3`、`target_cli`、`resolver_strategy`、`references_dir`
+   - 检查 `.story-deployed` 存在，字段齐全，版本号与 Step 2 的字段块一致
 3. 输出安装报告。读者是不懂编程的作者，按这个顺序写：
    - **先写「现在可以做什么」**：用写书的话列本次部署后真正可用的事（如「可以开新书、续写：说 /story-long-write」「可以拆一本对标书」），端的限制如实翻译（如「这个工具里审稿由我一个人完成，没有分工助手」）。
    - **再写「你还需要做的事」**：逐条可照做，如「新开一个会话」「在 Codex 里打开 /hooks，把 oh-story 的几条信任一下」「先安装 Node」；没有就写「无需其他操作」。这两段不出现脚本名、字段名、状态名或文件路径；各宿主部署文件「安装报告必须提示」的内容先翻译进这两段。
@@ -114,30 +114,23 @@ Phase 2 幂等：复制、写入与各宿主合并重复执行结果一致。工
 
 ## 模板占位符
 
-| 占位符 | 替换规则 | 示例 |
-|--------|----------|------|
-| `{项目名}` | 用户项目名称或目录名 | 《剑来》、《暗卫》 |
-| `{书名}` | 书名目录名（与目录一致） | 与 `{项目名}` 相同，或用户自定义 |
-| `{目标平台}` | 目标发布平台 | 起点、番茄、晋江、知乎盐言 |
-| `{作者名}` | 用户笔名或昵称 | 未指定时用「作者」 |
+只替换 `{项目名}`：用作者给的书名或项目名，没给就用当前目录名，去掉花括号。模板里其余花括号写法（如 `{书名}/正文/`）表示「任意一本书的目录」，原样保留。
 
-替换时去掉花括号。未指定项目名用当前目录名；其余先按表中默认值处理，没有默认值的占位符保留原样。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: 35` → 提示已部署，AskUserQuestion 确认是否重新部署；提示里写明重新部署只用当前本地 skill 包刷新项目文件，skill 本身的更新走 `npx skills add` 或 marketplace
-- `.story-deployed` 存在但 `agents_version` 缺失、非整数或小于 `35` → 提示需要更新，重新执行 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` 大于 `35` → 当前 skill 版本过旧，停止并提示先更新 oh-story-claudecode；不覆盖项目中的更新部署
+把脚本输出的旧节名写进安装报告的「部署明细」。
 
 ---
 
@@ -147,7 +140,7 @@ Phase 2 幂等：复制、写入与各宿主合并重复执行结果一致。工
 |------|------|
 | 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-reference-profiles.md

@@ -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,11 +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-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,8 +1,6 @@
 # AI 味词句信号索引
 
-> 保留 `banned-words.md` 文件名供调用方检索。这里列的是需回到上下文判断的信号，不是出现即错的禁词。表达服从 [style-resolution.md](style-resolution.md)；不据词频判断作者身份，不以清零为目标。具体修法由调用方加载的方法文件承担。
-
-<!-- 共享副本由 scripts/shared-references.json 管理，改动后同步并跑 scripts/check-shared-files.sh -->
+> 这里列的是需回到上下文判断的信号，不是出现即错的禁词。表达服从 [style-resolution.md](style-resolution.md)；不据词频判断作者身份，不以清零为目标。具体修法由调用方加载的方法文件承担。
 
 ## 句式与组织信号
 
@@ -36,11 +34,11 @@
 
 “她感到”“意识到”“知道”“原来”可以准确表达感受、判断和发现；“仿佛／好像／似乎”可以限定视角置信度；“坚定／冰冷／深邃”可以是准确描述。“突然／瞬间／猛地”也可能承担真实突发或时间压缩。只凭这些词不能认定告知式心理、模板比喻或偷懒。
 
-## 历史句式与复合样本
+## 复合样本
 
-以下保留旧词表及完整指南中的识别语料。例句展示组合风险，不是合格与不合格的标准答案；判断及改法仍按三层方法，不能照旧示范新增动作、改变人物态度或一律拆短。
+例句展示组合风险，不是合格与不合格的标准答案；判断及改法仍按三层方法，不能照例句新增动作、改变人物态度或一律拆短。
 
-| 观察对象 | 旧例句或模板 | 回到语境核对 |
+| 观察对象 | 例句或模板 | 回到语境核对 |
 |---|---|---|
 | 否定、状语与声线 | “他不是冷漠，而是绝望”“他笑了一下，带着一丝不易察觉的嘲讽”“他说，带着一丝无奈”“她声音不大，却带着不容置疑的力量”“好的，他说道” | 对比是否有纠错对象，状语与标签是否机械复现；普通“说”不用替换成动作 |
 | 跨段铺排与预告 | “不是嚎啕大哭。／也不是扯着嗓子喊不舍。／只是一个人走远了……”“他不知道的是，更大的风暴即将来临”“命运终于露出獠牙；属于他的反击才刚刚开始”“早已布好的棋局” | 是否反复铺垫同一意思、空泛宣告或越过揭露边界；排除猜测与题材承诺另判 |
@@ -54,10 +52,10 @@
 | 温和请求、完整解释与笼统反应 | “我觉得你这样做不太合适，能不能考虑一下我的感受？”“其实我这样做是有原因的，因为当时的情况非常复杂……”“所有人都震惊了，不敢相信自己的耳朵。”“她很害怕，不知道该怎么办，只能等着事情过去。” | 是否所有人都用同一套说法，关键交锋或选择是否被概括；不能把请求改辱骂、解释改挑衅，或凭空补锁门、录音与群体动作 |
 | 比喻的功能边界 | “像一头被抛弃的野狗”“像一把刀”“脸色惨白得像这漫天的雪”“力道大得像是要把骨头捏碎” | 生活化、物品、环境与身体感知比喻均可能有效；看是否传递角色特有信息，不按类别全删 |
 | 二修伪自然 | “手里拿着刀，他冲了上去”；连续“伸手拿起、取过、挑开、放下、转身”；强加口误、脏话、每句换行或对话占比 | 一次伴随动作前置不等于油腻；检查是否机械套用另一种句法、流程或格式 |
-| 旧替换的误改风险 | “美丽动人的笑容”“白色的药片”“手里那截链子”“飞驰的汽车”“他因为害怕而……”；垂下眼、目光微沉、攥拳 | 修饰、指示与原因可能承担区分、承接或动作条件；不能仅为去词删成信息残缺，也不能把每个情绪词换成同一微动作 |
+| 替换的误改风险 | “美丽动人的笑容”“白色的药片”“手里那截链子”“飞驰的汽车”“他因为害怕而……”；垂下眼、目光微沉、攥拳 | 修饰、指示与原因可能承担区分、承接或动作条件；不能仅为去词删成信息残缺，也不能把每个情绪词换成同一微动作 |
 
-## 提示名称索引
+## 使用边界
 
-脚本提示供定位，不能替代语义结论。`formulaic-parallelism` 对应对比与并列，`quote-emphasis-tic` 对应引号强调；`cliche-density-tic`、`metaphor-density-tic` 对应套词与比喻聚集；`stock-reaction-tic`、`micro-action-tic`、`action-list-tic` 对应反应与动作；`abstract-summary-tic`、`reasoning-chain-tic` 对应总结解释；`overcompressed-prose-tic`、`low-connective-density-tic` 对应过度压缩；`system-notice-formality-tic` 对应载体语域。是否构成问题、如何修复及获准保留，由本次方法与文风裁决确定。
+脚本提示只供定位，不能替代语义结论。是否构成问题、如何修复及获准保留，由本次方法与文风裁决确定。
 
 标点、句长、段落疏密和对话占比均不在此设置统一指标。不通过同义词轮换、错误用字、英文点省略号或机械补动作规避提示。

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

@@ -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",

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

@@ -12,8 +12,8 @@
 | 配角 | 配角卡模板 | 第2节 |
 | 反派 | 反派层级表 → 反派建立四要素 → 反派性格四步法 | 第3节 |
 | 角色动机 | 动机链模板 → 动机冲突类型 | 第4节 |
-| 角色塑造/深化 | 塑造方法速查（四层法/执念法/重复点/分层展示等） | 第5节 |
-| 主角特殊问题 | 逼格/成长/红线/调子太高/身份与金手指 | 第6节 |
+| 角色塑造/深化 | 塑造方法速查（反差设计/配角用法/执念法/重复点等） | 第5节 |
+| 主角特殊问题 | 逼格/成长弧/红线/调子太高/开篇立人设/身份与金手指 | 第6节 |
 | 反派塑造深化 | 反派渲染/人设主角化 | 第7节 |
 
 ---
@@ -73,17 +73,17 @@
 
 ### 3.1 反派层级表
 
-根据反派出场篇幅选对应层级，按表格要求设计。
+按反派要撑多长的剧情选层级，按表格要求设计。
 
-#### 小反派（1-5 章）
+#### 小反派（一个剧情单元内解决）
 
 | 维度 | 要求 |
 |------|------|
-| 功能 | 单个小弧线的障碍 |
+| 功能 | 一个剧情单元的障碍 |
 | 设计 | 1-2 个鲜明特征即可（嚣张/贪财/欺软怕硬） |
 | 退场 | 被打败或被揭穿，干脆利落 |
 
-#### 中等反派（10-30 章）
+#### 中等反派（一卷的主对手）
 
 | 维度 | 要求 |
 |------|------|
@@ -171,6 +171,8 @@
 - 约束必须有力——否则主角一路碾压没有张力
 - 风险必须真实——读者要相信主角真的可能失去重要的东西
 - 动机可以随剧情演变，但不能说变就变
+- 起因从三处找：世界压迫（没实力就自保不了）、金手指带来的利益、亲友的遭遇
+- 外力动机之外再给一个内在梦想；目标要贴身份，宗门圣女想救宗门可信，杂役弟子想救宗门就缺说服力
 
 ### 4.3 动机冲突类型
 
@@ -199,56 +201,36 @@
 - 角色的行动 → 具体的动作和决定，不是形容词堆砌
 - 角色的态度 → 通过对话和反应体现，不是心理独白
 
-### 5.2 展示人物特质的方法
+### 5.2 反差设计
 
-| 方法 | 操作 | 示例 |
-|------|------|------|
-| 敏感性 | 触碰弱点，看反应方式 | 惊慌失措/匆忙逃跑/转移注意力=不同性格 |
-| 逃避 | 展现回避行为暗示弱点 | 角色的"不做什么"比"做了什么"更揭示深层性格 |
-| 先正后缺 | 先展示吸引人特质，再揭示缺陷 | 读者先喜欢角色，才能容忍缺陷 |
-
-### 5.3 四大性格属性
+给每个重要角色填三层标签，至少一层和另两层相反：
 
-| 属性类别 | 定义 | 设计要点 |
-|---------|------|---------|
-| 道德属性 | 是非信念 | 影响其他性格形成 |
-| 成就属性 | 推动达成目标 | 与道德属性一致，服务目标 |
-| 互动属性 | 与人交流方式 | 数量最多的积极特质 |
-| 身份属性 | 身份认同感 | 定义个性的基本组成部分 |
+| 层 | 含义 | 例 |
+|---|---|---|
+| 身份 | 外界看到的身份 | 豪门弃妇 |
+| 表现 | 他展现给外界的行为 | 被骂不还口，被赶不反抗 |
+| 内核 | 真实的打算和性格 | 悄悄录音、收证据、提前转走财产 |
 
-选择技巧：以其中一个特质为主要特质，其他为辅。
+- 反差用行为对照写出来，不靠旁白点明；内核留到关键抉择时亮出来，亮得越晚越震撼。
+- 找反差可以让外表、身份、爱好、性格两两错位：看着凶实际心软、杀手擅长插花、豪门子弟住地下室。
+- 主角和核心配角给一层强反差；功能性配角贴一两个标签就够，不强行立体。要保持神秘和压迫感的高手可以留扁平，写透来历和软处反而显弱。
+- 反差太大会劝退一部分读者，按本书读者口味控制尺度。
 
-### 5.4 角色塑造四层法
-
-| 层次 | 方法 |
-|------|------|
-| 移情作用 | 开头不要太多角色，先让读者了解主角并产生期待 |
-| 最小特征（标签） | 主角由内而外塑造，配角由外到内塑造（贴标签） |
-| 角色的不真诚 | 所说≠所想，举动≠态度，日常相处与便当（角色死亡/退场）是深化角色的两极 |
-| 角色的聚光灯 | 配角必须与主角产生强烈联系性，配角压过主角时塑造新配角夺走光环 |
+### 5.3 展示人物特质的方法
 
-### 5.5 人物塑造与人物真相
-
-| 层面 | 定义 | 示例 |
+| 方法 | 操作 | 示例 |
 |------|------|------|
-| 人物塑造（显型） | 读者第一眼看到的特质 | 外表青春可爱的萝莉 |
-| 人物真相（隐性） | 角色内在的真实面貌 | 实际上是冷血杀手 |
-| 价值取向（内隐） | 关键选择时起决定作用的价值观 | 在道义与野心间选择野心 |
-
-操作要点：价值取向不必一开始揭示，在关键抉择时自然暴露；人物真相的揭示越晚，戏剧张力越强。
-
-### 5.6 人设分层展示法
+| 敏感性 | 触碰弱点，看反应方式 | 惊慌失措/匆忙逃跑/转移注意力=不同性格 |
+| 逃避 | 展现回避行为暗示弱点 | 角色的"不做什么"比"做了什么"更揭示深层性格 |
+| 先正后缺 | 先展示吸引人特质，再揭示缺陷 | 读者先喜欢角色，才能容忍缺陷 |
 
-| 层次 | 操作 |
-|------|------|
-| 第一层 | 告诉读者类型模型（萝莉/御姐/少妇） |
-| 第二层 | 贴特点标签（胸大/腿长/小麦色皮肤） |
-| 第三层 | 为性格找原因（家庭/内在冲动） |
-| 第四层 | 打破——可爱天然呆其实什么都知道，人设立刻升华 |
+### 5.4 配角用法
 
-深化记忆：在不同场景重现角色的标志词与行为，让读者认出同一特质。
+- 嘴替：主角不便说的话、不便发的狠、不便吃的瘪，交给一个忠心配角或伙伴，主角的逼格不掉。
+- 任务基地：选一个配角同时挂着几件短期和长期的事，主角每收完一个剧情单元回到他那里接新事；他下线时给主角更大的好处。
+- 以角色带角色：读者喜欢某个角色，就写他的家人、闺蜜、对头，喜爱跟着延续；读者不感兴趣的角色及时下线。
 
-### 5.7 人物经历三线时间法
+### 5.5 人物经历三线时间法
 
 | 时间线 | 内容 |
 |--------|------|
@@ -256,7 +238,7 @@
 | 现在 | 与主角的关系定位、当前互动模式 |
 | 未来 | 制造变强动力或危机（老师被劫/女主被抓/反派揭底） |
 
-### 5.8 配角执念设定法
+### 5.6 配角执念设定法
 
 快速让读者认同支线配角：
 
@@ -265,7 +247,7 @@
 - 过于极端的执念 → 加入"亲民"小细节 → 便于读者认同
 - 适用：支线配角，不适合频繁出现的主要配角
 
-### 5.9 人物行为重复点设计
+### 5.7 人物行为重复点设计
 
 维持长篇不歪的关键手法：
 
@@ -274,11 +256,11 @@
 - 人物看点 + 核心看点 = 层次感，两者循环产生差异化
 - 反派/配角也需要重复看点，能让人爱上的反派会增加读者新鲜感
 
-### 5.10 围绕人设写行为
+### 5.8 围绕人设写行为
 
 行为、语言、思维都要围绕人格展开。如果为了剧情需要让角色做出不符合人设的行为 → 先修改剧情，不要改人设。
 
-### 5.11 人推事件 vs 事件推人
+### 5.9 人推事件 vs 事件推人
 
 | 驱动方式 | 特点 |
 |---------|------|
@@ -296,23 +278,30 @@
 - 主角必须有逼格——这是读者的代入基础
 - 不要写太多降智的内心戏和爆粗口
 - 主角可以不完美，但不能让人看不起
+- 被挑衅时的反应随实力和阅历变：实力高就轻描淡写，实力不够就隐忍蓄力；气急败坏地反击是毒点
+
+### 6.2 主角的成长弧
 
-### 6.2 主角的成长
+成长按四段写，每段要有读者看得见的事件：
 
-- 成长不只体现在实力上，更体现在心智和选择上
-- 每次成长都要有触发事件和内在反思
-- 网文主角成长非必须：开场三观圆满的正常人更容易代入，稳定人设本身就是魅力
+1. 触发：一件事打破现状，主角原来的办法或信念不管用了
+2. 变化铺垫：主角试新办法、付代价，可以反复，每次留一处行为上的变化证据
+3. 转折点：关键抉择时，主角第一次按新的方式选
+4. 新状态：之后同类局面里，主角稳定用新的方式行动
+
+- 成长写在心智和选择上，不只写在实力上。
+- 网文主角不一定要成长：开场三观圆满、人设稳定的主角更容易代入，弧线可以只放在实力和地位上。
 
 ### 6.3 主角红线
 
 以下类型的主角绝对不要写：
 
-| 禁止 | 原因 |
+| 禁止 | 说明 |
 |------|------|
-| 圣母型主角 | 读者要痛快而非道德说教 |
+| 圣母型主角 | 以德报怨、拿自己人的利益换好名声，读者要的是痛快；守底线、行善后有回报不算圣母 |
 | 无脑战斗机器 | 难以产生情感共鸣 |
 | 内核邪恶 | 读者无法代入 |
-| 因蠢/圣母犯错 | 读者无法原谅 |
+| 因蠢、圣母心或与实力不符的低级失误犯错 | 读者无法原谅；因不可抗力或信息差犯错可以 |
 | 自暴自弃 | 比被欺负更让读者厌恶 |
 
 ### 6.4 主角调子起太高怎么办
@@ -323,15 +312,17 @@
 - 读者失去追更动力
 
 **化解方法**：
-- **压势不压人**——压低气势和期待，但不打压主角本身的能力和尊严
+- **降调不降人**——压低气势和期待，但不打压主角本身的能力和尊严
 - **留出维度差距**——即使某方面很强，总有其他维度是短板
 - **超额收获法**——看似收获很大，经主角盘算后发现更大
+- 紧张题材（极道、末世、悬疑）别给主角随时能兜底的靠山，靠山不能消掉危机感
 
 ### 6.5 主角开篇立人设
 
-- 人设通过选择建立，开篇必须让主角做出选择
-- 智斗型开局比暴力型开局更容易立人设
-- 读者更容易代入"聪明但普通"的主角，而非"上来就无敌"的主角
+- 人设靠选择立：开篇让主角做一次选择，读者从选择里看出他是什么人。
+- 无敌流、认知差这类开局，靠主角怎么用力量的选择立人设，不靠战力展示本身。
+- 行动力从三处显：做别人不敢做的事、做别人做不到的事、做别人没想到能这样做的事；行动要有人设上的缘由，不为制造意外崩人设。
+- 主角有不讨喜的一面（好色、贪财、记仇）要在开头亮明，后面别突然转性。
 
 ### 6.6 主角的两个身份与两个金手指
 
@@ -342,40 +333,9 @@
 | 显性金手指 | 系统/玉坠/重生记忆 | 开局获得贯穿全书 |
 | 隐性金手指 | 主角性格 | 让主角与众不同的就是金手指 |
 
-**最佳写法**：前期以金手指装逼 → 剧情推进中逐步把人设清晰
+**最佳写法**：前 3 章用一次选择立住人设（见 6.5），之后靠金手指场面把人设一层层加深
 **人设与全书气质**：主角人设必须与世界基调相符，四点高度统一：社会身份+身世+金手指+性格
 
-### 6.7 性格单一缺陷型主角+动物伙伴体系
-
-淡漠型主角反应少，容易让人物互动单薄；可用性格各异的伙伴补足反应与对话。
-
-**问题**：性格过于单一 → 影响精彩程度 → 难以推进故事
-**解法**：给淡漠型主角配备 3-5 只动物伙伴，每只不同性格。
-
-| 伙伴类型 | 功能 |
-|---------|------|
-| 蠢萌犯二型 | 负责搞笑，主角不宜吃瘪但动物可以 |
-| 聪敏嘴贱型 | 负责嘴替，主角不该说的话由它说，保持主角逼格 |
-| 耿直蠢笨型 | 负责反差萌 |
-| 奇特能力胆小型 | 负责能力补充 |
-
-### 6.8 核心情绪与表达欲平衡
-
-- 需求的内核不变，变的只是形式
-- 写完一段剧情后，站在读者角度审视是否偏离核心梗
-- 主角牛逼了必须有所得，不能光付出没回报
-- 表达欲旺盛时最容易偏离——要主动检查
-
-### 6.9 压势不压人：矛盾的正确来源
-
-**错误做法**：让反派莫名其妙针对主角，背后逻辑站不住脚。
-
-**正确做法**：反派有自己的目的，行动客观上导致主角困境，但并非刻意针对主角本人。
-
-**矛盾链条**：反派目的 → 压制主角所在群体（压势） → 主角推翻 → 底层依旧麻木 → 主角改变路径 → 新冲突自然产生
-
-核心：所有人被自己想要的利益驱动，背后是三观不同，更深是成长环境，最深层是世界观。
-
 ---
 
 ## 第7节：反派塑造深化
@@ -410,6 +370,8 @@
 - [ ] 逼格在线——不会让读者看不起
 - [ ] 没有触碰红线（圣母/无脑战斗机器/内核邪恶/因蠢犯错/自暴自弃）
 - [ ] 核心目标和全书主线对齐
+- [ ] 主要角色有三层标签，至少一层反差，用行为对照写出
+- [ ] 影响剧情走向的设定（实力、钱、人脉、背景）至少 3 项，爱好只做记忆点
 
 ### 配角检查
 
@@ -442,4 +404,4 @@
 - [ ] 行为/语言/思维围绕人设展开，没有为剧情改人设
 - [ ] 主要角色有行为重复点，维持长篇一致性
 - [ ] 配角与主角有明确联系，不会抢主角风头
-- [ ] 人物真相/价值取向在关键抉择时自然暴露
+- [ ] 内核标签在关键抉择时亮出，没有提前用旁白交代