@zwbigi/ink-xy 0.1.2 → 0.1.4

package/inkos/packages/core/src/agents/fanfic-prompt-sections.ts

@@ -0,0 +1,109 @@
+import type { FanficMode } from "../models/book.js";
+
+const MODE_PREAMBLES: Record<FanficMode, string> = {
+  canon: `你正在写**原作向同人**。严格遵守正典：
+- 角色的语癖、说话风格、行为模式必须与原作一致
+- 世界规则不可违反
+- 关键事件时间线不可矛盾
+- 可以填充原作空白、探索未详述的角度`,
+
+  au: `你正在写**AU（平行世界）同人**：
+- 世界规则可以改变（已在 allowedDeviations 中声明的偏离）
+- 角色的核心性格和说话方式应保持辨识度——读者要能认出是谁
+- AU 设定偏离必须内部一致（改了一条规则，相关的都要跟着变）`,
+
+  ooc: `你正在写**OOC 同人**：
+- 角色在极端情境下可以偏离性格底色
+- 但偏离必须有情境驱动，不能无缘无故变性格
+- 保留角色的语癖和说话特征——即使性格变了，说话方式也应有辨识度`,
+
+  cp: `你正在写**CP 同人**，以角色互动和关系发展为核心：
+- 配对双方每章必须有有效互动
+- 互动风格要有化学反应——不是两个人在同一个场景各干各的
+- 关系发展应有节奏感：推进、试探、阻碍、突破`,
+};
+
+export function buildFanficCanonSection(
+  fanficCanon: string,
+  mode: FanficMode,
+): string {
+  return `
+## 同人正典参照
+
+${MODE_PREAMBLES[mode]}
+
+以下是原作正典信息，写作时必须参照：
+
+${fanficCanon}`;
+}
+
+export function buildCharacterVoiceProfiles(fanficCanon: string): string {
+  // Extract character table from fanfic_canon.md
+  const tableMatch = fanficCanon.match(
+    /## 角色档案[\s\S]*?\n(\|[^\n]+\|\n\|[-|\s]+\|\n(?:\|[^\n]+\|\n)*)/,
+  );
+  if (!tableMatch) return "";
+
+  const rows = tableMatch[1]!
+    .split("\n")
+    .filter((line) => line.startsWith("|") && !line.startsWith("|--") && !line.startsWith("| 角色"))
+    .map((line) =>
+      line
+        .split("|")
+        .map((cell) => cell.trim())
+        .filter(Boolean),
+    )
+    .filter((cells) => cells.length >= 5);
+
+  if (rows.length === 0) return "";
+
+  const profiles = rows.map((cells) => {
+    const [name, , , catchphrases, speakingStyle, behavior] = cells;
+    const parts: string[] = [`### ${name}`];
+    if (catchphrases && catchphrases !== "（素材未提及）") {
+      parts.push(`- 口头禅/语癖：${catchphrases}`);
+    }
+    if (speakingStyle && speakingStyle !== "（素材未提及）") {
+      parts.push(`- 说话风格：${speakingStyle}`);
+    }
+    if (behavior && behavior !== "（素材未提及）") {
+      parts.push(`- 典型行为：${behavior}`);
+    }
+    return parts.join("\n");
+  });
+
+  return `
+## 角色语音参照（同人写作专用）
+
+以下角色的对话和行为必须参照原作特征。写对话时，先想"这个角色在原作里会怎么说"。
+
+${profiles.join("\n\n")}`;
+}
+
+const MODE_CHECKS: Record<FanficMode, string> = {
+  canon: `- 正典合规检查：本章是否违反原作设定？角色对话是否符合原作语癖？
+- 信息边界检查：角色是否引用了不该知道的信息？`,
+
+  au: `- AU 偏离清单：本章改变了哪些世界规则？改变是否内部一致？
+- 角色辨识度检查：读者能否从对话中认出角色？`,
+
+  ooc: `- OOC 偏离记录：角色在哪些方面偏离了性格底色？偏离驱动力是什么？
+- 语癖保留检查：即使 OOC，说话方式是否还有原作特征？`,
+
+  cp: `- CP 互动检查：配对双方本章是否有有效互动？关系发展是否推进？
+- 互动质量检查：互动是否有化学反应（不是各干各的）？`,
+};
+
+export function buildFanficModeInstructions(
+  mode: FanficMode,
+  allowedDeviations: ReadonlyArray<string>,
+): string {
+  const deviationsBlock = allowedDeviations.length > 0
+    ? `\n允许的偏离（不视为违规）：\n${allowedDeviations.map((d) => `- ${d}`).join("\n")}\n`
+    : "";
+
+  return `
+## 同人写作自检（在 PRE_WRITE_CHECK 中额外检查）
+
+${MODE_CHECKS[mode]}${deviationsBlock}`;
+}

