@waterwx/dsh-novel-forge 2.1.3 → 2.1.5

package/lib/index.js

@@ -1546,12 +1546,7 @@ const BUILTIN_ANTI_AI_RULES = [
 		name: "句式重复率偏高",
 		avoid: "连续使用同构句式（「首先…然后…接着…最后…」），读起来机械。",
 		fix: "拉开句长与起句方式，打散结构。",
-		detectPatterns: [
-			"首先",
-			"然后",
-			"接着",
-			"最后"
-		],
+		detectPatterns: ["首先"],
 		builtin: true,
 		key: "risk-repeated-sentence-structure",
 		severity: "forbidden",
@@ -5347,6 +5342,7 @@ const NOVEL_API = {
 	revisionPlan: "/api/dsh-novel-forge/revision/plan",
 	/** 张力曲线（GET 数据 / POST 设置）。 */
 	tension: "/api/dsh-novel-forge/tension",
+	styleHistory: "/api/dsh-novel-forge/style-history",
 	/** 提示词槽位（GET 列表 / POST 写入）。 */
 	promptSlots: "/api/dsh-novel-forge/prompt-slots",
 	/** 故事时间线（GET 列表 / POST 操作）。 */
@@ -6745,15 +6741,15 @@ const STYLE_BASELINE_CHAPTERS = 12;
 /** 低于此章数时中位数没有代表性，退回单一样本参照。 */
 const STYLE_BASELINE_MIN_CHAPTERS = 3;
 /**
-* 风格符合度事实块：拿本章指标与**本书已过审章节的中位数**（或绑定写法样本）对照。
+* 解析本书的风格基线 —— **审稿与漂移曲线共用这一份**，保证两条路同源。
 *
-* 取第一个带 sourceText 的写法资产做参照（提取时 routes.ts 会存下样本前 3000 字）。
-* 样本过短（指标无统计意义）时返回空串——宁可不给，也不给噪声。
+* 优先用本书**已过审章节的中位数**：单一样本的噪声会整个混进比对（样本碰巧长什么样，
+* 后面所有章都在跟它比），多章中位数对离群值不敏感。不足 3 章时退回单一样本。
+* @param outputDir - 书目录；缺省时只能用写法样本。
 * @param project - 当前书项目状态。
-* @param bodyText - 本章正文（已剥标题）。
-* @returns 可注入审稿 prompt 的文本；没有可用参照时为空串。
+* @returns 基线；既无已过审章节也无带样本文本的写法资产时返回 undefined。
 */
-function styleFidelityBlock(project, bodyText, outputDir) {
+function styleBaseline(outputDir, project) {
 	if (outputDir !== void 0) {
 		const approved = project.chapters.filter((c) => c.status === "approved" && c.file !== "");
 		if (approved.length >= STYLE_BASELINE_MIN_CHAPTERS) {
@@ -6766,22 +6762,28 @@ function styleFidelityBlock(project, bodyText, outputDir) {
 				const fp = extractStyleFingerprint(stripChapterHeadings(raw));
 				if (fp.sentences > 0) samples.push(fp);
 			}
-			if (samples.length >= STYLE_BASELINE_MIN_CHAPTERS) {
-				const reference = mergeFingerprints(samples);
-				const actual = extractStyleFingerprint(bodyText);
-				return renderFingerprintComparison(reference, actual, compareStyleFingerprint(reference, actual), "本书已过审 " + samples.length + " 章的中位数");
-			}
+			if (samples.length >= STYLE_BASELINE_MIN_CHAPTERS) return {
+				fingerprint: mergeFingerprints(samples),
+				label: "本书已过审 " + samples.length + " 章的中位数"
+			};
 		}
 	}
 	for (const style of project.assets?.styleAssets ?? []) {
 		const sample = style.sourceText;
 		if (sample === void 0 || sample === "") continue;
-		const reference = extractStyleFingerprint(sample);
-		if (reference.sentences === 0) continue;
-		const actual = extractStyleFingerprint(bodyText);
-		return renderFingerprintComparison(reference, actual, compareStyleFingerprint(reference, actual));
+		const fingerprint = extractStyleFingerprint(sample);
+		if (fingerprint.sentences === 0) continue;
+		return {
+			fingerprint,
+			label: "绑定写法资产的样本文本"
+		};
 	}
-	return "";
+}
+function styleFidelityBlock(project, bodyText, outputDir) {
+	const baseline = styleBaseline(outputDir, project);
+	if (baseline === void 0) return "";
+	const actual = extractStyleFingerprint(bodyText);
+	return renderFingerprintComparison(baseline.fingerprint, actual, compareStyleFingerprint(baseline.fingerprint, actual), baseline.label);
 }
 /** Run the AI review on one chapter. */
 async function reviewChapter(ctx, config, project, outputDir, chapterNo) {
@@ -13957,6 +13959,58 @@ function makeRoutes(deps) {
 			writeJson(res, 200, { scan: scanAiFlavor(text.slice(0, 2e4)) });
 		}
 	};
+	/**
+	* 风格漂移曲线：逐章风格指标 + 参照基线。
+	*
+	* 数据**即时算、不落盘**：语料就是章节文件本身，存一份快照只会带来陈旧问题。
+	* 基线与审稿同源（styleBaseline），所以图上看到的就是审稿时判偏离用的那把尺子。
+	*/
+	const styleHistoryRoute = {
+		kind: "exact",
+		path: NOVEL_API.styleHistory,
+		handler: (req, res) => {
+			if (!guard(req, res, "GET")) return;
+			const outputDir = resolveOutputDir(getConfig(), new URL(req.url ?? "/", "http://localhost").searchParams.get("bookId") ?? void 0);
+			const project = loadProject(outputDir);
+			if (project === void 0) {
+				writeJson(res, 200, {
+					baselineLabel: "",
+					baseline: null,
+					points: []
+				});
+				return;
+			}
+			const baseline = styleBaseline(outputDir, project);
+			const points = [];
+			for (const chapter of project.chapters) {
+				if (chapter.file === void 0 || chapter.file === "") continue;
+				const raw = readChapterFile(outputDir, chapter);
+				if (raw === void 0) continue;
+				const fingerprint = extractStyleFingerprint(stripChapterHeadings(raw));
+				const measured = fingerprint.sentences > 0;
+				points.push({
+					no: chapter.no,
+					title: chapter.title,
+					measured,
+					avgSentenceLength: fingerprint.avgSentenceLength,
+					shortSentenceRatio: fingerprint.shortSentenceRatio,
+					dialogueRatio: fingerprint.dialogueRatio,
+					avgParagraphLength: fingerprint.avgParagraphLength,
+					significant: baseline !== void 0 && measured ? compareStyleFingerprint(baseline.fingerprint, fingerprint).filter((d) => d.significant).map((d) => d.metric + (d.direction === "higher" ? "↑" : "↓")) : []
+				});
+			}
+			writeJson(res, 200, {
+				baselineLabel: baseline?.label ?? "",
+				baseline: baseline === void 0 ? null : {
+					avgSentenceLength: baseline.fingerprint.avgSentenceLength,
+					shortSentenceRatio: baseline.fingerprint.shortSentenceRatio,
+					dialogueRatio: baseline.fingerprint.dialogueRatio,
+					avgParagraphLength: baseline.fingerprint.avgParagraphLength
+				},
+				points
+			});
+		}
+	};
 	/** 热门题材雷达：输入平台/题材/榜单文本 → 信号 + 生产底座 + 开书创意。 */
 	const marketRadarRoute = {
 		kind: "exact",
@@ -16400,6 +16454,7 @@ function makeRoutes(deps) {
 		bookshelfImportDirRoute,
 		bookshelfImportTextRoute,
 		bookshelfImportTextPreviewRoute,
+		styleHistoryRoute,
 		resetRoute,
 		auditRoute,
 		charactersRefreshRoute,

package/lib/types/client/api.d.ts

@@ -280,6 +280,8 @@ export declare class NovelApi {
     assistant(message: string, onFrame: (frame: import('../protocol.ts').AssistantFrame) => void): Promise<void>;
     /** 张力曲线：数据 + 规则核对。 */
     tension(): Promise<import('../protocol.ts').TensionResponse>;
+    /** 风格漂移曲线：逐章指标 + 参照基线（与审稿同源）。 */
+    styleHistory(): Promise<import('../protocol.ts').StyleHistoryResponse>;
     /** 设置张力曲线预设。 */
     tensionPreset(preset: import('../protocol.ts').TensionCurvePreset): Promise<void>;
     /** 设置/清除某一章的目标张力。 */

package/lib/types/client/panel/CardHead.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 卡片区块页头：「标题 + 计数 + 一句说明 + 右侧动作」的唯一样式源。
+ *
+ * 为什么需要它：审查发现同一个语义（卡片首行当页头）在面板里被手写了 19 遍，
+ * 内联样式出现 8 种变体（`justifyContent: space-between` / 少 `flexWrap` /
+ * 少 `alignItems` / `gap` 有 6、8、无 三档），导致同一层级的区块标题在垂直节奏上
+ * 肉眼可见地参差不齐。收敛到这一个组件后，标题层级、对齐、换行策略只有一处定义。
+ *
+ * 与 `PageHeader` 的分工：
+ *   - `PageHeader` = 视图级页头（每视图仅一个，大号衬线标题 + eyebrow）
+ *   - `CardHead`   = 区块级页头（视图内多张卡的首行，小号、无 eyebrow）
+ * 两级只此两级，不再有第三种「行内 span 当标题」的写法。
+ */
+import type { ReactNode } from 'react';
+export interface CardHeadProps {
+    /** 区块标题（必填）。用短语而非句子。 */
+    title: ReactNode;
+    /** 计数后缀，例如 `（12）`。已含括号，避免调用方各写各的中英文标点。 */
+    count?: string | number;
+    /** 标题右侧的一句 meta（弱色、12px、可省略）。 */
+    note?: ReactNode;
+    /** 右侧动作区（按钮 / 下拉 / 切换）。 */
+    actions?: ReactNode;
+    /** 大号标题（该卡片是本视图唯一主体时用，避免小标题显得寒酸）。 */
+    large?: boolean;
+    /** 左侧 lucide 图标（16px 单色）。 */
+    icon?: ReactNode;
+}
+export declare function CardHead({ title, count, note, actions, large, icon }: CardHeadProps): JSX.Element;
+/**
+ * 两端对齐行：把 8 种内联变体收成一个类。
+ * 用于「左右两端放东西但左边不是标题」的场景（纯布局，不构成页头层级）。
+ */
+export declare function RowBetween({ wrap, align, gap, children }: {
+    /** 窄容器下是否换行（默认换行：宁可两行也不裁切）。 */
+    wrap?: boolean;
+    /** 垂直对齐方式。 */
+    align?: 'center' | 'baseline' | 'flex-start';
+    /** 间距档（默认 8）。 */
+    gap?: 6 | 8 | 12;
+    children: ReactNode;
+}): JSX.Element;

package/lib/types/client/panel/ConfirmDialog.d.ts

@@ -0,0 +1,36 @@
+export type ConfirmTone = 'danger' | 'warn' | 'info';
+export interface ConfirmSpec {
+    /** 弹窗标题：一句话说清要做什么。 */
+    title: string;
+    /** 后果说明：到底会发生什么、什么会保留。 */
+    body: React.ReactNode;
+    /** 逐条列出的影响面。 */
+    effects?: string[];
+    /** 承诺：如「原稿会先自动备份为 .bak，可再换回来」。 */
+    assurance?: string;
+    confirmLabel?: string;
+    cancelLabel?: string;
+    tone?: ConfirmTone;
+    /** 需要逐字输入的确认词；给出时用户必须输入一致才能确认。 */
+    requirePhrase?: string;
+    /** 真正的动作。抛错时弹窗不关，就地显示错误并可重试。 */
+    onConfirm: () => void | Promise<void>;
+}
+export declare function ConfirmDialog({ spec, onCancel, onDone }: {
+    spec: ConfirmSpec;
+    onCancel: () => void;
+    onDone: () => void;
+}): JSX.Element;
+/**
+ * 用法（替代 window.confirm）：
+ *   const confirm = useConfirm()
+ *   confirm({ title: '…', body: '…', tone: 'danger', onConfirm: async () => { await api.x() } })
+ *   // …并在 JSX 里渲染 {confirm.dialog}
+ *
+ * 动作用回调传入（而不是 resolve(true) 后由调用方自己跑），这样执行失败时
+ * 弹窗能留在原地显示错误并提供重试 —— 不会退化成「关掉弹窗 + 一句红字」。
+ */
+export declare function useConfirm(): {
+    confirm: (spec: ConfirmSpec) => void;
+    dialog: JSX.Element | null;
+};

package/lib/types/client/panel/NoticeBar.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 通知条（notice / error 统一出口）——取代此前 4 个视图各写一处的内联 notice/error。
+ *
+ * 为什么要这个组件（不是又一层抽象）：
+ *   1. 此前 TensionView / StyleView / TimelineView / PromptSlotsView 各写一套，
+ *      且 success 与 error 共用同一个未定义的 var(--nf-text-12) → 字号静默失效，
+ *      两者视觉权重完全一样，「成功」和「失败」在屏幕上长得一样。
+ *   2. 错误态只有一行红字。作者最痛的时刻不是失败，是「失败了不知道还能怎么办」，
+ *      所以这里强制 error 形态带上「发生了什么 + 怎么办」，并把重试摆在同一行。
+ *   3. 颜色走 --nf-*-ink 文字版令牌（见 panel.module.css 注释）：图形版语义色
+ *      （--nf-success #34c759 等）在浅色四档纸面上只有 1.98~3.20:1，不能当文字用。
+ */
+import type { ReactNode } from 'react';
+export type NoticeKind = 'ok' | 'error' | 'warn' | 'info';
+export declare function NoticeBar({ kind, children, onRetry, retryLabel, detail, actions }: {
+    kind: NoticeKind;
+    /** 主文案：一句话说清发生了什么。 */
+    children: ReactNode;
+    /** 次要说明：补充上下文（错误码、影响范围、下一步提示）。 */
+    detail?: ReactNode;
+    /** 重试回调。给了就在同一行显示重试按钮 —— 不给才是真的没救。 */
+    onRetry?: () => void;
+    retryLabel?: string;
+    /** 其他补救动作（如「换个模型再试」）。 */
+    actions?: ReactNode;
+}): JSX.Element;

package/lib/types/client/panel/Sparkline.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 指标条内嵌迷你走势图（sparkline）：把「一堆数字」变成「一条形状」。
+ *
+ * 为什么需要它：总编台四个常驻指标原本全是纯数字。作者看到「全书字数 87,431」
+ * 无法判断形状 —— 33 章是均匀分布的，还是前 5 章写了六成、中间塌了十章？
+ * sparkline 让「节奏」变成一眼可见的形态，而不需要点进任何视图。
+ *
+ * 设计约束（避免图表挤进 12px 高的指标格后反而变噪）：
+ *   - 不画坐标轴、不画网格、不画标签：只有形状；每根柱自带悬停提示给出该章字数，
+ *     峰值等形态解读由 describeShape() 以文字提供。
+ *   - 柱高按 max 归一化，0 字章节画成基线上的 1px 短横（"这一章还没写"）。
+ *   - 已过审 / 未过审用两套填充区分，替代图例文字。
+ *   - 纯装饰性趋势：aria-hidden，真正的数据在相邻的 <b> 数字里，已由读屏播报。
+ */
+export interface SparkPoint {
+    /** 章节号（仅用于 title 提示）。 */
+    no: number;
+    /** 该章字数。 */
+    chars: number;
+    /** 是否已过审 —— 决定用「过审色」还是「待定色」填充。 */
+    approved: boolean;
+}
+export interface SparklineProps {
+    points: SparkPoint[];
+    /** 无数据时的替代文本（例如「尚未开写」）。 */
+    emptyHint?: string;
+}
+/** 迷你柱状走势。宽固定 132、高 26，用 viewBox 缩放以适配窄容器。 */
+export declare function Sparkline({ points, emptyHint }: SparklineProps): JSX.Element;
+/**
+ * 形态解读：把序列讲成一句人话，给 sparkline 当无障碍替代与悬停提示。
+ * 不新增数据，只描述现有分布 —— 目的是让作者知道「该看哪里」而不是给结论。
+ */
+export declare function describeShape(points: SparkPoint[]): string;

package/lib/types/client/panel/StyleView.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 风格漂移曲线：把「每一章离本书自己的风格基线有多远」画出来。
+ *
+ * 图上三条信息：基线（虚线，本书已过审章节的中位数）、逐章实际（折线）、显著偏离的章（红点）。
+ * 指标可切换：句均长 / 短句占比 / 对话占比 / 段落均长。
+ *
+ * 两点刻意的设计：
+ * 1. **基线与审稿同源** —— 用的是同一份 styleBaseline，所以图上看到的就是审稿判偏离用的那把尺子。
+ *    若各画各的，作者会看到两个不一致的结论。
+ * 2. **数值即时算、不落盘** —— 数据源就是章节文件本身，存一份快照只会带来陈旧问题。
+ *
+ * 只画四项长度/比率指标：句长起伏与意象密度是诊断用的，画成曲线反而难读。
+ */
+import type { NovelApi } from '../api.ts';
+export interface StyleViewProps {
+    api: NovelApi;
+}
+export default function StyleView({ api }: StyleViewProps): JSX.Element;

package/lib/types/engine.d.ts

@@ -12,6 +12,7 @@
  */
 export declare const COMPLIANCE_REDLINES: ReadonlyArray<string>;
 import type { Context } from '@deepseek-ai/cordis';
+import { type StyleFingerprint } from './style-fingerprint.ts';
 import { fullTextBudget } from './model-capability.ts';
 import { applyModelCapability } from './model-request.ts';
 import type { AdaptationDimension, AdaptAnalyzeResponse, AdaptationMapping, AdaptationRules, AdaptProposeResponse, AuditIssue, AuthorReview, ExportScope, TimelineEvent, TimelineIssue, BreakdownResponse, ChapterPlan, Foreshadow, NovelConfig, OutlineCandidate, Plotline, PlotlineHealthReport, PlotlinePlan, ProjectState, ReviewReport, RoleRecord, RoleStatusCard, StoryBible, AddModelRequest, AddModelResponse, LlmModelsResponse, LlmVendorsResponse, LlmProvidersResponse, RemoveProviderRequest, RemoveProviderResponse, LlmTestResponse, Volume, WorldState, AdaptMaterializeRequest, AdaptMaterializeResponse, AdaptMaterializeSaveRequest, AdaptMaterializeSaveResponse, MarketRadarRequest, MarketRadarResult, MarketRadarSignal, MarketRadarBriefRequest, ProductionFoundation, MarketCreativeBrief, BookAnalysisRequest, BookAnalysisResult, IdeaInspirationRequest, IdeaInspirationResult, DirectorRequest, DirectorAdvice } from './protocol.ts';
@@ -68,6 +69,31 @@ export declare function planVolumes(ctx: Context, config: NovelConfig, outline:
  * Plan chapters from an outline (optionally for one volume).
  */
 export declare function planChapters(ctx: Context, config: NovelConfig, project: ProjectState, chapterCount: number, volumeNo?: number, outputDir?: string): Promise<ChapterPlan[]>;
+/**
+ * 风格符合度事实块：拿本章指标与**本书已过审章节的中位数**（或绑定写法样本）对照。
+ *
+ * 取第一个带 sourceText 的写法资产做参照（提取时 routes.ts 会存下样本前 3000 字）。
+ * 样本过短（指标无统计意义）时返回空串——宁可不给，也不给噪声。
+ * @param project - 当前书项目状态。
+ * @param bodyText - 本章正文（已剥标题）。
+ * @returns 可注入审稿 prompt 的文本；没有可用参照时为空串。
+ */
+/** 风格基线：参照指纹 + 人话说明。 */
+export interface StyleBaseline {
+    fingerprint: StyleFingerprint;
+    /** 供提示词与 UI 显示的来源说明。 */
+    label: string;
+}
+/**
+ * 解析本书的风格基线 —— **审稿与漂移曲线共用这一份**，保证两条路同源。
+ *
+ * 优先用本书**已过审章节的中位数**：单一样本的噪声会整个混进比对（样本碰巧长什么样，
+ * 后面所有章都在跟它比），多章中位数对离群值不敏感。不足 3 章时退回单一样本。
+ * @param outputDir - 书目录；缺省时只能用写法样本。
+ * @param project - 当前书项目状态。
+ * @returns 基线；既无已过审章节也无带样本文本的写法资产时返回 undefined。
+ */
+export declare function styleBaseline(outputDir: string | undefined, project: ProjectState): StyleBaseline | undefined;
 /** Run the AI review on one chapter. */
 export declare function reviewChapter(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number): Promise<ReviewReport>;
 /**

package/lib/types/protocol.d.ts

@@ -33,6 +33,7 @@ export declare const NOVEL_API: {
     readonly revisionPlan: "/api/dsh-novel-forge/revision/plan";
     /** 张力曲线（GET 数据 / POST 设置）。 */
     readonly tension: "/api/dsh-novel-forge/tension";
+    readonly styleHistory: "/api/dsh-novel-forge/style-history";
     /** 提示词槽位（GET 列表 / POST 写入）。 */
     readonly promptSlots: "/api/dsh-novel-forge/prompt-slots";
     /** 故事时间线（GET 列表 / POST 操作）。 */
@@ -2026,6 +2027,32 @@ export interface PlotBeatTemplate {
     /** 适用题材。 */
     applicableGenres: string[];
 }
+/** 风格漂移曲线上的一个点（一章）。 */
+export interface StyleHistoryPoint {
+    no: number;
+    title: string;
+    /** 该章指纹是否可用（过短的章没有统计意义） */
+    measured: boolean;
+    avgSentenceLength: number;
+    shortSentenceRatio: number;
+    dialogueRatio: number;
+    avgParagraphLength: number;
+    /** 超出容忍度的指标（指标 key + 方向箭头，如 avgSentenceLength↑；中文名由前端映射） */
+    significant: string[];
+}
+/** 风格漂移曲线：逐章指标 + 参照基线。 */
+export interface StyleHistoryResponse {
+    /** 基线说明，如「本书已过审 12 章的中位数」 */
+    baselineLabel: string;
+    /** 基线的四项关键指标（供图上画参考线）；无基线时为 null */
+    baseline: {
+        avgSentenceLength: number;
+        shortSentenceRatio: number;
+        dialogueRatio: number;
+        avgParagraphLength: number;
+    } | null;
+    points: StyleHistoryPoint[];
+}
 /** 写法引擎：从样本文本提取的叙事风格资产。 */
 export interface StyleAsset {
     /** 资产名（如「林越式痞坏」「冷峻猎手风」）。 */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@waterwx/dsh-novel-forge",
   "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": "2.1.3",
+  "version": "2.1.5",
   "type": "module",
   "author": "waterwx",
   "repository": {
@@ -111,6 +111,9 @@
     "watch": "tsdown --watch",
     "typecheck": "tsc --noEmit",
     "check:styles": "node scripts/check-theme-sizes.mjs",
+    "check:vars": "node scripts/check-css-vars.mjs",
+    "check:dead-classes": "node scripts/check-dead-classes.mjs",
+    "check:fallback": "node scripts/check-fallback-tiers.mjs",
     "check:third-party": "node scripts/check-third-party.mjs",
     "check:contrast": "node scripts/audit-contrast.mjs",
     "check:third-party:list": "node scripts/check-third-party.mjs --list",