@waterwx/dsh-novel-forge 1.1.8 → 1.2.0

package/lib/index.js

@@ -3,147 +3,10 @@ import z from "schemastery";
 import { exec } from "node:child_process";
 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";
-//#region src/protocol.ts
-/**
-* dsh-novel-forge — shared protocol between the host half (Node) and the
-* browser half (web GUI). Route paths, request/response shapes, the project
-* state file format, and the NDJSON generation stream frames all live here so
-* both halves spell exactly one vocabulary.
-*/
-/** The /api/dsh-novel-forge route family (same-origin, loopback-fenced). */
-const NOVEL_API = {
-	status: "/api/dsh-novel-forge/status",
-	loadOutline: "/api/dsh-novel-forge/load-outline",
-	saveOutline: "/api/dsh-novel-forge/save-outline",
-	plan: "/api/dsh-novel-forge/plan",
-	volumes: "/api/dsh-novel-forge/volumes",
-	bible: "/api/dsh-novel-forge/bible",
-	assets: "/api/dsh-novel-forge/assets",
-	styleEngine: "/api/dsh-novel-forge/style-engine",
-	generate: "/api/dsh-novel-forge/generate",
-	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",
-	/** 剧情线管理：增删改 + 关联章节。 */
-	plotlines: "/api/dsh-novel-forge/plotlines",
-	/** 角色库：AI 提炼 / 采纳 / 更新 / 删除。 */
-	roles: "/api/dsh-novel-forge/roles",
-	/** 作者复盘补跑：对已写章节补齐 authorReview（全书流式 / 单章 JSON）。 */
-	reviewBackfill: "/api/dsh-novel-forge/review/backfill",
-	/** 章节复位：generating 卡死 → pending（可重新生成）。 */
-	chapterReset: "/api/dsh-novel-forge/chapter/reset",
-	/** 章节直接通过：作者对 rejected/written 章节行使最终决定权。 */
-	chapterApprove: "/api/dsh-novel-forge/chapter/approve",
-	/** 敏感词检查：全书已写章节或指定文本。 */
-	sensitiveCheck: "/api/dsh-novel-forge/sensitive-check",
-	/** 开书想法 → AI 补全大纲：输入一句话想法，生成 2-3 个可选大纲方案。 */
-	outlineSuggest: "/api/dsh-novel-forge/outline/suggest",
-	/** 拆书分析：对已写章节做结构/人物/文风/卖点四维体检（两阶段：源笔记→分节分析）。 */
-	breakdown: "/api/dsh-novel-forge/breakdown",
-	/** 漫剧分镜生成：章节 → 角色锚点 + 分镜表（可适配豆包/Seedance/SD）。 */
-	storyboard: "/api/dsh-novel-forge/storyboard",
-	/** 漫剧分集计划：读一卷 → 按故事弧线分集（高潮拆集/过渡并章）。 */
-	storyboardPlan: "/api/dsh-novel-forge/storyboard/plan",
-	config: "/api/dsh-novel-forge/config",
-	openFolder: "/api/dsh-novel-forge/open-folder"
-};
-//#endregion
-//#region src/docx.ts
-/**
-* docx outline extraction: a .docx is a zip whose word/document.xml holds the
-* body text in <w:t> runs inside <w:p> paragraphs. We unzip with fflate and
-* walk the XML with a tiny tokenizer — no heavyweight XML/DOM dependency.
-*/
-/** Decode the handful of XML entities docx bodies actually use. */
-function decodeEntities(text) {
-	return text.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, "\"").replace(/&apos;/g, "'").replace(/&amp;/g, "&").replace(/&nbsp;/g, " ");
-}
-/**
-* Extract plain text from a docx buffer: one line per <w:p> paragraph, with
-* <w:tab>/<w:br> preserved as whitespace. Tables and nested structures are
-* flattened in document order (their paragraphs are just <w:p> too).
-* @param buffer - the raw .docx bytes.
-* @returns the body text.
-*/
-function extractDocxText(buffer) {
-	let files;
-	try {
-		files = unzipSync(buffer);
-	} catch (error) {
-		throw new Error(`not a valid docx (zip open failed): ${error.message}`);
-	}
-	const document = files["word/document.xml"];
-	if (document === void 0) throw new Error("not a valid docx (word/document.xml missing)");
-	const xml = strFromU8(document);
-	const paragraphs = [];
-	const parts = xml.split(/<w:p\b[^>]*>/);
-	for (let i = 1; i < parts.length; i++) {
-		const segment = parts[i];
-		const runs = [];
-		for (const match of segment.matchAll(/<w:t(?:\s[^>]*)?>([\s\S]*?)<\/w:t>|<w:tab\b[^>]*\/>|<w:br\b[^>]*\/>/g)) if (match[0].startsWith("<w:tab")) runs.push("	");
-		else if (match[0].startsWith("<w:br")) runs.push("\n");
-		else runs.push(decodeEntities(match[1] ?? ""));
-		const line = runs.join("").replace(/\u00a0/g, " ").trimEnd();
-		paragraphs.push(line);
-	}
-	const text = paragraphs.join("\n").replace(/\n{3,}/g, "\n\n").trim();
-	if (text.length === 0) throw new Error("docx contains no extractable text");
-	return text;
-}
-/**
-* Read and extract a docx outline from disk.
-* @param path - absolute path to the .docx file.
-* @returns the extracted outline text.
-*/
-function readOutlineFromDocx(path) {
-	let buffer;
-	try {
-		buffer = readFileSync(path);
-	} catch (error) {
-		throw new Error(`cannot read outline file "${path}": ${error.message}`);
-	}
-	return extractDocxText(new Uint8Array(buffer));
-}
-//#endregion
+import { strFromU8, unzipSync } from "fflate";
 //#region src/assets.ts
 /** 预置写法模板（来自 AI-Novel-Writing-Assistant 内置 DEFAULT_STYLE_TEMPLATES）。 */
 const BUILTIN_STYLE_TEMPLATES = [
@@ -759,6 +622,22 @@ function styleEngineSystemPrompt() {
 * tracking, project persistence, and whole-book export. Pure Node (no
 * web-server dependencies), so routes stay thin and logic is testable.
 */
+/**
+* 内容合规红线（平台硬性要求）：所有书籍、所有章节无条件生效，
+* 优先级高于单书大纲/圣经中的任何设定与作者自定义红线。
+* 注入点：章节生成系统提示 + 审稿系统提示（命中即 high）。
+*/
+const COMPLIANCE_REDLINES = [
+	"1. 不得出现反对宪法所确定的基本原则的内容。",
+	"2. 不得出现危害国家安全、泄露国家秘密、颠覆国家政权、破坏国家统一的内容。",
+	"3. 不得出现危害国家荣誉和利益的内容。",
+	"4. 不得出现煽动民族仇恨、民族歧视、破坏民族团结的内容。",
+	"5. 不得出现破坏国家宗教政策、宣扬邪教和愚昧迷信的内容（不得以真实宗教、邪教或迷信活动为背景进行宣扬）。",
+	"6. 不得出现散布谣言、扰乱社会秩序、破坏社会稳定的内容。",
+	"7. 不得出现淫秽色情、赌博、暴力、凶杀、恐怖或教唆犯罪的内容（网文语境：禁止露骨性描写、血腥暴力渲染、赌博教唆、犯罪手法详细教学）。",
+	"8. 不得出现侮辱或者诽谤他人、侵害他人合法权益的内容（不得以真实人物、组织为原型进行侮辱或影射攻击）。",
+	"9. 不得出现法律法规禁止的其他内容。"
+];
 /** Project state file name inside the output dir. */
 const PROJECT_FILE = "novel-project.json";
 /** Sanitize a file name: keep CJK/alphanumerics/space/dash/underscore. */
@@ -1237,7 +1116,8 @@ async function complete(ctx, config, options) {
 		messages,
 		system: options.system,
 		maxTokens: options.maxTokens ?? config.maxTokens,
-		temperature: options.temperature ?? .7
+		temperature: options.temperature ?? .7,
+		reasoningEffort: ReasoningEffortId(config.reasoningEffort ?? "off")
 	};
 	const assembler = new BlockAssembler();
 	for await (const chunk of ctx.llm.stream(request)) assembler.push(chunk);
@@ -1509,6 +1389,14 @@ function writeSystemPrompt(project) {
 	sections.push("3. 尊重大纲与设定圣经：人设不崩、金手指规则不自相矛盾、战力不随意膨胀。");
 	sections.push("4. 章末留一个钩子（悬念、反转或新线索），吸引读者读下一章。");
 	sections.push("5. 语言流畅自然，符合中文网文语感，避免翻译腔与病句。");
+	sections.push("6. 对话与冲突密度：每章至少 1 处实质对话或正面对抗/交锋场面；推理与心理活动必须用动作、环境细节、微表情、对话呈现，禁止整章纯内心独白铺陈（禁止\"解说式\"交代线索）。");
+	sections.push("7. 反派与对手的行动力：本章出现的反派/对手必须有其行动、反制或压迫感（布局、试探、追索、交锋至少占其一），不得作为纯背景板存在。");
+	sections.push("8. 配角辨识度：重要新登场配角应给姓名或可辨识的独有特征；禁止通篇用\"瘦高个/灰衣人/戴面具者\"等身形标签代称同一角色。");
+	sections.push("9. 信息呈现方式：关键线索、设定、局势通过对话、动作、发现物呈现，禁止主角内心\"讲解\"给读者听。");
+	sections.push("");
+	sections.push("==================== 内容合规红线（平台硬性要求，最高优先级，违反即失败） ====================");
+	sections.push(COMPLIANCE_REDLINES.join("\n"));
+	sections.push("以上九条为硬性底线，任何情况下不得以任何形式出现或影射；若剧情确需涉及（如批判、反讽），只能以明确否定、揭露、批判的立场呈现，且不得展开细节。");
 	return sections.join("\n");
 }
 /**
@@ -1592,6 +1480,8 @@ function reviewSystemPrompt(project) {
 		"5. 节奏与爽点：本章是否有推进、有钩子，是否拖沓灌水。",
 		"6. 逻辑漏洞：前后矛盾、时间线错误、对话失真。",
 		"7. 反 AI 规则：逐条核对下方「反 AI 规则」清单，命中即列为问题。",
+		"8. 呈现方式：整章是否纯内心推理铺陈（无对话/无对抗，推理全靠解说）；反派是否纯背景板无行动；重要配角是否无名标签化（瘦高个/灰衣人全程代称）——命中即列为问题。",
+		"9. 内容合规（最高优先级）：逐条核对下方「内容合规红线」，任何一条命中（含影射、暗示、详细描写）必须列为 high，并给出改写建议。",
 		"输出必须是合法 JSON 对象，不要输出任何其他文字：",
 		"{\"score\": 0-100的整数, \"verdict\": \"一句话总评\", \"issues\": [{\"severity\": \"high|medium|low\", \"item\": \"问题描述\", \"suggestion\": \"修改建议\"}]}",
 		"重要：所有字符串值内部不得包含换行符，JSON 必须在一段内完整结束。",
@@ -1611,6 +1501,9 @@ function reviewSystemPrompt(project) {
 		}
 		if (bible.redLines.length > 0) sections.push("红线：\n" + bible.redLines.map((r) => `- ${r}`).join("\n"));
 	}
+	sections.push("\n==================== 内容合规红线（平台硬性要求，最高优先级） ====================");
+	sections.push(COMPLIANCE_REDLINES.join("\n"));
+	sections.push("以上九条为硬性底线：正文中任何一条命中（含影射、暗示、详细展开）都必须列为 high，并给出改写建议；作者自定义红线不得豁免这九条。");
 	return sections.join("\n");
 }
 /** Run the AI review on one chapter. */
@@ -2004,6 +1897,7 @@ async function suggestOutlines(ctx, config, idea, count = 3, exclude = []) {
 		].join("\n"),
 		user: [
 			`作者的想法：${idea}`,
+			idea.trim().length < 40 ? "作者的想法非常简短（可能只有一句）。请基于通用网文套路合理扩展补全：为每个方案自洽地设计金手指/核心设定、主角人设与动机、主线走向，使其成为完整可开书的大纲；不同方案的方向仍须明显差异。" : "",
 			exclude.length > 0 ? `需避开的已暂留方案方向（新方案不得与之雷同）：\n${exclude.map((e, i) => `${i + 1}. ${e}`).join("\n")}` : "",
 			`请生成 ${n} 个大纲方案。`,
 			"只输出 JSON 数组。"
@@ -2854,15 +2748,21 @@ async function auditBatch(ctx, config, project, outputDir, batch) {
 	return issues;
 }
 /** 全书一致性质检：LLM 分批扫描已生成章节 + 设定 + 事实库，聚合矛盾清单。 */
-async function auditBook(ctx, config, project, outputDir) {
+async function auditBook(ctx, config, project, outputDir, onProgress) {
 	const written = project.chapters.filter((c) => c.status !== "pending" && c.status !== "generating");
-	if (written.length === 0) return [];
+	if (written.length === 0) {
+		onProgress?.(0, 0);
+		return [];
+	}
+	const totalBatches = Math.ceil(written.length / AUDIT_BATCH_SIZE);
 	const all = [];
+	onProgress?.(0, totalBatches);
 	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 {}
+		onProgress?.(Math.min(Math.ceil((i + AUDIT_BATCH_SIZE) / AUDIT_BATCH_SIZE), totalBatches), totalBatches);
 	}
 	return all.slice(0, 50);
 }
@@ -3254,87 +3154,671 @@ function exportBook(outputDir, project, format) {
 	};
 }
 //#endregion
-//#region src/assistant.ts
+//#region src/bookshelf.ts
 /**
-* AI assistant engine — a conversational editor over the novel project.
-*
-* The user talks to the assistant about plot, characters, settings; the
-* assistant can reply in prose AND emit action directives that the host
-* executes (rewrite a paragraph, edit the bible, regenerate a chapter,
-* export the book, ...). Conversation history persists next to the project
-* as NDJSON, so a reload keeps the thread.
-*
-* Action protocol: the model emits a line of the form
-*   <dsh-action name="toolName">{jsonArgs}</dsh-action>
-* anywhere in its reply. The host strips it, executes the tool, appends the
-* result as a tool-role message, and continues the loop (bounded rounds).
+* 书架（Bookshelf）— 多书管理：一本书记录一个独立输出目录。
+* 状态持久化到 ~/.dsh/dsh-novel-forge-bookshelf.json（跟随 dsh 配置惯例）。
 */
-/** History file name inside the output dir. */
-const ASSISTANT_HISTORY_FILE = "novel-assistant.jsonl";
-/** Max tool-call rounds per user turn (safety bound). */
-const MAX_TOOL_ROUNDS = 6;
-/** Load the persisted conversation (empty when none). */
-function loadAssistantHistory(outputDir) {
-	const file = join(outputDir, ASSISTANT_HISTORY_FILE);
-	if (!existsSync(file)) return [];
-	const messages = [];
+/** 书架配置文件路径。 */
+function bookshelfFile() {
+	return join(homedir(), ".dsh", "dsh-novel-forge-bookshelf.json");
+}
+function defaultStore() {
+	return {
+		books: [],
+		activeBookId: null
+	};
+}
+/** 读取书架（无则返回空）。 */
+function loadBookshelf() {
+	const file = bookshelfFile();
+	if (!existsSync(file)) return defaultStore();
 	try {
-		for (const line of readFileSync(file, "utf8").split("\n")) {
-			if (line.trim() === "") continue;
-			try {
-				const parsed = JSON.parse(line);
-				if (typeof parsed.role === "string" && typeof parsed.content === "string") messages.push(parsed);
-			} catch {}
-		}
-	} catch {}
-	return messages;
+		let raw = readFileSync(file, "utf8");
+		if (raw.charCodeAt(0) === 65279) raw = raw.slice(1);
+		const parsed = JSON.parse(raw);
+		if (!Array.isArray(parsed.books)) return defaultStore();
+		return {
+			books: parsed.books,
+			activeBookId: parsed.activeBookId ?? null
+		};
+	} catch {
+		return defaultStore();
+	}
 }
-/** 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 });
-	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 saveBookshelf(store) {
+	const file = bookshelfFile();
+	mkdirSync(join(homedir(), ".dsh"), { recursive: true });
+	writeFileSync(file, JSON.stringify(store, null, 2), "utf8");
 }
-/** 清空助手对话记录（删除历史文件）。 */
-function clearAssistantHistory(outputDir) {
-	const file = join(outputDir, ASSISTANT_HISTORY_FILE);
-	if (existsSync(file)) rmSync(file, { force: true });
+/** 当前激活的书。 */
+function activeBook(store) {
+	return store.books.find((b) => b.id === store.activeBookId);
 }
-/** 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("【道藏】");
-		if (bible.genre !== "") sections.push(`题材基调：${bible.genre}`);
-		if (bible.worldRules.length > 0) sections.push("世界规则：\n" + bible.worldRules.map((r) => `- ${r}`).join("\n"));
-		if (bible.characters.length > 0) {
-			sections.push("角色卡：");
-			for (const card of bible.characters) {
-				const roleName = {
-					protagonist: "主角",
-					supporting: "配角",
-					antagonist: "反派",
-					other: "其他"
-				}[card.role];
-				sections.push(`- ${card.name}（${roleName}）：${card.traits.join("、")}${card.goals !== "" ? `；目标：${card.goals}` : ""}`);
-			}
-		}
-		if (bible.redLines.length > 0) sections.push("写作红线：\n" + bible.redLines.map((r) => `- ${r}`).join("\n"));
-	}
+/** 书架快照（含每本书的进度摘要）。 */
+function bookshelfSnapshot(store) {
+	return {
+		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,
+				hasCover,
+				blurb: project?.blurb
+			};
+		}),
+		activeBookId: store.activeBookId
+	};
+}
+/** 新建一本书（自动成为当前书）。 */
+function createBook(bookName, outputDir) {
+	const store = loadBookshelf();
+	const id = `book-${Date.now().toString(36)}-${randomBytes(3).toString("hex")}`;
+	const now = (/* @__PURE__ */ new Date()).toISOString();
+	const book = {
+		id,
+		bookName,
+		outputDir,
+		createdAt: now,
+		updatedAt: now
+	};
+	store.books.push(book);
+	store.activeBookId = id;
+	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;
+}
+/**
+* 播种：书架为空时，把指定输出目录下已有的项目自动登记为第一本书。
+* 兼容升级场景 —— 旧版插件直接在输出目录写项目，从未登记书架。
+* @param outputDir - 候选输出目录（通常为 settings 的默认输出目录）。
+* @returns 是否发生了播种。
+*/
+function seedBookshelfFromOutputDir(outputDir) {
+	if (loadBookshelf().books.length > 0) return false;
+	if (!existsSync(outputDir)) return false;
+	const hasProject = existsSync(join(outputDir, "novel-project.json"));
+	const hasChapters = existsSync(outputDir);
+	if (!hasProject && !hasChapters) return false;
+	createBook(loadProject(outputDir)?.bookName ?? outputDir.split(/[\\/]/).pop() ?? "未命名小说", outputDir);
+	return true;
+}
+/** 激活一本书。 */
+function activateBook(id) {
+	const store = loadBookshelf();
+	const book = store.books.find((b) => b.id === id);
+	if (book === void 0) return void 0;
+	store.activeBookId = id;
+	book.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+	saveBookshelf(store);
+	return book;
+}
+/** 移除一本书。 */
+function removeBook(id) {
+	const store = loadBookshelf();
+	const idx = store.books.findIndex((b) => b.id === id);
+	if (idx === -1) return false;
+	store.books.splice(idx, 1);
+	if (store.activeBookId === id) store.activeBookId = store.books[0]?.id ?? null;
+	saveBookshelf(store);
+	return true;
+}
+/** 当前书输出目录（无书架则 undefined，回退 settings）。 */
+function activeBookOutputDir() {
+	return activeBook(loadBookshelf())?.outputDir;
+}
+/** 默认输出目录推断：小说目录/书名。 */
+function defaultOutputDirFor(bookName) {
+	return join("D:\\ryan work\\harness\\novels", bookName.replace(/[\\/:*?"<>|]/g, "").trim().slice(0, 40) || "未命名小说");
+}
+//#endregion
+//#region src/run.ts
+/**
+* 生产单（Production Run）：批量章节生产的标准执行器。
+* 职责：计划补足 → 逐章生成（完整质量门）→ 被拒分级处理（豁免/修订+验证/待人工）→ 断点续跑。
+* 与路由层解耦：只依赖 engine 导出函数与磁盘状态，自身不碰 HTTP。
+* 串行纪律：单例执行器 + working 锁；每章重新从磁盘加载，写前合并易变字段。
+*/
+/** 生产单 checkpoint 文件名（放在书目录下）。 */
+function runStateFile(outputDir) {
+	return join(outputDir, "run-state.json");
+}
+var ProductionRunner = class {
+	deps;
+	state = null;
+	working = false;
+	pauseRequested = false;
+	stopRequested = false;
+	/** 生产单绑定目录（start 时快照；所有读写固定用它，防止运行中切书导致写错目录）。 */
+	bookDir = null;
+	constructor(deps) {
+		this.deps = deps;
+	}
+	/** 当前生产单状态（内存优先；web 重启后从磁盘恢复）。 */
+	status() {
+		if (this.state !== null) return this.state;
+		const candidates = [this.deps.getConfig().outputDir];
+		const bookshelf = loadBookshelf();
+		for (const b of bookshelf.books) if (!candidates.includes(b.outputDir)) candidates.push(b.outputDir);
+		for (const outputDir of candidates) {
+			const file = runStateFile(outputDir);
+			if (!existsSync(file)) continue;
+			try {
+				const raw = readFileSync(file, "utf8");
+				const parsed = JSON.parse(raw);
+				if (parsed?.runId === void 0) continue;
+				if (parsed.status === "running") parsed.status = "paused";
+				this.state = parsed;
+				this.bookDir = outputDir;
+				return this.state;
+			} catch {}
+		}
+		return null;
+	}
+	persist() {
+		if (this.state === null) return;
+		const outputDir = this.bookDir ?? this.deps.getConfig().outputDir;
+		mkdirSync(outputDir, { recursive: true });
+		writeFileSync(runStateFile(outputDir), JSON.stringify(this.state, null, 2), "utf8");
+	}
+	log(text) {
+		if (this.state === null) return;
+		this.state.log.push({
+			at: (/* @__PURE__ */ new Date()).toISOString(),
+			text
+		});
+		if (this.state.log.length > 300) this.state.log = this.state.log.slice(-300);
+		this.state.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+	}
+	/** 启动/续跑生产单：startNo..endNo 区间，endNo 超出计划时先自动补计划。 */
+	async start(startNo, endNo) {
+		const config = this.deps.getConfig();
+		if (this.working) throw new Error("生产单正在运行中，请先暂停或停止");
+		let project = loadProject(config.outputDir);
+		if (project === void 0) throw new Error("输出目录中没有项目");
+		if (endNo > project.chapters.length) {
+			const need = endNo - project.chapters.length;
+			this.log(`计划不足，追加 ${need} 章计划…`);
+			const chapters = await planChapters(this.deps.ctx, config, project, need, void 0, config.outputDir);
+			mergeVolatileFromDisk(config.outputDir, project);
+			project.chapters.push(...chapters);
+			project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+			saveProject(config.outputDir, project);
+			this.log(`计划已追加，全书 ${project.chapters.length} 章`);
+		}
+		this.state = {
+			runId: `run-${Date.now().toString(36)}`,
+			startNo,
+			endNo,
+			status: "running",
+			currentNo: startNo,
+			stats: {
+				generated: 0,
+				revised: 0,
+				exempted: 0,
+				regenerated: 0,
+				error: 0
+			},
+			pendingManual: [],
+			log: [],
+			startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+			updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+		};
+		this.pauseRequested = false;
+		this.stopRequested = false;
+		this.bookDir = config.outputDir;
+		this.working = true;
+		this.persist();
+		this.loop();
+		return this.state;
+	}
+	pause() {
+		this.pauseRequested = true;
+	}
+	resume() {
+		if (this.state === null || this.state.status !== "paused") return;
+		this.state.status = "running";
+		this.working = true;
+		this.pauseRequested = false;
+		this.stopRequested = false;
+		this.persist();
+		this.loop();
+	}
+	stop() {
+		this.stopRequested = true;
+	}
+	/** 主循环：从 currentNo 扫描到 endNo，逐章处理；支持暂停/停止。 */
+	async loop() {
+		const config = this.deps.getConfig();
+		const outputDir = this.bookDir ?? config.outputDir;
+		try {
+			while (this.state !== null) {
+				if (this.stopRequested) {
+					this.stopRequested = false;
+					this.state.status = "stopped";
+					this.log("生产单已停止");
+					this.persist();
+					break;
+				}
+				if (this.pauseRequested) {
+					this.pauseRequested = false;
+					this.state.status = "paused";
+					this.log("生产单已暂停（随时可继续）");
+					this.persist();
+					break;
+				}
+				const project = loadProject(outputDir);
+				if (project === void 0) {
+					this.state.status = "error";
+					this.state.error = "项目丢失";
+					this.persist();
+					break;
+				}
+				let next;
+				for (let no = this.state.currentNo; no <= this.state.endNo; no++) {
+					const ch = project.chapters.find((c) => c.no === no);
+					if (ch === void 0) continue;
+					if (ch.status === "approved") {
+						this.state.currentNo = no;
+						continue;
+					}
+					next = ch;
+					break;
+				}
+				if (next === void 0) {
+					this.state.status = "done";
+					this.log(`生产单完成：${this.state.startNo}-${this.state.endNo} 章处理完毕`);
+					this.persist();
+					break;
+				}
+				this.state.currentNo = next.no;
+				await this.processChapter(project, next);
+				this.persist();
+			}
+		} catch (error) {
+			if (this.state !== null) {
+				this.state.status = "error";
+				this.state.error = error.message;
+				this.log(`生产单异常：${error.message}`);
+				this.persist();
+			}
+		} finally {
+			this.working = false;
+		}
+	}
+	async processChapter(project, chapter) {
+		if (chapter.status === "pending" || chapter.status === "error" || chapter.status === "written") await this.produce(project, chapter);
+		else if (chapter.status === "rejected") await this.handleRejected(project, chapter);
+		else if (chapter.status === "generating") {
+			chapter.status = "pending";
+			await this.produce(project, chapter);
+		}
+	}
+	/** 完整质量门：生成 → 摘要+事实 → 伏笔标记 → 审稿 → 作者复盘。 */
+	async produce(project, chapter) {
+		const { ctx, getConfig } = this.deps;
+		const config = getConfig();
+		const outputDir = this.bookDir ?? config.outputDir;
+		const no = chapter.no;
+		const wasError = chapter.status === "error";
+		chapter.status = "generating";
+		chapter.error = void 0;
+		chapter.generatingAt = (/* @__PURE__ */ new Date()).toISOString();
+		mergeVolatileFromDisk(outputDir, project);
+		saveProject(outputDir, project);
+		this.log(wasError ? `第${no}章《${chapter.title}》重新生成…` : `第${no}章《${chapter.title}》生成…`);
+		try {
+			for await (const step of generateChapterStream(ctx, config, project, outputDir, no));
+			try {
+				await summarizeAndExtractFacts(ctx, config, project, outputDir, no);
+			} catch (e) {
+				console.warn("[dsh-novel-forge] run summary/facts:", e.message);
+			}
+			try {
+				markForeshadowPlanted(project, outputDir, no);
+			} catch (e) {
+				console.warn("[dsh-novel-forge] run foreshadow:", e.message);
+			}
+			if (config.autoReview ?? true) {
+				const report = await reviewChapter(ctx, config, project, outputDir, no);
+				if (this.state !== null) this.state.stats[wasError ? "regenerated" : "generated"]++;
+				this.log(`第${no}章 审稿 ${report.score}分 ${report.passed ? "✅ 通过" : "⚠️ 被拒"}`);
+			} else {
+				chapter.status = "approved";
+				mergeVolatileFromDisk(outputDir, project);
+				saveProject(outputDir, project);
+			}
+			if (config.autoAuthorReview ?? true) try {
+				const body = readChapterFile(outputDir, chapter);
+				if (body !== void 0) {
+					let prevTail = "";
+					if (no > 1) {
+						const prev = project.chapters.find((c) => c.no === no - 1);
+						if (prev !== void 0) prevTail = (readChapterFile(outputDir, prev) ?? "").replace(/^#.*$/m, "").trim().slice(-600);
+					}
+					const review = await authorReviewChapter(ctx, config, project, no, body, prevTail);
+					chapter.authorReview = review;
+					if (review.advancedLines !== void 0) autoLinkPlotlines(project, no, review.advancedLines);
+					mergeVolatileFromDisk(outputDir, project);
+					saveProject(outputDir, project);
+				}
+			} catch (e) {
+				console.warn("[dsh-novel-forge] run author review:", e.message);
+			}
+		} catch (error) {
+			chapter.status = "error";
+			chapter.error = error.message;
+			mergeVolatileFromDisk(outputDir, project);
+			saveProject(outputDir, project);
+			if (this.state !== null) this.state.stats.error++;
+			this.log(`第${no}章 失败：${error.message}`);
+		}
+	}
+	/** 被拒分级处理：无 high 豁免；有 high 按意见修订（最多 2 轮）+ 验证模式；仍不过 → 待人工。 */
+	async handleRejected(project, chapter) {
+		const { ctx, getConfig } = this.deps;
+		const config = getConfig();
+		const outputDir = this.bookDir ?? config.outputDir;
+		const no = chapter.no;
+		const highs = (chapter.review?.issues ?? []).filter((i) => i.severity === "high");
+		if (highs.length === 0) {
+			chapter.status = "approved";
+			project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+			saveProject(outputDir, project);
+			if (this.state !== null) this.state.stats.exempted++;
+			this.log(`第${no}章 豁免通过（无 high）`);
+			return;
+		}
+		this.log(`第${no}章 修订（${highs.length} 个 high）…`);
+		for (let round = 1; round <= 2; round++) {
+			const instr = "按审稿意见修订（优先处理）：\n" + highs.map((h) => `[${h.severity}] ${h.item}${h.suggestion !== "" ? `\n建议：${h.suggestion}` : ""}`).join("\n\n");
+			try {
+				for await (const step of rewriteChapterStream(ctx, config, project, outputDir, no, instr, void 0));
+			} catch (error) {
+				this.log(`第${no}章 第${round}轮修订出错：${error.message}`);
+				continue;
+			}
+			const fresh = loadProject(outputDir);
+			const freshCh = fresh?.chapters.find((c) => c.no === no);
+			const draft = freshCh?.pendingDraft;
+			if (draft === void 0 || draft.length < 50) {
+				this.log(`第${no}章 第${round}轮草稿缺失，重试`);
+				continue;
+			}
+			const verify = await reviewChapterText(ctx, config, fresh, draft, chapter.review);
+			const highs2 = (verify.issues ?? []).filter((i) => i.severity === "high");
+			if (verify.passed || highs2.length === 0) {
+				this.applyDraft(fresh, freshCh, draft, verify);
+				if (this.state !== null) this.state.stats.revised++;
+				this.log(`第${no}章 第${round}轮修订通过（${verify.score}分）`);
+				return;
+			}
+			this.log(`第${no}章 第${round}轮仍不过（${highs2.length} high）`);
+		}
+		if (this.state !== null) this.state.pendingManual.push(no);
+		this.log(`第${no}章 ⚠️ 两轮修订仍不过 → 保留草稿待人工`);
+	}
+	applyDraft(project, chapter, draft, report) {
+		const config = this.deps.getConfig();
+		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.chars = draft.length;
+		chapter.file = fileName;
+		if (typeof report.score === "number") {
+			chapter.review = report;
+			chapter.status = report.passed === true ? "approved" : "rejected";
+		} else {
+			chapter.status = "written";
+			chapter.review = void 0;
+		}
+		chapter.error = void 0;
+		project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+		saveProject(config.outputDir, project);
+	}
+};
+//#endregion
+//#region src/protocol.ts
+/**
+* dsh-novel-forge — shared protocol between the host half (Node) and the
+* browser half (web GUI). Route paths, request/response shapes, the project
+* state file format, and the NDJSON generation stream frames all live here so
+* both halves spell exactly one vocabulary.
+*/
+/** The /api/dsh-novel-forge route family (same-origin, loopback-fenced). */
+const NOVEL_API = {
+	status: "/api/dsh-novel-forge/status",
+	loadOutline: "/api/dsh-novel-forge/load-outline",
+	saveOutline: "/api/dsh-novel-forge/save-outline",
+	plan: "/api/dsh-novel-forge/plan",
+	volumes: "/api/dsh-novel-forge/volumes",
+	bible: "/api/dsh-novel-forge/bible",
+	assets: "/api/dsh-novel-forge/assets",
+	styleEngine: "/api/dsh-novel-forge/style-engine",
+	generate: "/api/dsh-novel-forge/generate",
+	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",
+	/** 剧情线管理：增删改 + 关联章节。 */
+	plotlines: "/api/dsh-novel-forge/plotlines",
+	/** 角色库：AI 提炼 / 采纳 / 更新 / 删除。 */
+	roles: "/api/dsh-novel-forge/roles",
+	/** 作者复盘补跑：对已写章节补齐 authorReview（全书流式 / 单章 JSON）。 */
+	reviewBackfill: "/api/dsh-novel-forge/review/backfill",
+	/** 章节复位：generating 卡死 → pending（可重新生成）。 */
+	chapterReset: "/api/dsh-novel-forge/chapter/reset",
+	/** 章节直接通过：作者对 rejected/written 章节行使最终决定权。 */
+	chapterApprove: "/api/dsh-novel-forge/chapter/approve",
+	/** 敏感词检查：全书已写章节或指定文本。 */
+	sensitiveCheck: "/api/dsh-novel-forge/sensitive-check",
+	/** 开书想法 → AI 补全大纲：输入一句话想法，生成 2-3 个可选大纲方案。 */
+	outlineSuggest: "/api/dsh-novel-forge/outline/suggest",
+	/** 拆书分析：对已写章节做结构/人物/文风/卖点四维体检（两阶段：源笔记→分节分析）。 */
+	breakdown: "/api/dsh-novel-forge/breakdown",
+	/** 漫剧分镜生成：章节 → 角色锚点 + 分镜表（可适配豆包/Seedance/SD）。 */
+	storyboard: "/api/dsh-novel-forge/storyboard",
+	/** 漫剧分集计划：读一卷 → 按故事弧线分集（高潮拆集/过渡并章）。 */
+	storyboardPlan: "/api/dsh-novel-forge/storyboard/plan",
+	/** 生产单：启动批量生产（计划补足 + 逐章生成 + 被拒分级处理）。 */
+	runStart: "/api/dsh-novel-forge/run/start",
+	/** 生产单控制：pause / resume / stop。 */
+	runControl: "/api/dsh-novel-forge/run/control",
+	/** 生产单状态（含进度统计与日志）。 */
+	runStatus: "/api/dsh-novel-forge/run/status",
+	config: "/api/dsh-novel-forge/config",
+	openFolder: "/api/dsh-novel-forge/open-folder"
+};
+//#endregion
+//#region src/docx.ts
+/**
+* docx outline extraction: a .docx is a zip whose word/document.xml holds the
+* body text in <w:t> runs inside <w:p> paragraphs. We unzip with fflate and
+* walk the XML with a tiny tokenizer — no heavyweight XML/DOM dependency.
+*/
+/** Decode the handful of XML entities docx bodies actually use. */
+function decodeEntities(text) {
+	return text.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, "\"").replace(/&apos;/g, "'").replace(/&amp;/g, "&").replace(/&nbsp;/g, " ");
+}
+/**
+* Extract plain text from a docx buffer: one line per <w:p> paragraph, with
+* <w:tab>/<w:br> preserved as whitespace. Tables and nested structures are
+* flattened in document order (their paragraphs are just <w:p> too).
+* @param buffer - the raw .docx bytes.
+* @returns the body text.
+*/
+function extractDocxText(buffer) {
+	let files;
+	try {
+		files = unzipSync(buffer);
+	} catch (error) {
+		throw new Error(`not a valid docx (zip open failed): ${error.message}`);
+	}
+	const document = files["word/document.xml"];
+	if (document === void 0) throw new Error("not a valid docx (word/document.xml missing)");
+	const xml = strFromU8(document);
+	const paragraphs = [];
+	const parts = xml.split(/<w:p\b[^>]*>/);
+	for (let i = 1; i < parts.length; i++) {
+		const segment = parts[i];
+		const runs = [];
+		for (const match of segment.matchAll(/<w:t(?:\s[^>]*)?>([\s\S]*?)<\/w:t>|<w:tab\b[^>]*\/>|<w:br\b[^>]*\/>/g)) if (match[0].startsWith("<w:tab")) runs.push("	");
+		else if (match[0].startsWith("<w:br")) runs.push("\n");
+		else runs.push(decodeEntities(match[1] ?? ""));
+		const line = runs.join("").replace(/\u00a0/g, " ").trimEnd();
+		paragraphs.push(line);
+	}
+	const text = paragraphs.join("\n").replace(/\n{3,}/g, "\n\n").trim();
+	if (text.length === 0) throw new Error("docx contains no extractable text");
+	return text;
+}
+/**
+* Read and extract a docx outline from disk.
+* @param path - absolute path to the .docx file.
+* @returns the extracted outline text.
+*/
+function readOutlineFromDocx(path) {
+	let buffer;
+	try {
+		buffer = readFileSync(path);
+	} catch (error) {
+		throw new Error(`cannot read outline file "${path}": ${error.message}`);
+	}
+	return extractDocxText(new Uint8Array(buffer));
+}
+//#endregion
+//#region src/assistant.ts
+/**
+* AI assistant engine — a conversational editor over the novel project.
+*
+* The user talks to the assistant about plot, characters, settings; the
+* assistant can reply in prose AND emit action directives that the host
+* executes (rewrite a paragraph, edit the bible, regenerate a chapter,
+* export the book, ...). Conversation history persists next to the project
+* as NDJSON, so a reload keeps the thread.
+*
+* Action protocol: the model emits a line of the form
+*   <dsh-action name="toolName">{jsonArgs}</dsh-action>
+* anywhere in its reply. The host strips it, executes the tool, appends the
+* result as a tool-role message, and continues the loop (bounded rounds).
+*/
+/** History file name inside the output dir. */
+const ASSISTANT_HISTORY_FILE = "novel-assistant.jsonl";
+/** Max tool-call rounds per user turn (safety bound). */
+const MAX_TOOL_ROUNDS = 6;
+/** Load the persisted conversation (empty when none). */
+function loadAssistantHistory(outputDir) {
+	const file = join(outputDir, ASSISTANT_HISTORY_FILE);
+	if (!existsSync(file)) return [];
+	const messages = [];
+	try {
+		for (const line of readFileSync(file, "utf8").split("\n")) {
+			if (line.trim() === "") continue;
+			try {
+				const parsed = JSON.parse(line);
+				if (typeof parsed.role === "string" && typeof parsed.content === "string") messages.push(parsed);
+			} catch {}
+		}
+	} catch {}
+	return messages;
+}
+/** 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 });
+	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("【道藏】");
+		if (bible.genre !== "") sections.push(`题材基调：${bible.genre}`);
+		if (bible.worldRules.length > 0) sections.push("世界规则：\n" + bible.worldRules.map((r) => `- ${r}`).join("\n"));
+		if (bible.characters.length > 0) {
+			sections.push("角色卡：");
+			for (const card of bible.characters) {
+				const roleName = {
+					protagonist: "主角",
+					supporting: "配角",
+					antagonist: "反派",
+					other: "其他"
+				}[card.role];
+				sections.push(`- ${card.name}（${roleName}）：${card.traits.join("、")}${card.goals !== "" ? `；目标：${card.goals}` : ""}`);
+			}
+		}
+		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("【大世界】");
@@ -3955,168 +4439,35 @@ async function* runAssistantTurn(ctx, config, project, outputDir, userMessage) {
 		history.push({
 			role: "tool",
 			content: result,
-			tool: name,
-			ts: (/* @__PURE__ */ new Date()).toISOString()
-		});
-		appendHistory(outputDir, {
-			role: "tool",
-			content: result,
-			tool: name,
-			ts: (/* @__PURE__ */ new Date()).toISOString()
-		});
-		round++;
-		if (round >= MAX_TOOL_ROUNDS) {
-			const message = `（已连续执行 ${round} 次修改操作，本轮停止。如需继续请再说。）`;
-			history.push({
-				role: "assistant",
-				content: message,
-				ts: (/* @__PURE__ */ new Date()).toISOString()
-			});
-			appendHistory(outputDir, {
-				role: "assistant",
-				content: message,
-				ts: (/* @__PURE__ */ new Date()).toISOString()
-			});
-			yield {
-				frame: "delta",
-				text: message
-			};
-			return;
-		}
-	}
-}
-//#endregion
-//#region src/bookshelf.ts
-/**
-* 书架（Bookshelf）— 多书管理：一本书记录一个独立输出目录。
-* 状态持久化到 ~/.dsh/dsh-novel-forge-bookshelf.json（跟随 dsh 配置惯例）。
-*/
-/** 书架配置文件路径。 */
-function bookshelfFile() {
-	return join(homedir(), ".dsh", "dsh-novel-forge-bookshelf.json");
-}
-function defaultStore() {
-	return {
-		books: [],
-		activeBookId: null
-	};
-}
-/** 读取书架（无则返回空）。 */
-function loadBookshelf() {
-	const file = bookshelfFile();
-	if (!existsSync(file)) return defaultStore();
-	try {
-		let raw = readFileSync(file, "utf8");
-		if (raw.charCodeAt(0) === 65279) raw = raw.slice(1);
-		const parsed = JSON.parse(raw);
-		if (!Array.isArray(parsed.books)) return defaultStore();
-		return {
-			books: parsed.books,
-			activeBookId: parsed.activeBookId ?? null
-		};
-	} catch {
-		return defaultStore();
-	}
-}
-/** 持久化书架。 */
-function saveBookshelf(store) {
-	const file = bookshelfFile();
-	mkdirSync(join(homedir(), ".dsh"), { recursive: true });
-	writeFileSync(file, JSON.stringify(store, null, 2), "utf8");
-}
-/** 当前激活的书。 */
-function activeBook(store) {
-	return store.books.find((b) => b.id === store.activeBookId);
-}
-/** 书架快照（含每本书的进度摘要）。 */
-function bookshelfSnapshot(store) {
-	return {
-		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,
-				hasCover,
-				blurb: project?.blurb
-			};
-		}),
-		activeBookId: store.activeBookId
-	};
-}
-/** 新建一本书（自动成为当前书）。 */
-function createBook(bookName, outputDir) {
-	const store = loadBookshelf();
-	const id = `book-${Date.now().toString(36)}-${randomBytes(3).toString("hex")}`;
-	const now = (/* @__PURE__ */ new Date()).toISOString();
-	const book = {
-		id,
-		bookName,
-		outputDir,
-		createdAt: now,
-		updatedAt: now
-	};
-	store.books.push(book);
-	store.activeBookId = id;
-	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;
-}
-/**
-* 播种：书架为空时，把指定输出目录下已有的项目自动登记为第一本书。
-* 兼容升级场景 —— 旧版插件直接在输出目录写项目，从未登记书架。
-* @param outputDir - 候选输出目录（通常为 settings 的默认输出目录）。
-* @returns 是否发生了播种。
-*/
-function seedBookshelfFromOutputDir(outputDir) {
-	if (loadBookshelf().books.length > 0) return false;
-	if (!existsSync(outputDir)) return false;
-	const hasProject = existsSync(join(outputDir, "novel-project.json"));
-	const hasChapters = existsSync(outputDir);
-	if (!hasProject && !hasChapters) return false;
-	createBook(loadProject(outputDir)?.bookName ?? outputDir.split(/[\\/]/).pop() ?? "未命名小说", outputDir);
-	return true;
-}
-/** 激活一本书。 */
-function activateBook(id) {
-	const store = loadBookshelf();
-	const book = store.books.find((b) => b.id === id);
-	if (book === void 0) return void 0;
-	store.activeBookId = id;
-	book.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-	saveBookshelf(store);
-	return book;
-}
-/** 移除一本书。 */
-function removeBook(id) {
-	const store = loadBookshelf();
-	const idx = store.books.findIndex((b) => b.id === id);
-	if (idx === -1) return false;
-	store.books.splice(idx, 1);
-	if (store.activeBookId === id) store.activeBookId = store.books[0]?.id ?? null;
-	saveBookshelf(store);
-	return true;
-}
-/** 当前书输出目录（无书架则 undefined，回退 settings）。 */
-function activeBookOutputDir() {
-	return activeBook(loadBookshelf())?.outputDir;
-}
-/** 默认输出目录推断：桌面/书名。 */
-function defaultOutputDirFor(bookName) {
-	const clean = bookName.replace(/[\\/:*?"<>|]/g, "").trim().slice(0, 40) || "未命名小说";
-	return join(homedir(), "Desktop", clean);
+			tool: name,
+			ts: (/* @__PURE__ */ new Date()).toISOString()
+		});
+		appendHistory(outputDir, {
+			role: "tool",
+			content: result,
+			tool: name,
+			ts: (/* @__PURE__ */ new Date()).toISOString()
+		});
+		round++;
+		if (round >= MAX_TOOL_ROUNDS) {
+			const message = `（已连续执行 ${round} 次修改操作，本轮停止。如需继续请再说。）`;
+			history.push({
+				role: "assistant",
+				content: message,
+				ts: (/* @__PURE__ */ new Date()).toISOString()
+			});
+			appendHistory(outputDir, {
+				role: "assistant",
+				content: message,
+				ts: (/* @__PURE__ */ new Date()).toISOString()
+			});
+			yield {
+				frame: "delta",
+				text: message
+			};
+			return;
+		}
+	}
 }
 //#endregion
 //#region src/routes.ts
