@waterwx/dsh-novel-forge 2.4.0 → 2.5.1

package/lib/types/protocol.d.ts

@@ -34,8 +34,12 @@ export declare const NOVEL_API: {
     /** 张力曲线（GET 数据 / POST 设置）。 */
     readonly tension: "/api/dsh-novel-forge/tension";
     readonly styleHistory: "/api/dsh-novel-forge/style-history";
+    /** 风格目标卡：GET 当前卡；POST {action:'distill-archived'|'distill-sample'|'clear'}。 */
+    readonly styleProfile: "/api/dsh-novel-forge/style-profile";
     /** 提示词槽位（GET 列表 / POST 写入）。 */
     readonly promptSlots: "/api/dsh-novel-forge/prompt-slots";
+    /** 取名器：POST {action:'generate'} 生成候选；GET 名字库；POST {action:'adopt'|'discard'|'clear'} 维护。 */
+    readonly nameForge: "/api/dsh-novel-forge/name-forge";
     /** 故事时间线（GET 列表 / POST 操作）。 */
     readonly timeline: "/api/dsh-novel-forge/timeline";
     readonly marketRadar: "/api/dsh-novel-forge/market-radar";
@@ -261,7 +265,7 @@ export interface BookImportTextPreviewResponse {
     skipped: string[];
 }
 /** Chapter lifecycle states (the writing pipeline's state machine). */
-export type ChapterStatus = 'pending' | 'generating' | 'written' | 'reviewing' | 'approved' | 'rejected' | 'error';
+export type ChapterStatus = 'pending' | 'generating' | 'written' | 'approved' | 'rejected' | 'error';
 /** One chapter in the plan. */
 export interface ChapterPlan {
     /** 1-based chapter number (stable identity; files are named from it). */
@@ -699,6 +703,57 @@ export interface PromptSlotsRequest {
     /** 空串 = 清空该槽位（恢复默认）。 */
     value: string;
 }
+/** 取名类别。 */
+export type NameCategory = 'person' | 'place' | 'technique' | 'faction' | 'artifact';
+/** 名字库里的一条（采纳后才注入写作提示词）。 */
+export interface NameForgeEntry {
+    /** 稳定 id（`类别:名字`）。 */
+    id: string;
+    category: NameCategory;
+    name: string;
+    /** 命名理由/意象（20 字内为宜）。 */
+    note: string;
+    /** 是否生效（false = 已弃用，不注入）。 */
+    adopted: boolean;
+    createdAt: string;
+}
+/** 一次取名生成的候选（未落盘，作者采纳后才入库）。 */
+export interface NameForgeCandidate {
+    name: string;
+    note: string;
+}
+/** POST /name-forge {action:'generate'} 请求。 */
+export interface NameForgeGenerateRequest {
+    action: 'generate';
+    category: NameCategory;
+    /** 生成条数（1-20，默认 10）。 */
+    count?: number;
+    /** 作者补充要求（可空）。 */
+    hint?: string;
+    bookId?: string;
+}
+/** POST /name-forge 库维护请求。 */
+export interface NameForgeMutateRequest {
+    action: 'adopt' | 'discard' | 'clear';
+    category?: NameCategory;
+    /** adopt 时的候选列表。 */
+    candidates?: NameForgeCandidate[];
+    /** discard 时的条目 id。 */
+    id?: string;
+    bookId?: string;
+}
+/** POST /name-forge {action:'generate'} 响应。 */
+export interface NameForgeGenerateResponse {
+    candidates: NameForgeCandidate[];
+}
+/** GET /name-forge 响应：本书名字库（按类别分组由面板做）。 */
+export interface NameForgeBankResponse {
+    entries: NameForgeEntry[];
+}
+/** POST /name-forge 库维护响应。 */
+export interface NameForgeMutateResponse {
+    entries: NameForgeEntry[];
+}
 /**
  * 故事时间线事件：从章节正文抽取的「故事内时间点 + 地点 + 参与角色 + 事件」。
  * 用途：后续章节的时间连续性与地点衔接（比编年录更强调"顺序"）。
@@ -1190,6 +1245,10 @@ export interface ProjectState {
     tensionCurve?: TensionCurveConfig;
     /** 作者自定义的提示词槽位（白名单见 prompt-slots.ts）。 */
     promptSlots?: Partial<Record<PromptSlotId, string>>;
+    /** 取名器名字库（按类别收录的已采纳专有名字，注入写作提示词）。 */
+    nameBank?: NameForgeEntry[];
+    /** 风格目标卡（显式蒸馏的生成端锚点；审稿尺子不读它，实时算）。 */
+    styleProfile?: StyleProfile;
     /** 本书参数（写作/审稿/推理/模型快切；未设字段回退全局 config）。 */
     bookSettings?: BookSettings;
     /** ISO timestamps. */
@@ -1809,6 +1868,8 @@ export interface ExportResponse {
     file: string;
     chars: number;
     chapters: number;
+    /** 全本导出时因文件缺失/为空被跳过的章号；无跳过项时缺省。 */
+    skipped?: number[];
     scope: ExportScope;
     format: 'txt' | 'md' | 'json';
 }
@@ -1823,6 +1884,8 @@ export interface ConfigPatch {
     auditModel?: string;
     /** 备用模型（主模型失败时自动切换重试一次；空串 = 关闭）。 */
     fallbackModel?: string;
+    /** 备用模型的输出 token 上限（0/空 = 沿用主模型预算）。 */
+    fallbackMaxTokens?: number;
     /** 出章后自动抽取故事时间线（默认开）。 */
     autoTimeline?: boolean;
     reasoningEffort?: 'off' | 'low' | 'high' | 'max';
@@ -2092,6 +2155,55 @@ export interface StyleHistoryPoint {
     significant: string[];
 }
 /** 风格漂移曲线：逐章指标 + 参照基线。 */
+/**
+ * 风格指纹数据（字段与 style-fingerprint.ts 的 StyleFingerprint 结构一致，
+ * 这里复述一份是为了让协议文件不依赖宿主模块——shared vocabulary 自包含）。
+ */
+export interface StyleFingerprintData {
+    chars: number;
+    sentences: number;
+    avgSentenceLength: number;
+    sentenceLengthCv: number;
+    shortSentenceRatio: number;
+    dialogueRatio: number;
+    avgParagraphLength: number;
+    imageryPer1000: number;
+}
+/** 风格目标卡的蒸馏来源。 */
+export type StyleProfileSource = 'archived' | 'sample';
+/**
+ * 风格目标卡：作者**显式蒸馏**的产物（不是派生视图，所以落盘）。
+ *
+ * 与审稿端尺子的分工：审稿用「本书已过审章节中位数」实时算（自适应尺子）；
+ * 生成端的目标由本卡提供（外部锚点）——两把尺子刻意分开，否则生成目标会跟着
+ * 本书漂移一起走，越写越偏而且互相认证（棘轮效应）。本卡只在作者点「蒸馏」时变。
+ */
+export interface StyleProfile {
+    /** 蒸馏来源。 */
+    source: StyleProfileSource;
+    /** 人类可读来源说明，如「本书已过审 12 章的中位数」。 */
+    label: string;
+    fingerprint: StyleFingerprintData;
+    /** archived 来源的采样章数。 */
+    sampleChapters?: number;
+    updatedAt: string;
+}
+/** GET /style-profile 响应。 */
+export interface StyleProfileResponse {
+    /** 当前生效的目标卡；从未蒸馏过为 null（回落资产样本文本）。 */
+    profile: StyleProfile | null;
+    /** 可供蒸馏的已过审章数（<3 时不可用 archived 蒸馏）。 */
+    approvedChapters: number;
+    /** 当前实际生效的目标说明（卡优先，否则回落样本文本或「无」）。 */
+    effectiveLabel: string;
+}
+/** POST /style-profile 请求。 */
+export interface StyleProfileRequest {
+    action: 'distill-archived' | 'distill-sample' | 'clear';
+    /** distill-sample 时的样本文本（≥200 字）。 */
+    text?: string;
+    bookId?: string;
+}
 export interface StyleHistoryResponse {
     /** 基线说明，如「本书已过审 12 章的中位数」 */
     baselineLabel: string;

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

@@ -61,10 +61,11 @@ export declare function compareStyleFingerprint(reference: StyleFingerprint, act
 export declare function mergeFingerprints(items: readonly StyleFingerprint[]): StyleFingerprint;
 /**
  * 渲染**生成端**的风格目标（区间形式）。
- * @param reference - 写法样本的指纹。
+ * @param reference - 参照指纹（写法样本或蒸馏卡）。
+ * @param sourceLabel - 参照物的人类可读说明（缺省「绑定的写法样本」）。
  * @returns 可注入写作 prompt 的文本；样本过短时返回空串。
  */
-export declare function renderFingerprintTargets(reference: StyleFingerprint): string;
+export declare function renderFingerprintTargets(reference: StyleFingerprint, sourceLabel?: string): string;
 /**
  * 渲染**审稿端**的风格比对（事实锚点）。
  *

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

@@ -0,0 +1,62 @@
+/**
+ * 风格目标卡：把「这本书的写法」蒸馏成一份**作者显式确认**的确定性指标卡，
+ * 作为生成端的风格锚点。
+ *
+ * ## 为什么生成端要一张卡，而审稿端实时算
+ *
+ * 审稿端的尺子是「本书已过审章节的中位数」（styleBaseline，engine.ts）——自适应：
+ * 书写到哪，尺子量到哪。生成端如果也用同一把尺子，会出现**棘轮效应**：某一章
+ * 对话占比偏高 → 进了中位数 → 下一章的目标跟着抬高 → 越写越偏且「生成符合目标、
+ * 审稿也符合尺子」互相认证，没有任何一方报警。
+ *
+ * 所以两边刻意分开：
+ *   * 审稿 = 自适应尺子（实时算，不落盘）；
+ *   * 生成 = 外部锚点（本卡；只在作者点「蒸馏」时更新，是**决定**不是派生）。
+ *
+ * ## 卡的来源
+ *
+ * 1. `archived` —— 本书已过审章节等距抽样（≤12 章）的中位数：把「我现在实际
+ *    写出来的样子」固化成目标，适合写了一定时量后收紧；
+ * 2. `sample` —— 作者粘贴的参考样文本：开书阶段就想定调；
+ * 3. 无卡 —— 回落绑定写法资产的样本文本（旧行为，保持兼容）。
+ */
+import type { StyleProfile, StyleProfileSource, StyleFingerprintData } from './protocol.ts';
+/** 生成端实际生效的风格目标（判别联合：卡直给指纹，样本由调用方现算）。 */
+export type EffectiveStyleTarget = {
+    kind: 'profile';
+    fingerprint: StyleFingerprintData;
+    label: string;
+} | {
+    kind: 'sample';
+    sampleText: string;
+    label: string;
+} | {
+    kind: 'none';
+};
+/**
+ * 解析生成端生效的风格目标。
+ *
+ * 优先级：显式卡 > 绑定资产的样本文本 > 无。样本文本取「第一个有 sourceText
+ * 的资产」，指纹由调用方现算——本模块不依赖 style-fingerprint，保持纯数据。
+ *
+ * @param project 项目状态（只需 styleProfile 与 assets.styleAssets[].sourceText）。
+ * @returns 生效目标。
+ */
+export declare function resolveStyleTarget(project: {
+    styleProfile?: StyleProfile;
+    assets?: {
+        styleAssets?: Array<{
+            sourceText?: string;
+        }>;
+    };
+}): EffectiveStyleTarget;
+/** 用指纹数据构造一张目标卡。 */
+export declare function makeStyleProfile(source: StyleProfileSource, label: string, fingerprint: StyleFingerprintData, sampleChapters?: number): StyleProfile;
+/** 目标卡的中文来源名（面板用）。 */
+export declare function styleProfileSourceLabel(source: StyleProfileSource): string;
+/**
+ * 校验一次 distilled-sample 请求的样本文本。
+ * @returns 归一化后的文本。
+ * @throws 文本过短时抛错（路由转 400）。
+ */
+export declare function normalizeSampleText(text: string | undefined): string;

package/package.json

@@ -1,12 +1,12 @@
 {
   "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.4.0",
+  "version": "2.5.1",
   "type": "module",
   "author": "waterwx",
   "repository": {
     "type": "git",
-    "url": "https://github.com/watersxya/dsh-novel-forge.git"
+    "url": "git+https://github.com/watersxya/dsh-novel-forge.git"
   },
   "homepage": "https://github.com/watersxya/dsh-novel-forge",
   "bugs": {