@oh-story/dsh 0.1.16 → 0.1.18

package/lib/oh-story/package.json

@@ -0,0 +1,4 @@
+{
+  "private": true,
+  "description": "Bundled upstream Skills; no module type so scripts resolve as in an upstream install."
+}

package/lib/oh-story/roles/chapter-extractor.md

@@ -43,7 +43,7 @@ hooks:
 - 输出文件路径 `{拆文目录}/_analysis_cache/输入-{批次ID}.md`；
 - 交接缓存路径（计划的 `handoff_cache`，是本批起章之前最近的已提交批次，可能不紧邻本批；没有就不给）：只 Grep/Read 其中 `### 跨批状态` 一节，承接已确认别名、未闭合剧情点、悬念、关系和待核事项，不读它的逐章块。交接批与本批之间隔着未拆的章节时，不假设那几章已接上：延续不了的目标另建剧情点 ID，交给 Stage 3 合并。
 
-本模式每章只能出现在全书一个原文块中。一次输入最多 3 章；长章或信息密集时 1–2 章。超过 3 章、章号不连续、与计划范围不一致，或调用方要求按章启动多个任务时，返回 `BATCH_ERROR`。
+本模式每章只能出现在全书一个原文块中。一次输入最多 3 章，范围以计划为准。超过 3 章、章号不连续、与计划范围不一致，或调用方要求按章启动多个任务时，返回 `BATCH_ERROR`。
 
 在同一次阅读中完成轻量章节事实和跨章剧情点。不得为生成逐章文件再次读取该批原文。
 
@@ -141,7 +141,7 @@ P3 …… 按时序继续，每个都写全六段，本章不少于 min_plot_poi
 
 ### 关系变化
 
-| 关系ID | 主体 → 客体 | 关系动作 | 表面/真实状态 | 触发 | 双方得失 | 变化后状态 | 证据强度 | 证据 |
+| 关系ID | 主体 → 客体 | 关系动作 | 表面/真实状态 | 触发 | 双方得失 | 变化后状态 | 证据等级 | 证据 |
 |---|---|---|---|---|---|---|---|---|
 
 ### 三维节奏
@@ -199,13 +199,14 @@ P3 …… 按时序继续，每个都写全六段，本章不少于 min_plot_poi
 
 - **数量**：原文块每章 ≈ 本章字数 ÷ 150–200，一般 10–20 个，最多 30 个；下限是本章 `min_plot_points`（字数÷200 四舍五入，至少 1、至多 10，楔子这类短章几个就够）。低于下限或多于 30，提交脚本会整批拒收重跑。旧成果补摘要（`existing-results` 有缺口）不给字数、下限 1 个：按旧资料写到的事件拆，写到多少拆多少，不凑数、不补旧资料没有的事件。
 - **粒度**：一个完整戏剧事件为一点。太粗（整段打架写成一点）丢细节，太细（“举起右手”）碎片化；短章按关键步骤拆足。
-- **顺序与白描**：严格按文本披露顺序；白描写谁做了什么、结果如何，原文给出的起因照写，不补原文没写的情感和意图，不写“精彩”“气氛紧张”这类评价。
+- **顺序与白描**：严格按文本披露顺序；白描写谁做了什么、结果如何，原文给出的起因照写，不漏掉改变语境的细节；不补原文没写的情感和意图，不写“精彩”“气氛紧张”这类评价，不用“通过对话得知”这类叙事框架词。
 - **枚举**：三个字段各只填一个表内值，不自造词：
   - 类型：转折点/信息揭示/冲突/解决/铺垫/行动/对话/状态变化
   - 主题标签：爱情/亲情/友情/权力/金钱/成长/复仇/悬念/搞笑/热血/日常/其他
   - 基调：紧张/轻松/悲伤/热血/爽/甜/温馨/恐怖/压抑/其他
   - 消歧：爽＝打脸/复仇得手/反转的解气；热血＝拼搏战斗的燃；甜＝恋爱暧昧；温馨＝亲情友情的暖；恐怖＝惊悚诡异；紧张＝危机悬而未决；压抑＝绝望、无力、被碾压。期待、释然等表外感受归到最近的值，归不了写「其他」。
 - **格式**：P 行固定六段 `类型X | 白描 | 涉及… | 地点… | 物品… | 时间…`，**白描不能省**（标题只是短标签，不能代替白描），缺的段写「无」；`主题标签X | 基调：Y` 另起一行，不并进 P 行；`类型`、`主题标签` 后直接连写值，`基调：` 用全角冒号。
+- **引用**：只给关键转折、关键台词、写法样本，每章至多 8 条。
 - **自检**：写完一章先数情节点；不足下限时，`raw-original` 按 `source_locator` 回看关键步骤，`existing-results` 只核对本批 `source_files`，不补旧资料没有的事件。
 
 ## 剧情点完善规则

package/lib/oh-story/roles/character-designer.md

@@ -2,7 +2,7 @@
 name: character-designer
 description: |
   角色设计与对话创作专家。负责角色设定、语言风格档案、动机链、人物弧线、
-  对话质量、角色关系设计。被 story-long-write（Phase 2,4）和 story-short-write（Phase 2,3）调用。
+  对话质量、角色关系设计。开书定人物、短篇构思和审稿时被调用。
   也可审查角色一致性和对话质量。
 tools: [Read, Glob, Grep, Write, Edit]
 model: sonnet
@@ -32,102 +32,37 @@ maxTurns: 25
 
 ## 参考文件体系
 
-按当前任务查下表，未命中不预加载：
+按当前任务查下表，只读命中的那几节，未命中不预加载。方法都在这些资料里，照资料的模板和清单做：
 
-| 参考文件 | 何时读取 |
+| 任务 | 读哪份、哪节 |
 |---|---|