@@ -4178,6 +4529,12 @@ const DEFAULT_PLAN_COUNT = 30;
 */
 function makeRoutes(deps) {
 	const { ctx, getConfig, patchConfig } = deps;
+	/** 全书质检实时状态（内存态，重启后回到 idle；用于 /status 暴露进度）。 */
+	let auditState = {
+		status: "idle",
+		totalBatches: 0,
+		completedBatches: 0
+	};
 	/** Guard helper: fence + method check. */
 	const guard = (req, res, method) => {
 		if (!isLoopbackRequest(req)) {
@@ -4229,7 +4586,8 @@ function makeRoutes(deps) {
 					...project,
 					facts: (project.facts ?? []).slice(-80)
 				} : void 0,
-				generatedFiles: listChapterFiles(config.outputDir)
+				generatedFiles: listChapterFiles(config.outputDir),
+				audit: auditState
 			});
 		}
 	};
@@ -5134,13 +5492,41 @@ function makeRoutes(deps) {
 			const config = getConfig();
 			const project = requireProject(res);
 			if (project === void 0) return;
+			const startedAt = (/* @__PURE__ */ new Date()).toISOString();
+			auditState = {
+				status: "running",
+				startedAt,
+				totalBatches: 0,
+				completedBatches: 0
+			};
 			try {
+				const issues = await auditBook(ctx, config, project, config.outputDir, (completed, total) => {
+					auditState.totalBatches = total;
+					auditState.completedBatches = completed;
+				});
+				const auditedChapters = project.chapters.filter((c) => c.status !== "pending" && c.status !== "generating").length;
+				auditState = {
+					status: "done",
+					startedAt,
+					finishedAt: (/* @__PURE__ */ new Date()).toISOString(),
+					totalBatches: auditState.totalBatches,
+					completedBatches: auditState.totalBatches,
+					auditedChapters,
+					issuesCount: issues.length,
+					issues
+				};
 				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()
+					issues,
+					auditedChapters,
+					auditedAt: auditState.finishedAt
 				});
 			} catch (error) {
+				auditState = {
+					...auditState,
+					status: "error",
+					finishedAt: (/* @__PURE__ */ new Date()).toISOString(),
+					error: error.message
+				};
 				writeJson(res, 500, { error: error.message });
 			}
 		}
