@waterwx/dsh-novel-forge 1.4.1 → 1.6.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,
@@ -1926,10 +2116,13 @@ async function extractRoles(ctx, config, project) {
 	return roles;
 }
 /** ✨ AI 从全书提炼场景库：正文/编年录 → 高频重要场景的结构化视觉锚点。 */
-async function extractScenes(ctx, config, project) {
+async function extractScenes(ctx, config, project, styleId, filterId) {
+	const styleWords = styleKeywords(styleId, filterId);
 	const system = [
 		"你是一位网文漫剧场景导演。根据本书的大纲、编年录与已写章节摘录，提炼「镜头场景」——漫剧分镜/生图时每个镜头要知道\"在哪、什么时间光态、拍什么情节、人物什么状态\"。",
 		"按五幕结构覆盖全书核心场景（短篇 10 章内可少于五幕，按实际剧情组织）：第一幕后场/核心主场、第二幕对外卖场/营业区、第三幕禁忌区域/地下深仓、第四幕外部人间世界（短暂出逃）、第五幕回归与抉择。",
+		"【当前视觉风格】（moment/palette/moods/zh/en 必须按此风格措辞，不能写中性描述）：" + styleWords,
+		"重要：每个场景的 zh 提示词段首必须原样嵌入【当前视觉风格】词块原文；en 提示词末尾追加风格标签。不得省略或改写。",
 		"每个场景必须是「镜头场景」而非仅场地：给出该场景的关键情节镜头（人物动作+情绪+镜头推进）。",
 		"数量控制：最多输出 8 个场景；每个场景必须能对应到正文实际出现过的地点与情节，不得凭空虚构。",
 		"每个场景输出：",
@@ -1987,10 +2180,11 @@ async function extractScenes(ctx, config, project) {
 			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),
+			zh: ensureStyleEmbedded(str(entry.zh).slice(0, 800), styleWords, "zh"),
+			en: ensureStyleEmbedded(str(entry.en).slice(0, 600), styleWords, "en"),
 			tags: strArr(entry.tags).map((t) => t.slice(0, 24)).slice(0, 6),
-			source: str(entry.source).slice(0, 120)
+			source: str(entry.source).slice(0, 120),
+			styleId
 		});
 	}
 	return scenes;