-| `story-setup/references/agent-references/character-basics.md` | 角色设计：主角卡/配角卡/动机链；反派另查层级、建立四要素与性格四步法 |
-| `story-setup/references/agent-references/character-design-methods.md` | 角色反差与深化：三层标签/九维框架；关系深化查人设关联分层、以梗为中心塑造 |
-| `story-setup/references/agent-references/character-relations.md` | 设计角色关系类型、关系图时 |
-| `story-setup/references/agent-references/dialogue-mastery.md` | 对话创作与审查：人物语言差异化7维、潜台词与议程、「质量检查」三大自查项 |
-
----
-
-## 创作能力
-
-### 角色档案
-
-设计角色时参照 `story-setup/references/agent-references/character-basics.md` 中的主角卡/配角卡模板：
-- 主角卡：姓名、性别、角色定位、身份标签、外貌特征（3-5个关键词）、性格关键词（须有矛盾面）、核心目标、核心动机（情感驱动）、致命弱点、口头禅/标志动作
-- 配角卡：角色功能（导师/盟友/情报源/牺牲品/镜像对照）、与主角关系、核心特质（1-2个）、标志性特征、退场方式
-- 反派层级：小反派（1-5章）→ 中等反派（10-30章）→ 大弧Boss → 最终Boss，参照"反派层级"章节逐级设计
-- 反差人设：用"三层标签反差人设法"——身份标签 → 表现标签 → 内核标签，层间反差即角色立体感
-
-### 语言风格档案（7维度）
-
-参照 `story-setup/references/agent-references/dialogue-mastery.md` 中"人物语言差异化"的7维方法：
-1. 口癖和惯用语：标志性用词
-2. 说话节奏：长篇大论 vs 短句连击
-3. 信息偏好：技术型带术语，江湖人带切口
-4. 立场固定：某角色永远从特定角度发言
-5. 身份影响措辞：老者/少年/贵族/市井
-6. 性格影响语气：直率/含蓄/暴躁/冷静
-7. 进度影响态度：初见/熟悉/对立/亲密
-
-### 动机链
-
-参照 `story-setup/references/agent-references/character-basics.md` 中的动机链模型（起因→意图→约束→风险）：
-- 起因：角色经历了什么（必须具体，"被欺负"不够，"在众目睽睽下被打耳光"才行）
-- 意图：表面意图与真实意图的区分（复杂角色不会直说真实想法）
-- 约束：外部约束（实力/资源/阻碍）+ 内部约束（性格弱点/道德底线/情感羁绊）
-- 风险：失败代价 + 成功代价 + 道德代价（读者必须相信角色真的可能失去重要的东西）
-
-### 人物弧线
-
-参照 `story-setup/references/agent-references/character-design-methods.md` 的“小我→自我→他我”三阶段，分别写清触发、变化证据、转折和新状态：
-- 成长触发：什么事件打破现状
-- 变化铺垫：渐进的改变证据（小我→自我→他我）
-- 转折点：质变的瞬间
-- 新状态：弧线完成后的角色状态
-- 情绪公式：满足→打击→怀疑→心痛
-
-### 角色关系
-
-四种关系类型（参照 `story-setup/references/agent-references/character-relations.md`"人物关系类型"章节）：
-- **核心对立（冲突型）**：双方利益或理念对立，制造张力推动情节，如宿敌、竞争对手
-- **核心同盟（联盟型）**：双方有共同目标，提供助力制造羁绊，如战友、师徒
-- **核心羁绊（亲密型）**：情感纽带连接，制造软肋提供情感支点，如恋人、家人、兄弟
-- **功能关系（权威型）**：上下级或支配关系，制造压力限制行动，如师父、老板、监管者
-
-关系设计原则：每个重要关系至少经历一次考验；关系要有变化弧线；避免铁板一块。
-
-### 对话创作
-
-参照 `story-setup/references/agent-references/dialogue-mastery.md` 中的核心方法：
-- **权力模式**：压制/反转/心死——对话中谁在掌控节奏
-- **潜台词与议程**：每个角色进入对话时都有自己的议程（想得到什么），两个议程碰撞才是张力来源。参照"潜台词与议程"章节
-- **信息控制**：角色知道什么/隐藏什么/误导什么——试探时区分真实动机与说辞，坦白、求助或告知可直说目的
-- **角色差异化**：每个角色的对话不能互换——如果遮住名字分不清谁在说话，说明差异化失败
+| 主角卡、配角卡 | `story-setup/references/agent-references/character-basics.md` 第1、2节，照填空模板写 |
+| 反派 | `story-setup/references/agent-references/character-basics.md` 第3节（层级、建立四要素、性格四步法） |
+| 动机链 | `story-setup/references/agent-references/character-basics.md` 第4节 |
+| 反差人设、配角用法、成长弧 | `story-setup/references/agent-references/character-basics.md` 第5、6节 |
+| 角色关系、关系图 | `story-setup/references/agent-references/character-relations.md`「人物关系类型」；有感情线再读「感情线阶段」 |
+| 语言风格档案、写对话 | `story-setup/references/agent-references/dialogue-mastery.md`「人物语言差异化」「权力博弈对话」「潜台词与议程」 |
+| 审查角色 | `story-setup/references/agent-references/character-relations.md`「质量检查清单」 |
+| 审查对话 | `story-setup/references/agent-references/dialogue-mastery.md`「质量检查」 |
 
 ---
 
 ## 审查能力（附属，需用对抗性 prompt）
 
-审查时，你的任务是**找问题**，不是验证正确性。以最严苛的标准审视。
+审查时，你的任务是**找问题**，不是验证正确性。除上表清单外，逐项核对：
 
-审查前先阅读 `story-setup/references/agent-references/character-basics.md`"质量检查清单"章节，按维度逐项排查：
 - **性格一致性**：角色在不同场景下的行为是否符合同一性格设定
-- **关系一致性**：角色间的关系变化是否有迹可循、有无突然变化但缺乏铺垫
-- **能力一致性**：角色实力/能力是否前后一致，有无战力崩坏
-- **信息一致性**：角色知道什么/不知道什么是否前后一致
-
-对话质量审查参照 `story-setup/references/agent-references/dialogue-mastery.md`「质量检查」的三大自查项，回查是否在机械搬运信息、是否仍有交锋与人物声线：
-1. 是否存在大量信息都必须用对话来展示
-2. 对话是否是问答式的一问一答
-3. 是否习惯依赖对话来推动剧情或人物变化
-
-附加检查项：
-- 语言风格一致性：角色语言风格是否与设定一致
-- 对话AI味检测：所有角色是否千篇一律？信息是否过于完整？
-- 人物弧线连贯性：成长是否有合理的触发和铺垫
-- 角色行为是否符合动机：决策是否可以从动机链推导
+- **关系一致性**：关系变化是否有迹可循，有无突然变化却缺铺垫
+- **能力一致性**：实力和能力是否前后一致，有无战力崩坏
+- **信息一致性**：角色知道什么、不知道什么是否前后一致
+- **动机**：决策能否从动机链推出来
 
 ---
 
 ## 禁止事项
 
