@cloud411716/fancy-webnovel 3.0.3 → 4.0.0

package/plugins/fancy-scan/scripts/report-validate.js

@@ -27,6 +27,7 @@ import {
   TABLE_SEP_RE,
   DIRECTION_RE,
   DIRECTION_LABELS,
+  CANDIDATE_LABELS,
 } from '../templates/report-schema.js';
 
 /**
@@ -352,29 +353,56 @@ export function validateReportBody(body, opts = {}) {
       + ' —— 必须写成 `### 方向 N：名称`（N 是连续数字）');
   }
 
-  // ── 3. 每个方向的 11 项标签 ───────────────────────────────────
+  // ── 3. 每个方向的标签 ─────────────────────────────────────────
+  // 新格式只查 4 项；旧报告仍兼容 11 项。
   const tagStats = [];
   dirPos.forEach((start, k) => {
     const end = k + 1 < dirPos.length ? dirPos[k + 1] : lines.length;
     const section = lines.slice(start, end);
-    let okTags = 0;
-    for (const lab of DIRECTION_LABELS) {
+    const findLabel = (label) => {
       const re = new RegExp(
-        '^\\s*[-*+]?\\s*\\*\\*' + lab.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') + '\\*\\*\\s*[:：]\\s*(.+)$'
+        '^\\s*[-*+]?\\s*\\*\\*' + label.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') + '\\*\\*\\s*[:：]\\s*(.+)$'
       );
-      const hit = section.map(l => re.exec(l)).find(Boolean);
+      return section.map(l => re.exec(l)).find(Boolean);
+    };
+    const newHits = CANDIDATE_LABELS.map(findLabel);
+    const oldHits = DIRECTION_LABELS.map(findLabel);
+    const isNew = newHits.every(Boolean);
+    const isOld = oldHits.every(Boolean);
+    if (!isNew && !isOld) {
+      const missing = CANDIDATE_LABELS.filter((_, i) => !newHits[i]);
+      errors.push(`方向 ${k + 1} 缺标签：${missing.map(l => `「${l}」`).join('、')}`
+        + '（新格式要求 题材 / 一句话定位 / 市场评分 / 推荐理由 四项齐全）');
+    }
+    const labels = isNew ? CANDIDATE_LABELS : DIRECTION_LABELS;
+    let okTags = 0;
+    for (let i = 0; i < labels.length; i += 1) {
+      const lab = labels[i];
+      const hit = (isNew ? newHits : oldHits)[i];
       if (!hit) {
-        errors.push(`方向 ${k + 1} 缺标签「${lab}」（11 项必须齐全，格式 \`- **${lab}**：内容\`）`);
+        errors.push(`方向 ${k + 1} 缺标签「${lab}」（格式 \`- **${lab}**：内容\`）`);
+        continue;
+      }
+      const value = hit[1].trim();
+      if (lab === '市场评分') {
+        if (!/^\d+(?:\.\d+)?(?:\s*\/\s*10)?$/.test(value)) {
+          errors.push(`方向 ${k + 1} 的「市场评分」必须是 1-10 的数字（如 8.5 或 8.5/10）`);
+        } else {
+          okTags++;
+        }
         continue;
       }
-      const chars = cjkCount(hit[1]);
-      if (chars < R.minTagChars) {
-        errors.push(`方向 ${k + 1} 的「${lab}」只有 ${chars} 个汉字（要求 ≥${R.minTagChars}，不能只写个标签名充数）`);
+      const chars = cjkCount(value);
+      const minChars = isNew
+        ? (lab === '题材' ? 2 : (lab === '一句话定位' || lab === '推荐理由' ? 10 : R.minTagChars))
+        : 20;
+      if (chars < minChars) {
+        errors.push(`方向 ${k + 1} 的「${lab}」只有 ${chars} 个汉字（要求 ≥${minChars}，不能只写个标签名充数）`);
       } else {
         okTags++;
       }
     }
-    tagStats.push({ direction: k + 1, okTags, total: DIRECTION_LABELS.length });
+    tagStats.push({ direction: k + 1, okTags, total: labels.length });
   });
 
   // ── 4. 字数 ────────────────────────────────────────────────────
@@ -603,72 +631,7 @@ export function validateReportBody(body, opts = {}) {
     });
   }
 
-  // 选题对比表的“优先级”列必须是名次 1..N（从上到下递增），
-  // 不是加权总分。之前模型在列里填 4.44 / 3.83，读者无法一眼看出排名。
-  if (choiceTableRows.length) {
-    const nums = choiceTableRows.map(row => {
-      const cells = row.split('|').map(s => s.trim());
-      return Number(cells[cells.length - 1]);
-    });
-    const valid = nums.every((p, i) => Number.isInteger(p) && p === i + 1);
-    if (!valid) {
-      errors.push(`选题对比表的“优先级”列必须是 1–${choiceTableRows.length} 的名次`
-        + `（从上到下递增），当前是 ${nums.map(x => Number.isFinite(x) ? x : '空').join('/')}`);
-    }
-  }
-
-  // 优先级打分是自由文本，但常见写法是
-  // "方向 N ... a/b/c/待确认，加权后为 X"。
-  // 能解析就核对算术与排序；解析不到就跳过（不因为写法不同而误报）。
-  const scoreRows = [];
-  for (const chunk of text.split(/[；;\n]/)) {
-    const m = chunk.match(
-      /方向\s*(\d+)[^。；\n]{0,60}?(\d+)\s*\/\s*(\d+)\s*\/\s*(\d+)[^。；\n]{0,60}?加权后为\s*(\d+(?:\.\d+)?)/
-    );
-    if (!m) continue;
-    const scores = [Number(m[2]), Number(m[3]), Number(m[4])];
-    const expected = Math.round(
-      ((scores[0] * 40 + scores[1] * 25 + scores[2] * 25) / 90) * 100
-    ) / 100;
-    scoreRows.push({
-      direction: Number(m[1]),
-      scores,
-      stated: Number(m[5]),
-      expected,
-    });
-  }
-  for (const r of scoreRows) {
-    if (Math.abs(r.expected - r.stated) > 0.011) {
-      warnings.push(`优先级打分算术不一致：方向 ${r.direction} 的 ${r.scores.join('/')}`
-        + ` 按 90% 归一化应为 ${r.expected.toFixed(2)}，正文写 ${r.stated.toFixed(2)}`);
-    }
-  }
-  if (scoreRows.length > 1 && choiceTableRows.length) {
-    const priorityByDir = new Map();
-    for (const row of choiceTableRows) {
-      const cells = row.split('|').map(s => s.trim());
-      if (cells.length < 2) continue;
-      const dm = /^方向\s*(\d+)/.exec(cells[0]);
-      const p = Number(cells[cells.length - 1]);
-      if (dm && Number.isFinite(p)) priorityByDir.set(Number(dm[1]), p);
-    }
-    for (let i = 0; i < scoreRows.length; i++) {
-      for (let j = i + 1; j < scoreRows.length; j++) {
-        const a = scoreRows[i];
-        const b = scoreRows[j];
-        const pa = priorityByDir.get(a.direction);
-        const pb = priorityByDir.get(b.direction);
-        if (!pa || !pb || Math.abs(a.expected - b.expected) < 0.005) continue;
-        const wrong = (a.expected > b.expected && pa > pb)
-          || (b.expected > a.expected && pb > pa);
-        if (wrong) {
-          warnings.push(`选题对比表的优先级与加权总分不一致：方向 ${a.direction}`
-            + `（${a.expected.toFixed(2)}）与方向 ${b.direction}（${b.expected.toFixed(2)}）`
-            + ` 的顺序对不上（表里优先级 ${pa} vs ${pb}）`);
-        }
-      }
-    }
-  }
+  // 新格式不再要求“优先级”列；方向的市场评分在第四节逐项校验。
 
   // ── 6. 引用（书名 + 指标） ──────────────────────────────────────
   // 数的是**出现次数**，不是行数 —— 一行里写了两本书的两条佐证也算两处。

package/plugins/fancy-scan/templates/report-schema.js

@@ -41,19 +41,22 @@ export const SECTION_TITLES = [
  *   - 表格数用**分隔行**数（`| --- | --- |` 那种），不是"看起来像表格的行"；
  *   - 标签要求"加粗 + 全角冒号 + 正文 ≥20 汉字"，避免"写个标题充数"。
  */