@@ -2164,13 +2358,112 @@ function importBookTextFromText(raw, outputDir, bookName) {
 function importBookText(filePath, outputDir) {
 	return importBookTextFromText(decodeTextSmart(readFileSync(filePath)), outputDir, basename(filePath, extname(filePath)).slice(0, 40) || "导入小说");
 }
+/** 常见职业/身份尾缀：角色名如「周野律师」正文可能只写「周野」或「周野的律师」。 */
+const ROLE_NAME_SUFFIXES = [
+	"律师",
+	"辩护律师",
+	"医生",
+	"老师",
+	"教授",
+	"先生",
+	"女士",
+	"小姐",
+	"警官",
+	"警察",
+	"局长",
+	"总经理",
+	"经理",
+	"老板",
+	"师父",
+	"师傅",
+	"道长",
+	"老祖",
+	"长老",
+	"掌门",
+	"少主",
+	"公主",
+	"王子",
+	"王妃",
+	"皇后",
+	"皇帝",
+	"王爷",
+	"公子",
+	"姑娘",
+	"夫人",
+	"太太",
+	"大人",
+	"将军",
+	"丞相",
+	"尚书",
+	"员外"
+];
+/**
+* 从角色名/身份拆出正文可能使用的检索词：
+* - specific：具体称谓（含职业尾缀或 3 字以上身份片段），如「周野的律师」「辩护律师」「律师」——优先用，避免误抓到同名主干（周野）的段落；
+* - stems：名字主干（如「周野」），最后兜底。
+*/
+function roleFallbackTokens(name, identity) {
+	const specific = /* @__PURE__ */ new Set();
+	const stems = /* @__PURE__ */ new Set();
+	const addName = (s) => {
+		const t = s.trim();
+		if (t.length < 2) return;
+		specific.add(t);
+		for (const q of [
+			"辩护",
+			"助理",
+			"高级",
+			"首席",
+			"御用",
+			"御前",
+			"专职"
+		]) if (t.includes(q)) specific.add(t.replace(q, ""));
+		for (const suf of ROLE_NAME_SUFFIXES) if (t.endsWith(suf) && t.length > suf.length + 1) {
+			const stem = t.slice(0, -suf.length);
+			specific.add(stem + "的" + suf);
+			specific.add(suf);
+			if (stem.length >= 2) stems.add(stem);
+		}
+	};
+	addName(name);
+	for (const part of (identity ?? "").split(/[的，,。\s]+/)) {
+		const p = part.trim();
+		if (p.length < 2) continue;
+		if (p.length >= 3 || ROLE_NAME_SUFFIXES.some((s) => p.endsWith(s))) {
+			specific.add(p);
+			for (const suf of ROLE_NAME_SUFFIXES) if (p.endsWith(suf) && p.length > suf.length + 1) {
+				specific.add(suf);
+				stems.add(p.slice(0, -suf.length));
+			}
+		} else stems.add(p);
+	}
+	return {
+		specific: [...specific].filter((t) => t.length >= 2),
+		stems: [...stems].filter((t) => t.length >= 2)
+	};
+}
+/** 保证风格词块已内嵌（LLM 偶发漏嵌时兜底）：zh 段首前缀，en 末尾追加。 */
+function ensureStyleEmbedded(text, styleWords, lang) {
+	const t = text.trim();
+	if (styleWords === "" || t === "") return t;
+	if (t.includes(styleWords)) return t;
+	return lang === "zh" ? styleWords + "，" + t : t + "，" + styleWords;
+}
+/** 对 zh/en 一对提示词统一补风格词块。 */
+function withStyle(pair, styleWords) {
+	return {
+		zh: ensureStyleEmbedded(pair.zh, styleWords, "zh"),
+		en: ensureStyleEmbedded(pair.en, styleWords, "en")
+	};
+}
 /**
 * 为单个角色提炼「动漫形象描述词」：扫描该角色出场的已写章节正文，
 * 截取含外貌描写的段落，交给 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}」不在角色库中`);
+	role.promptStyleId = styleId;
 	const appearanceHints = /(发|眉|眼|眸|脸|肤|唇|身材|身高|衣|袍|裙|衫|靴|腰带|气质|模样|长相|容貌|披|束|扎|戴|佩|挂|绣|青|白|黑|红|蓝|紫|灰|银|金|少年|青年|少女|汉子|老者|中年|纤细|挺拔|瘦削|壮实|清秀|俊朗|英气|阴鸷|慈眉)/;
 	const roleText = `${role.name} ${role.identity ?? ""}`;
 	const colorWords = [
@@ -2237,38 +2530,55 @@ async function extractRoleVisual(ctx, config, project, outputDir, roleName) {
 		...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 matchesRole = (para, tokens) => para.includes(roleName) || tokens.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) {
-		const body = readChapterFile(outputDir, chapter);
-		if (body === void 0) continue;
-		const paras = body.split(/\n{2,}/).map((p) => p.trim()).filter((p) => p.length > 0);
-		let perChapter = 0;
-		for (const para of paras) {
-			if (perChapter >= 2 || excerpts.length >= 12) break;
-			if (!matchesRole(para)) continue;
-			if (appearanceHints.test(para) || excerpts.length < 4) {
-				excerpts.push({
-					no: chapter.no,
-					text: para.slice(0, 220)
-				});
-				perChapter++;
+	const written = project.chapters.filter((c) => c.status !== "pending" && c.status !== "generating" && c.file !== void 0);
+	/** 扫描一批章节，收集该角色出场且可能含外貌描写的段落（每章最多 2 段，共 12 段）。 */
+	const scanChapters = (list, tokens) => {
+		for (const chapter of list) {
+			if (excerpts.length >= 12) break;
+			const body = readChapterFile(outputDir, chapter);
+			if (body === void 0) continue;
+			const paras = body.split(/\n{2,}/).map((p) => p.trim()).filter((p) => p.length > 0);
+			let perChapter = 0;
+			for (const para of paras) {
+				if (perChapter >= 2 || excerpts.length >= 12) break;
+				if (!matchesRole(para, tokens)) continue;
+				if (appearanceHints.test(para) || excerpts.length < 4) {
+					excerpts.push({
+						no: chapter.no,
+						text: para.slice(0, 220)
+					});
+					perChapter++;
+				}
 			}
 		}
-		if (excerpts.length >= 12) break;
+	};
+	scanChapters(written.slice(-60), searchTokens);
+	if (excerpts.length === 0) scanChapters(written, searchTokens);
+	if (excerpts.length === 0) {
+		const fb = roleFallbackTokens(role.name, role.identity);
+		if (fb.specific.length > 0) scanChapters(written, fb.specific);
 	}
-	if (excerpts.length === 0) throw new Error(`正文中未找到「${roleName}」的出场描写（仅搜索最近 60 章），请确认角色名与正文一致`);
+	if (excerpts.length === 0) {
+		const fb = roleFallbackTokens(role.name, role.identity);
+		if (fb.stems.length > 0) scanChapters(written, fb.stems);
+	}
+	if (excerpts.length === 0) throw new Error(`正文中未找到「${roleName}」的出场描写（已扫描全书及角色名拆分词），请确认角色名与正文一致，或该角色尚未在正文出场`);
+	const rules = project.visualRules ?? [];
+	const styleWords = styleKeywords(styleId, filterId);
 	const raw = parseJsonObject(await complete(ctx, config, {
 		system: [
 			"你是一位动漫角色设定师与 AI 绘图提示词工程师。根据网文正文中该角色的实际外貌描写，输出「形象锚点」与「四类生图提示词」——一次完成，用于 AI 绘图（NovelAI / Stable Diffusion / Midjourney / 豆包等）生成一致的角色立绘。",
+			"【当前视觉风格】（portrait 立绘的「风格」字段必须原样使用，sheet/expressions/details 同样内嵌）：" + styleWords,
+			"重要：每段 zh 提示词的段首必须原样嵌入【当前视觉风格】词块原文；en 提示词末尾追加风格标签。不得省略或改写。",
 			"硬性要求（依据优先）：",
 			"1. 发色/发型/瞳色/服装/气质/标志物必须来自提供的正文段落，不得凭空发明。",
 			"2. 正文未明确写到的项目（如瞳色没写、身高没写），用「未定」标注或直接不写，不要编造数值。",
 			"3. 服装优先取正文明确出现的（颜色+款式），多次出现取最常穿的组合；服装按分件组织（上身/下身/鞋/配饰）。",
 			"4. 标志物（标签/印记/饰品）必须出现在每段提示词中——它们是一致性的命根子。",
 			"【本书视觉规则】（必须内嵌进每段提示词，保证设定不跑偏）：",
-			...(project.visualRules ?? []).map((r) => "- " + r),
+			...rules.map((r) => "- " + r),
 			"输出六部分：",
 			"- zh：中文形象锚点，一段连贯文字（60-150 字）：发色发型、瞳色、脸型气质、服装（颜色款式）、身材、标志性物件。",
 			"- en：英文形象锚点，booru 风格、逗号分隔、小写，30-50 个标签：含性别（1boy/1girl）、发色、发型、瞳色、服装、气质、标志物。不要输出负面提示词。",
@@ -2297,8 +2607,8 @@ async function extractRoleVisual(ctx, config, project, outputDir, roleName) {
 		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) : "";
+	let zh = typeof raw.zh === "string" ? raw.zh.trim().slice(0, 500) : "";
+	let 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) : [];
@@ -2328,6 +2638,17 @@ async function extractRoleVisual(ctx, config, project, outputDir, roleName) {
 		promptKit = void 0;
 	}
 	if (zh === "" || en === "") throw new Error("形象描述提炼失败：LLM 未返回有效 JSON");
+	zh = ensureStyleEmbedded(zh, styleWords, "zh");
+	en = ensureStyleEmbedded(en, styleWords, "en");
+	if (promptKit !== void 0) promptKit = {
+		portrait: withStyle(promptKit.portrait, styleWords),
+		sheet: withStyle(promptKit.sheet, styleWords),
+		expressions: promptKit.expressions.map((e) => ({
+			...e,
+			...withStyle(e, styleWords)
+		})),
+		details: withStyle(promptKit.details, styleWords)
+	};
 	return {
 		zh,
 		en,
@@ -2341,20 +2662,25 @@ 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}」还没有形象锚点，请先生成锚点`);
+	role.promptStyleId = styleId;
+	const rules = project.visualRules ?? [];
+	const styleWords = styleKeywords(styleId, filterId);
 	const raw = parseJsonObject(await complete(ctx, config, {
 		system: [
 			"你是一位 AI 绘图提示词工程师。基于给定角色的形象锚点、表情清单与本书视觉规则，输出四类生图提示词（每类 zh+en 各一段）。",
+			"【当前视觉风格】（每类提示词必须内嵌）：" + styleWords,
+			"重要：每段 zh 提示词的段首必须原样嵌入【当前视觉风格】词块原文；en 提示词末尾追加风格标签。不得省略或改写。",
 			"四类：",
 			"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 结果本身。"
@@ -2381,14 +2707,16 @@ async function generateRolePromptKit(ctx, config, project, roleName) {
 	};
 	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),
+		portrait: withStyle(pair(raw.portrait), styleWords),
+		sheet: withStyle(pair(raw.sheet), styleWords),
 		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)
+			...withStyle({
+				zh: str(e.zh).slice(0, 800),
+				en: str(e.en).slice(0, 1200)
+			}, styleWords)
 		})).slice(0, 12),
-		details: pair(raw.details)
+		details: withStyle(pair(raw.details), styleWords)
 	};
 	if (kit.portrait.zh === "" || kit.portrait.en === "") throw new Error("提示词精修失败：LLM 未返回有效 JSON");
 	return kit;
@@ -3049,6 +3377,229 @@ 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);
+	const next = {
+		...(idx === -1 ? void 0 : project.storyboards[idx]) ?? {},
+		...entry
+	};
+	if (entry.skeleton !== void 0) {
+		next.table = void 0;
+		next.prompts = void 0;
+	}
+	if (entry.table !== void 0) next.prompts = void 0;
+	if (idx === -1) project.storyboards.push(next);
+	else project.storyboards[idx] = next;
+	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 usedScenes = (project.scenes ?? []).filter((s) => body.includes(s.name)).slice(0, 6);
+	const scenes = usedScenes.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,
+		usedScenes: usedScenes.map((s) => s.name)
+	};
+	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: ensureStyleEmbedded(typeof entry.text === "string" ? entry.text.trim().slice(0, 400) : "", stylePrefix, "zh")
+	})).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;
+}
 /**
 * 反向推大纲：从已写章节正文反推出全书总纲（分卷 + 章节要点 + 主线/人物弧线/伏笔清单）。
 * 两阶段：分批提取章节事件摘要 → 汇总生成大纲。不修改章节/设定，只返回大纲文本。
@@ -4170,6 +4721,14 @@ const NOVEL_API = {
 	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 扫描已生成章节，输出矛盾问题清单。 */
@@ -5013,6 +5572,8 @@ async function* runAssistantTurn(ctx, config, project, outputDir, userMessage) {
 //#region src/routes.ts
 /** Cap on JSON request bodies (generous: cover images travel as base64). */
 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;
@@ -6644,7 +7205,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;
@@ -6669,7 +7230,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();
@@ -6934,6 +7495,167 @@ function makeRoutes(deps) {
 			}
 		}
 	};
+	/** 分镜·提示词级：分镜表 → 即梦可粘贴视频提示词。 */
+	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",
@@ -6964,7 +7686,7 @@ function makeRoutes(deps) {
 			if (project.scenes === void 0) project.scenes = [];
 			const op = body?.op;
 			if (op === "extract") try {
-				const candidates = await extractScenes(ctx, config, project);
+				const candidates = await extractScenes(ctx, config, project, body?.styleId, body?.filterId);
 				writeJson(res, 200, {
 					scenes: project.scenes,
 					candidates
@@ -7100,6 +7822,11 @@ function makeRoutes(deps) {
 		openFolderRoute,
 		outlineSuggestRoute,
 		outlineReverseRoute,
+		manhuaPlansRoute,
+		styleImageRoute,
+		storyboardSkeletonRoute,
+		storyboardTableRoute,
+		storyboardPromptsRoute,
 		breakdownRoute,
 		{
 			kind: "exact",