@zwbigi/ink-xy 0.1.2 → 0.1.4

package/inkos/packages/core/src/agents/detection-insights.ts

@@ -0,0 +1,72 @@
+/**
+ * Detection feedback loop — analyze detection_history.json to extract insights.
+ */
+
+import type { DetectionHistoryEntry, DetectionStats } from "../models/detection.js";
+
+/**
+ * Analyze detection history and produce aggregated statistics.
+ */
+export function analyzeDetectionInsights(
+  history: ReadonlyArray<DetectionHistoryEntry>,
+): DetectionStats {
+  if (history.length === 0) {
+    return {
+      totalDetections: 0,
+      totalRewrites: 0,
+      avgOriginalScore: 0,
+      avgFinalScore: 0,
+      avgScoreReduction: 0,
+      passRate: 0,
+      chapterBreakdown: [],
+    };
+  }
+
+  const detections = history.filter((h) => h.action === "detect");
+  const rewrites = history.filter((h) => h.action === "rewrite");
+
+  // Group by chapter
+  const chapterMap = new Map<number, DetectionHistoryEntry[]>();
+  for (const entry of history) {
+    const existing = chapterMap.get(entry.chapterNumber) ?? [];
+    chapterMap.set(entry.chapterNumber, [...existing, entry]);
+  }
+
+  const chapterBreakdown: Array<{
+    chapterNumber: number;
+    originalScore: number;
+    finalScore: number;
+    rewriteAttempts: number;
+  }> = [];
+
+  let totalOriginal = 0;
+  let totalFinal = 0;
+
+  for (const [chapterNumber, entries] of chapterMap) {
+    const sorted = [...entries].sort((a, b) => a.attempt - b.attempt);
+    const originalScore = sorted[0]?.score ?? 0;
+    const finalScore = sorted[sorted.length - 1]?.score ?? originalScore;
+    const rewriteAttempts = sorted.filter((e) => e.action === "rewrite").length;
+
+    chapterBreakdown.push({ chapterNumber, originalScore, finalScore, rewriteAttempts });
+    totalOriginal += originalScore;
+    totalFinal += finalScore;
+  }
+
+  const chapterCount = chapterBreakdown.length;
+  const avgOriginalScore = chapterCount > 0 ? totalOriginal / chapterCount : 0;
+  const avgFinalScore = chapterCount > 0 ? totalFinal / chapterCount : 0;
+
+  // Pass rate = chapters where final score decreased (or no rewrite needed)
+  const passedChapters = chapterBreakdown.filter((c) => c.finalScore <= c.originalScore).length;
+
+  return {
+    totalDetections: detections.length,
+    totalRewrites: rewrites.length,
+    avgOriginalScore: Math.round(avgOriginalScore * 1000) / 1000,
+    avgFinalScore: Math.round(avgFinalScore * 1000) / 1000,
+    avgScoreReduction: Math.round((avgOriginalScore - avgFinalScore) * 1000) / 1000,
+    passRate: chapterCount > 0 ? Math.round((passedChapters / chapterCount) * 100) / 100 : 0,
+    chapterBreakdown,
+  };
+}

package/inkos/packages/core/src/agents/detector.ts

