@waterwx/dsh-novel-forge 1.4.0 → 1.5.0

package/lib/index.js

@@ -4,6 +4,7 @@ import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-sett
 import z from "schemastery";
 import { exec } from "node:child_process";
 import { appendFileSync, copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
 import { BlockAssembler, ReasoningEffortId, createAssistantMessage, createUserMessage } from "@deepseek-ai/dsh-llm";
 import { randomBytes } from "node:crypto";
 import { strFromU8, unzipSync } from "fflate";
@@ -664,6 +665,195 @@ function getComicStylePrompt(styleId) {
 	return COMIC_STYLE_PRESETS.find((s) => s.id === styleId)?.prompt ?? "";
 }
 //#endregion
+//#region src/style-library.ts
+/** 内置风格模板（18 个）。 */
+const STYLE_LIBRARY = [
+	{
+		id: "pixar-adult-3d",
+		name: "成人向皮克斯 3D",
+		category: "3d",
+		traits: "CG 三维渲染，材质细腻，微表情表现力强；需压制 Q 版可爱感",
+		keywords: "3D皮克斯动画，成人写实CGI，电影光影，拒绝Q版",
+		weight: 1
+	},
+	{
+		id: "arcane-thick-3d",
+		name: "双城之战美漫厚涂 3D",
+		category: "3d",
+		traits: "粗重轮廓线，高对比硬阴影，材质粗粝，悲剧、压抑、科幻题材适配高",
+		keywords: "双城之战美术，3D美漫厚涂，强轮廓光影，暗调粗粝渲染",
+		weight: .95
+	},
+	{
+		id: "nextgen-cg",
+		name: "次世代游戏 CG",
+		category: "3d",
+		traits: "接近真人的三维渲染，照片级布料、皮肤材质，冷峻写实",
+		keywords: "次世代游戏CG渲染，超写实3D，真实物理材质，电影布光",
+		weight: .9
+	},
+	{
+		id: "low-cyberpunk-3d",
+		name: "底层赛博朋克 3D",
+		category: "3d",
+		traits: "锈蚀工业、破碎霓虹、屏幕噪点；避开华丽高楼，偏向破败底层",
+		keywords: "底层赛博朋克3D，废土工业，破碎霓虹，画面噪点色散",
+		weight: .85
+	},
+	{
+		id: "vaporwave-3d",
+		name: "复古蒸汽波 3D",
+		category: "3d",
+		traits: "粉-蓝-紫霓虹轮廓、90 年代复古网格、胶片色散颗粒，颓废疏离",
+		keywords: "3D复古蒸汽波，90年代三维渲染，霓虹轮廓光，胶片颗粒",
+		weight: .8
+	},
+	{
+		id: "dark-gothic-3d",
+		name: "暗黑哥特 3D",
+		category: "3d",
+		traits: "大面积阴影、冷青色调、衰败破败质感，适合幽暗密闭空间",
+		keywords: "3D暗黑哥特，冷青暗光，衰败质感，大面积阴影",
+		weight: .8
+	},
+	{
+		id: "clay-stopmotion-3d",
+		name: "黏土 / 定格 3D",
+		category: "3d",
+		traits: "捏塑颗粒肌理，手工定格质感；可做压抑向，不局限可爱风",
+		keywords: "3D黏土定格渲染，泥塑肌理，电影打光",
+		weight: .7
+	},
+	{
+		id: "openworld-survival",
+		name: "开放世界生存游戏风",
+		category: "game",
+		traits: "场景破败感强，货架、仓库、管线、灰尘、锈蚀明显；人物带一点“生存者”气质；适合探索感、逃亡感、世界观展示",
+		keywords: "开放世界生存游戏风格，废土场景，破败仓库，锈蚀金属货架，灰尘粒子，冷色写实光影",
+		weight: .8
+	},
+	{
+		id: "horror-game-3d",
+		name: "恐怖游戏 3D",
+		category: "game",
+		traits: "大面积阴影，荧光灯频闪，空间压抑；适合悬疑、压迫、精神异常段落",
+		keywords: "恐怖游戏 3D 风格，昏暗仓库，老旧荧光灯，硬阴影，压迫空间，冷灰蓝调，低饱和",
+		weight: .75
+	},
+	{
+		id: "tactical-stealth",
+		name: "战术潜行游戏风",
+		category: "game",
+		traits: "低视角、第三人称镜头感；人物在货架之间移动，光影克制；适合紧张剧情",
+		keywords: "战术潜行游戏视角，第三人称镜头，货架通道，冷色暗光，真实3D渲染，紧张压迫氛围",
+		weight: .7
+	},
+	{
+		id: "korean-webtoon",
+		name: "韩漫条漫风",
+		category: "2d",
+		traits: "修长人物，低饱和高级灰，氛围感强，都市向漫剧爆款画风",
+		keywords: "韩漫2D绘画，精致人物，低饱和灰调，氛围感插画",
+		weight: 1
+	},
+	{
+		id: "japan-cel-dark",
+		name: "日系赛璐璐动画",
+		category: "2d",
+		traits: "干净勾线，硬阴影；分明亮版、暗调悲剧版（边缘行者质感）",
+		keywords: "日系赛璐璐动画，清晰轮廓线，硬阴影，暗调都市动画",
+		weight: .9
+	},
+	{
+		id: "shinkai-anime",
+		name: "新海诚动画风",
+		category: "2d",
+		traits: "极致环境光影、丁达尔、空气中尘埃粒子，擅长雨夜、夜景外景",
+		keywords: "新海诚动画渲染，细腻环境光，漂浮尘埃粒子",
+		weight: .85
+	},
+	{
+		id: "pop-marvel-2d",
+		name: "波普美漫",
+		category: "2d",
+		traits: "网点半调、强撞色，线条张扬，节奏冲击力强",
+		keywords: "平行宇宙波普美漫，网点半调，漫画粗线条",
+		weight: .8
+	},
+	{
+		id: "dark-ghibli",
+		name: "暗黑吉卜力手绘",
+		category: "2d",
+		traits: "手绘水彩肌理；强制关闭温暖治愈，做残酷冷调版本",
+		keywords: "吉卜力手绘动画，暗黑写实，水彩肌理，拒绝暖光治愈",
+		weight: .75
+	},
+	{
+		id: "noir-film",
+		name: "黑色电影 Noir",
+		category: "film",
+		traits: "高反差黑白，只保留少量色彩作为视觉锚点，张力极强",
+		keywords: "黑色电影，大部分黑白，局部保留色彩，硬侧光，胶片颗粒",
+		stackable: true,
+		weight: 1
+	},
+	{
+		id: "vhs90",
+		name: "VHS 90 录像带复古",
+		category: "film",
+		traits: "扫描线、色彩偏移、磁带噪点，模拟老旧档案录像",
+		keywords: "VHS录像带质感，扫描线，色彩偏移，磁带噪点",
+		stackable: true,
+		weight: .9
+	},
+	{
+		id: "film-photo",
+		name: "胶片电影写真",
+		category: "film",
+		traits: "电影机拍摄质感，轻微颗粒，景深虚化，无夸张特效",
+		keywords: "电影写真质感，35mm胶片，胶片颗粒，浅景深",
+		stackable: true,
+		weight: .85
+	},
+	{
+		id: "chinese-ink",
+		name: "新中式水墨动画",
+		category: "craft",
+		traits: "水墨晕染，留白写意",
+		keywords: "水墨动画渲染，写意晕染，国风2D",
+		weight: 1
+	},
+	{
+		id: "paper-cut-3d",
+		name: "纸雕定格",
+		category: "craft",
+		traits: "多层纸张镂空叠层，光影穿透纸面",
+		keywords: "立体纸雕定格，纸张肌理，层叠镂空光影",
+		weight: .9
+	},
+	{
+		id: "guofeng-heavy",
+		name: "工笔重彩国风",
+		category: "craft",
+		traits: "精细线条，矿物颜料质感，古典华美",
+		keywords: "工笔重彩，国风2D绘画，矿物颜料质感，精细勾线",
+		weight: .8
+	}
+];
+/** 取单个风格（未找到返回 undefined）。 */
+function findStyle(id) {
+	return STYLE_LIBRARY.find((s) => s.id === id);
+}
+/** 按基底 + 滤镜拼接风格关键词（角色图/分镜/视频提示词共用；缺省回退 3D 动漫）。 */
+function styleKeywords(styleId, filterId) {
+	const parts = [];
+	const base = styleId !== void 0 ? findStyle(styleId) : void 0;
+	if (base !== void 0) parts.push(base.keywords);
+	const filter = filterId !== void 0 ? findStyle(filterId) : void 0;
+	if (filter !== void 0) parts.push(filter.keywords);
+	return parts.join("，") || "3D动漫，超精细建模，电影光影";
+}
+//#endregion
 //#region src/engine.ts
 /**
 * Novel engine — the host half's core: LLM-driven story-bible extraction,
@@ -690,6 +880,25 @@ const COMPLIANCE_REDLINES = [
 ];
 /** Project state file name inside the output dir. */
 const PROJECT_FILE = "novel-project.json";
+/** 智能解码文本文件：UTF-8 BOM / UTF-16 BOM / UTF-8（严格校验）/ GB18030 回退。 */
+function decodeTextSmart(buf) {
+	if (buf.length >= 3 && buf[0] === 239 && buf[1] === 187 && buf[2] === 191) return buf.subarray(3).toString("utf8");
+	if (buf.length >= 2 && buf[0] === 255 && buf[1] === 254) return buf.subarray(2).toString("utf16le");
+	const utf8 = buf.toString("utf8");
+	const bad = countReplacementChars(utf8);
+	if (bad === 0) return utf8;
+	try {
+		const gbk = new TextDecoder("gb18030").decode(buf);
+		if (countReplacementChars(gbk) < bad) return gbk;
+	} catch {}
+	return utf8;
+}
+/** 统计替换字符 U+FFFD 数量（UTF-8 乱码检测）。 */
+function countReplacementChars(s) {
+	let n = 0;
+	for (let i = 0; i < s.length; i++) if (s.charCodeAt(i) === 65533) n++;
+	return n;
+}
 /** Sanitize a file name: keep CJK/alphanumerics/space/dash/underscore. */
 function safeFileName(name) {
 	return name.replace(/[\\/:*?"<>|]/g, "").replace(/\s+/g, " ").trim().slice(0, 60);
@@ -1167,7 +1376,7 @@ async function complete(ctx, config, options) {
 		system: options.system,
 		maxTokens: options.maxTokens ?? config.maxTokens,
 		temperature: options.temperature ?? .7,
-		reasoningEffort: ReasoningEffortId(config.reasoningEffort ?? "off")
+		reasoningEffort: ReasoningEffortId(options.reasoning ?? config.reasoningEffort ?? "off")
 	};
 	const assembler = new BlockAssembler();
 	for await (const chunk of ctx.llm.stream(request)) assembler.push(chunk);
@@ -1293,7 +1502,8 @@ async function extractBible(ctx, config, outline, project) {
 		system: bibleSystemPrompt(),
 		user,
 		temperature: .4,
-		maxTokens: Math.max(config.maxTokens, 16e3)
+		maxTokens: Math.max(config.maxTokens, 16e3),
+		reasoning: config.analysisReasoning ?? "low"
 	}));
 	const strArray = (value) => Array.isArray(value) ? value.filter((v) => typeof v === "string" && v.trim() !== "") : [];
 	const characters = Array.isArray(raw.characters) ? raw.characters.filter((v) => typeof v === "object" && v !== null).map((entry) => ({
@@ -1756,7 +1966,8 @@ async function suggestPlotlines(ctx, config, project) {
 			"只输出 JSON 数组。"
 		].join("\n\n"),
 		temperature: .6,
-		maxTokens: Math.max(config.maxTokens, 4e3)
+		maxTokens: Math.max(config.maxTokens, 4e3),
+		reasoning: config.analysisReasoning ?? "low"
 	}));
 	const lines = [];
 	const kinds = /* @__PURE__ */ new Set([
@@ -1803,7 +2014,8 @@ async function refreshPlotlineProgress(ctx, config, project, line) {
 			"只输出 JSON 对象。"
 		].join("\n\n"),
 		temperature: .3,
-		maxTokens: Math.max(config.maxTokens, 2e3)
+		maxTokens: Math.max(config.maxTokens, 2e3),
+		reasoning: config.analysisReasoning ?? "low"
 	}));
 	return typeof raw.progress === "string" ? raw.progress.trim().slice(0, 300) : "";
 }