@@ -5651,6 +6037,208 @@ function makeRoutes(deps) {
 			});
 		}
 	};
+	/** 作者复盘补跑：对已写章节补齐 authorReview（body.chapterNo=单章 JSON，缺省=全书 NDJSON 流）。 */
+	const reviewBackfillRoute = {
+		kind: "exact",
+		path: NOVEL_API.reviewBackfill,
+		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);
+			/** 对一章执行作者复盘（读取已落盘正文，不改变章节状态/正文）。 */
+			const runOne = async (chapter) => {
+				const currentBody = readChapterFile(config.outputDir, chapter);
+				if (currentBody === void 0) throw new Error(`章节 ${chapter.no} 的正文文件不存在`);
+				let prevTail = "";
+				if (chapter.no > 1) {
+					const prev = project.chapters.find((c) => c.no === chapter.no - 1);
+					if (prev !== void 0) prevTail = (readChapterFile(config.outputDir, prev) ?? "").replace(/^#.*$/m, "").trim().slice(-600);
+				}
+				return authorReviewChapter(ctx, config, project, chapter.no, currentBody, prevTail);
+			};
+			if (typeof body?.chapterNo === "number" && body.chapterNo > 0) {
+				const chapter = project.chapters.find((c) => c.no === body.chapterNo);
+				if (chapter === void 0) {
+					writeJson(res, 404, { error: `章节 ${body.chapterNo} 不在计划中` });
+					return;
+				}
+				if (chapter.status === "pending") {
+					writeJson(res, 400, { error: "该章尚未生成正文，无法复盘" });
+					return;
+				}
+				try {
+					const review = await runOne(chapter);
+					chapter.authorReview = review;
+					if (review.advancedLines !== void 0) autoLinkPlotlines(project, chapter.no, review.advancedLines);
+					project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+					saveProject(config.outputDir, project);
+					writeJson(res, 200, {
+						no: chapter.no,
+						review
+					});
+					return;
+				} catch (error) {
+					writeJson(res, 500, { error: error.message });
+					return;
+				}
+			}
+			const missing = project.chapters.filter((c) => c.status !== "pending" && c.status !== "generating" && c.status !== "error" && c.authorReview === void 0);
+			if (missing.length === 0) {
+				writeJson(res, 200, { count: 0 });
+				return;
+			}
+			res.writeHead(200, {
+				"content-type": "application/x-ndjson; charset=utf-8",
+				"cache-control": "no-cache",
+				"referrer-policy": "no-referrer"
+			});
+			const send = (frame) => {
+				res.write(JSON.stringify(frame) + "\n");
+			};
+			let done = 0;
+			for (const chapter of missing) try {
+				const review = await runOne(chapter);
+				chapter.authorReview = review;
+				if (review.advancedLines !== void 0) autoLinkPlotlines(project, chapter.no, review.advancedLines);
+				done++;
+				saveProject(config.outputDir, project);
+				send({
+					type: "author-review",
+					no: chapter.no,
+					review
+				});
+			} catch (error) {
+				console.warn(`[dsh-novel-forge] author backfill ch.${chapter.no} failed:`, error.message);
+			}
+			project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+			saveProject(config.outputDir, project);
+			send({
+				type: "author-backfill-done",
+				count: done
+			});
+			res.end();
+		}
+	};
+	const configRoute = {
+		kind: "exact",
+		path: NOVEL_API.config,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const body = await readJsonBody(req);
+			if (body === void 0) {
+				writeJson(res, 400, { error: "无效的配置 JSON" });
+				return;
+			}
+			try {
+				writeJson(res, 200, { config: await patchConfig(body) });
+			} catch (error) {
+				writeJson(res, 400, { error: error.message });
+			}
+		}
+	};
+	const openFolderRoute = {
+		kind: "exact",
+		path: NOVEL_API.openFolder,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const dir = getConfig().outputDir;
+			exec(`explorer "${dir.replace(/"/g, "")}"`, (error) => {
+				if (error) writeJson(res, 500, {
+					ok: false,
+					error: error.message
+				});
+				else writeJson(res, 200, { ok: true });
+			});
+		}
+	};
+	/** 开书想法 → AI 大纲：2-3 个可选方案（支持暂留换批：count 只补空槽 + exclude 避开已留方向）。 */
+	const outlineSuggestRoute = {
+		kind: "exact",
+		path: NOVEL_API.outlineSuggest,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const config = getConfig();
+			const body = await readJsonBody(req);
+			const idea = body?.idea?.trim() ?? "";
+			if (idea.length < 50) {
+				writeJson(res, 400, { error: "想法太短（<50 字），请多写一两句：主角是谁、什么世界、想要什么爽点" });
+				return;
+			}
+			const count = body?.count !== void 0 ? Math.max(1, Math.min(3, Math.floor(body.count))) : 3;
+			const exclude = Array.isArray(body?.exclude) ? body.exclude.filter((e) => typeof e === "string" && e.trim() !== "").map((e) => e.trim().slice(0, 200)) : [];
+			try {
+				writeJson(res, 200, { candidates: await suggestOutlines(ctx, config, idea, count, exclude) });
+			} catch (error) {
+				writeJson(res, 500, { error: `大纲方案生成失败：${error.message}` });
+			}
+		}
+	};
+	/** 拆书分析：对已写章节做结构/人物/文风/卖点体检（两阶段：源笔记→分节分析）。 */
+	const breakdownRoute = {
+		kind: "exact",
+		path: NOVEL_API.breakdown,
+		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 {
+				writeJson(res, 200, await breakdownBook(ctx, config, project, config.outputDir, body?.scope ?? "recent", body?.preset ?? "quick", body?.budgetTokens ?? 5e4));
+			} catch (error) {
+				writeJson(res, 500, { error: `拆书分析失败：${error.message}` });
+			}
+		}
+	};
+	/** 漫剧分镜生成：章节 → 角色锚点 + 分镜表（适配豆包/Seedance/SD）。 */
+	const storyboardRoute = {
+		kind: "exact",
+		path: NOVEL_API.storyboard,
+		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;
+			}
+			try {
+				writeJson(res, 200, await generateStoryboard(ctx, config, project, config.outputDir, body.chapterNo, body?.genre ?? "", body?.platform ?? "抖音", body?.tool ?? "doubao"));
+			} catch (error) {
+				writeJson(res, 500, { error: `分镜生成失败：${error.message}` });
+			}
+		}
+	};
+	/** 漫剧分集计划：读一卷 → 按故事弧线分集（高潮拆集/过渡并章）。 */
+	const storyboardPlanRoute = {
+		kind: "exact",
+		path: NOVEL_API.storyboardPlan,
+		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?.volumeNo) || (body?.volumeNo ?? 0) < 1) {
+				writeJson(res, 400, { error: "volumeNo 须为正整数" });
+				return;
+			}
+			try {
+				writeJson(res, 200, await planStoryboardEpisodes(ctx, config, project, body.volumeNo, body?.platform ?? "抖音", body?.maxEpisodes ?? 25));
+			} catch (error) {
+				writeJson(res, 500, { error: `分集计划生成失败：${error.message}` });
+			}
+		}
+	};
+	/** 生产单执行器（单例）：计划补足 → 逐章生成 → 被拒分级处理 → 断点续跑。 */
+	const runner = new ProductionRunner({
+		ctx,
+		getConfig
+	});
 	return [
 		statusRoute,
 		loadOutlineRoute,
@@ -5690,198 +6278,67 @@ function makeRoutes(deps) {
 		plotlinesRoute,
 		rolesRoute,
 		sensitiveRoute,
-		{
-			kind: "exact",
-			path: NOVEL_API.reviewBackfill,
-			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);
-				/** 对一章执行作者复盘（读取已落盘正文，不改变章节状态/正文）。 */
-				const runOne = async (chapter) => {
-					const currentBody = readChapterFile(config.outputDir, chapter);
-					if (currentBody === void 0) throw new Error(`章节 ${chapter.no} 的正文文件不存在`);
-					let prevTail = "";
-					if (chapter.no > 1) {
-						const prev = project.chapters.find((c) => c.no === chapter.no - 1);
-						if (prev !== void 0) prevTail = (readChapterFile(config.outputDir, prev) ?? "").replace(/^#.*$/m, "").trim().slice(-600);
-					}
-					return authorReviewChapter(ctx, config, project, chapter.no, currentBody, prevTail);
-				};
-				if (typeof body?.chapterNo === "number" && body.chapterNo > 0) {
-					const chapter = project.chapters.find((c) => c.no === body.chapterNo);
-					if (chapter === void 0) {
-						writeJson(res, 404, { error: `章节 ${body.chapterNo} 不在计划中` });
-						return;
-					}
-					if (chapter.status === "pending") {
-						writeJson(res, 400, { error: "该章尚未生成正文，无法复盘" });
-						return;
-					}
-					try {
-						const review = await runOne(chapter);
-						chapter.authorReview = review;
-						if (review.advancedLines !== void 0) autoLinkPlotlines(project, chapter.no, review.advancedLines);
-						project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-						saveProject(config.outputDir, project);
-						writeJson(res, 200, {
-							no: chapter.no,
-							review
-						});
-						return;
-					} catch (error) {
-						writeJson(res, 500, { error: error.message });
-						return;
-					}
-				}
-				const missing = project.chapters.filter((c) => c.status !== "pending" && c.status !== "generating" && c.authorReview === void 0);
-				if (missing.length === 0) {
-					writeJson(res, 200, { count: 0 });
-					return;
-				}
-				res.writeHead(200, {
-					"content-type": "application/x-ndjson; charset=utf-8",
-					"cache-control": "no-cache",
-					"referrer-policy": "no-referrer"
-				});
-				const send = (frame) => {
-					res.write(JSON.stringify(frame) + "\n");
-				};
-				let done = 0;
-				for (const chapter of missing) try {
-					const review = await runOne(chapter);
-					chapter.authorReview = review;
-					if (review.advancedLines !== void 0) autoLinkPlotlines(project, chapter.no, review.advancedLines);
-					done++;
-					saveProject(config.outputDir, project);
-					send({
-						type: "author-review",
-						no: chapter.no,
-						review
-					});
-				} catch (error) {
-					console.warn(`[dsh-novel-forge] author backfill ch.${chapter.no} failed:`, error.message);
-				}
-				project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-				saveProject(config.outputDir, project);
-				send({
-					type: "author-backfill-done",
-					count: done
-				});
-				res.end();
-			}
-		},
+		reviewBackfillRoute,
 		chapterResetRoute,
 		chapterApproveRoute,
+		configRoute,
+		openFolderRoute,
+		outlineSuggestRoute,
+		breakdownRoute,
+		storyboardRoute,
+		storyboardPlanRoute,
 		{
 			kind: "exact",
-			path: NOVEL_API.config,
+			path: NOVEL_API.runStart,
 			handler: async (req, res) => {
 				if (!guard(req, res, "POST")) return;
 				const body = await readJsonBody(req);
-				if (body === void 0) {
-					writeJson(res, 400, { error: "无效的配置 JSON" });
+				const project = loadProject(getConfig().outputDir);
+				if (project === void 0) {
+					writeJson(res, 400, { error: "输出目录中没有项目" });
 					return;
 				}
-				try {
-					writeJson(res, 200, { config: await patchConfig(body) });
-				} catch (error) {
-					writeJson(res, 400, { error: error.message });
-				}
-			}
-		},
-		{
-			kind: "exact",
-			path: NOVEL_API.openFolder,
-			handler: async (req, res) => {
-				if (!guard(req, res, "POST")) return;
-				const dir = getConfig().outputDir;
-				exec(`explorer "${dir.replace(/"/g, "")}"`, (error) => {
-					if (error) writeJson(res, 500, {
-						ok: false,
-						error: error.message
-					});
-					else writeJson(res, 200, { ok: true });
-				});
-			}
-		},
-		{
-			kind: "exact",
-			path: NOVEL_API.outlineSuggest,
-			handler: async (req, res) => {
-				if (!guard(req, res, "POST")) return;
-				const config = getConfig();
-				const body = await readJsonBody(req);
-				const idea = body?.idea?.trim() ?? "";
-				if (idea.length < 50) {
-					writeJson(res, 400, { error: "想法太短（<50 字），请多写一两句：主角是谁、什么世界、想要什么爽点" });
+				const startNo = Number.isInteger(body?.startNo) && body.startNo >= 1 ? body.startNo : 1;
+				let endNo;
+				if (Number.isInteger(body?.endNo) && body.endNo >= startNo) endNo = body.endNo;
+				else if (Number.isInteger(body?.count) && body.count >= 1 && body.count <= 200) endNo = Math.max(0, ...project.chapters.map((c) => c.no)) + body.count;
+				else {
+					writeJson(res, 400, { error: "请提供 endNo 或 count（1-200）" });
 					return;
 				}
-				const count = body?.count !== void 0 ? Math.max(1, Math.min(3, Math.floor(body.count))) : 3;
-				const exclude = Array.isArray(body?.exclude) ? body.exclude.filter((e) => typeof e === "string" && e.trim() !== "").map((e) => e.trim().slice(0, 200)) : [];
-				try {
-					writeJson(res, 200, { candidates: await suggestOutlines(ctx, config, idea, count, exclude) });
-				} catch (error) {
-					writeJson(res, 500, { error: `大纲方案生成失败：${error.message}` });
-				}
-			}
-		},
-		{
-			kind: "exact",
-			path: NOVEL_API.breakdown,
-			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 {
-					writeJson(res, 200, await breakdownBook(ctx, config, project, config.outputDir, body?.scope ?? "recent", body?.preset ?? "quick", body?.budgetTokens ?? 5e4));
+					writeJson(res, 200, await runner.start(startNo, endNo));
 				} catch (error) {
-					writeJson(res, 500, { error: `拆书分析失败：${error.message}` });
+					writeJson(res, 409, { error: error.message });
 				}
 			}
 		},
 		{
 			kind: "exact",
-			path: NOVEL_API.storyboard,
+			path: NOVEL_API.runControl,
 			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 须为正整数" });
+				if (runner.status() === null) {
+					writeJson(res, 400, { error: "没有生产单" });
 					return;
 				}
-				try {
-					writeJson(res, 200, await generateStoryboard(ctx, config, project, config.outputDir, body.chapterNo, body?.genre ?? "", body?.platform ?? "抖音", body?.tool ?? "doubao"));
-				} catch (error) {
-					writeJson(res, 500, { error: `分镜生成失败：${error.message}` });
+				if (body?.action === "pause") runner.pause();
+				else if (body?.action === "resume") runner.resume();
+				else if (body?.action === "stop") runner.stop();
+				else {
+					writeJson(res, 400, { error: "action 须为 pause / resume / stop" });
+					return;
 				}
+				writeJson(res, 200, runner.status());
 			}
 		},
 		{
 			kind: "exact",
-			path: NOVEL_API.storyboardPlan,
-			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?.volumeNo) || (body?.volumeNo ?? 0) < 1) {
-					writeJson(res, 400, { error: "volumeNo 须为正整数" });
-					return;
-				}
-				try {
-					writeJson(res, 200, await planStoryboardEpisodes(ctx, config, project, body.volumeNo, body?.platform ?? "抖音", body?.maxEpisodes ?? 25));
-				} catch (error) {
-					writeJson(res, 500, { error: `分集计划生成失败：${error.message}` });
-				}
+			path: NOVEL_API.runStatus,
+			handler: (req, res) => {
+				if (!guard(req, res, "GET")) return;
+				writeJson(res, 200, runner.status());
 			}
 		}
 	];
