@waterwx/dsh-novel-forge 0.1.0 → 1.1.0

package/lib/types/assets.d.ts

@@ -21,11 +21,11 @@ export declare const BUILTIN_PROGRESSION_MODES: ProgressionMode[];
 export declare function emptyProjectAssets(): ProjectAssets;
 /** 合并项目资产与内置库：返回「生效的反 AI 规则」（内置全局 + 项目自定义）。 */
 export declare function effectiveAntiAiRules(assets: ProjectAssets | undefined): AntiAiRule[];
-/** 把生效规则渲染成提示词块。 */
+/** 把生效规则渲染成提示词块（压缩：avoid/fix 截断，省 token）。 */
 export declare function renderAntiAiRules(assets: ProjectAssets | undefined): string;
 /** 渲染题材与推进模式提示词块。 */
 export declare function renderGenreAndProgression(assets: ProjectAssets | undefined): string;
-/** 渲染写法资产提示词块。 */
+/** 渲染写法资产提示词块（规则去重，省 token）。 */
 export declare function renderStyleAssets(assets: ProjectAssets | undefined): string;
 /** 渲染全部写作资产提示词（供生成/规划/审稿注入）。 */
 export declare function renderAllAssets(assets: ProjectAssets | undefined): string;

package/lib/types/assistant.d.ts

@@ -19,6 +19,8 @@ import { chapterFileName } from './engine.ts';
 export declare const ASSISTANT_HISTORY_FILE = "novel-assistant.jsonl";
 /** Load the persisted conversation (empty when none). */
 export declare function loadAssistantHistory(outputDir: string): AssistantMessage[];
+/** 清空助手对话记录（删除历史文件）。 */
+export declare function clearAssistantHistory(outputDir: string): void;
 /** Execute one action directive. Returns a text result (or throws). */
 /**
  * Execute one action directive as an async generator: yields live progress

package/lib/types/bookshelf.d.ts

@@ -17,6 +17,8 @@ export declare function activeBook(store: BookshelfStore): BookEntry | undefined
 export declare function bookshelfSnapshot(store: BookshelfStore): BookshelfSnapshot;
 /** 新建一本书（自动成为当前书）。 */
 export declare function createBook(bookName: string, outputDir: string): BookEntry;
+/** 更新某本书的书名（开书向导导入大纲后书名以大纲首行为准）。 */
+export declare function renameBook(id: string, bookName: string): boolean;
 /**
  * 播种：书架为空时，把指定输出目录下已有的项目自动登记为第一本书。
  * 兼容升级场景 —— 旧版插件直接在输出目录写项目，从未登记书架。

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

@@ -28,14 +28,59 @@ export declare class NovelApi {
     foreshadow(req: ForeshadowRequest): Promise<ForeshadowResponse>;
     exportBook(format: 'txt' | 'md'): Promise<ExportResponse>;
     chapter(no: number): Promise<ChapterResponse>;
+    /** 审查手动编辑的正文（不落盘）。 */
+    chapterCheck(no: number, text: string): Promise<{
+        report: ReviewReport;
+    }>;
+    /** 保存手动编辑的正文（自动备份 .bak；带报告则沿用落盘，否则保存后自动审稿）。 */
+    chapterSave(no: number, text: string, report?: ReviewReport): Promise<import('../protocol.ts').ChapterSaveResponse>;
     patchConfig(patch: ConfigPatch): Promise<{
         config: NovelConfig;
     }>;
     openFolder(): Promise<void>;
     /** 书架快照。 */
     bookshelf(): Promise<import('../protocol.ts').BookshelfSnapshot>;
-    /** 新建书并激活。 */
-    bookCreate(bookName: string, outputDir?: string): Promise<import('../protocol.ts').BookshelfSnapshot>;
+    /** 新建书并激活（开书向导：可携带大纲文本，创建即建项目）。 */
+    bookCreate(bookName: string, outputDir?: string, outline?: string): Promise<import('../protocol.ts').BookshelfSnapshot>;
+    /** 重置项目（清空进度；可携带新大纲）。 */
+    reset(outline?: string): Promise<{
+        ok: boolean;
+        bookName: string;
+    }>;
+    /** 全书一致性质检。 */
+    audit(): Promise<import('../protocol.ts').AuditResponse>;
+    /** 角色卡刷新（基于事实库聚合）。 */
+    charactersRefresh(): Promise<{
+        cards: import('../protocol.ts').RoleStatusCard[];
+    }>;
+    /** 事实库回填：对历史已生成章节批量抽取事实。 */
+    factsBackfill(): Promise<{
+        ok: boolean;
+        filled: number;
+    }>;
+    /** 设定圣经局部修补。 */
+    biblePatch(patch: import('../protocol.ts').BiblePatchRequest): Promise<{
+        bible: import('../protocol.ts').StoryBible;
+    }>;
+    /** 小说简介：AI 生成/补全（partial 留空 = 全量），或手动保存。 */
+    blurb(action: 'generate' | 'save', text?: string, partial?: string): Promise<{
+        blurb: string;
+    }>;
+    /** 封面：读取（dataUrl；dir 指定某本书的输出目录，省略为当前书）。 */
+    coverGet(dir?: string): Promise<import('../protocol.ts').CoverResponse>;
+    /** 封面：上传（base64 data URL）或移除。 */
+    coverPost(action: 'upload' | 'remove', dataUrl?: string): Promise<{
+        ok: boolean;
+        coverPath?: string | null;
+    }>;
+    /** 重命名当前书（同步项目与书架条目）。 */
+    rename(bookName: string): Promise<{
+        bookName: string;
+    }>;
+    /** 大世界：AI 提炼（generate）或手动保存（save）。 */
+    world(action: 'generate' | 'save', world?: import('../protocol.ts').WorldState): Promise<{
+        world: import('../protocol.ts').WorldState;
+    }>;
     /** 切换当前书。 */
     bookActivate(id: string): Promise<import('../protocol.ts').BookshelfSnapshot>;
     /** 移除书架条目。 */