@@ -1813,6 +2025,8 @@ async function extractRoles(ctx, config, project) {
 		"你是一位网文角色库管理员。请根据本书的大纲、设定、编年录与章节摘要，提炼完整的角色库。",
 		"覆盖原则：所有在编年录/章节中实际出场或有名有姓的角色都应收录；无名的功能性人物（如\"矮胖姑娘\"）用其身份简称收录并标注。",
 		"数量控制：最多输出 10 个角色，宁缺毋滥；路人级一次带过的不要收录。",
+		"重要：正文中若有明确的主角与主要反派，必须分别以 protagonist / antagonist 收录，禁止遗漏；反派确实未出场时才可省略。",
+		"输出优先级：主角（protagonist）与主要反派（antagonist）必须优先输出并完整刻画，其次女主/重要配角；判断不出名字时用正文中的身份称呼。",
 		"每个角色输出：",
 		"1. name：角色名（或身份简称）。主角/有名配角必须用正文中实际出现的人名（如「沈放」），禁止用「主角（38岁超市理货员）」这类把身份塞进名字的占位名；正文确实没点名时才可用身份简称（如「富商」「灰衣老人」）。",
 		"2. roleLabel：定位——protagonist=主角；female_lead=女主（唯一知己/感情线核心，无后宫前提下只此一位）；female_support=重要女配；support=普通配角；antagonist=反派；extra=路人/背景。",
@@ -1830,28 +2044,50 @@ 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 sampleChapters = written.length <= 6 ? written : (() => {
+		const picked = /* @__PURE__ */ new Set();
+		for (let i = 0; i < 3 && i < written.length; i++) picked.add(i);
+		const step = Math.max(1, Math.floor(written.length / 4));
+		for (let i = step; i < written.length - 2; i += step) picked.add(i);
+		for (let i = Math.max(0, written.length - 2); i < written.length; i++) picked.add(i);
+		return [...picked].sort((a, b) => a - b).map((i) => written[i]);
+	})();
 	const excerptParts = [];
-	for (const chapter of written.slice(0, 3)) {
+	for (const chapter of sampleChapters) {
 		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)}`);
+		if (text.length > 0) excerptParts.push(`第${chapter.no}章《${chapter.title}》\n${text.slice(0, 1500)}`);
 	}
-	const raw = parseJsonArray(await complete(ctx, config, {
+	const 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 ? `编年录（最近 30 条）：\n${(project.facts ?? []).slice(-30).map((f) => `[第${f.chapterNo}章] ${f.text.slice(0, 60)}`).join("\n")}` : "",
+		written.length > 0 ? `已写章节标题（${written.length} 章）：\n${written.map((c) => `第${c.no}章《${c.title}》`).join("、")}` : "",
+		"只输出 JSON 数组。"
+	].join("\n\n");
+	let text = 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("、")}` : "",
-			"只输出 JSON 数组。"
-		].join("\n\n"),
+		user,
 		temperature: .3,
-		maxTokens: Math.max(config.maxTokens, 24e3)
-	}));
+		maxTokens: Math.max(config.maxTokens, 24e3),
+		reasoning: config.analysisReasoning ?? "low"
+	});
+	let raw = parseJsonArray(text);
+	const hasProtagonist = raw.some((e) => typeof e === "object" && e !== null && e.roleLabel === "protagonist");
+	if (raw.length === 0 || !hasProtagonist) {
+		text = await complete(ctx, config, {
+			system: system + (raw.length === 0 ? "\n上一次输出为空或格式不正确。请直接输出 JSON 数组（即使只有一个角色也要输出），不要输出其他文字。" : "\n上一次输出中缺少主角（roleLabel 为 protagonist 的角色）。请重新输出完整 JSON 数组，务必包含正文中的主角。"),
+			user,
+			temperature: .3,
+			maxTokens: Math.max(config.maxTokens, 24e3),
+			reasoning: config.analysisReasoning ?? "low"
+		});
+		raw = parseJsonArray(text);
+	}
 	const labels = /* @__PURE__ */ new Set([
 		"protagonist",
 		"female_lead",
@@ -1921,7 +2157,8 @@ async function extractScenes(ctx, config, project) {
 			"只输出 JSON 数组。"
 		].filter((s) => s !== "").join("\n"),
 		temperature: .4,
-		maxTokens: Math.max(config.maxTokens, 12e3)
+		maxTokens: Math.max(config.maxTokens, 12e3),
+		reasoning: config.analysisReasoning ?? "low"
 	}));
 	const strArr = (v) => Array.isArray(v) ? v.filter((x) => typeof x === "string" && x.trim() !== "") : [];
 	const str = (v) => typeof v === "string" ? v.trim() : "";
@@ -1948,10 +2185,13 @@ async function extractScenes(ctx, config, project) {
 	}
 	return scenes;
 }