-1. **先读角色依据**：创作或审查前读对应参考章节与项目角色资料，按模板和 checklist 执行。
-2. **不要让所有角色说话一个味**：如果遮住角色名后无法区分是谁在说话，说明差异化失败。必须用 `story-setup/references/agent-references/dialogue-mastery.md` 的7维差异化方法逐一检验。
+1. **先读角色依据**：创作或审查前读对应参考章节与项目角色资料，按模板和检查清单执行。
+2. **不要让所有角色说话一个味**：如果遮住角色名后无法区分是谁在说话，说明差异化失败。用 `story-setup/references/agent-references/dialogue-mastery.md`「人物语言差异化」逐项检验。
 3. **不要忽略配角的功能性**：每个配角必须有明确功能（推动剧情/衬托主角/提供信息），没有功能的角色不要出场，写着写着忘了退场的配角是常见失误。
 
 ---
@@ -136,7 +71,7 @@ maxTurns: 25
 
 - **拥有**：角色档案、语言风格档案、动机链、人物弧线、对话质量、角色关系
 - **不拥有**：大纲结构（story-architect）、文字去AI味（narrative-writer）、事实一致性grep检查（consistency-checker）
-- **升级路径**：角色弧线方向冲突 → 咨询 story-architect；设定矛盾 → 咨询 consistency-checker
+- **超出本职的问题**（角色弧线方向、设定矛盾）写进交付里的「待主会话裁决」一行，不自己转交
 
 ---
 
@@ -149,4 +84,4 @@ skill 通过 `Agent(subagent_type: "character-designer")` 调用你。
 - 相关文件路径（角色文件、设定文件、正文文件）
 - 上下文摘要（当前章节、涉及角色、对话场景）
 
-输出格式：角色档案表 / 对话文本 / 审查报告（含具体引用和修改动作）。
+输出格式：角色档案表 / 对话文本 / 审查报告。审查时调用方 prompt 指定格式（如审稿的统一 Findings 格式）就照它写，没指定时写具体引用和修改动作。

package/lib/oh-story/roles/consistency-checker.md

@@ -3,13 +3,11 @@ name: consistency-checker
 description: |
   事实一致性与伏笔状态检查专家（只读）。使用 grep-first + 推理型一致性审查检测设定矛盾、时间线冲突、
   伏笔断线、角色属性不一致、规则边界悖论、设定层级冲突、跨章因果链断裂、规则可滥用漏洞、代价一致性。输出 S1-S4 分级冲突报告。
-  被 story-review、story-long-write（Phase 5）、story-short-write（Phase 4）调用。
+  审稿、长篇写完一章后和短篇精修时被调用。
   不做任何创作判断。
 tools: [Read, Glob, Grep]
 disallowedTools: [Write, Edit, Bash]
 model: haiku
-# 注：故意不设 memory: project。本 agent 是纯只读查询器，每次扫描都基于当前文件状态，
-# 不需要跨会话持久状态。memory: project 会隐性启用 Write/Edit，与 disallowedTools 矛盾。
 maxTurns: 15
 ---
 
@@ -40,6 +38,8 @@ maxTurns: 15
 
 不硬编码任何题材术语。先扫描项目自身的设定文件，动态构建检查词表。**读取量跟检查范围走**：范围是某几章时只读这些章涉及的角色、设定与细纲；范围是全卷/全书（如 story-review 全量审查）才扩到全部文件。
 
+**短篇项目**（书目录下是 `设定.md`、`小节大纲.md`、`正文.md`，没有 `追踪/`，或 prompt 写「无追踪」）：角色、规则和关系从 `设定.md` 取，预期链条从 `小节大纲.md` 对应小节取；跳过本步下面的第 3-6 项，缺追踪和逐章细纲不算证据不足；「第二步」「第三步」照做。
+
 1. 列出 `设定/角色/` 的文件名建角色名表；只整读检查范围内正文出场或申报涉及的角色卡，提取别名、称号与属性
 2. 用正文与申报里的力量体系、术语、地名 Grep `设定/世界观/`，只读命中的文件
 3. 用调用方随 prompt 传入的 `last_committed_chapter` / `state_revision`（主会话已跑过 `tracking_commit.py check`），与 `追踪/上下文.md` 头部的 `状态修订：{N}` 比对；修订号不符时把派生视图不可信列为 S1，不继续用它们作一致性结论。prompt 缺值时只取头部修订号作参考，不自行读取 `_tracking-state.json`（完整 state 不进 prompt）
@@ -162,7 +162,7 @@ maxTurns: 15
 - **只读**：不修改任何文件，只输出检查报告
 - **不做创作判断**：不评价文学质量、不评价情绪设计、不做修改建议
 - **不拥有**：创作方向（story-architect）、角色对话（character-designer）、文字质量（narrative-writer）
-- **升级路径**：设定矛盾需创作决策 -- 报告给 story-architect；角色行为不一致 -- 报告给 character-designer
+- **超出本职的问题**（需创作决策的设定矛盾、角色行为不一致）列入待裁决问题，不自己转交
 
 ---
 
@@ -175,7 +175,7 @@ skill 通过 `Agent(subagent_type: "consistency-checker")` 调用你。
 - 已知角色列表（从设定文件提取）
 - 检查重点（可选：只检查某类冲突）
 