+/** 新格式每个方向只要求四项 */
+export const CANDIDATE_LABELS = ['题材', '一句话定位', '市场评分', '推荐理由'];
+
 export const REPORT_RULES = {
   /** 方向个数 */
   minDirections: 3,
-  maxDirections: 4,
-  /** 每个方向的 11 项设计标签 */
-  minTagsPerDirection: DIRECTION_LABELS.length,
+  maxDirections: 5,
+  /** 新格式每个方向的 4 个标签 */
+  minTagsPerDirection: CANDIDATE_LABELS.length,
   /** 每个标签后面的正文汉字数下限（防止"写个标签名充数"） */
-  minTagChars: 20,
-  /** 全文汉字数区间 */
-  minCjkTotal: 4000,
+  minTagChars: 4,
+  /** 全文汉字数区间（只保留市场分析，不再展开 11 项设计） */
+  minCjkTotal: 3000,
   maxCjkTotal: 15000,
   /** 纯正文汉字数下限（排除表格行、标题行、标签行之后的正文量） */
-  minPureCjk: 3000,
+  minPureCjk: 2200,
   /** 表格张数 */
   minTables: 3,
   /** 至少几处"《书名》…月票 N 张"式的引用 */
@@ -74,7 +77,7 @@ export function tableHeaders(metricLabel, grouped) {
   return {
     topic: `题材 | 书目数 | ${metricLabel}总量 | 均值 | 中位数 | ${share}`,
     competition: `题材 | ${share} | 头部集中度 | 同质化程度 | 差异化空间 | 判断`,
-    choice: '方向 | 题材 | 金手指 | 情绪价值 | 差异化 | 风险 | 优先级',
+    choice: '方向 | 题材 | 一句话定位 | 市场评分 | 推荐理由',
   };
 }
 

package/plugins/fancy-scan/templates.js

@@ -598,7 +598,7 @@ export const scan = {
           `- **辅助指标（${aux.map(a => a.label).join(' / ')}）只作交叉验证，不进上面三项公式** ——`,
           `  它们的口径和量级都与${h.label}不同（见 2.3），代入占比或相加都得出没有意义的数。用法：`,
           ...aux.map(a => `  - ${a.usage}`),
-          `  以上都是**同一天、同一批书的横向比较** —— 不能写成"正在上升""持续走高"。`,
+          `  以上都是**同一天、同一批书的横向比较** —— 不能写成“正在上升、持续走高”。`,
         ]
       : [];
 
@@ -613,7 +613,7 @@ export const scan = {
       ? [
           `- **数据文件里有 \`**排名变动：**\` 行时**，它说明"名次较上次有变动"（上升/下降 N 名/持平）——`,
           `  这可以写进结论，但**只能写这一次的变动**："名次较上次上升 N 位"；`,
-          `  **不能**由它推断连续走势（"连续上升""一路走高"）—— 它是单个变化值，不是历史序列。`,
+          `  **不能**由它推断连续走势（“连续上升、一路走高”）—— 它是单个变化值，不是历史序列。`,
         ]
       : [];
 

package/plugins/fancy-story-builder/prompts/01-skeleton-prompt.md

@@ -1,18 +1,19 @@
 # 01 骨架阶段产物契约
 
-> 本文件是骨架阶段的**产物契约**：每个文件长什么样、哪些规则不能破。
->
-> 怎么派活、怎么校验、错了怎么改、下一批做什么，全部由插件负责：
-> 插件按批次把活派给你，校验脚本判定通过与否，
-> 错误清单由插件整理后回喂给你。**你只负责按指令生成文件。**
->
-> 本阶段是第一层，无上游依赖。
+本文件是骨架阶段的**产物契约**：每个文件长什么样、哪些规则不能破。
+
+怎么派活、怎么校验、错了怎么改、下一批做什么，全部由插件负责：
+插件按批次把活派给你，校验脚本判定通过与否，
+错误清单由插件整理后回喂给你。**你只负责按指令生成文件。**
+
+本阶段是第一层，无上游依赖。
 
 @meta-only
 
 ---
 
 <!-- contract:overview -->
+
 ## 一、本阶段目标
 
 产出 4 个 JSON 文件到 `设定/raw/sources/骨架/`：
@@ -39,10 +40,11 @@
 ---
 
 <!-- contract:input -->
+
 ## 二、任务输入
 
-> 本节由插件注入，只读，不得修改。
-> 骨架阶段没有上游，这输入就是选题时的原始输入。
+本节由插件注入，只读，不得修改。
+骨架阶段没有上游，这输入就是选题时的原始输入。
 
 ${input_snapshot_block}
 
@@ -56,6 +58,7 @@ ${input_snapshot_block}
 ---
 
 <!-- contract:output-list -->
+
 ## 三、本阶段产出清单
 
 | # | 文件 | 路径 | 前置依赖 |
@@ -68,27 +71,29 @@ ${input_snapshot_block}
 ---
 
 <!-- contract:rules -->
+
 ## 四、核心铁律（违反任意一条都会校验失败）
 
-> 1. **不得出现任何章节号**（`chapter` / `ch` / `start` / `end` / `appearance_chapters` / `chapter_range` / `buried_chapter` / `recovered_chapter` / `key_nodes` 等，完整清单见 glossary 第六节）。骨架脚本会拦截 `SKELETON_CHAPTER_FORBIDDEN`。
->
-> 2. **常规实体的枚举必须遵守 glossary**。例如 `character_type` 只允许"主角/贯穿级核心配角/卷级重要配角/贯穿级核心反派/卷级反派"，不能自创。题材特有存在不要硬塞进 `characters`，改写进可选的 `other_entities`（`kind` 是自由文本，如 灵魂/神魂/器灵/妖灵/概念体）。ENUM 校验会拦截常规枚举。
->
-> 3. **引用关系只允许 id，不允许编名字**。关系.json 的 `from`/`to`/`character`/`faction`/`item`/`location`/`ending`/`main_line`/`branch` 必须是 `C001`/`X001`/`F001` 这种 id，不是名字。`SKELETON_REF_MISSING` 会拦截。
->
-> 4. **不得自创字段**。每个文件的字段必须严格在 `模板/骨架/<文件名>模板.json` 的 `structure.properties` 中定义。`EXTRA_FIELD` 会拦截。
->
-> 5. **公式推导（`derivations`）必须 30 条齐全**，每条 `{formula, range_low, range_high, note}`，且 `formula` 逐字与 `formulas-skeleton.json` 一致。`DERIVATION_MISSING` / `DERIVATION_RANGE_MISMATCH` 会拦截。
->
-> 6. **关系类型只能取第 8.2 节各自那套词表**。`character_relations[].relation_kind` 取 13 值（血缘/师徒/雇佣/服从/提携/合作/利益交换/利用/对立/敌对/竞争/中立/其他）；用 `其他` 时必须填 `relation_label` 写清具体关系（如 附身/寄生/契约/共生）。非人物实体的关系写 `other_relations`；`faction_membership[].member_relation` 取 8 值（利益交换/合作/对立/利用/师徒/雇佣/血亲/无）；`faction_relations[].relation_type` 取 4 值（合作/对立/利用/中立）；`main_line_branch_relation[].relation_kind` 取 6 值（促成/阻碍/并行/揭示/收束/依存）。不要写"盟友""对手""上下级""血亲"——它们不在对应词表里，ENUM 会拦截。
->
-> 7. **实体名要是真名字，内容要是真内容**。名字写"陆子仲"而不是"主角1"；`input_snapshot` 的 `positioning` / `core_conflict` 要写清一个具体处境，而不是"核心概述。"。`NAME_PLACEHOLDER` / `TEXT_TOO_SHORT` / `TEXT_PLACEHOLDER` 会拦截。
->
-> 8. **实体条数必须与框架的 quota 完全一致**。框架里声明 `character_counts.protagonist = 2`，实体清单里就恰好要有 2 个 `type=主角` 的角色；多一个少一个都会报 `QUOTA_MISMATCH`。
+1. **不得出现任何章节号**（`chapter` / `ch` / `start` / `end` / `appearance_chapters` / `chapter_range` / `buried_chapter` / `recovered_chapter` / `key_nodes` 等，完整清单见 glossary 第六节）。骨架脚本会拦截 `SKELETON_CHAPTER_FORBIDDEN`。
+
+2. **常规实体的枚举必须遵守 glossary**。例如 `character_type` 只允许"主角/贯穿级核心配角/卷级重要配角/贯穿级核心反派/卷级反派"，不能自创。题材特有存在不要硬塞进 `characters`，改写进可选的 `other_entities`（`kind` 是自由文本，如 灵魂/神魂/器灵/妖灵/概念体）。ENUM 校验会拦截常规枚举。
+
+3. **引用关系只允许 id，不允许编名字**。关系.json 的 `from`/`to`/`character`/`faction`/`item`/`location`/`ending`/`main_line`/`branch` 必须是 `C001`/`X001`/`F001` 这种 id，不是名字。`SKELETON_REF_MISSING` 会拦截。
+
+4. **不得自创字段**。每个文件的字段必须严格在 `模板/骨架/<文件名>模板.json` 的 `structure.properties` 中定义。`EXTRA_FIELD` 会拦截。
+
+5. **公式推导（`derivations`）必须 30 条齐全**，每条 `{formula, range_low, range_high, note}`，且 `formula` 逐字与 `formulas-skeleton.json` 一致。`DERIVATION_MISSING` / `DERIVATION_RANGE_MISMATCH` 会拦截。
+
+6. **关系类型只能取第 8.2 节各自那套词表**。`character_relations[].relation_kind` 取 13 值（血缘/师徒/雇佣/服从/提携/合作/利益交换/利用/对立/敌对/竞争/中立/其他）；用 `其他` 时必须填 `relation_label` 写清具体关系（如 附身/寄生/契约/共生）。非人物实体的关系写 `other_relations`；`faction_membership[].member_relation` 取 8 值（利益交换/合作/对立/利用/师徒/雇佣/血亲/无）；`faction_relations[].relation_type` 取 4 值（合作/对立/利用/中立）；`main_line_branch_relation[].relation_kind` 取 6 值（促成/阻碍/并行/揭示/收束/依存）。不要写“盟友、对手、上下级、血亲”——它们不在对应词表里，ENUM 会拦截。
+
+7. **实体名要是真名字，内容要是真内容**。名字写"陆子仲"而不是"主角1"；`input_snapshot` 的 `positioning` / `core_conflict` 要写清一个具体处境，而不是"核心概述。"。`NAME_PLACEHOLDER` / `TEXT_TOO_SHORT` / `TEXT_PLACEHOLDER` 会拦截。
+
+8. **实体条数必须与框架的 quota 完全一致**。框架里声明 `character_counts.protagonist = 2`，实体清单里就恰好要有 2 个 `type=主角` 的角色；多一个少一个都会报 `QUOTA_MISMATCH`。
 
 ---
 
 <!-- contract:refs -->
+
 ## 五、参考文件
 
 ### 必读（每次任务开始时读一次，之后不再重读）
@@ -118,6 +123,7 @@ ${benchmark_refs_block}
 ---
 
 <!-- contract:file:框架 -->
+
 ## 六、框架.json 的字段契约
 
 **顶层**：纯对象（没有顶层数组）　**模板**：`模板/骨架/框架模板.json`
@@ -277,6 +283,7 @@ Level 3（依赖实体数）：
 ---
 
 <!-- contract:file:实体 -->
+
 ## 七、实体.json 的字段契约
 
 **顶层**：12 个常规数组 + 可选的 `other_entities`　**模板**：`模板/骨架/实体模板.json`
@@ -341,6 +348,7 @@ Level 3（依赖实体数）：
 ---
 
 <!-- contract:file:关系 -->
+
 ## 八、关系.json 的字段契约
 
 **顶层**：9 个常规数组 + 可选的 `other_relations`　**模板**：`模板/骨架/关系模板.json`
@@ -390,10 +398,10 @@ Level 3（依赖实体数）：
 
 **`faction_relations[].relation_type`** —— 只从这 4 个值里选：`合作` / `对立` / `利用` / `中立`。
 
-> ⚠️ **这是四套互不相同的词表，别串用**：
-> `relation_kind`（角色关系，13 值，含扩展出口 `其他`）/ `member_relation`（成员关系，8 值）/ `relation_type`（势力关系，4 值）/ `main_line_branch_relation[].relation_kind`（支线挂主线，6 值）。
-> 拿 `relation_kind` 的值去填 `member_relation` 或 `relation_type` 一律报 ENUM
-> （tt5 实测 2026-10-27：9 条 ENUM 错误，2 个批次重写，理由全是"从角色关系词表里取值"）。
+⚠️ **这是四套互不相同的词表，别串用**：
+`relation_kind`（角色关系，13 值，含扩展出口 `其他`）/ `member_relation`（成员关系，8 值）/ `relation_type`（势力关系，4 值）/ `main_line_branch_relation[].relation_kind`（支线挂主线，6 值）。
+拿 `relation_kind` 的值去填 `member_relation` 或 `relation_type` 一律报 ENUM
+（tt5 实测 2026-10-27：9 条 ENUM 错误，2 个批次重写，理由全是"从角色关系词表里取值"）。
 
 ### 8.3 关键约束
 
@@ -411,6 +419,7 @@ Level 3（依赖实体数）：
 ---
 
 <!-- contract:file:层级 -->
+
 ## 九、层级.json 的字段契约
 
 **顶层**：4 个数组　**模板**：`模板/骨架/层级模板.json`
@@ -436,6 +445,7 @@ Level 3（依赖实体数）：
 ---
 
 <!-- contract:consistency -->
+
 ## 十、本阶段全量校验清单
 
 全量模式（插件在四个文件都产出后跑一次）检查以下项目：
@@ -477,6 +487,7 @@ Level 3（依赖实体数）：
 ---
 
 <!-- contract:errors -->
+
 ## 十一、常见错误代码速查（详见 glossary 与脚本）
 
 | code | 含义 | 修复方向 |
@@ -534,6 +545,7 @@ Level 3（依赖实体数）：
 ---
 
 <!-- contract:forbidden -->
+
 ## 十二、本阶段禁令（13 条）
 
 1. **不得出现任何章节号**（`chapter` / `ch` / `start` / `end` / `appearance_chapters` / `chapter_range` / `buried_chapter` / `recovered_chapter` / `key_nodes` 等，完整清单见 glossary 第六节）。骨架脚本会报 `SKELETON_CHAPTER_FORBIDDEN`。

package/plugins/fancy-story-builder/prompts/02-flesh-prompt.md

@@ -1,16 +1,17 @@
 # 02 血肉阶段产物契约
 
-> 本文件是血肉阶段的**产物契约**：它定义每个文件长什么样、哪些写法会被判错。
->
-> **流程由插件驱动**：插件会分批派活，每轮告诉你写哪个文件、哪些条目、写到哪里；
-> 插件自己跑校验脚本、判定通过与否，并把判定出来的错误清单回喂给你。
-> 你**不需要**自己调校验脚本，**不要**自己判断"通过没通过"，**不要**输出"已完成"之类的结论。
+本文件是血肉阶段的**产物契约**：它定义每个文件长什么样、哪些写法会被判错。
+
+**流程由插件驱动**：插件会分批派活，每轮告诉你写哪个文件、哪些条目、写到哪里；
+插件自己跑校验脚本、判定通过与否，并把判定出来的错误清单回喂给你。
+你**不需要**自己调校验脚本，**不要**自己判断"通过没通过"，**不要**输出"已完成"之类的结论。
 
 @meta-only
 
 ---
 
 <!-- contract:overview -->
+
 ## 你的职责
 
 你只做一件事：**按插件每轮给的指令，把指定的条目写成指定格式的 JSON**。
@@ -30,11 +31,12 @@
 ---
 
 <!-- contract:input -->
+
 ## 一、任务输入
 
-> 本节由插件注入，只读，不得修改。
-> 数据源：骨架阶段 `设定/raw/sources/骨架/框架.json` 的 `input_snapshot`（目标章节/目标字数取自同文件的 `capacity`）。
-> 骨架阶段已经把这次选题的完整输入固化成了这份快照，血肉阶段直接用它，不要另做推测或改写。
+本节由插件注入，只读，不得修改。
+数据源：骨架阶段 `设定/raw/sources/骨架/框架.json` 的 `input_snapshot`（目标章节/目标字数取自同文件的 `capacity`）。
+骨架阶段已经把这次选题的完整输入固化成了这份快照，血肉阶段直接用它，不要另做推测或改写。
 
 ${input_snapshot_block}
 
@@ -49,6 +51,7 @@ ${input_snapshot_block}
 ---
 
 <!-- contract:output-list -->
+
 ## 二、本阶段产出清单
 
 | # | 文件 | 路径 | 顶层数组 |
@@ -70,6 +73,7 @@ ${input_snapshot_block}
 ---
 
 <!-- contract:rules -->
+
 ## 三、核心铁律（7 条，违反任意一条都会被判错）
 
 1. **不得出现任何章节号**——单章号字段（`chapter` / `ch` / `start` / `end` / `turning` / `midpoint` / `resolution` / `resolution_chapter` / `appear_start` / `appear_end` / `exit_chapter` / `buried_chapter` / `recovered_chapter` / `hook_chapter` / `climax_chapter` / `pleasure_chapter`）、区间字段（`appearance_chapters` / `chapter_range`）、嵌套形式（`escalation_nodes[].chapter` / `info_gaps[].created` / `key_nodes[].chapter` / `arc_stages[].chapter` / `interweaves[].chapter` / `foreshadow_recovery[].chapter`）**全部禁止**；完整清单见 glossary 第六节（脚本按它判定，别自己猜字段名）。血肉脚本会拦截 `FLESH_CHAPTER_FORBIDDEN`。
@@ -84,11 +88,12 @@ ${input_snapshot_block}
 
 6. **关系类型必须与骨架完全一致**。`relationships[].relationship_type` 只能取 glossary 第五节 `relation_kind` 的 13 个值（血缘/师徒/雇佣/服从/提携/合作/利益交换/利用/对立/敌对/竞争/中立/其他），而且**必须等于骨架里同一对角色的关系类型**。骨架写"A 服从 B"，这里就不能写"上下级"或"盟友"；用 `其他` 时必须同时填 `relation_label`（如 附身/寄生/契约）。非人物实体参与的关系在骨架 `other_relations`，本项目不写进 `relationships[]`。`REL_TYPE_MISMATCH` / `REL_LABEL_REQUIRED` / `ENUM` 会拦截。
 
-7. **描述要写实，不能写空话**。`description` / `core_flaw` / `goals.*` 这类叙述字段要写出一个具体事实，而不是"很好""详细设定。"。`TEXT_TOO_SHORT` / `TEXT_PLACEHOLDER` 会拦截；不同角色不能共用同一段话（`TEXT_DUPLICATE`）。
+7. **描述要写实，不能写空话**。`description` / `core_flaw` / `goals.*` 这类叙述字段要写出一个具体事实，而不是“很好、详细设定”这类空话。`TEXT_TOO_SHORT` / `TEXT_PLACEHOLDER` 会拦截；不同角色不能共用同一段话（`TEXT_DUPLICATE`）。
 
 ---
 
 <!-- contract:refs -->
+
 ## 四、参考文件
 
 ### 4.1 必读
@@ -143,6 +148,7 @@ node references/upstream-query.js --stage=骨架 --file=关系 --list        #
 ---
 
 <!-- contract:file:角色 -->
+
 ## 五、角色.json 的字段契约
 
 **顶层数组**：`characters`　**模板**：`模板/血肉/角色模板.json`
@@ -176,7 +182,7 @@ node references/upstream-query.js --stage=骨架 --file=关系 --list        #
 | `language_profile.personality_tone` | 性格基调（冷硬/温和/尖刻/木讷） |
 | `language_profile.relationship_stage_tone` | 对不同关系的人说话语气怎么变 |
 | `behavior_repeat_points` | 反复出现的小动作或口头习惯，字符串数组 |
-| `traits` | **必填 3-5 条**独有特征/习惯/感官锚点。每条都要能在场景里演出来，不要写"善良""勇敢"这类评价词 |
+| `traits` | **必填 3-5 条**独有特征/习惯/感官锚点。每条都要能在场景里演出来，不要写“善良、勇敢”这类评价词 |
 | `extensions` | 题材特有的扩展设定；键用中文，值用字符串/数组。不要塞章节号 |
 | `mirror_type` | 反派专用：与主角互为镜像的类型，取 glossary `mirror_type` 词表。非反派不填 |
 | `relationships[]` | 关系条目，见下 |
@@ -209,6 +215,7 @@ node references/upstream-query.js --stage=骨架 --file=关系 --list        #
 ---
 
 <!-- contract:file:冲突 -->
+
 ## 六、冲突.json 的字段契约
 
 **顶层数组**：`conflicts`　**模板**：`模板/血肉/冲突模板.json`
@@ -239,6 +246,7 @@ node references/upstream-query.js --stage=骨架 --file=关系 --list        #
 ---
 
 <!-- contract:file:势力 -->
+
 ## 七、势力.json 的字段契约
 
 **顶层数组**：`factions`　**模板**：`模板/血肉/势力模板.json`
@@ -267,6 +275,7 @@ node references/upstream-query.js --stage=骨架 --file=关系 --list        #
 ---
 
 <!-- contract:file:剧情 -->
+
 ## 八、剧情.json 的字段契约
 
 **顶层数组**：`main_lines` + `branches`　**模板**：`模板/血肉/剧情模板.json`
@@ -298,6 +307,7 @@ node references/upstream-query.js --stage=骨架 --file=关系 --list        #
 ---
 
 <!-- contract:file:地点 -->
+
 ## 九、地点.json 的字段契约
 
 **顶层数组**：`locations`　**模板**：`模板/血肉/地点模板.json`
@@ -321,6 +331,7 @@ node references/upstream-query.js --stage=骨架 --file=关系 --list        #
 ---
 
 <!-- contract:file:结局 -->
+
 ## 十、结局.json 的字段契约
 
 **顶层数组**：`endings`　**模板**：`模板/血肉/结局模板.json`
@@ -356,6 +367,7 @@ node references/upstream-query.js --stage=骨架 --file=关系 --list        #
 ---
 
 <!-- contract:file:世界观规则 -->
+
 ## 十一、世界观规则.json 的字段契约
 
 **顶层数组**：`core_rules` + `information_rules` + `social_rules` + `rule_conflict_plan`
@@ -396,6 +408,7 @@ node references/upstream-query.js --stage=骨架 --file=关系 --list        #
 ---
 
 <!-- contract:file:关键道具 -->
+
 ## 十二、关键道具.json 的字段契约
 
 **顶层数组**：`core_items` + `branch_items` + `symbolic_items` + `details`
@@ -445,6 +458,7 @@ node references/upstream-query.js --stage=骨架 --file=关系 --list        #
 ---
 
 <!-- contract:file:其他实体 -->
+
 ## 十三、其他实体.json 的字段契约（按需）
 
 **顶层数组**：`other_entities`　**模板**：`模板/血肉/其他实体模板.json`
@@ -471,6 +485,7 @@ node references/upstream-query.js --stage=骨架 --file=关系 --list        #
 ---
 
 <!-- contract:quality -->
+
 ## 十四、关系类型与内容质量（照着正例写）
 
 脚本不只查结构，也查"写的东西是不是真的"、"两个阶段说的是不是同一件事"。
@@ -514,6 +529,7 @@ node references/upstream-query.js --stage=骨架 --file=关系 --list        #
 ---
 
 <!-- contract:errors -->
+
 ## 十五、常见错误代码速查
 
 插件回喂给你的错误清单里的 `code` 对应下表。**只改被点名的字段**，其余不要动。
@@ -558,6 +574,7 @@ node references/upstream-query.js --stage=骨架 --file=关系 --list        #
 ---
 
 <!-- contract:forbidden -->
+
 ## 十六、本阶段禁令（12 条）
 
 1. **不得出现任何章节号**——单章号字段（`chapter` / `ch` / `start` / `end` / `turning` / `midpoint` / `resolution` / `resolution_chapter` / `appear_start` / `appear_end` / `exit_chapter` / `buried_chapter` / `recovered_chapter` / `hook_chapter` / `climax_chapter` / `pleasure_chapter`）、区间字段（`appearance_chapters` / `chapter_range`）、嵌套形式（`escalation_nodes[].chapter` / `info_gaps[].created` / `key_nodes[].chapter` / `arc_stages[].chapter` / `interweaves[].chapter` / `foreshadow_recovery[].chapter`）**全部禁止**；完整清单见 glossary 第六节（脚本按它判定，别自己猜字段名）。
@@ -587,6 +604,7 @@ node references/upstream-query.js --stage=骨架 --file=关系 --list        #
 ---
 
 <!-- contract:semantic -->
+
 ## 十七、语义检查（可选，由用户显式开启）
 
 上面的校验全是**确定性脚本**：id 在不在、名字对不对、枚举合不合法、配额对不对得上、关系有没有声明。凡是脚本能判死的问题，都已经被判死了。

package/plugins/fancy-story-builder/prompts/03-rhythm-prompt.md

@@ -1,18 +1,19 @@
 # 03 节奏阶段产物契约
 
-> 本文件是节奏阶段的**产物契约**：它定义每个文件长什么样、哪些写法会被判错。
->
-> **流程由插件驱动**：插件会分批派活，每轮告诉你写哪个文件、哪些章/哪些条目、
-> 写到哪里；插件自己跑校验脚本、判定通过与否，并把判定出来的错误清单回喂给你。
-> 你**不需要**自己调校验脚本，**不要**自己判断"通过没通过"，**不要**输出"已完成"之类的结论。
->
-> 本阶段依赖骨架 + 血肉两个上游，任一未完成不得启动。
+本文件是节奏阶段的**产物契约**：它定义每个文件长什么样、哪些写法会被判错。
+
+**流程由插件驱动**：插件会分批派活，每轮告诉你写哪个文件、哪些章/哪些条目、
+写到哪里；插件自己跑校验脚本、判定通过与否，并把判定出来的错误清单回喂给你。
+你**不需要**自己调校验脚本，**不要**自己判断"通过没通过"，**不要**输出"已完成"之类的结论。
+
+本阶段依赖骨架 + 血肉两个上游，任一未完成不得启动。
 
 @meta-only
 
 ---
 
 <!-- contract:overview -->
+
 ## 你的职责
 
 你只做一件事：**按插件每轮给的指令，把指定的条目写成指定格式的 JSON**。
@@ -32,10 +33,11 @@
 ---
 
 <!-- contract:input -->
+
 ## 一、任务输入
 
-> 本节由插件注入，只读，不得修改。
-> 数据源：骨架阶段 `设定/raw/sources/骨架/框架.json` 的 `input_snapshot`（目标章节/目标字数取自同文件的 `capacity`）。
+本节由插件注入，只读，不得修改。
+数据源：骨架阶段 `设定/raw/sources/骨架/框架.json` 的 `input_snapshot`（目标章节/目标字数取自同文件的 `capacity`）。
 
 ${input_snapshot_block}
 
@@ -50,6 +52,7 @@ ${input_snapshot_block}
 ---
 
 <!-- contract:output-list -->
+
 ## 二、本阶段产出清单
 
 | # | 文件 | 路径 | 顶层键 |
@@ -70,6 +73,7 @@ ${input_snapshot_block}
 ---
 
 <!-- contract:rules -->
+
 ## 三、核心铁律（6 条，违反任意一条都会校验失败）
 
 1. **章节号必须在 `[1, T]` 内**（`T = target_chapters`）。`RHYTHM_CHAP_RANGE` 会拦截越界。
@@ -87,6 +91,7 @@ ${input_snapshot_block}
 ---
 
 <!-- contract:refs -->
+
 ## 四、参考文件
 
 ### 4.1 必读
@@ -136,6 +141,7 @@ node references/upstream-query.js --stage=血肉 --file=角色 --id=C001
 ---
 
 <!-- contract:file:章节规划 -->
+
 ## 五、章节规划.json 的字段契约
 
 **顶层数组**：`chapters`　**模板**：`模板/节奏/章节规划模板.json`
@@ -179,6 +185,7 @@ node references/upstream-query.js --stage=血肉 --file=角色 --id=C001
 ---
 
 <!-- contract:file:节奏参数 -->
+
 ## 六、节奏参数.json 的字段契约
 
 **顶层**：纯对象（没有顶层数组）　**模板**：`模板/节奏/节奏参数模板.json`
@@ -280,6 +287,7 @@ main_progress_chapter_count = T - branch_chapter_total + overlap_chapter_count
 ---
 
 <!-- contract:file:时序映射 -->
+
 ## 七、时序映射.json 的字段契约
 
 **顶层**：13 个 `*_timeline` 数组　**模板**：`模板/节奏/时序映射模板.json`
@@ -394,6 +402,7 @@ main_progress_chapter_count = T - branch_chapter_total + overlap_chapter_count
 ---
 
 <!-- contract:file:章节细纲 -->
+
 ## 八、章节细纲.json 的字段契约
 
 **顶层数组**：`outlines`　**模板**：`模板/节奏/章节细纲模板.json`
@@ -431,6 +440,7 @@ main_progress_chapter_count = T - branch_chapter_total + overlap_chapter_count
 ---
 
 <!-- contract:consistency -->
+
 ## 九、跨文件一致性（本阶段最容易翻车的地方）
 
 节奏阶段的多数校验是**全量口径**的——单看一个文件查不出来，必须四个文件对得上。
@@ -469,6 +479,7 @@ main_progress_chapter_count = T - branch_chapter_total + overlap_chapter_count
 ---
 
 <!-- contract:errors -->
+
 ## 十、常见错误代码速查
 
 插件回喂给你的错误清单里的 `code` 对应下表。**只改被点名的字段**，其余不要动。
@@ -514,6 +525,7 @@ main_progress_chapter_count = T - branch_chapter_total + overlap_chapter_count
 ---
 
 <!-- contract:forbidden -->
+
 ## 十一、本阶段禁令（11 条）
 
 1. **章节号必须在 `[1, T]` 内**。`RHYTHM_CHAP_RANGE` 会拦截越界。