@waterwx/dsh-novel-forge 2.1.2-alpha → 2.1.3

package/lib/types/src/review-policy.d.ts

@@ -1,97 +0,0 @@
-/**
- * 审稿规则注册表
- *
- * 生成用 compact 模式（核心规则），审稿用 full 模式（全部规则），
- * 消除 reviewSystemPrompt 内嵌规则与 renderAllAssets() 两套打架的问题。
- */
-/** 通用写作资产规则（兼容 ProjectAssets 中的各类规则） */
-export interface WritingRule {
-    name: string;
-    description: string;
-    type?: string;
-    enabled?: boolean;
-}
-export interface ReviewRule {
-    id: string;
-    /** 规则维度 */
-    dimension: 'character' | 'setting' | 'redline' | 'writing' | 'pacing' | 'logic' | 'anti-ai' | 'presentation' | 'compliance';
-    /** 严重度 */
-    severity: 'high' | 'medium' | 'low';
-    /** 规则类型：forbidden=禁止类（命中即问题），encourage=鼓励类（不命中不算错） */
-    type: 'forbidden' | 'encourage';
-    /** 规则描述 */
-    description: string;
-    /** 是否启用 */
-    enabled: boolean;
-    /** 作用域 */
-    scope: Array<'writing' | 'review' | 'polish' | 'all'>;
-}
-/** 内置审稿维度（结构化评分用） */
-export declare const REVIEW_DIMENSIONS: readonly [{
-    readonly id: "character";
-    readonly name: "人设一致性";
-    readonly weight: 0.2;
-}, {
-    readonly id: "setting";
-    readonly name: "设定一致性";
-    readonly weight: 0.15;
-}, {
-    readonly id: "redline";
-    readonly name: "红线检查";
-    readonly weight: 0.15;
-}, {
-    readonly id: "writing";
-    readonly name: "文笔质量";
-    readonly weight: 0.15;
-}, {
-    readonly id: "pacing";
-    readonly name: "节奏与爽点";
-    readonly weight: 0.1;
-}, {
-    readonly id: "logic";
-    readonly name: "逻辑漏洞";
-    readonly weight: 0.1;
-}, {
-    readonly id: "anti-ai";
-    readonly name: "反 AI 规则";
-    readonly weight: 0.05;
-}, {
-    readonly id: "presentation";
-    readonly name: "呈现方式";
-    readonly weight: 0.05;
-}, {
-    readonly id: "compliance";
-    readonly name: "内容合规";
-    readonly weight: 0.05;
-}];
-export type ReviewDimensionId = typeof REVIEW_DIMENSIONS[number]['id'];
-/** 维度结构化评分 */
-export interface DimensionScore {
-    dimension: ReviewDimensionId;
-    score: number;
-    note: string;
-}
-/**
- * 渲染审稿规则（compact 或 full 模式）
- *
- * compact: 只渲染禁止类 + high 严重度（用于生成时的约束）
- * full: 渲染全部启用规则（用于审稿时的检查清单）
- */
-export declare function renderReviewRules(assets: WritingRule[] | undefined, mode?: 'compact' | 'full'): string;
-/**
- * 从审稿 issues 中按维度统计
- * 用于结构化评分和 UI 展示。
- */
-export declare function groupIssuesByDimension(issues: Array<{
-    severity: string;
-    item: string;
-    dimension?: string;
-}>): Record<string, Array<{
-    severity: string;
-    item: string;
-}>>;
-/**
- * 计算维度加权总分
- * 用于审稿报告的结构化评分。
- */
-export declare function calculateWeightedScore(dimensions: DimensionScore[]): number;

package/lib/types/src/routes.d.ts

@@ -1,29 +0,0 @@
-/**
- * The /api/dsh-novel-forge route family: status, docx outline loading, LLM
- * story-bible extraction, volume planning, chapter planning, streaming
- * generation / rewrite / polish (NDJSON frames), review, summaries,
- * foreshadows, export, chapter reading, config patching, and opening the
- * output folder. Every route carries the same loopback-only trust fence as
- * the family plugins — these endpoints invoke the LLM and write files on the
- * host machine.
- */
-import type { WebRoute } from '@deepseek-ai/dsh-host-webserver';
-import type { Context } from '@deepseek-ai/cordis';
-import { type BibleResponse, type ConfigPatch, type ExportResponse, type LoadOutlineResponse, type NovelConfig, type PlanResponse, type StatusResponse, type VolumesResponse } from './protocol.ts';
-import { chapterFileName } from './engine.ts';
-/** Route deps. */
-export interface NovelRoutesDeps {
-    ctx: Context;
-    /** Resolve the live plugin config (settings-aware). */
-    getConfig: () => NovelConfig;
-    /** Persist a config patch through the settings seam. */
-    patchConfig: (patch: ConfigPatch) => Promise<NovelConfig>;
-}
-/**
- * Build every /api/dsh-novel-forge route.
- * @param deps - context, config resolver, config patcher.
- * @returns the route list.
- */
-export declare function makeRoutes(deps: NovelRoutesDeps): WebRoute[];
-export type { ConfigPatch, NovelConfig, StatusResponse, PlanResponse, LoadOutlineResponse, BibleResponse, VolumesResponse, ExportResponse, };
-export { chapterFileName };