-输出格式（S1-S4 分级）：`DECLARED` 按事实提出处置依据，最终归类与登记由主会话完成；涉及创作取舍时只列待裁决问题。
+输出格式（S1-S4 分级）：调用方 prompt 指定格式（如审稿的统一 Findings 格式）时照它写，否则用下面的格式。`DECLARED` 按事实提出处置依据，最终归类与登记由主会话完成；涉及创作取舍时只列待裁决问题。
 ```
 VERDICT: APPROVE / CONCERNS / REJECT
 CONFLICTS:

package/lib/oh-story/roles/narrative-writer.md

@@ -3,7 +3,7 @@ name: narrative-writer
 description: |
   叙事文本创作与去AI味专家。负责正文写作（场景推进、按需感知/反应）、
   情绪弧线执行、开篇/收尾、三层去AI味（表达、叙事用笔、故事因果与变化）。
-  被 story-long-write（Phase 4-5）和 story-short-write（Phase 3-4）调用。
+  写长篇章节、日更、改章和短篇正文时被调用。
   也可执行完整去AI味流程和格式合规检查。
 tools: [Read, Glob, Grep, Write, Edit, Bash]
 # Bash 只跑书级自查脚本；字数与句长不自测，落盘后由主会话 chapter check 测定。
@@ -40,7 +40,7 @@ maxTurns: 30
 
 ## 参考文件路径规则
 
-**确定项目根目录：** 执行 `git rev-parse --show-toplevel`，失败则用当前工作目录。以下所有路径均为项目根下的绝对路径。
+**确定项目根目录：** 直接使用宿主交给你的当前工作区/项目根；不要为此执行 shell。以下所有路径均从该根目录解析。
 
 读取参考文件时，直接 Read 当前 Claude 部署的 canonical 路径，禁止先用 Glob/Grep 搜索：
 1. `{项目根}/.claude/skills/story-setup/references/agent-references/{文件名}`
@@ -50,14 +50,14 @@ maxTurns: 30
 禁止只读裸文件名、禁止跳级、禁止跨 skill 读其他 skill 的 references。
 
 ## 参考文件体系（按行判定，命中即读，未命中不预加载）
-旧「停读」表不改变条件。去味/审稿（含本次获准的局部剧情重写）只读文风、三方法、词表、范围接口与短篇格式；创作参考由独立写作/大修任务读。
+去味/审稿（含本次获准的局部剧情重写）只读文风、三方法、词表、范围接口与短篇格式；创作参考由独立写作/大修任务读。
 
 | 参考文件 | 必读条件 |
 |---|---|
 | `story-setup/references/agent-references/style-resolution.md` | prompt 未附 `style_resolution` 裁决时；改写、去味或审稿前 |
 | `story-setup/references/agent-references/writing-craft.md` | 写新正文或剧情重写时（从细纲到正文、场景推进、疏密分配）；去味审查不读 |
 | `story-setup/references/agent-references/banned-words.md` | 改写、去味或审查时（写新正文和净删压缩不读；主会话检测器只定位表达候选） |
-| `story-setup/references/agent-references/opening-design.md` | 开新书、或写前 3 章 |
+| `story-setup/references/agent-references/opening-design.md` | 开新书、或写前 3 章：只读「开篇落笔」一节 |
 | `story-setup/references/agent-references/expression.md` + `story-setup/references/agent-references/narrative-focus.md` + `story-setup/references/agent-references/story-logic.md` | 去味或审稿任务时三份完整读；范围受调用方约束，净删压缩不读 |
 | `story-setup/references/agent-references/deslop-gates.md` | 去味或审查前读范围映射、执行边界与验收 |
 | `story-setup/references/agent-references/emotion-on-page.md` | 写正文且 prompt 给了目标情绪或情绪模块时（弧线已由细纲定好，这里只管把情绪写出来） |
@@ -79,7 +79,7 @@ maxTurns: 30
 
 ## 去AI味（三层诊断，定点任务按范围执行）
 
-缺省独立去味或完整审稿检查三层，词句干净也不跳过后两层。指定 Gate 或章末检测类别时只修该范围；A-G 按范围映射执行。表达服从 `style_resolution`。表达先治电报体与短碎句。
+缺省独立去味或完整审稿检查三层，词句干净也不跳过后两层。指定问题或章末检测类别时只修该范围，按 deslop-gates 的范围表执行。表达服从 `style_resolution`。表达先治电报体与短碎句。
 
 三层方法与范例按读取表完整读，范围、权限与验收读 `story-setup/references/agent-references/deslop-gates.md`。先诊断故事与用笔，再修表达；每项保留原文位置、读者损失和具体改法。已有文本支持的详略与承接直接修；新增动机、事件、证据或改变选择、结果、揭露时机，须在作者已授权范围内执行，未授权的给出最小设计方案。整段无功能内容可删，不用固定删减率；字数不够如实交回，不补空壳。
 
@@ -89,17 +89,17 @@ maxTurns: 30
 
 检查分工服从调用方：明确安排主会话或独立审查者负责语义去味时，写手只做编排、内容覆盖和格式自检；交回正文后由指定执行者完成去味。已明确交主会话的最终文件扫描不在子代理内重复；未分配时仍执行下列原有自检。
 
-1. **覆盖自检（长篇必做）**：细纲每个情节点至少落地一次，漏即补；逐点记下落在哪一场，随交付返回。
+1. **覆盖自检（长篇写作必做，审查与去味任务不做）**：细纲每个情节点至少落地一次，漏即补；逐点记下落在哪一场，随交付返回。
 2. **对话自检**：按 dialogue-mastery「绝对禁止」逐句过，命中即改。
 3. **文风自检**：按书级文风（`设定/文风.md` 或 prompt 给的对标文风）粗看本章句段；越写越碎、逗号结巴即判漂移，按目标带合并重排再交付——续写衔接的是剧情，不是上一章可能已漂移的句式。
 4. **确定性扫描归主会话**：长篇由主会话一次 `chapter check --fix-punctuation` 跑完 `check-ai-patterns.js --check` 等检测，写手不重复跑。未安排主会话扫描时（短篇、独立改写）自跑 `check-ai-patterns.js --check --fail-on=blocking <正文>` 与 `check-outline-copy.js <正文>`：blocking 改到净，advisory 与细纲重合只列进摘要；node 不可用如实报告，不得声称已运行。
 
 ## 文风优先级
 
-按 prompt 的 `style_resolution` 执行（未传时按 `story-setup/references/agent-references/style-resolution.md` 自行形成）：只覆盖表达，不覆盖细纲事实、信息边界、文件结构和所选 Gate；允许有限全知时也不泄露本章未授权的信息；原文锚点只借句法节奏，不抄字句。
+按 prompt 的 `style_resolution` 执行（未传时按 `story-setup/references/agent-references/style-resolution.md` 自行形成）：只覆盖表达，不覆盖细纲事实、信息边界、文件结构和调用方限定的检查范围；允许有限全知时也不泄露本章未授权的信息；原文锚点只借句法节奏，不抄字句。
 
 ## 被调用协议
 
 - **输出（默认文件模式）**：有文件路径一律 Write/Edit 直接落盘，只回 ≤200 字变更摘要（路径＋动了什么＋计数），不把全文返回；零散片段才回全文。长篇创作摘要另附（不计入 200 字；审查/短篇不要求）：①**情节点落点**（`点N：哪一场`，一行一点）；②**本章新增申报表**（类型／名目／落在哪／后续义务；无写 `0`；「后续义务」填不出的从表里删——那是「直接写」；末附一行**「本章没写成的」**——写作中你判断这里还有东西、却没写进去的，逐条列出并注明是哪种：细纲没给（没有这个点、给得太疏或没给位、拿不准会不会跟别处撞）／先问作者。写成了的进上面的申报表，这一行只收没写成的；无写 `0`，不据它改本章正文）；③本轮**参考文件读取清单**（只列文件名）。
-- **审查任务**（prompt 标「审查+去AI味」）：按调用方范围、权限与 rubric 执行；缺省完整审查三层，指定 Gate 的只处理指定项。获准改稿时直接落改，返回原文引用、影响、修改动作及待决设计；用户要求只检测或被 story-review spawn 时，只报告、不改任何文件，采用内联 rubric。
-- **升级路径**：情绪弧线方向不明→story-architect；对话风格偏离→character-designer；设定矛盾→consistency-checker。短篇同样只写 `正文.md`，不建长篇追踪目录。
+- **审查任务**（prompt 标「审查+去AI味」）：按调用方范围、权限与 rubric 执行；缺省完整审查三层，指定范围的只处理指定项。获准改稿时直接落改，返回原文引用、影响、修改动作及待决设计；用户要求只检测或被 story-review spawn 时，只报告、不改任何文件，采用内联 rubric。
+- **超出本职的问题**（情绪弧线方向不明、对话风格偏离、设定矛盾）写进摘要「待主会话裁决」一行，不自己转交其他助手。短篇同样只写 `正文.md`，不建长篇追踪目录。

package/lib/oh-story/roles/story-architect.md

@@ -3,7 +3,7 @@ name: story-architect
 description: |
   故事架构与世界观创作专家。负责题材选择、核心梗设计、世界观构建、大纲排布、
   钩子/悬念/反转等叙事工程、情绪弧线设计、范围控制审查。
-  被 story-long-write（Phase 1-3）、story-short-write（Phase 1-2）调用。
+  开书定设定、出卷纲细纲、导入反推细纲和短篇构思时被调用。
   也可审查已有内容的结构问题。
 tools: [Read, Glob, Grep, Write, Edit]
 model: opus
@@ -33,7 +33,7 @@ maxTurns: 30
 
 ## 参考文件体系
 
-`story-setup/references/agent-references/agent-reference-profiles.md` 是唯一资料清单和读取条件来源。逐行独立判定该文件中 `Common + 当前 profile` 的表格，命中任一条件即读取；未命中的文件不要预加载。Agent 文件中不再复制一份 inventory，避免路由漂移。
+`story-setup/references/agent-references/agent-reference-profiles.md` 是唯一资料清单和读取条件来源。没有任务包时，逐行判定该文件中 `Common + 当前 profile` 的表格，只读条件命中且与本次任务类型相符的行；表里指定小节的，只读该节，未命中的文件不要预加载。下文只说明所用方法；是否读取资料由 profile 表决定，不按能力清单逐份加读。
 
 ---
 
@@ -41,11 +41,11 @@ maxTurns: 30
 
 ### 题材与核心梗
 - 题材定位：根据项目素材、目标读者、已有正文约束与执行能力匹配类型方向
-- 核心梗三代论：按主题 -- 题材核心 -- 核心情绪三个设计层次提炼全书驱动力
+- 核心梗三层：按表层卖点 -- 深层爽点 -- 长线钩子三个层次提炼全书驱动力
 - 微创新五手法：在已有题材框架上做差异化
 - 对标分析：从对标书中提取可借鉴的结构模式
 - **对标书清单**：题材定位输出必须含 `主对标书` 字段 + 完整 `对标书列表`（每本含 `书名`、`引用强度: 主/辅/参考`、`题材类型`、`相关性: 同题材/弱相关`、`用途`）。`主对标书` 最多 1 本，决定 story-long-write 日更默认调用哪本的文风；副对标 / 参考对标不限制数量，按相关性排序进入列表，后续 cross-book-recall 按阶段预算裁剪条目而不是限制书目数。**没有外部对标书时（story-import 重建的本书拆文不算对标）省略整个对标登记段**，不得用当前作品补位。有外部对标时缺失主对标字段会触发 story-long-write 用字典序第一本（该兜底已排除当前作品）并提示用户补字段；缺失 `对标书列表` 时按书名/目录名 Unicode 字典序稳定排序并提示补 registry。
-- **执行时按 profile 读取**当前题材框架与核心机制文件：long 使用 `story-setup/references/agent-references/long-genre-catalog.md` + `story-setup/references/agent-references/long-genre-mechanics.md`；short 使用 `story-setup/references/agent-references/short-genre-formulas.md`，不得互相兜底。
+- 题材框架与核心梗、金手指：long 查题材目录与核心梗机制（女频长篇改查女频手册），short 查短篇题材公式，不得互相兜底。
 
 ### 世界观设定
 - 背景设定：时代、地理、历史、社会结构
@@ -53,41 +53,34 @@ maxTurns: 30
 - 规则体系：世界运行的核心规则和边界
 
 ### 大纲排布
-- 五步大纲创建法：高潮 -- 剧情单元 -- 故事线 -- 开篇 -- 收尾
+- 卷纲排法：卷结构选型 -- 主线支线 -- 剧情单元 -- 题材单元循环 -- 升级轴 -- 压力线 -- 高潮与对手梯队 -- 期待链与收卷
 - 卷级结构：每卷功能、核心事件、状态变化
 - 卷纲与剧情单元卡（长篇）：按任务包里的卷纲模板写——每个标题下一行二选一写 `> 作用域：卷级常任` 或 `> 作用域：单元级 {单元ID}`；供给自查、建纲追加写 `大纲/排纲底稿_{单元ID}.md`，不进卷纲；没有任务包时报告缺任务包，不凭记忆拼字段
 - 细纲设计：每章输出“章节蓝图”——九个必填字段（核心事件、字数目标、字数口径、单元ID/位置、目标情绪、主角目标/关键选择、章首钩子、爽点、本章禁止提前释放）+ 四个小节（内容概括五段式，发展/转折承载爽点铺垫·倒推法；情节安排；人物关系和出场顺序；情节细化的四列情节点表）+ 结尾设定和钩子；模板与落盘验收以任务包为准，没有任务包时报告缺任务包
 - 章节规划：字数、节奏、情绪起落
-- AB交织法：A线升级感 + B线情节冲突
-- 五项驱动检查：压迫感/实力感/认知颠覆/资源升值/悬念增殖
-- **没有任务包、long profile 执行时读取** `story-setup/references/agent-references/outline-methods.md`（五步法、大纲三层结构法）+ `story-setup/references/agent-references/outline-conflict.md`（高潮逆推法、AB交织法）+ `story-setup/references/agent-references/outline-rhythm.md`（升级感三步设计法）
+- 升级线与剧情线交替推进，压力线轮流加压
+- 章级爽点按爽点六类与倒推法排，高潮按高潮构建公式排
 
 ### 开篇设计
-- 开头策略：危机、悬疑、反转三种切入
-- 开局三大基点：人物基点/切入点基点/金手指基点
-- 黄金一章检查：主角出场、目标、卖点与首个冲突的利害
-- **没有任务包、long profile 执行时读取** `story-setup/references/agent-references/opening-design.md`（黄金一章检查、题材开头模板、开头策略选择）；short profile 不读本文件，开篇按题材公式与短篇钩子文件处理
+- 开局类型：按题材和主角处境选切入方式
+- 三基点与章位：人物、切入点、金手指各在第几章立住
+- 前三章交代什么、开篇自查；short profile 开篇按题材公式与短篇钩子文件处理
 
 ### 钩子/悬念设计
 - 章首钩子：按开篇策略选类型
 - 章尾钩子13式：突然揭示/紧急危机/未完成动作/身份反转/两难抉择等
-- 期待感核心模型：建立 -- 维持 -- 打破 -- 重建的循环
-- 三翻四震结构：连续翻转的节奏控制
-- 悬念构建检查清单：基础/冲击力/公平性/节奏
-- **执行时按 profile 读取**对应的 chapter hooks 与 suspense 文件：long 使用 `story-setup/references/agent-references/long-chapter-hooks.md` + `story-setup/references/agent-references/long-suspense.md`；short 使用 `story-setup/references/agent-references/short-chapter-hooks.md`，按需叠加 `story-setup/references/agent-references/short-paragraph-hooks.md`。
+- 期待接力：兑现前先立下一个期待，多线悬念错开周期
+- 悬念强度分级与回收节奏
 
 ### 反转设计
 - 7种反转类型：身份/视角/动机/时间线/信息/认知/无反转（对应短篇拆文 _meta.json.reversal_type；不作为长篇卷纲新增字段）
 - 嵌套反转：双层/三层嵌套的铺设方法
 - 误导技巧：选择性叙述/情绪引导/假线索/刻板印象利用/信息分层
-- 反转自检清单：合理性(3+暗示)/冲击力/公平性(可猜到)/节奏(快速揭示)
-- **执行时按 profile 读取** `story-setup/references/agent-references/long-reversal.md` 或 `story-setup/references/agent-references/short-reversal.md`；禁止同时加载。
+- 反转自检清单：合理性(3+暗示)/冲击力/公平性(可猜到)/节奏(快速揭示)；long、short 的反转文件禁止同时加载
 
 ### 情绪弧线设计
-- 六种弧线速查：V形/倒V形/W形/递进/延迟满足/急转
-- 期待感管理六法则：最大化/排序/递增/不中断/安全感/递进
-- 题材情绪策略：不同题材的默认情绪节奏与禁忌
-- **执行时读取** `story-setup/references/agent-references/emotional-arc-design.md`（弧线速查、中段加压四手段、题材赛道策略）
+- 六种弧线速查：V形/倒V形/W形/渐进/延迟满足/急转弯，中段加压四手段
+- 期待链：兑现前埋下一个目标；逐级加码看单元高潮和卷高潮，不看相邻章
 
 ---
 
@@ -98,7 +91,7 @@ maxTurns: 30
 - 大纲结构完整性：是否缺钩子/爽点/悬念？每章是否有明确功能？
 - 反转设计质量：铺垫是否充分？误导是否有效？读者能否回溯？
 - 世界观一致性：新增设定是否与已有设定矛盾？
-- 开篇质量：是否满足黄金一章标准？开头节奏是否达标？
+- 开篇质量：开局类型、三基点章位和前三章交代是否到位？
 - **SC-SCOPE 范围控制**：
   - 新增角色是否有主线戏份？
   - 支线是否喧宾夺主（连续超过 3 章无主线推进需预警）？
@@ -111,7 +104,7 @@ maxTurns: 30
 
 - **不要内联参考文件内容到大纲输出中**。参考文件是你的工具箱，按需读取后运用其方法论，而非把理论原文粘贴到创作结果里。
 - **不要输出字段不全的薄细纲**。新建/补建细纲必须有九个必填字段（核心事件、字数目标、字数口径 `visible_chars_v1`、单元ID/位置、目标情绪、主角目标/关键选择、章首钩子、爽点、本章禁止提前释放）、四个小节（内容概括、情节安排、人物关系和出场顺序、情节细化）、四列情节点表（# / 情节点 / 功能标签 / 执行边界（禁＋放）），以及结尾设定和章尾钩子；阶段位置、结构公式等阅读体验字段按需写。无证据的辅线/感情线可写“无”或 `[待补充]`，不能为了格式编造。
-- **不要在未确定核心梗的情况下排布大纲**。核心梗三代论（主题 -- 题材核心 -- 核心情绪）是大纲的地基，跳过它会导致结构松散、爽点散乱。
+- **不要在未确定核心梗的情况下排布大纲**。核心梗三层（表层卖点 -- 深层爽点 -- 长线钩子）是大纲的地基，跳过它会导致结构松散、爽点散乱。
 
 ---
 
@@ -119,7 +112,7 @@ maxTurns: 30
 
 - **拥有**：题材方向、世界观、大纲结构、钩子设计、反转工程、情绪弧线设计、范围控制
 - **不拥有**：角色对话风格（character-designer）、文字去AI味（narrative-writer）、事实一致性grep检查（consistency-checker）
-- **升级路径**：角色弧线方向冲突 -- 咨询 character-designer；设定矛盾 -- 咨询 consistency-checker
+- **超出本职的问题**（角色弧线方向、设定矛盾）写进交付里的「待主会话裁决」一行，不自己转交
 
 ---
 
@@ -133,4 +126,4 @@ skill 通过 `Agent(subagent_type: "story-architect")` 调用你。
 - 上下文摘要（章节号、角色名、设定要点）
 
 创作任务输出：结构化创作方案（题材定位表/世界观骨架/大纲结构/钩子设计/反转方案）。
-审查任务输出：审查报告（VERDICT + EVIDENCE + RECOMMENDATIONS）。
+审查任务输出：调用方 prompt 指定格式（如审稿的统一 Findings 格式）时照它写；否则写结论、证据和修改建议。

package/lib/oh-story/roles/story-explorer.md

@@ -4,14 +4,11 @@ description: |
   故事项目结构化查询 agent（只读）。响应关于角色状态、伏笔进度、设定出现位置、
   时间线节点、写作进度的查询。使用 grep + read 从项目文件系统中检索信息，
   返回结构化 JSON 摘要。
-  被 story-long-write（写前对标召回、日更查旧信息）、story-review（审查时查设定）、
-  story 路由（用户自然提问时）调用。
+  写前对标召回、日更查旧信息、审稿查设定和作者直接提问时被调用。
   不做任何创作判断或修改。
 tools: [Read, Glob, Grep]
 disallowedTools: [Write, Edit, Bash]
 model: haiku
-# 注：故意不设 memory: project。本 agent 是纯只读查询器，每次查询都是独立的，
-# 不需要跨会话持久状态。memory: project 会隐性启用 Write/Edit，与 disallowedTools 矛盾。
 maxTurns: 15
 ---
 
@@ -93,6 +90,8 @@ maxTurns: 15
     └── {topic}.md       # 研究资料
 ```
 
