@waterwx/dsh-novel-forge 1.0.0 → 1.1.0

package/lib/index.js

@@ -1,7 +1,7 @@
 import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
 import z from "schemastery";
 import { exec } from "node:child_process";
-import { appendFileSync, copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
+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";
@@ -36,8 +36,14 @@ const NOVEL_API = {
 	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",
@@ -49,6 +55,14 @@ const NOVEL_API = {
 	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"
 };
@@ -645,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) {
@@ -679,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");
 }
@@ -960,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. */
@@ -983,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++) {
@@ -1050,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);
@@ -1084,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));
@@ -1156,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: [
@@ -1181,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额外要求：你正在【修订】一章已写好的正文。保留原文中好的部分，只修改需要修改的地方，输出完整的新正文（不要只输出修改片段），字数与原文相当。";
@@ -1359,7 +1415,17 @@ async function* generateChapterStream(ctx, config, project, outputDir, chapterNo
 		if (existsSync(prevPath)) continuity = readFileSync(prevPath, "utf8").slice(-900);
 	}
 	const prevSummary = prev?.summary;
-	const recentFacts = (project.facts ?? []).slice(-20).map((f) => f.text);
+	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",
@@ -1368,6 +1434,7 @@ async function* generateChapterStream(ctx, config, project, outputDir, chapterNo
 				`本章剧情要点：${chapter.beats}`,
 				"",
 				recentFacts.length > 0 ? `本书已确立的事实（新写内容不得与之矛盾）：\n${recentFacts.join("\n")}` : "",
+				relatedFacts.length > 0 ? `本章相关的既往事实（同样不得违背）：\n${relatedFacts.join("\n")}` : "",
 				prevSummary !== void 0 && prevSummary !== "" ? `上一章摘要：${prevSummary}` : "",
 				continuity !== "" ? `上一章结尾（用于衔接，不要复述）：\n${continuity}` : "这是第一章，注意开篇要有吸引力。",
 				"",
@@ -1432,13 +1499,56 @@ 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）。
@@ -1472,13 +1582,12 @@ async function extractFacts(ctx, config, project, outputDir, chapterNo) {
 	saveProject(outputDir, project);
 	return lines.length;
 }
-/** 全书一致性质检：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 AUDIT_BATCH_SIZE = 10;
+/** 单批质检：设定 + 事实库 + 该批章节节选 → 矛盾清单。 */
+async function auditBatch(ctx, config, project, outputDir, batch) {
 	const system = [
-		"你是一位严谨的网文连续性审校编辑。你会收到一本小说的设定圣经、事实库和各章正文节选。",
-		"请找出全书的一致性矛盾，例如：",
+		"你是一位严谨的网文连续性审校编辑。你会收到一本小说的设定圣经、事实库和一批章节正文节选。",
+		"请找出这批章节中的一致性矛盾，例如：",
 		"- 人物状态冲突：境界/修为/伤势/资源在同一章内或跨章前后矛盾。",
 		"- 设定违背：正文与世界观规则、金手指规则、写作红线冲突。",
 		"- 时间线错乱：事件顺序、时间跨度、地点移动不合逻辑。",
@@ -1489,15 +1598,15 @@ async function auditBook(ctx, config, project, outputDir) {
 		"3. 输出必须是合法 JSON 数组，格式：[{\"chapterNo\": 章节号, \"severity\": \"high|medium|low\", \"item\": \"矛盾描述\", \"suggestion\": \"修改建议\"}]",
 		"重要：所有字符串值内部不得包含换行符，JSON 必须在一段内完整结束。"
 	].join("\n");
-	const factsBlock = (project.facts ?? []).slice(-80).map((f) => `[第${f.chapterNo}章] ${f.text}`).join("\n");
-	const chapterBlocks = written.map((c) => {
+	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")}` : "",
@@ -1525,7 +1634,226 @@ async function auditBook(ctx, config, project, outputDir) {
 			suggestion: typeof entry.suggestion === "string" ? entry.suggestion : ""
 		});
 	}
-	return issues.slice(0, 30);
+	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 !== "")
+	};
 }
 /**
 * 事实库回填：对历史已生成章节批量抽取事实（无事实记录的旧章节）。
@@ -1639,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 = [];
@@ -1669,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 = {
@@ -1738,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("【设定圣经】");
@@ -1766,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: "生成中",
@@ -1784,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\": \"追加的规则\"}。修改设定圣经的世界规则。",
@@ -1819,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）再回答。",
+		"- 专业：给建议时说明理由，指出问题所在章节/段落，给出可直接落地的修改方案（改什么、怎么改）。",
+		"- 主动：作者说\"改一下\"，主动调用对应工具执行，不要只给建议不动手；执行前用一句话说明意图，执行后简短汇报结果。",
+		"- 忠于设定：以大纲、设定圣经、事实库为准，不得自相矛盾；发现问题（如剧情与设定冲突）主动指出。",
+		"- 中文回复；文字量适中，别啰嗦。",
 		"",
 		"使用规则（非常重要）：",
 		"- 当你想执行任何工具时，你的【整个回复】必须只包含动作指令标签，格式如下（不要有任何解释文字、不要用自然语言说\"我要去改\"，直接输出标签）：",
@@ -1833,7 +2217,7 @@ function assistantSystemPrompt(project) {
 		"- 如果工具执行失败（例如片段未找到），根据错误信息修正参数后自动重试一次，不要直接放弃或让作者手动操作。",
 		"- 修改前先向作者说明你要改什么、为什么；动作执行后简要汇报结果。",
 		"- 涉及删除类操作（删除章节、清空设定）必须等作者明确同意。",
-		"- 严格忠于设定圣经与大刚；不得自行发明与既有设定冲突的内容。",
+		"- 严格忠于设定圣经与大纲；不得自行发明与既有设定冲突的内容。",
 		"- 用中文回复。"
 	].join("\n");
 }
@@ -1851,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);
@@ -1862,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));
@@ -1872,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));
@@ -1910,9 +2313,9 @@ async function* executeAction(ctx, config, project, outputDir, name, args) {
 			chapter.error = void 0;
 			project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
 			saveProject(outputDir, project);
-			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);
@@ -1922,12 +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 "（正在生成章节摘要…）";
-			try {
-				await summarizeChapter(ctx, config, project, outputDir, no);
-			} catch {}
+			yield "（正在生成章节摘要与编年录…）";
 			try {
-				await extractFacts(ctx, config, project, outputDir, no);
+				await summarizeAndExtractFacts(ctx, config, project, outputDir, no);
 			} catch {}
 			yield "（正在 AI 审稿…）";
 			const report = await reviewChapter(ctx, config, project, outputDir, no);
@@ -2044,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);
@@ -2056,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
 	};
@@ -2085,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). */
@@ -2105,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();
@@ -2138,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,
@@ -2301,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
@@ -2384,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;
@@ -2480,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)
 			});
 		}
