@zwbigi/ink-xy 0.1.2 → 0.1.4

package/inkos/packages/core/src/agents/rules-reader.ts

@@ -0,0 +1,155 @@
+import { readFile, readdir } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { parseGenreProfile, type ParsedGenreProfile } from "../models/genre-profile.js";
+import { parseBookRules, tryParseBookRulesFrontmatter, type ParsedBookRules } from "../models/book-rules.js";
+import { BookConfigSchema } from "../models/book.js";
+
+const BUILTIN_GENRES_DIR = join(dirname(fileURLToPath(import.meta.url)), "../../genres");
+
+async function tryReadFile(path: string): Promise<string | null> {
+  try {
+    return await readFile(path, "utf-8");
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Load genre profile. Lookup order:
+ * 1. Project-level: {projectRoot}/genres/{genreId}.md
+ * 2. Built-in:     packages/core/genres/{genreId}.md
+ * 3. Fallback:     built-in other.md
+ */
+export async function readGenreProfile(
+  projectRoot: string,
+  genreId: string,
+): Promise<ParsedGenreProfile> {
+  const projectPath = join(projectRoot, "genres", `${genreId}.md`);
+  const builtinPath = join(BUILTIN_GENRES_DIR, `${genreId}.md`);
+  const fallbackPath = join(BUILTIN_GENRES_DIR, "other.md");
+
+  const raw =
+    (await tryReadFile(projectPath)) ??
+    (await tryReadFile(builtinPath)) ??
+    (await tryReadFile(fallbackPath));
+
+  if (!raw) {
+    throw new Error(`Genre profile not found for "${genreId}" and fallback "other.md" is missing`);
+  }
+
+  return parseGenreProfile(raw);
+}
+
+/**
+ * List all available genre profiles (project-level + built-in, deduped).
+ * Returns array of { id, name, source }.
+ */
+export async function listAvailableGenres(
+  projectRoot: string,
+): Promise<ReadonlyArray<{ readonly id: string; readonly name: string; readonly source: "project" | "builtin" }>> {
+  const results = new Map<string, { id: string; name: string; source: "project" | "builtin" }>();
+
+  // Built-in genres first
+  try {
+    const builtinFiles = await readdir(BUILTIN_GENRES_DIR);
+    for (const file of builtinFiles) {
+      if (!file.endsWith(".md")) continue;
+      const id = file.replace(/\.md$/, "");
+      const raw = await tryReadFile(join(BUILTIN_GENRES_DIR, file));
+      if (!raw) continue;
+      const parsed = parseGenreProfile(raw);
+      results.set(id, { id, name: parsed.profile.name, source: "builtin" });
+    }
+  } catch { /* no builtin dir */ }
+
+  // Project-level genres override
+  const projectDir = join(projectRoot, "genres");
+  try {
+    const projectFiles = await readdir(projectDir);
+    for (const file of projectFiles) {
+      if (!file.endsWith(".md")) continue;
+      const id = file.replace(/\.md$/, "");
+      const raw = await tryReadFile(join(projectDir, file));
+      if (!raw) continue;
+      const parsed = parseGenreProfile(raw);
+      results.set(id, { id, name: parsed.profile.name, source: "project" });
+    }
+  } catch { /* no project genres dir */ }
+
+  return [...results.values()].sort((a, b) => a.id.localeCompare(b.id));
+}
+
+/** Return the path to the built-in genres directory. */
+export function getBuiltinGenresDir(): string {
+  return BUILTIN_GENRES_DIR;
+}
+
+/**
+ * Load the structured book rules (YAML frontmatter).
+ *
+ * Phase 5 cleanup #3: the YAML frontmatter now lives at the top of
+ * outline/story_frame.md. For books initialized before that cleanup it may
+ * still live in book_rules.md instead, so we fall back to that legacy path
+ * when story_frame.md has no frontmatter (or no file at all).
+ *
+ * Phase 5 hotfix 2: when the source is story_frame.md, the prose body
+ * underneath the frontmatter is NOT semantic "book rules" text — it is the
+ * 5-section outline essay. We therefore slice out ONLY the frontmatter block
+ * for parseBookRules, so ParsedBookRules.body ends up empty for new-layout
+ * books. Legacy book_rules.md still carries narrow narrative rules in its
+ * body, so we pass it through verbatim.
+ *
+ * Returns null only if NEITHER source yields parseable rules.
+ */
+export async function readBookRules(bookDir: string): Promise<ParsedBookRules | null> {
+  const storyFrameRaw = await tryReadFile(join(bookDir, "story/outline/story_frame.md"));
+  if (storyFrameRaw) {
+    // Extract just the leading `---\n...\n---` block. Anything after it is
+    // outline prose and must NOT leak into ParsedBookRules.body.
+    const frontmatterMatch = storyFrameRaw.match(/^\s*(---\s*\n[\s\S]*?\n---\s*)(?:\n|$)/);
+    if (frontmatterMatch) {
+      // Phase 5 hotfix 3: use the strict parser so a broken YAML block does
+      // NOT silently zero out protagonist / prohibitions / genreLock. If the
+      // frontmatter is malformed we log and fall through to legacy.
+      const parsed = tryParseBookRulesFrontmatter(frontmatterMatch[1], (err) => {
+        // eslint-disable-next-line no-console
+        console.warn(
+          `[rules-reader] story_frame.md frontmatter is malformed at ${bookDir}/story/outline/story_frame.md — falling back to legacy book_rules.md. Error: ${err instanceof Error ? err.message : String(err)}`,
+        );
+      });
+      if (parsed) return parsed;
+      // fall through to legacy fallback below
+    }
+  }
+
+  const legacyRaw = await tryReadFile(join(bookDir, "story/book_rules.md"));
+  if (!legacyRaw) return null;
+  // Legacy file: body intentionally preserved (narrow narrative rules).
+  //
+  // Phase hotfix 1: parseBookRules now returns null if the file is a Phase 5
+  // compat shim (no YAML, only the architect-emitted pointer prose). In that
+  // case we surface a warning so callers don't silently fall back to default
+  // empty rules — the common new-book path where story_frame.md frontmatter
+  // is broken AND no legacy rules ever existed.
+  const parsed = parseBookRules(legacyRaw);
+  if (parsed === null) {
+    // eslint-disable-next-line no-console
+    console.warn(
+      `[rules-reader] book_rules.md at ${bookDir}/story/book_rules.md is a Phase 5 compat shim with no authoritative rules — returning null instead of silently zeroing out rules. Fix the YAML frontmatter on outline/story_frame.md.`,
+    );
+  }
+  return parsed;
+}
+
+export async function readBookLanguage(bookDir: string): Promise<"zh" | "en" | undefined> {
+  const raw = await tryReadFile(join(bookDir, "book.json"));
+  if (!raw) return undefined;
+
+  try {
+    const parsed = BookConfigSchema.pick({ language: true }).safeParse(JSON.parse(raw));
+    return parsed.success ? parsed.data.language : undefined;
+  } catch {
+    return undefined;
+  }
+}

package/inkos/packages/core/src/agents/sensitive-words.ts

@@ -0,0 +1,142 @@
+/**
+ * Sensitive word detection — rule-based analysis (no LLM).
+ *
+ * Detects politically sensitive, sexually explicit, and extremely violent terms
+ * in Chinese web novel content. Used in audit pipeline to flag or block content.
+ */
+
+import type { AuditIssue } from "./continuity.js";
+
+export interface SensitiveWordMatch {
+  readonly word: string;
+  readonly count: number;
+  readonly severity: "block" | "warn";
+}
+
+export interface SensitiveWordResult {
+  readonly issues: ReadonlyArray<AuditIssue>;
+  readonly found: ReadonlyArray<SensitiveWordMatch>;
+}
+
+type SensitiveWordLanguage = "zh" | "en";
+
+// Political terms — severity "block"
+const POLITICAL_WORDS: ReadonlyArray<string> = [
+  "习近平", "习主席", "习总书记", "共产党", "中国共产党", "共青团",
+  "六四", "天安门事件", "天安门广场事件", "法轮功", "法轮大法",
+  "台独", "藏独", "疆独", "港独",
+  "新疆集中营", "再教育营",
+  "维吾尔", "达赖喇嘛", "达赖",
+  "刘晓波", "艾未未", "赵紫阳",
+  "文化大革命", "文革", "大跃进",
+  "反右运动", "镇压", "六四屠杀",
+  "中南海", "政治局常委",
+  "翻墙", "防火长城",
+];
+
+// Sexual terms — severity "warn"
+const SEXUAL_WORDS: ReadonlyArray<string> = [
+  "性交", "做爱", "口交", "肛交", "自慰", "手淫",
+  "阴茎", "阴道", "阴蒂", "乳房", "乳头",
+  "射精", "高潮", "潮吹",
+  "淫荡", "淫乱", "荡妇", "婊子",
+  "强奸", "轮奸",
+];
+
+// Extreme violence — severity "warn"
+const VIOLENCE_EXTREME: ReadonlyArray<string> = [
+  "肢解", "碎尸", "挖眼", "剥皮", "开膛破肚",
+  "虐杀", "凌迟", "活剥", "活埋", "烹煮活人",
+];
+
+interface WordListEntry {
+  readonly words: ReadonlyArray<string>;
+  readonly severity: "block" | "warn";
+  readonly label: string;
+  readonly englishLabel: string;
+}
+
+const WORD_LISTS: ReadonlyArray<WordListEntry> = [
+  { words: POLITICAL_WORDS, severity: "block", label: "政治敏感词", englishLabel: "political sensitive terms" },
+  { words: SEXUAL_WORDS, severity: "warn", label: "色情敏感词", englishLabel: "sexual sensitive terms" },
+  { words: VIOLENCE_EXTREME, severity: "warn", label: "极端暴力词", englishLabel: "extreme violence terms" },
+];
+
+/**
+ * Analyze text content for sensitive words.
+ * Returns issues that can be merged into audit results.
+ */
+export function analyzeSensitiveWords(
+  content: string,
+  customWords?: ReadonlyArray<string>,
+  language: SensitiveWordLanguage = "zh",
+): SensitiveWordResult {
+  const found: SensitiveWordMatch[] = [];
+  const issues: AuditIssue[] = [];
+  const isEnglish = language === "en";
+  const joiner = isEnglish ? ", " : "、";
+
+  // Check built-in word lists
+  for (const list of WORD_LISTS) {
+    const matches = scanWords(content, list.words, list.severity);
+    if (matches.length > 0) {
+      found.push(...matches);
+      const wordSummary = matches.map((m) => `"${m.word}"×${m.count}`).join(joiner);
+      issues.push({
+        severity: list.severity === "block" ? "critical" : "warning",
+        category: isEnglish ? "Sensitive terms" : "敏感词",
+        description: isEnglish
+          ? `Detected ${list.englishLabel}: ${wordSummary}`
+          : `检测到${list.label}：${wordSummary}`,
+        suggestion: isEnglish
+          ? (list.severity === "block"
+              ? "You must remove or replace these blocked terms before publication"
+              : `Replace or soften these ${list.englishLabel} to reduce moderation risk`)
+          : (list.severity === "block"
+              ? "必须删除或替换政治敏感词，否则无法发布"
+              : `建议替换或弱化${list.label}，避免平台审核问题`),
+      });
+    }
+  }
+
+  // Check custom words
+  if (customWords && customWords.length > 0) {
+    const customMatches = scanWords(content, customWords, "warn");
+    if (customMatches.length > 0) {
+      found.push(...customMatches);
+      const wordSummary = customMatches.map((m) => `"${m.word}"×${m.count}`).join(joiner);
+      issues.push({
+        severity: "warning",
+        category: isEnglish ? "Sensitive terms" : "敏感词",
+        description: isEnglish
+          ? `Detected custom sensitive term(s): ${wordSummary}`
+          : `检测到自定义敏感词：${wordSummary}`,
+        suggestion: isEnglish
+          ? "Replace or remove these terms according to project rules"
+          : "根据项目规则替换或删除这些词语",
+      });
+    }
+  }
+
+  return { issues, found };
+}
+
+function scanWords(
+  content: string,
+  words: ReadonlyArray<string>,
+  severity: "block" | "warn",
+): ReadonlyArray<SensitiveWordMatch> {
+  const matches: SensitiveWordMatch[] = [];
+  for (const word of words) {
+    const regex = new RegExp(escapeRegExp(word), "g");
+    const hits = content.match(regex);
+    if (hits && hits.length > 0) {
+      matches.push({ word, count: hits.length, severity });
+    }
+  }
+  return matches;
+}
+
+function escapeRegExp(str: string): string {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}

package/inkos/packages/core/src/agents/settler-delta-parser.ts

@@ -0,0 +1,53 @@
+import {
+  RuntimeStateDeltaSchema,
+  type RuntimeStateDelta,
+} from "../models/runtime-state.js";
+
+export interface SettlerDeltaOutput {
+  readonly postSettlement: string;
+  readonly runtimeStateDelta: RuntimeStateDelta;
+}
+
+function sanitizeJSON(str: string): string {
+  return str
+    .replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g, "")
+    .replace(/,\s*([}\]])/g, "$1");
+}
+
+export function parseSettlerDeltaOutput(content: string): SettlerDeltaOutput {
+  const extract = (tag: string): string => {
+    const regex = new RegExp(
+      `=== ${tag} ===\\s*([\\s\\S]*?)(?==== [A-Z_]+ ===|$)`,
+    );
+    const match = content.match(regex);
+    return match?.[1]?.trim() ?? "";
+  };
+
+  const rawDelta = extract("RUNTIME_STATE_DELTA");
+  if (!rawDelta) {
+    throw new Error("runtime state delta block is missing");
+  }
+
+  const jsonPayload = stripCodeFence(rawDelta);
+  let parsed: unknown;
+  try {
+    parsed = JSON.parse(sanitizeJSON(jsonPayload));
+  } catch (error) {
+    throw new Error(`runtime state delta is not valid JSON: ${String(error)}`);
+  }
+
+  try {
+    return {
+      postSettlement: extract("POST_SETTLEMENT"),
+      runtimeStateDelta: RuntimeStateDeltaSchema.parse(parsed),
+    };
+  } catch (error) {
+    throw new Error(`runtime state delta failed schema validation: ${String(error)}`);
+  }
+}
+
+function stripCodeFence(value: string): string {
+  const trimmed = value.trim();
+  const fenced = trimmed.match(/^```(?:json)?\s*([\s\S]*?)\s*```$/i);
+  return fenced?.[1]?.trim() ?? trimmed;
+}