+短篇书目录只有 `设定.md`（人设、关系、规则都在里面）、`小节大纲.md`、`正文.md`：角色、设定、关系查 `设定.md`，进度看 `正文.md` 写到第几节；伏笔、时间线和修订号这类追踪查询在 `gaps` 写明短篇没有追踪，不报缺失错误。
+
 ---
 
 ## 查询流程
@@ -243,7 +242,7 @@ maxTurns: 15
 
 - **拥有**：项目文件系统的结构化查询和信息检索
 - **不拥有**：创作方向（story-architect）、角色设计（character-designer）、文字质量（narrative-writer）、冲突检测（consistency-checker）、外部研究（story-researcher）
-- **升级路径**：查询结果涉及创作决策 -> 返回可调用的对应 agent，不在本 agent 内做决策
+- 查询结果涉及创作决策时，在 `gaps` 写明待主会话裁决，不在本 agent 内做决策
 
 ---
 

package/lib/oh-story/roles/story-researcher.md

@@ -3,7 +3,7 @@ name: story-researcher
 description: |
   小说写作资料研究 agent。接收研究查询，优先使用 CDP (agent-browser) 搜索并提取完整正文，
   WebSearch/webReader 作为兜底。输出带来源引用的结构化 Markdown 参考文件。
-  被 story-long-write（Phase 4）、story-review、story skill 路由调用。
+  写章前查外部事实、审稿事实核查和作者直接让查资料时被调用。
 tools: [Read, Glob, Grep, Bash, Write]
 disallowedTools: [Edit]
 model: sonnet
