@waterwx/dsh-novel-forge 1.1.7 → 1.1.9

package/lib/index.js

@@ -3,139 +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",
-	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 = [
@@ -751,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. */
@@ -1501,6 +1388,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");
 }
 /**
@@ -1584,6 +1479,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 必须在一段内完整结束。",
@@ -1603,6 +1500,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. */
@@ -1650,17 +1550,18 @@ async function reviewChapter(ctx, config, project, outputDir, chapterNo) {
 * 审查「任意正文文本」（作者手动编辑后的草稿，不落盘）。
 * 复用审稿提示词与红线/道藏/反AI规则；仅返回报告，不改文件不改状态。
 */
-async function reviewChapterText(ctx, config, project, text) {
+async function reviewChapterText(ctx, config, project, text, previousReport) {
 	const user = [
 		`书名：《${project.bookName}》`,
-		"==================== 待审查正文 ====================",
+		previousReport !== void 0 ? "==================== 上一轮审稿意见（逐条核对是否已解决） ====================\n" + previousReport.issues.map((it, i) => `${i + 1}. [${it.severity}] ${it.item}${it.suggestion !== "" ? ` → ${it.suggestion}` : ""}`).join("\n") : "",
+		previousReport !== void 0 ? "==================== 修订稿（上一轮审稿后按意见修订的正文） ====================" : "==================== 待审查正文 ====================",
 		text.slice(0, 2e4)
 	].join("\n");
 	const raw = parseJsonObject(await complete(ctx, config, {
-		system: reviewSystemPrompt(project),
+		system: previousReport !== void 0 ? verifySystemPrompt(project) : reviewSystemPrompt(project),
 		user,
 		temperature: .3,
-		maxTokens: Math.max(config.maxTokens, 8e3)
+		maxTokens: Math.max(config.maxTokens, 16e3)
 	}));
 	const issues = Array.isArray(raw.issues) ? raw.issues.filter((v) => typeof v === "object" && v !== null).map((entry) => ({
 		severity: [
@@ -1672,14 +1573,37 @@ async function reviewChapterText(ctx, config, project, text) {
 		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;
+	let passed = score >= config.reviewPassScore;
+	if (previousReport !== void 0) {
+		const hasHigh = issues.some((i) => i.severity === "high");
+		const prevHighResolved = previousReport.issues.filter((i) => i.severity === "high").every((p) => !issues.some((i) => i.item.includes(p.item.slice(0, 12))));
+		passed = !hasHigh && prevHighResolved;
+	}
 	return {
 		score,
-		passed: score >= config.reviewPassScore,
+		passed,
 		verdict: typeof raw.verdict === "string" ? raw.verdict.slice(0, 200) : "",
 		issues,
 		reviewedAt: (/* @__PURE__ */ new Date()).toISOString()
 	};
 }
+/** 验证模式系统提示：修订后逐条核对原意见是否解决，只挑新增 high，不重复挑剔主观项。 */
+function verifySystemPrompt(project) {
+	return [
+		"你是一位网文审稿验证员。作者已按上一轮审稿意见修订了本章，你需要验证修订效果。",
+		"你的任务（严格按此执行）：",
+		"1. 逐条核对「上一轮意见」中的每一条是否已在修订稿中解决——已解决的不再列出；未解决或部分解决的，按原严重度列出（item 需注明\"未解决：原意见 xxx\"）。",
+		"2. 只挑修订【新引入】的 high 级问题（设定矛盾/逻辑硬伤/事实错误）——新引入的 medium/low 主观项（文笔/套话/节奏）不要列。",
+		"3. 禁止重复挑剔上一轮已指出且本次已解决的主观项（如\"缓缓/微微\"等套话、错别字）——即使换个说法再提也不行。",
+		"4. 严禁为了显得专业而新增\"换一批毛病\"式的意见；如果修订稿已解决全部 high 且无新增 high，输出 issues 为空数组。",
+		"score 评分：按修订稿整体质量给 50-90 分（解决全部 high 且无新增 high 时给 70 以上）。",
+		"verdict：一句话结论（如\"原 high 已解决，无新增高风险问题\"或\"仍有未解决的 high\"）。",
+		"输出必须是合法 JSON 对象：{\"score\": 数字, \"verdict\": \"一句话\", \"issues\": [{\"severity\": \"high|medium|low\", \"item\": \"问题\", \"suggestion\": \"建议\"}]}",
+		"重要：所有字符串值内部不得包含换行符，JSON 必须在一段内完整结束。",
+		"重要：直接输出 JSON 结果本身，不要把思考过程写在输出里。",
+		`本书设定圣经（核对设定冲突用）：\n${project.bible !== void 0 ? JSON.stringify(project.bible).slice(0, 3e3) : "（无）"}`
+	].join("\n");
+}
 /** Build the author-review system prompt (narrative structure, not prose). */
 function authorReviewSystemPrompt() {
 	return [
@@ -1877,6 +1801,402 @@ async function extractRoles(ctx, config, project) {
 	}
 	return roles;
 }
+/**
+* 为单个角色提炼「动漫形象描述词」：扫描该角色出场的已写章节正文，
+* 截取含外貌描写的段落，交给 LLM 提炼中文描述 + 英文绘图标签。
+*/
+async function extractRoleVisual(ctx, config, project, outputDir, roleName) {
+	const role = (project.roles ?? []).find((r) => r.name === roleName);
+	if (role === void 0) throw new Error(`角色「${roleName}」不在角色库中`);
+	const appearanceHints = /(发|眉|眼|眸|脸|肤|唇|身材|身高|衣|袍|裙|衫|靴|腰带|气质|模样|长相|容貌|披|束|扎|戴|佩|挂|绣|青|白|黑|红|蓝|紫|灰|银|金|少年|青年|少女|汉子|老者|中年|纤细|挺拔|瘦削|壮实|清秀|俊朗|英气|阴鸷|慈眉)/;
+	const excerpts = [];
+	const written = project.chapters.filter((c) => c.status !== "pending" && c.status !== "generating" && c.file !== void 0).slice(-60);
+	for (const chapter of written) {
+		const body = readChapterFile(outputDir, chapter);
+		if (body === void 0) continue;
+		const paras = body.split(/\n{2,}/).map((p) => p.trim()).filter((p) => p.length > 0);
+		let perChapter = 0;
+		for (const para of paras) {
+			if (perChapter >= 2 || excerpts.length >= 12) break;
+			if (!para.includes(roleName)) continue;
+			if (appearanceHints.test(para) || excerpts.length < 4) {
+				excerpts.push({
+					no: chapter.no,
+					text: para.slice(0, 220)
+				});
+				perChapter++;
+			}
+		}
+		if (excerpts.length >= 12) break;
+	}
+	if (excerpts.length === 0) throw new Error(`正文中未找到「${roleName}」的出场描写（仅搜索最近 60 章），请确认角色名与正文一致`);
+	const raw = parseJsonObject(await complete(ctx, config, {
+		system: [
+			"你是一位动漫角色设定师。根据网文正文中该角色的实际外貌描写，提炼「动漫形象描述词」，用于 AI 绘图（NovelAI / Stable Diffusion / Midjourney / 豆包等）生成一致的角色立绘。",
+			"硬性要求（依据优先）：",
+			"1. 发色/发型/瞳色/服装/气质/标志物必须来自提供的正文段落，不得凭空发明。",
+			"2. 正文未明确写到的项目（如瞳色没写），用「未定」标注，不要编造。",
+			"3. 服装优先取正文明确出现的（颜色+款式），多次出现取最常穿的组合。",
+			"输出三个部分：",
+			"- zh：中文外貌描述，一段连贯文字（60-150 字）：发色发型、瞳色、脸型气质、服装（颜色款式）、身材、标志性物件。",
+			"- en：英文绘图标签，booru 风格、逗号分隔、小写，30-50 个标签：含性别（1boy/1girl）、发色、发型、瞳色、服装（如 chinese hanfu / daoist robe）、气质、背景无关项。不要输出负面提示词。",
+			"- tags：中文关键标签数组，5-10 个（如 [\"黑发\",\"束发\",\"青色道袍\",\"清秀\",\"腰悬古玉\"]）。",
+			"- source：说明依据（如\"第1章/第8章外貌描写；瞳色未明确\"）。",
+			"输出必须是合法 JSON 对象：{\"zh\": \"...\", \"en\": \"...\", \"tags\": [...], \"source\": \"...\"}",
+			"重要：所有字符串值内部不得包含换行符，JSON 必须在一段内完整结束。",
+			"重要：直接输出 JSON 结果本身，不要把思考过程写在输出里。"
+		].join("\n"),
+		user: [
+			`书名：《${project.bookName}》`,
+			`目标角色：${role.name}（${role.identity}）`,
+			role.traits.length > 0 ? `性格标签：${role.traits.join("、")}` : "",
+			`正文出场描写（含外貌线索的段落）：`,
+			...excerpts.map((e) => `[第${e.no}章] ${e.text}`),
+			"只输出 JSON 对象。"
+		].join("\n\n"),
+		temperature: .4,
+		maxTokens: Math.max(config.maxTokens, 4e3)
+	}));
+	const zh = typeof raw.zh === "string" ? raw.zh.trim().slice(0, 500) : "";
+	const en = typeof raw.en === "string" ? raw.en.trim().slice(0, 1500) : "";
+	const tags = Array.isArray(raw.tags) ? raw.tags.filter((t) => typeof t === "string" && t.trim() !== "").map((t) => t.trim().slice(0, 20)).slice(0, 12) : [];
+	const source = typeof raw.source === "string" ? raw.source.trim().slice(0, 300) : "";
+	if (zh === "" || en === "") throw new Error("形象描述提炼失败：LLM 未返回有效 JSON");
+	return {
+		zh,
+		en,
+		tags,
+		source
+	};
+}
+/**
+* 开书想法 → AI 大纲：输入一句话想法，生成 2-3 个方向不同、可直接开书的完整大纲方案。
+* @param count 本次生成几个（默认 3，最多 3）
+* @param exclude 已暂留方案的剧情方向/卖点摘要（换批时避开，防止重复）
+*/
+async function suggestOutlines(ctx, config, idea, count = 3, exclude = []) {
+	const n = Math.max(1, Math.min(3, Math.floor(count)));
+	const parsed = parseJsonArray(await complete(ctx, config, {
+		system: [
+			"你是一位资深网文策划。作者只给了一句「想法」，你需要把它扩展成 2-3 个【方向差异明显】的完整小说大纲方案，供作者挑选。",
+			"每个方案必须满足：",
+			"1. bookName：书名（6 字以内，抓眼球、点题）。",
+			"2. genre：题材（如 仙侠修真 / 都市异能 / 玄幻 / 悬疑）。",
+			"3. sellingPoint：核心卖点一句话（金手指/爽点/差异化，40 字内）。",
+			"4. outline：完整大纲文本（至少 800 字，可直接作为开书大纲），结构包含：书名与题材、金手指/核心设定、主角人设与动机、主线剧情走向（至少 5 个阶段）、关键配角与势力、卖点与爽点设计、预计分卷（3-5 卷）。",
+			"方向差异要求：",
+			"- 方案之间的金手指/剧情走向必须明显不同（如：苟道发育流 vs 随身老爷爷流 vs 群像争霸流），不能只是换书名。",
+			"- 忠实于作者想法的核心要素，但允许在不同方向上进行合理演绎。",
+			"- 不输出任何与已列「需避开的方向」雷同的方案。",
+			"输出必须是合法 JSON 数组，只输出数组本身：",
+			"[{\"id\": \"唯一id\", \"bookName\": \"...\", \"genre\": \"...\", \"sellingPoint\": \"...\", \"outline\": \"...\"}]",
+			`本次只输出 ${n} 个方案。`,
+			"重要：所有字符串值内部不得包含换行符（大纲内部分段请用「。\n」或「；」自然断句），JSON 必须在一段内完整结束。",
+			"重要：直接输出 JSON 结果本身，不要把思考过程写在输出里。"
+		].join("\n"),
+		user: [
+			`作者的想法：${idea}`,
+			idea.trim().length < 40 ? "作者的想法非常简短（可能只有一句）。请基于通用网文套路合理扩展补全：为每个方案自洽地设计金手指/核心设定、主角人设与动机、主线走向，使其成为完整可开书的大纲；不同方案的方向仍须明显差异。" : "",
+			exclude.length > 0 ? `需避开的已暂留方案方向（新方案不得与之雷同）：\n${exclude.map((e, i) => `${i + 1}. ${e}`).join("\n")}` : "",
+			`请生成 ${n} 个大纲方案。`,
+			"只输出 JSON 数组。"
+		].join("\n\n"),
+		temperature: .85,
+		maxTokens: Math.max(config.maxTokens, 12e3)
+	}));
+	const candidates = [];
+	for (const entry of parsed) {
+		if (typeof entry !== "object" || entry === null) continue;
+		const bookName = typeof entry.bookName === "string" ? entry.bookName.trim().slice(0, 30) : "";
+		const outline = typeof entry.outline === "string" ? entry.outline.trim() : "";
+		if (bookName === "" || outline.length < 300) continue;
+		candidates.push({
+			id: typeof entry.id === "string" && entry.id !== "" ? entry.id : `oc-${Date.now().toString(36)}-${candidates.length}`,
+			bookName,
+			genre: typeof entry.genre === "string" ? entry.genre.trim().slice(0, 20) : "",
+			sellingPoint: typeof entry.sellingPoint === "string" ? entry.sellingPoint.trim().slice(0, 120) : "",
+			outline
+		});
+	}
+	if (candidates.length === 0) throw new Error("大纲方案生成失败：LLM 未返回有效 JSON（可重试）");
+	return candidates.slice(0, n);
+}
+/** 拆书分析：对已写章节做结构/人物/文风/卖点四维体检。
+*  两阶段管道（借鉴 AI-Novel-Writing-Assistant）：
+*  ① 源片段笔记：每章抽取结构化笔记（剧情/人物/设定/写法/卖点/短板信号）
+*  ② 分节分析：按维度各跑一次 LLM，输出可读分析稿 + 结构化数据 + 证据链。
+*  @param scope 'recent'(默认最近20章) | 'volume:N' | 'all'
+*  @param preset 'quick'(总览/剧情/人物/文风) | 'standard'(+卖点)
+*  @param budgetTokens token 预算上限（超过即截断章节取样）。
+*/
+async function breakdownBook(ctx, config, project, outputDir, scope = "recent", preset = "quick", budgetTokens = 5e4) {
+	const written = project.chapters.filter((c) => c.status !== "pending" && c.status !== "generating" && c.summary !== void 0 && c.summary !== "");
+	let selected = written;
+	if (scope === "recent") selected = written.slice(-20);
+	else if (/^volume:\d+$/.test(scope)) {
+		const v = Number(scope.slice(7));
+		selected = written.filter((c) => c.volume === v);
+	}
+	if (selected.length === 0) throw new Error("没有可分析的已写章节（需要已生成并带摘要）");
+	let budget = budgetTokens;
+	const chunks = [];
+	for (const c of selected.slice().reverse()) {
+		const bodySlice = (readChapterFile(outputDir, c) ?? "").replace(/^#\s+.*$/m, "").trim().slice(0, 4e3);
+		const est = Math.ceil((bodySlice.length + (c.summary?.length ?? 0)) / 4) + 400;
+		if (est > budget && chunks.length > 0) break;
+		chunks.unshift({
+			no: c.no,
+			title: c.title,
+			summary: c.summary ?? "",
+			body: bodySlice
+		});
+		budget -= est;
+	}
+	const notes = [];
+	let usedTokens = 0;
+	const noteSystem = [
+		"你是中文网文拆书助手。把单章正文整理成结构化笔记，供后续章节级分析复用。",
+		"只输出 JSON 对象：",
+		"{\"summary\": \"1-2句\", \"plotPoints\": [\"...\"], \"characters\": [\"...\"], \"worldbuilding\": [\"...\"], \"styleTechniques\": [\"...\"], \"marketHighlights\": [\"...\"], \"weaknessSignals\": [\"...\"]}",
+		"硬规则：只提取正文明确出现的信息；每数组最多 4 项；不要补写原文外的动机/意图；evidence 不在此阶段输出。",
+		"重要：直接输出 JSON，不要输出其他文字；字符串内不含换行。"
+	].join("\n");
+	for (const ch of chunks) {
+		const noteUser = [
+			`第${ch.no}章《${ch.title}》`,
+			"正文：",
+			ch.body.slice(0, 3e3)
+		].join("\n");
+		try {
+			const raw = parseJsonObject(await complete(ctx, config, {
+				system: noteSystem,
+				user: noteUser,
+				temperature: .2,
+				maxTokens: Math.max(config.maxTokens, 3e3)
+			}));
+			const pick = (k) => Array.isArray(raw[k]) ? raw[k].filter((x) => typeof x === "string" && x.trim() !== "").map((x) => x.trim().slice(0, 120)).slice(0, 4) : [];
+			notes.push(`【第${ch.no}章《${ch.title}》】\n摘要：${typeof raw.summary === "string" ? raw.summary.slice(0, 200) : ""}\n剧情：${pick("plotPoints").join("；")}\n人物：${pick("characters").join("；")}\n设定：${pick("worldbuilding").join("；")}\n写法：${pick("styleTechniques").join("；")}\n卖点：${pick("marketHighlights").join("；")}\n短板信号：${pick("weaknessSignals").join("；") || "（无明显短板信号）"}`);
+			usedTokens += 800;
+		} catch {}
+	}
+	const sectionsConfig = [
+		{
+			key: "overview",
+			title: "拆书总览",
+			focus: "一句话定位、题材标签、整体优势与短板",
+			system: [
+				"你是资深中文网文拆书分析师，负责《拆书总览》小节。",
+				"基于给定章节笔记做低风险综合判断，输出 JSON：{\"markdown\": \"可直接展示的分析稿（简体中文，先给结论再说明体现在哪、为何成立）\", \"structured\": {\"oneLinePositioning\": \"一句话定位\", \"genreTags\": [\"题材标签\"], \"sellingPointTags\": [\"卖点标签\"], \"strengths\": [\"整体优势\"], \"weaknesses\": [\"整体短板\"]}}",
+				"硬规则：只基于笔记归纳；推断用「更偏向/可能」等谨慎措辞；证据不足写「材料不足」；不虚构原文细节。",
+				"重要：直接输出 JSON，字符串内不含换行。"
+			].join("\n")
+		},
+		{
+			key: "plot",
+			title: "剧情结构",
+			focus: "主线梗概、阶段推进、冲突升级、节奏风险",
+			system: [
+				"你是资深中文网文拆书分析师，负责《剧情结构》小节。",
+				"基于给定章节笔记分析，输出 JSON：{\"markdown\": \"分析稿（简体中文，先结论后依据）\", \"structured\": {\"mainlineSummary\": \"主线梗概\", \"phaseProgressions\": [\"阶段推进\"], \"escalationDesigns\": [\"冲突升级\"], \"paceRisks\": [\"节奏风险\"], \"reusablePatterns\": [\"可复用套路\"]}}",
+				"硬规则：只基于笔记归纳；推断谨慎措辞；不虚构。",
+				"重要：直接输出 JSON，字符串内不含换行。"
+			].join("\n")
+		},
+		{
+			key: "character",
+			title: "人物系统",
+			focus: "主角定位、配角功能、关系网络、成长弧线、辨识度风险",
+			system: [
+				"你是资深中文网文拆书分析师，负责《人物系统》小节。",
+				"基于给定章节笔记分析，输出 JSON：{\"markdown\": \"分析稿（简体中文，先结论后依据）\", \"structured\": {\"protagonistPositioning\": \"主角定位\", \"supportingFunctions\": [\"配角功能\"], \"relationshipNetwork\": [\"关系网络\"], \"growthArcs\": [\"成长弧线\"], \"clarityRisks\": [\"辨识度风险\"]}}",
+				"硬规则：只基于笔记归纳；推断谨慎措辞；不虚构。",
+				"重要：直接输出 JSON，字符串内不含换行。"
+			].join("\n")
+		},
+		{
+			key: "style",
+			title: "文风与技法",
+			focus: "叙事视角、语言风格、描写方式、节奏控制、钩子设计、可复用写法",
+			system: [
+				"你是资深中文网文拆书分析师，负责《文风与技法》小节。",
+				"基于给定章节笔记分析，输出 JSON：{\"markdown\": \"分析稿（简体中文，先结论后依据）\", \"structured\": {\"narrativePov\": \"叙事视角\", \"languageStyle\": \"语言风格\", \"dialoguePatterns\": [\"对话特征\"], \"rhythmControl\": [\"节奏控制\"], \"hookDesigns\": [\"钩子设计\"], \"reusableTechniques\": [\"可复用写法\"]}}",
+				"硬规则：只基于笔记归纳；推断谨慎措辞；不虚构。",
+				"重要：直接输出 JSON，字符串内不含换行。"
+			].join("\n")
+		}
+	];
+	if (preset === "standard") sectionsConfig.push({
+		key: "market",
+		title: "商业化卖点",
+		focus: "读者爽点、点击驱动、人物/题材卖点、商业化风险",
+		system: [
+			"你是资深中文网文拆书分析师，负责《商业化卖点》小节。",
+			"基于给定章节笔记分析，输出 JSON：{\"markdown\": \"分析稿（简体中文，先结论后依据）\", \"structured\": {\"hookPoints\": [\"读者爽点\"], \"clickDrivers\": [\"点击驱动\"], \"characterSellingPoints\": [\"人物卖点\"], \"genreSellingPoints\": [\"题材卖点\"], \"commercialRisks\": [\"商业化风险\"]}}",
+			"硬规则：只基于笔记归纳；推断谨慎措辞；不虚构。",
+			"重要：直接输出 JSON，字符串内不含换行。"
+		].join("\n")
+	});
+	const notesText = notes.join("\n\n");
+	const sections = [];
+	const evidence = [];
+	for (const sec of sectionsConfig) try {
+		const raw = parseJsonObject(await complete(ctx, config, {
+			system: sec.system,
+			user: `分析范围：${selected.length} 章（${scope === "all" ? "全书" : scope === "recent" ? "最近 20 章" : "指定卷"}）。\n\n章节笔记：\n${notesText}`,
+			temperature: .3,
+			maxTokens: Math.max(config.maxTokens, 6e3)
+		}));
+		sections.push({
+			key: sec.key,
+			title: sec.title,
+			markdown: typeof raw.markdown === "string" ? raw.markdown.trim() : "（生成失败）",
+			structured: typeof raw.structured === "object" && raw.structured !== null ? raw.structured : {}
+		});
+		usedTokens += 2e3;
+	} catch {
+		sections.push({
+			key: sec.key,
+			title: sec.title,
+			markdown: "（本节生成失败，可重试）",
+			structured: {}
+		});
+	}
+	return {
+		sections,
+		evidence,
+		chaptersScanned: chunks.length,
+		usedTokens
+	};
+}
+/**
+* 漫剧分镜生成：把一章正文改编为短视频漫剧分镜（吸收 manga-script-master 方法论）。
+* 产出：本集标题 + 赛道节奏说明 + 角色视觉锚点卡 + 分镜表（8-12 格）+ 结尾钩子。
+* 角色锚点优先复用角色库 imagePrompt（无则从正文提炼）。
+*/
+async function generateStoryboard(ctx, config, project, outputDir, chapterNo, genre, platform, tool) {
+	const chapter = project.chapters.find((c) => c.no === chapterNo);
+	if (chapter === void 0) throw new Error(`章节 ${chapterNo} 不在计划中`);
+	const body = readChapterFile(outputDir, chapter);
+	if (body === void 0) throw new Error(`章节 ${chapterNo} 尚未生成正文`);
+	const roleCards = (project.roles ?? []).filter((r) => r.imagePrompt !== void 0 && (body.includes(r.name) || chapter.summary?.includes(r.name) === true)).map((r) => ({
+		name: r.name,
+		anchor: r.imagePrompt.zh.slice(0, 120),
+		tags: r.imagePrompt.en.slice(0, 300)
+	})).slice(0, 3);
+	const raw = parseJsonObject(await complete(ctx, config, {
+		system: [
+			"你是一位精通短视频算法与 AIGC 的顶级漫剧导演。把给定的一章网文改编为高完播率的漫剧分镜。",
+			"硬性要求：",
+			"1. 前 3 秒必须有强冲突或视觉冲击（黄金开局）；每 10 秒至少一个小高潮；结尾必须有悬念钩子。",
+			"2. 所有情感必须具象化为动作（不能写\"他很愤怒\"，要写\"他拳头砸碎桌角，碎片飞溅\"）。",
+			"3. 台词每句 ≤15 字，用画面推进叙事。",
+			"4. 总时长 60-120 秒，分镜 8-12 格，每格标注时间码、景别、转场/动效。",
+			"5. 输出 JSON：",
+			"{\"title\": \"本集标题（核心设定+冲突+悬念句式）\", \"pacingNote\": \"赛道判断与节奏说明（按爽文/甜宠/悬疑/搞笑模型）\", \"hook\": \"本集钩子一句话\", \"panels\": [{\"timecode\": \"0:00-0:03\", \"shot\": \"特写\", \"visual\": \"具象画面描述\", \"dialogue\": \"(情绪)台词\", \"transition\": \"硬切/闪白等\", \"prompt\": \"英文AI提示词：角色标签+表情+动作+场景+景别+光影+风格+9:16\"}], \"endingHook\": \"结尾钩子台词\"}",
+			"6. 英文 prompt 里的角色标签必须复用提供的角色锚点标签；多角色同框用 left/right/foreground 分隔。",
+			"7. 严禁在提示词里出现文字/水印（画面内字幕后期加）。",
+			"重要：直接输出 JSON，字符串内不含换行。"
+		].join("\n"),
+		user: [
+			`书名：《${project.bookName}》`,
+			`章节：第 ${chapter.no} 章《${chapter.title}》`,
+			chapter.summary !== void 0 ? `章节摘要：${chapter.summary}` : "",
+			`目标平台：${platform}（默认抖音竖屏 9:16）`,
+			`赛道：${genre !== "" ? genre : "（由你按内容判断：爽文/甜宠/悬疑/搞笑）"}`,
+			`AI 工具：${tool}（影响提示词格式）`,
+			roleCards.length > 0 ? `角色视觉锚点（英文标签全分镜强制复用）：\n${roleCards.map((r) => `- ${r.name}：${r.tags}`).join("\n")}` : "（无角色锚点卡，从正文提炼 1-2 个核心角色并给出标签）",
+			"==================== 正文 ====================",
+			body.replace(/^#\s+.*$/m, "").trim().slice(0, 6e3),
+			"只输出 JSON 对象。"
+		].join("\n\n"),
+		temperature: .5,
+		maxTokens: Math.max(config.maxTokens, 12e3)
+	}));
+	const str = (v, fallback = "") => typeof v === "string" ? v.trim() : fallback;
+	const panels = (Array.isArray(raw.panels) ? raw.panels.filter((p) => typeof p === "object" && p !== null) : []).map((p, i) => ({
+		index: i + 1,
+		timecode: str(p.timecode, `0:${String(i * 10).padStart(2, "0")}`),
+		shot: str(p.shot, "中景"),
+		visual: str(p.visual),
+		dialogue: str(p.dialogue),
+		transition: str(p.transition, "硬切"),
+		prompt: str(p.prompt)
+	})).filter((p) => p.visual !== "").slice(0, 12);
+	return {
+		title: str(raw.title, `第 ${chapter.no} 集`),
+		pacingNote: str(raw.pacingNote, "（按内容判断赛道节奏）"),
+		hook: str(raw.hook),
+		characters: roleCards.map((r) => ({
+			name: r.name,
+			visualAnchor: r.anchor,
+			tags: r.tags,
+			expressions: []
+		})),
+		panels,
+		endingHook: str(raw.endingHook)
+	};
+}
+/**
+* 漫剧分集计划：AI 通读一卷的章节标题+摘要+beats，按故事弧线把章节分组为漫剧集。
+* 原则（吸收 manga-script 节奏模型）：高潮章单独成集、过渡章合并、断点选在钩子最强处。
+*/
+async function planStoryboardEpisodes(ctx, config, project, volumeNo, platform, maxEpisodes) {
+	const volume = project.volumes?.find((v) => v.no === volumeNo);
+	if (volume === void 0) throw new Error(`第 ${volumeNo} 卷不存在（卷计划未生成或卷号错误）`);
+	const chapters = project.chapters.filter((c) => c.volume === volumeNo && c.status !== "pending" && c.status !== "generating").sort((a, b) => a.no - b.no);
+	if (chapters.length === 0) throw new Error(`第 ${volumeNo} 卷没有已写章节`);
+	const chapterBriefs = chapters.map((c) => {
+		const beatsHead = (c.beats ?? "").split("\n")[0] ?? "";
+		return `第${c.no}章《${c.title}》｜${beatsHead.slice(0, 60)}｜${(c.summary ?? "").slice(0, 100)}`;
+	});
+	const raw = parseJsonObject(await complete(ctx, config, {
+		system: [
+			"你是一位精通短视频算法与漫剧节奏的总导演。把给定的一卷网文改编为「漫剧分集计划」——不是按章分，而是按故事弧线分集。",
+			"分集原则：",
+			"1. 高潮章（大冲突/身份揭晓/大收获）单独成集或两章一集；过渡章（赶路/准备/日常）2-3 章合并为一集；支线穿插章并入相邻主线圈。",
+			"2. 每集 60-120 秒 ≈ 1-2 章正文，但以\"叙事任务完整\"为准，不被章节号束缚。",
+			"3. 断点选在钩子最强处：每集结尾必须留下让观众点下集的悬念。",
+			"4. 全集数控制在 8 到上限之间（上限由输入给出），宁少勿碎。",
+			"5. 卷的开局集要强（3 秒钩子），卷的结尾集要收束本卷弧线并埋下卷间钩子。",
+			"输出 JSON：",
+			"{\"strategy\": \"本卷漫剧化策略一句话（赛道判断+整体节奏安排）\", \"episodes\": [{\"title\": \"集标题（冲突+悬念句式）\", \"chapters\": [章号数组], \"narrativeJob\": \"这集讲什么、为什么这么分（1-2句）\", \"openingHook\": \"开头3秒钩子\", \"endingHook\": \"结尾钩子\"}]}",
+			"硬性要求：episodes 按章号顺序排列且覆盖全部给定章节（不得遗漏）；chapters 数组必须连续（如 [81,82,83]）；每集 chapters 至少 1 章、最多 4 章；所有文字用简体中文。",
+			"重要：直接输出 JSON，字符串内不含换行。"
+		].join("\n"),
+		user: [
+			`书名：《${project.bookName}》`,
+			`第 ${volumeNo} 卷《${volume.title}》（${volume.chapterStart}-${volume.chapterEnd} 章）`,
+			`卷定位：${volume.summary}`,
+			`目标平台：${platform}（竖屏 9:16）`,
+			`本卷已写章节（${chapters.length} 章，按序）：\n${chapterBriefs.join("\n")}`,
+			`全集数上限：${maxEpisodes}`,
+			"只输出 JSON 对象。"
+		].join("\n\n"),
+		temperature: .4,
+		maxTokens: Math.max(config.maxTokens, 12e3)
+	}));
+	const episodesRaw = Array.isArray(raw.episodes) ? raw.episodes.filter((e) => typeof e === "object" && e !== null) : [];
+	const str = (v, fallback = "") => typeof v === "string" ? v.trim() : fallback;
+	const episodes = [];
+	for (const e of episodesRaw) {
+		const chaptersArr = Array.isArray(e.chapters) ? e.chapters.filter((n) => typeof n === "number" && Number.isInteger(n) && n > 0) : [];
+		if (chaptersArr.length === 0) continue;
+		episodes.push({
+			index: episodes.length + 1,
+			title: str(e.title, `第 ${episodes.length + 1} 集`),
+			chapters: chaptersArr,
+			narrativeJob: str(e.narrativeJob),
+			openingHook: str(e.openingHook),
+			endingHook: str(e.endingHook)
+		});
+	}
+	if (episodes.length === 0) throw new Error("分集计划生成失败：LLM 未返回有效集数");
+	return {
+		strategy: str(raw.strategy, "（按内容判断赛道节奏）"),
+		episodes,
+		chaptersScanned: chapters.length
+	};
+}
 /** 🩺 剧情健康检查：基于已写章节数/各线状态/编年录，判断是否需要新线及添加时机。 */
 async function analyzePlotlineHealth(ctx, config, project) {
 	const system = [
@@ -2181,6 +2501,7 @@ async function* generateChapterStream(ctx, config, project, outputDir, chapterNo
 			score
 		};
 	}).filter((x) => x.score >= 3).sort((a, b) => b.score - a.score).slice(0, 15).map((x) => `[第${x.f.chapterNo}章] ${x.f.text}`).filter((t) => !recentSet.has(t.slice(t.indexOf("]") + 2)));
+	const foreshadowHints = (project.foreshadows ?? []).filter((f) => f.status === "planned" && f.targetChapter !== void 0 && f.targetChapter > 0).filter((f) => Math.abs(f.targetChapter - chapterNo) <= 12).map((f) => `- ${f.description.slice(0, 120)}${f.targetChapter !== void 0 ? `（计划回收于第 ${f.targetChapter} 章）` : ""}`);
 	const messages = [createUserMessage({
 		content: [{
 			type: "text",
@@ -2188,6 +2509,7 @@ async function* generateChapterStream(ctx, config, project, outputDir, chapterNo
 				`现在写第 ${chapter.no} 章，标题《${chapter.title}》。`,
 				`本章剧情要点：${chapter.beats}`,
 				"",
+				foreshadowHints.length > 0 ? `本章附近需顺势埋下以下暗线（自然带过，不喧宾夺主，1-2 句即可，但细节要可辨识、与描述吻合）：\n${foreshadowHints.join("\n")}` : "",
 				recentFacts.length > 0 ? `本书已确立的事实（新写内容不得与之矛盾）：\n${recentFacts.join("\n")}` : "",
 				relatedFacts.length > 0 ? `本章相关的既往事实（同样不得违背）：\n${relatedFacts.join("\n")}` : "",
 				prevSummary !== void 0 && prevSummary !== "" ? `上一章摘要：${prevSummary}` : "",
@@ -2304,17 +2626,50 @@ async function summarizeAndExtractFacts(ctx, config, project, outputDir, chapter
 	};
 }
 /**
-* 抽取本章「已确立事实」追加到事实库/时间线（最多 300 条，最新优先）。
-* 事实注入后续章节生成提示词，保证人物状态/境界/资源/关系长期一致。
-* @returns 新增事实条数（失败返回 0，调用方 best-effort）。
+* 伏笔落地标记：检查刚生成的章节正文是否埋下了 planned 伏笔（关键词匹配），
+* 命中则将该伏笔标记为 planted 并记录 plantedChapter——保证暗线管理页与正文同步。
+* 纯关键词粗匹配，宁缺毋滥：仅处理「描述含可辨识关键词」的伏笔，无把握则不标。
 */
-async function extractFacts(ctx, config, project, outputDir, chapterNo) {
+function markForeshadowPlanted(project, outputDir, chapterNo) {
 	const chapter = project.chapters.find((c) => c.no === chapterNo);
 	if (chapter === void 0) return 0;
 	const body = readChapterFile(outputDir, chapter);
 	if (body === void 0) return 0;
-	const lines = (await complete(ctx, config, {
-		system: [
+	let marked = 0;
+	for (const f of project.foreshadows ?? []) {
+		if (f.status !== "planned") continue;
+		if (f.plantedChapter !== void 0) continue;
+		const quoted = f.description.match(/[「“『《]([^」”』》]{2,12})[」”』》]/g);
+		const keywords = (quoted !== null ? quoted : []).map((q) => q.slice(1, -1)).filter((k) => k.length >= 2);
+		const nearTarget = f.targetChapter !== void 0 && Math.abs(f.targetChapter - chapterNo) <= 12;
+		if (keywords.length === 0 && !nearTarget) continue;
+		const hit = keywords.length === 0 ? false : keywords.some((k) => body.includes(k));
+		if (hit || keywords.length === 0 && nearTarget) {
+			if (hit) {
+				f.status = "planted";
+				f.plantedChapter = chapterNo;
+				marked++;
+			}
+		}
+	}
+	if (marked > 0) {
+		project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+		saveProject(outputDir, project);
+	}
+	return marked;
+}
+/**
+* 抽取本章「已确立事实」追加到事实库/时间线（最多 300 条，最新优先）。
+* 事实注入后续章节生成提示词，保证人物状态/境界/资源/关系长期一致。
+* @returns 新增事实条数（失败返回 0，调用方 best-effort）。
+*/
+async function extractFacts(ctx, config, project, outputDir, chapterNo) {
+	const chapter = project.chapters.find((c) => c.no === chapterNo);
+	if (chapter === void 0) return 0;
+	const body = readChapterFile(outputDir, chapter);
+	if (body === void 0) return 0;
+	const lines = (await complete(ctx, config, {
+		system: [
 			"你是一位网文编辑。请从本章正文中抽取「已确立事实」，供后续章节保持一致。",
 			"事实指：人物当前状态（境界/修为/伤势/资源/心境）、重要关系变化、地点与时间线、已落地或新增的伏笔线索、关键道具去向。",
 			"要求：",
@@ -2749,47 +3104,631 @@ async function suggestForeshadows(ctx, config, project) {
 	return created;
 }
 /**
-* 写法引擎：从样本文本提取一份写法资产（叙事风格规则）。
-* @returns 提取出的风格规则（未持久化，由调用方存入 project.assets）。
+* 写法引擎：从样本文本提取一份写法资产（叙事风格规则）。
+* @returns 提取出的风格规则（未持久化，由调用方存入 project.assets）。
+*/
+async function extractStyleAsset(ctx, config, sampleText) {
+	const user = `请分析下面这段样本文本，提炼其叙事风格规则：\n\n${sampleText}`;
+	const raw = parseJsonObject(await complete(ctx, config, {
+		system: styleEngineSystemPrompt(),
+		user,
+		temperature: .3,
+		maxTokens: Math.max(config.maxTokens, 12e3)
+	}));
+	const strArray = (value) => Array.isArray(value) ? value.filter((v) => typeof v === "string" && v.trim() !== "") : [];
+	const result = {
+		proseRules: strArray(raw.proseRules),
+		dialogueRules: strArray(raw.dialogueRules),
+		descriptionRules: strArray(raw.descriptionRules),
+		boundaries: strArray(raw.boundaries)
+	};
+	if (result.proseRules.length + result.dialogueRules.length + result.descriptionRules.length + result.boundaries.length === 0) throw new Error("写法提取失败：模型没有返回有效规则");
+	return result;
+}
+/** Export the whole book as one txt/md file. */
+function exportBook(outputDir, project, format) {
+	const parts = [];
+	if (format === "md") parts.push(`# ${project.bookName}\n`);
+	else parts.push(project.bookName, "");
+	const done = project.chapters.filter((c) => c.file !== void 0);
+	for (const chapter of done) {
+		const body = readChapterFile(outputDir, chapter) ?? "";
+		if (format === "md") parts.push(`\n## 第${chapter.no}章 ${chapter.title}\n`, body.trim(), "");
+		else parts.push("", `第${chapter.no}章 ${chapter.title}`, "", body.trim(), "");
+	}
+	const content = parts.join("\n");
+	const ext = format === "md" ? "md" : "txt";
+	const file = `《${safeFileName(project.bookName)}》全本.${ext}`;
+	writeFileSync(join(outputDir, file), content, "utf8");
+	return {
+		file,
+		chars: content.length,
+		chapters: done.length
+	};
+}
+//#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) {
+	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.
 */
-async function extractStyleAsset(ctx, config, sampleText) {
-	const user = `请分析下面这段样本文本，提炼其叙事风格规则：\n\n${sampleText}`;
-	const raw = parseJsonObject(await complete(ctx, config, {
-		system: styleEngineSystemPrompt(),
-		user,
-		temperature: .3,
-		maxTokens: Math.max(config.maxTokens, 12e3)
-	}));
-	const strArray = (value) => Array.isArray(value) ? value.filter((v) => typeof v === "string" && v.trim() !== "") : [];
-	const result = {
-		proseRules: strArray(raw.proseRules),
-		dialogueRules: strArray(raw.dialogueRules),
-		descriptionRules: strArray(raw.descriptionRules),
-		boundaries: strArray(raw.boundaries)
-	};
-	if (result.proseRules.length + result.dialogueRules.length + result.descriptionRules.length + result.boundaries.length === 0) throw new Error("写法提取失败：模型没有返回有效规则");
-	return result;
+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;
 }
-/** Export the whole book as one txt/md file. */
-function exportBook(outputDir, project, format) {
-	const parts = [];
-	if (format === "md") parts.push(`# ${project.bookName}\n`);
-	else parts.push(project.bookName, "");
-	const done = project.chapters.filter((c) => c.file !== void 0);
-	for (const chapter of done) {
-		const body = readChapterFile(outputDir, chapter) ?? "";
-		if (format === "md") parts.push(`\n## 第${chapter.no}章 ${chapter.title}\n`, body.trim(), "");
-		else parts.push("", `第${chapter.no}章 ${chapter.title}`, "", body.trim(), "");
+/**
+* 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}`);
 	}
-	const content = parts.join("\n");
-	const ext = format === "md" ? "md" : "txt";
-	const file = `《${safeFileName(project.bookName)}》全本.${ext}`;
-	writeFileSync(join(outputDir, file), content, "utf8");
-	return {
-		file,
-		chars: content.length,
-		chapters: done.length
-	};
+	return extractDocxText(new Uint8Array(buffer));
 }
 //#endregion
 //#region src/assistant.ts
@@ -3476,185 +4415,52 @@ async function* runAssistantTurn(ctx, config, project, outputDir, userMessage) {
 				name,
 				status: "error",
 				detail: error.message
-			};
-		}
-		if (prose !== "") {
-			history.push({
-				role: "assistant",
-				content: prose,
-				ts: (/* @__PURE__ */ new Date()).toISOString()
-			});
-			appendHistory(outputDir, {
-				role: "assistant",
-				content: prose,
-				ts: (/* @__PURE__ */ new Date()).toISOString()
-			});
-		}
-		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);
+			};
+		}
+		if (prose !== "") {
+			history.push({
+				role: "assistant",
+				content: prose,
+				ts: (/* @__PURE__ */ new Date()).toISOString()
+			});
+			appendHistory(outputDir, {
+				role: "assistant",
+				content: prose,
+				ts: (/* @__PURE__ */ new Date()).toISOString()
+			});
+		}
+		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/routes.ts
@@ -3975,6 +4781,12 @@ function makeRoutes(deps) {
 				} catch (error) {
 					console.warn("[dsh-novel-forge] summary/facts failed:", error.message);
 				}
+				try {
+					const marked = markForeshadowPlanted(project, config.outputDir, no);
+					if (marked > 0) console.log(`[dsh-novel-forge] 第${no}章已埋伏笔 ${marked} 条`);
+				} catch (error) {
+					console.warn("[dsh-novel-forge] markForeshadowPlanted failed:", error.message);
+				}
 				if (!(body?.skipReview === true) && (config.autoReview ?? true)) send({
 					type: "review",
 					no,
@@ -4169,17 +4981,24 @@ function makeRoutes(deps) {
 			if (existsSync(targetPath)) copyFileSync(targetPath, join(config.outputDir, `${fileName.replace(/\.md$/, "")}.bak.md`));
 			writeFileSync(targetPath, `# 第${chapter.no}章 ${chapter.title}\n\n${draft}\n`, "utf8");
 			chapter.pendingDraft = void 0;
-			chapter.status = "written";
 			chapter.chars = draft.length;
 			chapter.file = fileName;
-			chapter.review = void 0;
+			const carried = body?.report;
+			if (carried !== void 0 && typeof carried.score === "number") {
+				chapter.review = carried;
+				chapter.status = carried.passed ? "approved" : "rejected";
+			} else {
+				chapter.status = "written";
+				chapter.review = void 0;
+			}
 			chapter.error = void 0;
 			project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
 			saveProject(config.outputDir, project);
 			writeJson(res, 200, {
 				ok: true,
 				chars: draft.length,
-				file: fileName
+				file: fileName,
+				markdown: draft
 			});
 		}
 	};
@@ -4336,13 +5155,14 @@ function makeRoutes(deps) {
 			const config = getConfig();
 			const project = requireProject(res);
 			if (project === void 0) return;
-			const text = (await readJsonBody(req))?.text?.trim() ?? "";
+			const body = await readJsonBody(req);
+			const text = body?.text?.trim() ?? "";
 			if (text.length < 50) {
 				writeJson(res, 400, { error: "正文过短（<50 字），请先编辑内容" });
 				return;
 			}
 			try {
-				writeJson(res, 200, { report: await reviewChapterText(ctx, config, project, text) });
+				writeJson(res, 200, { report: await reviewChapterText(ctx, config, project, text, body?.previousReport) });
 			} catch (error) {
 				writeJson(res, 500, { error: error.message });
 			}
@@ -5087,6 +5907,31 @@ function makeRoutes(deps) {
 				if (idx === -1) project.roles.push(r);
 				else project.roles[idx] = r;
 			} else if (op === "remove" && body?.name !== void 0) project.roles = project.roles.filter((x) => x.name !== body.name);
+			else if (op === "visual") {
+				const name = body?.name?.trim();
+				if (name === void 0 || name === "") {
+					writeJson(res, 400, { error: "name（角色名）必填" });
+					return;
+				}
+				try {
+					const visual = await extractRoleVisual(ctx, config, project, config.outputDir, name);
+					const role = project.roles.find((r) => r.name === name);
+					if (role !== void 0) role.imagePrompt = visual;
+					project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+					saveProject(config.outputDir, project);
+					writeJson(res, 200, {
+						roles: project.roles,
+						visual
+					});
+					return;
+				} catch (error) {
+					writeJson(res, 500, { error: `形象提炼失败：${error.message}` });
+					return;
+				}
+			} else {
+				writeJson(res, 400, { error: "未知的 roles op" });
+				return;
+			}
 			project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
 			saveProject(config.outputDir, project);
 			writeJson(res, 200, { roles: project.roles });
@@ -5150,6 +5995,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.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,
@@ -5189,121 +6236,67 @@ function makeRoutes(deps) {
 		plotlinesRoute,
 		rolesRoute,
 		sensitiveRoute,
+		reviewBackfillRoute,
+		chapterResetRoute,
+		chapterApproveRoute,
+		configRoute,
+		openFolderRoute,
+		outlineSuggestRoute,
+		breakdownRoute,
+		storyboardRoute,
+		storyboardPlanRoute,
 		{
 			kind: "exact",
-			path: NOVEL_API.reviewBackfill,
+			path: NOVEL_API.runStart,
 			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 project = loadProject(getConfig().outputDir);
+				if (project === void 0) {
+					writeJson(res, 400, { error: "输出目录中没有项目" });
+					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 });
+				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;
 				}
-				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
-					});
+				try {
+					writeJson(res, 200, await runner.start(startNo, endNo));
 				} catch (error) {
-					console.warn(`[dsh-novel-forge] author backfill ch.${chapter.no} failed:`, error.message);
+					writeJson(res, 409, { error: error.message });
 				}
-				project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-				saveProject(config.outputDir, project);
-				send({
-					type: "author-backfill-done",
-					count: done
-				});
-				res.end();
 			}
 		},
-		chapterResetRoute,
-		chapterApproveRoute,
 		{
 			kind: "exact",
-			path: NOVEL_API.config,
+			path: NOVEL_API.runControl,
 			handler: async (req, res) => {
 				if (!guard(req, res, "POST")) return;
 				const body = await readJsonBody(req);
-				if (body === void 0) {
-					writeJson(res, 400, { error: "无效的配置 JSON" });
+				if (runner.status() === null) {
+					writeJson(res, 400, { error: "没有生产单" });
 					return;
 				}
-				try {
-					writeJson(res, 200, { config: await patchConfig(body) });
-				} catch (error) {
-					writeJson(res, 400, { 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.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 });
-				});
+			path: NOVEL_API.runStatus,
+			handler: (req, res) => {
+				if (!guard(req, res, "GET")) return;
+				writeJson(res, 200, runner.status());
 			}
 		}
 	];
@@ -5327,20 +6320,21 @@ 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"),
 	chapterChars: z.number().default(3500),
 	maxTokens: z.number().default(12e3),
 	reviewPassScore: z.number().default(70),
 	autoReview: z.boolean().default(true),
-	autoAuthorReview: z.boolean().default(true)
+	autoAuthorReview: z.boolean().default(true),
+	autoReviewAfterRevise: z.boolean().default(true)
 });
 /** 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_CHAPTER_CHARS = 3500;
@@ -5348,10 +6342,11 @@ const DEFAULT_MAX_TOKENS = 12e3;
 const DEFAULT_REVIEW_PASS_SCORE = 70;
 const DEFAULT_AUTO_REVIEW = true;
 const DEFAULT_AUTO_AUTHOR_REVIEW = true;
+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 {
@@ -5363,7 +6358,8 @@ function resolveConfig(value) {
 		maxTokens: value?.maxTokens ?? DEFAULT_MAX_TOKENS,
 		reviewPassScore: value?.reviewPassScore ?? DEFAULT_REVIEW_PASS_SCORE,
 		autoReview: value?.autoReview ?? DEFAULT_AUTO_REVIEW,
-		autoAuthorReview: value?.autoAuthorReview ?? DEFAULT_AUTO_AUTHOR_REVIEW
+		autoAuthorReview: value?.autoAuthorReview ?? DEFAULT_AUTO_AUTHOR_REVIEW,
+		autoReviewAfterRevise: value?.autoReviewAfterRevise ?? DEFAULT_AUTO_REVIEW_AFTER_REVISE
 	};
 }
 /**
@@ -5393,6 +6389,7 @@ function apply(ctx, config) {
 		if (patch.reviewPassScore !== void 0) next.reviewPassScore = patch.reviewPassScore;
 		if (patch.autoReview !== void 0) next.autoReview = patch.autoReview;
 		if (patch.autoAuthorReview !== void 0) next.autoAuthorReview = patch.autoAuthorReview;
+		if (patch.autoReviewAfterRevise !== void 0) next.autoReviewAfterRevise = patch.autoReviewAfterRevise;
 		const settings = ctx.get("settings");
 		if (settings !== void 0) await settings.update(NOVEL_SETTINGS_NAMESPACE, next);
 		else current = () => ({
@@ -5438,6 +6435,53 @@ function apply(ctx, config) {
 		},
 		onChange: sync
 	});
+	const skillsService = ctx.get("skills");
+	if (skillsService?.register !== void 0) {
+		const disposeSkill = skillsService.register({
+			name: "novel-forge-chapter-batch",
+			description: "批量生成小说章节并值守处理审稿未过的章节（豁免/按意见修订/验证模式/重新生成），依赖 dsh-novel-forge 的 /api/dsh-novel-forge/* 路由。",
+			content: [
+				"# 小说章节批量生产与值守处理",
+				"",
+				"## 0. 值守纪律（最高优先级，违反即空转）",
+				"1. 启动后台任务后立即停下，不轮询、不连续 wait、不做无意义动作——后台任务完成时运行时自动通知。",
+				"2. 只有收到「任务完成」通知或用户新消息时，才继续下一步（读结果→处理未过→汇报）。",
+				"3. 等待期间可做与当前任务无关的其他有用工作，但不得为等任务而空转。",
+				"4. 任务因 web 重启中断时：待 3080 恢复后，复位卡死章节（generating/error → reset）再续跑，并向用户说明中断原因。",
+				"",
+				"## 1. 前置检查",
+				"1. `GET /api/dsh-novel-forge/status` 确认服务在跑，读项目章节数。",
+				"2. 列出目标区间 pending 章节号，避免重复生成已处理章节。",
+				"3. **串行执行，禁止并行写 project.json**（并发会互相覆盖状态，实测教训）。",
+				"",
+				"## 2. 批量生成",
+				"逐章串行调用 `POST /generate` `{ chapterNo, skipReview: false }`（走完整质量门：生成→摘要+编年录→审稿→复盘）。",
+				"响应为 NDJSON，找 review 帧取 score/passed。每章 2-5 分钟；失败重试 1 次；后台跑并告知预计时长。",
+				"用 Node 脚本（fetch 逐章循环），避免 PowerShell 转义坑，用完删除。",
+				"",
+				"## 3. 未过章节分级处理",
+				"### A. 无 high → 豁免通过：`POST /chapter/approve`（主观项不磨）",
+				"### B. 有 high 且明确 → 按意见修订 + 验证模式：",
+				"1. 拼指令 `按审稿意见修订（优先处理）：\n[severity] item → suggestion`（high 优先，无 high 取前 3 medium）",
+				"2. `POST /rewrite` 产草稿；3. `POST /chapter/check` 带 `previousReport` 走验证模式（只核对原意见解决+只挑新增 high）",
+				"4. 判定 `passed || 无 high` 可接受；5. `POST /draft/apply` 带 passed 报告落盘 approved",
+				"6. 不可接受 → 第二轮修订（指令更精确）→ 再验证；每章最多修 2 轮，仍不过保留草稿待人工",
+				"### C. 结构性 high（修订改不好）→ `POST /draft/discard` 后 `POST /generate` 重写，剩主观项再走 A",
+				"### D. error 状态 → `POST /chapter/reset` 后 `POST /generate`",
+				"注意：approved 但 review 有 high 的保留不动；修订指令越精确越有效（具体数字/行为一次就过）。",
+				"",
+				"## 4. 收尾",
+				"`GET /status` 验证目标区间全 approved；可选刷新剧情线（`POST /plotlines` op=refresh，注意只读最近 8 章摘要）；汇报通过/未过/失败与遗留项。",
+				"",
+				"## 5. 已知陷阱",
+				"- 并发写 project.json 互相覆盖 → 必须串行",
+				"- rewrite 草稿可能偶发不落盘 → 应用前检查 pendingDraft，不存在则重跑",
+				"- PowerShell 调 API 引号/中文转义是坑 → 用 Node 脚本",
+				"- 验证模式 500 偶发 → 重试一次"
+			].join("\n")
+		});
+		ctx.effect(() => disposeSkill, "dsh-novel-forge: skill");
+	}
 	sync();
 }
 //#endregion