package/inkos/packages/core/src/agents/foundation-reviewer.ts

@@ -0,0 +1,204 @@
+import { BaseAgent } from "./base.js";
+import type { ArchitectOutput } from "./architect.js";
+
+export interface FoundationReviewResult {
+  readonly passed: boolean;
+  readonly totalScore: number;
+  readonly dimensions: ReadonlyArray<{
+    readonly name: string;
+    readonly score: number;
+    readonly feedback: string;
+  }>;
+  readonly overallFeedback: string;
+}
+
+const PASS_THRESHOLD = 80;
+const DIMENSION_FLOOR = 60;
+
+export class FoundationReviewerAgent extends BaseAgent {
+  get name(): string {
+    return "foundation-reviewer";
+  }
+
+  async review(params: {
+    readonly foundation: ArchitectOutput;
+    readonly mode: "original" | "fanfic" | "series";
+    readonly sourceCanon?: string;
+    readonly styleGuide?: string;
+    readonly language: "zh" | "en";
+  }): Promise<FoundationReviewResult> {
+    const canonBlock = params.sourceCanon
+      ? `\n## 原作正典参照\n${params.sourceCanon.slice(0, 8000)}\n`
+      : "";
+    const styleBlock = params.styleGuide
+      ? `\n## 原作风格参照\n${params.styleGuide.slice(0, 2000)}\n`
+      : "";
+
+    const dimensions = params.mode === "original"
+      ? this.originalDimensions(params.language)
+      : this.derivativeDimensions(params.language, params.mode);
+
+    const systemPrompt = params.language === "en"
+      ? this.buildEnglishReviewPrompt(dimensions, canonBlock, styleBlock)
+      : this.buildChineseReviewPrompt(dimensions, canonBlock, styleBlock);
+
+    const userPrompt = this.buildFoundationExcerpt(params.foundation, params.language);
+
+    const response = await this.chat([
+      { role: "system", content: systemPrompt },
+      { role: "user", content: userPrompt },
+    ], { temperature: 0.3 });
+
+    return this.parseReviewResult(response.content, dimensions);
+  }
+
+  private originalDimensions(language: "zh" | "en"): ReadonlyArray<string> {
+    return language === "en"
+      ? [
+          "Core Conflict (Is there a clear, compelling central conflict that can sustain 40 chapters?)",
+          "Opening Momentum (Can the first 5 chapters create a page-turning hook?)",
+          "World Coherence (Is the worldbuilding internally consistent and specific?)",
+          "Character Differentiation (Are the main characters distinct in voice and motivation?)",
+          "Pacing Feasibility (Does the volume outline have enough variety — not the same beat for 10 chapters?)",
+        ]
+      : [
+          "核心冲突（是否有清晰且有足够张力的核心冲突支撑40章？）",
+          "开篇节奏（前5章能否形成翻页驱动力？）",
+          "世界一致性（世界观是否内洽且具体？）",
+          "角色区分度（主要角色的声音和动机是否各不相同？）",
+          "节奏可行性（卷纲是否有足够变化——不会连续10章同一种节拍？）",
+        ];
+  }
+
+  private derivativeDimensions(language: "zh" | "en", mode: "fanfic" | "series"): ReadonlyArray<string> {
+    const modeLabel = mode === "fanfic"
+      ? (language === "en" ? "Fan Fiction" : "同人")
+      : (language === "en" ? "Series" : "系列");
+
+    return language === "en"
+      ? [
+          `Source DNA Preservation (Does the ${modeLabel} respect the original's world rules, character personalities, and established facts?)`,
+          `New Narrative Space (Is there a clear divergence point or new territory that gives the story room to be ORIGINAL, not a retelling?)`,
+          "Core Conflict (Is the new story's central conflict compelling and distinct from the original?)",
+          "Opening Momentum (Can the first 5 chapters create a page-turning hook without requiring 3 chapters of setup?)",
+          `Pacing Feasibility (Does the outline avoid the trap of re-walking the original's plot beats?)`,
+        ]
+      : [
+          `原作DNA保留（${modeLabel}是否尊重原作的世界规则、角色性格、已确立事实？）`,
+          `新叙事空间（是否有明确的分岔点或新领域，让故事有原创空间，而非复述原作？）`,
+          "核心冲突（新故事的核心冲突是否有足够张力且区别于原作？）",
+          "开篇节奏（前5章能否形成翻页驱动力，不需要3章铺垫？）",
+          `节奏可行性（卷纲是否避免了重走原作剧情节拍的陷阱？）`,
+        ];
+  }
+
+  private buildChineseReviewPrompt(
+    dimensions: ReadonlyArray<string>,
+    canonBlock: string,
+    styleBlock: string,
+  ): string {
+    return `你是一位资深小说编辑，正在审核一本新书的基础设定（世界观 + 大纲 + 规则）。
+
+你需要从以下维度逐项打分（0-100），并给出具体意见：
+
+${dimensions.map((dim, i) => `${i + 1}. ${dim}`).join("\n")}
+
+## 评分标准
+- 80+ 通过，可以开始写作
+- 60-79 有明显问题，需要修改
+- <60 方向性错误，需要重新设计
+
+## 输出格式（严格遵守）
+=== DIMENSION: 1 ===
+分数：{0-100}
+意见：{具体反馈}
+
+=== DIMENSION: 2 ===
+分数：{0-100}
+意见：{具体反馈}
+
+...（每个维度一个 block）
+
+=== OVERALL ===
+总分：{加权平均}
+通过：{是/否}
+总评：{1-2段总结，指出最大的问题和最值得保留的优点}
+${canonBlock}${styleBlock}
+
+审核时要严格。不要因为"还行"就给高分。80分意味着"可以直接开写，不需要改"。`;
+  }
+
+  private buildEnglishReviewPrompt(
+    dimensions: ReadonlyArray<string>,
+    canonBlock: string,
+    styleBlock: string,
+  ): string {
+    return `You are a senior fiction editor reviewing a new book's foundation (worldbuilding + outline + rules).
+
+Score each dimension (0-100) with specific feedback:
+
+${dimensions.map((dim, i) => `${i + 1}. ${dim}`).join("\n")}
+
+## Scoring
+- 80+ Pass — ready to write
+- 60-79 Needs revision
+- <60 Fundamental direction problem
+
+## Output format (strict)
+=== DIMENSION: 1 ===
+Score: {0-100}
+Feedback: {specific feedback}
+
+=== DIMENSION: 2 ===
+Score: {0-100}
+Feedback: {specific feedback}
+
+...
+
+=== OVERALL ===
+Total: {weighted average}
+Passed: {yes/no}
+Summary: {1-2 paragraphs — biggest problem and best quality}
+${canonBlock}${styleBlock}
+
+Be strict. 80 means "ready to write without changes."`;
+  }
+
+  private buildFoundationExcerpt(foundation: ArchitectOutput, language: "zh" | "en"): string {
+    return language === "en"
+      ? `## Story Bible\n${foundation.storyBible.slice(0, 3000)}\n\n## Volume Outline\n${foundation.volumeOutline.slice(0, 3000)}\n\n## Book Rules\n${foundation.bookRules.slice(0, 1500)}\n\n## Initial State\n${foundation.currentState.slice(0, 1000)}\n\n## Initial Hooks\n${foundation.pendingHooks.slice(0, 1000)}`
+      : `## 世界设定\n${foundation.storyBible.slice(0, 3000)}\n\n## 卷纲\n${foundation.volumeOutline.slice(0, 3000)}\n\n## 规则\n${foundation.bookRules.slice(0, 1500)}\n\n## 初始状态\n${foundation.currentState.slice(0, 1000)}\n\n## 初始伏笔\n${foundation.pendingHooks.slice(0, 1000)}`;
+  }
+
+  private parseReviewResult(
+    content: string,
+    dimensions: ReadonlyArray<string>,
+  ): FoundationReviewResult {
+    const parsedDimensions: Array<{ readonly name: string; readonly score: number; readonly feedback: string }> = [];
+
+    for (let i = 0; i < dimensions.length; i++) {
+      const regex = new RegExp(
+        `=== DIMENSION: ${i + 1} ===\\s*[\\s\\S]*?(?:分数|Score)[：:]\\s*(\\d+)[\\s\\S]*?(?:意见|Feedback)[：:]\\s*([\\s\\S]*?)(?==== |$)`,
+      );
+      const match = content.match(regex);
+      parsedDimensions.push({
+        name: dimensions[i]!,
+        score: match ? parseInt(match[1]!, 10) : 50,
+        feedback: match ? match[2]!.trim() : "(parse failed)",
+      });
+    }
+
+    const totalScore = parsedDimensions.length > 0
+      ? Math.round(parsedDimensions.reduce((sum, d) => sum + d.score, 0) / parsedDimensions.length)
+      : 0;
+    const anyBelowFloor = parsedDimensions.some((d) => d.score < DIMENSION_FLOOR);
+    const passed = totalScore >= PASS_THRESHOLD && !anyBelowFloor;
+
+    const overallMatch = content.match(
+      /=== OVERALL ===[\s\S]*?(?:总评|Summary)[：:]\s*([\s\S]*?)$/,
+    );
+    const overallFeedback = overallMatch ? overallMatch[1]!.trim() : "(parse failed)";
+
+    return { passed, totalScore, dimensions: parsedDimensions, overallFeedback };
+  }
+}

