@waterwx/dsh-novel-forge 2.3.0 → 2.5.0

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

@@ -292,8 +292,26 @@ export declare class NovelApi {
     promptSlots(): Promise<import('../protocol.ts').PromptSlotsResponse>;
     /** 写入一个提示词槽位（空串 = 清空）。 */
     promptSlotSet(id: import('../protocol.ts').PromptSlotId, value: string): Promise<void>;
+    /** 取名器：本书名字库。 */
+    nameForgeBank(): Promise<import('../protocol.ts').NameForgeBankResponse>;
+    /** 取名器：生成一批候选（不落盘）。 */
+    nameForgeGenerate(category: import('../protocol.ts').NameCategory, count: number, hint: string): Promise<import('../protocol.ts').NameForgeGenerateResponse>;
+    /** 取名器：采纳候选入名字库。 */
+    nameForgeAdopt(category: import('../protocol.ts').NameCategory, candidates: import('../protocol.ts').NameForgeCandidate[]): Promise<import('../protocol.ts').NameForgeMutateResponse>;
+    /** 取名器：从名字库移除一条。 */
+    nameForgeDiscard(id: string): Promise<import('../protocol.ts').NameForgeMutateResponse>;
     /** 故事时间线：列表（含规则初筛问题）。 */
     timeline(): Promise<import('../protocol.ts').TimelineResponse>;
+    /** 风格目标卡：当前卡 + 生效说明 + 可蒸馏章数。 */
+    styleProfile(): Promise<import('../protocol.ts').StyleProfileResponse>;
+    /** 蒸馏风格目标卡（archived = 本书已过审章节中位数；sample = 参考样文本）。 */
+    styleProfileDistill(action: 'distill-archived' | 'distill-sample', text?: string): Promise<{
+        profile: import('../protocol.ts').StyleProfile | null;
+    }>;
+    /** 清除风格目标卡（回落绑定资产的样本文本）。 */
+    styleProfileClear(): Promise<{
+        profile: null;
+    }>;
     /** 抽取某一章的时间线事件。 */
     timelineExtract(chapterNo: number): Promise<{
         events: import('../protocol.ts').TimelineEvent[];

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

@@ -0,0 +1,11 @@
+/**
+ * 取名器：按类别批量生成专有名字，逐条采纳入本书名字库。
+ *
+ * 边界写在界面上：候选不落盘，采纳后才注入写作提示词（本书层「已定名资产」块）；
+ * 库有容量上限（每类 60 / 全书 200），满了会明确报错而不是静默丢弃。
+ */
+import type { NovelApi } from '../api.ts';
+export interface NameForgeViewProps {
+    api: NovelApi;
+}
+export default function NameForgeView({ api }: NameForgeViewProps): JSX.Element;

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

@@ -9,6 +9,10 @@
  *    若各画各的，作者会看到两个不一致的结论。
  * 2. **数值即时算、不落盘** —— 数据源就是章节文件本身，存一份快照只会带来陈旧问题。
  *
+ * 页面分两截，各管一把尺子：
+ * - **风格目标卡**（上）：生成端的锚点，作者显式蒸馏后落盘；审稿不读它；
+ * - **漂移曲线**（下）：审稿端的自适应尺子，实时算。两者刻意分开，见 style-profile.ts 文件头。
+ *
  * 只画四项长度/比率指标：句长起伏与意象密度是诊断用的，画成曲线反而难读。
  */
 import type { NovelApi } from '../api.ts';

package/lib/types/engine.d.ts

@@ -12,7 +12,7 @@ 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';
+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, NameCategory, NameForgeCandidate, StyleProfile, DirectorRequest, DirectorAdvice } from './protocol.ts';
 /** Project state file name inside the output dir. */
 export declare const PROJECT_FILE = "novel-project.json";
 /** Chapter output file name, e.g. 第001章_开篇.md */
@@ -112,6 +112,27 @@ export interface StyleBaseline {
  * @returns 基线；既无已过审章节也无带样本文本的写法资产时返回 undefined。
  */
 export declare function styleBaseline(outputDir: string | undefined, project: ProjectState): StyleBaseline | undefined;
+/**
+ * 从本书**已过审章节**等距抽样算风格指纹（中位数）。
+ *
+ * 审稿尺子（styleBaseline）与蒸馏卡（distillStyleProfile）共用这一份采样——
+ * 两条路必须同源，否则「审稿说没偏离、生成目标却是另一个方向」。
+ * @returns 抽样指纹与参与章数；不足 {@link STYLE_BASELINE_MIN_CHAPTERS} 章时返回 undefined。
+ */
+export declare function sampleArchivedFingerprint(outputDir: string | undefined, project: ProjectState): {
+    fingerprint: StyleFingerprint;
+    count: number;
+} | undefined;
+/**
+ * 蒸馏一张风格目标卡（作者显式动作，落 project.styleProfile）。
+ *
+ * archived：本书已过审章节的中位数（把「我现在实际写出来的样子」固化成目标）；
+ * sample：作者粘贴的参考样文本（开书定调）。
+ *
+ * 与审稿尺子刻意分工：见 style-profile.ts 文件头「棘轮效应」说明。
+ * @throws 数据不足时抛错（路由转 400）。
+ */
+export declare function distillStyleProfile(outputDir: string | undefined, project: ProjectState, source: 'archived' | 'sample', sampleText?: string): StyleProfile;
 /** Run the AI review on one chapter. */
 export declare function reviewChapter(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number): Promise<ReviewReport>;
 /**
@@ -437,6 +458,17 @@ export declare function runMarketCreativeBrief(ctx: Context, config: NovelConfig
 export declare function runBookAnalysis(ctx: Context, config: NovelConfig, req: BookAnalysisRequest): Promise<BookAnalysisResult>;
 /** 创意灵感：一句话/题材 → 多方向开书灵感。 */
 export declare function runIdeaInspiration(ctx: Context, config: NovelConfig, req: IdeaInspirationRequest): Promise<IdeaInspirationResult>;
+/**
+ * 取名器：按类别批量生成专有名字（题材感知 + 世界观避重 + 库内避重）。
+ *
+ * 候选**不落盘**——作者在面板逐条采纳后才进名字库（走 nameForgeRoute 的
+ * adopt 动作）。生成失败（含模型输出无法解析）抛错，由路由转 500。
+ */
+export declare function runNameForge(ctx: Context, config: NovelConfig, project: ProjectState, req: {
+    category: NameCategory;
+    count?: number;
+    hint?: string;
+}): Promise<NameForgeCandidate[]>;
 /** 雷达→灵感：基于市场信号/生产底座/创意简报，生成贴合市场的开书灵感。 */
 export declare function runMarketIdeaInspiration(ctx: Context, config: NovelConfig, req: {
     signals?: MarketRadarSignal[];

package/lib/types/name-forge.d.ts

@@ -0,0 +1,110 @@
+/**
+ * 取名器：按类别批量生成中文网文专有名字，入每书「名字库」，采纳后注入写作提示词。
+ *
+ * 设计边界（与提示词槽位同一家风）：
+ *   * 取名是**辅助资产**：候选由模型生成，作者逐条采纳才进库；未采纳的候选
+ *     不落盘、不注入——作者保有最终决定权；
+ *   * 库有容量上限（每类 60 / 全书 200 条），超限拒绝写入并要求先清理，防止
+ *     「生成很爽、库变垃圾场」；
+ *   * 注入写作提示词的名字块只列**已采纳**名字，且声明「新角色/地点优先
+ *     使用下表；表外创新名须与下表气质一致」——不锁死创作，只防跑偏。
+ */
+import type { NameCategory, NameForgeCandidate, NameForgeEntry, ProjectState } from './protocol.ts';
+/** 一个取名类别。 */
+export interface NameCategorySpec {
+    id: NameCategory;
+    /** 面板显示名。 */
+    label: string;
+    /** 面板上的一句话说明。 */
+    hint: string;
+    /** 送模型的类别定义（Prompt 内使用）。 */
+    brief: string;
+    /** 示例（占位符）。 */
+    placeholder: string;
+    /** 单次生成上限。 */
+    maxCount: number;
+}
+/** 取名类别表（顺序即面板顺序）。 */
+export declare const NAME_CATEGORIES: readonly NameCategorySpec[];
+/** 取一个类别规格；未知 id 抛错（路由层转 400）。 */
+export declare function categorySpec(id: string): NameCategorySpec;
+/**
+ * 名字库容量纪律：单类 ≤ 60、全书 ≤ 200。
+ *
+ * 全书上限必须**小于**「类数 × 单类上限」（5×60=300）否则永远先被单类规则
+ * 挡住、成为死代码——200 逼作者在囤积前清理，也足够一部 600 章的书用。
+ */
+export declare const NAME_BANK_MAX_PER_CATEGORY = 60;
+export declare const NAME_BANK_MAX_TOTAL = 200;
+/** 归一化一条候选/入库条目（裁剪 + 截断；去重由调用方处理）。 */
+export declare function normalizeNameEntry(raw: {
+    name?: unknown;
+    note?: unknown;
+}): {
+    name: string;
+    note: string;
+};
+/**
+ * 解析取名 LLM 输出为候选列表。
+ *
+ * 宽容度分级：标准 JSON → 去围栏 → 截取首尾花括号；仍失败返回空数组（由
+ * 调用方决定重试或报错），绝不把模型废话当名字。
+ *
+ * @param text 模型原始输出。
+ * @param category 目标类别（用于校验字段完整性）。
+ * @param count 期望条数（上限）。
+ * @returns 候选列表（已去重、去空、截断）。
+ */
+export declare function parseNameCandidates(text: string, count: number): NameForgeCandidate[];
+/**
+ * 构造取名请求的 user 提示词。
+ *
+ * 书籍语境三件套：题材基调、世界设定（境界/区域/势力既有名）、已入库名字
+ * （避重）——三者都可缺省，缺省时明确告诉模型「无既有设定，自由发挥」。
+ *
+ * @param category 类别规格。
+ * @param count 期望条数。
+ * @param hint 作者补充要求（可空）。
+ * @param context 书籍语境。
+ */
+export declare function buildNameForgeUserPrompt(category: NameCategorySpec, count: number, hint: string, context: {
+    genre?: string;
+    worldNames?: string[];
+    bankNames?: string[];
+}): string;
+/** 从项目状态收集取名语境（题材 + 世界既有名 + 已入库名字）。 */
+export declare function collectNameForgeContext(project: ProjectState): {
+    genre: string;
+    worldNames: string[];
+    bankNames: string[];
+};
+/** 读取并规整名字库（按类别分组返回前先做一致性校验；非法条目丢弃）。 */
+export declare function readNameBank(project: ProjectState): NameForgeEntry[];
+/**
+ * 写入名字库（采纳候选 / 弃用单条 / 清空）。
+ *
+ * 容量纪律：单类 ≤ 60、总数 ≤ 200；超限抛错由路由转 400，**不做静默截断**——
+ * 让作者明确知道库满了，而不是疑惑「我刚取的名字去哪了」。
+ */
+export declare function mutateNameBank(project: ProjectState, op: {
+    kind: 'adopt';
+    category: NameCategory;
+    candidates: Array<{
+        name: string;
+        note?: string;
+    }>;
+} | {
+    kind: 'discard';
+    id: string;
+} | {
+    kind: 'clear';
+}): NameForgeEntry[];
+/**
+ * 把已采纳名字渲染成写作提示词块（本书层注入）。
+ *
+ * 声明边界：优先使用、不锁死——「表外创新名须与下表气质一致」。
+ *
+ * @param project 项目状态。
+ * @returns 提示词片段；无库时返回空串。
+ */
+export declare function renderNameBank(project: ProjectState): string;

package/lib/types/prompts/nameforge.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 取名域：按类别批量生成中文网文专有名字（人名 / 地名 / 功法 / 势力 / 宝物）。
+ *
+ * 本文件同时是提示词注册表的域模块之一（见 catalog.ts）。
+ *
+ * 设计边界：
+ *   * 取名是**辅助资产**，产出进「名字库」供作者采纳；采纳后的名字才注入
+ *     写作提示词（书名库渲染在 prompts/writing.ts 的本书层）；
+ *   * 提示词只描述「怎么取名」，不写死任何名字——所有候选来自模型按本书
+ *     语境（题材 / 世界设定 / 已有名字避重）的实时生成。
+ */
+import type { PromptEntry } from './catalog.ts';
+/** 取名系统提示词：类别感知 + 避重 + 结构化 JSON 输出。 */
+export declare function nameForgeSystemPrompt(): string;
+/** 本域提示词登记（注册表消费）。 */
+export declare const entries: PromptEntry[];

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";
@@ -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. */
@@ -2092,6 +2151,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,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.3.0",
+  "version": "2.5.0",
   "type": "module",
   "author": "waterwx",
   "repository": {
@@ -103,7 +103,7 @@
     "cordis.patch.yml",
     "README.md"
   ],
-  "license": "Apache-2.0",
+  "license": "AGPL-3.0-only",
   "scripts": {
     "postinstall": "node scripts/patch-schemastery.mjs",
     "build": "node scripts/clean-types.mjs && tsc -p tsconfig.build.json && tsdown",