package/lib/types/src/run.d.ts

@@ -1,32 +0,0 @@
-import type { Context } from '@deepseek-ai/cordis';
-import type { NovelConfig, RunState } from './protocol.ts';
-export declare class ProductionRunner {
-    private deps;
-    private state;
-    private working;
-    private pauseRequested;
-    private stopRequested;
-    /** 生产单绑定目录（start 时快照；所有读写固定用它，防止运行中切书导致写错目录）。 */
-    private bookDir;
-    constructor(deps: {
-        ctx: Context;
-        getConfig: () => NovelConfig;
-    });
-    /** 当前生产单状态（内存优先；web 重启后从磁盘恢复）。 */
-    status(): RunState | null;
-    private persist;
-    private log;
-    /** 启动/续跑生产单：startNo..endNo 区间，endNo 超出计划时先自动补计划。 */
-    start(startNo: number, endNo: number): Promise<RunState>;
-    pause(): void;
-    resume(): void;
-    stop(): void;
-    /** 主循环：从 currentNo 扫描到 endNo，逐章处理；支持暂停/停止。 */
-    private loop;
-    private processChapter;
-    /** 完整质量门：生成 → 摘要+事实 → 伏笔标记 → 审稿 → 作者复盘。 */
-    private produce;
-    /** 被拒分级处理：无 high 豁免；有 high 按意见修订（最多 2 轮）+ 验证模式；仍不过 → 待人工。 */
-    private handleRejected;
-    private applyDraft;
-}

package/lib/types/src/shot-language.d.ts

@@ -1,46 +0,0 @@
-/**
- * 镜头语言词库（分镜规范化基准）。
- * 分镜表的 shot/camera/composition/light 字段统一从这里取值（英文 id），
- * 生成提示词时用 zh 中文词块；适配英文平台时用 en。
- * 目的：让"景别/运镜/构图/光效"有标准词表，避免 LLM 自由发挥导致漂移。
- */
-/** 景别。 */
-export type ShotSizeId = 'extreme_wide' | 'wide' | 'full' | 'medium' | 'medium_close' | 'close' | 'extreme_close' | 'big_extreme_close';
-/** 运镜/机位。 */
-export type CameraMoveId = 'static' | 'dolly_in' | 'dolly_out' | 'pan_left' | 'pan_right' | 'track_left' | 'track_right' | 'follow' | 'pedestal_up' | 'pedestal_down' | 'orbit' | 'handheld' | 'low_angle' | 'high_angle' | 'over_shoulder';
-/** 构图。 */
-export type CompositionId = 'rule_of_thirds' | 'center' | 'leading_line' | 'foreground' | 'low' | 'overhead' | 'symmetry';
-/** 光效。 */
-export type LightingId = 'front' | 'side' | 'back' | 'top' | 'rembrandt' | 'neon' | 'hard' | 'soft' | 'mood' | 'contrast';
-export interface ShotLangEntry<T extends string> {
-    id: T;
-    /** 中文（提示词/展示用）。 */
-    zh: string;
-    /** 英文（英文平台适配用）。 */
-    en: string;
-    /** 一句话说明（下拉/卡片）。 */
-    hint: string;
-}
-export declare const SHOT_SIZES: readonly ShotLangEntry<ShotSizeId>[];
-export declare const CAMERA_MOVES: readonly ShotLangEntry<CameraMoveId>[];
-export declare const COMPOSITIONS: readonly ShotLangEntry<CompositionId>[];
-export declare const LIGHTINGS: readonly ShotLangEntry<LightingId>[];
-export interface ShotLanguage {
-    shot?: ShotSizeId;
-    camera: CameraMoveId[];
-    composition?: CompositionId;
-    light: LightingId[];
-}
-/** 从中文文本归一化到景别（处理旧数据/LLM 口语）。未知回退 medium。 */
-export declare function normalizeShotSize(text: string | undefined): ShotSizeId;
-/** 从中文文本归一化到运镜列表。 */
-export declare function normalizeCameras(text: string | undefined): CameraMoveId[];
-/** 从中文文本归一化到构图（可选）。 */
-export declare function normalizeComposition(text: string | undefined): CompositionId | undefined;
-/** 从中文文本归一化到光效列表。 */
-export declare function normalizeLightings(text: string | undefined): LightingId[];
-/** 取词条中文（ZHs 合并句子）。 */
-export declare function sizeZh(id: ShotSizeId | undefined): string;
-export declare function cameraZh(ids: CameraMoveId[] | undefined): string;
-export declare function compoZh(id: CompositionId | undefined): string;
-export declare function lightZh(ids: LightingId[] | undefined): string;