@@ -2682,14 +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);
-				}
-				try {
-					await extractFacts(ctx, config, project, config.outputDir, no);
-				} catch (error) {
-					console.warn("[dsh-novel-forge] facts extraction failed:", error.message);
+					console.warn("[dsh-novel-forge] summary/facts failed:", error.message);
 				}
 				if (!(body?.skipReview === true) && (config.autoReview ?? true)) send({
 					type: "review",
@@ -3019,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,
@@ -3078,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,
@@ -3095,6 +3582,8 @@ function makeRoutes(deps) {
 		foreshadowRoute,
 		exportRoute,
 		chapterRoute,
+		chapterCheckRoute,
+		chapterSaveRoute,
 		{
 			kind: "exact",
 			path: NOVEL_API.assets,
@@ -3176,6 +3665,7 @@ function makeRoutes(deps) {
 		},
 		assistantRoute,
 		assistantHistoryRoute,
+		assistantClearRoute,
 		{
 			kind: "exact",
 			path: NOVEL_API.bookshelf,
@@ -3339,7 +3829,7 @@ function makeRoutes(deps) {
 				const project = requireProject(res);
 				if (project === void 0) return;
 				if (project.bible === void 0) {
-					writeJson(res, 400, { error: "尚未生成设定圣经，请先生成" });
+					writeJson(res, 400, { error: "尚未生成道藏，请先生成" });
 					return;
 				}
 				const body = await readJsonBody(req);
@@ -3351,6 +3841,163 @@ function makeRoutes(deps) {
 				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,
@@ -3426,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 {