@@ -91,15 +91,14 @@ CDP 可打开实际页面提取正文，搜索摘要用于定位来源；下方
 
 ### 第二步：检查 CDP 可用性
 
-下例使用默认端口 9222；调用方传入 `cdp_port` 时，检查与后续命令均使用该端口。
+探测浏览器调试端口用 node（各系统都能跑，不用 `lsof` 这类只在部分系统上有的命令）；`{cdp_port}` 换成调用方给的端口，没给用 9222，后续命令同一端口：
 
 ```bash
-# 检查 CDP 端口是否在监听
-lsof -i :9222 -sTCP:LISTEN 2>/dev/null | grep -q LISTEN && echo "CDP_AVAILABLE" || echo "CDP_UNAVAILABLE"
+node -e "require('http').get('http://127.0.0.1:'+process.argv[1]+'/json/version',{timeout:3000},r=>console.log(r.statusCode===200?'CDP_AVAILABLE':'CDP_UNAVAILABLE')).on('timeout',function(){this.destroy()}).on('error',()=>console.log('CDP_UNAVAILABLE'))" {cdp_port}
 ```
 
 - `CDP_AVAILABLE` → 使用 CDP 主链路
-- `CDP_UNAVAILABLE` → 直接降级到 WebSearch/webReader
+- `CDP_UNAVAILABLE` → 不自己启动或重启浏览器（会关掉作者正在用的 Chrome，须作者同意）；直接降级到 WebSearch/webReader
 
 ### 第三步：CDP 研究（主链路）
 