package/lib/types/src/story-beat-language.d.ts

@@ -1,35 +0,0 @@
-/**
- * 编剧词库（剧情骨架规范化基准）。
- * 骨架的 function（叙事功能）与 emotion（情绪走向）统一从这里取值（英文 id），
- * 生成提示词/展示时用 zh 中文。
- * 目的：让"叙事功能/情绪"有标准词表，避免 LLM 自由发挥导致情绪链漂移。
- */
-/** 叙事功能（对应节拍在剧情中的作用）。 */
-export type StoryFunctionId = 'exposition' | 'conflict' | 'turn' | 'climax' | 'resolve' | 'foreshadow' | 'character';
-/** 情绪词（低→高能量的情绪阶，角色在节拍中的主要情绪点）。 */
-export type EmotionId = 'calm' | 'indifferent' | 'expectant' | 'curious' | 'alert' | 'suppressed' | 'enduring' | 'worried' | 'irritable' | 'uneasy' | 'terrified' | 'angry' | 'collapsing' | 'resolute' | 'grieved' | 'relieved' | 'bittersweet' | 'triumphant' | 'reborn' | 'numb';
-export interface BeatLangEntry<T extends string> {
-    id: T;
-    /** 中文（展示用）。 */
-    zh: string;
-    /** 英文（英文平台适配用）。 */
-    en: string;
-    /** 一句话说明。 */
-    hint: string;
-}
-/** 叙事功能词表。 */
-export declare const STORY_FUNCTIONS: readonly BeatLangEntry<StoryFunctionId>[];
-/** 情绪词表（按能量/阶段排序）。 */
-export declare const EMOTIONS: readonly BeatLangEntry<EmotionId>[];
-export interface StoryBeatLanguage {
-    function: StoryFunctionId;
-    emotion: EmotionId[];
-}
-/** 从中文归一化叙事功能（未知回退 exposition）。 */
-export declare function normalizeStoryFunction(text: string | undefined): StoryFunctionId;
-/** 从中文文本归一化情绪词列表（可含→箭头链）。 */
-export declare function normalizeEmotions(text: string | undefined): EmotionId[];
-/** 叙事功能中文。 */
-export declare function functionZh(id: StoryFunctionId | undefined): string;
-/** 情绪中文（箭头连接）。 */
-export declare function emotionZh(ids: EmotionId[] | undefined): string;

package/lib/types/src/style-library.d.ts

@@ -1,33 +0,0 @@
-/**
- * 风格库（内置模板）：漫剧方案的视觉基底 + 可叠加滤镜。
- * 关键词针对即梦 Seedream 优化：画风定义 + 质感描述 + 光影色彩 + 即梦质量词（8K/五官清晰/真实材质）。
- */
-export type StyleCategory = '3d' | 'game' | '2d' | 'craft' | 'film';
-export interface ArtStyle {
-    id: string;
-    /** 风格名（用户可见）。 */
-    name: string;
-    category: StyleCategory;
-    /** 特点一句话（卡片展示）。 */
-    traits: string;
-    /** 风格关键词/前缀（生成角色图/视频提示词时套用）。 */
-    keywords: string;
-    /** 是否可作为滤镜叠加在基底风格之上（影视实验类；缺省 false）。 */
-    stackable?: boolean;
-    /** 默认推荐排序权重（0-1，推荐池排序参考）。 */
-    weight?: number;
-}
-export declare const STYLE_CATEGORIES: ReadonlyArray<{
-    id: StyleCategory;
-    label: string;
-    icon: string;
-    desc: string;
-}>;
-/** 内置风格模板（基底 21 个 + 滤镜 3 个）。 */
-export declare const STYLE_LIBRARY: ArtStyle[];
-/** 按分类取风格。 */
-export declare function stylesByCategory(category: StyleCategory): ArtStyle[];
-/** 取单个风格（未找到返回 undefined）。 */
-export declare function findStyle(id: string): ArtStyle | undefined;
-/** 按基底 + 滤镜拼接风格关键词（角色图/分镜/视频提示词共用；缺省回退 3D 动漫）。 */
-export declare function styleKeywords(styleId?: string, filterId?: string): string;