package/inkos/packages/core/src/agents/length-normalizer.ts

@@ -0,0 +1,218 @@
+import { BaseAgent } from "./base.js";
+import type { LengthNormalizeMode, LengthSpec } from "../models/length-governance.js";
+import { countChapterLength, chooseNormalizeMode, isOutsideHardRange, isOutsideSoftRange } from "../utils/length-metrics.js";
+
+export interface NormalizeLengthInput {
+  readonly chapterContent: string;
+  readonly lengthSpec: LengthSpec;
+  readonly chapterIntent?: string;
+  readonly reducedControlBlock?: string;
+}
+
+export interface NormalizeLengthOutput {
+  readonly normalizedContent: string;
+  readonly finalCount: number;
+  readonly applied: boolean;
+  readonly mode: LengthNormalizeMode;
+  readonly warning?: string;
+  readonly tokenUsage?: {
+    readonly promptTokens: number;
+    readonly completionTokens: number;
+    readonly totalTokens: number;
+  };
+}
+
+export class LengthNormalizerAgent extends BaseAgent {
+  get name(): string {
+    return "length-normalizer";
+  }
+
+  async normalizeChapter(input: NormalizeLengthInput): Promise<NormalizeLengthOutput> {
+    const originalCount = countChapterLength(input.chapterContent, input.lengthSpec.countingMode);
+    const mode = input.lengthSpec.normalizeMode === "none"
+      ? chooseNormalizeMode(originalCount, input.lengthSpec)
+      : input.lengthSpec.normalizeMode;
+
+    if (mode === "none") {
+      return {
+        normalizedContent: input.chapterContent,
+        finalCount: originalCount,
+        applied: false,
+        mode,
+      };
+    }
+
+    const systemPrompt = this.buildSystemPrompt(mode);
+    const userPrompt = this.buildUserPrompt(input, originalCount, mode);
+    const response = await this.chat(
+      [
+        { role: "system", content: systemPrompt },
+        { role: "user", content: userPrompt },
+      ],
+      {
+        temperature: 0.2,
+      },
+    );
+
+    const sanitizedContent = this.sanitizeNormalizedContent(response.content, input.chapterContent);
+    const sanitizedCount = countChapterLength(sanitizedContent, input.lengthSpec.countingMode);
+    const wasTruncated = sanitizedContent !== input.chapterContent
+      && sanitizedCount < input.lengthSpec.hardMin
+      && this.looksTruncated(sanitizedContent);
+    const normalizedContent = wasTruncated ? input.chapterContent : sanitizedContent;
+    const finalCount = countChapterLength(normalizedContent, input.lengthSpec.countingMode);
+    const warning = wasTruncated
+      ? "Length normalizer output appeared truncated; kept original chapter."
+      : this.buildWarning(finalCount, input.lengthSpec);
+
+    return {
+      normalizedContent,
+      finalCount,
+      applied: true,
+      mode,
+      warning,
+      tokenUsage: response.usage,
+    };
+  }
+
+  private buildSystemPrompt(mode: LengthNormalizeMode): string {
+    const action = mode === "compress"
+      ? "compress"
+      : "expand";
+
+    return `你是一位章节长度修正器。你的任务是对章节正文做一次单次修正，只能执行一次，不得递归重写。
+
+修正目标：
+- ${action} 章节长度到给定目标区间
+- 保留章节原有事实、关键钩子、角色名和必须保留的标记
+- 不要引入新的支线、未来揭示或额外总结
+- 不要在正文外输出任何解释`;
+  }
+
+  private buildUserPrompt(
+    input: NormalizeLengthInput,
+    originalCount: number,
+    mode: LengthNormalizeMode,
+  ): string {
+    const intentBlock = input.chapterIntent
+      ? `\n## Chapter Intent\n${input.chapterIntent}\n`
+      : "";
+    const controlBlock = input.reducedControlBlock
+      ? `\n## Reduced Control Block\n${input.reducedControlBlock}\n`
+      : "";
+
+    return `请对下面正文做一次${mode === "compress" ? "压缩" : "扩写"}修正。
+
+## Length Spec
+- Target: ${input.lengthSpec.target}
+- Soft Range: ${input.lengthSpec.softMin}-${input.lengthSpec.softMax}
+- Hard Range: ${input.lengthSpec.hardMin}-${input.lengthSpec.hardMax}
+- Counting Mode: ${input.lengthSpec.countingMode}
+
+## Current Count
+${originalCount}
+
+## Correction Rules
+- 只修正一次，不要递归
+- 保留正文中的关键标记、人物名、地点名和已有事实
+- 不要凭空新增子情节
+- 不要插入解释性总结或分析
+- 输出修正后的完整正文，不要加标签
+
+${intentBlock}${controlBlock}
+## Chapter Content
+${input.chapterContent}`;
+  }
+
+  private buildWarning(finalCount: number, lengthSpec: LengthSpec): string | undefined {
+    if (!isOutsideSoftRange(finalCount, lengthSpec)) {
+      return undefined;
+    }
+
+    if (isOutsideHardRange(finalCount, lengthSpec)) {
+      return `Final count ${finalCount} is outside the hard range ${lengthSpec.hardMin}-${lengthSpec.hardMax} after one normalization pass.`;
+    }
+
+    return `Final count ${finalCount} is outside the soft range ${lengthSpec.softMin}-${lengthSpec.softMax} after one normalization pass.`;
+  }
+
+  private sanitizeNormalizedContent(rawContent: string, fallbackContent: string): string {
+    const trimmed = rawContent.trim();
+    if (!trimmed) return fallbackContent;
+
+    const fenced = this.extractFirstFencedBlock(trimmed);
+    if (fenced) return fenced;
+
+    const stripped = this.stripCommonWrappers(trimmed);
+    if (stripped !== undefined) {
+      // Empty after stripping = response was only wrapper text, use original
+      if (!stripped) return fallbackContent;
+      // Guard: if stripping removed more than 50% of content, the regex was too aggressive.
+      if (stripped.length < trimmed.length * 0.5) return trimmed;
+      return stripped;
+    }
+
+    return trimmed;
+  }
+
+  private looksTruncated(content: string): boolean {
+    const trimmed = content.trim();
+    if (!trimmed) return false;
+    if (trimmed.endsWith("```")) return false;
+    if (/[。！？!?」』”’）)\]】》…]$/.test(trimmed)) return false;
+    if (/\n\s*$/.test(content) && /[，,；;：:]$/.test(trimmed)) return true;
+    return /[，,；;：:、]$/.test(trimmed) || /[\u4e00-\u9fffA-Za-z0-9]$/.test(trimmed);
+  }
+
+  private extractFirstFencedBlock(content: string): string | undefined {
+    const match = content.match(/```(?:[a-zA-Z-]+)?\s*\n([\s\S]*?)\n```/);
+    if (!match) return undefined;
+    const body = match[1]?.trim();
+    return body ? body : undefined;
+  }
+
+  private stripCommonWrappers(content: string): string | undefined {
+    const lines = content.split("\n");
+    let removedAny = false;
+    const keptLines: string[] = [];
+
+    for (const rawLine of lines) {
+      const trimmed = rawLine.trim();
+      if (this.isWrapperLine(trimmed)) {
+        removedAny = true;
+        continue;
+      }
+      keptLines.push(rawLine);
+    }
+
+    if (!removedAny) {
+      return undefined;
+    }
+
+    return keptLines.join("\n").trim();
+  }
+
+  private isWrapperLine(line: string): boolean {
+    if (!line) return false;
+    if (/^```/.test(line)) return true;
+    if (/^#+\s*(说明|解释|注释|analysis|analysis note)\b/i.test(line)) return true;
+
+    if (/^(下面是|以下是).*(正文|章节|压缩|扩写|修正|修改|调整|改写|润色|结果|内容|输出|版本)/i.test(line)) {
+      return true;
+    }
+
+    if (/^我先.*(压缩|扩写|修正|修改|调整|改写|润色|处理).*(正文|章节)?/i.test(line)) {
+      return true;
+    }
+
+    if (/^(here(?:'s| is)|below is).*(chapter|draft|content|rewrite|revised|compressed|expanded|normalized|adjusted|output|version|result)/i.test(line)) {
+      return true;
+    }
+
+    if (/^i(?:'ll| will)\s+(rewrite|revise|reword|compress|expand|normalize|adjust|shorten|lengthen|trim|fix)\b/i.test(line)) {
+      return true;
+    }
+
+    return false;
+  }
+}

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

@@ -0,0 +1,127 @@
+import type { BookConfig } from "../models/book.js";
+import type { GenreProfile } from "../models/genre-profile.js";
+
+/**
+ * Observer phase: extract ALL facts from the chapter.
+ * Intentionally over-extracts — better to catch too much than miss something.
+ * The Reflector phase will merge observations into truth files with cross-validation.
+ */
+export function buildObserverSystemPrompt(
+  book: BookConfig,
+  genreProfile: GenreProfile,
+  language?: "zh" | "en",
+): string {
+  const isEnglish = (language ?? genreProfile.language) === "en";
+
+  const langPrefix = isEnglish
+    ? "【LANGUAGE OVERRIDE】ALL output MUST be in English.\n\n"
+    : "";
+
+  return `${langPrefix}${isEnglish ? "You are" : "你是"}${isEnglish ? " a fact extraction specialist" : "一个事实提取专家"}。${isEnglish ? "Read the chapter text and extract EVERY observable fact change." : "阅读章节正文，提取每一个可观察到的事实变化。"}
+
+${isEnglish ? "## Extraction Categories" : "## 提取类别"}
+
+${isEnglish ? `1. **Character actions**: Who did what, to whom, why
+2. **Location changes**: Who moved where, from where
+3. **Resource changes**: Items gained, lost, consumed, quantities
+4. **Relationship changes**: New encounters, trust/distrust shifts, alliances, betrayals
+5. **Emotional shifts**: Character mood before → after, trigger event
+6. **Information flow**: Who learned what, who is still unaware
+7. **Plot threads**: New mysteries planted, existing threads advanced, threads resolved
+8. **Time progression**: How much time passed, time markers mentioned
+9. **Physical state**: Injuries, healing, fatigue, power changes` : `1. **角色行为**：谁做了什么，对谁，为什么
+2. **位置变化**：谁去了哪里，从哪里来
+3. **资源变化**：获得、失去、消耗了什么，具体数量
+4. **关系变化**：新相遇、信任/不信任转变、结盟、背叛
+5. **情绪变化**：角色情绪从X到Y，触发事件是什么
+6. **信息流动**：谁知道了什么新信息，谁仍然不知情
+7. **剧情线索**：新埋下的悬念、已有线索的推进、线索的解答
+8. **时间推进**：过了多少时间，提到的时间标记
+9. **身体状态**：受伤、恢复、疲劳、战力变化`}
+
+${isEnglish ? "## Rules" : "## 规则"}
+
+${isEnglish ? `- Extract from the TEXT ONLY — do not infer what might happen
+- Over-extract: if unsure whether something is significant, include it
+- Be specific: "Lin Chen's left arm fractured" not "Lin Chen got hurt"
+- Include chapter-internal time markers
+- Note which characters are present in each scene` : `- 只从正文提取——不推测可能发生的事
+- 宁多勿少：不确定是否重要时也要记录
+- 具体化："陆承烬左肩旧伤开裂" 而非 "陆承烬受伤了"
+- 记录章节内的时间标记
+- 标注每个场景中在场的角色`}
+
+${isEnglish ? "## Output Format" : "## 输出格式"}
+
+=== OBSERVATIONS ===
+
+${isEnglish ? `[CHARACTERS]
+- <name>: <action/state change> (scene: <location>)
+
+[LOCATIONS]
+- <character> moved from <A> to <B>
+
+[RESOURCES]
+- <character> gained/lost <item> (quantity: <n>)
+
+[RELATIONSHIPS]
+- <charA> → <charB>: <change description>
+
+[EMOTIONS]
+- <character>: <before> → <after> (trigger: <event>)
+
+[INFORMATION]
+- <character> learned: <fact> (source: <how>)
+- <character> still unaware of: <fact>
+
+[PLOT_THREADS]
+- NEW: <description>
+- ADVANCED: <existing thread> — <progress>
+- RESOLVED: <thread> — <resolution>
+
+[TIME]
+- <time markers, duration>
+
+[PHYSICAL_STATE]
+- <character>: <injury/healing/fatigue/power change>` : `[角色行为]
+- <角色名>: <行为/状态变化> (场景: <地点>)
+
+[位置变化]
+- <角色> 从 <A> 到 <B>
+
+[资源变化]
+- <角色> 获得/失去 <物品> (数量: <n>)
+
+[关系变化]
+- <角色A> → <角色B>: <变化描述>
+
+[情绪变化]
+- <角色>: <之前> → <之后> (触发: <事件>)
+
+[信息流动]
+- <角色> 得知: <事实> (来源: <途径>)
+- <角色> 仍不知: <事实>
+
+[剧情线索]
+- 新埋: <描述>
+- 推进: <已有线索> — <进展>
+- 回收: <线索> — <解答>
+
+[时间]
+- <时间标记、时长>
+
+[身体状态]
+- <角色>: <受伤/恢复/疲劳/战力变化>`}`;
+}
+
+export function buildObserverUserPrompt(
+  chapterNumber: number,
+  title: string,
+  content: string,
+  language?: "zh" | "en",
+): string {
+  const isEnglish = language === "en";
+  return isEnglish
+    ? `Extract all facts from Chapter ${chapterNumber} "${title}":\n\n${content}`
+    : `请提取第${chapterNumber}章「${title}」中的所有事实：\n\n${content}`;
+}