@waterwx/dsh-novel-forge 1.1.9 → 1.3.0

package/lib/index.js

@@ -614,6 +614,56 @@ function styleEngineSystemPrompt() {
 	].join("\n");
 }
 //#endregion
+//#region src/comic-presets.ts
+const COMIC_STYLE_PRESETS = [
+	{
+		id: "japan",
+		label: "日漫 / 黑白",
+		prompt: "manga style, screentone, bold ink lines, high contrast, black and white, cel shading",
+		layoutHint: "页漫优先"
+	},
+	{
+		id: "korea",
+		label: "韩漫 / 条漫",
+		prompt: "manhwa style, soft cel shading, vibrant colors, clean lineart, webtoon vertical composition, glossy highlights",
+		layoutHint: "条漫优先"
+	},
+	{
+		id: "china",
+		label: "国漫 / 古风",
+		prompt: "chinese ink painting style, flowing brush strokes, traditional palette, ethereal atmosphere, xianxia aesthetic",
+		layoutHint: "页漫/条漫均可"
+	},
+	{
+		id: "america",
+		label: "美漫 / 超级英雄",
+		prompt: "american comic style, bold outlines, dramatic lighting, dynamic poses, vibrant colors, halftone shading",
+		layoutHint: "页漫优先"
+	},
+	{
+		id: "chibi",
+		label: "Q版 / 搞笑",
+		prompt: "chibi style, cute proportions, big head, exaggerated expressions, simple background, bright colors",
+		layoutHint: "条漫/四格优先"
+	},
+	{
+		id: "realistic",
+		label: "写实 / 电影感",
+		prompt: "realistic cinematic style, detailed textures, natural lighting, film grain, high detail",
+		layoutHint: "页漫/全彩"
+	},
+	{
+		id: "cyber",
+		label: "赛博 / 暗黑",
+		prompt: "cyberpunk style, neon lights, dark atmosphere, high contrast, futuristic city, cool tones",
+		layoutHint: "页漫/全彩"
+	}
+];
+function getComicStylePrompt(styleId) {
+	if (!styleId) return "";
+	return COMIC_STYLE_PRESETS.find((s) => s.id === styleId)?.prompt ?? "";
+}
+//#endregion
 //#region src/engine.ts
 /**
 * Novel engine — the host half's core: LLM-driven story-bible extraction,
@@ -1116,7 +1166,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);
@@ -1214,6 +1265,7 @@ function bibleSystemPrompt() {
 		"3. 世界规则覆盖力量体系、金手指机制、势力、地理等所有硬性规则，逐条列出。",
 		"4. 红线列出大纲中明确禁止的内容（如无后宫、不圣母、无无脑碾压等）。",
 		"5. 风格列出叙事基调、节奏、POV 等写作风格要点。",
+		"6. 角色名必须用正文/编年录中的真实姓名；若大纲只写「主角」未点名，而已写章节或编年录中有名字，则用该真实姓名；禁止输出「主角（描述）」这类把身份塞进名字的占位名。",
 		"输出必须是合法 JSON 对象，不要输出任何其他文字或 Markdown 代码块标记。",
 		"重要：所有字符串值内部不得包含换行符（不要用多行字符串），JSON 必须在一段内完整结束。",
 		"重要：直接输出 JSON 结果本身，不要把思考过程或推理内容写在输出里。",
@@ -1222,8 +1274,21 @@ function bibleSystemPrompt() {
 	].join("\n");
 }
 /** Extract the story bible from an outline. */