package/lib/types/story-beat-language.d.ts

@@ -1,35 +0,0 @@
-/**
- * 编剧词库（剧情骨架规范化基准）。
- * 骨架的 function（叙事功能）与 emotion（情绪走向）统一从这里取值（英文 id），
- * 生成提示词/展示时用 zh 中文。
- * 目的：让"叙事功能/情绪"有标准词表，避免 LLM 自由发挥导致情绪链漂移。
- */
-/** 叙事功能（对应节拍在剧情中的作用）。 */
-export type StoryFunctionId = 'exposition' | 'conflict' | 'turn' | 'climax' | 'resolve' | 'foreshadow' | 'character';
-/** 情绪词（低→高能量的情绪阶，角色在节拍中的主要情绪点）。 */
-export type EmotionId = 'calm' | 'indifferent' | 'expectant' | 'curious' | 'alert' | 'suppressed' | 'enduring' | 'worried' | 'irritable' | 'uneasy' | 'terrified' | 'angry' | 'collapsing' | 'resolute' | 'grieved' | 'relieved' | 'bittersweet' | 'triumphant' | 'reborn' | 'numb';
-export interface BeatLangEntry<T extends string> {
-    id: T;
-    /** 中文（展示用）。 */
-    zh: string;
-    /** 英文（英文平台适配用）。 */
-    en: string;
-    /** 一句话说明。 */
-    hint: string;
-}
-/** 叙事功能词表。 */
-export declare const STORY_FUNCTIONS: readonly BeatLangEntry<StoryFunctionId>[];
-/** 情绪词表（按能量/阶段排序）。 */
-export declare const EMOTIONS: readonly BeatLangEntry<EmotionId>[];
-export interface StoryBeatLanguage {
-    function: StoryFunctionId;
-    emotion: EmotionId[];
-}
-/** 从中文归一化叙事功能（未知回退 exposition）。 */
-export declare function normalizeStoryFunction(text: string | undefined): StoryFunctionId;
-/** 从中文文本归一化情绪词列表（可含→箭头链）。 */
-export declare function normalizeEmotions(text: string | undefined): EmotionId[];
-/** 叙事功能中文。 */
-export declare function functionZh(id: StoryFunctionId | undefined): string;
-/** 情绪中文（箭头连接）。 */
-export declare function emotionZh(ids: EmotionId[] | undefined): string;

package/lib/types/style-library.d.ts

@@ -1,33 +0,0 @@
-/**
- * 风格库（内置模板）：漫剧方案的视觉基底 + 可叠加滤镜。
- * 关键词针对即梦 Seedream 优化：画风定义 + 质感描述 + 光影色彩 + 即梦质量词（8K/五官清晰/真实材质）。
- */
-export type StyleCategory = '3d' | 'game' | '2d' | 'craft' | 'film';
-export interface ArtStyle {
-    id: string;
-    /** 风格名（用户可见）。 */
-    name: string;
-    category: StyleCategory;
-    /** 特点一句话（卡片展示）。 */
-    traits: string;
-    /** 风格关键词/前缀（生成角色图/视频提示词时套用）。 */
-    keywords: string;
-    /** 是否可作为滤镜叠加在基底风格之上（影视实验类；缺省 false）。 */
-    stackable?: boolean;
-    /** 默认推荐排序权重（0-1，推荐池排序参考）。 */
-    weight?: number;
-}
-export declare const STYLE_CATEGORIES: ReadonlyArray<{
-    id: StyleCategory;
-    label: string;
-    icon: string;
-    desc: string;
-}>;
-/** 内置风格模板（基底 21 个 + 滤镜 3 个）。 */
-export declare const STYLE_LIBRARY: ArtStyle[];
-/** 按分类取风格。 */
-export declare function stylesByCategory(category: StyleCategory): ArtStyle[];
-/** 取单个风格（未找到返回 undefined）。 */
-export declare function findStyle(id: string): ArtStyle | undefined;
-/** 按基底 + 滤镜拼接风格关键词（角色图/分镜/视频提示词共用；缺省回退 3D 动漫）。 */
-export declare function styleKeywords(styleId?: string, filterId?: string): string;