@@ -0,0 +1,224 @@
+/**
+ * AIGC detection — calls external API (GPTZero, Originality, or custom endpoint) or local rule-based/LLM model.
+ * Not a BaseAgent subclass since it doesn't use the LLM provider exclusively.
+ */
+
+import type { DetectionConfig } from "../models/project.js";
+import type { AgentContext } from "./base.js";
+import { chatCompletion } from "../llm/provider.js";
+import { analyzeAITells } from "./ai-tells.js";
+
+export interface DetectionResult {
+  readonly score: number; // 0-1, higher = more likely AI
+  readonly provider: string;
+  readonly detectedAt: string;
+  readonly raw?: Record<string, unknown>;
+}
+
+/**
+ * Detect AI-generated content by calling an external detection API,
+ * running local rule-based analysis, or querying the default LLM.
+ * Returns a normalized score between 0 (human) and 1 (AI).
+ */
+export async function detectAIContent(
+  config: DetectionConfig,
+  content: string,
+  ctx?: AgentContext,
+): Promise<DetectionResult> {
+  const detectedAt = new Date().toISOString();
+
+  switch (config.provider) {
+    case "gptzero": {
+      const apiKey = getApiKey(config);
+      return detectGPTZero(config.apiUrl || "https://api.gptzero.me/v2/predict/text", apiKey, content, detectedAt);
+    }
+    case "originality": {
+      const apiKey = getApiKey(config);
+      return detectOriginality(config.apiUrl || "https://api.originality.ai/api/v1/scan/ai", apiKey, content, detectedAt);
+    }
+    case "custom": {
+      const apiKey = getApiKey(config);
+      return detectCustom(config.apiUrl || "", apiKey, content, detectedAt);
+    }
+    case "local":
+      return detectLocal(content, detectedAt);
+    case "llm":
+      if (!ctx) {
+        throw new Error("AIGC detection using LLM provider requires an AgentContext.");
+      }
+      return detectLLM(ctx, content, detectedAt);
+  }
+}
+
+function getApiKey(config: DetectionConfig): string {
+  const keyName = config.apiKeyEnv || "DETECTION_API_KEY";
+  const apiKey = process.env[keyName];
+  if (!apiKey) {
+    throw new Error(
+      `Detection API key not found. Set ${keyName} in your environment.`,
+    );
+  }
+  return apiKey;
+}
+
+async function detectGPTZero(
+  apiUrl: string,
+  apiKey: string,
+  content: string,
+  detectedAt: string,
+): Promise<DetectionResult> {
+  const response = await fetch(apiUrl, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "X-Api-Key": apiKey,
+    },
+    body: JSON.stringify({ document: content }),
+  });
+
+  if (!response.ok) {
+    const body = await response.text();
+    throw new Error(`GPTZero API failed: ${response.status} ${body}`);
+  }
+
+  const data = await response.json() as Record<string, unknown>;
+  const documents = data.documents as Array<Record<string, unknown>> | undefined;
+  const score = documents?.[0]?.completely_generated_prob as number ?? 0;
+
+  return { score, provider: "gptzero", detectedAt, raw: data };
+}
+
+async function detectOriginality(
+  apiUrl: string,
+  apiKey: string,
+  content: string,
+  detectedAt: string,
+): Promise<DetectionResult> {
+  const response = await fetch(apiUrl, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${apiKey}`,
+    },
+    body: JSON.stringify({ content }),
+  });
+
+  if (!response.ok) {
+    const body = await response.text();
+    throw new Error(`Originality API failed: ${response.status} ${body}`);
+  }
+
+  const data = await response.json() as Record<string, unknown>;
+  const score = (data.score as Record<string, unknown>)?.ai as number ?? 0;
+
+  return { score, provider: "originality", detectedAt, raw: data };
+}
+
+async function detectCustom(
+  apiUrl: string,
+  apiKey: string,
+  content: string,
+  detectedAt: string,
+): Promise<DetectionResult> {
+  if (!apiUrl) {
+    throw new Error("Detection API URL (apiUrl) must be configured for custom provider.");
+  }
+  const response = await fetch(apiUrl, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${apiKey}`,
+    },
+    body: JSON.stringify({ content }),
+  });
+
+  if (!response.ok) {
+    const body = await response.text();
+    throw new Error(`Detection API failed: ${response.status} ${body}`);
+  }
+
+  const data = await response.json() as Record<string, unknown>;
+  const score = typeof data.score === "number" ? data.score : 0;
+
+  return { score, provider: "custom", detectedAt, raw: data };
+}
+
+function detectLocal(
+  content: string,
+  detectedAt: string,
+): DetectionResult {
+  const result = analyzeAITells(content, "zh");
+  const warnings = result.issues.filter(i => i.severity === "warning");
+  const infos = result.issues.filter(i => i.severity === "info");
+
+  // Base score 0.05, +0.25 per warning, +0.10 per info, max 0.95
+  let score = 0.05 + warnings.length * 0.25 + infos.length * 0.10;
+  score = Math.min(0.95, score);
+
+  return {
+    score,
+    provider: "local",
+    detectedAt,
+    raw: { ...result, score },
+  };
+}
+
+async function detectLLM(
+  ctx: AgentContext,
+  content: string,
+  detectedAt: string,
+): Promise<DetectionResult> {
+  const prompt = `你是一位顶尖的中文文学编辑和小说AIGC写作特征（“AI味”）检测专家。
+请仔细评估以下小说章节文本的“AI味”和写作风格，并给出详细的评估结果。
+
+常见的中文小说“AI味”特征包括：
+1. 段落长度高度均匀，缺乏长短结合的节奏变化。
+2. 过度使用套话、假大空的抒情和转折词（如“然而”、“与此同时”、“在某种意义上”、“似乎”、“大概”、“不禁”等）。
+3. 列表式排比句式或连续用相同开头（如多句以“他…”或“营地…”开头）。
+4. 缺乏粗粝、真实的细节描写，多用泛化的、诗意化的概念（例如“时间流逝”、“命运纠缠”）。
+5. 叙事逻辑过于温和或圆滑，缺乏突发冲突和人物真实的心理张力。
+
+请按照以下JSON格式返回您的评估结果，绝对不要包含任何Markdown包装（如 \`\`\`json 和 \`\`\` 标记），直接返回 JSON 文本：
+{
+  "score": 0.0到1.0之间的浮点数（分值越高，表示AI痕迹越重，>=0.5为超标）,
+  "issues": [
+    {
+      "severity": "warning" 或 "info",
+      "category": "特征类别名称",
+      "description": "具体的AI痕迹或写作风格缺陷描述",
+      "suggestion": "具体的修改与润色建议"
+    }
+  ]
+}
+
+待评估文本：
+${content}`;
+
+  const response = await chatCompletion(ctx.client, ctx.model, [
+    { role: "user", content: prompt }
+  ], { temperature: 0.3 });
+
+  let score = 0.5;
+  let raw: any = {};
+  try {
+    const text = response.content.trim();
+    const jsonStr = text.replace(/^```json\s*/i, "").replace(/```$/, "").trim();
+    const data = JSON.parse(jsonStr);
+    score = typeof data.score === "number" ? data.score : 0.5;
+    raw = data;
+  } catch (e) {
+    ctx.logger?.warn(`[detector] Failed to parse LLM response as JSON: ${e}. Response was: ${response.content}`);
+    const match = response.content.match(/score["'\s:]+(\d+\.\d+|\d+)/i);
+    if (match && match[1]) {
+      score = parseFloat(match[1]);
+    }
+  }
+
+  return {
+    score,
+    provider: `llm (${ctx.model})`,
+    detectedAt,
+    raw,
+  };
+}
+

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

@@ -0,0 +1,129 @@
+import type { BookConfig } from "../models/book.js";
+import type { GenreProfile } from "../models/genre-profile.js";
+import type { BookRules } from "../models/book-rules.js";
+
+// English equivalent of buildCoreRules() — universal writing rules for English fiction
+export function buildEnglishCoreRules(_book: BookConfig): string {
+  return `## Universal Writing Rules
+
+### Character Rules
+1. **Consistency**: Behavior driven by "past experience + current interests + core personality." Never break character without cause.
+2. **Dimensionality**: Core trait + contrasting detail = real person. Perfect characters are failed characters.
+3. **No puppets**: Side characters must have independent motivation and agency. MC's strength comes from outmaneuvering smart people, not steamrolling idiots.
+4. **Voice distinction**: Different characters must speak differently—vocabulary, sentence length, slang, verbal tics.
+5. **Relationship logic**: Any relationship change must be set up by events and motivated by interests.
+
+### Narrative Technique
+6. **Show, don't tell**: Convey through action and sensory detail, not exposition. Values expressed through behavior, not declared.
+7. **Sensory grounding**: Each scene includes 1-2 sensory details beyond the visual.
+8. **Chapter hooks**: Every chapter ending needs a hook—question, reveal, threat, promise.
+9. **Information layering**: Worldbuilding emerges through action. Key lore revealed at plot-critical moments. Never dump exposition.
+10. **Description serves narrative**: Environment descriptions set mood or foreshadow. One line is enough.
+11. **Downtime earns its place**: Quiet scenes must plant hooks, advance relationships, or build contrast. Pure filler is padding.
+12. **Dialogue-driven**: In scenes with character interaction, deliver conflict and information through dialogue first, narration second. Solo/escape/exploration scenes are exempt.
+
+### Logic / Consistency
+12. **World rules are law**: Once established, physics/magic/social rules cannot bend for plot convenience.
+13. **Cost matters**: Every power, ability, or advantage must have a cost or limitation that creates real trade-offs.
+14. **Consequences stick**: Actions have consequences. Characters can't escape repercussions through luck or author fiat.
+15. **No reset buttons**: The world must change permanently in response to major events.
+
+### Reader Psychology
+16. **Promise and payoff**: Every planted hook must be resolved. Every mystery must have an answer.
+17. **Escalation**: Each conflict should feel higher-stakes than the last—either externally or emotionally.
+18. **Reader proxy**: One character should react with surprise/excitement/fear when remarkable things happen, giving readers permission to feel the same.
+19. **Pacing breathing room**: After a high-intensity sequence, give 0.5-1 chapter of lower intensity before the next escalation.`;
+}
+
+// English equivalent of buildAntiAIExamples()
+export function buildEnglishAntiAIRules(): string {
+  return `## Anti-AI Iron Laws
+
+**[IRON LAW 1]** The narrator never tells the reader what to conclude.
+If the reader can infer intent from action, the narrator must not state it.
+- ✗ "He realized this was the most important battle of his life."
+- ✓ Just write the battle—let the stakes speak.
+
+**[IRON LAW 2]** No analytical/report language in prose.
+Banned in narrative text: "core motivation," "information asymmetry," "strategic advantage," "calculated risk," "optimal outcome," "key takeaway," "it's worth noting."
+- ✗ "His core motivation was survival."
+- ✓ "He needed to get out. That was it. Everything else was noise."
+
+**[IRON LAW 3]** AI-tell words are rate-limited (max 1 per 3,000 words):
+delve, tapestry, testament, intricate, pivotal, vibrant, embark, comprehensive, nuanced, landscape (metaphorical), realm (metaphorical), foster, underscore.
+
+**[IRON LAW 4]** No repetitive image cycling.
+If the same metaphor appears twice, the third occurrence MUST switch to a new image.
+
+**[IRON LAW 5]** Planning terms never appear in chapter text.
+"Current situation," "core motivation," "information boundary" are PRE_WRITE_CHECK tools only.
+
+**[IRON LAW 6]** Ban the "Not X; Y" construction. Max once per chapter.
+- ✗ "It wasn't fear. It was something deeper."
+- ✓ State the thing directly.
+
+**[IRON LAW 7]** Ban lists of three in descriptive prose. Max once per 2,000 words.
+- ✗ "ancient, terrible, and vast"
+- ✓ Use pairs or single precise words.
+
+### Anti-AI Example Table
+
+| AI Pattern | Human Version | Why |
+|---|---|---|
+| He felt a surge of anger. | He slammed the table. The water glass toppled. | Action externalizes emotion |
+| She was overwhelmed with sadness. | She held the phone with both hands, knuckles white. | Physical detail replaces label |
+| However, things were not as simple. | Yeah, right. Nothing's ever that easy. | Character voice replaces narrator hedge |
+| He saw a shadow move across the wall. | A shadow slid across the wall. | Remove filter word "saw" |
+| "I won't do it," she exclaimed defiantly. | "I won't do it." She crossed her arms. | Action beat > adverb + fancy tag |`;
+}
+
+// English equivalent of buildCharacterPsychologyMethod()
+export function buildEnglishCharacterMethod(): string {
+  return `## Character Psychology Method (Internal Planning Tool)
+
+Before writing any character's action or dialogue, run this mental checklist (NOT in prose):
+1. **Situation**: What does this character know RIGHT NOW? (Information boundary)
+2. **Want**: What do they want in this scene? (Immediate goal)
+3. **Personality filter**: How does their personality shape their approach?
+4. **Action**: What do they DO? (Behavior, not internal monologue)
+5. **Reaction**: How do others respond to their action?
+
+This method is for YOUR planning. The terms never appear in the chapter text.`;
+}
+
+// English pre-write checklist
+export function buildEnglishPreWriteChecklist(book: BookConfig, gp: GenreProfile): string {
+  const items = [
+    "Outline anchor: Which volume_outline plot point does this chapter advance?",
+    "POV: Whose perspective? Consistent throughout?",
+    "Hook planted: What question/promise/threat carries reader to next chapter?",
+    "Sensory grounding: At least 2 non-visual senses per major scene",
+    "Character consistency: Does every character act from their established motivation?",
+    "Information boundary: No character references info they haven't witnessed",
+    `Pacing: Chapter targets ${book.chapterWordCount} words. ${gp.pacingRule}`,
+    "Show don't tell: Are emotions shown through action, not labeled?",
+    "AI-tell check: No banned analytical language in prose?",
+    "Conflict: What is the core tension driving this chapter?",
+  ];
+
+  if (gp.powerScaling) {
+    items.push("Power scaling: Does any power usage follow established rules?");
+  }
+  if (gp.numericalSystem) {
+    items.push("Numerical check: Are all stats/resources consistent with ledger?");
+  }
+
+  return `## Pre-Write Checklist
+
+Before writing, output a PRE_WRITE_CHECK addressing:
+${items.map((item, i) => `${i + 1}. ${item}`).join("\n")}`;
+}
+
+// English genre intro
+export function buildEnglishGenreIntro(book: BookConfig, gp: GenreProfile): string {
+  return `You are a professional ${gp.name} web fiction author writing for English-speaking platforms (Royal Road, Kindle Unlimited, Scribble Hub).
+
+Target: ${book.chapterWordCount} words per chapter, ${book.targetChapters} total chapters.
+
+Write in English. Vary sentence length. Mix short punchy sentences with longer flowing ones. Maintain consistent narrative voice throughout.`;
+}

package/inkos/packages/core/src/agents/fanfic-canon-importer.ts

@@ -0,0 +1,146 @@
+import { BaseAgent } from "./base.js";
+import type { FanficMode } from "../models/book.js";
+
+export interface FanficCanonOutput {
+  readonly worldRules: string;
+  readonly characterProfiles: string;
+  readonly keyEvents: string;
+  readonly powerSystem: string;
+  readonly writingStyle: string;
+  readonly fullDocument: string;
+}
+
+const MODE_LABELS: Record<FanficMode, string> = {
+  canon: "原作向（严格遵守原作设定）",
+  au: "AU/平行世界（世界规则可改，角色保留）",
+  ooc: "OOC（角色性格可偏离原作）",
+  cp: "CP（以配对关系为核心）",
+};
+
+export class FanficCanonImporter extends BaseAgent {
+  get name(): string {
+    return "fanfic-canon-importer";
+  }
+
+  async importFromText(
+    sourceText: string,
+    sourceName: string,
+    fanficMode: FanficMode,
+  ): Promise<FanficCanonOutput> {
+    // Truncate if too long (>50k chars ≈ ~25k words)
+    const maxLen = 50000;
+    const truncated = sourceText.length > maxLen;
+    const text = truncated ? sourceText.slice(0, maxLen) : sourceText;
+
+    const modeLabel = MODE_LABELS[fanficMode];
+
+    const systemPrompt = `你是一个专业的同人创作素材分析师。你的任务是从用户提供的原作素材中提取结构化正典信息，供同人写作系统使用。
+
+同人模式：${modeLabel}
+
+你需要从原作素材中提取以下内容，每个部分用 === SECTION: <name> === 分隔：
+
+=== SECTION: world_rules ===
+世界规则（地理、物理法则、魔法/力量体系、阵营组织、社会结构）。
+如果原作素材不包含明确的世界规则，从已有信息合理推断。
+
+=== SECTION: character_profiles ===
+角色档案表格，每个重要角色一行：
+
+| 角色 | 身份 | 性格底色 | 语癖/口头禅 | 说话风格 | 行为模式 | 关键关系 | 信息边界 |
+|------|------|----------|-------------|----------|----------|----------|----------|
+
+要求：
+- 语癖/口头禅必须从原文中精确提取，如有的话
+- 说话风格描述该角色的语气、用词偏好、句式特征
+- 行为模式描述该角色在特定情境下的典型反应
+- 信息边界标注该角色知道什么、不知道什么
+- 至少提取 3 个角色，不超过 15 个
+
+=== SECTION: key_events ===
+关键事件时间线：
+
+| 序号 | 事件 | 涉及角色 | 对同人写作的约束 |
+|------|------|----------|------------------|
+
+按时间/出现顺序排列，标注每个事件对同人创作的约束程度。
+
+=== SECTION: power_system ===
+力量/能力体系（如果适用）。包括等级划分、核心规则、已知限制。
+如果原作没有明确的力量体系，输出"（原作无明确力量体系）"。
+
+=== SECTION: writing_style ===
+原作写作风格特征（供同人写作模仿）：
+
+1. 叙事人称与视角（第一人称/第三人称有限/全知，是否频繁切换）
+2. 句式节奏（长短句交替模式、段落平均长度感受、对话占比）
+3. 场景描写手法（五感偏好、意象选择、环境描写密度）
+4. 对话标记习惯（说/道/笑道 等用法，对话前后是否有动作/表情补充）
+5. 情绪表达方式（直白内心独白 vs 动作外化 vs 环境映射）
+6. 比喻/修辞倾向（常用比喻类型、修辞频率）
+7. 节奏转换（紧张→舒缓的过渡方式、章节结尾习惯）
+
+每项用1-2个原文例句佐证。只提取原文实际存在的特征，不要泛泛描述。
+
+提取原则：
+- 忠实于原作素材，不捏造原作中没有的信息
+- 信息不足时标注"（素材未提及）"而非编造
+- 角色语癖是最重要的字段——同人读者最在意角色"像不像"
+- 写作风格提取必须基于实际文本特征，附原文例句
+${truncated ? "\n注意：原作素材过长，已截断。请基于已有部分提取。" : ""}`;
+
+    const response = await this.chat(
+      [
+        { role: "system", content: systemPrompt },
+        { role: "user", content: `以下是原作《${sourceName}》的素材：\n\n${text}` },
+      ],
+      { temperature: 0.3 },
+    );
+
+    const content = response.content;
+    const extract = (tag: string): string => {
+      const regex = new RegExp(
+        `=== SECTION: ${tag} ===\\s*([\\s\\S]*?)(?==== SECTION:|$)`,
+      );
+      const match = content.match(regex);
+      return match?.[1]?.trim() ?? "";
+    };
+
+    const worldRules = extract("world_rules");
+    const characterProfiles = extract("character_profiles");
+    const keyEvents = extract("key_events");
+    const powerSystem = extract("power_system");
+    const writingStyle = extract("writing_style");
+
+    const meta = [
+      "---",
+      "meta:",
+      `  sourceFile: "${sourceName}"`,
+      `  fanficMode: "${fanficMode}"`,
+      `  generatedAt: "${new Date().toISOString()}"`,
+    ].join("\n");
+
+    const fullDocument = [
+      `# 同人正典（《${sourceName}》）`,
+      "",
+      "## 世界规则",
+      worldRules || "（素材中未提取到明确世界规则）",
+      "",
+      "## 角色档案",
+      characterProfiles || "（素材中未提取到角色信息）",
+      "",
+      "## 关键事件时间线",
+      keyEvents || "（素材中未提取到关键事件）",
+      "",
+      "## 力量体系",
+      powerSystem || "（原作无明确力量体系）",
+      "",
+      "## 原作写作风格",
+      writingStyle || "（素材不足以提取风格特征）",
+      "",
+      meta,
+    ].join("\n");
+
+    return { worldRules, characterProfiles, keyEvents, powerSystem, writingStyle, fullDocument };
+  }
+}

package/inkos/packages/core/src/agents/fanfic-dimensions.ts

@@ -0,0 +1,87 @@
+import type { FanficMode } from "../models/book.js";
+
+export interface FanficDimensionConfig {
+  readonly activeIds: ReadonlyArray<number>;
+  readonly severityOverrides: ReadonlyMap<number, "critical" | "warning" | "info">;
+  readonly deactivatedIds: ReadonlyArray<number>;
+  readonly notes: ReadonlyMap<number, string>;
+}
+
+// Fanfic-specific audit dimensions (34-37)
+export const FANFIC_DIMENSIONS: ReadonlyArray<{
+  readonly id: number;
+  readonly name: string;
+  readonly baseNote: string;
+}> = [
+  {
+    id: 34,
+    name: "角色还原度",
+    baseNote: "检查角色的语癖、说话风格、行为模式是否与 fanfic_canon.md 角色档案一致。偏离必须有情境驱动。",
+  },
+  {
+    id: 35,
+    name: "世界规则遵守",
+    baseNote: "检查章节内容是否违反 fanfic_canon.md 中的世界规则（地理、力量体系、阵营关系）。",
+  },
+  {
+    id: 36,
+    name: "关系动态",
+    baseNote: "检查角色之间的关系互动是否合理，是否与 fanfic_canon.md 中标注的关键关系一致或有合理发展。",
+  },
+  {
+    id: 37,
+    name: "正典事件一致性",
+    baseNote: "检查章节是否与 fanfic_canon.md 关键事件时间线矛盾。",
+  },
+];
+
+// Mode → dimension severity mapping
+const SEVERITY_MAP: Record<FanficMode, Record<number, "critical" | "warning" | "info">> = {
+  canon: { 34: "critical", 35: "critical", 36: "warning", 37: "critical" },
+  au:    { 34: "critical", 35: "info",     36: "warning", 37: "info" },
+  ooc:   { 34: "info",     35: "warning",  36: "warning", 37: "info" },
+  cp:    { 34: "warning",  35: "warning",  36: "critical", 37: "info" },
+};
+
+// Spinoff dims (28-31) are deactivated in fanfic mode — they're for same-author spinoffs
+const SPINOFF_DIMS = [28, 29, 30, 31];
+
+// OOC mode relaxes the built-in OOC check (dim 1)
+const OOC_DIM = 1;
+
+export function getFanficDimensionConfig(
+  mode: FanficMode,
+  _allowedDeviations: ReadonlyArray<string> = [],
+): FanficDimensionConfig {
+  const severityMap = SEVERITY_MAP[mode];
+  const severityOverrides = new Map<number, "critical" | "warning" | "info">();
+  const notes = new Map<number, string>();
+
+  for (const dim of FANFIC_DIMENSIONS) {
+    severityOverrides.set(dim.id, severityMap[dim.id]!);
+
+    const severity = severityMap[dim.id]!;
+    const severityLabel = severity === "critical" ? "（严格检查）"
+      : severity === "info" ? "（仅记录，不判定失败）"
+      : "（警告级别）";
+    notes.set(dim.id, `${dim.baseNote} ${severityLabel}`);
+  }
+
+  // OOC mode relaxes the built-in OOC check
+  if (mode === "ooc") {
+    severityOverrides.set(OOC_DIM, "info");
+    notes.set(OOC_DIM, "OOC模式下角色可偏离性格底色，此维度仅记录不判定失败。参照 fanfic_canon.md 角色档案评估偏离程度。");
+  }
+
+  // Canon mode strengthens the built-in OOC check
+  if (mode === "canon") {
+    notes.set(OOC_DIM, "原作向同人：角色必须严格遵守性格底色。参照 fanfic_canon.md 角色档案中的性格底色和行为模式。");
+  }
+
+  return {
+    activeIds: FANFIC_DIMENSIONS.map((d) => d.id),
+    severityOverrides,
+    deactivatedIds: SPINOFF_DIMS,
+    notes,
+  };
+}