@waterwx/dsh-novel-forge 2.4.0 → 2.5.1

package/lib/types/assets.d.ts

@@ -2,13 +2,13 @@
  * Writing assets — 题材基底库 / 推进模式库 / 反 AI 规则 / 写法引擎.
  *
  * 内置种子数据（本项目自研表述；结构参考了同类工具的功能划分）：
- * - 8 套预置叙事风格模板
- * - 12 条带命中模式的反 AI 规则
+ * - 预置叙事风格模板（数量以 {@link BUILTIN_STYLE_TEMPLATES} 数组为准）
+ * - 带命中模式的反 AI 规则（数量以 ANTI_AI_RULES 数组为准）
  * - 题材树 + 推进模式种子
  * Assets persist with the project (novel-project.json) and are injected into
  * generation / planning / review prompts, and available to the AI assistant.
  */
-import type { AntiAiRule, GenreNode, PlotBeatTemplate, ProgressionMode, ProjectAssets, StarterStyleProfile, StyleAsset, StyleTemplate } from './protocol.ts';
+import type { AntiAiRule, GenreNode, PlotBeatTemplate, ProgressionMode, ProjectAssets, StarterStyleProfile, StyleAsset, StyleProfile, StyleTemplate } from './protocol.ts';
 /** 预置叙事风格模板（8 套，一键绑定无需样本文本）。 */
 export declare const BUILTIN_STYLE_TEMPLATES: StyleTemplate[];
 /** 内置全局反 AI 规则（12 条，随插件发布；项目可叠加自定义规则）。 */
@@ -31,9 +31,9 @@ export declare function renderAntiAiRules(assets: ProjectAssets | undefined): st
 /** 渲染题材与推进模式提示词块。 */
 export declare function renderGenreAndProgression(assets: ProjectAssets | undefined): string;
 /** 渲染写法资产提示词块（规则去重，省 token）。 */
-export declare function renderStyleAssets(assets: ProjectAssets | undefined): string;
+export declare function renderStyleAssets(assets: ProjectAssets | undefined, profile?: StyleProfile): string;
 /** 渲染全部写作资产提示词（供生成/规划/审稿注入）。 */
-export declare function renderAllAssets(assets: ProjectAssets | undefined): string;
+export declare function renderAllAssets(assets: ProjectAssets | undefined, profile?: StyleProfile): string;
 /** 预置写法模板 → 可直接绑定的 StyleAsset。 */
 export declare function styleTemplateToAsset(template: StyleTemplate): StyleAsset;
 /** 起始风格画像库：无样本文本也能快速绑定一套写法（4 档起步写法）。 */

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/locales.d.ts

