@waterwx/dsh-novel-forge 1.1.9 → 1.2.0-alpha

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

@@ -0,0 +1,97 @@
+/**
+ * 审稿规则注册表
+ *
+ * 生成用 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/routes.d.ts

@@ -18,6 +18,10 @@ export interface NovelRoutesDeps {
     getConfig: () => NovelConfig;
     /** Persist a config patch through the settings seam. */
     patchConfig: (patch: ConfigPatch) => Promise<NovelConfig>;
+    /** Raw settings config（未与激活书合并）——目录迁移判断默认目录是否需同步用。 */
+    rawConfig?: () => {
+        outputDir?: string;
+    };
 }
 /**
  * Build every /api/dsh-novel-forge route.

package/lib/types/run.d.ts

@@ -17,10 +17,12 @@ export declare class ProductionRunner {
     private persist;
     private log;
     /** 启动/续跑生产单：startNo..endNo 区间，endNo 超出计划时先自动补计划。 */
-    start(startNo: number, endNo: number): Promise<RunState>;
+    start(startNo: number, endNo: number, runDir?: string): Promise<RunState>;
     pause(): void;
     resume(): void;
     stop(): void;
+    /** 是否有生产单正在执行（目录迁移等磁盘级操作前须为 false）。 */
+    isWorking(): boolean;
     /** 主循环：从 currentNo 扫描到 endNo，逐章处理；支持暂停/停止。 */
     private loop;
     private processChapter;

package/lib/types/stage-contract.d.ts

@@ -0,0 +1,60 @@
+/**
+ * 阶段契约（Stage Contract）——宿主计算的「当前阶段 → 本轮允许的动作」。
+ *
+ * 设计来源（借鉴 dsh-ai-novel-writer 的「作者请求中的当前阶段决定唯一允许命令」）：
+ * 允许的动作必须由宿主根据真实项目状态算出，而不是指望模型记住或自律。
+ * 宿主计算结果同时用于三处：
+ *   1) 注入助手系统提示词：模型知道自己在哪一步、下一步该做什么；
+ *   2) 通用续写指令（「继续 / 下一步」）下的写操作白名单强约束（阶段即唯一命令）；
+ *   3) 拒绝写操作时给出可执行的、阶段相关的理由，而不是一句「不允许」。
+ *
+ * 注意：作者显式点名的写操作永远优先于阶段白名单（作者终审权）；
+ * 阶段强约束只在作者没有指定具体对象（通用续写）时生效。
+ */
+import type { ChapterPlan, ProjectState, StageInfo } from './protocol.ts';
+/** 创作阶段标识（线上形状见 protocol.ts 的 StageInfo）。 */
+export type BookStageId = StageInfo['id'];
+/** 一个阶段契约。 */
+export type BookStage = StageInfo;
+/**
+ * 作者这一轮是否只说了「继续/下一步」这类没有具体对象的指令。
+ *
+ * @param message 本轮用户消息。
+ * @returns 是通用续写指令时为 true。
+ */
+export declare function isGenericContinue(message: string): boolean;
+/**
+ * 根据项目真实状态计算当前创作阶段。
+ *
+ * @param project 当前项目（未加载时为 undefined）。
+ * @returns 阶段契约（推荐动作 + 写操作白名单 + 判定理由）。
+ */
+export declare function computeBookStage(project: ProjectState | undefined): BookStage;
+/**
+ * 判断某写操作是否在当前阶段的允许白名单内。
+ *
+ * @param stage 阶段契约。
+ * @param tool 助手工具名。
+ * @returns 允许时为 true。
+ */
+export declare function stageAllows(stage: BookStage, tool: string): boolean;
+/**
+ * 按阶段把一组动作分成「本阶段可用」与「阶段外」。
+ *
+ * @param stage 阶段契约。
+ * @param tools 动作名列表（通常是写操作登记表）。
+ * @returns 两个保持输入顺序的子集。
+ */
+export declare function splitByStage(stage: BookStage, tools: readonly string[]): {
+    available: string[];
+    outside: string[];
+};
+/**
+ * 渲染阶段契约为可注入提示词的一段文字。
+ *
+ * @param stage 阶段契约。
+ * @returns 多行文本。
+ */
+export declare function renderStageContract(stage: BookStage): string;
+/** 汇总章节状态计数（供面板/提示词展示，避免各处重复统计）。 */
+export declare function summarizeChapters(chapters: ChapterPlan[]): Record<string, number>;

package/package.json