package/inkos/packages/core/src/agents/settler-parser.ts

@@ -0,0 +1,38 @@
+import type { GenreProfile } from "../models/genre-profile.js";
+
+export interface SettlementOutput {
+  readonly postSettlement: string;
+  readonly updatedState: string;
+  readonly updatedLedger: string;
+  readonly updatedHooks: string;
+  readonly chapterSummary: string;
+  readonly updatedSubplots: string;
+  readonly updatedEmotionalArcs: string;
+  readonly updatedCharacterMatrix: string;
+}
+
+export function parseSettlementOutput(
+  content: string,
+  genreProfile: GenreProfile,
+): SettlementOutput {
+  const extract = (tag: string): string => {
+    const regex = new RegExp(
+      `=== ${tag} ===\\s*([\\s\\S]*?)(?==== [A-Z_]+ ===|$)`,
+    );
+    const match = content.match(regex);
+    return match?.[1]?.trim() ?? "";
+  };
+
+  return {
+    postSettlement: extract("POST_SETTLEMENT"),
+    updatedState: extract("UPDATED_STATE") || "(状态卡未更新)",
+    updatedLedger: genreProfile.numericalSystem
+      ? (extract("UPDATED_LEDGER") || "(账本未更新)")
+      : "",
+    updatedHooks: extract("UPDATED_HOOKS") || "(伏笔池未更新)",
+    chapterSummary: extract("CHAPTER_SUMMARY"),
+    updatedSubplots: extract("UPDATED_SUBPLOTS"),
+    updatedEmotionalArcs: extract("UPDATED_EMOTIONAL_ARCS"),
+    updatedCharacterMatrix: extract("UPDATED_CHARACTER_MATRIX"),
+  };
+}