@@ -34,7 +34,6 @@ export declare const zh: {
     readonly 'plan.pending': "待生成";
     readonly 'plan.generating': "生成中";
     readonly 'plan.written': "待审稿";
-    readonly 'plan.reviewing': "审稿中";
     readonly 'plan.approved': "已通过";
     readonly 'plan.rejected': "待修订";
     readonly 'plan.error': "失败";

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

@@ -0,0 +1,69 @@
+import type { ReactElement } from 'react';
+import type { NovelApi } from '../api.ts';
+import type { ChapterPlan, ChapterSnapshot, Plotline, ReviewReport } from '../../protocol.ts';
+/** 审稿维度中文名（工作台与主面板共用）。 */
+export declare const REVIEW_DIM_ZH: Record<string, string>;
+export declare function statusBadge(chapter: ChapterPlan): {
+    cls: string;
+    label: string;
+};
+/** One review issue line (severity-colored, theme-aware). */
+export declare function severityColor(severity: string): string;
+/** 把章节 beats 按结构标签渲染的实现见 ChapterPlanPanel.renderBeats（左栏与计划抽屉共用）。 */
+/** The diff list of a draft-vs-original comparison (scrollable). */
+export declare function DiffList({ original, draft, fontSize }: {
+    original: string;
+    draft: string;
+    fontSize?: number;
+}): ReactElement;
+/** 章节工作台右侧页签：对比（草稿 diff）/ 审稿（AI 审稿报告）/ 复盘（作者复盘）。 */
+export type ChapterSideTab = 'diff' | 'review' | 'author' | 'versions';
+/** 章节工作台（独立全页）需要的全部输入；所有数据来自真实 project.chapters。 */
+interface ChapterWorkbenchProps {
+    chapter: ChapterPlan;
+    bookKey: string;
+    /** 已加载的正文 markdown；'' 表示未加载 / 尚未生成。 */
+    text: string;
+    /** 润色 / 修订草稿；存在时「对比」页可做逐段 diff。 */
+    draft?: string;
+    fontSize: number;
+    busy: boolean;
+    busyAny: boolean;
+    onBack: () => void;
+    onWrite: () => void;
+    onReview: () => void;
+    onApprove: () => void;
+    onEdit: () => void;
+    /** 按作者勾选的审稿意见修订（不传则内部自动挑 high）。 */
+    onRevisePicked: (issues: ReviewReport['issues']) => void;
+    onReset: () => void;
+    onRegenerate: () => void;
+    onBackfillAuthor: () => void;
+    /** 右栏当前页签（受控：修订完成后由外层自动切到「对比」）。 */
+    tab: ChapterSideTab;
+    onTabChange: (tab: ChapterSideTab) => void;
+    /** 草稿审查报告（验证模式产物，针对草稿本身）；null = 还没审查过。 */
+    draftReport: ReviewReport | null;
+    onApplyDraft: () => void;
+    onDiscardDraft: () => void;
+    onCheckDraft: () => void;
+    /** 本章历史版本（快照）与回滚/存档动作。 */
+    snapshots: ChapterSnapshot[];
+    onRestoreSnapshot: (id: string) => void;
+    onCreateSnapshot: () => void;
+    /** 左栏「本章计划」：剧情线用于关联项，api + onPlanSaved 提供就地补写通道。 */
+    plotlines: Plotline[];
+    api: NovelApi;
+    onPlanSaved: (chapter: ChapterPlan) => void;
+    /** 截断声明汇入外层进度台。 */
+    onNotice: (message: string) => void;
+    onLinkLines: () => void;
+    /** 失败态的出路之一：打开「AI 进度」浮窗看这一章的运行详情（Prompt / 耗时 / 原始错误）。 */
+    onOpenRunLog: () => void;
+}
+/**
+ * 章节工作台：**独立全页**（不塞进抽屉或主从布局，内容太重）。
+ * 三栏并发 —— 左：本章计划（六项固定分组，见 ChapterPlanPanel）；中：正文；右：对比 / 审稿 / 复盘 / 历史。
+ */
+export declare function ChapterWorkbench({ chapter, bookKey, text, draft, fontSize, busy, busyAny, onBack, onWrite, onReview, onApprove, onEdit, onRevisePicked, onReset, onRegenerate, onBackfillAuthor, tab, onTabChange, draftReport, onApplyDraft, onDiscardDraft, onCheckDraft, snapshots, onRestoreSnapshot, onCreateSnapshot, plotlines, api, onPlanSaved, onNotice, onLinkLines, onOpenRunLog, }: ChapterWorkbenchProps): ReactElement;
+export {};

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/NovelPanel.d.ts

@@ -14,5 +14,4 @@ export interface NovelPanelProps {
     /** The API client every tab operates through. */
     api: NovelApi;
 }
-/** The novel-forge panel. */
 export declare function NovelPanel({ controller, api }: NovelPanelProps): import("react").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/client/panel/WorkspaceView.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 润色 / 修订工作区（全页受控组件）。
+ *
+ * 从 NovelPanel.tsx 抽出（2026-10 重构第二步）：它是一整页编辑器，原先直接嵌在
+ * 5600 行主组件的 return 里，任何一处改动都要翻过上百行 JSX。这里只做**受控渲染**：
+ * 状态与请求逻辑仍留在面板（它要驱动全局 busy / 进度台 / 刷新），视图只负责把
+ * props 接上——纯搬家，不搬行为。
+ */
+import type { Dispatch, MutableRefObject, SetStateAction } from 'react';
+import type { ReactElement } from 'react';
+import type { ReviewReport } from '../../protocol.ts';
+/** 工作区状态（面板持有）。 */
+export interface WorkspaceState {
+    no: number;
+    title: string;
+    original: string;
+    instruction: string;
+    draft: string | null;
+    /** 打开工作区时的正文基线（用于判断"有未保存修改"）。 */
+    baseline: string;
+    /** 已采纳草稿（原地结论态）：显示已采纳横幅 + 自动审稿结果，返回时才关闭工作区。 */
+    applied?: boolean;
+}
+/** 工作区视图的全部输入；状态与副作用都由面板提供。 */
+export interface WorkspaceViewProps {
+    workspace: WorkspaceState;
+    onWorkspaceChange: (next: WorkspaceState) => void;
+    onClose: () => void;
+    onGotoChapter: (no: number) => void;
+    backTo: string;
+    editorFontSize: number;
+    onEditorFontSizeChange: (n: number) => void;
+    editorRef: MutableRefObject<HTMLTextAreaElement | null>;
+    selected: string;
+    onCaptureSelection: () => void;
+    checkReport: ReviewReport | null;
+    checked: number[];
+    onCheckedChange: Dispatch<SetStateAction<number[]>>;
+    showDiff: boolean;
+    onShowDiffChange: (next: boolean) => void;
+    resultMode: boolean;
+    busy: boolean;
+    onReviseByReport: () => void;
+    onRewrite: (whole: boolean) => void;
+    onPolish: () => void;
+    onSave: () => void;
+    onCheck: () => void;
+    onDiscardDraft: (no: number) => void;
+}
+/** 工作区全页：左栏原文（可选中局部目标）+ 右栏指令 / 预览 / 应用。 */
+export declare function WorkspaceView({ workspace, onWorkspaceChange, onClose, onGotoChapter, backTo, editorFontSize, onEditorFontSizeChange, editorRef, selected, onCaptureSelection, checkReport, checked, onCheckedChange, showDiff, onShowDiffChange, resultMode, busy, onReviseByReport, onRewrite, onPolish, onSave, onCheck, onDiscardDraft, }: WorkspaceViewProps): ReactElement;

package/lib/types/client/panel/home-model.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 总编台（首页）的纯计算层。
+ *
+ * 从 NovelPanel.tsx 抽出（2026-10 重构）：这些数字原先散在 6000+ 行组件的
+ * useMemo 里，既没法单测，也让「同一件事在面板里说两遍」难以发现。抽成纯函数后：
+ *   - 输入只有 project / chapters，输出是确定的结构；
+ *   - 面板只负责渲染，数字口径集中在这里改；
+ *   - `tests/home-model.test.ts` 直接覆盖边界（空书、全过审、生成中）。
+ */
+import type { ChapterPlan, ProjectState } from '../../protocol.ts';
+/** 总编台用的章节统计（一次遍历算完，避免面板里重复过滤）。 */
+export interface ChapterStats {
+    /** 有正文的章数（approved / written / rejected）。 */
+    done: number;
+    /** 待处理章数（pending / error）。 */
+    pending: number;
+    /** 已过审章数。 */
+    approved: number;
+    /** 待审章数（written / rejected）。 */
+    reviewPending: number;
+    /** 全书已写字数（汉字口径，来自 chapter.chars）。 */
+    totalChars: number;
+    /** 正在生成的章（同刻至多一章；undefined = 没有）。 */
+    writingNow: ChapterPlan | undefined;
+    /** 逐章字数序列（Sparkline 用；顺序 = 章节数组顺序）。 */
+    charSeries: Array<{
+        no: number;
+        chars: number;
+        approved: boolean;
+    }>;
+}
+/**
+ * 单次遍历统计全书章节。
+ * @param chapters 全书章节计划（顺序无关，按数组顺序输出 charSeries）。
+ */
+export declare function computeChapterStats(chapters: ChapterPlan[]): ChapterStats;
+/** 创作旅程的一个阶段。 */
+export interface JourneyStage {
+    id: string;
+    label: string;
+    done: boolean;
+}
+/**
+ * 创作旅程 6 阶段（大纲 → 设定 → 卷计划 → 章节计划 → 正文 → 审稿）。
+ *
+ * 「完成」的判定只看项目真实数据，不参考 UI 当前所在页；否则作者在
+ * 「总纲」页多停留一会儿，旅程条就会自己变。
+ *
+ * @param project 当前书（undefined = 没有书）。
+ * @param chapters 章节计划。
+ * @param approvedCount 已过审章数（来自 {@link computeChapterStats}）。
+ */
+export declare function computeJourneyStages(project: ProjectState | undefined, chapters: ChapterPlan[], approvedCount: number): JourneyStage[];

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[];
@@ -470,11 +502,18 @@ export declare function extractTimelineForChapter(ctx: Context, config: NovelCon
  * @returns 模型给出的问题清单（与规则初筛结果合并由调用方决定）。
  */
 export declare function reviewTimeline(ctx: Context, config: NovelConfig, project: ProjectState): Promise<TimelineIssue[]>;
-/** Export the whole book as one txt/md file. */
+/**
+ * Export the whole book as one txt/md file.
+ *
+ * 只收真实存在且非空的章节文件：`chapter.file` 有值不等于文件没被手删/清空，
+ * 旧实现会把它们当空串拼进去，导出件看起来完整、实际缺章。跳过的章号随
+ * `skipped` 一起返回，由面板如实提示。
+ */
 export declare function exportBook(outputDir: string, project: ProjectState, format: 'txt' | 'md'): {
     file: string;
     chars: number;
     chapters: number;
+    skipped?: number[];
 };
 /**
  * 按范围导出：整本正文 / 设定 / 规划 / 角色 / 质检记录 / 项目 JSON。
@@ -489,4 +528,5 @@ export declare function exportScope(outputDir: string, project: ProjectState, sc
     file: string;
     chars: number;
     chapters: number;
+    skipped?: number[];
 };

package/lib/types/index.d.ts

@@ -8,7 +8,7 @@
  */
 import type { Context } from '@deepseek-ai/cordis';
 import z from 'schemastery';
-import type { NovelConfig } from './protocol.ts';
+import type { NovelConfig, SavedModel } from './protocol.ts';
 /** Stable cordis plugin name. */
 export declare const name = "novel-forge";
 /** Services required before the novel-forge surfaces can mount. */
@@ -47,6 +47,8 @@ export interface Config {
     auditModel?: string;
     /** 备用模型：主模型失败时自动切换重试一次（留空 = 不切换）。 */
     fallbackModel?: string;
+    /** 备用模型的输出 token 上限（仅在设了 fallbackModel 时有意义；0/空 = 沿用主模型预算）。 */
+    fallbackMaxTokens?: number;
     /** 出章后自动抽取故事时间线（默认开）。 */
     autoTimeline?: boolean;
     /** LLM reasoning effort (off/low/high/max). */
@@ -73,6 +75,8 @@ export interface Config {
     themeOpacity?: number;
     /** 是否启用改编模式（默认关闭）。 */
     enableAdaptMode?: boolean;
+    /** 手动添加的模型库（「我的模型」条目；只存插件内）。 */
+    savedModels?: SavedModel[];
 }
 /**
  * Plugin config schema.

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[];