@@ -1,8 +1,32 @@
 {
   "name": "@waterwx/dsh-novel-forge",
-  "description": "AI 编译小说工作台 for the dsh web GUI: import a novel outline (docx/text), plan chapters with LLM, generate chapter by chapter (3000-4000 chars each), and save every chapter as Markdown into your chosen output folder.",
-  "version": "1.1.9",
+  "description": "AI 编译纯文本小说工作台 for the dsh web GUI: import a novel outline (docx/text), plan volumes & chapters with LLM, generate chapter by chapter (3000-4000 chars each), auto AI review & book audit, and export the full book as Markdown/TXT into your chosen output folder.",
+  "version": "1.2.0-alpha",
   "type": "module",
+  "author": "waterwx",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/watersxya/dsh-novel-forge.git"
+  },
+  "homepage": "https://github.com/watersxya/dsh-novel-forge",
+  "bugs": {
+    "url": "https://github.com/watersxya/dsh-novel-forge/issues"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "小说工坊",
+    "novel-forge",
+    "ai-novel-writing",
+    "novel-writing",
+    "写作助手",
+    "小说创作",
+    "网文写作",
+    "章节生成",
+    "AI审稿",
+    "story-writing"
+  ],
   "engines": {
     "node": "^22.19.0 || >=24.0.0"
   },
@@ -26,7 +50,6 @@
     },
     "client": {
       "inject": [
-        "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-connection",
         "@deepseek-ai/dsh-client-ui-settings"
       ],
@@ -35,36 +58,35 @@
   },
   "dependencies": {
     "fflate": "^0.8.2",
+    "lucide-react": "^1.33.0",
     "schemastery": "^3.18.0"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-llm": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-skill": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-client-connection": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-locale": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-host-webserver": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-llm": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-settings": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-skill": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-system-prompt": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-tools": "0.1.2-alpha.3",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-llm": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-skill": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.5",
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-client-connection": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-locale": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-host-webserver": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-llm": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-settings": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-skill": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-system-prompt": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-tools": "0.1.2-alpha.3",
     "@types/node": "^22.20.0",
     "@types/react": "~18.3.1",
     "@types/react-dom": "^18.3.5",
@@ -77,10 +99,9 @@
   },
   "files": [
     "lib/**/*.js",
-    "lib/**/*.js.map",
     "lib/**/*.d.ts",
-    "lib/**/*.d.ts.map",
     "src",
+    "scripts/patch-schemastery.mjs",
     "cordis.patch.yml",
     "README.md"
   ],
@@ -91,6 +112,9 @@
     "bundle": "tsdown",
     "watch": "tsdown --watch",
     "typecheck": "tsc --noEmit",
+    "check:styles": "node scripts/check-theme-sizes.mjs",
+    "release": "node scripts/release.mjs",
+    "release:dry": "node scripts/release.mjs --dry-run",
     "test": "vitest run"
   }
 }

package/scripts/patch-schemastery.mjs