-/** 从 txt/md 全本拆分章节并建立项目：正文落盘为章节文件，status=written（待审稿）。 */
-function importBookText(filePath, outputDir) {
-	const lines = readFileSync(filePath, "utf8").split(/\r?\n/);
+/** 从 txt/md 全本文本拆章（纯逻辑，不落盘）：识别章节头、剥离重复标题、去重、排序并统一重新编号。 */
+function splitBookText(raw) {
+	const lines = raw.split(/\r?\n/);
 	const chapterHead = /^\s*(?:#\s*)?第\s*(\d+|[一二三四五六七八九十百千]+)\s*[章回节卷]\s*(.*?)\s*$/;
+	const cnOnlyHead = /^\s*(?:#\s*)?([一二三四五六七八九十百千万零〇]{1,6})(?:[、.．:：]\s*(.*?)\s*)?$/;
+	const specialHead = /^\s*(?:#\s*)?(序章|序言|楔子|引子|前言|开篇|尾声|终章|大结局|番外(?:篇|章)?|后记|完结感言|上架感言|作者的话)\s*[：:、.\s]*(.*?)\s*$/;
+	const enHead = /^\s*(?:#\s*)?chapter\s+(\d+)\s*[.:：、\-\s]*(.*?)\s*$/i;
 	const cnNum = {
 		一: 1,
 		二: 2,
@@ -1982,33 +2222,107 @@ function importBookText(filePath, outputDir) {
 	};
 	const chunks = [];
 	let current = null;
+	let specialSeq = 0;
 	for (const line of lines) {
 		const m = chapterHead.exec(line);
 		if (m !== null) {
-			if (current !== null) chunks.push(current);
 			const no = parseCn(m[1]);
-			const title = (m[2] ?? "").trim() || "";
+			if (current !== null) chunks.push(current);
+			current = {
+				sortKey: no > 0 ? no : chunks.length + 1,
+				title: (m[2] ?? "").trim(),
+				body: []
+			};
+			continue;
+		}
+		const mc = cnOnlyHead.exec(line);
+		if (mc !== null) {
+			const no = parseCn(mc[1]);
+			if (current !== null) chunks.push(current);
+			const t = (mc[2] ?? "").trim();
+			current = {
+				sortKey: no > 0 ? no : chunks.length + 1,
+				title: t !== "" ? t : "第" + mc[1] + "章",
+				body: []
+			};
+			continue;
+		}
+		const ms = specialHead.exec(line);
+		if (ms !== null) {
+			specialSeq++;
+			const name = ms[1];
+			const front = /序章|序言|楔子|引子|前言|开篇/.test(name);
+			const title = (ms[2] ?? "").trim();
+			if (current !== null) chunks.push(current);
 			current = {
-				no: no > 0 ? no : chunks.length + 1,
-				title,
+				sortKey: front ? specialSeq * .001 : 999999 + specialSeq * .001,
+				title: title !== "" ? title : name,
 				body: []
 			};
-		} else if (current !== null) current.body.push(line);
+			continue;
+		}
+		const me = enHead.exec(line);
+		if (me !== null) {
+			if (current !== null) chunks.push(current);
+			current = {
+				sortKey: Number(me[1]),
+				title: (me[2] ?? "").trim(),
+				body: []
+			};
+			continue;
+		}
+		if (current !== null) current.body.push(line);
 	}
 	if (current !== null) chunks.push(current);
-	if (chunks.length === 0) throw new Error("未识别到章节（需要\"第X章\"格式，或带 # 的章节标题）");
-	const seen = /* @__PURE__ */ new Set();
-	const ordered = chunks.filter((c) => {
-		if (seen.has(c.no)) return false;
-		seen.add(c.no);
-		return true;
-	}).sort((a, b) => a.no - b.no);
-	const bookName = basename(filePath, extname(filePath)).slice(0, 40) || "导入小说";
+	if (chunks.length === 0) throw new Error("未识别到章节（需要\"第X章\"格式、中文数字章节（一、二、三…）、序章/楔子/尾声等章节标题、英文 Chapter N，或带 # 的章节标题）");
+	const stripHead = (b) => {
+		let i = 0;
+		while (i < b.length) {
+			const t = b[i].trim();
+			if (t === "" || chapterHead.test(t) || cnOnlyHead.test(t) || specialHead.test(t) || enHead.test(t)) i++;
+			else break;
+		}
+		return b.slice(i).join("\n").trim();
+	};
+	const byKey = /* @__PURE__ */ new Map();
+	for (const c of chunks) {
+		const len = stripHead(c.body).length;
+		const ex = byKey.get(c.sortKey);
+		if (ex === void 0 || len > stripHead(ex.body).length) byKey.set(c.sortKey, c);
+	}
+	return [...byKey.values()].sort((a, b) => a.sortKey - b.sortKey).map((c, i) => ({
+		no: i + 1,
+		title: c.title,
+		body: stripHead(c.body)
+	}));
+}
+/** 拆章预览（不落盘）：章节编号/标题/字数 + 跳过清单。 */
+function previewBookText(raw) {
+	const chapters = [];
+	const skipped = [];
+	for (const c of splitBookText(raw)) {
+		if (c.body.length < 50) {
+			skipped.push("第" + c.no + "章" + (c.title !== "" ? "「" + c.title + "」" : "") + "（内容过短，已跳过）");
+			continue;
+		}
+		chapters.push({
+			no: c.no,
+			title: c.title !== "" ? c.title : "第" + c.no + "章",
+			chars: c.body.length
+		});
+	}
+	return {
+		chapters,
+		skipped
+	};
+}
+/** 从全本文本导入（浏览器上传 / 服务器文件共用）：建项目、写章节文件、保存。 */
+function importBookTextFromText(raw, outputDir, bookName) {
 	const project = createProject(bookName);
 	mkdirSync(outputDir, { recursive: true });
 	const skipped = [];
-	for (const c of ordered) {
-		const body = c.body.join("\n").trim();
+	for (const c of splitBookText(raw)) {
+		const body = c.body;
 		if (body.length < 50) {
 			skipped.push("第" + c.no + "章" + (c.title !== "" ? "「" + c.title + "」" : "") + "（内容过短，已跳过）");
 			continue;
@@ -2036,11 +2350,15 @@ function importBookText(filePath, outputDir) {
 		skipped
 	};
 }
+/** 从 txt/md 全本文件导入：编码自适应读取后拆章建项目，status=written（待审稿）。 */
+function importBookText(filePath, outputDir) {
+	return importBookTextFromText(decodeTextSmart(readFileSync(filePath)), outputDir, basename(filePath, extname(filePath)).slice(0, 40) || "导入小说");
+}
 /**
 * 为单个角色提炼「动漫形象描述词」：扫描该角色出场的已写章节正文，
 * 截取含外貌描写的段落，交给 LLM 提炼中文描述 + 英文绘图标签。
 */
-async function extractRoleVisual(ctx, config, project, outputDir, roleName) {
+async function extractRoleVisual(ctx, config, project, outputDir, roleName, styleId, filterId) {
 	const role = (project.roles ?? []).find((r) => r.name === roleName);
 	if (role === void 0) throw new Error(`角色「${roleName}」不在角色库中`);
 	const appearanceHints = /(发|眉|眼|眸|脸|肤|唇|身材|身高|衣|袍|裙|衫|靴|腰带|气质|模样|长相|容貌|披|束|扎|戴|佩|挂|绣|青|白|黑|红|蓝|紫|灰|银|金|少年|青年|少女|汉子|老者|中年|纤细|挺拔|瘦削|壮实|清秀|俊朗|英气|阴鸷|慈眉)/;
@@ -2131,16 +2449,18 @@ async function extractRoleVisual(ctx, config, project, outputDir, roleName) {
 		if (excerpts.length >= 12) break;
 	}
 	if (excerpts.length === 0) throw new Error(`正文中未找到「${roleName}」的出场描写（仅搜索最近 60 章），请确认角色名与正文一致`);
+	const rules = project.visualRules ?? [];
 	const raw = parseJsonObject(await complete(ctx, config, {
 		system: [
 			"你是一位动漫角色设定师与 AI 绘图提示词工程师。根据网文正文中该角色的实际外貌描写，输出「形象锚点」与「四类生图提示词」——一次完成，用于 AI 绘图（NovelAI / Stable Diffusion / Midjourney / 豆包等）生成一致的角色立绘。",
+			"【当前视觉风格】（portrait 立绘的「风格」字段必须原样使用，sheet/expressions/details 同样内嵌）：" + styleKeywords(styleId, filterId),
 			"硬性要求（依据优先）：",
 			"1. 发色/发型/瞳色/服装/气质/标志物必须来自提供的正文段落，不得凭空发明。",
 			"2. 正文未明确写到的项目（如瞳色没写、身高没写），用「未定」标注或直接不写，不要编造数值。",
 			"3. 服装优先取正文明确出现的（颜色+款式），多次出现取最常穿的组合；服装按分件组织（上身/下身/鞋/配饰）。",
 			"4. 标志物（标签/印记/饰品）必须出现在每段提示词中——它们是一致性的命根子。",
 			"【本书视觉规则】（必须内嵌进每段提示词，保证设定不跑偏）：",
-			...(project.visualRules ?? []).map((r) => "- " + r),
+			...rules.map((r) => "- " + r),
 			"输出六部分：",
 			"- zh：中文形象锚点，一段连贯文字（60-150 字）：发色发型、瞳色、脸型气质、服装（颜色款式）、身材、标志性物件。",
 			"- en：英文形象锚点，booru 风格、逗号分隔、小写，30-50 个标签：含性别（1boy/1girl）、发色、发型、瞳色、服装、气质、标志物。不要输出负面提示词。",
@@ -2166,7 +2486,8 @@ async function extractRoleVisual(ctx, config, project, outputDir, roleName) {
 			"只输出 JSON 对象。"
 		].join("\n\n"),
 		temperature: .4,
-		maxTokens: Math.max(config.maxTokens, 12e3)
+		maxTokens: Math.max(config.maxTokens, 12e3),
+		reasoning: config.analysisReasoning ?? "low"
 	}));
 	const zh = typeof raw.zh === "string" ? raw.zh.trim().slice(0, 500) : "";
 	const en = typeof raw.en === "string" ? raw.en.trim().slice(0, 1500) : "";
@@ -2212,20 +2533,22 @@ async function extractRoleVisual(ctx, config, project, outputDir, roleName) {
 * 角色四类生图提示词精修包（promptKit）：以锚点 + 表情清单 + 视觉规则为输入，
 * LLM 产出 立绘/四视图/表情×N/细节 四套 zh+en 提示词（比前端拼装更精炼）。
 */
-async function generateRolePromptKit(ctx, config, project, roleName) {
+async function generateRolePromptKit(ctx, config, project, roleName, styleId, filterId) {
 	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 rules = project.visualRules ?? [];
 	const raw = parseJsonObject(await complete(ctx, config, {
 		system: [
 			"你是一位 AI 绘图提示词工程师。基于给定角色的形象锚点、表情清单与本书视觉规则，输出四类生图提示词（每类 zh+en 各一段）。",
+			"【当前视觉风格】（每类提示词必须内嵌）：" + styleKeywords(styleId, filterId),
 			"四类：",
 			"1. portrait 立绘：正面站立全身人像，3D动漫超精细建模，纯白纯色背景；按字段流组织：身份（男子，角色名，外表年龄）→ 发型发色 → 胡茬 → 眼眸 → 面部 → 气质 → 上身服装分件（含磨损）→ 下身 → 鞋 → 标志物（含细节）→ 收尾（角色设计稿，细节完整展示，无多余杂物，全身完整无裁切）。",
 			"2. sheet 四视图：同一角色的 正面/左侧面/右侧面/背面 四视图设定表（character sheet），纯白背景，四个视角分别描述。",
 			"3. expressions 表情：每个表情一段，脸部特写（头部到锁骨），纯白背景，五官与角色定稿完全一致，只换情绪表达（眼神/嘴角/眉），皮肤纹理细节完整，无多余杂物。",
 			"4. details 细节：多组局部细节集合参考图（一张图多个局部框），纯白背景；把该角色全部标志物逐项列出，每项一句特写描述；细节清晰锐利，角色细节参考稿，无多余杂物。",
 			"【本书视觉规则】（必须内嵌进每段提示词，保证设定不跑偏）：",
-			...(project.visualRules ?? []).map((r) => "- " + r),
+			...rules.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 结果本身。"
@@ -2239,7 +2562,8 @@ async function generateRolePromptKit(ctx, config, project, roleName) {
 			"只输出 JSON 对象。"
 		].join("\n\n"),
 		temperature: .4,
-		maxTokens: Math.max(config.maxTokens, 12e3)
+		maxTokens: Math.max(config.maxTokens, 12e3),
+		reasoning: config.analysisReasoning ?? "low"
 	}));
 	const str = (v) => typeof v === "string" ? v.trim() : "";
 	const pair = (v) => {
@@ -2284,7 +2608,8 @@ async function extractVisualRules(ctx, config, project) {
 			"只输出 JSON 数组。"
 		].filter((s) => s !== "").join("\n\n"),
 		temperature: .3,
-		maxTokens: Math.max(config.maxTokens, 4e3)
+		maxTokens: Math.max(config.maxTokens, 4e3),
+		reasoning: config.analysisReasoning ?? "low"
 	})).map((r) => typeof r === "string" ? r.trim().slice(0, 80) : "").filter((r) => r !== "").slice(0, 8);
 }
 /**
@@ -2320,7 +2645,8 @@ async function suggestOutlines(ctx, config, idea, count = 3, exclude = []) {
 			"只输出 JSON 数组。"
 		].join("\n\n"),
 		temperature: .85,
-		maxTokens: Math.max(config.maxTokens, 12e3)
+		maxTokens: Math.max(config.maxTokens, 12e3),
+		reasoning: config.analysisReasoning ?? "low"
 	}));
 	const candidates = [];
 	for (const entry of parsed) {
@@ -2390,7 +2716,8 @@ async function breakdownBook(ctx, config, project, outputDir, scope = "recent",
 				system: noteSystem,
 				user: noteUser,
 				temperature: .2,
-				maxTokens: Math.max(config.maxTokens, 3e3)
+				maxTokens: Math.max(config.maxTokens, 3e3),
+				reasoning: config.analysisReasoning ?? "low"
 			}));
 			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("；") || "（无明显短板信号）"}`);
@@ -2462,7 +2789,8 @@ async function breakdownBook(ctx, config, project, outputDir, scope = "recent",
 			system: sec.system,
 			user: `分析范围：${selected.length} 章（${scope === "all" ? "全书" : scope === "recent" ? "最近 20 章" : "指定卷"}）。\n\n章节笔记：\n${notesText}`,
 			temperature: .3,
-			maxTokens: Math.max(config.maxTokens, 6e3)
+			maxTokens: Math.max(config.maxTokens, 6e3),
+			reasoning: config.analysisReasoning ?? "low"
 		}));
 		sections.push({
 			key: sec.key,
@@ -2915,6 +3243,261 @@ async function summarizeChapter(ctx, config, project, outputDir, chapterNo) {
 	saveProject(outputDir, project);
 	return chapter.summary;
 }
+/** 把分镜产出写入项目持久化（按章 upsert）。 */
+function saveChapterStoryboard(project, outputDir, entry) {
+	if (project.storyboards === void 0) project.storyboards = [];
+	const idx = project.storyboards.findIndex((e) => e.chapterNo === entry.chapterNo);
+	if (idx === -1) project.storyboards.push(entry);
+	else project.storyboards[idx] = {
+		...project.storyboards[idx],
+		...entry
+	};
+	project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+	saveProject(outputDir, project);
+}
+/**
+* 分镜·导演级：剧情骨架 → 分镜表（镜头级）。
+* 只做画面层：景别/机位运镜/时长/画面/台词/音效/光效 + 状态连续；禁止改剧情（骨架只读）。
+*/
+async function generateStoryboardTable(ctx, config, project, outputDir, chapterNo, skeleton, styleId, filterId) {
+	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} 的正文文件不存在`);
+	if ((skeleton.beats ?? []).length === 0) throw new Error("骨架为空，请先生成剧情骨架");
+	const roles = (project.roles ?? []).filter((r) => body.includes(r.name)).slice(0, 8).map((r) => `${r.name}（${r.roleLabel === "protagonist" ? "主角" : r.roleLabel === "antagonist" ? "反派" : r.roleLabel === "female_lead" ? "女主" : "配角"}）：${r.identity ?? ""}`);
+	const scenes = (project.scenes ?? []).filter((s) => body.includes(s.name)).slice(0, 6).map((s) => `${s.name}：${s.summary ?? ""}`);
+	const rules = (project.visualRules ?? []).map((r) => "- " + r);
+	const baseStyle = styleId !== void 0 ? findStyle(styleId) : void 0;
+	const filterStyle = filterId !== void 0 ? findStyle(filterId) : void 0;
+	const styleLines = [];
+	if (baseStyle !== void 0) styleLines.push("- 基底风格「" + baseStyle.name + "」：" + baseStyle.keywords);
+	if (filterStyle !== void 0) styleLines.push("- 叠加滤镜「" + filterStyle.name + "」：" + filterStyle.keywords);
+	if (styleLines.length === 0) styleLines.push("- （未选择风格，默认 3D 动漫超精细建模质感）");
+	const raw = parseJsonObject(await complete(ctx, config, {
+		system: [
+			"你是一位从业 10 年的电影导演兼分镜师，专长网文改编影视化。",
+			"任务：把「剧情骨架」的每一个节拍展开为 1-3 个电影镜头，输出分镜表——只做画面层，禁止新增或改变剧情（骨架是只读输入）。",
+			"输出合法 JSON 对象：{\"shots\": [{\"beatId\": \"骨架节拍id\", \"shot\": \"景别\", \"camera\": \"机位与运镜\", \"duration\": 秒数, \"visual\": \"画面内容\", \"line\": \"台词/旁白\", \"sound\": \"音效\", \"light\": \"光效\", \"prevState\": \"承接上一镜头结尾状态\", \"nextState\": \"本镜头结束状态\"}]}",
+			"景别取值：远景/全景/中景/近景/特写。",
+			"硬性要求：",
+			"【视觉风格】（必须内嵌进 visual/light 的画面措辞与光效描述）：",
+			...styleLines,
+			"1. 按骨架节拍顺序输出镜头，每个节拍至少 1 个镜头，总镜头数 8-25。",
+			"2. 镜头间连续：下一镜头的 prevState 必须与上一镜头的 nextState 一致（人物位置/动作/情绪/服装），禁止瞬移、服装消失、情绪跳变。",
+			"3. visual 必须写明：角色动作 + 表情 + 服装/标志物（标志物来自下方视觉规则与角色锚点，逐镜头保持）。",
+			"4. 台词/音效/光效无则空字符串，不要编造。",
+			"5. duration 1-12 秒。",
+			"6. 所有字符串值内部不得包含换行符，JSON 必须在一段内完整结束，不要输出其他文字。"
+		].join("\n"),
+		user: [
+			`章节《${chapter.title}》（第 ${chapter.no} 章）`,
+			"==== 剧情骨架（只读，禁止改动） ====",
+			`弧线：${skeleton.arc}`,
+			skeleton.beats.map((b) => `[${b.id}] [${b.function}] ${b.event}（情绪：${b.emotion}${b.cause !== void 0 ? "；承接：" + b.cause : ""}）`).join("\n"),
+			roles.length > 0 ? "==== 出场角色锚点 ====\n" + roles.join("\n") : "",
+			scenes.length > 0 ? "==== 相关场景 ====\n" + scenes.join("\n") : "",
+			rules.length > 0 ? "==== 本书视觉规则（必须内嵌进 visual） ====\n" + rules.join("\n") : "",
+			"==== 章节正文（画面细节以此为准） ====",
+			body.replace(/^#\s+.*$/m, "").trim().slice(0, 3e3)
+		].filter((s) => s !== "").join("\n\n"),
+		temperature: .3,
+		maxTokens: Math.max(config.maxTokens, 6e3),
+		reasoning: config.analysisReasoning ?? "low"
+	}));
+	const beatIds = new Set(skeleton.beats.map((b) => b.id));
+	const shotKinds = /* @__PURE__ */ new Set([
+		"远景",
+		"全景",
+		"中景",
+		"近景",
+		"特写"
+	]);
+	const shots = Array.isArray(raw.shots) ? raw.shots.filter((v) => typeof v === "object" && v !== null).map((entry, i) => ({
+		id: "s" + (i + 1),
+		beatId: beatIds.has(entry.beatId) ? entry.beatId : skeleton.beats[0].id,
+		shot: shotKinds.has(entry.shot) ? entry.shot : "中景",
+		camera: typeof entry.camera === "string" ? entry.camera.trim().slice(0, 80) : "",
+		duration: typeof entry.duration === "number" && entry.duration >= 1 && entry.duration <= 12 ? Math.round(entry.duration) : 4,
+		visual: typeof entry.visual === "string" ? entry.visual.trim().slice(0, 300) : "",
+		line: typeof entry.line === "string" ? entry.line.trim().slice(0, 120) : "",
+		sound: typeof entry.sound === "string" ? entry.sound.trim().slice(0, 80) : "",
+		light: typeof entry.light === "string" ? entry.light.trim().slice(0, 80) : "",
+		prevState: typeof entry.prevState === "string" ? entry.prevState.trim().slice(0, 150) : "",
+		nextState: typeof entry.nextState === "string" ? entry.nextState.trim().slice(0, 150) : ""
+	})).filter((s) => s.visual !== "") : [];
+	if (shots.length === 0) throw new Error("模型未输出有效镜头，请重试");
+	const covered = new Set(shots.map((s) => s.beatId));
+	const missing = skeleton.beats.filter((b) => !covered.has(b.id)).map((b) => b.id);
+	if (missing.length > 0) console.warn(`[dsh-novel-forge] storyboard: beat ${missing.join(",")} 无镜头覆盖`);
+	const table = {
+		chapterNo,
+		shots
+	};
+	saveChapterStoryboard(project, outputDir, {
+		chapterNo,
+		table,
+		updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+	});
+	return table;
+}
+/**
+* 分镜·提示词级：分镜表 → 即梦可粘贴视频提示词。
+* 每镜头一段：风格词块（基底+滤镜）+ 画面内容（角色动作/服装标志物）+ 机位运镜 + 光效。
+* 提示词聚焦画面与镜头（视频模型无音频，台词/音效不注入）。
+*/
+async function generateStoryboardPrompts(ctx, config, project, outputDir, chapterNo, table, styleId, filterId) {
+	if ((table.shots ?? []).length === 0) throw new Error("分镜表为空，请先生成分镜表");
+	const chapter = project.chapters.find((c) => c.no === chapterNo);
+	const baseStyle = styleId !== void 0 ? findStyle(styleId) : void 0;
+	const filterStyle = filterId !== void 0 ? findStyle(filterId) : void 0;
+	const stylePrefix = [baseStyle?.keywords, filterStyle?.keywords].filter((v) => v !== void 0 && v !== "").join("，") || "3D动漫，超精细建模，电影光影";
+	const rules = (project.visualRules ?? []).map((r) => "- " + r);
+	const shotLines = table.shots.map((s) => `[${s.id}] 节拍${s.beatId} · ${s.shot} · ${s.camera} · ${s.duration}s
+画面：${s.visual}
+台词：${s.line !== "" ? s.line : "（无）"}
+光效：${s.light !== "" ? s.light : "（无）"}
+承接：${s.prevState} → ${s.nextState}`).join("\n\n");
+	const raw = parseJsonObject(await complete(ctx, config, {
+		system: [
+			"你是一位资深影视分镜提示词工程师，熟悉即梦 AI / Seedance 等视频生成模型的中文提示词写法。",
+			"任务：把分镜表的每个镜头写成一段可直接粘贴进视频生成工具的提示词。",
+			"提示词结构（按顺序）：风格词块 → 画面主体（人物动作+表情+服装标志物）→ 机位运镜（含时长感）→ 光效氛围。单段中文 60-140 字，逗号分隔，流畅自然。",
+			"风格词块（必须原样放在每段开头）：" + stylePrefix,
+			"硬性要求：",
+			"1. 只写画面与镜头，禁止写音频/台词配音说明（视频模型无音频）。",
+			"2. 服装/发色/标志物必须沿用镜头表与视觉规则，禁止自行更换。",
+			"3. 运镜用通俗电影词（推近/拉远/跟随/低机位仰拍/过肩/手持晃动/固定机位），不要用分镜术语缩写。",
+			"4. 输出合法 JSON 对象：{\"prompts\": [{\"shotId\": \"s1\", \"text\": \"...\"}]}，所有镜头都要有，顺序一致。",
+			"5. 字符串内不得包含换行符，JSON 必须在一段内完整结束。"
+		].join("\n"),
+		user: [
+			`章节《${chapter?.title ?? ""}》（第 ${chapterNo} 章）`,
+			rules.length > 0 ? "本书视觉规则（必须遵守）：\n" + rules.join("\n") : "",
+			"==== 分镜表 ====",
+			shotLines,
+			"只输出 JSON 对象。"
+		].filter((x) => x !== "").join("\n\n"),
+		temperature: .3,
+		maxTokens: Math.max(config.maxTokens, 6e3),
+		reasoning: config.analysisReasoning ?? "low"
+	}));
+	const shotIds = new Set(table.shots.map((s) => s.id));
+	const prompts = Array.isArray(raw.prompts) ? raw.prompts.filter((v) => typeof v === "object" && v !== null).map((entry) => ({
+		shotId: shotIds.has(entry.shotId) ? entry.shotId : "",
+		text: typeof entry.text === "string" ? entry.text.trim().slice(0, 400) : ""
+	})).filter((x) => x.shotId !== "" && x.text !== "") : [];
+	if (prompts.length === 0) throw new Error("模型未输出有效提示词，请重试");
+	saveChapterStoryboard(project, outputDir, {
+		chapterNo,
+		prompts,
+		updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+	});
+	return prompts;
+}
+/**
+* 分镜·编剧级：单章 → 剧情骨架（节拍链）。
+* 只做故事层（事件/情绪/功能/因果），不做画面；导演级分镜在其上展开。
+*/
+async function generateStoryboardSkeleton(ctx, config, project, outputDir, chapterNo) {
+	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 raw = parseJsonObject(await complete(ctx, config, {
+		system: [
+			"你是一位从业 15 年的电影编剧，专长网文改编影视化，深谙三幕结构与节拍（beat）写作。",
+			"任务：把这一章改编成影视化「剧情骨架」——只做故事层，不做画面。",
+			"输出合法 JSON 对象：{\"arc\": \"本章弧线一句话（起承转合，20-60字）\", \"beats\": [{\"event\": \"事件一句话（发生了什么）\", \"emotion\": \"人物情绪走向（如 压抑→隐忍→惊惧）\", \"function\": \"铺垫|冲突|转折|高潮|收束|伏笔|人物塑造\", \"cause\": \"承接上一节拍的原因（可省略）\"}]}",
+			"硬性要求：",
+			"1. beats 数量 4-9 个，严格按时间顺序，因果链完整：前一个 beat 的结果是后一个 beat 的原因。",
+			"2. 必须覆盖本章全部剧情要点与正文关键事件，遗漏关键事件视为失败。",
+			"3. 只输出剧情骨架，禁止写画面描写、机位运镜、台词细节、音效（那是导演阶段的事）。",
+			"4. 所有字符串值内部不得包含换行符，JSON 必须在一段内完整结束。",
+			"5. 直接输出 JSON 本身，不要输出思考过程或其他文字。"
+		].join("\n"),
+		user: [
+			`章节《${chapter.title}》（第 ${chapter.no} 章）`,
+			`剧情要点：${chapter.beats !== void 0 && chapter.beats !== "" ? chapter.beats : "（未填写）"}`,
+			"==================== 章节正文 ====================",
+			body.replace(/^#\s+.*$/m, "").trim()
+		].join("\n"),
+		temperature: .3,
+		maxTokens: Math.max(config.maxTokens, 4e3),
+		reasoning: config.analysisReasoning ?? "low"
+	}));
+	const arc = typeof raw.arc === "string" ? raw.arc.trim().slice(0, 200) : "";
+	const functions = /* @__PURE__ */ new Set([
+		"铺垫",
+		"冲突",
+		"转折",
+		"高潮",
+		"收束",
+		"伏笔",
+		"人物塑造"
+	]);
+	const beats = Array.isArray(raw.beats) ? raw.beats.filter((v) => typeof v === "object" && v !== null).map((entry, i) => ({
+		id: "b" + (i + 1),
+		event: typeof entry.event === "string" ? entry.event.trim().slice(0, 200) : "",
+		emotion: typeof entry.emotion === "string" ? entry.emotion.trim().slice(0, 100) : "",
+		function: functions.has(entry.function) ? entry.function : "铺垫",
+		cause: typeof entry.cause === "string" && entry.cause.trim() !== "" ? entry.cause.trim().slice(0, 150) : void 0
+	})).filter((b) => b.event !== "") : [];
+	if (beats.length === 0) throw new Error("模型未输出有效节拍链，请重试");
+	const skeleton = {
+		chapterNo,
+		arc: arc !== "" ? arc : "（本章弧线未生成）",
+		beats
+	};
+	saveChapterStoryboard(project, outputDir, {
+		chapterNo,
+		skeleton,
+		updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+	});
+	return skeleton;
+}
+/**
+* 反向推大纲：从已写章节正文反推出全书总纲（分卷 + 章节要点 + 主线/人物弧线/伏笔清单）。
+* 两阶段：分批提取章节事件摘要 → 汇总生成大纲。不修改章节/设定，只返回大纲文本。
+*/
+async function reverseOutlineFromChapters(ctx, config, project, outputDir, onProgress) {
+	const written = project.chapters.filter((c) => c.status !== "pending" && c.status !== "generating" && c.status !== "error").filter((c) => readChapterFile(outputDir, c) !== void 0).sort((a, b) => a.no - b.no);
+	if (written.length === 0) throw new Error("本书还没有已写章节，无法反推大纲");
+	const BATCH = 10;
+	const notes = [];
+	const total = written.length;
+	for (let i = 0; i < written.length; i += BATCH) {
+		const note = await complete(ctx, config, {
+			system: "你是一位网文编辑。下面是一本书若干章正文的节选。请为每一章输出一行「事件摘要」，格式严格为：第N章《标题》：关键事件+主角状态变化+新增伏笔或线索。每章恰好一行，不要空行，不要评价，不要输出其他内容。",
+			user: written.slice(i, i + BATCH).map((c) => {
+				const body = readChapterFile(outputDir, c) ?? "";
+				return "第" + c.no + "章《" + (c.title || "无题") + "》\n" + body.replace(/^#\s+.*$/m, "").trim().slice(0, 1e3);
+			}).join("\n\n---\n\n"),
+			temperature: .2,
+			maxTokens: Math.max(config.maxTokens, 3e3),
+			reasoning: config.analysisReasoning ?? "low"
+		});
+		notes.push(note.trim());
+		onProgress?.(Math.min(i + BATCH, total), total, "章节摘要");
+	}
+	onProgress?.(total, total, "生成大纲");
+	const outline = await complete(ctx, config, {
+		system: [
+			"你是一位经验丰富的小说主编。根据下面全书各章事件摘要，反推出这本书的总纲（大纲），可直接作为后续写作依据。要求：",
+			"1. 第一行写《书名》（从摘要中的书名或内容推断，若无则用《未命名》）。",
+			"2. 按故事弧线划分卷/部分：每卷给出卷名与主旨（标注覆盖章节范围）。",
+			"3. 每一章列出：章节号 + 标题 + 一句话核心情节（若原章无标题可自拟）。",
+			"4. 最后给出：全书主线、主要人物弧线、已埋设待回收的伏笔清单。",
+			"5. 输出为纯文本 Markdown 结构（# 一级标题、## 二级标题、- 列表），不要多余寒暄。"
+		].join("\n"),
+		user: notes.join("\n\n"),
+		temperature: .4,
+		maxTokens: Math.max(config.maxTokens, 6e3),
+		reasoning: config.analysisReasoning ?? "low"
+	});
+	onProgress?.(total, total, "完成");
+	return outline.trim();
+}
 /**
 * 摘要 + 事实抽取合并为一次 LLM 调用（省一次调用与一次正文输入，
 * 批量生成时整体开销约省 25%）。
@@ -3120,7 +3703,8 @@ async function generateBlurb(ctx, config, project, partial = "") {
 			partial.trim() !== "" ? `已有开头草稿（请保留其内容与语气，续写补全为完整简介）：\n${partial.trim()}` : "请全量生成一份完整简介。"
 		].filter((s) => s !== "").join("\n\n"),
 		temperature: .7,
-		maxTokens: Math.max(config.maxTokens, 4e3)
+		maxTokens: Math.max(config.maxTokens, 4e3),
+		reasoning: config.analysisReasoning ?? "low"
 	})).replace(/^["'「『]|["'」』]$/g, "").replace(/^简介[：:]\s*/, "").trim().slice(0, 600);
 }
 /**
@@ -3282,7 +3866,8 @@ async function extractWorld(ctx, config, project) {
 			"只输出 JSON 对象。"
 		].filter((s) => s !== "").join("\n\n"),
 		temperature: .3,
-		maxTokens: Math.max(config.maxTokens, 12e3)
+		maxTokens: Math.max(config.maxTokens, 12e3),
+		reasoning: config.analysisReasoning ?? "low"
 	}));
 	const str = (value) => typeof value === "string" ? value.trim() : "";
 	const objArray = (value) => Array.isArray(value) ? value.filter((v) => typeof v === "object" && v !== null) : [];
@@ -3421,7 +4006,8 @@ async function suggestForeshadows(ctx, config, project) {
 		system: foreshadowSystemPrompt(),
 		user,
 		temperature: .5,
-		maxTokens: Math.max(config.maxTokens, 12e3)
+		maxTokens: Math.max(config.maxTokens, 12e3),
+		reasoning: config.analysisReasoning ?? "low"
 	}));
 	const existing = new Set(project.foreshadows.map((f) => f.description));
 	const created = [];
@@ -3989,6 +4575,16 @@ const NOVEL_API = {
 	bookshelfImportDir: "/api/dsh-novel-forge/bookshelf/import-dir",
 	/** 导入 txt/md 全本：拆章建项目并登记书架。 */
 	bookshelfImportText: "/api/dsh-novel-forge/bookshelf/import-text",
+	/** 导入 txt/md 全本：拆章预览（不落盘）。 */
+	bookshelfImportTextPreview: "/api/dsh-novel-forge/bookshelf/import-text/preview",
+	/** 漫剧方案管理：create/remove/activate。 */
+	manhuaPlans: "/api/dsh-novel-forge/manhua/plans",
+	/** 分镜·编剧级：单章 → 剧情骨架（节拍链）。 */
+	storyboardSkeleton: "/api/dsh-novel-forge/storyboard/skeleton",
+	/** 分镜·导演级：骨架 → 分镜表（镜头级）。 */
+	storyboardTable: "/api/dsh-novel-forge/storyboard/table",
+	/** 分镜·提示词级：分镜表 → 即梦可粘贴视频提示词。 */
+	storyboardPrompts: "/api/dsh-novel-forge/storyboard/prompts",
 	/** 重置项目（可选携带新大纲）：清空设定/卷/章节/伏笔/资产/事实库。 */
 	reset: "/api/dsh-novel-forge/reset",
 	/** 全书一致性质检：LLM 扫描已生成章节，输出矛盾问题清单。 */
@@ -4023,6 +4619,8 @@ const NOVEL_API = {
 	sensitiveCheck: "/api/dsh-novel-forge/sensitive-check",
 	/** 开书想法 → AI 补全大纲：输入一句话想法，生成 2-3 个可选大纲方案。 */
 	outlineSuggest: "/api/dsh-novel-forge/outline/suggest",
+	/** 反推大纲：从已写章节正文反向生成全书总纲（NDJSON 流）。 */
+	outlineReverse: "/api/dsh-novel-forge/outline/reverse",
 	/** 拆书分析：对已写章节做结构/人物/文风/卖点四维体检（两阶段：源笔记→分节分析）。 */
 	breakdown: "/api/dsh-novel-forge/breakdown",
 	/** 漫剧分镜生成：章节 → 角色锚点 + 分镜表（可适配豆包/Seedance/SD）。 */
@@ -4829,7 +5427,9 @@ async function* runAssistantTurn(ctx, config, project, outputDir, userMessage) {
 //#endregion
 //#region src/routes.ts
 /** Cap on JSON request bodies (generous: cover images travel as base64). */
-const MAX_JSON_BODY_BYTES = 16 * 1024 * 1024;
+const MAX_JSON_BODY_BYTES = 64 * 1024 * 1024;
+/** 包内置风格效果图目录（assets/styles，随 npm 包分发）。 */
+const builtinStyleDir = fileURLToPath(new URL("../assets/styles/", import.meta.url));
 /** Loopback-only fence (mirrors the family plugins' pairing routes). */
 function isLoopbackRequest(request) {
 	const address = request.socket.remoteAddress;
@@ -5862,23 +6462,34 @@ function makeRoutes(deps) {
 			}
 		}
 	};
-	/** 导入 txt/md 全本（Mode B）：拆章落盘建项目，登记书架。 */
+	/** 导入 txt/md 全本（Mode B）：拆章落盘建项目，登记书架。支持浏览器上传（text+fileName）与服务器本地文件（filePath）两种模式。 */
 	const bookshelfImportTextRoute = {
 		kind: "exact",
 		path: NOVEL_API.bookshelfImportText,
 		handler: async (req, res) => {
 			if (!guard(req, res, "POST")) return;
 			const body = await readJsonBody(req);
-			const filePath = body?.filePath?.trim();
-			if (filePath === void 0 || filePath === "") {
-				writeJson(res, 400, { error: "filePath 不能为空" });
-				return;
-			}
-			if (!existsSync(filePath)) {
-				writeJson(res, 400, { error: `文件不存在：${filePath}` });
-				return;
-			}
 			try {
+				if (body?.text !== void 0 && body.text.length > 0) {
+					const bookName = (body.fileName ?? "").replace(/\.[^.]+$/, "").trim().slice(0, 40) || "导入小说";
+					const outDir = body?.outputDir?.trim() !== void 0 && body.outputDir.trim() !== "" ? body.outputDir.trim() : defaultOutputDirFor(bookName);
+					const result = importBookTextFromText(body.text, outDir, bookName);
+					const { book } = importDir(outDir);
+					writeJson(res, 200, {
+						...result,
+						book
+					});
+					return;
+				}
+				const filePath = body?.filePath?.trim();
+				if (filePath === void 0 || filePath === "") {
+					writeJson(res, 400, { error: "filePath 不能为空（或请上传文件内容）" });
+					return;
+				}
+				if (!existsSync(filePath)) {
+					writeJson(res, 400, { error: `文件不存在：${filePath}` });
+					return;
+				}
 				const bookName = basename(filePath, extname(filePath)).slice(0, 40) || "导入小说";
 				const outDir = body?.outputDir?.trim() !== void 0 && body.outputDir.trim() !== "" ? body.outputDir.trim() : defaultOutputDirFor(bookName);
 				const result = importBookText(filePath, outDir);
@@ -5892,6 +6503,27 @@ function makeRoutes(deps) {
 			}
 		}
 	};
+	/** 上传全文做拆章预览（不落盘、不登记书架）。 */
+	const bookshelfImportTextPreviewRoute = {
+		kind: "exact",
+		path: NOVEL_API.bookshelfImportTextPreview,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const body = await readJsonBody(req);
+			if (body?.text === void 0 || body.text.length === 0) {
+				writeJson(res, 400, { error: "text 不能为空" });
+				return;
+			}
+			try {
+				writeJson(res, 200, {
+					bookName: (body.fileName ?? "").replace(/\.[^.]+$/, "").trim().slice(0, 40) || "导入小说",
+					...previewBookText(body.text)
+				});
+			} catch (err) {
+				writeJson(res, 400, { error: err instanceof Error ? err.message : String(err) });
+			}
+		}
+	};
 	/** 全书一致性质检。 */
 	const auditRoute = {
 		kind: "exact",
@@ -6429,7 +7061,7 @@ function makeRoutes(deps) {
 					return;
 				}
 				try {
-					const visual = await extractRoleVisual(ctx, config, project, config.outputDir, name);
+					const visual = await extractRoleVisual(ctx, config, project, config.outputDir, name, body?.styleId, body?.filterId);
 					const role = project.roles.find((r) => r.name === name);
 					if (role !== void 0) {
 						role.imagePrompt = visual;
@@ -6454,7 +7086,7 @@ function makeRoutes(deps) {
 					return;
 				}
 				try {
-					const kit = await generateRolePromptKit(ctx, config, project, name);
+					const kit = await generateRolePromptKit(ctx, config, project, name, body?.styleId, body?.filterId);
 					const role = project.roles.find((r) => r.name === name);
 					if (role !== void 0) role.promptKit = kit;
 					project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
@@ -6673,6 +7305,213 @@ function makeRoutes(deps) {
 			}
 		}
 	};
+	/** 反推大纲：从已写章节正文反向生成全书总纲（NDJSON 流式进度）。 */
+	const outlineReverseRoute = {
+		kind: "exact",
+		path: NOVEL_API.outlineReverse,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const config = getConfig();
+			const project = requireProject(res);
+			if (project === void 0) return;
+			res.writeHead(200, {
+				"content-type": "application/x-ndjson; charset=utf-8",
+				"cache-control": "no-cache",
+				"x-accel-buffering": "no",
+				"referrer-policy": "no-referrer"
+			});
+			const send = (frame) => {
+				res.write(JSON.stringify(frame) + "\n");
+			};
+			try {
+				const outline = await reverseOutlineFromChapters(ctx, config, project, config.outputDir, (done, total, phase) => {
+					send({
+						type: "outline-progress",
+						done,
+						total,
+						phase
+					});
+				});
+				project.outline = outline;
+				project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+				saveProject(config.outputDir, project);
+				send({
+					type: "outline-done",
+					outline,
+					chars: outline.length
+				});
+			} catch (error) {
+				send({
+					type: "error",
+					no: 0,
+					message: error.message
+				});
+			} finally {
+				res.end();
+			}
+		}
+	};
+	/** 分镜·提示词级：分镜表 → 即梦可粘贴视频提示词。 */
+	const storyboardPromptsRoute = {
+		kind: "exact",
+		path: NOVEL_API.storyboardPrompts,
+		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 no = body?.chapterNo;
+			if (!Number.isInteger(no) || no === void 0 || no < 1) {
+				writeJson(res, 400, { error: "chapterNo 须为正整数" });
+				return;
+			}
+			if (body?.table === void 0 || (body.table.shots ?? []).length === 0) {
+				writeJson(res, 400, { error: "table 不能为空，请先生成分镜表" });
+				return;
+			}
+			try {
+				writeJson(res, 200, { prompts: await generateStoryboardPrompts(ctx, config, project, config.outputDir, no, body.table, body?.styleId, body?.filterId) });
+			} catch (error) {
+				writeJson(res, 500, { error: `视频提示词生成失败：${error.message}` });
+			}
+		}
+	};
+	/** 分镜·导演级：骨架 → 分镜表（镜头级）。 */
+	const storyboardTableRoute = {
+		kind: "exact",
+		path: NOVEL_API.storyboardTable,
+		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 no = body?.chapterNo;
+			if (!Number.isInteger(no) || no === void 0 || no < 1) {
+				writeJson(res, 400, { error: "chapterNo 须为正整数" });
+				return;
+			}
+			if (body?.skeleton === void 0 || (body.skeleton.beats ?? []).length === 0) {
+				writeJson(res, 400, { error: "skeleton 不能为空，请先生成剧情骨架" });
+				return;
+			}
+			try {
+				writeJson(res, 200, { table: await generateStoryboardTable(ctx, config, project, config.outputDir, no, body.skeleton, body?.styleId, body?.filterId) });
+			} catch (error) {
+				writeJson(res, 500, { error: `分镜表生成失败：${error.message}` });
+			}
+		}
+	};
+	/** 漫剧方案管理：create / remove / activate。 */
+	const manhuaPlansRoute = {
+		kind: "exact",
+		path: NOVEL_API.manhuaPlans,
+		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 (project.mangaPlans === void 0) project.mangaPlans = [];
+			if (body?.op === "create") {
+				const name = body.name?.trim();
+				const styleId = body.styleId?.trim();
+				if (name === void 0 || name === "" || styleId === void 0 || styleId === "") {
+					writeJson(res, 400, { error: "name 与 styleId 不能为空" });
+					return;
+				}
+				if (project.mangaPlans.some((p) => p.name === name)) {
+					writeJson(res, 400, { error: `方案名「${name}」已存在` });
+					return;
+				}
+				const id = `manga-${Date.now().toString(36)}`;
+				project.mangaPlans.push({
+					id,
+					name: name.slice(0, 40),
+					styleId,
+					filterId: body.filterId?.trim() !== "" ? body.filterId?.trim() : void 0,
+					active: project.mangaPlans.length === 0,
+					createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+					updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+				});
+			} else if (body?.op === "remove" && body.id !== void 0) {
+				const removed = project.mangaPlans.find((p) => p.id === body.id);
+				project.mangaPlans = project.mangaPlans.filter((p) => p.id !== body.id);
+				if (removed?.active === true && project.mangaPlans.length > 0) project.mangaPlans[0].active = true;
+			} else if (body?.op === "activate" && body.id !== void 0) project.mangaPlans.forEach((p) => {
+				p.active = p.id === body.id;
+			});
+			else {
+				writeJson(res, 400, { error: "op 须为 create/remove/activate" });
+				return;
+			}
+			project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+			saveProject(config.outputDir, project);
+			writeJson(res, 200, { plans: project.mangaPlans });
+		}
+	};
+	/** 风格库效果图：GET /styles/image?id=<styleId>，从 ~/.dsh/dsh-novel-forge-styles/<id>.png 读取。 */
+	const styleImageRoute = {
+		kind: "exact",
+		path: "/api/dsh-novel-forge/styles/image",
+		handler: async (req, res) => {
+			if (!isLoopbackRequest(req)) {
+				writeJson(res, 403, { error: "forbidden: loopback-only" });
+				return;
+			}
+			const id = (new URL(req.url ?? "", "http://localhost").searchParams.get("id") ?? "").replace(/[^a-z0-9-]/gi, "");
+			if (id === "") {
+				writeJson(res, 404, { error: "style image not found" });
+				return;
+			}
+			const base = join(homedir(), ".dsh", "dsh-novel-forge-styles");
+			const candidates = [
+				{
+					file: join(base, "thumbs", id + ".webp"),
+					type: "image/webp"
+				},
+				{
+					file: join(base, id + ".png"),
+					type: "image/png"
+				},
+				{
+					file: join(builtinStyleDir, id + ".webp"),
+					type: "image/webp"
+				}
+			];
+			for (const c of candidates) if (existsSync(c.file)) {
+				res.writeHead(200, {
+					"content-type": c.type,
+					"cache-control": "public, max-age=86400"
+				});
+				res.end(readFileSync(c.file));
+				return;
+			}
+			writeJson(res, 404, { error: "style image not found" });
+		}
+	};
+	/** 分镜·编剧级：单章 → 剧情骨架（节拍链）。 */
+	const storyboardSkeletonRoute = {
+		kind: "exact",
+		path: NOVEL_API.storyboardSkeleton,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const config = getConfig();
+			const project = requireProject(res);
+			if (project === void 0) return;
+			const no = (await readJsonBody(req))?.chapterNo;
+			if (!Number.isInteger(no) || no === void 0 || no < 1) {
+				writeJson(res, 400, { error: "chapterNo 须为正整数" });
+				return;
+			}
+			try {
+				writeJson(res, 200, { skeleton: await generateStoryboardSkeleton(ctx, config, project, config.outputDir, no) });
+			} catch (error) {
+				writeJson(res, 500, { error: `剧情骨架生成失败：${error.message}` });
+			}
+		}
+	};
 	/** 拆书分析：对已写章节做结构/人物/文风/卖点体检（两阶段：源笔记→分节分析）。 */
 	const breakdownRoute = {
 		kind: "exact",
@@ -6817,6 +7656,7 @@ function makeRoutes(deps) {
 		bookshelfRemoveRoute,
 		bookshelfImportDirRoute,
 		bookshelfImportTextRoute,
+		bookshelfImportTextPreviewRoute,
 		resetRoute,
 		auditRoute,
 		charactersRefreshRoute,
@@ -6837,6 +7677,12 @@ function makeRoutes(deps) {
 		configRoute,
 		openFolderRoute,
 		outlineSuggestRoute,
+		outlineReverseRoute,
+		manhuaPlansRoute,
+		styleImageRoute,
+		storyboardSkeletonRoute,
+		storyboardTableRoute,
+		storyboardPromptsRoute,
 		breakdownRoute,
 		{
 			kind: "exact",
@@ -6931,6 +7777,12 @@ const Config = z.object({
 		"high",
 		"max"
 	]).default("off"),
+	analysisReasoning: z.union([
+		"off",
+		"low",
+		"high",
+		"max"
+	]).default("low"),
 	chapterChars: z.number().default(3500),
 	maxTokens: z.number().default(12e3),
 	reviewPassScore: z.number().default(70),
@@ -6948,6 +7800,7 @@ const DEFAULT_OUTPUT_DIR = join(homedir(), ".dsh", "novels");
 const DEFAULT_PROVIDER = "deepseek-official";
 const DEFAULT_MODEL = "deepseek-v4-flash";
 const DEFAULT_REASONING_EFFORT = "off";
+const DEFAULT_ANALYSIS_REASONING = "low";
 const DEFAULT_CHAPTER_CHARS = 3500;
 const DEFAULT_MAX_TOKENS = 12e3;
 const DEFAULT_REVIEW_PASS_SCORE = 70;
@@ -6966,6 +7819,7 @@ function resolveConfig(value) {
 		provider: value?.provider ?? DEFAULT_PROVIDER,
 		model: value?.model ?? DEFAULT_MODEL,
 		reasoningEffort: value?.reasoningEffort ?? DEFAULT_REASONING_EFFORT,
+		analysisReasoning: value?.analysisReasoning ?? DEFAULT_ANALYSIS_REASONING,
 		chapterChars: value?.chapterChars ?? DEFAULT_CHAPTER_CHARS,
 		maxTokens: value?.maxTokens ?? DEFAULT_MAX_TOKENS,
 		reviewPassScore: value?.reviewPassScore ?? DEFAULT_REVIEW_PASS_SCORE,
@@ -7000,6 +7854,7 @@ function apply(ctx, config) {
 		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.analysisReasoning !== void 0) next.analysisReasoning = patch.analysisReasoning;
 		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;