@waterwx/dsh-novel-forge 2.1.3 → 2.1.4

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/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.4",
   "type": "module",
   "author": "waterwx",
   "repository": {