@@ -0,0 +1,47 @@
+// Durable local fix: schemastery@3.18.x from npm has no "exports" field, which
+// breaks tsx/Node ESM resolution when dsh loads novel-forge's lib/index.js.
+// pnpm re-installs can overwrite the manual node_modules patch, so this script
+// re-applies it on every `pnpm install` (postinstall).
+import { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const root = join(fileURLToPath(new URL('..', import.meta.url)))
+const pnpmDir = join(root, 'node_modules', '.pnpm')
+
+if (!existsSync(pnpmDir)) {
+  console.warn('[dsh-novel-forge] no node_modules/.pnpm found; skip schemastery patch')
+  process.exit(0)
+}
+
+const candidates = readdirSync(pnpmDir)
+  .filter((name) => name.startsWith('schemastery@'))
+  .map((name) => join(pnpmDir, name, 'node_modules', 'schemastery', 'package.json'))
+  .filter((file) => existsSync(file))
+
+if (candidates.length === 0) {
+  console.warn('[dsh-novel-forge] schemastery package not found; skip patch')
+  process.exit(0)
+}
+
+let patched = 0
+for (const file of candidates) {
+  const pkg = JSON.parse(readFileSync(file, 'utf8'))
+  if (pkg.exports) {
+    console.log(`[dsh-novel-forge] schemastery exports already present: ${file}`)
+    continue
+  }
+  pkg.exports = {
+    '.': {
+      types: './lib/index.d.ts',
+      import: './lib/index.mjs',
+      require: './lib/index.cjs',
+    },
+    './package.json': './package.json',
+  }
+  writeFileSync(file, `${JSON.stringify(pkg, null, 2)}\n`, 'utf8')
+  console.log(`[dsh-novel-forge] patched schemastery exports: ${file}`)
+  patched++
+}
+
+if (patched === 0) console.log('[dsh-novel-forge] schemastery patch: nothing to do')

package/src/action-guard.ts

@@ -0,0 +1,127 @@
+/**
+ * 动作失败分级（fail-stop 规则）——不依赖 LLM/宿主服务的纯逻辑模块，可离线单测。
+ *
+ * 规则来源（借鉴 dsh-ai-novel-writer）：
+ *  - 参数/契约类失败**不得重复同一调用**，解释一次即停；
+ *  - 瞬时故障允许有限重试，同样禁止无限重试。
+ * 规则必须可测试，否则只是文档。
+ */
+
+/**
+ * 动作失败分级：
+ * - `contract` 参数/契约类（参数缺失、片段未找到、章节不存在、非法取值…）：
+ *   同一调用只允许修正一次，禁止原样重复。
+ * - `transient` 瞬时故障（网络、模型中断、磁盘临时不可用…）：允许重试一次。
+ */
+export type ActionErrorKind = 'contract' | 'transient'
+
+/** 带分级的动作失败（executeAction 抛出，供 fail-stop 判定）。 */
+export class NovelActionError extends Error {
+  readonly kind: ActionErrorKind
+  constructor(kind: ActionErrorKind, message: string) {
+    super(message)
+    this.name = 'NovelActionError'
+    this.kind = kind
+  }
+}
+
+/** 瞬时故障特征（先判，避免被下面的契约词误伤）。 */
+const TRANSIENT_PATTERNS: readonly RegExp[] = [
+  /助手调用失败/,
+  /生成失败|请求失败|调用失败/,
+  /network|fetch failed|ECONNRESET|ECONNREFUSED|ETIMEDOUT|EPIPE|EAI_AGAIN|socket hang up|aborted|terminated/i,
+  /超时|timeout/i,
+  /频繁|限流|rate\s*limit|too many requests|\b429\b/i,
+  /ENOSPC|EACCES|EBUSY|EPERM|EMFILE/,
+]
+
+/**
+ * 参数/契约类失败特征（兜底识别）。
+ *
+ * 宿主自己的前置条件失败已在抛出点标成 {@link NovelActionError}（引擎与助手动作层），
+ * 这里的正则只兜住漏标的历史消息与第三方错误。
+ */
+const CONTRACT_PATTERNS: readonly RegExp[] = [
+  /动作参数不是合法 JSON/,
+  /未知工具/,
+  /需要/,
+  /不存在/,
+  /尚未生成/,
+  /未找到/,
+  /不在计划中/,
+  /正文文件不存在/,
+  /还没有已写章节/,
+  /没有可分析的已写章节/,
+  /非法/,
+  /无效/,
+  /必须是/,
+  /无法识别/,
+  /请先/,
+]
+
+/**
+ * 判定一次动作失败的类别。
+ *
+ * @param error 捕获到的异常。
+ * @returns `contract`（参数/契约，不重试原样调用）或 `transient`（瞬时，可重试一次）。
+ */
+export function classifyActionError(error: unknown): ActionErrorKind {
+  if (error instanceof NovelActionError) return error.kind
+  const message = error instanceof Error ? error.message : String(error)
+  if (TRANSIENT_PATTERNS.some(re => re.test(message))) return 'transient'
+  if (CONTRACT_PATTERNS.some(re => re.test(message))) return 'contract'
+  // 未知错误默认按瞬时处理：允许一次重试，但同一调用签名仍有次数上限（见 fail-stop）。
+  return 'transient'
+}
+
+/**
+ * 同一调用签名允许的总尝试次数（含首次）。
+ *
+ * @param kind 失败类别。
+ * @returns `contract` = 1（禁止原样重复），`transient` = 2（允许一次重试）。
+ */
+export function actionRetryLimit(kind: ActionErrorKind): number {
+  return kind === 'contract' ? 1 : 2
+}
+
+/**
+ * 把动作参数规范化为稳定签名（键排序），用于识别「同一个调用」。
+ *
+ * @param args 动作参数。
+ * @returns 稳定字符串签名。
+ */
+export function safeArgsKey(args: Record<string, unknown> | undefined): string {
+  if (args === undefined) return ''
+  try {
+    return JSON.stringify(Object.keys(args).sort().map(key => [key, args[key]]))
+  } catch {
+    return String(args)
+  }
+}
+
+/**
+ * 已失败调用记账：同一签名达到重试上限即 fail-stop。
+ */
+export class FailureLedger {
+  private readonly counts = new Map<string, number>()
+
+  /**
+   * 记录一次失败并判断是否应当停止本轮。
+   *
+   * @param tool 工具名。
+   * @param args 该次调用参数。
+   * @param kind 失败类别。
+   * @returns `attempts` 本次是第几次失败；`stop` 是否达到上限（true = 立即停止，不再喂回模型）。
+   */
+  record(tool: string, args: Record<string, unknown> | undefined, kind: ActionErrorKind): { attempts: number; stop: boolean } {
+    const signature = `${tool}:${safeArgsKey(args)}`
+    const attempts = (this.counts.get(signature) ?? 0) + 1
+    this.counts.set(signature, attempts)
+    return { attempts, stop: attempts >= actionRetryLimit(kind) }
+  }
+
+  /** 已登记的失败签名数量（测试/诊断用）。 */
+  get size(): number {
+    return this.counts.size
+  }
+}

package/src/ai-scan.ts

@@ -0,0 +1,179 @@
+/**
+ * 本地 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,
+  }
+}