package/src/ai-scan.ts

@@ -1,179 +0,0 @@
-/**
- * 本地 AI 味扫描器（不调 LLM，确定性检测）
- *
- * 用途：生成/润色后自动扫描，结果作为「事实锚点」注入审稿提示词，
- * 让 LLM 做判断而非机械统计。也可用于 UI 展示 AI 味指标。
- */
-
-export interface AiScanResult {
-  /** 总评分 0-100，越高越像 AI 写的 */
-  aiScore: number
-  /** 命中的套话及次数 */
-  clicheHits: Array<{ word: string; count: number }>
-  /** 段落长度方差（过高=段落过于整齐） */
-  paragraphLengthVariance: number
-  /** 连续解释性叙事段数（≥3 视为问题） */
-  consecutiveExpositoryParagraphs: number
-  /** 句式重复率（相同开头句式占比） */
-  sentenceRepetitionRate: number
-  /** 过长段落数（>300字） */
-  longParagraphCount: number
-  /** 过短段落数（<20字） */
-  shortParagraphCount: number
-  /** 对话占比（0-1） */
-  dialogueRatio: number
-  /** 问题摘要，可直接注入审稿提示词 */
-  summary: string
-}
-
-/** 重灾区套话（高频出现即问题） */
-const HEAVY_CLICHES = [
-  '不禁', '仿佛', '一时间', '不由得', '顿时', '然而',
-  '缓缓', '轻轻', '微微', '默默', '似乎', '终于',
-  '显然', '其实', '无法形容', '难以言喻', '不由自主',
-]
-
-/** 轻微套话（偶尔出现可接受，高频才问题） */
-const LIGHT_CLICHES = [
-  '心中', '脑海', '眼神', '嘴角', '眉头', '身影',
-  '气息', '光芒', '力量', '感觉', '知道', '明白',
-]
-
-/** 解释性叙事开头模式 */
-const EXPOSITORY_STARTS = [
-  '原来', '因为', '由于', '所以', '因此', '于是',
-  '这就是', '也就是说', '换句话说', '事实上', '实际上',
-]
-
-export function scanAiFlavor(text: string): AiScanResult {
-  const paragraphs = text.split(/\n{2,}/).map(p => p.trim()).filter(p => p.length > 0)
-  const totalChars = text.length
-
-  // 1. 套话统计
-  const clicheHits: Array<{ word: string; count: number }> = []
-  let clicheTotal = 0
-  for (const word of [...HEAVY_CLICHES, ...LIGHT_CLICHES]) {
-    const count = countOccurrences(text, word)
-    if (count > 0) {
-      clicheHits.push({ word, count })
-      clicheTotal += count
-    }
-  }
-  clicheHits.sort((a, b) => b.count - a.count)
-
-  // 2. 段落长度方差
-  const paraLengths = paragraphs.map(p => p.length)
-  const avgLen = paraLengths.length > 0 ? paraLengths.reduce((a, b) => a + b, 0) / paraLengths.length : 0
-  const variance = paraLengths.length > 0
-    ? paraLengths.reduce((sum, len) => sum + Math.pow(len - avgLen, 2), 0) / paraLengths.length
-    : 0
-
-  // 3. 连续解释性叙事
-  let maxConsecutive = 0
-  let currentConsecutive = 0
-  for (const p of paragraphs) {
-    const isExpository = EXPOSITORY_STARTS.some(s => p.startsWith(s)) ||
-      (p.length > 150 && !p.includes('"') && !p.includes('「') && !p.includes('『'))
-    if (isExpository) {
-      currentConsecutive++
-      maxConsecutive = Math.max(maxConsecutive, currentConsecutive)
-    } else {
-      currentConsecutive = 0
-    }
-  }
-
-  // 4. 句式重复率（相同句首词）
-  const sentences = text.split(/[。！？!?]/).map(s => s.trim()).filter(s => s.length > 0)
-  const starterCounts = new Map<string, number>()
-  for (const s of sentences) {
-    const starter = s.slice(0, 2)
-    starterCounts.set(starter, (starterCounts.get(starter) ?? 0) + 1)
-  }
-  const repeatedStarters = Array.from(starterCounts.values()).filter(c => c >= 3).reduce((a, b) => a + b, 0)
-  const sentenceRepetitionRate = sentences.length > 0 ? repeatedStarters / sentences.length : 0
-
-  // 5. 段落长度分布
-  const longParagraphCount = paraLengths.filter(l => l > 300).length
-  const shortParagraphCount = paraLengths.filter(l => l < 20).length
-
-  // 6. 对话占比
-  const dialogueChars = (text.match(/["「『][^"」』]*["」』]/g) ?? []).join('').length
-  const dialogueRatio = totalChars > 0 ? dialogueChars / totalChars : 0
-
-  // 7. 综合 AI 味评分（0-100，越高越像 AI）
-  let aiScore = 0
-  // 套话密度（每千字套话数）
-  const clicheDensity = totalChars > 0 ? (clicheTotal / totalChars) * 1000 : 0
-  aiScore += Math.min(40, clicheDensity * 8)
-  // 段落过于整齐（方差小=AI特征）
-  if (variance < 2000 && paraLengths.length >= 5) aiScore += 15
-  // 连续解释性叙事
-  aiScore += Math.min(20, maxConsecutive * 5)
-  // 句式重复
-  aiScore += Math.min(15, sentenceRepetitionRate * 30)
-  // 对话过少
-  if (dialogueRatio < 0.05 && totalChars > 1000) aiScore += 10
-  aiScore = Math.min(100, Math.round(aiScore))
-
-  // 8. 问题摘要
-  const issues: string[] = []
-  if (clicheDensity > 3) {
-    const topCliches = clicheHits.slice(0, 5).map(h => `${h.word}×${h.count}`).join('、')
-    issues.push(`套话密度偏高（每千字 ${clicheDensity.toFixed(1)} 次）：${topCliches}`)
-  }
-  if (maxConsecutive >= 3) issues.push(`连续 ${maxConsecutive} 段解释性叙事，缺少对话/动作`)
-  if (sentenceRepetitionRate > 0.15) issues.push(`句式重复率 ${(sentenceRepetitionRate * 100).toFixed(0)}%，开头句式单一`)
-  if (longParagraphCount > 3) issues.push(`${longParagraphCount} 段超过 300 字，段落过长`)
-  if (dialogueRatio < 0.05 && totalChars > 1000) issues.push('对话占比过低，整章偏叙述')
-
-  const summary = issues.length > 0
-    ? `本地 AI 味扫描（AI 味指数 ${aiScore}/100）：\n` + issues.map(i => `- ${i}`).join('\n')
-    : `本地 AI 味扫描（AI 味指数 ${aiScore}/100）：未发现明显问题。`
-
-  return {
-    aiScore,
-    clicheHits,
-    paragraphLengthVariance: Math.round(variance),
-    consecutiveExpositoryParagraphs: maxConsecutive,
-    sentenceRepetitionRate: Math.round(sentenceRepetitionRate * 100) / 100,
-    longParagraphCount,
-    shortParagraphCount,
-    dialogueRatio: Math.round(dialogueRatio * 100) / 100,
-    summary,
-  }
-}
-
-function countOccurrences(text: string, word: string): number {
-  if (word.length === 0) return 0
-  let count = 0
-  let idx = text.indexOf(word)
-  while (idx !== -1) {
-    count++
-    idx = text.indexOf(word, idx + word.length)
-  }
-  return count
-}
-
-/** 扫描前后对比（润色时用） */
-export function compareAiScan(before: AiScanResult, after: AiScanResult): {
-  improved: boolean
-  deltaScore: number
-  details: string[]
-} {
-  const deltaScore = before.aiScore - after.aiScore
-  const details: string[] = []
-  if (deltaScore > 0) details.push(`AI 味指数下降 ${deltaScore} 分（${before.aiScore} → ${after.aiScore}）`)
-  else if (deltaScore < 0) details.push(`AI 味指数上升 ${-deltaScore} 分（${before.aiScore} → ${after.aiScore}），需检查`)
-  else details.push(`AI 味指数持平（${before.aiScore}）`)
-
-  const beforeCliches = before.clicheHits.reduce((a, b) => a + b.count, 0)
-  const afterCliches = after.clicheHits.reduce((a, b) => a + b.count, 0)
-  if (afterCliches < beforeCliches) details.push(`套话减少 ${beforeCliches - afterCliches} 处`)
-  else if (afterCliches > beforeCliches) details.push(`套话增加 ${afterCliches - beforeCliches} 处`)
-
-  return {
-    improved: deltaScore > 0,
-    deltaScore,
-    details,
-  }
-}