@cloud411716/fancy-webnovel 2.2.0 → 3.0.0

package/plugins/fancy-story-builder/storydb/prompts.js

@@ -0,0 +1,952 @@
+/**
+ * Prompts for the storydb-native generation flow.
+ *
+ * Each stage prompt is self-contained:
+ *   1. what the model is producing
+ *   2. a command reference with purpose / when / example
+ *   3. a step-by-step workflow
+ *   4. one copyable `apply` payload
+ *   5. hard rules and recovery instructions
+ *   6. the stage-check completion gate
+ *
+ * The LLM writes through the storydb CLI. It never writes stage JSON files and
+ * never writes generator scripts.
+ */
+
+import { EDGES } from './definitions.js';
+
+const CLI = 'node <cli> --db <root>';
+
+
+function json(value) {
+  return JSON.stringify(value || {}, null, 2);
+}
+
+function edgeList(tables) {
+  return tables
+    .map((table) => {
+      const edge = EDGES[table];
+      return edge ? '- `' + table + '`：' + edge.in + ' -> ' + edge.out : null;
+    })
+    .filter(Boolean)
+    .join('\n');
+}
+
+function setup() {
+  return `## 工具入口
+
+本次**不使用 bash、不使用 storydb CLI、不直接改数据库文件**。所有读写都通过工具：
+
+- 读/分析：\`fancy_story_read\`，用 \`action\` 选择
+  \`status\` / \`schema\` / \`get\` / \`search\` / \`query\` / \`context\` / \`validate\` / \`stage_check\` / \`next\` / \`why\` / \`impact\`
+- 写：阶段批量用 \`fancy_story_apply_batch\`；自然语言写用 \`fancy_story_apply\`（会弹窗确认）
+- 导出：\`fancy_story_export\`
+- 项目/数据库：\`fancy_workspace\`、\`fancy_db\`
+
+如果客户端是把 MCP 工具直接暴露出来，名字可能是 \`story_status\` / \`story_schema\` / \`story_apply\`，或带 \`mcp__fancy__\` 前缀；看到哪种就用哪种。不要自己拼 shell 命令。`;
+}
+
+function rules(options = {}) {
+  const perChapter = options.perChapter
+    ? '\n6. 章节用 \`fancy_story_apply_batch\` 的 \`perChapter: true\` + `chapters: [...]` 分批提交，每批 5-10 章；超过 10 章会被 `BATCH_TOO_LARGE` 拒绝。每章是一个独立事务；某章失败只回滚该章。'
+    : '';
+  const decisionNo = options.perChapter ? 7 : 6;
+  const parallelNo = decisionNo + 1;
+  const reportNo = decisionNo + 2;
+  const refs = options.refs
+    ? `\n## 参考资料\n\n先读项目里这些文件，再动手设计；不要凭记忆编造公式、节奏或文风要求。\n\n${options.refs}\n`
+    : '';
+  return `## 铁律
+
+1. 不写 \`设定/**/*.json\`，不运行旧的 \`build\` 命令，不读插件源码。
+2. 不要写 Node/Python/Shell 生成脚本，也不要用 \`python3 - <<\` / \`node -e\` 修改 JSON。要批量写入就分多次 \`fancy_story_apply_batch\`；章节用 \`perChapter: true\`，每批最多 10 章。
+3. 写入分两种：
+   - 当前是 \`/fancy-build\` 阶段：用 \`fancy_story_apply_batch\`。用户已经显式发起阶段，不需要逐批确认；工具内部会先预览再提交。
+   - 用户用自然语言要求改数据：用 \`fancy_story_apply\`；它会先预览并弹窗要求用户确认。
+   一个 apply 是一个事务；失败会回滚，错误原文会返回给你。
+4. 先查再写。不要编造 ID；引用人物/势力/地点/伏笔/爽点/信息差之前，先用 \`fancy_story_read\`、\`fancy_story_read\` 或 \`fancy_story_read\` 确认。
+5. 缺细节可以先用 \`status: "seed"\` 或 \`status: "draft"\` 占位；不要把未完成的记录标成 \`complete\`。${perChapter}
+${decisionNo}. 每个 \`fancy_story_apply_batch\` 至少带一条 \`decisions\`（subject / text / reason），说明这次为什么这样写。决策和数据同事务。
+${parallelNo}. **不要使用 subagent 并行写同一个项目。** 服务端支持多客户端，但同一章的并发写入仍会互相覆盖；一个项目同一时间只让一个写手提交。
+${reportNo}. 不要把判断写成“需要你知道”“请确认”之类的聊天汇报。需要保留的判断写进 \`decisions\`；结束时只报告 \`fancy_story_read\` 结果和关键计数。
+
+## 表结构怎么查
+
+不要背表结构，也不要要求把整份 schema 塞进上下文。先查再用：
+
+- 列出全部表：\`fancy_story_read {"action":"schema"}\`
+- 看某张表：\`fancy_story_read {"action":"schema","table":"<表名>"}\`（字段、必填、枚举、关联边）
+- 查几条记录：\`fancy_story_read {"action":"search","kind":"<表名>","where":{"字段":"值"},"limit":20}\`
+- 只取需要的列：\`fancy_story_read {"action":"query","sql":"SELECT entity_id AS id, name, type FROM character ORDER BY entity_id"}\`
+- 不要用 \`grep\` / \`awk\` / \`node -e\` 解析工具输出；工具返回的就是结构化 JSON。
+- 边表也能 \`fancy_story_read\`（例如 \`fancy_story_read {"action":"search","kind":"foreshadow_payoff","limit":20}\`）；边不要用 \`update\`，重新 \`link\` 同一条边会覆盖它的 data。
+
+实体表：\`story\`、\`scale\`、\`volume\`、\`act\`、\`world_doc\`、\`story_doc\`、\`line\`、\`line_node\`、\`ending\`、\`role_slot\`、\`character\`、\`faction\`、\`location\`、\`item\`、\`conflict\`、\`foreshadow\`、\`payoff\`、\`climax\`、\`information\`、\`chapter\`、\`outline\`、\`scene\`、\`chapter_text\`、\`handoff\`。
+
+边表：\`has_volume\`、\`has_act\`、\`has_chapter\`、\`chapter_cast\`、\`chapter_location\`、\`chapter_line_node\`、\`chapter_branch\`、\`chapter_conflict\`、\`chapter_climax\`、\`chapter_item\`、\`relation\`、\`faction_relation\`、\`membership\`、\`conflict_participant\`、\`climax_participant\`、\`foreshadow_payoff\`、\`foreshadow_action\`、\`payoff_action\`、\`info_action\`、\`ending_action\`、\`outline_scene\`、\`outline_cast\`、\`outline_location\`、\`outline_foreshadow\`、\`scene_cast\`、\`scene_location\`、\`scene_foreshadow\`。
+
+ID 规则：
+
+- \`create\` 的 ID 放在 \`data.id\`（人物、势力、地点、道具、冲突、伏笔、爽点、高潮、信息差）；\`update\` 的 ID 放在 \`id\`。
+- 卷/幕/线索/节点/结局/功能位用各自的 \`volume_id\`、\`act_id\`、\`line_id\`、\`node_id\`、\`ending_id\`、\`role_id\`。
+- 章节用 \`chapter_id\`（如 \`CH341\`）；细纲/正文/交接也用 \`chapter_id\`。
+- \`scale\`、\`world_doc\`、\`story_doc\` 是单例，不需要 ID。
+- 场景 \`scene\` 的 ID 自动是 \`SC_<chapter_id>_<scene_order>\`，例如 \`scene:SC_CH341_1\`。
+
+${refs}`;
+}
+
+function applyFormat() {
+  return `## apply 的格式
+
+\`\`\`json
+{
+  "workflow": "rhythm",
+  "summary": "第 341-342 章",
+  "ops": [
+    { "op": "create", "kind": "chapter", "data": { "chapter_id": "CH341" } },
+    { "op": "link", "edge": "chapter_cast", "from": "chapter:CH341", "to": "character:C001", "data": { "role": "pov" } },
+    { "op": "knowledge", "data": { "chapter_id": "CH341", "subject_type": "foreshadow", "subject_id": "FS001", "character_id": "C001", "change": "learns", "coverage": "partial" } }
+  ],
+  "decisions": [
+    { "subject": "chapter:CH341", "text": "第 341 章承担公开复核表的转折", "reason": "承接上一章的反对者" }
+  ]
+}
+\`\`\`
+
+> 用 \`fancy_story_apply_batch\` 提交这份参数；它会先预览再写入。自然语言写入请改用 \`fancy_story_apply\`。
+
+可用的 op：
+
+| op | 作用 | 关键字段 |
+| --- | --- | --- |
+| \`create\` | 新建或覆盖一条实体 | \`kind\`、\`data\` |
+| \`update\` | 局部修改已有实体 | \`kind\`、\`id\`、\`data\` |
+| \`link\` | 新建或覆盖一条边 | \`edge\`、\`from\`、\`to\`、\`data\` |
+| \`unlink\` | 删除一条边 | \`edge\`、\`from\`、\`to\`，可加 \`data.action\` |
+| \`knowledge\` | 记录一次知识变化 | \`data\`（见 knowledge_event 表） |`;
+}
+
+// ---------------------------------------------------------------------------
+// scale
+// ---------------------------------------------------------------------------
+
+export function buildScalePrompt(ctx) {
+  return `# scale：确定故事的规模骨架
+
+你要为一本网文确定：总章数、总字数、卷、幕、每卷/幕的章节区间和各类实体配额。结果写入 SurrealDB 故事图，不写文件。
+
+## 本阶段产出
+
+- \`scale:main\`：容量、结构、配额、节奏预算。
+- \`volume\`：每卷的 \`chapter_start\` / \`chapter_end\`。
+- \`act\`：每幕的 \`chapter_start\` / \`chapter_end\`，挂到所属卷。
+- 边：\`has_volume\`（story -> volume）、\`has_act\`（volume -> act）。
+
+${setup()}
+
+${rules({ refs: '- `references/formulas-skeleton.json`：数量公式和硬上限\n- `references/genre-profiles.json`：题材参数、卷长、倍率' })}
+
+## 工具速查
+
+| 目的 | 工具调用 | 什么时候用 |
+| --- | --- | --- |
+| 看当前故事/规模 | \`fancy_story_read {"action":"status"}\` | 开始前，确认没有残留规模数据 |
+| 看表结构 | \`fancy_story_read {"action":"schema","table":"scale"}\`、\`fancy_story_read {"action":"schema","table":"volume"}\`、\`fancy_story_read {"action":"schema","table":"act"}\` | 第一次写这三张表前 |
+| 提交规模和卷/幕 | \`fancy_story_preview\` → \`fancy_story_apply_batch\` | 全部算好后一次提交 |
+| 检查完成度 | \`fancy_story_read {"action":"stage_check","stage":"scale"}\` | 提交后，必须通过 |
+| 看已写入的卷 | \`fancy_story_read {"action":"search","kind":"volume","limit":50}\` | 需要确认卷区间时 |
+
+## 执行步骤
+
+1. 如果项目里存在 \`references/formulas-skeleton.json\` 或 \`references/genre-profiles.json\`，先读它们，用里面的公式和题材参数计算；不存在就按选题和常识计算。
+2. 计算并写死这些数：
+   - \`target_chapters\`、\`target_words\`、\`avg_words_per_chapter\`
+   - 卷数、每卷的 \`chapter_start\` / \`chapter_end\`
+   - 每卷的幕数、每幕的 \`chapter_start\` / \`chapter_end\`
+   - 人物/势力/地点/道具/冲突/伏笔/高潮/爽点/结局的配额
+3. 用一次 \`apply\` 写入 \`scale:main\`、所有 \`volume\`、所有 \`act\`，以及 \`has_volume\` / \`has_act\` 边。
+4. 运行 \`fancy_story_read {"action":"stage_check","stage":"scale"}\`，直到 \`ok: true\`。
+
+## 选题
+
+\`\`\`json
+${json(ctx.topic)}
+\`\`\`
+
+## 边
+
+- \`has_volume\`：story -> volume
+- \`has_act\`：volume -> act
+
+## 可复制的提交示例
+
+把下面的数字换成你算出的结果。卷和幕的数量按实际增减。
+
+参数（用 \`fancy_story_apply_batch\` 提交；它会先预览再写入）：
+
+\`\`\`json
+{
+  "workflow": "scale",
+  "summary": "500 章 / 5 卷 / 15 幕",
+  "ops": [
+    {
+      "op": "create",
+      "kind": "scale",
+      "data": {
+        "capacity": { "target_chapters": 500, "target_words": 1500000, "avg_words_per_chapter": 3000 },
+        "structure": { "volume_count": 5, "acts_per_volume": 3 },
+        "quotas": {
+          "characters": { "protagonist": 1, "core_supporting": 6, "volume_supporting": 30, "core_antagonist": 2, "volume_antagonist": 3 },
+          "factions": 8,
+          "locations": 30,
+          "items": { "core": 5, "branch": 20, "symbolic": 10 },
+          "conflicts": { "core": 1, "phase": 15, "branch": 30 },
+          "foreshadows": { "small": 60, "medium": 30, "large": 10 },
+          "climaxes": { "small": 20, "medium": 10, "large": 5 },
+          "pleasures": { "small": 80, "medium": 35, "large": 12 },
+          "endings": 3
+        },
+        "rhythm_budget": {},
+        "distribution": {},
+        "constraints": {},
+        "formulas": {},
+        "derivations": {},
+        "status": "draft"
+      }
+    },
+    { "op": "create", "kind": "volume", "data": { "volume_id": "V001", "title": "第一卷", "chapter_start": 1, "chapter_end": 100, "goal": "建立秩序", "status": "draft" } },
+    { "op": "create", "kind": "act", "data": { "act_id": "A001", "volume_id": "V001", "act_index": 1, "chapter_start": 1, "chapter_end": 33, "goal": "进入新环境", "status": "draft" } },
+    { "op": "link", "edge": "has_volume", "from": "story:main", "to": "volume:V001", "data": {} },
+    { "op": "link", "edge": "has_act", "from": "volume:V001", "to": "act:A001", "data": {} }
+  ],
+  "decisions": [
+    { "subject": "scale:main", "text": "按 500 章、5 卷、每卷 3 幕切分", "reason": "题材公式给出的中长线容量" }
+  ]
+}
+\`\`\`
+
+## 完成标准
+
+- \`scale:main\` 存在，\`capacity\` / \`quotas\` / \`structure\` 不为空。
+- 所有卷覆盖 \`1..target_chapters\`，卷内幕区间连续、不重叠。
+- \`fancy_story_read {"action":"stage_check","stage":"scale"}\` 返回 \`ok: true\`。
+`;
+}
+
+// ---------------------------------------------------------------------------
+// macro
+// ---------------------------------------------------------------------------
+
+export function buildMacroPrompt(ctx) {
+  return `# macro：补世界观、故事、线索、结局和功能位
+
+scale 已经给出卷/幕骨架。现在在骨架上补：世界观、故事核心、主线/支线、主线节点、结局、角色功能位，并给卷/幕补目标。
+
+## 本阶段产出
+
+- \`world_doc\`：世界观前提、主题、规则、力量体系、社会秩序、禁忌、意象、读者承诺。
+- \`story_doc\`：核心问题、核心冲突、结构、反套路、承诺。
+- \`line\` + \`line_node\`：至少 1 条主线，主线拆成若干节点，节点落到真实卷/幕。
+- \`ending\`：至少 1 个结局，写明要回收的伏笔 ID。
+- \`role_slot\`：主角、核心配角、反派等功能位。
+- 需要时给已有 \`volume\` / \`act\` 补 \`goal\`、\`core_conflict\`、\`emotional_arc\`、\`ending_hook\`。
+
+${setup()}
+
+${rules({ refs: '- `references/骨架指导/`：卷纲、幕纲、主支线的写法\n- `references/glossary.md`、`references/index.md`：术语和目录约定' })}
+
+## 工具速查
+
+| 目的 | 工具调用 | 什么时候用 |
+| --- | --- | --- |
+| 看已有规模 | \`fancy_story_read {"action":"search","kind":"volume","limit":50}\`、\`fancy_story_read {"action":"search","kind":"act","limit":100}\` | 开始前，确认卷/幕 ID |
+| 看表结构 | \`fancy_story_read {"action":"schema","table":"world_doc"}\`、\`schema story_doc\`、\`schema line\`、\`schema line_node\`、\`schema ending\`、\`schema role_slot\` | 写对应表前 |
+| 看某个卷/幕 | \`fancy_story_read {"action":"get","kind":"volume","id":"V001"}\`、\`fancy_story_read {"action":"get","kind":"act","id":"A001"}\` | 需要补目标时 |
+| 提交 | \`fancy_story_preview\` → \`fancy_story_apply_batch\` | 一批实体 + 边写完后 |
+| 检查 | \`fancy_story_read {"action":"stage_check","stage":"macro"}\` | 提交后，必须通过 |
+
+## 执行步骤
+
+1. 先看 \`fancy_story_read {"action":"status"}\`，确认 scale 已存在、macro 还没有写完。
+2. 写 \`world_doc\`：世界观前提、主题、规则、力量体系、社会秩序、禁忌、意象、读者承诺。
+3. 写 \`story_doc\`：核心问题、核心冲突、结构、反套路、承诺。
+4. 写 1 条主线和若干支线；每条主线至少拆 3 个 \`line_node\`，节点要落到卷/幕。
+5. 写 \`ending\`：至少一个主结局，注明需要回收的伏笔 ID。
+6. 写 \`role_slot\`：主角、核心配角、反派等功能位，后面 cast 会按这些槽位建人物。
+7. 需要时用 \`update\` 给已有 \`volume\` / \`act\` 补 \`goal\`、\`core_conflict\`、\`emotional_arc\`、\`ending_hook\`。
+8. 运行 \`fancy_story_read {"action":"stage_check","stage":"macro"}\`，直到通过。
+
+## 上游 scale
+
+\`\`\`json
+${json(ctx.scale)}
+\`\`\`
+
+## 边
+
+- \`has_volume\`：story -> volume（scale 已写）
+- \`has_act\`：volume -> act（scale 已写）
+
+## 可复制的提交示例
+
+参数（用 \`fancy_story_apply_batch\` 提交；它会先预览再写入）：
+
+\`\`\`json
+{
+  "workflow": "macro",
+  "summary": "世界观 / 主线 / 结局 / 功能位",
+  "ops": [
+    { "op": "create", "kind": "world_doc", "data": { "premise": "资源枯竭后的城市靠配给维持秩序", "theme": ["秩序", "公平"], "tone": "冷峻", "world_rules": ["配给表公开可查"], "status": "draft" } },
+    { "op": "create", "kind": "story_doc", "data": { "core_question": "公开的秩序能不能被真正执行", "core_conflict": "主角坚持公开，既得利益者要求私下分配", "status": "draft" } },
+    { "op": "create", "kind": "line", "data": { "line_id": "M001", "kind": "main", "name": "重建配给秩序", "goal": "让配给表公开且可复核", "status": "draft" } },
+    { "op": "create", "kind": "line_node", "data": { "node_id": "M001-01", "line_id": "M001", "volume": "V001", "act": "A001", "goal": "第一次公开复核", "status": "draft" } },
+    { "op": "create", "kind": "ending", "data": { "ending_id": "E001", "level": "主线", "type": "阶段性胜利", "direction": "秩序被保留，但代价被看见", "required_foreshadow_recovery": ["FS001"], "status": "draft" } },
+    { "op": "create", "kind": "role_slot", "data": { "role_id": "R001", "name": "主角", "slot_function": "推动公开复核", "quota_key": "protagonist", "status": "draft" } },
+    { "op": "update", "kind": "volume", "id": "V001", "data": { "goal": "建立新秩序", "core_conflict": "公开与私分的冲突" } }
+  ],
+  "decisions": [
+    { "subject": "line:M001", "text": "主线围绕公开配给表推进", "reason": "核心问题需要一个可被章节验证的动作" }
+  ]
+}
+\`\`\`
+
+## 完成标准
+
+- \`world_doc\`、\`story_doc\` 各至少 1 条。
+- 至少 1 条主线、3 个主线节点、1 个结局、若干 \`role_slot\`。
+- 主线节点引用的卷/幕真实存在。
+- \`fancy_story_read {"action":"stage_check","stage":"macro"}\` 返回 \`ok: true\`。
+`;
+}
+
+// ---------------------------------------------------------------------------
+// cast
+// ---------------------------------------------------------------------------
+
+export function buildCastPrompt(ctx) {
+  return `# cast：建立人物、势力、地点、冲突和伏笔网络
+
+scale 给出配额，macro 给出主线/结局/功能位。现在按配额补齐实体和它们之间的关系，建立后面 rhythm 能直接引用的 ID 网络。
+
+## 本阶段产出
+
+- 按配额补齐 \`character\`、\`faction\`、\`location\`、\`item\`、\`conflict\`、\`foreshadow\`、\`payoff\`、\`climax\`、\`information\`。
+- 建立 \`relation\`、\`faction_relation\`、\`membership\`、\`conflict_participant\`、\`climax_participant\`、\`foreshadow_payoff\`。
+- 人物绑定 \`role_slot\`；伏笔/爽点成对规划，具体章节动作留到 rhythm。
+
+${setup()}
+
+${rules({ refs: '- `references/血肉指导/`：人物、势力、冲突、伏笔的写法\n- `references/genre-profiles.json`、`references/glossary.md`：题材约束和术语' })}
+
+## 工具速查
+
+| 目的 | 工具调用 | 什么时候用 |
+| --- | --- | --- |
+| 看总进度 | \`fancy_story_read {"action":"status"}\` | 每批写入后 |
+| 看配额 | \`fancy_story_read {"action":"get","kind":"scale","id":"main"}\` | 开始前，确认还缺多少 |
+| 看表结构 | \`fancy_story_read {"action":"schema","table":"character"}\` 等 | 第一次写某张表前 |
+| 找已有实体 | \`fancy_story_read {"action":"search","kind":"character","where":{"type":"主角"}}\`、\`fancy_story_read {"action":"search","kind":"foreshadow","limit":200}\` | 避免重复 ID |
+| 看单个实体 | \`fancy_story_read {"action":"get","kind":"character","id":"C001"}\` | 写关系前确认存在 |
+| 提交 | \`fancy_story_preview\` → \`fancy_story_apply_batch\` | 每批 10-20 个实体 |
+| 检查 | \`fancy_story_read {"action":"stage_check","stage":"cast"}\` | 每批后/结束 |
+
+## 执行步骤
+
+1. \`fancy_story_read {"action":"status"}\`，再 \`fancy_story_read {"action":"get","kind":"scale","id":"main"}\` 看配额。
+2. 按这个顺序写，先实体后关系：
+   - \`faction\` → \`location\` → \`character\`（绑定 \`role_slot\`）
+   - \`item\` → \`conflict\` → \`foreshadow\` → \`payoff\` → \`climax\` → \`information\`
+   - 最后写 \`relation\`、\`faction_relation\`、\`membership\`、\`conflict_participant\`、\`climax_participant\`、\`foreshadow_payoff\`
+3. 每个实体必须有稳定 ID。人物 \`role_slot\` 指向 macro 里已有的 \`role_slot.role_id\`。
+4. 伏笔和爽点要成对规划：每个 \`foreshadow\` 至少有 plant 和 reveal 的回收目标；每个 \`payoff\` 至少有 setup 和 payoff 的兑现方向。这里只写实体，不写具体章节动作（章节动作在 rhythm）。
+5. 每批 10-20 个实体提交一次；失败按错误原文改那一批。
+6. 全部写完后运行 \`fancy_story_read {"action":"stage_check","stage":"cast"}\`。数量不足会报 \`STAGE_INCOMPLETE\`，按 \`expected/actual\` 补。
+
+## 上游配额
+
+\`\`\`json
+${json(ctx.quotas)}
+\`\`\`
+
+## 上游 macro
+
+\`\`\`json
+${json(ctx.macro)}
+\`\`\`
+
+## 边
+
+${edgeList(['relation', 'faction_relation', 'membership', 'conflict_participant', 'climax_participant', 'foreshadow_payoff'])}
+
+## 可复制的提交示例
+
+参数（用 \`fancy_story_apply_batch\` 提交；它会先预览再写入）：
+
+\`\`\`json
+{
+  "workflow": "cast",
+  "summary": "第一批：主角 / 核心配角 / 地点 / 伏笔",
+  "ops": [
+    { "op": "create", "kind": "character", "data": { "id": "C001", "name": "沈砚", "type": "主角", "role_slot": "R001", "goal": { "external": "查清配给表被改的真相", "internal": "证明自己不是靠关系上位" }, "flaw": "不信任体制内的人", "status": "draft" } },
+    { "op": "create", "kind": "character", "data": { "id": "C002", "name": "韩雨棠", "type": "核心配角", "role_slot": "R002", "goal": { "external": "保住复核组" }, "status": "draft" } },
+    { "op": "create", "kind": "location", "data": { "id": "L001", "name": "配给公示栏", "type": "公共空间", "narrative_function": "公开与私下的冲突现场", "status": "draft" } },
+    { "op": "create", "kind": "foreshadow", "data": { "id": "FS001", "name": "空白的来源栏", "type": "medium", "setup": "公示表上有一栏永远空白", "payoff_target": "配给来源被调包", "scope": "book", "status": "draft" } },
+    { "op": "create", "kind": "payoff", "data": { "id": "P001", "name": "当众念完复核表", "scale": "medium", "setup": "有人要求先私下看", "payoff": "主角坚持当场念完", "status": "draft" } },
+    { "op": "link", "edge": "relation", "from": "character:C001", "to": "character:C002", "data": { "kind": "合作", "initial_state": "互相试探" } },
+    { "op": "link", "edge": "foreshadow_payoff", "from": "foreshadow:FS001", "to": "payoff:P001", "data": { "relation": "揭示来源" } }
+  ],
+  "decisions": [
+    { "subject": "character:C001", "text": "主角设定为复核执行者", "reason": "主线需要一个能推动公开复核的人" }
+  ]
+}
+\`\`\`
+
+## 完成标准
+
+- 各类实体数量达到 scale 配额。
+- 所有边引用的实体都存在（DB 会拒绝悬空边）。
+- 人物都绑定了 \`role_slot\`。
+- \`fancy_story_read {"action":"stage_check","stage":"cast"}\` 返回 \`ok: true\`。
+`;
+}
+
+// ---------------------------------------------------------------------------
+// rhythm
+// ---------------------------------------------------------------------------
+
+export function buildRhythmPrompt(ctx) {
+  const target = (ctx.scale && ctx.scale.capacity && ctx.scale.capacity.target_chapters)
+    || (ctx.topic && ctx.topic.target_chapters)
+    || 0;
+  return `# rhythm：把设定落到每一章
+
+你要为第 1 章到第 ${target || '目标'} 章建立 \`chapter\` 节点，并写清每章的：谁出场、在哪、推进哪条线、制造什么冲突、埋/收哪个伏笔、铺垫/兑现哪个爽点、章末钩子。完成后 \`stage-check rhythm\` 必须通过。
+
+## 本阶段产出
+
+- \`chapter\`：覆盖 \`1..target\`，\`display_no\` 连续。
+- 每章至少 1 条 \`chapter_cast\`，POV 用 \`role: "pov"\`；至少 1 条 \`chapter_location\`。
+- 按需要写 \`chapter_line_node\` / \`chapter_branch\` / \`chapter_conflict\`。
+- 有高潮的章写 \`chapter_climax\`；有明确道具的章写 \`chapter_item\`。
+- 按节奏写 \`foreshadow_action\` / \`payoff_action\` / \`info_action\`，必要时写 \`knowledge\`。
+- 每章至少一条 \`decisions\`。
+
+${setup()}
+
+${rules({ perChapter: true, refs: '- `references/节奏指导/`：章节节奏、钩子、情绪曲线\n- `references/formulas-rhythm.json`、`references/genre-profiles.json`：节奏参数' })}
+
+## 工具速查
+
+| 目的 | 工具调用 | 什么时候用 |
+| --- | --- | --- |
+| 看总进度 | \`fancy_story_read {"action":"status"}\` | 开始前、每批后 |
+| 看已有章节 | \`fancy_story_read {"action":"search","kind":"chapter","limit":20}\` | 规划下一批前，避免重复 |
+| 看卷/幕 ID | \`fancy_story_read {"action":"search","kind":"volume","limit":50}\`、\`fancy_story_read {"action":"search","kind":"act","limit":100}\` | 不确定章节归属时 |
+| 查人物/伏笔/爽点 | \`fancy_story_read {"action":"get","kind":"character","id":"C001"}\`、\`fancy_story_read {"action":"get","kind":"foreshadow","id":"FS001"}\`、\`fancy_story_read {"action":"search","kind":"payoff","limit":500}\` | 需要具体设定时 |
+| 看单章上下文 | \`fancy_story_read {"action":"context","chapter":341,"prev":3}\` | 写/修某一章前；会返回该章已有的动作和知识事件 |
+| 看实体关系 | \`fancy_story_read {"action":"context","entity":"foreshadow:FS012"}\` | 不确定伏笔埋设/回收时 |
+| 提交章节 | \`fancy_story_preview\` → \`fancy_story_apply_batch\`（\`perChapter: true\`） | 每 5-10 章提交一次 |
+| 检查 | \`fancy_story_read {"action":"stage_check","stage":"rhythm"}\` | 每批后/结束，必须通过 |
+| 修单条动作 | \`fancy_story_apply_batch {"ops":[{"op":"unlink","edge":"payoff_action","from":"chapter:CH341","to":"payoff:P001","data":{"action":"setup"}}]}\` | 只删动作，不重写整章时 |
+
+## 执行步骤
+
+1. 先 \`fancy_story_read {"action":"status"}\` 和 \`fancy_story_read {"action":"search","kind":"chapter","limit":20}\`，确认已有章节和下一批起点。
+2. 按卷、按幕、按章号递增规划。每章至少回答：
+   - 这一章推进哪条主线/支线节点？
+   - 谁出场，POV 是谁？
+   - 时间（\`story_day\`）和地点是什么？
+   - 这一章的核心冲突和转折是什么？
+   - 章末钩子是什么？连续 3 章不能同类型。
+   - 本章要埋/推进/回收哪些伏笔？要 setup/payoff 哪些爽点？要创建/推进/解决哪些信息差？
+3. 每 5-10 章提交一次 \`apply perChapter: true\`。每章是完整替换：默认会清掉该章原有的 cast/action 边，再写你这次提交的边，所以每章要把该章的边写全。
+4. 每批后运行 \`fancy_story_read {"action":"stage_check","stage":"rhythm"}\`。只修 \`errors\`；\`warnings\` 不阻断，但要看一眼。
+5. 最后确认章节覆盖 1..${target || 'target'}、每章至少 1 个 cast。
+
+## 上游规模
+
+\`\`\`json
+${json(ctx.scale)}
+\`\`\`
+
+## 上游 cast（只给数量；具体实体用 query/search 查）
+
+\`\`\`json
+${json(ctx.cast && ctx.cast.counts)}
+\`\`\`
+
+## 主线/支线节点
+
+\`\`\`json
+${json({
+    lines: (ctx.macro && ctx.macro.lines) || [],
+    nodes: (ctx.macro && ctx.macro.nodes) || [],
+  })}
+\`\`\`
+
+## 一张章节图要写的字段
+
+写之前运行 \`fancy_story_read {"action":"schema","table":"chapter"}\` 和 \`fancy_story_read {"action":"schema","table":"knowledge_event"}\`。必填字段以 schema 为准；本章 example 只展示写法。
+
+## 边
+
+${edgeList(['has_chapter', 'chapter_cast', 'chapter_location', 'chapter_line_node', 'chapter_branch', 'chapter_conflict', 'chapter_climax', 'chapter_item', 'foreshadow_action', 'payoff_action', 'info_action', 'ending_action'])}
+
+## 可复制的两章提交示例
+
+下面的 ID 只是示例，必须换成 DB 里真实存在的 ID。每章都要有自己的 \`decisions\`。
+
+参数（用 \`fancy_story_apply_batch\` 提交；它会先预览再写入）：
+
+\`\`\`json
+{
+  "perChapter": true,
+  "workflow": "rhythm",
+  "summary": "第 341-342 章",
+  "chapters": [
+    {
+      "chapter": "CH341",
+      "ops": [
+        { "op": "create", "kind": "chapter", "data": {
+          "chapter_id": "CH341",
+          "display_no": 341,
+          "title": "第一张复核表",
+          "volume": "V004",
+          "act": "A012",
+          "pov": "C001",
+          "time": { "story_day": 318, "clock": "20:00-21:00", "duration_minutes": 60 },
+          "why": { "main_line_nodes": ["M001-12"], "branch_nodes": ["B003"], "conflict": ["X033"], "theme": "秩序要能被核对", "stakes": "配额表一旦公开就不能再改" },
+          "how": { "function_main": "推进重建秩序", "function_aux": "回收 FS012 的铺垫", "turn": "公开的配额表逼出第一个反对者", "ending_hook": "反对者拿出另一本账" },
+          "emotion": { "phase": "紧绷", "value": 4 },
+          "hook": { "type": "突然揭示", "strength": "强" },
+          "word_target": 2400,
+          "status": "draft"
+        } },
+        { "op": "link", "edge": "has_chapter", "from": "act:A012", "to": "chapter:CH341", "data": {} },
+        { "op": "link", "edge": "chapter_cast", "from": "chapter:CH341", "to": "character:C001", "data": { "role": "pov" } },
+        { "op": "link", "edge": "chapter_cast", "from": "chapter:CH341", "to": "character:C027", "data": { "role": "cast" } },
+        { "op": "link", "edge": "chapter_location", "from": "chapter:CH341", "to": "location:L011", "data": {} },
+        { "op": "link", "edge": "chapter_line_node", "from": "chapter:CH341", "to": "line_node:M001-12", "data": {} },
+        { "op": "link", "edge": "chapter_conflict", "from": "chapter:CH341", "to": "conflict:X033", "data": {} },
+        { "op": "link", "edge": "foreshadow_action", "from": "chapter:CH341", "to": "foreshadow:FS012", "data": { "action": "plant", "chapter_no": 341, "detail": "来源栏第一次空着" } },
+        { "op": "link", "edge": "payoff_action", "from": "chapter:CH341", "to": "payoff:P086", "data": { "action": "setup", "chapter_no": 341, "detail": "有人要求先私下看" } },
+        { "op": "knowledge", "data": { "chapter_id": "CH341", "chapter_no": 341, "subject_type": "foreshadow", "subject_id": "FS012", "character_id": "C001", "change": "learns", "coverage": "partial", "knowledge": "来源栏可能被改过", "how": "witnessed", "scene": "公示栏", "evidence": "空白栏" } }
+      ],
+      "decisions": [
+        { "subject": "chapter:CH341", "text": "公开复核表逼出第一个反对者", "reason": "把主线从查账推进到公开对抗" }
+      ]
+    },
+    {
+      "chapter": "CH342",
+      "ops": [
+        { "op": "create", "kind": "chapter", "data": {
+          "chapter_id": "CH342",
+          "display_no": 342,
+          "title": "另一本账",
+          "volume": "V004",
+          "act": "A012",
+          "pov": "C001",
+          "time": { "story_day": 318, "clock": "21:00-22:00", "duration_minutes": 60 },
+          "why": { "main_line_nodes": ["M001-12"], "conflict": ["X033"], "theme": "账本的真实性", "stakes": "两本账必须有一本假的" },
+          "how": { "function_main": "推进冲突", "turn": "反对者拿出另一本账", "ending_hook": "两本账的签名一致" },
+          "emotion": { "phase": "紧张", "value": 5 },
+          "hook": { "type": "两难抉择", "strength": "强" },
+          "word_target": 2400,
+          "status": "draft"
+        } },
+        { "op": "link", "edge": "has_chapter", "from": "act:A012", "to": "chapter:CH342", "data": {} },
+        { "op": "link", "edge": "chapter_cast", "from": "chapter:CH342", "to": "character:C001", "data": { "role": "pov" } },
+        { "op": "link", "edge": "chapter_cast", "from": "chapter:CH342", "to": "character:C024", "data": { "role": "cast" } },
+        { "op": "link", "edge": "chapter_location", "from": "chapter:CH342", "to": "location:L011", "data": {} },
+        { "op": "link", "edge": "chapter_line_node", "from": "chapter:CH342", "to": "line_node:M001-12", "data": {} },
+        { "op": "link", "edge": "foreshadow_action", "from": "chapter:CH342", "to": "foreshadow:FS012", "data": { "action": "progress", "chapter_no": 342, "detail": "另一本账也有同一个空白来源栏" } },
+        { "op": "knowledge", "data": { "chapter_id": "CH342", "chapter_no": 342, "subject_type": "foreshadow", "subject_id": "FS012", "character_id": "C001", "change": "confirms", "coverage": "full", "knowledge": "两本账都被人改过", "how": "inferred", "scene": "公示栏", "evidence": "相同的空白栏" } }
+      ],
+      "decisions": [
+        { "subject": "chapter:CH342", "text": "用两本账把冲突升级", "reason": "上一章只是公开，这一章要让公开本身出问题" }
+      ]
+    }
+  ]
+}
+\`\`\`
+
+## 每章最低要求
+
+- \`chapter\` 的必填字段齐全，\`display_no\` 连续。
+- 至少 1 条 \`chapter_cast\`，POV 用 \`role: "pov"\`；每条 \`chapter_cast\` 都必须带 \`role\`（\`pov\` / \`cast\` / \`mentioned\`）。
+- 至少 1 条 \`chapter_location\`。
+- 推进主线的章要有 \`chapter_line_node\`；冲突在本章实际发生时才写 \`chapter_conflict\`，纯背景/威胁不要挂冲突边。
+- 冲突在本章实际出场的人物必须写 \`chapter_cast\`；\`conflict.participants\` 是整条冲突的参与者，不等于每章都出场。
+- 伏笔动作只写 \`plant\` / \`progress\` / \`reveal\`；爽点动作只写 \`setup\` / \`payoff\`；信息差只写 \`created\` / \`progressed\` / \`resolved\`。
+- 结局动作只写 \`ending_action\` + \`action: "close"\`，不要用 \`resolve\` 等其他值。
+- 有高潮的章写 \`chapter_climax\`；有明确道具的章写 \`chapter_item\`。
+- 知识事件只在人物对某事的知道程度发生变化时写；同一章、同一人物、同一对象只写一条。
+
+## 硬规则（违反会被 DB 拒绝）
+
+- \`PAYOFF_ORDER\`：\`setup\` 必须早于 \`payoff\`。先写 setup 章，再写 payoff 章；不要先兑现后铺垫。
+- \`FORESHADOW_ORDER\`：\`plant\` 必须早于 \`progress\` / \`reveal\`；\`reveal\` 之后不能再 \`plant\`。
+- \`knowledge_rules\`：
+  - \`learns\` → \`partial\` 或 \`full\`
+  - \`partially_learns\` → \`partial\`
+  - \`confirms\` → \`full\`，且此前不能是 \`unknown\`
+  - \`corrects\` → \`partial\` 或 \`full\`
+  - \`forgets\` → \`unknown\`
+  - \`misinforms\` → \`false\`
+  - \`how: "told"\` 必须写 \`source_character_id\`
+- \`HOOK_REPEAT\`：连续 3 章不能使用同一个 \`hook.type\`。
+- \`TIME_REGRESSION\`：\`time.story_day\` 不能比上一章小；闪回必须写 \`time.flashback: true\`。
+- \`CHAPTER_VOLUME\` / \`CHAPTER_ACT\`：章节引用的卷/幕必须已经存在。
+- 所有 \`from\` / \`to\` 引用的实体必须已经存在，否则会报悬空引用。
+
+## 出错怎么修
+
+- \`apply\` 返回 \`ok: false\`：看 \`error.message\` 和 \`detail.op_index\`，只改那个 op 后重新提交；不要重写整批。
+- \`stage-check\` 返回 \`ok: false\`：只处理 \`errors\`；\`warnings\` 是提示，不阻断。
+- \`PAYOFF_ORDER\`：用 \`fancy_story_read {"action":"context","entity":"payoff:Pxxx"}\` 看 setup/payoff 章号；把 setup 放到更早的章，或把 payoff 放到 setup 之后。重写某一章时直接重新提交该章（\`perChapter: true\` 会替换该章旧动作）。
+- \`FORESHADOW_ORDER\`：先补 plant 章，再写 progress/reveal。
+- \`RHYTHM_CAST\`：给该章补 \`chapter_cast\`。
+- \`HOOK_REPEAT\`：改其中一章的 \`hook.type\`。
+- 缺章：用 \`fancy_story_read {"action":"search","kind":"chapter","limit":50}\` 找缺口，只补缺的章。
+
+## 完成标准
+
+- \`chapter\` 数量达到 target，\`display_no\` 覆盖 \`1..target\`。
+- 每章至少 1 个 cast。
+- 没有 \`PAYOFF_ORDER\` / \`FORESHADOW_ORDER\` / \`HOOK_REPEAT\` / \`TIME_REGRESSION\` 等硬错误。
+- \`fancy_story_read {"action":"stage_check","stage":"rhythm"}\` 返回 \`ok: true\`。
+`;
+}
+
+// ---------------------------------------------------------------------------
+// outline
+// ---------------------------------------------------------------------------
+
+export function buildOutlinePrompt(ctx) {
+  return `# outline：给每一章写可执行的细纲
+
+rhythm 已经有章节图。现在为每一章补 \`outline\` 和 \`scene\`：这一章必须写什么、不能写什么、分几个场景、每个场景的目标/阻碍/转折/结果、出场人物和地点。
+${ctx.selection && ctx.selection.all === false ? '\n## 本次范围\n\n本次只处理：' + ctx.selection.label + '。不要写其他章节；stage-check 也只检查这些章节。\n' : '\n## 本次范围\n\n本次处理全部章节。\n'}
+## 本阶段产出
+
+细纲不是“本章大概写什么”，而是正文写作的施工图。每章必须从 rhythm 图取全信息，不能只写两句概括。
+
+- 每章一条 \`outline\`：\`pov\`、\`time\`、\`why\`、\`must_write\`、\`must_not_write\`、\`continuity\`、\`ending\`。
+- \`must_write\` 至少 3-6 条具体事件；\`must_not_write\` 至少 2 条；不要写“推进剧情”“制造冲突”这种空话。
+- 每个 \`outline\` 一般 2-4 个 \`scene\`，至少 1 个；每个场景写清目标、阻碍、转折、结果、地点、出场人物。
+- 建 \`outline_scene\`、\`outline_cast\`、\`outline_location\`；有伏笔的章建 \`outline_foreshadow\`。
+- 本章如果 rhythm 已安排伏笔、爽点、信息差、高潮、道具，必须在 \`must_write\` 或场景里逐条落地，不能遗漏。
+- 正文要能只看这份细纲就写出来；写到写阶段还需要猜的内容，说明细纲不合格。
+
+${setup()}
+
+${rules({ perChapter: true, refs: '- `references/节奏指导/`：细纲的 must_write / must_not_write 和场景写法\n- `references/formulas-rhythm.json`：节奏参数' })}
+
+## 工具速查
+
+| 目的 | 工具调用 | 什么时候用 |
+| --- | --- | --- |
+| 看总进度 | \`fancy_story_read {"action":"status"}\` | 开始前、每批后 |
+| 看已有章节 | \`fancy_story_read {"action":"search","kind":"chapter","limit":20}\` | 规划下一批前 |
+| 看单章上下文 | \`fancy_story_read {"action":"context","chapter":341,"prev":3}\` | 写每一章细纲前；包含章节图、cast、knowledge、已有 outline/scene |
+| 看表结构 | \`fancy_story_read {"action":"schema","table":"outline"}\`、\`fancy_story_read {"action":"schema","table":"scene"}\` | 第一次写之前 |
+| 提交 | \`fancy_story_preview\` → \`fancy_story_apply_batch\`（\`perChapter: true\`） | 每 5-10 章提交一次 |
+| 检查 | \`fancy_story_read {"action":"stage_check","stage":"outline"}\` | 每批后/结束，必须通过 |
+
+## 执行步骤
+
+1. \`fancy_story_read {"action":"status"}\`，确认 rhythm 已完成。
+2. 用 \`fancy_story_read {"action":"search","kind":"chapter","limit":20}\` 分批取章节，再用 \`fancy_story_read {"action":"context","chapter":N,"prev":3}\` 取单章上下文。处理完一批再取下一批，不要把全部章节一次塞进上下文。
+3. 每章先从 \`context\` 读出并核对：POV、时间、情绪、钩子、cast、地点、主线/支线节点、冲突、伏笔动作、爽点动作、信息差动作、高潮、道具。
+4. 每章写：
+   - \`outline\`：\`chapter_id\`、\`number\`、\`title\`、\`pov\`、\`time\`、\`why\`、\`must_write\`、\`must_not_write\`、\`continuity\`、\`ending\`
+   - 2-4 个 \`scene\`：\`outline_id\`、\`scene_order\`、\`goal\`、\`obstacle\`、\`turn\`、\`outcome\`、\`location\`、\`cast\`
+   - \`outline_scene\`、\`outline_cast\`、\`outline_location\` 边；伏笔章加 \`outline_foreshadow\` 边
+5. 写完后回查：本章的每个 \`chapter_cast\` / \`chapter_location\` / \`chapter_conflict\` / \`foreshadow_action\` / \`payoff_action\` / \`info_action\` / \`chapter_climax\` / \`chapter_item\` 是否都在细纲里有对应描述。没有就补 \`must_write\` 或场景。
+6. 每 5-10 章提交一次 \`apply perChapter: true\`；每章是独立事务。
+7. 全部写完后运行 \`fancy_story_read {"action":"stage_check","stage":"outline"}\`。
+
+## 提交前自检
+
+每章逐项打勾，缺一项就不要提交：
+
+- 出场人物：本章 \`chapter_cast\` 的每个人都出现了吗？
+- 地点：本章 \`chapter_location\` 的地点都写到了吗？
+- 伏笔：每个 \`foreshadow_action\` 的 plant/progress/reveal 都有对应情节吗？
+- 爽点：每个 \`payoff_action\` 的 setup/payoff 都有对应情节吗？
+- 信息差：每个 \`info_action\` 的建立/推进/解决都有对应情节吗？
+- 高潮/道具：有 \`chapter_climax\`/\`chapter_item\` 时写进正文了吗？
+- 情绪/钩子：本章 \`emotion\` 与 \`hook\` 和正文实际感受一致吗？
+- 长度：\`word_count\` 达到 \`word_target\` 的 80% 以上吗？
+
+## 上游进度
+
+\`\`\`json
+${json(ctx.summary)}
+\`\`\`
+
+## 边
+
+${edgeList(['outline_scene', 'outline_cast', 'outline_location', 'outline_foreshadow'])}
+
+## 可复制的单章提交示例
+
+参数（用 \`fancy_story_apply_batch\` 提交；它会先预览再写入）：
+
+\`\`\`json
+{
+  "perChapter": true,
+  "workflow": "outline",
+  "summary": "第 341 章细纲",
+  "chapters": [
+    {
+      "chapter": "CH341",
+      "ops": [
+        { "op": "create", "kind": "outline", "data": {
+          "chapter_id": "CH341",
+          "number": 341,
+          "title": "第一张复核表",
+          "pov": "C001",
+          "time": { "story_day": 318, "clock": "20:00-21:00", "duration_minutes": 60 },
+          "why": { "main_line_nodes": ["M001-12"], "conflict": ["X033"], "theme": "秩序要能被核对", "stakes": "配额表一旦公开就不能再改" },
+          "must_write": ["复核分配表的过程", "公开后第一个反对者的反应", "把 FS012 的来源栏空白拍在桌上", "P086 的 setup：有人要求先私下看"],
+          "must_not_write": ["不要用旁白总结制度", "不要让主角一次说服所有人"],
+          "continuity": { "from_prev": "承接上一章的反对者", "to_next": "账本被带走" },
+          "ending": { "type": "悬念", "text": "反对者把账本拍在桌上", "hook": "账本是从哪来的" },
+          "status": "draft"
+        } },
+        { "op": "create", "kind": "scene", "data": {
+          "outline_id": "CH341",
+          "scene_order": 1,
+          "goal": "把复核结果公开",
+          "obstacle": "有人要求先私下看",
+          "turn": "主角坚持当场念完",
+          "outcome": "公开成立，但埋下反对者",
+          "location": "L011",
+          "cast": ["C001", "C027"],
+          "status": "draft"
+        } },
+        { "op": "create", "kind": "scene", "data": {
+          "outline_id": "CH341",
+          "scene_order": 2,
+          "goal": "让反对者把另一本账拿出来",
+          "obstacle": "主角不能当众承认自己没核对过来源",
+          "turn": "账本上的签名和公示表一致",
+          "outcome": "两本账互相证明，冲突升级",
+          "location": "L011",
+          "cast": ["C001", "C027"],
+          "status": "draft"
+        } },
+        { "op": "link", "edge": "outline_scene", "from": "outline:CH341", "to": "scene:SC_CH341_1", "data": { "scene_order": 1 } },
+        { "op": "link", "edge": "outline_scene", "from": "outline:CH341", "to": "scene:SC_CH341_2", "data": { "scene_order": 2 } },
+        { "op": "link", "edge": "outline_cast", "from": "outline:CH341", "to": "character:C001", "data": { "role": "pov" } },
+        { "op": "link", "edge": "outline_location", "from": "outline:CH341", "to": "location:L011", "data": {} },
+        { "op": "link", "edge": "outline_foreshadow", "from": "outline:CH341", "to": "foreshadow:FS012", "data": { "intent": "plant" } }
+      ],
+      "decisions": [
+        { "subject": "outline:CH341", "text": "用公开念表作为本章核心动作", "reason": "承接 rhythm 的公开复核节点" }
+      ]
+    }
+  ]
+}
+\`\`\`
+
+## 完成标准
+
+- 每一章都有 \`outline\`，并且 \`pov\` / \`time\` / \`why\` 来自或对齐 rhythm 章节图。
+- 每个 \`outline\` 一般 2-4 个 \`scene\`，至少 1 个，且通过 \`outline_scene\` 连上。
+- 每章都有 \`outline_cast\` 和 \`outline_location\`；有伏笔的章有 \`outline_foreshadow\`。
+- \`must_write\` 至少 3 条具体事件，\`must_not_write\` 非空。
+- rhythm 图里本章的伏笔、爽点、信息差、高潮、道具都能在细纲里找到落点。
+- \`fancy_story_read {"action":"stage_check","stage":"outline"}\` 返回 \`ok: true\`。
+`;
+}
+
+// ---------------------------------------------------------------------------
+// writing
+// ---------------------------------------------------------------------------
+
+export function buildWritingPrompt(ctx) {
+  return `# write：按细纲写正文，并留下章末交接
+
+细纲已经写好。现在逐章写正文，写入 \`chapter_text\`，同时写 \`handoff\`，让下一章能接住地点、时间、人物和未结线索。
+${ctx.selection && ctx.selection.all === false ? '\n## 本次范围\n\n本次只处理：' + ctx.selection.label + '。不要写其他章节；stage-check 也只检查这些章节。\n' : '\n## 本次范围\n\n本次处理全部章节。\n'}
+## 本阶段产出
+
+- 每章一条 \`chapter_text\`：正文 \`content\` + \`word_count\`。
+- 每章一条 \`handoff\`：章末地点、时间、人物、未结线索、下一场提示、连贯性备注。
+- 正文覆盖 \`outline.must_write\`，不违反 \`must_not_write\`，按 \`outline.ending\` 收束。
+
+${setup()}
+
+${rules({ perChapter: true, refs: '- `references/写作指导/`：正文写法、去 AI 味、章节纪律\n- `references/genre-profiles.json`：题材语气和字数基准' })}
+
+## 工具速查
+
+| 目的 | 工具调用 | 什么时候用 |
+| --- | --- | --- |
+| 看总进度 | \`fancy_story_read {"action":"status"}\` | 开始前、每批后 |
+| 看已有章节 | \`fancy_story_read {"action":"search","kind":"chapter","limit":20}\` | 规划下一批前 |
+| 看单章上下文 | \`fancy_story_read {"action":"context","chapter":341,"prev":3}\` | 每章写正文前；包含细纲、场景、人物、地点、知识、前文结尾 |
+| 查前文关键词 | \`fancy_story_read {"action":"context","chapter":341,"prev":3,"search":"账本"}\` | 不确定前文是否提过某物时 |
+| 看表结构 | \`fancy_story_read {"action":"schema","table":"chapter_text"}\`、\`fancy_story_read {"action":"schema","table":"handoff"}\` | 第一次写之前 |
+| 提交 | \`fancy_story_preview\` → \`fancy_story_apply_batch\`（\`perChapter: true\`） | 每 1-5 章提交一次 |
+| 检查 | \`fancy_story_read {"action":"stage_check","stage":"writing"}\` | 每批后/结束，必须通过 |
+
+## 执行步骤
+
+1. \`fancy_story_read {"action":"status"}\`，确认 outline 已完成。
+2. 用 \`fancy_story_read {"action":"search","kind":"chapter","limit":20}\` 分批取章节；逐章运行 \`fancy_story_read {"action":"context","chapter":N,"prev":3}\`。
+3. 写前把 \`context\` 返回的以下内容逐项对一遍，写进正文：
+   - \`cast\`：每个出场人物都要出现，不能只写 POV。
+   - \`locations\`：本章地点要在场景里落地。
+   - \`actions\`：每个伏笔/爽点/信息差动作都要有具体情节，不能只在旁白里提一句。
+   - \`climaxes\` / \`items\`：有明确关联时写进正文；没有时不要凭空加。
+   - \`chapter.emotion\` / \`chapter.hook\` / \`chapter.how\`：情绪、钩子、转折、章末收束要对齐。
+4. 写正文：
+   - 覆盖 \`outline.must_write\` 的每个事件。
+   - 不违反 \`outline.must_not_write\`。
+   - 结尾按 \`outline.ending\` 收束。
+   - 正文长度必须达到 \`chapter.word_target\` 的 80% 以上；不要用 1000 字草稿冒充 2400 字章节。
+   - 如果上一章 handoff 的地点/时间与本章开场不一致，写过渡；不要无解释跳场景。
+5. 同一次提交里写 \`chapter_text\` 和 \`handoff\`。正文用 \`content\`，字数用 \`word_count\`（中文按非空白字符数估算）。
+6. 每 1-5 章提交一次；失败只回滚当前章。
+7. 全部写完后运行 \`fancy_story_read {"action":"stage_check","stage":"writing"}\`。
+
+## 提交前自检
+
+每章逐项打勾，缺一项就不要提交：
+
+- 出场人物：本章 \`chapter_cast\` 的每个人都出现了吗？
+- 地点：本章 \`chapter_location\` 的地点都写到了吗？
+- 伏笔：每个 \`foreshadow_action\` 的 plant/progress/reveal 都有对应情节吗？
+- 爽点：每个 \`payoff_action\` 的 setup/payoff 都有对应情节吗？
+- 信息差：每个 \`info_action\` 的建立/推进/解决都有对应情节吗？
+- 高潮/道具：有 \`chapter_climax\`/\`chapter_item\` 时写进正文了吗？
+- 情绪/钩子：本章 \`emotion\` 与 \`hook\` 和正文实际感受一致吗？
+- 长度：\`word_count\` 达到 \`word_target\` 的 80% 以上吗？
+
+## 上游进度
+
+\`\`\`json
+${json(ctx.summary)}
+\`\`\`
+
+## 可复制的单章提交示例
+
+参数（用 \`fancy_story_apply_batch\` 提交；它会先预览再写入）：
+
+\`\`\`json
+{
+  "perChapter": true,
+  "workflow": "writing",
+  "summary": "第 341 章正文",
+  "chapters": [
+    {
+      "chapter": "CH341",
+      "ops": [
+        { "op": "create", "kind": "chapter_text", "data": {
+          "chapter_id": "CH341",
+          "display_no": 341,
+          "content": "# 第341章 第一张复核表\\n\\n……",
+          "word_count": 2400,
+          "status": "draft"
+        } },
+        { "op": "create", "kind": "handoff", "data": {
+          "chapter_id": "CH341",
+          "end_location": "L011",
+          "end_time": { "story_day": 318, "clock": "21:00" },
+          "end_characters": ["C001", "C027"],
+          "open_threads": ["账本的来源"],
+          "next_scene_hint": "反对者带着账本去找 C024",
+          "continuity_notes": "从公示栏转到档案楼，需要一个走路的过渡",
+          "status": "draft"
+        } }
+      ],
+      "decisions": [
+        { "subject": "chapter_text:CH341", "text": "把公开念表写成正面冲突", "reason": "细纲要求公开后立刻出现反对者" }
+      ]
+    }
+  ]
+}
+\`\`\`
+
+## 完成标准
+
+- 每一章都有 \`chapter_text\`，\`word_count > 0\`。
+- 每章有 \`handoff\`。
+- 正文覆盖细纲的 \`must_write\`，不违反 \`must_not_write\`。
+- \`fancy_story_read {"action":"stage_check","stage":"writing"}\` 返回 \`ok: true\`。
+`;
+}
+
+// ---------------------------------------------------------------------------
+// repair
+// ---------------------------------------------------------------------------
+
+export function buildRepairPrompt(stage, check, ctx = {}) {
+  const label = stage === 'writing' ? 'write' : stage;
+  const errors = (check.errors || []).slice(0, 20);
+  const pending = (check.pending || []).slice(0, 20);
+  const warnings = (check.warnings || []).slice(0, 10);
+  const prompt = `# 继续完成 ${label} 阶段
+
+上一次 \`stage-check ${stage}\` 没有通过。不要重写已经完成的内容，只修下面这些问题。
+
+## 命令入口
+
+\`\`\`bash
+fancy_story_read {"action":"stage_check","stage":"${stage}"}
+\`\`\`
+
+## 必须修的错误
+
+\`\`\`json
+${JSON.stringify(errors, null, 2)}
+\`\`\`
+
+## 待办
+
+\`\`\`json
+${JSON.stringify(pending, null, 2)}
+\`\`\`
+
+## 可参考的警告（不阻断）
+
+\`\`\`json
+${JSON.stringify(warnings, null, 2)}
+\`\`\`
+
+## 做法
+
+1. 先看错误里的 \`scope\` / \`message\` / \`op_index\`，判断是哪条数据或哪个操作。
+2. 用 \`fancy_story_read\`、\`fancy_story_read {"action":"context","entity":"..."}\`、\`fancy_story_read {"action":"context","chapter":...}\` 或 \`fancy_story_read {"action":"query","sql":"SELECT ..."}\` 定位。
+3. 用 \`fancy_story_apply_batch\` 修；如果是章节问题，用 \`fancy_story_apply_batch（perChapter: true）\` 重新提交该章（会替换该章的 cast/action 边）。
+4. 失败时按 DB 返回的错误原文改，不要猜。
+5. 修完重新运行 \`fancy_story_read {"action":"stage_check","stage":"${stage}"}\`，直到 \`ok: true\`。
+6. 不要停下来等确认；不要写阶段 JSON；不要写生成脚本。`;
+  const withRefs = prompt
+    .replaceAll('<cli>', ctx.cliPath || '<cli>')
+    .replaceAll('<root>', ctx.projectRoot || '<root>');
+  if (ctx.wikiReferences) {
+    return withRefs + '\n\n## 共享对标参考\n\n以下文件在工作区 `' + ctx.workspaceRoot + '` 下（多个项目共享；路径相对工作区）：\n\n' + ctx.wikiReferences + '\n';
+  }
+  return withRefs;
+}
+
+export function buildStagePrompt(stage, ctx) {
+  let prompt;
+  switch (stage) {
+    case 'scale': prompt = buildScalePrompt(ctx); break;
+    case 'macro': prompt = buildMacroPrompt(ctx); break;
+    case 'cast': prompt = buildCastPrompt(ctx); break;
+    case 'rhythm': prompt = buildRhythmPrompt(ctx); break;
+    case 'outline': prompt = buildOutlinePrompt(ctx); break;
+    case 'writing': prompt = buildWritingPrompt(ctx); break;
+    default: throw new Error('未知阶段：' + stage);
+  }
+  return prompt
+    .replaceAll('<cli>', ctx.cliPath || '<cli>')
+    .replaceAll('<root>', ctx.projectRoot || '<root>');
+}