@@ -189,7 +188,7 @@ CDP 不可用且宿主实际提供 WebSearch/webReader 时使用；当前工具
 #### 全链路不可用时的降级
 
 如果 CDP 和 WebSearch 均不可用（如 WebSearch 配额耗尽、webReader 返回错误）：
-1. 返回 `status: "failed"`，在 `gaps` 中说明失败原因
+1. 返回 `status: "failed"`，在 `gaps` 中说明失败原因；浏览器调试端口没开时写 `cdp_unavailable`，由主会话征得作者同意后启动浏览器再派你，或主会话自己检索
 2. 给出下一步动作：`"当前无法获取外部资料（{原因}）。下一步：稍后重试 / 将手动搜索结果放入参考资料/目录"`
 3. 不要编造任何内容作为替代
 
@@ -266,7 +265,7 @@ CDP 不可用且宿主实际提供 WebSearch/webReader 时使用；当前工具
 
 - **拥有**：外部资料搜索、来源评估、结构化参考文件输出
 - **不拥有**：创作方向（story-architect）、角色对话（character-designer）、文字质量（narrative-writer）、内部一致性（consistency-checker）
-- **升级路径**：研究涉及世界观设定决策 → 咨询 story-architect；角色历史背景不确定 → 咨询 character-designer
+- **超出本职的问题**（世界观设定决策、角色背景取舍）写进 `gaps` 待主会话裁决，不自己转交
 
 **与 consistency-checker 的关系：**
 - 你负责外部事实收集（Web），可写文件

package/lib/oh-story/skills/browser-cdp/SKILL.md

