@waterwx/dsh-novel-forge 0.1.0 → 1.1.0

package/lib/index.js

@@ -1,9 +1,9 @@
 import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
 import z from "schemastery";
 import { exec } from "node:child_process";
-import { appendFileSync, existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
-import { strFromU8, unzipSync } from "fflate";
+import { appendFileSync, copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
+import { strFromU8, unzipSync } from "fflate";
 import { BlockAssembler, ReasoningEffortId, createAssistantMessage, createUserMessage } from "@deepseek-ai/dsh-llm";
 import { homedir } from "node:os";
 import { randomBytes } from "node:crypto";
@@ -28,13 +28,41 @@ const NOVEL_API = {
 	review: "/api/dsh-novel-forge/review",
 	rewrite: "/api/dsh-novel-forge/rewrite",
 	polish: "/api/dsh-novel-forge/polish",
+	/** 采纳待确认草稿（润色/重写产物）覆盖正文文件。 */
+	draftApply: "/api/dsh-novel-forge/draft/apply",
+	/** 放弃待确认草稿，保留原稿。 */
+	draftDiscard: "/api/dsh-novel-forge/draft/discard",
 	summary: "/api/dsh-novel-forge/summary",
 	foreshadow: "/api/dsh-novel-forge/foreshadow",
 	exportBook: "/api/dsh-novel-forge/export",
 	chapter: "/api/dsh-novel-forge/chapter",
+	/** 审查任意正文文本（作者手动编辑后，不落盘）。 */
+	chapterCheck: "/api/dsh-novel-forge/chapter/check",
+	/** 保存手动编辑的正文（自动备份 .bak）。 */
+	chapterSave: "/api/dsh-novel-forge/chapter/save",
 	assistant: "/api/dsh-novel-forge/assistant",
 	assistantHistory: "/api/dsh-novel-forge/assistant-history",
+	/** 清空助手对话记录。 */
+	assistantClear: "/api/dsh-novel-forge/assistant/clear",
 	bookshelf: "/api/dsh-novel-forge/bookshelf",
+	/** 重置项目（可选携带新大纲）：清空设定/卷/章节/伏笔/资产/事实库。 */
+	reset: "/api/dsh-novel-forge/reset",
+	/** 全书一致性质检：LLM 扫描已生成章节，输出矛盾问题清单。 */
+	audit: "/api/dsh-novel-forge/audit",
+	/** 角色卡刷新：基于事实库与各章摘要聚合角色当前状态。 */
+	charactersRefresh: "/api/dsh-novel-forge/characters/refresh",
+	/** 事实库回填：对历史已生成章节批量抽取事实（旧章节无事实记录时用）。 */
+	factsBackfill: "/api/dsh-novel-forge/facts/backfill",
+	/** 设定圣经局部修补（如世界观规则编辑）。 */
+	biblePatch: "/api/dsh-novel-forge/bible/patch",
+	/** 小说简介：生成（AI）/补全（AI）/保存。 */
+	blurb: "/api/dsh-novel-forge/blurb",
+	/** 重命名当前书（同步项目与书架条目）。 */
+	rename: "/api/dsh-novel-forge/rename",
+	/** 大世界：AI 提炼 / 保存结构化数据（境界/区域/势力）。 */
+	world: "/api/dsh-novel-forge/world",
+	/** 封面：GET 读取（dataUrl）/ POST 上传或移除。 */
+	cover: "/api/dsh-novel-forge/blurb/cover",
 	config: "/api/dsh-novel-forge/config",
 	openFolder: "/api/dsh-novel-forge/open-folder"
 };
@@ -631,11 +659,12 @@ function effectiveAntiAiRules(assets) {
 	const customNames = new Set(custom.map((r) => r.name));
 	return [...BUILTIN_ANTI_AI_RULES.filter((r) => !customNames.has(r.name)), ...custom];
 }
-/** 把生效规则渲染成提示词块。 */
+/** 把生效规则渲染成提示词块（压缩：avoid/fix 截断，省 token）。 */
 function renderAntiAiRules(assets) {
 	const rules = effectiveAntiAiRules(assets);
 	if (rules.length === 0) return "";
-	return ["==================== 反 AI 规则（写作时必须遵守的表达边界） ====================", ...rules.map((r) => `- ${r.name}：避免——${r.avoid}；修正——${r.fix}`)].join("\n");
+	const clip = (value, max) => value.length > max ? value.slice(0, max) + "…" : value;
+	return ["==================== 反 AI 规则（写作时必须遵守的表达边界） ====================", ...rules.map((r) => `- ${r.name}：避免——${clip(r.avoid, 90)}${r.fix !== "" ? `；修正——${clip(r.fix, 50)}` : ""}`)].join("\n");
 }
 /** 渲染题材与推进模式提示词块。 */
 function renderGenreAndProgression(assets) {
@@ -665,17 +694,18 @@ function renderGenreAndProgression(assets) {
 	}
 	return sections.join("\n");
 }
-/** 渲染写法资产提示词块。 */
+/** 渲染写法资产提示词块（规则去重，省 token）。 */
 function renderStyleAssets(assets) {
 	const styles = assets?.styleAssets ?? [];
 	if (styles.length === 0) return "";
 	const sections = ["==================== 写法资产（本书的叙事风格约束） ===================="];
 	for (const style of styles) {
 		sections.push(`【${style.name}】`);
-		if (style.proseRules.length > 0) sections.push("叙述与节奏：\n" + style.proseRules.map((r) => `- ${r}`).join("\n"));
-		if (style.dialogueRules.length > 0) sections.push("台词风格：\n" + style.dialogueRules.map((r) => `- ${r}`).join("\n"));
-		if (style.descriptionRules.length > 0) sections.push("描写与情绪：\n" + style.descriptionRules.map((r) => `- ${r}`).join("\n"));
-		if (style.boundaries.length > 0) sections.push("表达边界：\n" + style.boundaries.map((r) => `- ${r}`).join("\n"));
+		const unique = (rules) => [...new Set(rules)];
+		if (style.proseRules.length > 0) sections.push("叙述与节奏：\n" + unique(style.proseRules).map((r) => `- ${r}`).join("\n"));
+		if (style.dialogueRules.length > 0) sections.push("台词风格：\n" + unique(style.dialogueRules).map((r) => `- ${r}`).join("\n"));
+		if (style.descriptionRules.length > 0) sections.push("描写与情绪：\n" + unique(style.descriptionRules).map((r) => `- ${r}`).join("\n"));
+		if (style.boundaries.length > 0) sections.push("表达边界：\n" + unique(style.boundaries).map((r) => `- ${r}`).join("\n"));
 	}
 	return sections.join("\n");
 }
@@ -738,6 +768,7 @@ function loadProject(outputDir) {
 		if (!Array.isArray(raw.assets.antiAiRules)) raw.assets.antiAiRules = [];
 		if (!Array.isArray(raw.assets.auxiliaryProgressions)) raw.assets.auxiliaryProgressions = [];
 		if (!Array.isArray(raw.assets.styleAssets)) raw.assets.styleAssets = [];
+		if (!Array.isArray(raw.facts)) raw.facts = [];
 		return raw;
 	} catch {
 		return;
@@ -752,7 +783,7 @@ function saveProject(outputDir, project) {
 function listChapterFiles(outputDir) {
 	if (!existsSync(outputDir)) return [];
 	try {
-		return readdirSync(outputDir).filter((name) => /^第\d+章_.*\.md$/.test(name)).sort((a, b) => {
+		return readdirSync(outputDir).filter((name) => /^第\d+章_.*\.md$/.test(name) && !name.endsWith(".bak.md")).sort((a, b) => {
 			return Number(/^第(\d+)章/.exec(a)?.[1] ?? 0) - Number(/^第(\d+)章/.exec(b)?.[1] ?? 0);
 		});
 	} catch {
@@ -792,6 +823,7 @@ function createProject(outline, outlinePath) {
 		chapters: [],
 		foreshadows: [],
 		assets: emptyProjectAssets(),
+		facts: [],
 		createdAt: now,
 		updatedAt: now
 	};
@@ -944,7 +976,7 @@ async function extractBible(ctx, config, outline) {
 		style: strArray(raw.style),
 		generatedAt: (/* @__PURE__ */ new Date()).toISOString()
 	};
-	if (bible.worldRules.length === 0 && bible.characters.length === 0 && bible.redLines.length === 0) throw new Error("设定圣经生成失败：模型没有返回有效内容");
+	if (bible.worldRules.length === 0 && bible.characters.length === 0 && bible.redLines.length === 0) throw new Error("道藏生成失败：模型没有返回有效内容");
 	return bible;
 }
 /** System prompt for volume planning. */
@@ -967,7 +999,8 @@ async function planVolumes(ctx, config, outline) {
 	const parsed = parseJsonArray(await complete(ctx, config, {
 		system: volumeSystemPrompt(),
 		user,
-		temperature: .4
+		temperature: .4,
+		maxTokens: Math.max(config.maxTokens, 12e3)
 	}));
 	const volumes = [];
 	for (let i = 0; i < parsed.length; i++) {
@@ -1005,8 +1038,8 @@ function planSystemPrompt(volumes) {
 		"2. 章节之间要衔接自然，前章结尾为后章埋下钩子。",
 		"3. 严格遵循大纲的人设、金手指规则、战力体系与世界观设定，不得自行发明冲突设定。",
 		"4. 输出必须是合法的 JSON 数组，不要输出任何其他文字或 Markdown 代码块标记。",
-		"5. 数组每个元素格式：{\"title\": \"章节标题（10字以内，有网文感）\", \"beats\": \"本章剧情要点（150-250字，含起承转合与钩子）\"}",
-		"重要：所有字符串值内部不得包含换行符，JSON 必须在一段内完整结束。",
+		"5. 数组每个元素格式：{\"title\": \"章节标题（10字以内，有网文感）\", \"beats\": \"结构化剧情要点（150-250字，必须包含四段，段间用换行分隔）：\\n本章目标：本章要完成的核心推进；\\n剧情要点：主要情节的起承转合（2-4 句）；\\n爽点/钩子：本章的爽点兑现或情绪钩子；\\n结尾钩子：本章结尾为下一章埋下的悬念\"}",
+		"重要：beats 字段内部必须使用 \\n 转义表示换行（JSON 字符串内不得有真实换行符），其余字符串值也不得包含真实换行符，JSON 必须在一段内完整结束。",
 		"重要：直接输出 JSON 结果本身，不要把思考过程或推理内容写在输出里。",
 		volumes !== void 0 && volumes.length > 0 ? ["\n全书分卷结构（规划章节时需落在对应卷内）："].concat(volumes.map((v) => `第${v.no}卷《${v.title}》：${v.summary}（章节 ${v.chapterStart}-${v.chapterEnd}）`)).join("\n") : ""
 	].join("\n");
@@ -1034,8 +1067,11 @@ function writeSystemPrompt(project) {
 		if (bible.redLines.length > 0) sections.push("写作红线（违反即失败）：\n" + bible.redLines.map((r) => `- ${r}`).join("\n"));
 		if (bible.style.length > 0) sections.push("风格要求：\n" + bible.style.map((r) => `- ${r}`).join("\n"));
 	}
+	const worldBlock = renderWorld(project.world);
+	if (worldBlock !== "") sections.push(worldBlock);
 	sections.push("==================== 全书大纲 ====================");
-	sections.push(project.outline);
+	const outlineBlock = project.outline.length > 6e3 ? project.outline.slice(0, 6e3) + "\n…（大纲过长已节选，完整内容见总纲页）" : project.outline;
+	sections.push(outlineBlock);
 	sections.push("==================== 大纲结束 ====================");
 	const assetsBlock = renderAllAssets(project.assets);
 	if (assetsBlock !== "") sections.push(assetsBlock);
@@ -1068,7 +1104,8 @@ async function planChapters(ctx, config, project, chapterCount, volumeNo) {
 	const parsed = parseJsonArray(await complete(ctx, config, {
 		system: planSystemPrompt(project.volumes),
 		user,
-		temperature: .7
+		temperature: .7,
+		maxTokens: Math.max(config.maxTokens, 2e4)
 	}));
 	const chapters = [];
 	const existing = new Set(project.chapters.map((c) => c.no));
@@ -1140,7 +1177,8 @@ async function reviewChapter(ctx, config, project, outputDir, chapterNo) {
 	const raw = parseJsonObject(await complete(ctx, config, {
 		system: reviewSystemPrompt(project),
 		user,
-		temperature: .3
+		temperature: .3,
+		maxTokens: Math.max(config.maxTokens, 16e3)
 	}));
 	const issues = Array.isArray(raw.issues) ? raw.issues.filter((v) => typeof v === "object" && v !== null).map((entry) => ({
 		severity: [
@@ -1165,6 +1203,40 @@ async function reviewChapter(ctx, config, project, outputDir, chapterNo) {
 	saveProject(outputDir, project);
 	return report;
 }
+/**
+* 审查「任意正文文本」（作者手动编辑后的草稿，不落盘）。
+* 复用审稿提示词与红线/道藏/反AI规则；仅返回报告，不改文件不改状态。
+*/
+async function reviewChapterText(ctx, config, project, text) {
+	const user = [
+		`书名：《${project.bookName}》`,
+		"==================== 待审查正文 ====================",
+		text.slice(0, 2e4)
+	].join("\n");
+	const raw = parseJsonObject(await complete(ctx, config, {
+		system: reviewSystemPrompt(project),
+		user,
+		temperature: .3,
+		maxTokens: Math.max(config.maxTokens, 8e3)
+	}));
+	const issues = Array.isArray(raw.issues) ? raw.issues.filter((v) => typeof v === "object" && v !== null).map((entry) => ({
+		severity: [
+			"high",
+			"medium",
+			"low"
+		].includes(entry.severity) ? entry.severity : "medium",
+		item: typeof entry.item === "string" ? entry.item : "",
+		suggestion: typeof entry.suggestion === "string" ? entry.suggestion : ""
+	})).filter((issue) => issue.item !== "") : [];
+	const score = typeof raw.score === "number" ? Math.max(0, Math.min(100, Math.round(raw.score))) : 60;
+	return {
+		score,
+		passed: score >= config.reviewPassScore,
+		verdict: typeof raw.verdict === "string" ? raw.verdict.slice(0, 200) : "",
+		issues,
+		reviewedAt: (/* @__PURE__ */ new Date()).toISOString()
+	};
+}
 /** Build the rewrite system prompt (fix review issues / instructions). */
 function rewriteSystemPrompt(project) {
 	return writeSystemPrompt(project) + "\n\n额外要求：你正在【修订】一章已写好的正文。保留原文中好的部分，只修改需要修改的地方，输出完整的新正文（不要只输出修改片段），字数与原文相当。";
@@ -1257,19 +1329,14 @@ async function* rewriteChapterStream(ctx, config, project, outputDir, chapterNo,
 	].filter((part) => part !== "").join("\n\n");
 	else newBody = rewritten;
 	if (newBody.length < 100) throw new Error("修订结果过短，可能失败，请重试");
-	const fileName = chapterFileName(chapter);
-	const markdown = `# 第${chapter.no}章 ${chapter.title}\n\n${newBody}\n`;
-	writeFileSync(join(outputDir, fileName), markdown, "utf8");
-	chapter.status = "written";
-	chapter.chars = newBody.length;
+	chapter.pendingDraft = newBody;
 	chapter.error = void 0;
-	chapter.review = void 0;
 	project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
 	saveProject(outputDir, project);
 	yield {
-		frame: "done",
-		file: fileName,
-		chars: newBody.length
+		frame: "drafted",
+		chars: newBody.length,
+		draft: newBody
 	};
 }
 /** The de-AI-ify polish system prompt (with project writing assets injected). */
@@ -1286,7 +1353,8 @@ function polishSystemPrompt(project) {
 		assetsBlock !== "" ? assetsBlock : ""
 	].join("\n");
 }
-/** 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. */
 async function* polishChapterStream(ctx, config, project, outputDir, chapterNo) {
 	const chapter = project.chapters.find((c) => c.no === chapterNo);
 	if (chapter === void 0) throw new Error(`章节 ${chapterNo} 不在计划中`);
@@ -1327,16 +1395,13 @@ async function* polishChapterStream(ctx, config, project, outputDir, chapterNo)
 	const newBody = assembler.blocks().filter((block) => block.type === "text").map((block) => block.text).join("\n").trim();
 	if (streamError !== void 0) throw streamError;
 	if (newBody.length < 100) throw new Error("润色结果过短，可能失败，请重试");
-	const fileName = chapterFileName(chapter);
-	writeFileSync(join(outputDir, fileName), `# 第${chapter.no}章 ${chapter.title}\n\n${newBody}\n`, "utf8");
-	chapter.status = "written";
-	chapter.chars = newBody.length;
+	chapter.pendingDraft = newBody;
 	project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
 	saveProject(outputDir, project);
 	yield {
-		frame: "done",
-		file: fileName,
-		chars: newBody.length
+		frame: "drafted",
+		chars: newBody.length,
+		draft: newBody
 	};
 }
 /** Generate one chapter (streaming). Yields progress frames; persists when done. */
@@ -1350,6 +1415,17 @@ async function* generateChapterStream(ctx, config, project, outputDir, chapterNo
 		if (existsSync(prevPath)) continuity = readFileSync(prevPath, "utf8").slice(-900);
 	}
 	const prevSummary = prev?.summary;
+	const allFacts = project.facts ?? [];
+	const recentFacts = allFacts.slice(-20).map((f) => f.text);
+	const beatsText = chapter.beats;
+	const relatedFacts = allFacts.slice(-120).filter((f) => {
+		const head = f.text.slice(0, 24);
+		for (let i = 0; i + 3 <= head.length; i++) {
+			const tri = head.slice(i, i + 3);
+			if (tri.trim() !== "" && beatsText.includes(tri)) return true;
+		}
+		return false;
+	}).slice(-15).map((f) => `[第${f.chapterNo}章] ${f.text}`);
 	const messages = [createUserMessage({
 		content: [{
 			type: "text",
@@ -1357,6 +1433,8 @@ async function* generateChapterStream(ctx, config, project, outputDir, chapterNo
 				`现在写第 ${chapter.no} 章，标题《${chapter.title}》。`,
 				`本章剧情要点：${chapter.beats}`,
 				"",
+				recentFacts.length > 0 ? `本书已确立的事实（新写内容不得与之矛盾）：\n${recentFacts.join("\n")}` : "",
+				relatedFacts.length > 0 ? `本章相关的既往事实（同样不得违背）：\n${relatedFacts.join("\n")}` : "",
 				prevSummary !== void 0 && prevSummary !== "" ? `上一章摘要：${prevSummary}` : "",
 				continuity !== "" ? `上一章结尾（用于衔接，不要复述）：\n${continuity}` : "这是第一章，注意开篇要有吸引力。",
 				"",
@@ -1421,12 +1499,451 @@ async function summarizeChapter(ctx, config, project, outputDir, chapterNo) {
 		].join("\n"),
 		user: body.replace(/^#\s+.*$/m, "").trim(),
 		temperature: .3,
-		maxTokens: 800
+		maxTokens: Math.max(config.maxTokens, 4e3)
 	})).slice(0, 500);
 	project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
 	saveProject(outputDir, project);
 	return chapter.summary;
 }
+/**
+* 摘要 + 事实抽取合并为一次 LLM 调用（省一次调用与一次正文输入，
+* 批量生成时整体开销约省 25%）。
+* @returns 摘要与新增事实条数（失败返回空，调用方 best-effort）。
+*/
+async function summarizeAndExtractFacts(ctx, config, project, outputDir, chapterNo) {
+	const chapter = project.chapters.find((c) => c.no === chapterNo);
+	if (chapter === void 0) return {
+		summary: "",
+		factCount: 0
+	};
+	const body = readChapterFile(outputDir, chapter);
+	if (body === void 0) return {
+		summary: "",
+		factCount: 0
+	};
+	const raw = parseJsonObject(await complete(ctx, config, {
+		system: [
+			"你是一位网文编辑。请为下面一章做两件事，输出合法 JSON 对象：",
+			"{\"summary\": \"120-200字摘要，含关键事件/主角状态变化（境界资源伤势心境）/新增伏笔线索/角色关系变化，客观陈述不评价\", \"facts\": [\"已确立事实1\", \"…3-6条\"]}",
+			"facts 指：本章明确写出的、对后续有约束力的事实——人物当前状态、重要关系变化、地点与时间线、已落地或新增的伏笔线索、关键道具去向。",
+			"重要：所有字符串值内部不得包含换行符，JSON 必须在一段内完整结束。"
+		].join("\n"),
+		user: body.replace(/^#\s+.*$/m, "").trim(),
+		temperature: .2,
+		maxTokens: Math.max(config.maxTokens, 5e3)
+	}));
+	const summary = typeof raw.summary === "string" ? raw.summary.trim().slice(0, 500) : "";
+	const factLines = Array.isArray(raw.facts) ? raw.facts.filter((v) => typeof v === "string" && v.trim().length > 8).map((v) => v.trim().slice(0, 140)) : [];
+	if (summary !== "") chapter.summary = summary;
+	const list = project.facts ?? [];
+	for (const line of factLines.slice(0, 8)) list.push({
+		chapterNo,
+		text: line
+	});
+	project.facts = list.slice(-300);
+	project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+	saveProject(outputDir, project);
+	return {
+		summary,
+		factCount: factLines.length
+	};
+}
+/**
+* 抽取本章「已确立事实」追加到事实库/时间线（最多 300 条，最新优先）。
+* 事实注入后续章节生成提示词，保证人物状态/境界/资源/关系长期一致。
+* @returns 新增事实条数（失败返回 0，调用方 best-effort）。
+*/
+async function extractFacts(ctx, config, project, outputDir, chapterNo) {
+	const chapter = project.chapters.find((c) => c.no === chapterNo);
+	if (chapter === void 0) return 0;
+	const body = readChapterFile(outputDir, chapter);
+	if (body === void 0) return 0;
+	const lines = (await complete(ctx, config, {
+		system: [
+			"你是一位网文编辑。请从本章正文中抽取「已确立事实」，供后续章节保持一致。",
+			"事实指：人物当前状态（境界/修为/伤势/资源/心境）、重要关系变化、地点与时间线、已落地或新增的伏笔线索、关键道具去向。",
+			"要求：",
+			"1. 只抽取本章明确写出的、对后续有约束力的内容；纯心理活动与无关细节不要。",
+			"2. 每行一条事实，用客观陈述句，不含主观评价。",
+			"3. 输出 3-6 条，每行一条，不要编号、不要前缀、不要解释。"
+		].join("\n"),
+		user: body.replace(/^#\s+.*$/m, "").trim(),
+		temperature: .2,
+		maxTokens: Math.max(config.maxTokens, 4e3)
+	})).split("\n").map((line) => line.replace(/^[-*\d.\s]+/, "").trim()).filter((line) => line.length > 8).slice(0, 8);
+	if (lines.length === 0) return 0;
+	const facts = project.facts ?? [];
+	for (const line of lines) facts.push({
+		chapterNo,
+		text: line.slice(0, 140)
+	});
+	project.facts = facts.slice(-300);
+	project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+	saveProject(outputDir, project);
+	return lines.length;
+}
+const AUDIT_BATCH_SIZE = 10;
+/** 单批质检：设定 + 事实库 + 该批章节节选 → 矛盾清单。 */
+async function auditBatch(ctx, config, project, outputDir, batch) {
+	const system = [
+		"你是一位严谨的网文连续性审校编辑。你会收到一本小说的设定圣经、事实库和一批章节正文节选。",
+		"请找出这批章节中的一致性矛盾，例如：",
+		"- 人物状态冲突：境界/修为/伤势/资源在同一章内或跨章前后矛盾。",
+		"- 设定违背：正文与世界观规则、金手指规则、写作红线冲突。",
+		"- 时间线错乱：事件顺序、时间跨度、地点移动不合逻辑。",
+		"- 细节穿帮：人名/地名/物品/数字前后不一致。",
+		"要求：",
+		"1. 只报告有实质证据的矛盾，不要泛泛而谈写作质量问题。",
+		"2. 每条必须定位到具体章节号。",
+		"3. 输出必须是合法 JSON 数组，格式：[{\"chapterNo\": 章节号, \"severity\": \"high|medium|low\", \"item\": \"矛盾描述\", \"suggestion\": \"修改建议\"}]",
+		"重要：所有字符串值内部不得包含换行符，JSON 必须在一段内完整结束。"
+	].join("\n");
+	const factsBlock = (project.facts ?? []).slice(-60).map((f) => `[第${f.chapterNo}章] ${f.text}`).join("\n");
+	const chapterBlocks = batch.map((c) => {
+		const excerpt = (readChapterFile(outputDir, c) ?? "").replace(/^#\s+.*$/m, "").trim().slice(0, 700);
+		return `【第${c.no}章《${c.title}》】\n${excerpt}`;
+	}).join("\n\n");
+	const parsed = parseJsonArray(await complete(ctx, config, {
+		system,
+		user: [
+			"请对以下小说做一致性质检。",
+			project.bible !== void 0 ? "设定圣经：\n" + [
+				project.bible.worldRules.length > 0 ? `世界规则：\n${project.bible.worldRules.map((r) => `- ${r}`).join("\n")}` : "",
+				project.bible.redLines.length > 0 ? `写作红线：\n${project.bible.redLines.map((r) => `- ${r}`).join("\n")}` : "",
+				project.bible.characters.length > 0 ? `角色：\n${project.bible.characters.map((ch) => `- ${ch.name}（${ch.traits.join("、")}）`).join("\n")}` : ""
+			].filter((s) => s !== "").join("\n") : "",
+			factsBlock !== "" ? `已确立事实库：\n${factsBlock}` : "",
+			`正文节选（每章前 700 字）：\n${chapterBlocks}`,
+			"只输出 JSON 数组。"
+		].filter((s) => s !== "").join("\n\n"),
+		temperature: .2,
+		maxTokens: Math.max(config.maxTokens, 12e3)
+	}));
+	const issues = [];
+	for (const entry of parsed) {
+		const item = typeof entry.item === "string" ? entry.item : "";
+		if (item === "") continue;
+		issues.push({
+			chapterNo: Number(entry.chapterNo) || 0,
+			severity: [
+				"high",
+				"medium",
+				"low"
+			].includes(entry.severity) ? entry.severity : "medium",
+			item,
+			suggestion: typeof entry.suggestion === "string" ? entry.suggestion : ""
+		});
+	}
+	return issues;
+}
+/** 全书一致性质检：LLM 分批扫描已生成章节 + 设定 + 事实库，聚合矛盾清单。 */
+async function auditBook(ctx, config, project, outputDir) {
+	const written = project.chapters.filter((c) => c.status !== "pending" && c.status !== "generating");
+	if (written.length === 0) return [];
+	const all = [];
+	for (let i = 0; i < written.length; i += AUDIT_BATCH_SIZE) {
+		const batch = written.slice(i, i + AUDIT_BATCH_SIZE);
+		try {
+			all.push(...await auditBatch(ctx, config, project, outputDir, batch));
+		} catch {}
+	}
+	return all.slice(0, 50);
+}
+/** 小说简介：AI 生成或按已写开头补全（面向读者的作品门面）。 */
+async function generateBlurb(ctx, config, project, partial = "") {
+	const system = [
+		"你是一位网文平台编辑，擅长写抓人的作品简介。",
+		"要求：",
+		"1. 120-250 字，突出核心卖点（金手指/题材/爽点/人设反差），用一两句抛出开局钩子。",
+		"2. 不剧透结局与关键反转；语气贴合题材（热血/悬疑/轻松/虐心）。",
+		"3. 中文，直接输出简介正文，不要 Markdown、不要引号包裹、不要「简介：」前缀。"
+	].join("\n");
+	const genreBlock = project.bible?.genre !== void 0 ? `题材：${project.bible.genre}` : "";
+	const volumeBlock = (project.volumes ?? []).slice(0, 3).map((v) => v.title).join("、");
+	return (await complete(ctx, config, {
+		system,
+		user: [
+			`书名：《${project.bookName}》`,
+			genreBlock,
+			volumeBlock !== "" ? `卷结构：${volumeBlock}` : "",
+			`已写章节数：${project.chapters.filter((c) => c.status !== "pending" && c.status !== "generating").length}`,
+			"大纲节选：\n" + project.outline.slice(0, 2500),
+			partial.trim() !== "" ? `已有开头草稿（请保留其内容与语气，续写补全为完整简介）：\n${partial.trim()}` : "请全量生成一份完整简介。"
+		].filter((s) => s !== "").join("\n\n"),
+		temperature: .7,
+		maxTokens: Math.max(config.maxTokens, 4e3)
+	})).replace(/^["'「『]|["'」』]$/g, "").replace(/^简介[：:]\s*/, "").trim().slice(0, 600);
+}
+/**
+* 组装全书上下文包（AI 助手 book_overview 工具）。
+* 分片策略：章节要点默认只给最近 30 章（避免超长后爆上下文）；
+* scope='full' 全量；scope=数字 只给该卷章节。
+*/
+function bookOverview(project, scope = "recent") {
+	const s = [];
+	s.push(`书名：${project.bookName}`);
+	s.push(`【大纲全文】\n${project.outline}`);
+	if (project.bible !== void 0) {
+		const bible = project.bible;
+		s.push("【设定圣经】");
+		if (bible.genre !== "") s.push(`题材基调：${bible.genre}`);
+		if (bible.worldRules.length > 0) s.push("世界规则：\n" + bible.worldRules.map((r) => `- ${r}`).join("\n"));
+		if (bible.characters.length > 0) {
+			s.push("角色卡：");
+			for (const card of bible.characters) {
+				const roleName = {
+					protagonist: "主角",
+					supporting: "配角",
+					antagonist: "反派",
+					other: "其他"
+				}[card.role];
+				s.push(`- ${card.name}（${roleName}）：${card.traits.join("、")}${card.goals !== "" ? `；目标：${card.goals}` : ""}${card.relations !== "" ? `；关系：${card.relations}` : ""}`);
+			}
+		}
+		if (bible.redLines.length > 0) s.push("写作红线：\n" + bible.redLines.map((r) => `- ${r}`).join("\n"));
+		if (bible.style.length > 0) s.push("风格要求：\n" + bible.style.map((r) => `- ${r}`).join("\n"));
+	}
+	const worldBlock = renderWorld(project.world);
+	if (worldBlock !== "") s.push(worldBlock);
+	if (project.volumes !== void 0 && project.volumes.length > 0) {
+		s.push("【卷结构】");
+		for (const v of project.volumes) s.push(`第${v.no}卷《${v.title}》：${v.summary}（章节 ${v.chapterStart}-${v.chapterEnd}）`);
+	}
+	if (project.chapters.length > 0) {
+		const maxNo = project.chapters.reduce((m, c) => Math.max(m, c.no), 0);
+		const shown = project.chapters.filter((c) => {
+			if (scope === "full") return true;
+			if (typeof scope === "number") return c.volume === scope;
+			return c.no > Math.max(0, maxNo - 30);
+		});
+		const label = scope === "full" ? "全部章节（标题/状态/剧情要点/摘要）" : typeof scope === "number" ? `第 ${scope} 卷章节（标题/状态/剧情要点/摘要）` : `最近 ${shown.length} 章（标题/状态/剧情要点/摘要）`;
+		s.push(`【${label}】`);
+		const statusText = {
+			pending: "待生成",
+			generating: "生成中",
+			written: "待审稿",
+			reviewing: "审稿中",
+			approved: "已通过",
+			rejected: "待修订",
+			error: "失败"
+		};
+		for (const c of shown) s.push(`第${c.no}章《${c.title}》[${statusText[c.status] ?? c.status}]${c.chars !== void 0 ? ` ${c.chars}字` : ""}\n剧情要点：${c.beats}\n摘要：${c.summary ?? "无"}`);
+		if (scope !== "full" && project.chapters.length > shown.length) s.push(`（还有 ${project.chapters.length - shown.length} 章未列出，可用 scope=volume:N 查看指定卷）`);
+	}
+	if ((project.facts ?? []).length > 0) {
+		s.push("【事实库（最近 40 条；更多用 facts_query 检索）】");
+		for (const f of (project.facts ?? []).slice(-40)) s.push(`- [第${f.chapterNo}章] ${f.text}`);
+	}
+	if (project.foreshadows.length > 0) {
+		s.push("【伏笔】");
+		for (const f of project.foreshadows) s.push(`- [${f.status}] ${f.description}${f.targetChapter !== void 0 ? `（预计 ${f.targetChapter} 章回收）` : ""}`);
+	}
+	if (project.blurb !== void 0 && project.blurb !== "") s.push(`【小说简介】${project.blurb}`);
+	return s.join("\n\n");
+}
+/**
+* 影响分析：LLM 扫描全书（大纲/设定/大世界/事实库/已写章节），
+* 定位一次改动波及的所有位置。助手在修改后主动调用，做连锁维护。
+*/
+async function analyzeImpact(ctx, config, project, outputDir, change) {
+	const system = [
+		"你是一位网文一致性审校。作者要做一处修改，请找出这次改动会波及的所有位置（设定、大纲、已写章节正文、事实库、简介中可能因此过时或矛盾的内容）。",
+		"输出必须是合法 JSON 数组，格式：[{\"location\": \"位置（第N章/大纲/设定圣经-世界规则/大世界-境界/事实库/简介）\", \"quote\": \"原文片段（20-60字）\", \"suggestion\": \"修改建议\", \"kind\": \"must|optional|note\"}]",
+		"kind 含义：must=必须同步改否则矛盾；optional=建议改（影响观感）；note=备注（如旧称保留为古称、或无需改但需知晓）。",
+		"重要：所有字符串值内部不得包含换行符，JSON 必须在一段内完整结束。"
+	].join("\n");
+	const written = project.chapters.filter((c) => c.status !== "pending" && c.status !== "generating");
+	const base = [
+		`要做的修改：${change}`,
+		"以下为全书设定与规则要点（章节为分批节选）：",
+		`大纲节选：\n${project.outline.slice(0, 2e3)}`,
+		project.bible !== void 0 ? `道藏：${project.bible.worldRules.length} 条世界规则 / ${project.bible.redLines.length} 条红线 / 人物 ${project.bible.characters.map((c) => c.name).join("、")}` : "",
+		(project.facts ?? []).length > 0 ? `编年录最近 40 条：\n${(project.facts ?? []).slice(-40).map((f) => `[第${f.chapterNo}章] ${f.text}`).join("\n")}` : ""
+	].filter((s) => s !== "").join("\n\n");
+	const items = [];
+	const IMPACT_BATCH_SIZE = 8;
+	for (let i = 0; i < written.length; i += IMPACT_BATCH_SIZE) {
+		const batch = written.slice(i, i + IMPACT_BATCH_SIZE);
+		const chapterBlock = batch.map((c) => {
+			const excerpt = (readChapterFile(outputDir, c) ?? "").replace(/^#\s+.*$/m, "").trim().slice(0, 500);
+			return `【第${c.no}章《${c.title}》】\n${excerpt}`;
+		}).join("\n\n");
+		const user = `${base}\n\n本批章节（第 ${batch[0].no}-${batch[batch.length - 1].no} 章）：\n${chapterBlock}\n\n只输出 JSON 数组。`;
+		try {
+			const text = await complete(ctx, config, {
+				system,
+				user,
+				temperature: .2,
+				maxTokens: Math.max(config.maxTokens, 12e3)
+			});
+			for (const entry of parseJsonArray(text)) {
+				const quote = typeof entry.quote === "string" ? entry.quote.trim() : "";
+				if (quote === "") continue;
+				items.push({
+					location: typeof entry.location === "string" ? entry.location : "未定位",
+					quote: quote.slice(0, 120),
+					suggestion: typeof entry.suggestion === "string" ? entry.suggestion : "",
+					kind: entry.kind === "must" || entry.kind === "optional" || entry.kind === "note" ? entry.kind : "optional"
+				});
+			}
+		} catch {}
+	}
+	return items.slice(0, 30);
+}
+/** 把大世界结构化数据渲染成提示词块（境界体系按顺序强约束）。 */
+function renderWorld(world) {
+	if (world === void 0) return "";
+	const sections = ["==================== 大世界（结构化设定，写作时严格遵守） ===================="];
+	if (world.realms.length > 0) {
+		sections.push("境界体系（由低到高，不得随意跳级或自创境界）：");
+		world.realms.forEach((realm, i) => {
+			sections.push(`${i + 1}. ${realm.name}${realm.description !== "" ? ` — ${realm.description}` : ""}`);
+		});
+	}
+	if (world.regions.length > 0) {
+		sections.push("地理区域：");
+		for (const region of world.regions) sections.push(`- ${region.name}${region.description !== "" ? `：${region.description}` : ""}${region.faction !== void 0 && region.faction !== "" ? `（势力：${region.faction}）` : ""}`);
+	}
+	if (world.factions.length > 0) {
+		sections.push("势力分布：");
+		for (const faction of world.factions) sections.push(`- ${faction.name}（${faction.kind}）${faction.description !== "" ? `：${faction.description}` : ""}${faction.region !== void 0 && faction.region !== "" ? `（驻地：${faction.region}）` : ""}`);
+	}
+	return sections.join("\n");
+}
+/** AI 提炼大世界：从大纲 + 设定圣经生成结构化境界体系/区域/势力。 */
+async function extractWorld(ctx, config, project) {
+	const system = [
+		"你是一位网文世界观架构师。请根据小说大纲与设定圣经，提炼结构化「大世界」数据。",
+		"输出必须是合法 JSON 对象：",
+		"{\"realms\": [{\"name\": \"境界名\", \"description\": \"突破条件/寿命/标志等\"}], \"regions\": [{\"name\": \"区域名\", \"description\": \"描述\", \"faction\": \"关联势力名或空\"}], \"factions\": [{\"name\": \"势力名\", \"kind\": \"宗门/家族/王朝/组织等\", \"description\": \"描述\", \"region\": \"驻地区域或空\"}]}",
+		"要求：",
+		"1. realms 按由低到高顺序排列（修仙题材必须含完整境界链；无境界设定的题材可输出空数组）。",
+		"2. 数量贴合大纲：realms 3-12 个，regions 2-10 个，factions 2-10 个。",
+		"3. 内容严格来自大纲与设定圣经，不要凭空发明与大纲冲突的设定。",
+		"重要：所有字符串值内部不得包含换行符，JSON 必须在一段内完整结束。"
+	].join("\n");
+	const bibleBlock = project.bible !== void 0 ? [project.bible.genre !== "" ? `题材：${project.bible.genre}` : "", project.bible.worldRules.length > 0 ? `世界规则：\n${project.bible.worldRules.map((r) => `- ${r}`).join("\n")}` : ""].filter((s) => s !== "").join("\n") : "";
+	const raw = parseJsonObject(await complete(ctx, config, {
+		system,
+		user: [
+			"请为这部小说提炼大世界数据。",
+			`书名：《${project.bookName}》`,
+			bibleBlock !== "" ? bibleBlock : "",
+			"大纲：\n" + project.outline.slice(0, 5e3),
+			"只输出 JSON 对象。"
+		].filter((s) => s !== "").join("\n\n"),
+		temperature: .3,
+		maxTokens: Math.max(config.maxTokens, 12e3)
+	}));
+	const str = (value) => typeof value === "string" ? value.trim() : "";
+	const objArray = (value) => Array.isArray(value) ? value.filter((v) => typeof v === "object" && v !== null) : [];
+	return {
+		realms: objArray(raw.realms).map((entry) => ({
+			name: str(entry.name).slice(0, 20) || "未命名境界",
+			description: str(entry.description).slice(0, 200)
+		})).filter((r) => r.name !== "未命名境界" || r.description !== ""),
+		regions: objArray(raw.regions).map((entry) => ({
+			name: str(entry.name).slice(0, 30) || "未命名区域",
+			description: str(entry.description).slice(0, 200),
+			faction: str(entry.faction).slice(0, 30)
+		})).filter((r) => r.name !== "未命名区域" || r.description !== ""),
+		factions: objArray(raw.factions).map((entry) => ({
+			name: str(entry.name).slice(0, 30) || "未命名势力",
+			kind: str(entry.kind).slice(0, 20) || "组织",
+			description: str(entry.description).slice(0, 200),
+			region: str(entry.region).slice(0, 30)
+		})).filter((f) => f.name !== "未命名势力" || f.description !== "")
+	};
+}
+/**
+* 事实库回填：对历史已生成章节批量抽取事实（无事实记录的旧章节）。
+* @returns 回填的章节数。
+*/
+async function backfillFacts(ctx, config, project, outputDir) {
+	const have = new Set((project.facts ?? []).map((f) => f.chapterNo));
+	let filled = 0;
+	for (const chapter of project.chapters) {
+		if (chapter.status === "pending" || chapter.status === "generating") continue;
+		if (chapter.file === void 0 || have.has(chapter.no)) continue;
+		try {
+			if (await extractFacts(ctx, config, project, outputDir, chapter.no) > 0) filled++;
+		} catch {}
+		have.add(chapter.no);
+	}
+	return filled;
+}
+/**
+* 角色卡刷新：出场统计由服务端从正文精确计算（角色名出现过的章节数、
+* 最近出现章节），LLM 只负责聚合「当前状态」一句话。
+*/
+async function refreshCharacters(ctx, config, project, outputDir) {
+	const roster = project.bible?.characters ?? [];
+	const facts = project.facts ?? [];
+	if (roster.length === 0 && facts.length === 0) return [];
+	const stat = /* @__PURE__ */ new Map();
+	const known = roster.map((card) => card.name);
+	for (const chapter of project.chapters) {
+		if (chapter.status === "pending" || chapter.status === "generating") continue;
+		const body = readChapterFile(outputDir, chapter);
+		if (body === void 0) continue;
+		for (const name of known) if (body.includes(name)) {
+			const entry = stat.get(name) ?? {
+				chapters: /* @__PURE__ */ new Set(),
+				last: 0
+			};
+			entry.chapters.add(chapter.no);
+			if (chapter.no > entry.last) entry.last = chapter.no;
+			stat.set(name, entry);
+		}
+	}
+	let statuses = /* @__PURE__ */ new Map();
+	if (facts.length > 0) {
+		const system = [
+			"你是一位网文角色档案管理员。请根据「角色名单」与「已确立事实库」，为每个角色输出「当前状态」一句话（境界/修为/伤势/资源/心境）。",
+			"输出必须是合法 JSON 数组，格式：[{\"name\": \"角色名\", \"status\": \"当前状态一句话\"}]",
+			"重要：所有字符串值内部不得包含换行符，JSON 必须在一段内完整结束。"
+		].join("\n");
+		const rosterBlock = roster.map((ch) => `- ${ch.name}（${ch.traits.join("、")}）`).join("\n");
+		const factsBlock = facts.map((f) => `[第${f.chapterNo}章] ${f.text}`).join("\n");
+		const user = [
+			`角色名单：\n${rosterBlock}`,
+			`已确立事实库（${facts.length} 条）：\n${factsBlock.slice(-6e3)}`,
+			"只输出 JSON 数组。"
+		].join("\n\n");
+		try {
+			const text = await complete(ctx, config, {
+				system,
+				user,
+				temperature: .2,
+				maxTokens: Math.max(config.maxTokens, 8e3)
+			});
+			for (const entry of parseJsonArray(text)) {
+				const name = typeof entry.name === "string" ? entry.name : "";
+				if (name !== "" && typeof entry.status === "string") statuses.set(name, entry.status);
+			}
+		} catch {}
+	}
+	const cards = [];
+	const roleOf = (name) => roster.find((c) => c.name === name)?.role ?? "other";
+	for (const card of roster) {
+		const entry = stat.get(card.name);
+		cards.push({
+			name: card.name,
+			role: card.role,
+			status: statuses.get(card.name) ?? "",
+			lastChapter: entry?.last ?? 0,
+			appearances: entry?.chapters.size ?? 0
+		});
+	}
+	for (const [name, entry] of stat) if (!cards.some((c) => c.name === name)) cards.push({
+		name,
+		role: roleOf(name),
+		status: statuses.get(name) ?? "",
+		lastChapter: entry.last,
+		appearances: entry.chapters.size
+	});
+	return cards;
+}
 /** System prompt for foreshadow suggestions. */
 function foreshadowSystemPrompt() {
 	return [
@@ -1450,7 +1967,8 @@ async function suggestForeshadows(ctx, config, project) {
 	const parsed = parseJsonArray(await complete(ctx, config, {
 		system: foreshadowSystemPrompt(),
 		user,
-		temperature: .5
+		temperature: .5,
+		maxTokens: Math.max(config.maxTokens, 12e3)
 	}));
 	const existing = new Set(project.foreshadows.map((f) => f.description));
 	const created = [];
@@ -1480,7 +1998,8 @@ async function extractStyleAsset(ctx, config, sampleText) {
 	const raw = parseJsonObject(await complete(ctx, config, {
 		system: styleEngineSystemPrompt(),
 		user,
-		temperature: .3
+		temperature: .3,
+		maxTokens: Math.max(config.maxTokens, 12e3)
 	}));
 	const strArray = (value) => Array.isArray(value) ? value.filter((v) => typeof v === "string" && v.trim() !== "") : [];
 	const result = {
@@ -1549,15 +2068,33 @@ function loadAssistantHistory(outputDir) {
 	} catch {}
 	return messages;
 }
-/** Append one message to the persisted history. */
+/** Append one message to the persisted history. Tool payloads (e.g. full
+*  outline / chapter text) are capped so the jsonl and later LLM context
+*  don't grow unboundedly. */
 function appendHistory(outputDir, message) {
 	mkdirSync(outputDir, { recursive: true });
-	appendFileSync(join(outputDir, ASSISTANT_HISTORY_FILE), JSON.stringify(message) + "\n", "utf8");
+	const entry = message.role === "tool" && message.content.length > 4e3 ? {
+		...message,
+		content: message.content.slice(0, 4e3) + "\n…（已截断，如需完整内容请重新调用工具）"
+	} : message;
+	appendFileSync(join(outputDir, ASSISTANT_HISTORY_FILE), JSON.stringify(entry) + "\n", "utf8");
+}
+/** 清空助手对话记录（删除历史文件）。 */
+function clearAssistantHistory(outputDir) {
+	const file = join(outputDir, ASSISTANT_HISTORY_FILE);
+	if (existsSync(file)) rmSync(file, { force: true });
 }
 /** Render the project snapshot the assistant sees. */
 function renderProjectSnapshot(project) {
 	const sections = [];
 	sections.push(`书名：${project.bookName}`);
+	sections.push(`大纲节选（如需全文用 outline_text 工具）：\n${project.outline.slice(0, 2500)}`);
+	const assetNames = [];
+	if (project.assets?.genre !== void 0) assetNames.push(`题材：${project.assets.genre.name}`);
+	if (project.assets?.primaryProgression !== void 0) assetNames.push(`主推进：${project.assets.primaryProgression.name}`);
+	if ((project.assets?.styleAssets?.length ?? 0) > 0) assetNames.push(`写法：${project.assets.styleAssets.map((s) => s.name).join("、")}`);
+	if ((project.assets?.antiAiRules?.length ?? 0) > 0) assetNames.push(`文戒自定义：${project.assets.antiAiRules.map((r) => r.name).join("、")}`);
+	if (assetNames.length > 0) sections.push(`【写作资产】${assetNames.join(" · ")}`);
 	if (project.bible !== void 0) {
 		const bible = project.bible;
 		sections.push("【设定圣经】");
@@ -1577,13 +2114,21 @@ function renderProjectSnapshot(project) {
 		}
 		if (bible.redLines.length > 0) sections.push("写作红线：\n" + bible.redLines.map((r) => `- ${r}`).join("\n"));
 	}
+	if (project.world !== void 0) {
+		const world = project.world;
+		sections.push("【大世界】");
+		if (world.realms.length > 0) sections.push("境界体系：" + world.realms.map((r, i) => `${i + 1}.${r.name}（${r.description.slice(0, 40)}）`).join(" → "));
+		if (world.regions.length > 0) sections.push("区域：" + world.regions.map((r) => r.name).join("、"));
+		if (world.factions.length > 0) sections.push("势力：" + world.factions.map((f) => `${f.name}（${f.kind}）`).join("、"));
+	}
 	if (project.volumes !== void 0 && project.volumes.length > 0) {
 		sections.push("【卷结构】");
 		for (const v of project.volumes) sections.push(`第${v.no}卷《${v.title}》：${v.summary}（章节 ${v.chapterStart}-${v.chapterEnd}）`);
 	}
 	if (project.chapters.length > 0) {
-		sections.push("【章节计划与进度】");
-		for (const c of project.chapters) {
+		const shown = project.chapters.slice(-30);
+		sections.push(`【章节计划与进度（最近 ${shown.length} 章）】`);
+		for (const c of shown) {
 			const statusText = {
 				pending: "待生成",
 				generating: "生成中",
@@ -1595,27 +2140,48 @@ function renderProjectSnapshot(project) {
 			}[c.status];
 			sections.push(`第${c.no}章《${c.title}》[${statusText}]${c.chars !== void 0 ? ` ${c.chars}字` : ""}${c.summary !== void 0 && c.summary !== "" ? ` 摘要：${c.summary}` : ""}`);
 		}
+		if (project.chapters.length > shown.length) sections.push(`（还有 ${project.chapters.length - shown.length} 章未列出，可用 book_overview scope=volume:N 查看）`);
+		const recent = project.chapters.filter((c) => c.status === "approved" || c.status === "written").slice(-2);
+		if (recent.length > 0) {
+			sections.push("【最近章节正文节选】");
+			for (const c of recent) sections.push(`第${c.no}章《${c.title}》（节选，如需全文用 chapter_text）：${c.beats.slice(0, 300)}`);
+		}
 	}
 	if (project.foreshadows.length > 0) {
 		sections.push("【伏笔】");
 		for (const f of project.foreshadows) sections.push(`- [${f.status}] ${f.description}${f.targetChapter !== void 0 ? `（预计 ${f.targetChapter} 章回收）` : ""}`);
 	}
+	if ((project.facts ?? []).length > 0) {
+		sections.push("【已确立事实库（最近 40 条，回答设定问题必须遵守）】");
+		for (const f of (project.facts ?? []).slice(-40)) sections.push(`- [第${f.chapterNo}章] ${f.text}`);
+	}
+	if (project.blurb !== void 0 && project.blurb !== "") sections.push(`【小说简介】${project.blurb}`);
 	return sections.join("\n");
 }
 /** The assistant system prompt. */
 function assistantSystemPrompt(project) {
 	return [
-		"你是这部小说的 AI 编辑助理，负责陪作者讨论剧情、人设、世界观，并把讨论结果落实到项目里。",
+		"你是「编辑老师」——服务这本书作者的资深中文网文编辑。",
+		"人设：二十年网文老编辑，懂套路、懂市场、懂节奏，说话直接但句句有用。",
+		"座右铭：「书是你的，但坑我替你盯着。」",
+		"职责边界：陪作者讨论剧情/人设/世界观/爽点节奏并落地修改、维护全书一致性；不闲聊、不彩虹屁、不无意义长篇大论。",
 		"==================== 当前项目快照 ====================",
 		renderProjectSnapshot(project),
 		"==================== 快照结束 ====================",
 		"",
-		"你可以：",
-		"1. 与作者讨论剧情走向、人物动机、爽点节奏、伏笔安排等，给出专业建议（直接文字回答）。",
-		"2. 讨论达成一致后，用动作指令实际修改内容。动作指令格式（放在回复末尾单独一行）：",
-		"   <dsh-action name=\"工具名\">{\"参数名\": 值}</dsh-action>",
+		"工作规则（严格遵守）：",
+		"1. 全量知情：回答和修改必须基于项目真实数据，禁止编造书中不存在的设定。需要完整信息时，先调用 book_overview 获取全书上下文（大纲全文/设定圣经/大世界/事实库/全部章节要点/伏笔/简介）；需要某章正文用 chapter_text。",
+		"2. 修改流程：改前用一句话说明意图 → 执行工具 → 改后简要汇报。",
+		"3. 连锁维护：改动可能波及其它位置（其它章节、设定、事实库、简介）时，执行后主动调用 impact_analysis 分析影响面，并把「必须同步」的项一并处理或明确提示作者逐项确认。",
+		"4. 删除红线：删除章节、清空设定等破坏性操作必须等作者明确同意。",
+		"5. 品质门槛：建议必须具体——指出问题在哪一章、哪一段、哪一句，并给出可落地的改法；禁止\"建议增强冲突\"这类空话。",
+		"6. 设定忠诚：忠于大纲、设定圣经、大世界、事实库；发现书中已有内容与设定冲突时，主动指出并给修正方案。",
+		"7. 中文回复，简洁有干货。",
 		"",
 		"可用工具：",
+		"- book_overview：{\"scope\": \"recent|full|volume:2\"(可选，默认 recent)}。返回全书上下文包（大纲/道藏/大世界/章节要点/事实库/伏笔/简介）。recent=最近30章；full=全部章节（书很长时慎用）；volume:N=只看第N卷。",
+		"- facts_query：{\"keyword\": \"关键词\"}。从编年录（事实库）按关键词检索相关事实（如灵石、境界名、人物名）。",
+		"- impact_analysis：{\"change\": \"要做的修改描述\"}。分析这次改动会波及哪些位置，返回影响清单（定位到章节/设定/事实库）。",
 		"- outline_text：无参数。返回当前大纲全文。",
 		"- outline_replace：{\"old\": \"要替换的原文片段\", \"new\": \"新文本\"}。在大纲中替换一段文字（old 必须能在大纲中找到）。",
 		"- bible_set_rule：{\"index\": 序号(0起), \"text\": \"新规则文本\"} 或 {\"append\": \"追加的规则\"}。修改设定圣经的世界规则。",
@@ -1630,7 +2196,14 @@ function assistantSystemPrompt(project) {
 		"- assets_status：无参数。查看本书当前写作资产（题材/推进模式/反AI规则/写法）。",
 		"- assets_set_genre：{\"name\": \"题材名\", \"description\": \"题材说明(可选)\"}。设置本书题材基底。",
 		"- assets_set_progression：{\"name\": \"模式名\", \"driver\": \"驱动力\", \"primary\": true/false}。设置主/辅助推进模式。",
-		"- assets_add_rule：{\"name\": \"规则名(可选)\", \"avoid\": \"要避免的表达问题\", \"fix\": \"修正方向(可选)\"}。新增反 AI 规则。",
+		"- assets_add_rule：{\"name\": \"规则名(可选)\", \"avoid\": \"要避免的表达问题\", \"fix\": \"修正方向(可选)}。新增反 AI 规则。",
+		"",
+		"回答质量要求（非常重要）：",
+		"- 具体：回答必须引用项目里的真实内容（人名、境界、章节、伏笔、设定），禁止空泛套话。快照里没有的信息，先调用工具获取（chapter_text / outline_text）再回答。",
+		"- 专业：给建议时说明理由，指出问题所在章节/段落，给出可直接落地的修改方案（改什么、怎么改）。",
+		"- 主动：作者说\"改一下\"，主动调用对应工具执行，不要只给建议不动手；执行前用一句话说明意图，执行后简短汇报结果。",
+		"- 忠于设定：以大纲、设定圣经、事实库为准，不得自相矛盾；发现问题（如剧情与设定冲突）主动指出。",
+		"- 中文回复；文字量适中，别啰嗦。",
 		"",
 		"使用规则（非常重要）：",
 		"- 当你想执行任何工具时，你的【整个回复】必须只包含动作指令标签，格式如下（不要有任何解释文字、不要用自然语言说\"我要去改\"，直接输出标签）：",
@@ -1644,7 +2217,7 @@ function assistantSystemPrompt(project) {
 		"- 如果工具执行失败（例如片段未找到），根据错误信息修正参数后自动重试一次，不要直接放弃或让作者手动操作。",
 		"- 修改前先向作者说明你要改什么、为什么；动作执行后简要汇报结果。",
 		"- 涉及删除类操作（删除章节、清空设定）必须等作者明确同意。",
-		"- 严格忠于设定圣经与大刚；不得自行发明与既有设定冲突的内容。",
+		"- 严格忠于设定圣经与大纲；不得自行发明与既有设定冲突的内容。",
 		"- 用中文回复。"
 	].join("\n");
 }
@@ -1662,6 +2235,25 @@ async function* executeAction(ctx, config, project, outputDir, name, args) {
 		for await (const step of stream) if (step.frame === "delta") yield step.text;
 	};
 	switch (name) {
+		case "book_overview": {
+			const scopeArg = str(args.scope);
+			return bookOverview(project, scopeArg === "full" ? "full" : /^volume:(\d+)$/.test(scopeArg) ? Number(scopeArg.slice(7)) : "recent");
+		}
+		case "facts_query": {
+			const keyword = str(args.keyword).trim();
+			if (keyword === "") throw new Error("facts_query 需要 keyword");
+			const hits = (project.facts ?? []).filter((f) => f.text.includes(keyword)).slice(-30);
+			if (hits.length === 0) return `编年录中未找到与「${keyword}」相关的事实记录。`;
+			return `编年录中与「${keyword}」相关的事实（${hits.length} 条）：\n` + hits.map((f) => `- [第${f.chapterNo}章] ${f.text}`).join("\n");
+		}
+		case "impact_analysis": {
+			const change = str(args.change);
+			if (change === "") throw new Error("impact_analysis 需要 change（要做的修改描述）");
+			const items = await analyzeImpact(ctx, config, project, outputDir, change);
+			if (items.length === 0) return "影响分析：未发现需要同步修改的位置。";
+			const lines = items.map((it, i) => `${i + 1}. [${it.location}]「${it.quote}」${it.suggestion !== "" ? ` → ${it.suggestion}` : ""}（${it.kind === "must" ? "必须同步" : it.kind === "optional" ? "建议" : "备注"}）`);
+			return `影响分析：这次改动波及 ${items.length} 处——\n${lines.join("\n")}\n请据此提示作者逐项处理；章节内的修改可引导作者在工作区查看。`;
+		}
 		case "outline_text": return project.outline;
 		case "outline_replace": {
 			const old = str(args.old);
@@ -1673,7 +2265,7 @@ async function* executeAction(ctx, config, project, outputDir, name, args) {
 			return `大纲已修改：替换了 ${old.length} 字符的片段。`;
 		}
 		case "bible_set_rule": {
-			if (project.bible === void 0) throw new Error("尚无设定圣经，请先提炼");
+			if (project.bible === void 0) throw new Error("尚无道藏，请先提炼");
 			const index = num(args.index);
 			if (index !== void 0) project.bible.worldRules[index] = str(args.text);
 			else if (str(args.append) !== "") project.bible.worldRules.push(str(args.append));
@@ -1683,7 +2275,7 @@ async function* executeAction(ctx, config, project, outputDir, name, args) {
 			return `世界规则已更新（当前 ${project.bible.worldRules.length} 条）。`;
 		}
 		case "bible_set_redline": {
-			if (project.bible === void 0) throw new Error("尚无设定圣经，请先提炼");
+			if (project.bible === void 0) throw new Error("尚无道藏，请先提炼");
 			const index = num(args.index);
 			if (index !== void 0) project.bible.redLines[index] = str(args.text);
 			else if (str(args.append) !== "") project.bible.redLines.push(str(args.append));
@@ -1707,9 +2299,23 @@ async function* executeAction(ctx, config, project, outputDir, name, args) {
 			const instructions = str(args.instructions);
 			const target = str(args.target);
 			for await (const chunk of forward(rewriteChapterStream(ctx, config, project, outputDir, no, instructions, target === "" ? void 0 : target))) yield chunk;
-			yield "（正在生成章节摘要…）";
+			const chapter = project.chapters.find((c) => c.no === no);
+			const draft = chapter?.pendingDraft;
+			if (chapter === void 0 || draft === void 0 || draft === "") throw new Error(`章节 ${no} 修订后没有产出草稿`);
+			const fileName = chapterFileName(chapter);
+			mkdirSync(outputDir, { recursive: true });
+			writeFileSync(join(outputDir, fileName), `# 第${chapter.no}章 ${chapter.title}\n\n${draft}\n`, "utf8");
+			chapter.pendingDraft = void 0;
+			chapter.status = "written";
+			chapter.chars = draft.length;
+			chapter.file = fileName;
+			chapter.review = void 0;
+			chapter.error = void 0;
+			project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+			saveProject(outputDir, project);
+			yield "（已采纳修订稿，正在生成章节摘要与编年录…）";
 			try {
-				await summarizeChapter(ctx, config, project, outputDir, no);
+				await summarizeAndExtractFacts(ctx, config, project, outputDir, no);
 			} catch {}
 			yield "（正在 AI 审稿…）";
 			const report = await reviewChapter(ctx, config, project, outputDir, no);
@@ -1719,9 +2325,9 @@ async function* executeAction(ctx, config, project, outputDir, name, args) {
 			const no = num(args.no);
 			if (no === void 0) throw new Error("chapter_generate 需要 no");
 			for await (const chunk of forward(generateChapterStream(ctx, config, project, outputDir, no))) yield chunk;
-			yield "（正在生成章节摘要…）";
+			yield "（正在生成章节摘要与编年录…）";
 			try {
-				await summarizeChapter(ctx, config, project, outputDir, no);
+				await summarizeAndExtractFacts(ctx, config, project, outputDir, no);
 			} catch {}
 			yield "（正在 AI 审稿…）";
 			const report = await reviewChapter(ctx, config, project, outputDir, no);
@@ -1838,11 +2444,11 @@ async function* executeAction(ctx, config, project, outputDir, name, args) {
 		default: throw new Error(`未知工具 ${name}`);
 	}
 }
-/** Extract the first action directive from a reply. */
+/** Extract the first action directive from a reply (tolerant to common tag misspellings). */
 function extractAction(reply) {
-	const match = /<dsh-action\s+name="([^"]+)"\s*>([\s\S]*?)<\/dsh-action>/.exec(reply);
+	const match = /<([a-z_]*d[a-z]?sh?-action)\s+name="([^"]+)"\s*>([\s\S]*?)<\/\1>/.exec(reply);
 	if (match === null) return void 0;
-	const rawArgs = match[2]?.trim() ?? "";
+	const rawArgs = match[3]?.trim() ?? "";
 	let args;
 	try {
 		args = rawArgs === "" ? {} : JSON.parse(rawArgs);
@@ -1850,7 +2456,7 @@ function extractAction(reply) {
 		throw new Error(`动作参数不是合法 JSON：${rawArgs.slice(0, 80)}`);
 	}
 	return {
-		name: match[1] ?? "",
+		name: match[2] ?? "",
 		args,
 		index: match.index
 	};
@@ -1879,16 +2485,19 @@ function historyToMessages(history) {
 			model: "deepseek-v4-flash"
 		}
 	}));
-	else if (entry.role === "tool") messages.push(createUserMessage({
-		content: [{
-			type: "text",
-			text: `【工具 ${entry.tool ?? ""} 的执行结果】\n${entry.content}`
-		}],
-		source: {
-			kind: "plugin",
-			plugin: "dsh-novel-forge"
-		}
-	}));
+	else if (entry.role === "tool") {
+		const body = entry.content.length > 2e3 ? entry.content.slice(0, 2e3) + "\n…（结果过长已截断，需要完整内容请重新调用工具）" : entry.content;
+		messages.push(createUserMessage({
+			content: [{
+				type: "text",
+				text: `【工具 ${entry.tool ?? ""} 的执行结果】\n${body}`
+			}],
+			source: {
+				kind: "plugin",
+				plugin: "dsh-novel-forge"
+			}
+		}));
+	}
 	return messages;
 }
 /** One non-streaming LLM chat turn (used inside the tool loop). */
@@ -1899,7 +2508,7 @@ async function chatOnce(ctx, config, system, history) {
 		model: config.model,
 		messages,
 		system,
-		maxTokens: config.maxTokens,
+		maxTokens: Math.max(config.maxTokens, 16e3),
 		temperature: .7
 	};
 	const assembler = new BlockAssembler();
@@ -1932,9 +2541,11 @@ async function* runAssistantTurn(ctx, config, project, outputDir, userMessage) {
 		const reply = await chatOnce(ctx, config, system, history);
 		const action = extractAction(reply);
 		if (action === void 0) {
-			if (/(改|修改|修订|重写|替换|调整|生成|新增|删除|导出|看看|查看|调出|读一下|加上|加一个|去掉|删掉|把.+改成)/.test(reply) && !nudged) {
+			const intendsAction = /(改|修改|修订|重写|替换|调整|生成|新增|删除|导出|看看|查看|调出|读一下|加上|加一个|去掉|删掉|把.+改成)/.test(reply);
+			const strayTag = /<[a-z_-]*action[^>]*>/.test(reply);
+			if ((intendsAction || strayTag) && !nudged) {
 				nudged = true;
-				const nudge = "你的上一条回复表达了想操作项目的意图（如查看/修改大纲、章节等），但没有输出动作指令标签，因此没有执行任何操作。请直接输出 <dsh-action name=\"工具名\">{\"参数\":值}</dsh-action> 标签来执行，不要用文字描述意图。如果需要先看内容，先输出 outline_text 或 chapter_text 标签。";
+				const nudge = "你的上一条回复表达了想操作项目的意图（或动作标签格式有误），因此没有执行任何操作。请直接输出动作标签来执行，格式必须为 <dsh-action name=\"工具名\">{\"参数\":值}</dsh-action>（注意拼写是 dsh-action，不是 dash-action；标签成对出现，参数为合法 JSON）。如果需要先看内容，先输出 outline_text 或 chapter_text 标签。";
 				history.push({
 					role: "tool",
 					content: nudge,
@@ -2095,11 +2706,14 @@ function bookshelfSnapshot(store) {
 		books: store.books.map((book) => {
 			const project = loadProject(book.outputDir);
 			const done = project === void 0 ? 0 : project.chapters.filter((c) => c.status === "approved" || c.status === "written" || c.status === "rejected").length;
+			const hasCover = project?.coverPath !== void 0 && project.coverPath !== "" && existsSync(join(book.outputDir, project.coverPath));
 			return {
 				...book,
 				done,
 				total: project?.chapters.length ?? 0,
-				hasProject: project !== void 0
+				hasProject: project !== void 0,
+				hasCover,
+				blurb: project?.blurb
 			};
 		}),
 		activeBookId: store.activeBookId
@@ -2122,6 +2736,16 @@ function createBook(bookName, outputDir) {
 	saveBookshelf(store);
 	return book;
 }
+/** 更新某本书的书名（开书向导导入大纲后书名以大纲首行为准）。 */
+function renameBook(id, bookName) {
+	const store = loadBookshelf();
+	const book = store.books.find((b) => b.id === id);
+	if (book === void 0) return false;
+	book.bookName = bookName;
+	book.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+	saveBookshelf(store);
+	return true;
+}
 /**
 * 播种：书架为空时，把指定输出目录下已有的项目自动登记为第一本书。
 * 兼容升级场景 —— 旧版插件直接在输出目录写项目，从未登记书架。
@@ -2168,8 +2792,8 @@ function defaultOutputDirFor(bookName) {
 }
 //#endregion
 //#region src/routes.ts
-/** Cap on JSON request bodies. */
-const MAX_JSON_BODY_BYTES = 4 * 1024 * 1024;
+/** Cap on JSON request bodies (generous: cover images travel as base64). */
+const MAX_JSON_BODY_BYTES = 16 * 1024 * 1024;
 /** Loopback-only fence (mirrors the family plugins' pairing routes). */
 function isLoopbackRequest(request) {
 	const address = request.socket.remoteAddress;
@@ -2264,7 +2888,10 @@ function makeRoutes(deps) {
 			}
 			writeJson(res, 200, {
 				config,
-				project: project ?? void 0,
+				project: project !== void 0 ? {
+					...project,
+					facts: (project.facts ?? []).slice(-80)
+				} : void 0,
 				generatedFiles: listChapterFiles(config.outputDir)
 			});
 		}
@@ -2466,9 +3093,9 @@ function makeRoutes(deps) {
 					title: chapter.title
 				});
 				try {
-					await summarizeChapter(ctx, config, project, config.outputDir, no);
+					await summarizeAndExtractFacts(ctx, config, project, config.outputDir, no);
 				} catch (error) {
-					console.warn("[dsh-novel-forge] summary failed:", error.message);
+					console.warn("[dsh-novel-forge] summary/facts failed:", error.message);
 				}
 				if (!(body?.skipReview === true) && (config.autoReview ?? true)) send({
 					type: "review",
@@ -2544,16 +3171,11 @@ function makeRoutes(deps) {
 					type: "delta",
 					text: step.text
 				});
-				else if (step.frame === "done") send({
-					type: "rewritten",
+				else if (step.frame === "drafted") send({
+					type: "drafted",
 					no,
-					file: step.file,
-					chars: step.chars
-				});
-				send({
-					type: "review",
-					no,
-					report: await reviewChapter(ctx, config, project, config.outputDir, no)
+					chars: step.chars,
+					draft: step.draft
 				});
 				res.end();
 			} catch (error) {
@@ -2596,11 +3218,11 @@ function makeRoutes(deps) {
 					type: "delta",
 					text: step.text
 				});
-				else if (step.frame === "done") send({
-					type: "rewritten",
+				else if (step.frame === "drafted") send({
+					type: "drafted",
 					no,
-					file: step.file,
-					chars: step.chars
+					chars: step.chars,
+					draft: step.draft
 				});
 				res.end();
 			} catch (error) {
@@ -2615,6 +3237,77 @@ function makeRoutes(deps) {
 			}
 		}
 	};
+	/** 采纳待确认草稿：覆盖正文文件 + 状态回 written + 清空草稿。 */
+	const draftApplyRoute = {
+		kind: "exact",
+		path: NOVEL_API.draftApply,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const config = getConfig();
+			const project = requireProject(res);
+			if (project === void 0) return;
+			const body = await readJsonBody(req);
+			if (!Number.isInteger(body?.chapterNo)) {
+				writeJson(res, 400, { error: "chapterNo 须为正整数" });
+				return;
+			}
+			const chapter = project.chapters.find((c) => c.no === body.chapterNo);
+			if (chapter === void 0) {
+				writeJson(res, 404, { error: `章节 ${body.chapterNo} 不在计划中` });
+				return;
+			}
+			if (chapter.pendingDraft === void 0 || chapter.pendingDraft === "") {
+				writeJson(res, 400, { error: `章节 ${chapter.no} 没有待确认的草稿` });
+				return;
+			}
+			const draft = chapter.pendingDraft;
+			const fileName = chapterFileName(chapter);
+			mkdirSync(config.outputDir, { recursive: true });
+			const targetPath = join(config.outputDir, fileName);
+			if (existsSync(targetPath)) copyFileSync(targetPath, join(config.outputDir, `${fileName.replace(/\.md$/, "")}.bak.md`));
+			writeFileSync(targetPath, `# 第${chapter.no}章 ${chapter.title}\n\n${draft}\n`, "utf8");
+			chapter.pendingDraft = void 0;
+			chapter.status = "written";
+			chapter.chars = draft.length;
+			chapter.file = fileName;
+			chapter.review = void 0;
+			chapter.error = void 0;
+			project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+			saveProject(config.outputDir, project);
+			writeJson(res, 200, {
+				ok: true,
+				chars: draft.length,
+				file: fileName
+			});
+		}
+	};
+	/** 放弃待确认草稿：保留原稿，仅清空草稿字段。 */
+	const draftDiscardRoute = {
+		kind: "exact",
+		path: NOVEL_API.draftDiscard,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const config = getConfig();
+			const project = requireProject(res);
+			if (project === void 0) return;
+			const body = await readJsonBody(req);
+			if (!Number.isInteger(body?.chapterNo)) {
+				writeJson(res, 400, { error: "chapterNo 须为正整数" });
+				return;
+			}
+			const chapter = project.chapters.find((c) => c.no === body.chapterNo);
+			if (chapter === void 0) {
+				writeJson(res, 404, { error: `章节 ${body.chapterNo} 不在计划中` });
+				return;
+			}
+			if (chapter.pendingDraft !== void 0) {
+				chapter.pendingDraft = void 0;
+				project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+				saveProject(config.outputDir, project);
+			}
+			writeJson(res, 200, { ok: true });
+		}
+	};
 	const summaryRoute = {
 		kind: "exact",
 		path: NOVEL_API.summary,
@@ -2732,6 +3425,77 @@ function makeRoutes(deps) {
 			});
 		}
 	};
+	/** 审查手动编辑的正文（不落盘，返回审稿报告）。 */
+	const chapterCheckRoute = {
+		kind: "exact",
+		path: NOVEL_API.chapterCheck,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const config = getConfig();
+			const project = requireProject(res);
+			if (project === void 0) return;
+			const text = (await readJsonBody(req))?.text?.trim() ?? "";
+			if (text.length < 50) {
+				writeJson(res, 400, { error: "正文过短（<50 字），请先编辑内容" });
+				return;
+			}
+			try {
+				writeJson(res, 200, { report: await reviewChapterText(ctx, config, project, text) });
+			} catch (error) {
+				writeJson(res, 500, { error: error.message });
+			}
+		}
+	};
+	/** 保存手动编辑的正文（自动备份 .bak，状态回 written）。 */
+	const chapterSaveRoute = {
+		kind: "exact",
+		path: NOVEL_API.chapterSave,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const config = getConfig();
+			const project = requireProject(res);
+			if (project === void 0) return;
+			const body = await readJsonBody(req);
+			if (!Number.isInteger(body?.chapterNo)) {
+				writeJson(res, 400, { error: "chapterNo 须为正整数" });
+				return;
+			}
+			const chapter = project.chapters.find((c) => c.no === body.chapterNo);
+			if (chapter === void 0) {
+				writeJson(res, 404, { error: `章节 ${body.chapterNo} 不在计划中` });
+				return;
+			}
+			const text = body?.text?.trim() ?? "";
+			if (text.length < 50) {
+				writeJson(res, 400, { error: "正文过短（<50 字），未保存" });
+				return;
+			}
+			const fileName = chapterFileName(chapter);
+			mkdirSync(config.outputDir, { recursive: true });
+			const targetPath = join(config.outputDir, fileName);
+			if (existsSync(targetPath)) copyFileSync(targetPath, join(config.outputDir, `${fileName.replace(/\.md$/, "")}.bak.md`));
+			writeFileSync(targetPath, `# 第${chapter.no}章 ${chapter.title}\n\n${text}\n`, "utf8");
+			chapter.status = "written";
+			chapter.chars = text.length;
+			chapter.file = fileName;
+			chapter.pendingDraft = void 0;
+			let report;
+			const carried = body?.report;
+			if (carried !== void 0 && typeof carried.score === "number") {
+				report = carried;
+				chapter.review = report;
+				chapter.status = report.passed ? "approved" : "rejected";
+			} else report = await reviewChapter(ctx, config, project, config.outputDir, chapter.no);
+			project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+			saveProject(config.outputDir, project);
+			writeJson(res, 200, {
+				ok: true,
+				chars: text.length,
+				file: fileName,
+				report
+			});
+		}
+	};
 	const assistantRoute = {
 		kind: "exact",
 		path: NOVEL_API.assistant,
@@ -2791,6 +3555,16 @@ function makeRoutes(deps) {
 			writeJson(res, 200, { messages: loadAssistantHistory(getConfig().outputDir) });
 		}
 	};
+	/** 清空助手对话记录。 */
+	const assistantClearRoute = {
+		kind: "exact",
+		path: NOVEL_API.assistantClear,
+		handler: (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			clearAssistantHistory(getConfig().outputDir);
+			writeJson(res, 200, { ok: true });
+		}
+	};
 	return [
 		statusRoute,
 		loadOutlineRoute,
@@ -2802,10 +3576,14 @@ function makeRoutes(deps) {
 		reviewRoute,
 		rewriteRoute,
 		polishRoute,
+		draftApplyRoute,
+		draftDiscardRoute,
 		summaryRoute,
 		foreshadowRoute,
 		exportRoute,
 		chapterRoute,
+		chapterCheckRoute,
+		chapterSaveRoute,
 		{
 			kind: "exact",
 			path: NOVEL_API.assets,
@@ -2887,6 +3665,7 @@ function makeRoutes(deps) {
 		},
 		assistantRoute,
 		assistantHistoryRoute,
+		assistantClearRoute,
 		{
 			kind: "exact",
 			path: NOVEL_API.bookshelf,
@@ -2911,7 +3690,14 @@ function makeRoutes(deps) {
 						writeJson(res, 400, { error: "bookName 不能为空" });
 						return;
 					}
-					createBook(bookName, body?.outputDir?.trim() !== "" && body?.outputDir !== void 0 ? body.outputDir : defaultOutputDirFor(bookName));
+					const outputDir = body?.outputDir?.trim() !== "" && body?.outputDir !== void 0 ? body.outputDir : defaultOutputDirFor(bookName);
+					const book = createBook(bookName, outputDir);
+					const outline = body?.outline?.trim();
+					if (outline !== void 0 && outline.length >= 50) {
+						const project = createProject(outline);
+						saveProject(outputDir, project);
+						renameBook(book.id, project.bookName);
+					}
 					writeJson(res, 200, bookshelfSnapshot(loadBookshelf()));
 					return;
 				}
@@ -2952,6 +3738,266 @@ function makeRoutes(deps) {
 				writeJson(res, 200, bookshelfSnapshot(loadBookshelf()));
 			}
 		},
+		{
+			kind: "exact",
+			path: NOVEL_API.reset,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				const config = getConfig();
+				const project = loadProject(config.outputDir);
+				if (project === void 0) {
+					writeJson(res, 400, { error: "输出目录中没有项目，无需重置" });
+					return;
+				}
+				const outline = (await readJsonBody(req))?.outline?.trim();
+				if (outline !== void 0 && outline.length >= 50) {
+					project.outline = outline;
+					project.bookName = createProject(outline).bookName;
+				}
+				project.bible = void 0;
+				project.volumes = void 0;
+				project.chapters = [];
+				project.foreshadows = [];
+				project.assets = emptyProjectAssets();
+				project.facts = [];
+				project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+				saveProject(config.outputDir, project);
+				writeJson(res, 200, {
+					ok: true,
+					bookName: project.bookName
+				});
+			}
+		},
+		{
+			kind: "exact",
+			path: NOVEL_API.audit,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				const config = getConfig();
+				const project = requireProject(res);
+				if (project === void 0) return;
+				try {
+					writeJson(res, 200, {
+						issues: await auditBook(ctx, config, project, config.outputDir),
+						auditedChapters: project.chapters.filter((c) => c.status !== "pending" && c.status !== "generating").length,
+						auditedAt: (/* @__PURE__ */ new Date()).toISOString()
+					});
+				} catch (error) {
+					writeJson(res, 500, { error: error.message });
+				}
+			}
+		},
+		{
+			kind: "exact",
+			path: NOVEL_API.charactersRefresh,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				const config = getConfig();
+				const project = requireProject(res);
+				if (project === void 0) return;
+				try {
+					writeJson(res, 200, { cards: await refreshCharacters(ctx, config, project, config.outputDir) });
+				} catch (error) {
+					writeJson(res, 500, { error: error.message });
+				}
+			}
+		},
+		{
+			kind: "exact",
+			path: NOVEL_API.factsBackfill,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				const config = getConfig();
+				const project = requireProject(res);
+				if (project === void 0) return;
+				try {
+					writeJson(res, 200, {
+						ok: true,
+						filled: await backfillFacts(ctx, config, project, config.outputDir)
+					});
+				} catch (error) {
+					writeJson(res, 500, { error: error.message });
+				}
+			}
+		},
+		{
+			kind: "exact",
+			path: NOVEL_API.biblePatch,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				const config = getConfig();
+				const project = requireProject(res);
+				if (project === void 0) return;
+				if (project.bible === void 0) {
+					writeJson(res, 400, { error: "尚未生成道藏，请先生成" });
+					return;
+				}
+				const body = await readJsonBody(req);
+				if (Array.isArray(body?.worldRules)) project.bible.worldRules = body.worldRules.filter((r) => r.trim() !== "");
+				if (Array.isArray(body?.redLines)) project.bible.redLines = body.redLines.filter((r) => r.trim() !== "");
+				if (Array.isArray(body?.style)) project.bible.style = body.style.filter((r) => r.trim() !== "");
+				project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+				saveProject(config.outputDir, project);
+				writeJson(res, 200, { bible: project.bible });
+			}
+		},
+		{
+			kind: "exact",
+			path: NOVEL_API.blurb,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				const config = getConfig();
+				const project = requireProject(res);
+				if (project === void 0) return;
+				const body = await readJsonBody(req);
+				try {
+					if (body?.action === "save") {
+						const text = body.text?.trim() ?? "";
+						project.blurb = text;
+						project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+						saveProject(config.outputDir, project);
+						writeJson(res, 200, { blurb: text });
+						return;
+					}
+					const partial = body?.partial?.trim() ?? "";
+					const blurb = await generateBlurb(ctx, config, project, partial);
+					project.blurb = blurb;
+					project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+					saveProject(config.outputDir, project);
+					writeJson(res, 200, { blurb });
+				} catch (error) {
+					writeJson(res, 500, { error: error.message });
+				}
+			}
+		},
+		{
+			kind: "exact",
+			path: NOVEL_API.cover,
+			handler: async (req, res) => {
+				const config = getConfig();
+				if (req.method === "GET") {
+					if (!isLoopbackRequest(req)) {
+						writeJson(res, 403, { error: "forbidden: loopback-only" });
+						return;
+					}
+					const dirParam = new URL(req.url ?? "/", "http://localhost").searchParams.get("dir");
+					const targetDir = dirParam !== null && dirParam !== "" ? dirParam : config.outputDir;
+					const coverPath = loadProject(targetDir)?.coverPath;
+					if (coverPath === void 0 || coverPath === "") {
+						writeJson(res, 200, { dataUrl: null });
+						return;
+					}
+					const file = join(targetDir, coverPath);
+					if (!existsSync(file)) {
+						writeJson(res, 200, { dataUrl: null });
+						return;
+					}
+					writeJson(res, 200, { dataUrl: `data:${coverPath.toLowerCase().endsWith(".png") ? "image/png" : coverPath.toLowerCase().endsWith(".jpg") || coverPath.toLowerCase().endsWith(".jpeg") ? "image/jpeg" : coverPath.toLowerCase().endsWith(".webp") ? "image/webp" : "image/png"};base64,${readFileSync(file).toString("base64")}` });
+					return;
+				}
+				if (req.method === "POST") {
+					if (!guard(req, res, "POST")) return;
+					const project = requireProject(res);
+					if (project === void 0) return;
+					const body = await readJsonBody(req);
+					try {
+						if (body?.action === "remove") {
+							if (project.coverPath !== void 0 && project.coverPath !== "") {
+								const oldFile = join(config.outputDir, project.coverPath);
+								if (existsSync(oldFile)) rmSync(oldFile, { force: true });
+							}
+							project.coverPath = void 0;
+							project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+							saveProject(config.outputDir, project);
+							writeJson(res, 200, {
+								ok: true,
+								coverPath: null
+							});
+							return;
+						}
+						const dataUrl = body?.dataUrl ?? "";
+						const match = /^data:(image\/(?:png|jpeg|jpg|webp));base64,(.+)$/s.exec(dataUrl);
+						if (match === null) {
+							writeJson(res, 400, { error: "封面须为 PNG/JPEG/WebP 的 base64 data URL" });
+							return;
+						}
+						const mime = match[1];
+						const fileName = `cover.${mime === "image/png" ? "png" : mime === "image/webp" ? "webp" : "jpg"}`;
+						const targetPath = join(config.outputDir, fileName);
+						const oldPath = project.coverPath;
+						mkdirSync(config.outputDir, { recursive: true });
+						writeFileSync(targetPath, Buffer.from(match[2], "base64"));
+						if (oldPath !== void 0 && oldPath !== "" && oldPath !== fileName) {
+							const oldFile = join(config.outputDir, oldPath);
+							if (existsSync(oldFile)) rmSync(oldFile, { force: true });
+						}
+						project.coverPath = fileName;
+						project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+						saveProject(config.outputDir, project);
+						writeJson(res, 200, {
+							ok: true,
+							coverPath: fileName
+						});
+					} catch (error) {
+						writeJson(res, 500, { error: error.message });
+					}
+					return;
+				}
+				writeJson(res, 405, { error: "method not allowed (expected GET or POST)" });
+			}
+		},
+		{
+			kind: "exact",
+			path: NOVEL_API.world,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				const config = getConfig();
+				const project = requireProject(res);
+				if (project === void 0) return;
+				const body = await readJsonBody(req);
+				try {
+					if (body?.action === "save" && body.world !== void 0) {
+						project.world = {
+							realms: Array.isArray(body.world.realms) ? body.world.realms : [],
+							regions: Array.isArray(body.world.regions) ? body.world.regions : [],
+							factions: Array.isArray(body.world.factions) ? body.world.factions : []
+						};
+						project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+						saveProject(config.outputDir, project);
+						writeJson(res, 200, { world: project.world });
+						return;
+					}
+					const world = await extractWorld(ctx, config, project);
+					project.world = world;
+					project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+					saveProject(config.outputDir, project);
+					writeJson(res, 200, { world });
+				} catch (error) {
+					writeJson(res, 500, { error: error.message });
+				}
+			}
+		},
+		{
+			kind: "exact",
+			path: NOVEL_API.rename,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				const config = getConfig();
+				const project = requireProject(res);
+				if (project === void 0) return;
+				const bookName = (await readJsonBody(req))?.bookName?.trim();
+				if (bookName === void 0 || bookName === "") {
+					writeJson(res, 400, { error: "书名不能为空" });
+					return;
+				}
+				project.bookName = bookName.slice(0, 60);
+				project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+				saveProject(config.outputDir, project);
+				const store = loadBookshelf();
+				if (store.activeBookId !== null) renameBook(store.activeBookId, project.bookName);
+				writeJson(res, 200, { bookName: project.bookName });
+			}
+		},
 		{
 			kind: "exact",
 			path: NOVEL_API.config,
@@ -3027,7 +4073,7 @@ const DEFAULT_AUTO_REVIEW = true;
 /** Order of the announcement section within the tool-guidance band. */
 const SECTION_ORDER = 160;
 /** Model-facing announcement: plugin presence, capabilities, and limits. */
-const NOVEL_GUIDANCE = "本机已安装 dsh-novel-forge 插件（AI 编译小说工作台）：侧边栏「小说工坊」入口。能力：读取 docx 大纲（默认桌面《归墟玉主》大纲）或粘贴大纲文本；用 LLM 提炼设定圣经（人设/世界观/金手指规则/写作红线）；生成卷计划与章节计划；逐章调用 LLM 生成 3000-4000 字正文并保存为 Markdown（默认输出到 桌面\\归墟玉主）；每章自动生成摘要（叙事记忆）、自动 AI 审稿（人设/设定/红线/文笔/爽点/逻辑），支持按审稿意见重写、去 AI 味润色、伏笔管理、批量连写与全本导出（txt/md）。限制：生成消耗 LLM API 额度；输出目录与模型可在插件设置中修改；章节正文质量取决于大纲完整度。用户提到「小说 / 大纲 / 写小说 / 章节 / 审稿 / 伏笔 / 润色 / 归墟玉主」时即指本插件，请据此协作。";
+const NOVEL_GUIDANCE = "本机已安装 dsh-novel-forge 插件（AI 编译小说工作台）：侧边栏「小说工坊」入口。能力：读取 docx 大纲（默认桌面《归墟玉主》大纲）或粘贴大纲文本；用 LLM 提炼道藏（人设/世界观/金手指规则/写作红线，即设定圣经）；生成卷计划与章节计划；逐章调用 LLM 生成 3000-4000 字正文并保存为 Markdown（默认输出到 桌面\\归墟玉主）；每章自动生成摘要（叙事记忆）、自动 AI 审稿（人设/设定/红线/文笔/爽点/逻辑），支持按审稿意见重写、去 AI 味润色、暗线（伏笔）管理、批量连写与全本导出（txt/md）。限制：生成消耗 LLM API 额度；输出目录与模型可在插件设置中修改；章节正文质量取决于大纲完整度。用户提到「小说 / 大纲 / 写小说 / 章节 / 审稿 / 润色 / 归墟玉主」时即指本插件，请据此协作。";
 /** Resolve a config-like value into the full runtime config. */
 function resolveConfig(value) {
 	return {