package/inkos/packages/core/src/agents/settler-prompts.ts

@@ -0,0 +1,230 @@
+import type { BookConfig } from "../models/book.js";
+import type { GenreProfile } from "../models/genre-profile.js";
+import type { BookRules } from "../models/book-rules.js";
+
+export function buildSettlerSystemPrompt(
+  book: BookConfig,
+  genreProfile: GenreProfile,
+  bookRules: BookRules | null,
+  language?: "zh" | "en",
+): string {
+  const resolvedLang = language ?? genreProfile.language;
+  const isEnglish = resolvedLang === "en";
+  const numericalBlock = genreProfile.numericalSystem
+    ? `\n- 本题材有数值/资源体系，你必须在 UPDATED_LEDGER 中追踪正文中出现的所有资源变动
+- 数值验算铁律：期初 + 增量 = 期末，三项必须可验算`
+    : `\n- 本题材无数值系统，UPDATED_LEDGER 留空`;
+
+  const hookRules = `
+## 伏笔追踪规则（严格执行）
+
+- 新伏笔：只有当正文中出现一个会延续到后续章节、且有具体回收方向的未解问题时，才新增 hook_id。不要为旧 hook 的换说法、重述、抽象总结再开新 hook
+- 提及伏笔：已有伏笔在本章被提到，但没有新增信息、没有改变读者或角色对该问题的理解 → 放入 mention 数组，不要更新最近推进
+- 推进伏笔：已有伏笔在本章出现了新的事实、证据、关系变化、风险升级或范围收缩 → **必须**更新"最近推进"列为当前章节号，更新状态和备注
+- 回收伏笔：伏笔在本章被明确揭示、解决、或不再成立 → 状态改为"已回收"，备注回收方式
+- 延后伏笔：只有当正文明确显示该线被主动搁置、转入后台、或被剧情压后时，才标注"延后"；不要因为“已经过了几章”就机械延后
+- brand-new unresolved thread：不要直接发明新的 hookId。把候选放进 newHookCandidates，由系统决定它是映射到旧 hook、变成真正新 hook，还是被拒绝为重述
+- payoffTiming 使用语义节奏，不用硬写章节号：只允许 immediate / near-term / mid-arc / slow-burn / endgame
+- **铁律**：不要把“再次提到”“换个说法重述”“抽象复盘”当成推进。只有状态真的变了，才更新最近推进。只是出现过的旧 hook，放进 mention 数组。`;
+
+  const fullCastBlock = bookRules?.enableFullCastTracking
+    ? `\n## 全员追踪\nPOST_SETTLEMENT 必须额外包含：本章出场角色清单、角色间关系变动、未出场但被提及的角色。`
+    : "";
+
+  const langPrefix = isEnglish
+    ? `【LANGUAGE OVERRIDE】ALL output (state card, hooks, summaries, subplots, emotional arcs, character matrix) MUST be in English. The === TAG === markers remain unchanged.\n\n`
+    : "";
+
+  return `${langPrefix}你是状态追踪分析师。给定新章节正文和当前 truth 文件，你的任务是产出更新后的 truth 文件。
+
+## 工作模式
+
+你不是在写作。你的任务是：
+1. 仔细阅读正文，提取所有状态变化
+2. 基于"当前追踪文件"做增量更新
+3. 严格按照 === TAG === 格式输出
+
+## 分析维度
+
+从正文中提取以下信息：
+- 角色出场、退场、状态变化（受伤/突破/死亡等）
+- 位置移动、场景转换
+- 物品/资源的获得与消耗
+- 伏笔的埋设、推进、回收
+- 情感弧线变化
+- 支线进展
+- 角色间关系变化、新的信息边界
+
+## 书籍信息
+
+- 标题：${book.title}
+- 题材：${genreProfile.name}（${book.genre}）
+- 平台：${book.platform}
+${numericalBlock}
+${hookRules}${fullCastBlock}
+
+## 输出格式（必须严格遵循）
+
+${buildSettlerOutputFormat(genreProfile)}
+
+## 关键规则
+
+1. 状态卡和伏笔池必须基于"当前追踪文件"做增量更新，不是从零开始
+2. 正文中的每一个事实性变化都必须反映在对应的追踪文件中
+3. 不要遗漏细节：数值变化、位置变化、关系变化、信息变化都要记录
+4. 角色交互矩阵中的"信息边界"要准确——角色只知道他在场时发生的事
+
+## 铁律：只记录正文中实际发生的事（严格执行）
+
+- **只提取正文中明确描写的事件和状态变化**。不要推断、预测、或补充正文没有写到的内容
+- 如果正文只写到角色走到门口还没进去，状态卡就不能写"角色已进入房间"
+- 如果正文只暗示了某种可能性但没有确认，不要把它当作已发生的事实记录
+- 不要从卷纲或大纲中补充正文尚未到达的剧情到状态卡
+- 不要删除或修改已有 hooks 中与本章无关的内容——只更新本章正文涉及的 hooks
+- 第 1 章尤其注意：初始追踪文件可能包含从大纲预生成的内容，只保留正文实际支持的部分，不要保留正文未涉及的预设
+- **伏笔例外**：正文中出现的未解疑问、悬念、伏笔线索必须在 hooks 中记录。这不是"推断"，而是"提取正文中的叙事承诺"。如果正文暗示了一个谜题/冲突/秘密但没有解答，那就是一个 hook，必须记录`;
+}
+
+function buildSettlerOutputFormat(gp: GenreProfile): string {
+  const chapterTypeExample = gp.chapterTypes.length > 0
+    ? gp.chapterTypes[0]
+    : "主线推进";
+
+  return `=== POST_SETTLEMENT ===
+（简要说明本章有哪些状态变动、伏笔推进、结算注意事项；允许 Markdown 表格或要点）
+
+=== RUNTIME_STATE_DELTA ===
+（必须输出 JSON，不要输出 Markdown，不要加解释）
+\`\`\`json
+{
+  "chapter": 12,
+  "currentStatePatch": {
+    "currentLocation": "可选",
+    "protagonistState": "可选",
+    "currentGoal": "可选",
+    "currentConstraint": "可选",
+    "currentAlliances": "可选",
+    "currentConflict": "可选"
+  },
+  "hookOps": {
+    "upsert": [
+      {
+        "hookId": "mentor-oath",
+        "startChapter": 8,
+        "type": "relationship",
+        "status": "progressing",
+        "lastAdvancedChapter": 12,
+        "expectedPayoff": "揭开师债真相",
+        "payoffTiming": "slow-burn",
+        "notes": "本章为何推进/延后/回收"
+      }
+    ],
+    "mention": ["本章只是被提到、没有真实推进的 hookId"],
+    "resolve": ["已回收的 hookId"],
+    "defer": ["需要标记延后的 hookId"]
+  },
+  "newHookCandidates": [
+    {
+      "type": "mystery",
+      "expectedPayoff": "新伏笔未来要回收到哪里",
+      "payoffTiming": "near-term",
+      "notes": "本章为什么会形成新的未解问题"
+    }
+  ],
+  "chapterSummary": {
+    "chapter": 12,
+    "title": "本章标题",
+    "characters": "角色1,角色2",
+    "events": "一句话概括关键事件",
+    "stateChanges": "一句话概括状态变化",
+    "hookActivity": "mentor-oath advanced",
+    "mood": "紧绷",
+    "chapterType": "${chapterTypeExample}"
+  },
+  "subplotOps": [],
+  "emotionalArcOps": [],
+  "characterMatrixOps": [],
+  "notes": []
+}
+\`\`\`
+
+规则：
+1. 只输出增量，不要重写完整 truth files
+2. 所有章节号字段都必须是整数，不能写自然语言
+3. hookOps.upsert 里只能写“当前伏笔池里已经存在”的 hookId，不允许发明新的 hookId
+4. brand-new unresolved thread 一律写进 newHookCandidates，不要自造 hookId
+5. 如果旧 hook 只是被提到、没有真实状态变化，把它放进 mention，不要更新 lastAdvancedChapter
+6. 如果本章推进了旧 hook，lastAdvancedChapter 必须等于当前章号
+7. 如果回收或延后 hook，必须放在 resolve / defer 数组里
+8. chapterSummary.chapter 必须等于当前章节号`;
+}
+
+export function buildSettlerUserPrompt(params: {
+  readonly chapterNumber: number;
+  readonly title: string;
+  readonly content: string;
+  readonly currentState: string;
+  readonly ledger: string;
+  readonly hooks: string;
+  readonly chapterSummaries: string;
+  readonly subplotBoard: string;
+  readonly emotionalArcs: string;
+  readonly characterMatrix: string;
+  readonly volumeOutline: string;
+  readonly observations?: string;
+  readonly selectedEvidenceBlock?: string;
+  readonly governedControlBlock?: string;
+  readonly validationFeedback?: string;
+}): string {
+  const ledgerBlock = params.ledger
+    ? `\n## 当前资源账本\n${params.ledger}\n`
+    : "";
+
+  const summariesBlock = params.chapterSummaries !== "(文件尚未创建)"
+    ? `\n## 已有章节摘要\n${params.chapterSummaries}\n`
+    : "";
+
+  const subplotBlock = params.subplotBoard !== "(文件尚未创建)"
+    ? `\n## 当前支线进度板\n${params.subplotBoard}\n`
+    : "";
+
+  const emotionalBlock = params.emotionalArcs !== "(文件尚未创建)"
+    ? `\n## 当前情感弧线\n${params.emotionalArcs}\n`
+    : "";
+
+  const matrixBlock = params.characterMatrix !== "(文件尚未创建)"
+    ? `\n## 当前角色交互矩阵\n${params.characterMatrix}\n`
+    : "";
+
+  const observationsBlock = params.observations
+    ? `\n## 观察日志（由 Observer 提取，包含本章所有事实变化）\n${params.observations}\n\n基于以上观察日志和正文，更新所有追踪文件。确保观察日志中的每一项变化都反映在对应的文件中。\n`
+    : "";
+  const selectedEvidenceBlock = params.selectedEvidenceBlock
+    ? `\n## 已选长程证据\n${params.selectedEvidenceBlock}\n`
+    : "";
+  const controlBlock = params.governedControlBlock ?? "";
+  const outlineBlock = controlBlock.length === 0
+    ? `\n## 卷纲\n${params.volumeOutline}\n`
+    : "";
+  const validationFeedbackBlock = params.validationFeedback
+    ? `\n## 状态校验反馈\n${params.validationFeedback}\n\n请严格纠正这些矛盾，只修正 truth files，不要改写正文，不要引入正文中不存在的新事实。\n`
+    : "";
+
+  return `请分析第${params.chapterNumber}章「${params.title}」的正文，更新所有追踪文件。
+${observationsBlock}
+${validationFeedbackBlock}
+## 本章正文
+
+${params.content}
+${controlBlock}
+
+## 当前状态卡
+${params.currentState}
+${ledgerBlock}
+## 当前伏笔池
+${params.hooks}
+${selectedEvidenceBlock}${summariesBlock}${subplotBlock}${emotionalBlock}${matrixBlock}
+${outlineBlock}
+
+请严格按照 === TAG === 格式输出结算结果。`;
+}