@@ -61,8 +106,22 @@ export declare class NovelApi {
     rewrite(chapterNo: number, instructions: string, target: string, onFrame: (frame: JobFrame) => void): Promise<void>;
     /** Polish (de-AI-ify) one chapter. */
     polish(chapterNo: number, onFrame: (frame: JobFrame) => void): Promise<void>;
+    /** 采纳待确认草稿（润色/重写产物），覆盖正文文件。 */
+    draftApply(chapterNo: number): Promise<{
+        ok: boolean;
+        chars: number;
+        file: string;
+    }>;
+    /** 放弃待确认草稿，保留原稿。 */
+    draftDiscard(chapterNo: number): Promise<{
+        ok: boolean;
+    }>;
     /** Run one assistant turn (NDJSON stream). */
     assistant(message: string, onFrame: (frame: import('../protocol.ts').AssistantFrame) => void): Promise<void>;
     /** Load the persisted assistant conversation. */
     assistantHistory(): Promise<import('../protocol.ts').AssistantMessage[]>;
+    /** 清空助手对话记录。 */
+    assistantClear(): Promise<{
+        ok: boolean;
+    }>;
 }

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

@@ -4,7 +4,7 @@
 /** zh dictionary. */
 export declare const zh: {
     readonly 'entry.label': "小说工坊";
-    readonly 'entry.tooltip': "AI 编译小说工作台：大纲 → 设定圣经 → 卷计划 → 章节计划 → 逐章生成+审稿";
+    readonly 'entry.tooltip': "AI 编译小说工作台：总纲 → 道藏 → 卷计划 → 章节计划 → 逐章生成+审稿";
     readonly 'panel.title': "小说工坊";
     readonly 'common.close': "关闭";
     readonly 'common.loading': "加载中…";
@@ -14,36 +14,36 @@ export declare const zh: {
     readonly 'common.generating': "生成中…";
     readonly 'common.chars': "字";
     readonly 'tab.workflow': "工作流";
-    readonly 'tab.overview': "大纲";
+    readonly 'tab.overview': "总纲";
     readonly 'tab.plan': "章节";
-    readonly 'tab.bible': "设定库";
-    readonly 'tab.foreshadow': "伏笔";
+    readonly 'tab.bible': "道藏";
+    readonly 'tab.foreshadow': "暗线";
     readonly 'tab.assistant': "AI 助手";
     readonly 'tab.settings': "设置";
     readonly 'workflow.title': "创作工作流";
-    readonly 'workflow.step1': "① 加载大纲";
-    readonly 'workflow.step2': "② 提炼设定圣经";
+    readonly 'workflow.step1': "① 加载总纲";
+    readonly 'workflow.step2': "② 提炼道藏";
     readonly 'workflow.step3': "③ 规划卷";
     readonly 'workflow.step4': "④ 生成章节计划";
     readonly 'workflow.step5': "⑤ 逐章写作 + AI 审稿";
     readonly 'workflow.step6': "⑥ 润色 / 导出";
-    readonly 'workflow.loadOutline': "读取大纲";
-    readonly 'workflow.genBible': "提炼设定圣经";
+    readonly 'workflow.loadOutline': "读取总纲";
+    readonly 'workflow.genBible': "提炼道藏";
     readonly 'workflow.genVolumes': "生成卷计划";
     readonly 'workflow.genPlan': "生成章节计划";
     readonly 'workflow.done': "已完成";
     readonly 'workflow.todo': "待办";
-    readonly 'workflow.bibleDone': "设定圣经已生成（{n} 条规则 / {c} 个角色 / {r} 条红线）";
+    readonly 'workflow.bibleDone': "道藏已生成（{n} 条规则 / {c} 个人物 / {r} 条红线）";
     readonly 'workflow.volumesDone': "卷计划已生成（{n} 卷）";
     readonly 'workflow.planDone': "章节计划已生成（{n} 章）";
-    readonly 'workflow.progress': "进度：大纲 ✓ · 设定 {bible} · 卷 {volumes} · 计划 {plan} · 已完成 {done}/{total} 章";
-    readonly 'overview.loadDocx': "从 docx 读取大纲";
-    readonly 'overview.loadDocxDefault': "读取默认大纲";
+    readonly 'workflow.progress': "进度：总纲 ✓ · 道藏 {bible} · 卷 {volumes} · 计划 {plan} · 已完成 {done}/{total} 章";
+    readonly 'overview.loadDocx': "从 docx 读取总纲";
+    readonly 'overview.loadDocxDefault': "读取默认总纲";
     readonly 'overview.loadingOutline': "正在解析 docx…";
-    readonly 'overview.outlineHint': "大纲文本（可编辑）";
-    readonly 'overview.outlineChars': "大纲字数";
-    readonly 'overview.saveOutline': "保存大纲";
-    readonly 'overview.saved': "大纲已保存";
+    readonly 'overview.outlineHint': "总纲文本（可编辑）";
+    readonly 'overview.outlineChars': "总纲字数";
+    readonly 'overview.saveOutline': "保存总纲";
+    readonly 'overview.saved': "总纲已保存";
     readonly 'overview.bookName': "书名";
     readonly 'overview.loadCustom': "指定 docx 路径";
     readonly 'overview.loadCustomHint': "绝对路径，留空使用默认";
@@ -78,17 +78,17 @@ export declare const zh: {
     readonly 'plan.summary': "章节摘要";
     readonly 'plan.volumes': "卷";
     readonly 'plan.noVolume': "未分卷";
-    readonly 'bible.title': "设定圣经";
-    readonly 'bible.gen': "AI 提炼设定圣经";
+    readonly 'bible.title': "道藏";
+    readonly 'bible.gen': "AI 提炼道藏";
     readonly 'bible.genre': "题材基调";
     readonly 'bible.worldRules': "世界规则";
-    readonly 'bible.characters': "角色卡";
+    readonly 'bible.characters': "人物志";
     readonly 'bible.redLines': "写作红线";
     readonly 'bible.style': "风格要求";
-    readonly 'bible.none': "尚未生成设定圣经。生成后写作会严格遵守人设与金手指规则，审稿也会按红线检查。";
-    readonly 'foreshadow.title': "伏笔管理";
-    readonly 'foreshadow.suggest': "AI 建议伏笔";
-    readonly 'foreshadow.none': "暂无伏笔";
+    readonly 'bible.none': "尚未生成道藏。生成后写作会严格遵守人设与金手指规则，审稿也会按红线检查。";
+    readonly 'foreshadow.title': "暗线管理";
+    readonly 'foreshadow.suggest': "AI 建议暗线";
+    readonly 'foreshadow.none': "暂无暗线";
     readonly 'foreshadow.status': "状态";
     readonly 'foreshadow.planned': "计划中";
     readonly 'foreshadow.planted': "已埋设";
@@ -122,7 +122,7 @@ export declare const zh: {
     readonly 'progress.rewriting': "正在修订第 {no} 章…";
     readonly 'progress.polishing': "正在润色第 {no} 章…";
     readonly 'progress.empty': "生成/审稿进度将显示在这里";
-    readonly 'assistant.hint': "和 AI 编辑讨论剧情、人设、伏笔；达成一致后可让它直接修改大纲、设定圣经、章节内容。";
+    readonly 'assistant.hint': "和 AI 编辑讨论剧情、人设、暗线；达成一致后可让它直接修改总纲、道藏、章节内容。";
     readonly 'assistant.placeholder': "例如：我想让第 2 章结尾加一个悬念——墟境里传来爷爷的声音…";
     readonly 'assistant.send': "发送";
     readonly 'assistant.toolStart': "⚙ 执行操作：{name}…";

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

@@ -2,6 +2,11 @@ import type { NovelApi } from '../api.ts';
 /** Props. */
 export interface AssetsTabProps {
     api: NovelApi;
+    /** 初始子页（左侧导航直达对应资产分类）。 */
+    initialTab?: AssetSubTab;
 }
+/** 写作资产子页签。 */
+type AssetSubTab = 'genre' | 'progression' | 'templates' | 'rules' | 'style';
 /** 写作资产页签。 */
-export declare function AssetsTab({ api }: AssetsTabProps): import("react").JSX.Element;
+export declare function AssetsTab({ api, initialTab }: AssetsTabProps): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,9 @@
+import type { NovelApi } from '../api.ts';
+/** 开书向导页。 */
+export declare function CreateBookView({ api, onBack, onCreated, }: {
+    api: NovelApi;
+    /** 返回书架。 */
+    onBack: () => void;
+    /** 开书成功：进入新书工作台。 */
+    onCreated: (id: string) => void;
+}): import("react").JSX.Element;

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

@@ -1,7 +1,7 @@
 import type { NovelApi } from '../api.ts';
 import type { PanelController } from './controller.ts';
 /** The panel's tab identifiers. */
-export type NovelTab = 'workflow' | 'overview' | 'plan' | 'bible' | 'assets' | 'foreshadow' | 'assistant' | 'settings';
+export type NovelTab = 'workflow' | 'overview' | 'blurb' | 'plan' | 'bible' | 'world' | 'foreshadow' | 'assistant' | 'settings' | 'characters' | 'assetsGenre' | 'assetsProgression' | 'assetsTemplates' | 'assetsRules' | 'assetsStyle';
 /** Panel shell props. */
 export interface NovelPanelProps {
     /** The panel state owner (open/close/toggle). */

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

@@ -0,0 +1,11 @@
+import type { NovelApi } from '../api.ts';
+import type { BookshelfSnapshot } from '../../protocol.ts';
+/** 书架首页。 */
+export declare function ShelfView({ api, shelf, onOpenBook, onAddBook, }: {
+    api: NovelApi;
+    shelf: BookshelfSnapshot;
+    /** 点击书卡：激活该书并进入工作台。 */
+    onOpenBook: (id: string) => void;
+    /** 点击＋：进入开书向导页。 */
+    onAddBook: () => void;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,10 @@
+import type { NovelApi } from '../api.ts';
+import type { WorldState } from '../../protocol.ts';
+/** 大世界页签。 */
+export declare function WorldTab({ api, world, onChanged, }: {
+    api: NovelApi;
+    /** 当前项目的大世界数据（可能为空）。 */
+    world: WorldState | undefined;
+    /** 保存/提炼成功后由父组件刷新项目状态。 */
+    onChanged: (world: WorldState) => void;
+}): import("react").JSX.Element;

package/lib/types/engine.d.ts

@@ -6,7 +6,7 @@
  * web-server dependencies), so routes stay thin and logic is testable.
  */
 import type { Context } from '@deepseek-ai/cordis';
-import type { ChapterPlan, Foreshadow, NovelConfig, ProjectState, ReviewReport, StoryBible, Volume } from './protocol.ts';
+import type { AuditIssue, ChapterPlan, Foreshadow, NovelConfig, ProjectState, ReviewReport, RoleStatusCard, StoryBible, Volume, WorldState } 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 */
@@ -35,6 +35,11 @@ export declare function planVolumes(ctx: Context, config: NovelConfig, outline:
 export declare function planChapters(ctx: Context, config: NovelConfig, project: ProjectState, chapterCount: number, volumeNo?: number): Promise<ChapterPlan[]>;
 /** Run the AI review on one chapter. */
 export declare function reviewChapter(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number): Promise<ReviewReport>;
+/**
+ * 审查「任意正文文本」（作者手动编辑后的草稿，不落盘）。
+ * 复用审稿提示词与红线/道藏/反AI规则；仅返回报告，不改文件不改状态。
+ */
+export declare function reviewChapterText(ctx: Context, config: NovelConfig, project: ProjectState, text: string): Promise<ReviewReport>;
 /**
  * Stream a chapter rewrite. With `target` (a passage of the body), only that
  * passage's paragraph is rewritten and spliced back — everything else stays
@@ -47,20 +52,21 @@ export declare function rewriteChapterStream(ctx: Context, config: NovelConfig,
     frame: 'delta';
     text: string;
 } | {
-    frame: 'done';
-    file: string;
+    frame: 'drafted';
     chars: number;
+    draft: string;
 }, void, unknown>;
-/** Stream a chapter polish (de-AI-ify). */
+/** Stream a chapter polish (de-AI-ify). Draft-mode: the polished body lands
+ *  in `chapter.pendingDraft` and is only applied on draft/apply. */
 export declare function polishChapterStream(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number): AsyncGenerator<{
     frame: 'start';
 } | {
     frame: 'delta';
     text: string;
 } | {
-    frame: 'done';
-    file: string;
+    frame: 'drafted';
     chars: number;
+    draft: string;
 }, void, unknown>;
 /** Generate one chapter (streaming). Yields progress frames; persists when done. */
 export declare function generateChapterStream(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number): AsyncGenerator<{
@@ -75,6 +81,61 @@ export declare function generateChapterStream(ctx: Context, config: NovelConfig,
 }, void, unknown>;
 /** Generate a chapter summary (narrative memory). */
 export declare function summarizeChapter(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number): Promise<string>;
+/**
+ * 摘要 + 事实抽取合并为一次 LLM 调用（省一次调用与一次正文输入，
+ * 批量生成时整体开销约省 25%）。
+ * @returns 摘要与新增事实条数（失败返回空，调用方 best-effort）。
+ */
+export declare function summarizeAndExtractFacts(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number): Promise<{
+    summary: string;
+    factCount: number;
+}>;
+/**
+ * 抽取本章「已确立事实」追加到事实库/时间线（最多 300 条，最新优先）。
+ * 事实注入后续章节生成提示词，保证人物状态/境界/资源/关系长期一致。
+ * @returns 新增事实条数（失败返回 0，调用方 best-effort）。
+ */
+export declare function extractFacts(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, chapterNo: number): Promise<number>;
+/** 全书一致性质检：LLM 分批扫描已生成章节 + 设定 + 事实库，聚合矛盾清单。 */
+export declare function auditBook(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string): Promise<AuditIssue[]>;
+/** 小说简介：AI 生成或按已写开头补全（面向读者的作品门面）。 */
+export declare function generateBlurb(ctx: Context, config: NovelConfig, project: ProjectState, partial?: string): Promise<string>;
+/**
+ * 组装全书上下文包（AI 助手 book_overview 工具）。
+ * 分片策略：章节要点默认只给最近 30 章（避免超长后爆上下文）；
+ * scope='full' 全量；scope=数字 只给该卷章节。
+ */
+export declare function bookOverview(project: ProjectState, scope?: 'recent' | 'full' | number): string;
+/** 一条影响分析结果（改动波及处）。 */
+export interface ImpactItem {
+    /** 位置：章节号 / 大纲 / 设定圣经 / 大世界 / 事实库 / 简介。 */
+    location: string;
+    /** 原文片段（定位用）。 */
+    quote: string;
+    /** 修改建议。 */
+    suggestion: string;
+    /** must = 必须同步改；optional = 建议改；note = 备注（如保留旧称作古称）。 */
+    kind: 'must' | 'optional' | 'note';
+}
+/**
+ * 影响分析：LLM 扫描全书（大纲/设定/大世界/事实库/已写章节），
+ * 定位一次改动波及的所有位置。助手在修改后主动调用，做连锁维护。
+ */
+export declare function analyzeImpact(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string, change: string): Promise<ImpactItem[]>;
+/** 把大世界结构化数据渲染成提示词块（境界体系按顺序强约束）。 */
+export declare function renderWorld(world: WorldState | undefined): string;
+/** AI 提炼大世界：从大纲 + 设定圣经生成结构化境界体系/区域/势力。 */
+export declare function extractWorld(ctx: Context, config: NovelConfig, project: ProjectState): Promise<WorldState>;
+/**
+ * 事实库回填：对历史已生成章节批量抽取事实（无事实记录的旧章节）。
+ * @returns 回填的章节数。
+ */
+export declare function backfillFacts(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string): Promise<number>;
+/**
+ * 角色卡刷新：出场统计由服务端从正文精确计算（角色名出现过的章节数、
+ * 最近出现章节），LLM 只负责聚合「当前状态」一句话。
+ */
+export declare function refreshCharacters(ctx: Context, config: NovelConfig, project: ProjectState, outputDir: string): Promise<RoleStatusCard[]>;
 /** Suggest foreshadows from the outline + plan. */
 export declare function suggestForeshadows(ctx: Context, config: NovelConfig, project: ProjectState): Promise<Foreshadow[]>;
 /**

package/lib/types/index.d.ts

@@ -44,7 +44,7 @@ export interface Config {
 }
 export declare const Config: z<Config>;
 /** Model-facing announcement: plugin presence, capabilities, and limits. */
-export declare const NOVEL_GUIDANCE = "\u672C\u673A\u5DF2\u5B89\u88C5 dsh-novel-forge \u63D2\u4EF6\uFF08AI \u7F16\u8BD1\u5C0F\u8BF4\u5DE5\u4F5C\u53F0\uFF09\uFF1A\u4FA7\u8FB9\u680F\u300C\u5C0F\u8BF4\u5DE5\u574A\u300D\u5165\u53E3\u3002\u80FD\u529B\uFF1A\u8BFB\u53D6 docx \u5927\u7EB2\uFF08\u9ED8\u8BA4\u684C\u9762\u300A\u5F52\u589F\u7389\u4E3B\u300B\u5927\u7EB2\uFF09\u6216\u7C98\u8D34\u5927\u7EB2\u6587\u672C\uFF1B\u7528 LLM \u63D0\u70BC\u8BBE\u5B9A\u5723\u7ECF\uFF08\u4EBA\u8BBE/\u4E16\u754C\u89C2/\u91D1\u624B\u6307\u89C4\u5219/\u5199\u4F5C\u7EA2\u7EBF\uFF09\uFF1B\u751F\u6210\u5377\u8BA1\u5212\u4E0E\u7AE0\u8282\u8BA1\u5212\uFF1B\u9010\u7AE0\u8C03\u7528 LLM \u751F\u6210 3000-4000 \u5B57\u6B63\u6587\u5E76\u4FDD\u5B58\u4E3A Markdown\uFF08\u9ED8\u8BA4\u8F93\u51FA\u5230 \u684C\u9762\\\u5F52\u589F\u7389\u4E3B\uFF09\uFF1B\u6BCF\u7AE0\u81EA\u52A8\u751F\u6210\u6458\u8981\uFF08\u53D9\u4E8B\u8BB0\u5FC6\uFF09\u3001\u81EA\u52A8 AI \u5BA1\u7A3F\uFF08\u4EBA\u8BBE/\u8BBE\u5B9A/\u7EA2\u7EBF/\u6587\u7B14/\u723D\u70B9/\u903B\u8F91\uFF09\uFF0C\u652F\u6301\u6309\u5BA1\u7A3F\u610F\u89C1\u91CD\u5199\u3001\u53BB AI \u5473\u6DA6\u8272\u3001\u4F0F\u7B14\u7BA1\u7406\u3001\u6279\u91CF\u8FDE\u5199\u4E0E\u5168\u672C\u5BFC\u51FA\uFF08txt/md\uFF09\u3002\u9650\u5236\uFF1A\u751F\u6210\u6D88\u8017 LLM API \u989D\u5EA6\uFF1B\u8F93\u51FA\u76EE\u5F55\u4E0E\u6A21\u578B\u53EF\u5728\u63D2\u4EF6\u8BBE\u7F6E\u4E2D\u4FEE\u6539\uFF1B\u7AE0\u8282\u6B63\u6587\u8D28\u91CF\u53D6\u51B3\u4E8E\u5927\u7EB2\u5B8C\u6574\u5EA6\u3002\u7528\u6237\u63D0\u5230\u300C\u5C0F\u8BF4 / \u5927\u7EB2 / \u5199\u5C0F\u8BF4 / \u7AE0\u8282 / \u5BA1\u7A3F / \u4F0F\u7B14 / \u6DA6\u8272 / \u5F52\u589F\u7389\u4E3B\u300D\u65F6\u5373\u6307\u672C\u63D2\u4EF6\uFF0C\u8BF7\u636E\u6B64\u534F\u4F5C\u3002";
+export declare const NOVEL_GUIDANCE = "\u672C\u673A\u5DF2\u5B89\u88C5 dsh-novel-forge \u63D2\u4EF6\uFF08AI \u7F16\u8BD1\u5C0F\u8BF4\u5DE5\u4F5C\u53F0\uFF09\uFF1A\u4FA7\u8FB9\u680F\u300C\u5C0F\u8BF4\u5DE5\u574A\u300D\u5165\u53E3\u3002\u80FD\u529B\uFF1A\u8BFB\u53D6 docx \u5927\u7EB2\uFF08\u9ED8\u8BA4\u684C\u9762\u300A\u5F52\u589F\u7389\u4E3B\u300B\u5927\u7EB2\uFF09\u6216\u7C98\u8D34\u5927\u7EB2\u6587\u672C\uFF1B\u7528 LLM \u63D0\u70BC\u9053\u85CF\uFF08\u4EBA\u8BBE/\u4E16\u754C\u89C2/\u91D1\u624B\u6307\u89C4\u5219/\u5199\u4F5C\u7EA2\u7EBF\uFF0C\u5373\u8BBE\u5B9A\u5723\u7ECF\uFF09\uFF1B\u751F\u6210\u5377\u8BA1\u5212\u4E0E\u7AE0\u8282\u8BA1\u5212\uFF1B\u9010\u7AE0\u8C03\u7528 LLM \u751F\u6210 3000-4000 \u5B57\u6B63\u6587\u5E76\u4FDD\u5B58\u4E3A Markdown\uFF08\u9ED8\u8BA4\u8F93\u51FA\u5230 \u684C\u9762\\\u5F52\u589F\u7389\u4E3B\uFF09\uFF1B\u6BCF\u7AE0\u81EA\u52A8\u751F\u6210\u6458\u8981\uFF08\u53D9\u4E8B\u8BB0\u5FC6\uFF09\u3001\u81EA\u52A8 AI \u5BA1\u7A3F\uFF08\u4EBA\u8BBE/\u8BBE\u5B9A/\u7EA2\u7EBF/\u6587\u7B14/\u723D\u70B9/\u903B\u8F91\uFF09\uFF0C\u652F\u6301\u6309\u5BA1\u7A3F\u610F\u89C1\u91CD\u5199\u3001\u53BB AI \u5473\u6DA6\u8272\u3001\u6697\u7EBF\uFF08\u4F0F\u7B14\uFF09\u7BA1\u7406\u3001\u6279\u91CF\u8FDE\u5199\u4E0E\u5168\u672C\u5BFC\u51FA\uFF08txt/md\uFF09\u3002\u9650\u5236\uFF1A\u751F\u6210\u6D88\u8017 LLM API \u989D\u5EA6\uFF1B\u8F93\u51FA\u76EE\u5F55\u4E0E\u6A21\u578B\u53EF\u5728\u63D2\u4EF6\u8BBE\u7F6E\u4E2D\u4FEE\u6539\uFF1B\u7AE0\u8282\u6B63\u6587\u8D28\u91CF\u53D6\u51B3\u4E8E\u5927\u7EB2\u5B8C\u6574\u5EA6\u3002\u7528\u6237\u63D0\u5230\u300C\u5C0F\u8BF4 / \u5927\u7EB2 / \u5199\u5C0F\u8BF4 / \u7AE0\u8282 / \u5BA1\u7A3F / \u6DA6\u8272 / \u5F52\u589F\u7389\u4E3B\u300D\u65F6\u5373\u6307\u672C\u63D2\u4EF6\uFF0C\u8BF7\u636E\u6B64\u534F\u4F5C\u3002";
 /** Resolve a config-like value into the full runtime config. */
 export declare function resolveConfig(value: Partial<Config> | undefined): NovelConfig;
 /**

package/lib/types/protocol.d.ts

@@ -18,13 +18,41 @@ export declare const NOVEL_API: {
     readonly review: "/api/dsh-novel-forge/review";
     readonly rewrite: "/api/dsh-novel-forge/rewrite";
     readonly polish: "/api/dsh-novel-forge/polish";
+    /** 采纳待确认草稿（润色/重写产物）覆盖正文文件。 */
+    readonly draftApply: "/api/dsh-novel-forge/draft/apply";
+    /** 放弃待确认草稿，保留原稿。 */
+    readonly draftDiscard: "/api/dsh-novel-forge/draft/discard";
     readonly summary: "/api/dsh-novel-forge/summary";
     readonly foreshadow: "/api/dsh-novel-forge/foreshadow";
     readonly exportBook: "/api/dsh-novel-forge/export";
     readonly chapter: "/api/dsh-novel-forge/chapter";
+    /** 审查任意正文文本（作者手动编辑后，不落盘）。 */
+    readonly chapterCheck: "/api/dsh-novel-forge/chapter/check";
+    /** 保存手动编辑的正文（自动备份 .bak）。 */
+    readonly chapterSave: "/api/dsh-novel-forge/chapter/save";
     readonly assistant: "/api/dsh-novel-forge/assistant";
     readonly assistantHistory: "/api/dsh-novel-forge/assistant-history";
+    /** 清空助手对话记录。 */
+    readonly assistantClear: "/api/dsh-novel-forge/assistant/clear";
     readonly bookshelf: "/api/dsh-novel-forge/bookshelf";
+    /** 重置项目（可选携带新大纲）：清空设定/卷/章节/伏笔/资产/事实库。 */
+    readonly reset: "/api/dsh-novel-forge/reset";
+    /** 全书一致性质检：LLM 扫描已生成章节，输出矛盾问题清单。 */
+    readonly audit: "/api/dsh-novel-forge/audit";
+    /** 角色卡刷新：基于事实库与各章摘要聚合角色当前状态。 */
+    readonly charactersRefresh: "/api/dsh-novel-forge/characters/refresh";
+    /** 事实库回填：对历史已生成章节批量抽取事实（旧章节无事实记录时用）。 */
+    readonly factsBackfill: "/api/dsh-novel-forge/facts/backfill";
+    /** 设定圣经局部修补（如世界观规则编辑）。 */
+    readonly biblePatch: "/api/dsh-novel-forge/bible/patch";
+    /** 小说简介：生成（AI）/补全（AI）/保存。 */
+    readonly blurb: "/api/dsh-novel-forge/blurb";
+    /** 重命名当前书（同步项目与书架条目）。 */
+    readonly rename: "/api/dsh-novel-forge/rename";
+    /** 大世界：AI 提炼 / 保存结构化数据（境界/区域/势力）。 */
+    readonly world: "/api/dsh-novel-forge/world";
+    /** 封面：GET 读取（dataUrl）/ POST 上传或移除。 */
+    readonly cover: "/api/dsh-novel-forge/blurb/cover";
     readonly config: "/api/dsh-novel-forge/config";
     readonly openFolder: "/api/dsh-novel-forge/open-folder";
 };
@@ -47,6 +75,8 @@ export interface BookshelfSnapshot {
         done: number;
         total: number;
         hasProject: boolean;
+        hasCover: boolean;
+        blurb?: string;
     }>;
     /** 当前激活的书 id（无则 null）。 */
     activeBookId: string | null;
@@ -55,6 +85,13 @@ export interface BookshelfSnapshot {
 export interface BookCreateRequest {
     bookName: string;
     outputDir?: string;
+    /** 开书向导：创建时直接导入的大纲文本（提供则立即建立项目）。 */
+    outline?: string;
+}
+/** POST /reset 请求：重置项目（可选更新大纲）。 */
+export interface ResetRequest {
+    /** 新大纲文本；提供则替换 outline，否则保留原大纲。 */
+    outline?: string;
 }
 /** POST /bookshelf/activate 请求：切换当前书。 */
 export interface BookActivateRequest {
@@ -90,6 +127,11 @@ export interface ChapterPlan {
     summary?: string;
     /** Latest review report (present once reviewed). */
     review?: ReviewReport;
+    /**
+     * 待确认草稿：润色（去AI味）或整章重写的产物正文。生成时先存这里，
+     * 用户看过对比后点「采纳」才覆盖正文文件；点「放弃」则丢弃。刷新页面不丢失。
+     */
+    pendingDraft?: string;
 }
 /** One review finding. */
 export interface ReviewIssue {
@@ -167,6 +209,122 @@ export interface Foreshadow {
     /** Resolution note when resolved. */
     resolvedNote?: string;
 }
+/** 一条已确立的叙事事实（事实库/时间线，注入后续章节生成）。 */
+export interface ChapterFact {
+    /** 来源章节号。 */
+    chapterNo: number;
+    /** 事实文本（人物状态/境界资源/关系变化/伏笔落地等）。 */
+    text: string;
+}
+/** 一条全书质检发现的问题（一致性矛盾，定位到章）。 */
+export interface AuditIssue {
+    /** 问题所在章节号（无法定位时 0）。 */
+    chapterNo: number;
+    severity: 'high' | 'medium' | 'low';
+    /** 矛盾描述。 */
+    item: string;
+    /** 修改建议。 */
+    suggestion: string;
+}
+/** POST /audit 响应。 */
+export interface AuditResponse {
+    issues: AuditIssue[];
+    /** 参与质检的章节数。 */
+    auditedChapters: number;
+    /** 质检时间。 */
+    auditedAt: string;
+}
+/** 角色卡：角色当前状态（从事实库聚合）。 */
+export interface RoleStatusCard {
+    name: string;
+    /** protagonist / supporting / antagonist / other。 */
+    role: string;
+    /** 当前状态一句话（境界/资源/伤势/心境）。 */
+    status: string;
+    /** 最近出场章节。 */
+    lastChapter: number;
+    /** 出场次数。 */
+    appearances: number;
+}
+/** POST /bible/patch 请求：局部修补设定圣经。 */
+export interface BiblePatchRequest {
+    worldRules?: string[];
+    redLines?: string[];
+    style?: string[];
+}
+/** POST /blurb 请求：AI 生成/补全或手动保存小说简介。 */
+export interface BlurbRequest {
+    action: 'generate' | 'save';
+    /** 已写好的开头（AI 补全时使用；留空 = 全量生成）。 */
+    partial?: string;
+    /** 手动保存的完整简介（action=save 时）。 */
+    text?: string;
+}
+/** POST /chapter/check|save 请求：审查/保存手动编辑的正文。 */
+export interface ChapterTextRequest {
+    chapterNo: number;
+    /** 当前编辑中的正文全文。 */
+    text: string;
+    /** 保存时携带：已在工作区审查过的报告（沿用落盘，不重复审）；缺省则保存后自动正式审稿一次。 */
+    report?: ReviewReport;
+}
+/** POST /chapter/save 响应。 */
+export interface ChapterSaveResponse {
+    ok: boolean;
+    chars: number;
+    file: string;
+    /** 落盘的审稿报告（沿用工作区报告或保存后自动审稿）。 */
+    report?: ReviewReport;
+}
+/** POST /cover 请求：上传或移除封面。 */
+export interface CoverRequest {
+    action: 'upload' | 'remove';
+    /** 上传时：data:image/...;base64,... 格式的图片数据。 */
+    dataUrl?: string;
+}
+/** POST /rename 请求：重命名当前书。 */
+export interface RenameRequest {
+    bookName: string;
+}
+/** 大世界：一个境界等级。 */
+export interface WorldRealm {
+    /** 境界名（练气/筑基/金丹…）。 */
+    name: string;
+    /** 描述：突破条件/寿命/标志等。 */
+    description: string;
+}
+/** 大世界：一个地理区域。 */
+export interface WorldRegion {
+    name: string;
+    description: string;
+    /** 关联势力名（可空）。 */
+    faction?: string;
+}
+/** 大世界：一方势力。 */
+export interface WorldFaction {
+    name: string;
+    /** 类型：宗门/家族/王朝/组织… */
+    kind: string;
+    description: string;
+    /** 驻地区域（可空）。 */
+    region?: string;
+}
+/** 大世界结构化数据。 */
+export interface WorldState {
+    realms: WorldRealm[];
+    regions: WorldRegion[];
+    factions: WorldFaction[];
+}
+/** POST /world 请求：AI 提炼或手动保存。 */
+export interface WorldRequest {
+    action: 'generate' | 'save';
+    /** action=save 时的完整世界数据。 */
+    world?: WorldState;
+}
+/** GET /cover 响应：封面的 dataUrl（无封面为 null）。 */
+export interface CoverResponse {
+    dataUrl: string | null;
+}
 /** The persisted project: outline + bible + plan + progress. */
 export interface ProjectState {
     /** Book title (first non-empty line of the outline, usually). */
@@ -185,6 +343,14 @@ export interface ProjectState {
     foreshadows: Foreshadow[];
     /** 写作资产（题材基底/推进模式/反AI规则/写法资产）。 */
     assets?: ProjectAssets;
+    /** 事实库/时间线：每章生成后抽取，注入后续章节保持一致性。 */
+    facts?: ChapterFact[];
+    /** 小说简介（面向读者的作品门面，AI 生成或手动保存）。 */
+    blurb?: string;
+    /** 封面文件名（相对输出目录，如 cover.png）。 */
+    coverPath?: string;
+    /** 大世界结构化数据（境界体系/区域/势力）。 */
+    world?: WorldState;
     /** ISO timestamps. */
     createdAt: string;
     updatedAt: string;
@@ -292,6 +458,13 @@ export type JobFrame = {
     no: number;
     file: string;
     chars: number;
+}
+/** 润色/重写完成，产物作为待确认草稿（尚未覆盖正文）。 */
+ | {
+    type: 'drafted';
+    no: number;
+    chars: number;
+    draft: string;
 } | {
     type: 'error';
     no: number;
@@ -316,6 +489,10 @@ export interface RewriteRequest {
 export interface PolishRequest {
     chapterNo: number;
 }
+/** POST /draft/apply | /draft/discard request: 采纳或放弃待确认草稿。 */
+export interface DraftDecisionRequest {
+    chapterNo: number;
+}
 /** POST /summary request: (re)generate a chapter summary. */
 export interface SummaryRequest {
     chapterNo: number;