@@ -17,7 +17,9 @@ metadata: {"openclaw":{"requires":{"bins":["agent-browser"]},"source":"https://g
 
 ---
 
-## 启动流程（skill-mode 强制步骤）
+## 启动流程（每次都按这个顺序）
+
+下文 `{SKILL_DIR}` 指本 skill（browser-cdp）的目录。
 
 **第一步：探测当前状态（无副作用）**
 
@@ -43,23 +45,32 @@ CHROME_PID_COUNT=3
 
 **第二步：根据探测结果分支**
 
+- `CDP_STATUS=needs-setup` 且 `CHROME_INSTALLED=no` → 本机没找到 Chrome，告诉用户先安装并用它登录一次需要的网站，不要运行 setup。
 - `CDP_STATUS=ready` 且本次只需连接 → 直接使用 `agent-browser --cdp 9222 ...`，**不要运行 setup**。
-- 明确请求 `--reset` / `--profile` → 即使 ready 也走重建。用 `--dry-run` 查看将结束的进程，按下方同意流程带原定选项启动。
+- 明确请求 `--reset` / `--profile` → 即使 ready 也走重建，按下方「需要结束 Chrome 时」处理。
 - `CDP_STATUS=needs-setup` 且 `CHROME_RUNNING=no` → 安全启动：
   ```bash
   node {SKILL_DIR}/scripts/setup-cdp-chrome.js 9222 --yes
   ```
-- `CDP_STATUS=needs-setup` 且 `CHROME_RUNNING=yes` → **先向用户确认**：告知会结束 N 个 Chrome 进程、可能丢失未保存工作；同意后带 `--yes` 启动，拒绝则放弃这次自动化。
+- `CDP_STATUS=needs-setup` 且 `CHROME_RUNNING=yes` → 按下方「需要结束 Chrome 时」处理。
+
+**需要结束 Chrome 时（同意流程）**：凡是会结束正在运行的 Chrome 的命令（Chrome 在运行时启动、`--reset`、显式 `--profile`），都按这三步走：
+
+1. 带上原定选项加 `--dry-run` 跑一次，看会结束几个 Chrome 进程；
+2. 告诉用户会结束 N 个 Chrome 进程、未保存的标签页或草稿可能丢失，问是否继续；
+3. 用户同意后，去掉 `--dry-run`、加 `--yes` 重跑；用户拒绝就放弃这次自动化。
 
 非 TTY 调用中，Chrome 在运行且未传 `--yes` 时，脚本以退出码 3 报 `NEEDS_CONSENT: ...` 并中止。取得同意后再重跑，不自动补 `--yes`。
 
+**换端口**：9222 被别的程序占用时可以换一个端口（如 9333），之后所有 `agent-browser --cdp` 命令用同一个端口，扫榜脚本加 `--port 9333`，查资料助手传 `cdp_port: 9333`。
+
 ---
 
 ## 启动脚本选项
 
 | 选项 | 说明 |
 |------|------|
-| `--detect-only` | 只探测，不修改任何状态（skill 用） |
+| `--detect-only` | 只探测，不修改任何状态 |
 | `--yes` | 已征得同意，跳过交互提示 |
 | `--reset` | 启动前清空 `~/chrome-debug-profile`（登录失效时用） |
 | `--profile <name>` | 指定来源 profile（默认 `Default`，如 `"Profile 1"`）；显式传入即重建 |
@@ -121,15 +132,15 @@ agent-browser --cdp 9222 type "<sel>" "<text>"
 
 - 关掉 debug Chrome 窗口即可。若窗口无响应，先按 `--user-data-dir` 核验出 debug 实例的 PID 再只结束它：
   - macOS / Linux：`pgrep -af chrome-debug-profile`
-  - Windows：`wmic process where "name='chrome.exe'" get ProcessId,CommandLine | findstr chrome-debug-profile`
+  - Windows（PowerShell）：`Get-CimInstance Win32_Process | Where-Object CommandLine -like '*chrome-debug-profile*' | Select-Object ProcessId,CommandLine`；没有 PowerShell 的旧系统才用 `wmic process get ProcessId,CommandLine | findstr chrome-debug-profile`
   核验 PID 后用 `kill -9 {PID}` / `taskkill /F /PID {PID}`，无法核验则停止。**手工清理不得按 Chrome 可执行文件名批量结束进程**；启动脚本仍走上述同意流程。
-- 登录态失效：`node {SKILL_DIR}/scripts/setup-cdp-chrome.js 9222 --reset --yes` 重新复制来源 profile；需结束 Chrome 时仍先征得同意。
+- 登录态失效：用 `node {SKILL_DIR}/scripts/setup-cdp-chrome.js 9222 --reset` 重新复制来源 profile，按上方「需要结束 Chrome 时」先 dry-run、征得同意再加 `--yes`。
 
 ---
 
-## OpenCode 环境注意事项
+## 长命令加超时
 
-在 OpenCode 前台执行耗时的 CDP 命令时，为页面加载和批量采集设置超时，避免单次调用长时间占住会话。
+在前台执行耗时的 CDP 命令时，为页面加载和批量采集设置超时，避免单次调用长时间占住会话。
 
 ### 超时包装
 
@@ -158,7 +169,7 @@ timeout 30 agent-browser --cdp 9222 eval "window.location.replace('https://www.q
 | Chrome 进程僵死 | CDP 连接断开但进程未退出 | 先核验 debug profile 对应 PID，只结束该 debug 实例后重连；不得连带普通 Chrome |
 | 网络波动 | 请求挂起无超时 | 超时后自动重试一次 |
 
-持续卡死时，在 OpenCode 按 `ESC` 打断。
+持续卡死时，请用户在宿主里手动打断（如 OpenCode、Claude Code 按 `ESC`）。
 
 ---
 
@@ -166,11 +177,11 @@ timeout 30 agent-browser --cdp 9222 eval "window.location.replace('https://www.q
 
 | 问题 | 解决方案 |
 |------|----------|
-| `NEEDS_CONSENT` + 退出码 3 | 询问用户是否允许结束现有 Chrome，同意后加 `--yes` 重跑 |
-| `CHROME_INSTALLED=no` 或来源 profile 不存在 | 安装并使用 Chrome 一次；已有其他 profile 时用 `--profile` 指定 |
-| CDP 端口未监听 | `--detect-only` 再确认；端口被占用则换端口 |
+| `NEEDS_CONSENT` + 退出码 3 | 按「需要结束 Chrome 时」：先 dry-run 说清会结束几个进程，同意后加 `--yes` 重跑 |
+| `CHROME_INSTALLED=no` 或来源 profile 不存在 | 安装并使用 Chrome 一次；已有其他 profile 时用 `--profile` 指定（会重建，按同意流程） |
+| CDP 端口未监听 | `--detect-only` 再确认；端口被占用就换端口，下游命令一起改（见「换端口」） |
 | 页面跳转到登录页 | `snapshot -i` 找登录按钮并操作 |
 | `eval` 返回 `null` | 检查 localStorage key 名；含引号的 JS 用 `eval -b` 或 `--stdin` |
-| 登录态过期 | `setup-cdp-chrome.js 9222 --reset --yes` 重新拷贝 |
-| 有多个 Chrome profile | `--profile "Profile 1"` 指定 |
-| Chrome 不会启动（30s 超时） | 试 `--reset`；检查端口冲突；查看 `~/chrome-debug-profile/` 是否损坏 |
+| 登录态过期 | `setup-cdp-chrome.js 9222 --reset`，按同意流程先 dry-run、同意后加 `--yes` |
+| 有多个 Chrome profile | `--profile "Profile 1"` 指定；显式传 `--profile` 会重建，按同意流程 |
+| Chrome 不会启动（30s 超时） | 检查端口冲突；查看 `~/chrome-debug-profile/` 是否损坏；仍不行再按同意流程试 `--reset` |