-async function extractBible(ctx, config, outline) {
-	const user = `请为下面这部小说提炼设定圣经：\n\n${outline}`;
+async function extractBible(ctx, config, outline, project) {
+	const written = (project?.chapters ?? []).filter((c) => c.status !== "pending" && c.status !== "generating" && c.file !== void 0);
+	const excerpts = [];
+	for (const chapter of written.slice(0, 3)) {
+		const body = readChapterFile(config.outputDir, chapter);
+		if (body === void 0) continue;
+		const text = body.replace(/^#.*$/gm, "").trim();
+		if (text.length > 0) excerpts.push(`第${chapter.no}章《${chapter.title}》\n${text.slice(0, 2200)}`);
+	}
+	const facts = (project?.facts ?? []).slice(-40);
+	const user = [
+		`请为下面这部小说提炼设定圣经：\n\n${outline}`,
+		facts.length > 0 ? `\n\n【已写章节事实（编年录）】用于确认真实角色姓名与已确立设定；忠于大纲，不要新增大纲外设定：\n${facts.map((f) => `[第${f.chapterNo}章] ${f.text.slice(0, 100)}`).join("\n")}` : "",
+		excerpts.length > 0 ? `\n\n【已写章节正文摘录】角色姓名、身份以正文为准（大纲未点名时用正文里的真实姓名，禁止用「主角（描述）」占位名）：\n${excerpts.join("\n\n")}` : ""
+	].filter((s) => s !== "").join("\n");
 	const raw = parseJsonObject(await complete(ctx, config, {
 		system: bibleSystemPrompt(),
 		user,
@@ -1244,6 +1309,10 @@ async function extractBible(ctx, config, outline) {
 		relations: typeof entry.relations === "string" ? entry.relations : "",
 		knowledge: strArray(entry.knowledge)
 	})).filter((card) => card.name !== "") : [];
+	const realProtagonist = (project?.roles ?? []).find((r) => r.roleLabel === "protagonist")?.name?.trim();
+	if (realProtagonist !== void 0 && realProtagonist !== "") {
+		for (const card of characters) if (card.role === "protagonist" && /^(主角|未命名)/.test(card.name)) card.name = realProtagonist;
+	}
 	const bible = {
 		genre: typeof raw.genre === "string" ? raw.genre : "",
 		worldRules: strArray(raw.worldRules),
@@ -1416,17 +1485,18 @@ async function planChapters(ctx, config, project, chapterCount, volumeNo, output
 		} catch {}
 	}
 	const outlineBlock = continuation ? (() => {
-		const cut = project.outline.indexOf("七、关键剧情桥段");
-		if (cut > 1500) return project.outline.slice(0, cut).trimEnd() + "\n（大纲后续剧情桥段与分卷细节从略；续写请以「上一章结尾原文」与「最新剧情状态」为剧情起点）";
-		return project.outline.slice(0, 3e3) + "\n…（大纲过长已节选）";
+		if (project.outline.length <= 2e4) return project.outline;
+		const cut = project.outline.indexOf("十、全书核心弹幕记忆梗");
+		if (cut > 1500) return project.outline.slice(0, cut).trimEnd() + "\n（大纲过长，末尾记忆梗从略）";
+		return project.outline.slice(0, 8e3) + "\n…（大纲过长已节选）";
 	})() : project.outline;
 	const user = [
 		"请为下面这部小说规划章节。",
 		volume !== void 0 ? `本次只规划第 ${volume.no} 卷《${volume.title}》的章节：\n${volume.summary}` : continuation ? `本书已有 ${existing.length} 章已规划/已写作（见下方「已有章节」）。请规划**后续**章节：从第 ${startNo} 章开始。` : "请规划全书开篇章节。",
-		continuation ? "【续写硬性要求】已有章节的剧情不得重写或重复，章节标题也不得与已有章节重复。以下情节均已在已有章节中发生过，后续章节**绝对不得再次出现**：穿越、暴雨送餐、滴血认主/古玉认主、首次进入墟境、用废铁淬炼首件法器、绝境肉身入鼎洗炼（该机缘已用尽）、杀死白袍弟子与灰衣随从、藏尸水沟。" : "",
+		continuation ? "【续写硬性要求】已有章节的剧情不得重写或重复，章节标题也不得与已有章节重复。以下情节均已在已有章节中发生过，后续章节**绝对不得再次出现**：穿越、暴雨送餐、滴血认主/古玉认主、首次进入墟境、用废铁淬炼首件法器、绝境肉身入鼎洗炼（该机缘已用尽）、杀死白袍弟子与灰衣随从、藏尸水沟。\n若本次规划已进入大纲的收尾区间（接近全书规划总章数），最后 5-10 章必须按大纲推进到大结局（终极抉择/清算/双结局等），**禁止以悬念、逃离、未解之谜收尾**——收尾区间按大纲卷定位判断，不以当前剧情是否“感觉像结尾”为准。" : "",
 		prevTail !== "" ? `【上一章（第 ${startNo - 1} 章）结尾原文】第 ${startNo} 章必须紧接此状态继续，从新的事件写起，不得回顾重述：\n${prevTail}` : "",
 		latestFacts !== "" ? `【最新剧情状态（本书编年录，第 ${startNo - 1} 章结尾的事实）】规划续写时必须以此为起点，时间线、人物状态与地点衔接一致：\n${latestFacts}` : "",
-		continuation ? "已有章节：\n" + existing.map((c) => {
+		continuation ? "已有章节（共 " + existing.length + " 章；仅列最近 80 章，更早的以标题计数为准，剧情以「编年录」为权威）：\n" + existing.slice(-80).map((c) => {
 			const sm = c.summary !== void 0 && c.summary !== "" ? `（${c.summary.slice(0, 120)}）` : "";
 			return `第${c.no}章《${c.title}》${sm}`;
 		}).join("\n") : "",
@@ -1535,7 +1605,7 @@ async function reviewChapter(ctx, config, project, outputDir, chapterNo) {
 	const score = typeof raw.score === "number" ? Math.max(0, Math.min(100, Math.round(raw.score))) : 60;
 	const report = {
 		score,
-		passed: score >= config.reviewPassScore,
+		passed: score >= config.reviewPassScore || issues.every((i) => i.severity !== "high") && score >= 60,
 		verdict: typeof raw.verdict === "string" ? raw.verdict.slice(0, 200) : "",
 		issues,
 		reviewedAt: (/* @__PURE__ */ new Date()).toISOString()
@@ -1573,7 +1643,7 @@ async function reviewChapterText(ctx, config, project, text, previousReport) {
 		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;
+	let passed = score >= config.reviewPassScore || issues.every((i) => i.severity !== "high") && score >= 60;
 	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))));
@@ -1744,7 +1814,7 @@ async function extractRoles(ctx, config, project) {
 		"覆盖原则：所有在编年录/章节中实际出场或有名有姓的角色都应收录；无名的功能性人物（如\"矮胖姑娘\"）用其身份简称收录并标注。",
 		"数量控制：最多输出 10 个角色，宁缺毋滥；路人级一次带过的不要收录。",
 		"每个角色输出：",
-		"1. name：角色名（或身份简称）。",
+		"1. name：角色名（或身份简称）。主角/有名配角必须用正文中实际出现的人名（如「沈放」），禁止用「主角（38岁超市理货员）」这类把身份塞进名字的占位名；正文确实没点名时才可用身份简称（如「富商」「灰衣老人」）。",
 		"2. roleLabel：定位——protagonist=主角；female_lead=女主（唯一知己/感情线核心，无后宫前提下只此一位）；female_support=重要女配；support=普通配角；antagonist=反派；extra=路人/背景。",
 		"3. identity：身份一句话（宗门/势力/血脉/职业）。",
 		"4. traits：3-6 个性格标签。",
@@ -1760,12 +1830,20 @@ async function extractRoles(ctx, config, project) {
 	].join("\n");
 	const written = project.chapters.filter((c) => c.status !== "pending" && c.status !== "generating");
 	const existingRoles = project.roles ?? [];
+	const excerptParts = [];
+	for (const chapter of written.slice(0, 3)) {
+		const body = readChapterFile(config.outputDir, chapter);
+		if (body === void 0) continue;
+		const text = body.replace(/^#.*$/gm, "").trim();
+		if (text.length > 0) excerptParts.push(`第${chapter.no}章《${chapter.title}》\n${text.slice(0, 2400)}`);
+	}
 	const raw = parseJsonArray(await complete(ctx, config, {
 		system,
 		user: [
 			`书名：《${project.bookName}》`,
 			existingRoles.length > 0 ? `已收录角色（跳过，不要输出）：${existingRoles.map((r) => r.name).join("、")}` : "",
 			`大纲（节选前 3000 字）：\n${project.outline.slice(0, 3e3)}`,
+			excerptParts.length > 0 ? `已写正文摘录（角色姓名/身份/关系以正文为准）：\n${excerptParts.join("\n\n")}` : "",
 			project.bible !== void 0 && project.bible.characters.length > 0 ? `已有角色卡（补充信息）：\n${project.bible.characters.map((c) => `- ${c.name}（${c.role}）：${c.traits.join("、")}${c.goals !== "" ? `；目标：${c.goals}` : ""}`).join("\n")}` : "",
 			(project.facts ?? []).length > 0 ? `编年录（最近 60 条）：\n${(project.facts ?? []).slice(-60).map((f) => `[第${f.chapterNo}章] ${f.text.slice(0, 80)}`).join("\n")}` : "",
 			written.length > 0 ? `已写章节标题（${written.length} 章）：\n${written.map((c) => `第${c.no}章《${c.title}》`).join("、")}` : "",
@@ -1801,6 +1879,75 @@ async function extractRoles(ctx, config, project) {
 	}
 	return roles;
 }
+/** ✨ AI 从全书提炼场景库：正文/编年录 → 高频重要场景的结构化视觉锚点。 */
+async function extractScenes(ctx, config, project) {
+	const system = [
+		"你是一位网文漫剧场景导演。根据本书的大纲、编年录与已写章节摘录，提炼「镜头场景」——漫剧分镜/生图时每个镜头要知道\"在哪、什么时间光态、拍什么情节、人物什么状态\"。",
+		"按五幕结构覆盖全书核心场景（短篇 10 章内可少于五幕，按实际剧情组织）：第一幕后场/核心主场、第二幕对外卖场/营业区、第三幕禁忌区域/地下深仓、第四幕外部人间世界（短暂出逃）、第五幕回归与抉择。",
+		"每个场景必须是「镜头场景」而非仅场地：给出该场景的关键情节镜头（人物动作+情绪+镜头推进）。",
+		"数量控制：最多输出 8 个场景；每个场景必须能对应到正文实际出现过的地点与情节，不得凭空虚构。",
+		"每个场景输出：",
+		"1. name：场景名（地点+光态，如「后场通道·装卸口（雨夜）」）。",
+		"2. act：幕归属（第一幕后场/第二幕卖场/第三幕深仓/第四幕外界/第五幕抉择）。",
+		"3. moment：时间光态（夜间闭店后/雨夜/凌晨/频闪灯…）。",
+		"4. summary：一句话定位（空间类型/功能/氛围）。",
+		"5. beats：关键情节镜头 1-3 条（人物动作+情绪+镜头推进，如\"沈放佝偻站在货架过道，镜头推近，情绪从漠然过渡到压抑悲伤\"）。",
+		"6. characterState：主角/关键角色在该场景的状态一句话（含标志物细节如标签磨损、手腕红痕）。",
+		"7. elements：环境构成数组 3-6 项（空间结构/陈设/标志物）。",
+		"8. palette：色调与光影数组 2-4 项（颜色词，可附 HEX）。",
+		"9. moods：氛围关键词 2-4 个（压抑/神秘/空旷/悲凉…）。",
+		"10. zh：中文生图提示词（连贯一段，写实电影感，含环境/光线/氛围/人物状态）。",
+		"11. en：英文生图提示词（booru 风格逗号分隔，含 photorealistic/cinematic）。",
+		"12. tags：3-6 个关键标签。",
+		"13. source：依据来源说明（哪几章哪些描写）。",
+		"若故事存在结局抉择（如双分支），最后 1-2 个场景应为「抉择场景」，zh 里写明分支 A/B 两种画面。",
+		"输出必须是合法 JSON 数组，不要输出其他文字：[{\"name\":\"...\", \"act\":\"...\", \"moment\":\"...\", \"summary\":\"...\", \"beats\":[...], \"characterState\":\"...\", \"elements\":[...], \"palette\":[...], \"moods\":[...], \"zh\":\"...\", \"en\":\"...\", \"tags\":[...], \"source\":\"...\"}]",
+		"重要：所有字符串值内部不得包含换行符；直接输出 JSON 结果本身。"
+	].join("\n");
+	const written = project.chapters.filter((c) => c.status !== "pending" && c.status !== "generating");
+	const excerptParts = [];
+	for (const chapter of written.slice(0, 4)) {
+		const body = readChapterFile(config.outputDir, chapter);
+		if (body === void 0) continue;
+		const text = body.replace(/^#.*$/gm, "").trim();
+		if (text.length > 0) excerptParts.push("第" + chapter.no + "章《" + chapter.title + "》\n" + text.slice(0, 1800));
+	}
+	const raw = parseJsonArray(await complete(ctx, config, {
+		system,
+		user: [
+			"书名：《" + project.bookName + "》",
+			(project.facts ?? []).length > 0 ? "编年录（最近 80 条，场景地点以这里为准）：\n" + (project.facts ?? []).slice(-80).map((f) => "[第" + f.chapterNo + "章] " + f.text.slice(0, 80)).join("\n") : "",
+			excerptParts.length > 0 ? "已写正文摘录（场景描写以正文为准）：\n" + excerptParts.join("\n") : "",
+			"只输出 JSON 数组。"
+		].filter((s) => s !== "").join("\n"),
+		temperature: .4,
+		maxTokens: Math.max(config.maxTokens, 12e3)
+	}));
+	const strArr = (v) => Array.isArray(v) ? v.filter((x) => typeof x === "string" && x.trim() !== "") : [];
+	const str = (v) => typeof v === "string" ? v.trim() : "";
+	const scenes = [];
+	for (const entry of raw) {
+		if (typeof entry !== "object" || entry === null) continue;
+		const name = str(entry.name).slice(0, 40);
+		if (name === "") continue;
+		scenes.push({
+			name,
+			act: str(entry.act).slice(0, 40),
+			moment: str(entry.moment).slice(0, 60),
+			summary: str(entry.summary).slice(0, 120),
+			beats: strArr(entry.beats).map((t) => t.slice(0, 120)).slice(0, 3),
+			characterState: str(entry.characterState).slice(0, 160),
+			elements: strArr(entry.elements).map((t) => t.slice(0, 60)).slice(0, 6),
+			palette: strArr(entry.palette).map((t) => t.slice(0, 40)).slice(0, 4),
+			moods: strArr(entry.moods).map((t) => t.slice(0, 20)).slice(0, 4),
+			zh: str(entry.zh).slice(0, 800),
+			en: str(entry.en).slice(0, 600),
+			tags: strArr(entry.tags).map((t) => t.slice(0, 24)).slice(0, 6),
+			source: str(entry.source).slice(0, 120)
+		});
+	}
+	return scenes;
+}
 /**
 * 为单个角色提炼「动漫形象描述词」：扫描该角色出场的已写章节正文，
 * 截取含外貌描写的段落，交给 LLM 提炼中文描述 + 英文绘图标签。
@@ -1809,6 +1956,72 @@ 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 roleText = `${role.name} ${role.identity ?? ""}`;
+	const colorWords = [
+		"深灰",
+		"灰蓝",
+		"灰",
+		"蓝",
+		"白",
+		"黑",
+		"红",
+		"青",
+		"紫",
+		"银",
+		"金",
+		"黄",
+		"绿",
+		"粉",
+		"棕"
+	];
+	const garmentWords = [
+		"工装",
+		"西装",
+		"定制西装",
+		"袍",
+		"裙",
+		"衫",
+		"衣",
+		"裤",
+		"靴",
+		"鞋",
+		"帽",
+		"腰带",
+		"制服",
+		"外套",
+		"马甲",
+		"夹克"
+	];
+	const roleWords = [
+		"女人",
+		"男人",
+		"老者",
+		"老人",
+		"中年",
+		"青年",
+		"少女",
+		"姑娘",
+		"男子",
+		"女子",
+		"工人",
+		"路人",
+		"购买者"
+	];
+	const locationWords = [
+		"别墅",
+		"小区",
+		"街区"
+	];
+	const identityTokens = (role.identity ?? "").split(/[，,。\s]+/).filter((t) => t.length >= 2);
+	const searchTokens = Array.from(/* @__PURE__ */ new Set([
+		roleName,
+		...identityTokens,
+		...colorWords.filter((w) => roleText.includes(w)),
+		...garmentWords.filter((w) => roleText.includes(w)),
+		...roleWords.filter((w) => roleText.includes(w)),
+		...locationWords.filter((w) => roleText.includes(w))
+	])).filter((t) => t.length >= 2);
+	const matchesRole = (para) => para.includes(roleName) || searchTokens.some((tok) => para.includes(tok));
 	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) {
@@ -1818,7 +2031,7 @@ async function extractRoleVisual(ctx, config, project, outputDir, roleName) {
 		let perChapter = 0;
 		for (const para of paras) {
 			if (perChapter >= 2 || excerpts.length >= 12) break;
-			if (!para.includes(roleName)) continue;
+			if (!matchesRole(para)) continue;
 			if (appearanceHints.test(para) || excerpts.length < 4) {
 				excerpts.push({
 					no: chapter.no,
@@ -1832,17 +2045,27 @@ async function extractRoleVisual(ctx, config, project, outputDir, roleName) {
 	if (excerpts.length === 0) throw new Error(`正文中未找到「${roleName}」的出场描写（仅搜索最近 60 章），请确认角色名与正文一致`);
 	const raw = parseJsonObject(await complete(ctx, config, {
 		system: [
-			"你是一位动漫角色设定师。根据网文正文中该角色的实际外貌描写，提炼「动漫形象描述词」，用于 AI 绘图（NovelAI / Stable Diffusion / Midjourney / 豆包等）生成一致的角色立绘。",
+			"你是一位动漫角色设定师与 AI 绘图提示词工程师。根据网文正文中该角色的实际外貌描写，输出「形象锚点」与「四类生图提示词」——一次完成，用于 AI 绘图（NovelAI / Stable Diffusion / Midjourney / 豆包等）生成一致的角色立绘。",
 			"硬性要求（依据优先）：",
 			"1. 发色/发型/瞳色/服装/气质/标志物必须来自提供的正文段落，不得凭空发明。",
-			"2. 正文未明确写到的项目（如瞳色没写），用「未定」标注，不要编造。",
-			"3. 服装优先取正文明确出现的（颜色+款式），多次出现取最常穿的组合。",
-			"输出三个部分：",
-			"- zh：中文外貌描述，一段连贯文字（60-150 字）：发色发型、瞳色、脸型气质、服装（颜色款式）、身材、标志性物件。",
-			"- en：英文绘图标签，booru 风格、逗号分隔、小写，30-50 个标签：含性别（1boy/1girl）、发色、发型、瞳色、服装（如 chinese hanfu / daoist robe）、气质、背景无关项。不要输出负面提示词。",
+			"2. 正文未明确写到的项目（如瞳色没写、身高没写），用「未定」标注或直接不写，不要编造数值。",
+			"3. 服装优先取正文明确出现的（颜色+款式），多次出现取最常穿的组合；服装按分件组织（上身/下身/鞋/配饰）。",
+			"4. 标志物（标签/印记/饰品）必须出现在每段提示词中——它们是一致性的命根子。",
+			"【本书视觉规则】（必须内嵌进每段提示词，保证设定不跑偏）：",
+			...(project.visualRules ?? []).map((r) => "- " + r),
+			"输出六部分：",
+			"- zh：中文形象锚点，一段连贯文字（60-150 字）：发色发型、瞳色、脸型气质、服装（颜色款式）、身材、标志性物件。",
+			"- en：英文形象锚点，booru 风格、逗号分隔、小写，30-50 个标签：含性别（1boy/1girl）、发色、发型、瞳色、服装、气质、标志物。不要输出负面提示词。",
 			"- tags：中文关键标签数组，5-10 个（如 [\"黑发\",\"束发\",\"青色道袍\",\"清秀\",\"腰悬古玉\"]）。",
 			"- source：说明依据（如\"第1章/第8章外貌描写；瞳色未明确\"）。",
-			"输出必须是合法 JSON 对象：{\"zh\": \"...\", \"en\": \"...\", \"tags\": [...], \"source\": \"...\"}",
+			"- expressions：该角色在本书剧情中需要的情绪表情清单数组，6-12 个（如 [\"疲惫\",\"麻木\",\"压抑悲伤\",\"皱眉\",\"紧绷\",\"放空\"]），依据正文情绪描写与角色处境推断。",
+			"- promptKit：四类精修提示词（字段化+出图约束，参考示例结构）：",
+			"  · portrait 立绘：角色设计稿定位，纯白纯色背景，全身完整无裁切，无多余杂物；字段流：年龄感、身高（有依据才写）、发型发色、胡茬、眼眸、面部气质、上身服装分件（含磨损）、下身、鞋、标志物细节。",
+			"  · sheet 四视图：同一角色的 正面/左侧面/右侧面/背面 四视图设定表（character sheet），纯白背景，全身完整，四个视角分别描述，服装与标志物细节完整展示。",
+			"  · expressions 表情：每个表情一段，脸部特写（头部到锁骨），纯白背景，五官与角色定稿完全一致，只换情绪表达（眼神/嘴角/眉），皮肤纹理细节完整，无多余杂物。",
+			"  · details 细节：多组局部细节集合参考图（一张图多个局部框），纯白背景；把该角色全部标志物逐项列出（如标签/印记/工牌/袖口磨损/鞋），每项一句特写描述；细节清晰锐利，角色细节参考稿，无多余杂物。",
+			"promptKit 每段 zh：连贯中文 60-150 字；en：booru 标签 30-50 个。",
+			"输出必须是合法 JSON 对象：{\"zh\": \"...\", \"en\": \"...\", \"tags\": [...], \"source\": \"...\", \"expressions\": [...], \"promptKit\": {\"portrait\": {\"zh\":\"...\", \"en\":\"...\"}, \"sheet\": {\"zh\":\"...\", \"en\":\"...\"}, \"expressions\": [{\"name\":\"疲惫\",\"zh\":\"...\",\"en\":\"...\"}], \"details\": {\"zh\":\"...\", \"en\":\"...\"}}}",
 			"重要：所有字符串值内部不得包含换行符，JSON 必须在一段内完整结束。",
 			"重要：直接输出 JSON 结果本身，不要把思考过程写在输出里。"
 		].join("\n"),
@@ -1855,21 +2078,128 @@ async function extractRoleVisual(ctx, config, project, outputDir, roleName) {
 			"只输出 JSON 对象。"
 		].join("\n\n"),
 		temperature: .4,
-		maxTokens: Math.max(config.maxTokens, 4e3)
+		maxTokens: Math.max(config.maxTokens, 12e3)
 	}));
 	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) : "";
+	const expressions = Array.isArray(raw.expressions) ? raw.expressions.filter((e) => typeof e === "string" && e.trim() !== "").map((e) => e.trim().slice(0, 12)).slice(0, 12) : [];
+	const str = (v) => typeof v === "string" ? v.trim() : "";
+	const pair = (v) => {
+		const o = typeof v === "object" && v !== null ? v : {};
+		return {
+			zh: str(o.zh).slice(0, 800),
+			en: str(o.en).slice(0, 1200)
+		};
+	};
+	const kitRaw = typeof raw.promptKit === "object" && raw.promptKit !== null ? raw.promptKit : {};
+	const kitExpr = Array.isArray(kitRaw.expressions) ? kitRaw.expressions.filter((e) => typeof e === "object" && e !== null) : [];
+	let promptKit;
+	try {
+		promptKit = {
+			portrait: pair(kitRaw.portrait),
+			sheet: pair(kitRaw.sheet),
+			expressions: kitExpr.map((e) => ({
+				name: str(e.name).slice(0, 12) || "表情",
+				zh: str(e.zh).slice(0, 800),
+				en: str(e.en).slice(0, 1200)
+			})).slice(0, 12),
+			details: pair(kitRaw.details)
+		};
+	} catch {
+		promptKit = void 0;
+	}
 	if (zh === "" || en === "") throw new Error("形象描述提炼失败：LLM 未返回有效 JSON");
 	return {
 		zh,
 		en,
 		tags,
-		source
+		source,
+		expressions,
+		promptKit
 	};
 }
 /**
+* 角色四类生图提示词精修包（promptKit）：以锚点 + 表情清单 + 视觉规则为输入，
+* LLM 产出 立绘/四视图/表情×N/细节 四套 zh+en 提示词（比前端拼装更精炼）。
+*/
+async function generateRolePromptKit(ctx, config, project, roleName) {
+	const role = (project.roles ?? []).find((r) => r.name === roleName);
+	if (role === void 0) throw new Error(`角色「${roleName}」不在角色库中`);
+	if (role.imagePrompt === void 0) throw new Error(`角色「${roleName}」还没有形象锚点，请先生成锚点`);
+	const raw = parseJsonObject(await complete(ctx, config, {
+		system: [
+			"你是一位 AI 绘图提示词工程师。基于给定角色的形象锚点、表情清单与本书视觉规则，输出四类生图提示词（每类 zh+en 各一段）。",
+			"四类：",
+			"1. portrait 立绘：全身/半身正视图，含完整服装与标志物。",
+			"2. sheet 四视图：同一角色的 正面/左侧面/右侧面/背面 四视图设定表（character sheet），纯白背景，四个视角分别描述。",
+			"3. expressions 表情：每个表情一段，脸部特写（头部到锁骨），纯白背景，五官与角色定稿完全一致，只换情绪表达（眼神/嘴角/眉），皮肤纹理细节完整，无多余杂物。",
+			"4. details 细节：多组局部细节集合参考图（一张图多个局部框），纯白背景；把该角色全部标志物逐项列出，每项一句特写描述；细节清晰锐利，角色细节参考稿，无多余杂物。",
+			"【本书视觉规则】（必须内嵌进每段提示词，保证设定不跑偏）：",
+			...(project.visualRules ?? []).map((r) => "- " + r),
+			"zh 要求：连贯中文，写实电影感，60-150 字/段；en 要求：booru 风格逗号分隔标签，30-50 个/段。",
+			"输出必须是合法 JSON 对象：{\"portrait\": {\"zh\": \"...\", \"en\": \"...\"}, \"sheet\": {\"zh\": \"...\", \"en\": \"...\"}, \"expressions\": [{\"name\": \"疲惫\", \"zh\": \"...\", \"en\": \"...\"}], \"details\": {\"zh\": \"...\", \"en\": \"...\"}}",
+			"重要：所有字符串值内部不得包含换行符；直接输出 JSON 结果本身。"
+		].join("\n"),
+		user: [
+			`角色：${role.name}（${role.identity ?? ""}）`,
+			`中文锚点：${role.imagePrompt.zh}`,
+			`英文锚点：${role.imagePrompt.en}`,
+			`关键标签：${role.imagePrompt.tags.join("、")}`,
+			`表情清单：${(role.expressions ?? []).join("、") || "（未提供，按角色气质推断 6 个）"}`,
+			"只输出 JSON 对象。"
+		].join("\n\n"),
+		temperature: .4,
+		maxTokens: Math.max(config.maxTokens, 12e3)
+	}));
+	const str = (v) => typeof v === "string" ? v.trim() : "";
+	const pair = (v) => {
+		const o = typeof v === "object" && v !== null ? v : {};
+		return {
+			zh: str(o.zh).slice(0, 800),
+			en: str(o.en).slice(0, 1200)
+		};
+	};
+	const expressionsRaw = Array.isArray(raw.expressions) ? raw.expressions.filter((e) => typeof e === "object" && e !== null) : [];
+	const kit = {
+		portrait: pair(raw.portrait),
+		sheet: pair(raw.sheet),
+		expressions: expressionsRaw.map((e) => ({
+			name: str(e.name).slice(0, 12) || "表情",
+			zh: str(e.zh).slice(0, 800),
+			en: str(e.en).slice(0, 1200)
+		})).slice(0, 12),
+		details: pair(raw.details)
+	};
+	if (kit.portrait.zh === "" || kit.portrait.en === "") throw new Error("提示词精修失败：LLM 未返回有效 JSON");
+	return kit;
+}
+/** ✨ 从道藏/红线提炼「视觉世界观规则」：生图/生视频必须遵守的设定纠偏（如"商品=人，禁止常规超市商品"）。 */
+async function extractVisualRules(ctx, config, project) {
+	const system = [
+		"你是一位 AI 绘图的视觉规则设计师。本书的设定是\"反常识\"的，生图/生视频模型默认会画成现实世界的样子，你需要提炼 3-6 条「视觉规则」钉住本书的视觉世界观。",
+		"规则要求：",
+		"1. 每条必须可执行：明确\"画面里必须出现什么/禁止出现什么\"（如\"货架上的一切商品都是活人，禁止画成罐头/饮料/日用品\"）。",
+		"2. 覆盖本书最容易被模型画错的 2-4 个核心反常识点。",
+		"3. 每条 40 字内，禁止泛泛而谈。",
+		"输出必须是合法 JSON 数组：[\"规则1\", \"规则2\", ...]，不要输出其他文字。"
+	].join("\n");
+	const bible = project.bible;
+	return parseJsonArray(await complete(ctx, config, {
+		system,
+		user: [
+			`书名：《${project.bookName}》`,
+			`题材：${bible?.genre ?? ""}`,
+			bible !== void 0 && bible.worldRules.length > 0 ? `世界规则：\n${bible.worldRules.map((r) => "- " + r).join("\n")}` : "",
+			bible !== void 0 && bible.redLines.length > 0 ? `红线：\n${bible.redLines.map((r) => "- " + r).join("\n")}` : "",
+			"只输出 JSON 数组。"
+		].filter((s) => s !== "").join("\n\n"),
+		temperature: .3,
+		maxTokens: Math.max(config.maxTokens, 4e3)
+	})).map((r) => typeof r === "string" ? r.trim().slice(0, 80) : "").filter((r) => r !== "").slice(0, 8);
+}
+/**
 * 开书想法 → AI 大纲：输入一句话想法，生成 2-3 个方向不同、可直接开书的完整大纲方案。
 * @param count 本次生成几个（默认 3，最多 3）
 * @param exclude 已暂留方案的剧情方向/卖点摘要（换批时避开，防止重复）
@@ -2068,134 +2398,49 @@ async function breakdownBook(ctx, config, project, outputDir, scope = "recent",
 		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)}`;
+async function generateRoleReferenceImage(ctx, config, project, outputDir, name, style = "") {
+	const role = project.roles?.find((r) => r.name === name);
+	if (role === void 0) throw new Error(`角色 ${name} 不存在`);
+	if (role.imagePrompt === void 0) throw new Error(`角色 ${name} 还没有形象锚点，请先生成锚点`);
+	if (config.imageApiEnabled !== true) throw new Error("豆包生图未启用，请在设置中开启");
+	const apiKey = config.imageApiKey;
+	const model = config.imageApiModel;
+	if (apiKey === void 0 || apiKey === "" || model === void 0 || model === "") throw new Error("请先在设置中配置豆包 API Key 和生图模型");
+	const stylePrompt = getComicStylePrompt(style);
+	const prompt = [
+		role.imagePrompt.zh,
+		role.imagePrompt.en,
+		role.imagePrompt.tags.join(", "),
+		stylePrompt,
+		"character reference sheet, front view, clean background, consistent design"
+	].filter(Boolean).join(", ");
+	const res = await fetch("https://ark.cn-beijing.volces.com/api/v3/images/generations", {
+		method: "POST",
+		headers: {
+			"Content-Type": "application/json",
+			Authorization: `Bearer ${apiKey}`
+		},
+		body: JSON.stringify({
+			model,
+			prompt,
+			response_format: "url",
+			size: "2K",
+			stream: false,
+			watermark: false
+		})
 	});
-	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 (!res.ok) {
+		const text = await res.text();
+		throw new Error(`豆包生图失败（${res.status}）：${text}`);
 	}
-	if (episodes.length === 0) throw new Error("分集计划生成失败：LLM 未返回有效集数");
-	return {
-		strategy: str(raw.strategy, "（按内容判断赛道节奏）"),
-		episodes,
-		chaptersScanned: chapters.length
-	};
+	const url = (await res.json()).data?.[0]?.url;
+	if (url === void 0 || url === "") throw new Error("豆包生图未返回图片 URL");
+	const imgRes = await fetch(url);
+	if (!imgRes.ok) throw new Error("下载豆包图片失败");
+	const buf = Buffer.from(await imgRes.arrayBuffer());
+	const dataUrl = `data:${imgRes.headers.get("content-type") || "image/jpeg"};base64,${buf.toString("base64")}`;
+	role.imageUrl = dataUrl;
+	return dataUrl;
 }
 /** 🩺 剧情健康检查：基于已写章节数/各线状态/编年录，判断是否需要新线及添加时机。 */
 async function analyzePlotlineHealth(ctx, config, project) {
@@ -2747,15 +2992,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);
 }
@@ -3648,6 +3899,8 @@ const NOVEL_API = {
 	plotlines: "/api/dsh-novel-forge/plotlines",
 	/** 角色库：AI 提炼 / 采纳 / 更新 / 删除。 */
 	roles: "/api/dsh-novel-forge/roles",
+	scenes: "/api/dsh-novel-forge/scenes",
+	visualRules: "/api/dsh-novel-forge/visual-rules",
 	/** 作者复盘补跑：对已写章节补齐 authorReview（全书流式 / 单章 JSON）。 */
 	reviewBackfill: "/api/dsh-novel-forge/review/backfill",
 	/** 章节复位：generating 卡死 → pending（可重新生成）。 */
@@ -3661,9 +3914,8 @@ const NOVEL_API = {
 	/** 拆书分析：对已写章节做结构/人物/文风/卖点四维体检（两阶段：源笔记→分节分析）。 */
 	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。 */
@@ -4522,6 +4774,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)) {
@@ -4573,7 +4831,8 @@ function makeRoutes(deps) {
 					...project,
 					facts: (project.facts ?? []).slice(-80)
 				} : void 0,
-				generatedFiles: listChapterFiles(config.outputDir)
+				generatedFiles: listChapterFiles(config.outputDir),
+				audit: auditState
 			});
 		}
 	};
@@ -4649,7 +4908,7 @@ function makeRoutes(deps) {
 				return;
 			}
 			try {
-				const bible = await extractBible(ctx, config, outline);
+				const bible = await extractBible(ctx, config, outline, project);
 				const now = (/* @__PURE__ */ new Date()).toISOString();
 				const next = project ?? createProject(outline);
 				next.bible = bible;
@@ -5478,13 +5737,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 });
 			}
 		}
@@ -5907,7 +6194,71 @@ 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") {
+			else if (op === "image") {
+				const name = body?.name?.trim();
+				const dataUrl = body?.dataUrl?.trim();
+				if (name === void 0 || name === "") {
+					writeJson(res, 400, { error: "name（角色名）必填" });
+					return;
+				}
+				if (dataUrl === void 0 || dataUrl === "") {
+					writeJson(res, 400, { error: "dataUrl（参考图）必填" });
+					return;
+				}
+				const role = project.roles.find((r) => r.name === name);
+				if (role === void 0) {
+					writeJson(res, 404, { error: `角色 ${name} 不存在` });
+					return;
+				}
+				const label = body?.label?.trim() ?? "";
+				if (label !== "") {
+					role.gallery ??= [];
+					role.gallery = role.gallery.filter((g) => g.label !== label);
+					role.gallery.push({
+						label,
+						dataUrl
+					});
+					if (label === "立绘" || label.includes("立绘")) role.imageUrl = dataUrl;
+				} else role.imageUrl = dataUrl;
+				project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+				saveProject(config.outputDir, project);
+				writeJson(res, 200, {
+					roles: project.roles,
+					imageUrl: role.imageUrl
+				});
+				return;
+			} else if (op === "removeImage") {
+				const name = body?.name?.trim();
+				const label = body?.label?.trim() ?? "";
+				const role = project.roles.find((r) => r.name === name);
+				if (role !== void 0) if (label !== "") {
+					role.gallery = (role.gallery ?? []).filter((g) => g.label !== label);
+					if (label === "立绘" || label.includes("立绘")) role.imageUrl = void 0;
+				} else role.imageUrl = void 0;
+				project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+				saveProject(config.outputDir, project);
+				writeJson(res, 200, { roles: project.roles });
+				return;
+			} else if (op === "imageGenerate") {
+				const name = body?.name?.trim();
+				if (name === void 0 || name === "") {
+					writeJson(res, 400, { error: "name（角色名）必填" });
+					return;
+				}
+				try {
+					const imageUrl = await generateRoleReferenceImage(ctx, config, project, config.outputDir, name, body?.style ?? "");
+					project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+					saveProject(config.outputDir, project);
+					writeJson(res, 200, {
+						roles: project.roles,
+						imageUrl
+					});
+					return;
+				} catch (error) {
+					writeJson(res, 500, { error: `角色参考图生成失败：${error.message}` });
+					return;
+				}
+			} else if (op === "visual") {
 				const name = body?.name?.trim();
 				if (name === void 0 || name === "") {
 					writeJson(res, 400, { error: "name（角色名）必填" });
@@ -5916,7 +6267,11 @@ function makeRoutes(deps) {
 				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;
+					if (role !== void 0) {
+						role.imagePrompt = visual;
+						if ((visual.expressions ?? []).length > 0) role.expressions = visual.expressions;
+						if (visual.promptKit !== void 0) role.promptKit = visual.promptKit;
+					}
 					project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
 					saveProject(config.outputDir, project);
 					writeJson(res, 200, {
@@ -5928,6 +6283,27 @@ function makeRoutes(deps) {
 					writeJson(res, 500, { error: `形象提炼失败：${error.message}` });
 					return;
 				}
+			} else if (op === "promptKit") {
+				const name = body?.name?.trim();
+				if (name === void 0 || name === "") {
+					writeJson(res, 400, { error: "name（角色名）必填" });
+					return;
+				}
+				try {
+					const kit = await generateRolePromptKit(ctx, config, project, name);
+					const role = project.roles.find((r) => r.name === name);
+					if (role !== void 0) role.promptKit = kit;
+					project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+					saveProject(config.outputDir, project);
+					writeJson(res, 200, {
+						roles: project.roles,
+						promptKit: kit
+					});
+					return;
+				} catch (error) {
+					writeJson(res, 500, { error: `提示词精修失败：${error.message}` });
+					return;
+				}
 			} else {
 				writeJson(res, 400, { error: "未知的 roles op" });
 				return;
@@ -6042,7 +6418,7 @@ function makeRoutes(deps) {
 					return;
 				}
 			}
-			const missing = project.chapters.filter((c) => c.status !== "pending" && c.status !== "generating" && c.authorReview === void 0);
+			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;
@@ -6150,46 +6526,97 @@ function makeRoutes(deps) {
 			}
 		}
 	};
-	/** 漫剧分镜生成：章节 → 角色锚点 + 分镜表（适配豆包/Seedance/SD）。 */
-	const storyboardRoute = {
+	/** 场景库：AI 提炼 / 采纳 / 更新 / 删除 / 图集。 */
+	const scenesRoute = {
 		kind: "exact",
-		path: NOVEL_API.storyboard,
+		path: NOVEL_API.scenes,
 		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 (project.scenes === void 0) project.scenes = [];
+			const op = body?.op;
+			if (op === "extract") try {
+				const candidates = await extractScenes(ctx, config, project);
+				writeJson(res, 200, {
+					scenes: project.scenes,
+					candidates
+				});
 				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}` });
+				writeJson(res, 500, { error: `场景提炼失败：${error.message}` });
+				return;
 			}
+			else if ((op === "adopt" || op === "update") && body?.scene !== void 0) {
+				const s = body.scene;
+				const idx = project.scenes.findIndex((x) => x.name === s.name);
+				if (idx === -1) project.scenes.push(s);
+				else project.scenes[idx] = s;
+			} else if (op === "remove" && body?.name !== void 0) project.scenes = project.scenes.filter((x) => x.name !== body.name);
+			else if (op === "image") {
+				const name = body?.name?.trim();
+				const dataUrl = body?.dataUrl?.trim();
+				if (name === void 0 || name === "" || dataUrl === void 0 || dataUrl === "") {
+					writeJson(res, 400, { error: "name（场景名）与 dataUrl 必填" });
+					return;
+				}
+				const scene = project.scenes.find((x) => x.name === name);
+				if (scene === void 0) {
+					writeJson(res, 404, { error: `场景 ${name} 不存在` });
+					return;
+				}
+				const label = body?.label?.trim() ?? "全景";
+				scene.gallery ??= [];
+				scene.gallery = scene.gallery.filter((g) => g.label !== label);
+				scene.gallery.push({
+					label,
+					dataUrl
+				});
+			} else if (op === "removeImage") {
+				const name = body?.name?.trim();
+				const label = body?.label?.trim() ?? "";
+				const scene = project.scenes.find((x) => x.name === name);
+				if (scene !== void 0 && label !== "") scene.gallery = (scene.gallery ?? []).filter((g) => g.label !== label);
+			} else {
+				writeJson(res, 400, { error: `未知操作 ${op}` });
+				return;
+			}
+			project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+			saveProject(config.outputDir, project);
+			writeJson(res, 200, { scenes: project.scenes });
 		}
 	};
-	/** 漫剧分集计划：读一卷 → 按故事弧线分集（高潮拆集/过渡并章）。 */
-	const storyboardPlanRoute = {
+	/** 视觉世界观规则：从道藏提炼（生图/生视频纠偏），或手动保存。 */
+	const visualRulesRoute = {
 		kind: "exact",
-		path: NOVEL_API.storyboardPlan,
+		path: NOVEL_API.visualRules,
 		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 须为正整数" });
+			if (body?.op === "extract") try {
+				const rules = await extractVisualRules(ctx, config, project);
+				project.visualRules = rules;
+				project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+				saveProject(config.outputDir, project);
+				writeJson(res, 200, { rules });
 				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}` });
+				writeJson(res, 500, { error: `视觉规则提炼失败：${error.message}` });
+				return;
+			}
+			else if (body?.op === "save" && Array.isArray(body.rules)) {
+				project.visualRules = body.rules.filter((r) => typeof r === "string" && r.trim() !== "").map((r) => r.trim().slice(0, 80)).slice(0, 12);
+				project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+				saveProject(config.outputDir, project);
+				writeJson(res, 200, { rules: project.visualRules });
+				return;
 			}
+			writeJson(res, 400, { error: "op 须为 extract 或 save" });
 		}
 	};
 	/** 生产单执行器（单例）：计划补足 → 逐章生成 → 被拒分级处理 → 断点续跑。 */
@@ -6235,6 +6662,8 @@ function makeRoutes(deps) {
 		renameRoute,
 		plotlinesRoute,
 		rolesRoute,
+		scenesRoute,
+		visualRulesRoute,
 		sensitiveRoute,
 		reviewBackfillRoute,
 		chapterResetRoute,
@@ -6243,8 +6672,6 @@ function makeRoutes(deps) {
 		openFolderRoute,
 		outlineSuggestRoute,
 		breakdownRoute,
-		storyboardRoute,
-		storyboardPlanRoute,
 		{
 			kind: "exact",
 			path: NOVEL_API.runStart,
@@ -6324,12 +6751,21 @@ const Config = z.object({
 	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),
 	autoReview: z.boolean().default(true),
 	autoAuthorReview: z.boolean().default(true),
-	autoReviewAfterRevise: z.boolean().default(true)
+	autoReviewAfterRevise: z.boolean().default(true),
+	imageApiKey: z.string().default(""),
+	imageApiModel: z.string().default(""),
+	imageApiEnabled: z.boolean().default(false)
 });
 /** Schema defaults, re-read for hand-built test contexts. */
 const DEFAULT_ANNOUNCE = true;
@@ -6337,6 +6773,7 @@ const DEFAULT_OUTLINE_PATH = "D:\\ryan work\\harness\\novels\\归墟玉主\\《
 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;
@@ -6354,12 +6791,16 @@ 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,
 		autoReview: value?.autoReview ?? DEFAULT_AUTO_REVIEW,
 		autoAuthorReview: value?.autoAuthorReview ?? DEFAULT_AUTO_AUTHOR_REVIEW,
-		autoReviewAfterRevise: value?.autoReviewAfterRevise ?? DEFAULT_AUTO_REVIEW_AFTER_REVISE
+		autoReviewAfterRevise: value?.autoReviewAfterRevise ?? DEFAULT_AUTO_REVIEW_AFTER_REVISE,
+		imageApiKey: value?.imageApiKey,
+		imageApiModel: value?.imageApiModel,
+		imageApiEnabled: value?.imageApiEnabled ?? false
 	};
 }
 /**
@@ -6384,12 +6825,16 @@ 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;
 		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;
+		if (patch.imageApiKey !== void 0) next.imageApiKey = patch.imageApiKey;
+		if (patch.imageApiModel !== void 0) next.imageApiModel = patch.imageApiModel;
+		if (patch.imageApiEnabled !== void 0) next.imageApiEnabled = patch.imageApiEnabled;
 		const settings = ctx.get("settings");
 		if (settings !== void 0) await settings.update(NOVEL_SETTINGS_NAMESPACE, next);
 		else current = () => ({