@@ -5905,10 +6362,16 @@ const NOVEL_SETTINGS_NAMESPACE = settingsNamespace("dsh-novel-forge");
 const Config = z.object({
 	announceToAgent: z.boolean().default(true),
 	enabled: z.boolean().default(true),
-	outlinePath: z.string().default("C:\\Users\\Ryan\\Desktop\\《归墟玉主》全书大纲_重新排版版.docx"),
-	outputDir: z.string().default("C:\\Users\\Ryan\\Desktop\\归墟玉主"),
+	outlinePath: z.string().default("D:\\ryan work\\harness\\novels\\归墟玉主\\《归墟玉主》全书大纲_重新排版版.docx"),
+	outputDir: z.string().default("D:\\ryan work\\harness\\novels\\归墟玉主"),
 	provider: z.string().default("deepseek-official"),
 	model: z.string().default("deepseek-v4-flash"),
+	reasoningEffort: z.union([
+		"off",
+		"low",
+		"high",
+		"max"
+	]).default("off"),
 	chapterChars: z.number().default(3500),
 	maxTokens: z.number().default(12e3),
 	reviewPassScore: z.number().default(70),
@@ -5918,10 +6381,11 @@ const Config = z.object({
 });
 /** Schema defaults, re-read for hand-built test contexts. */
 const DEFAULT_ANNOUNCE = true;
-const DEFAULT_OUTLINE_PATH = "C:\\Users\\Ryan\\Desktop\\《归墟玉主》全书大纲_重新排版版.docx";
-const DEFAULT_OUTPUT_DIR = "C:\\Users\\Ryan\\Desktop\\归墟玉主";
+const DEFAULT_OUTLINE_PATH = "D:\\ryan work\\harness\\novels\\归墟玉主\\《归墟玉主》全书大纲_重新排版版.docx";
+const DEFAULT_OUTPUT_DIR = "D:\\ryan work\\harness\\novels\\归墟玉主";
 const DEFAULT_PROVIDER = "deepseek-official";
 const DEFAULT_MODEL = "deepseek-v4-flash";
+const DEFAULT_REASONING_EFFORT = "off";
 const DEFAULT_CHAPTER_CHARS = 3500;
 const DEFAULT_MAX_TOKENS = 12e3;
 const DEFAULT_REVIEW_PASS_SCORE = 70;
@@ -5931,7 +6395,7 @@ const DEFAULT_AUTO_REVIEW_AFTER_REVISE = 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 大纲（默认 D:\\ryan work\\harness\\novels\\归墟玉主 大纲）或粘贴大纲文本；用 LLM 提炼道藏（人设/世界观/金手指规则/写作红线，即设定圣经）；生成卷计划与章节计划；逐章调用 LLM 生成 3000-4000 字正文并保存为 Markdown（默认输出到 D:\\ryan work\\harness\\novels\\归墟玉主）；每章自动生成摘要（叙事记忆）、自动 AI 审稿（人设/设定/红线/文笔/爽点/逻辑），支持按审稿意见重写、去 AI 味润色、暗线（伏笔）管理、批量连写与全本导出（txt/md）。限制：生成消耗 LLM API 额度；输出目录与模型可在插件设置中修改；章节正文质量取决于大纲完整度。用户提到「小说 / 大纲 / 写小说 / 章节 / 审稿 / 润色 / 归墟玉主」时即指本插件，请据此协作。";
 /** Resolve a config-like value into the full runtime config. */
 function resolveConfig(value) {
 	return {
@@ -5939,6 +6403,7 @@ function resolveConfig(value) {
 		outputDir: value?.outputDir ?? DEFAULT_OUTPUT_DIR,
 		provider: value?.provider ?? DEFAULT_PROVIDER,
 		model: value?.model ?? DEFAULT_MODEL,
+		reasoningEffort: value?.reasoningEffort ?? DEFAULT_REASONING_EFFORT,
 		chapterChars: value?.chapterChars ?? DEFAULT_CHAPTER_CHARS,
 		maxTokens: value?.maxTokens ?? DEFAULT_MAX_TOKENS,
 		reviewPassScore: value?.reviewPassScore ?? DEFAULT_REVIEW_PASS_SCORE,
@@ -5969,6 +6434,7 @@ function apply(ctx, config) {
 		if (patch.outputDir !== void 0) next.outputDir = patch.outputDir;
 		if (patch.provider !== void 0) next.provider = patch.provider;
 		if (patch.model !== void 0) next.model = patch.model;
+		if (patch.reasoningEffort !== void 0) next.reasoningEffort = patch.reasoningEffort;
 		if (patch.chapterChars !== void 0) next.chapterChars = patch.chapterChars;
 		if (patch.maxTokens !== void 0) next.maxTokens = patch.maxTokens;
 		if (patch.reviewPassScore !== void 0) next.reviewPassScore = patch.reviewPassScore;