@waterwx/dsh-novel-forge 1.7.2 → 1.8.0

package/lib/index.js

@@ -2,11 +2,11 @@ import { homedir } from "node:os";
 import { basename, extname, join } from "node:path";
 import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
 import z from "schemastery";
-import { exec } from "node:child_process";
+import { spawn } from "node:child_process";
 import { appendFileSync, copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
+import { randomBytes } from "node:crypto";
 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";
 //#region src/assets.ts
 /** 预置写法模板（来自 AI-Novel-Writing-Assistant 内置 DEFAULT_STYLE_TEMPLATES）。 */
@@ -854,6 +854,338 @@ function styleKeywords(styleId, filterId) {
 	return parts.join("，") || "3D动漫，超精细建模，电影光影";
 }
 //#endregion
+//#region src/shot-language.ts
+const SHOT_SIZES = [
+	{
+		id: "extreme_wide",
+		zh: "大远景",
+		en: "extreme wide shot",
+		hint: "环境为主，人物很小"
+	},
+	{
+		id: "wide",
+		zh: "远景",
+		en: "wide shot",
+		hint: "人在景中，交代环境"
+	},
+	{
+		id: "full",
+		zh: "全景",
+		en: "full shot",
+		hint: "全身』人物整体"
+	},
+	{
+		id: "medium",
+		zh: "中景",
+		en: "medium shot",
+		hint: "膝部以上，叙事主力"
+	},
+	{
+		id: "medium_close",
+		zh: "中近景",
+		en: "medium close-up",
+		hint: "胸以上，表情+动作"
+	},
+	{
+		id: "close",
+		zh: "近景",
+		en: "close-up",
+		hint: "肩以上，突出表情"
+	},
+	{
+		id: "extreme_close",
+		zh: "特写",
+		en: "extreme close-up",
+		hint: "脸/物细节"
+	},
+	{
+		id: "big_extreme_close",
+		zh: "大特写",
+		en: "big close-up",
+		hint: "局部（眼/手/标志物）"
+	}
+];
+const CAMERA_MOVES = [
+	{
+		id: "static",
+		zh: "固定机位",
+		en: "static camera",
+		hint: "机位不动"
+	},
+	{
+		id: "dolly_in",
+		zh: "推近",
+		en: "dolly in",
+		hint: "镜头向主体逼近"
+	},
+	{
+		id: "dolly_out",
+		zh: "拉远",
+		en: "dolly out",
+		hint: "镜头远离主体"
+	},
+	{
+		id: "pan_left",
+		zh: "左摇",
+		en: "pan left",
+		hint: "机位不动，镜头左转"
+	},
+	{
+		id: "pan_right",
+		zh: "右摇",
+		en: "pan right",
+		hint: "机位不动，镜头右转"
+	},
+	{
+		id: "track_left",
+		zh: "左横移",
+		en: "track left",
+		hint: "机位随主体左移"
+	},
+	{
+		id: "track_right",
+		zh: "右横移",
+		en: "track right",
+		hint: "机位随主体右移"
+	},
+	{
+		id: "follow",
+		zh: "跟随",
+		en: "follow shot",
+		hint: "镜头跟着主体运动"
+	},
+	{
+		id: "pedestal_up",
+		zh: "升镜",
+		en: "pedestal up",
+		hint: "机位抬高"
+	},
+	{
+		id: "pedestal_down",
+		zh: "降镜",
+		en: "pedestal down",
+		hint: "机位降低"
+	},
+	{
+		id: "orbit",
+		zh: "环绕",
+		en: "orbit shot",
+		hint: "镜头绕主体转"
+	},
+	{
+		id: "handheld",
+		zh: "手持晃动",
+		en: "handheld",
+		hint: "真实感/紧张感"
+	},
+	{
+		id: "low_angle",
+		zh: "低机位仰拍",
+		en: "low angle",
+		hint: "突出威严/压迫"
+	},
+	{
+		id: "high_angle",
+		zh: "高机位俯拍",
+		en: "high angle",
+		hint: "突出渺小/全知"
+	},
+	{
+		id: "over_shoulder",
+		zh: "过肩镜头",
+		en: "over-the-shoulder",
+		hint: "对话常用"
+	}
+];
+const LIGHTINGS = [
+	{
+		id: "front",
+		zh: "顺光",
+		en: "front light",
+		hint: "正面均匀照明"
+	},
+	{
+		id: "side",
+		zh: "侧光",
+		en: "side light",
+		hint: "明暗对比强"
+	},
+	{
+		id: "back",
+		zh: "逆光",
+		en: "back light",
+		hint: "轮廓光/剪影"
+	},
+	{
+		id: "top",
+		zh: "顶光",
+		en: "top light",
+		hint: "俯照硬朗"
+	},
+	{
+		id: "rembrandt",
+		zh: "伦勃朗光",
+		en: "rembrandt lighting",
+		hint: "侧逆光，经典人像"
+	},
+	{
+		id: "neon",
+		zh: "霓虹光",
+		en: "neon lighting",
+		hint: "赛博/夜景"
+	},
+	{
+		id: "hard",
+		zh: "硬光",
+		en: "hard light",
+		hint: "犀利阴影"
+	},
+	{
+		id: "soft",
+		zh: "柔光",
+		en: "soft light",
+		hint: "柔和过渡"
+	},
+	{
+		id: "mood",
+		zh: "氛围光",
+		en: "mood lighting",
+		hint: "情绪化色温"
+	},
+	{
+		id: "contrast",
+		zh: "高反差",
+		en: "high contrast",
+		hint: "黑白/强明暗"
+	}
+];
+/** 从中文文本归一化到景别（处理旧数据/LLM 口语）。未知回退 medium。 */
+function normalizeShotSize(text) {
+	if (text === void 0 || text === "") return "medium";
+	const t = text.trim();
+	if (t.includes("大远景")) return "extreme_wide";
+	if (t.includes("远景")) return "wide";
+	if (t.includes("全景")) return "full";
+	if (t.includes("中近景") || t.includes("中景")) return "medium";
+	if (t.includes("近景") || t.includes("胸")) return "close";
+	if (t.includes("大特写")) return "big_extreme_close";
+	if (t.includes("特写")) return "extreme_close";
+	return "medium";
+}
+/** 从中文文本归一化到运镜列表。 */
+function normalizeCameras(text) {
+	if (text === void 0 || text === "") return ["static"];
+	const t = text.trim();
+	const out = [];
+	const push = (id) => {
+		if (!out.includes(id)) out.push(id);
+	};
+	if (t.includes("推近") || t.includes("推进")) push("dolly_in");
+	if (t.includes("拉远") || t.includes("拉出")) push("dolly_out");
+	if (t.includes("左摇")) push("pan_left");
+	if (t.includes("右摇")) push("pan_right");
+	if (t.includes("横移")) push(t.includes("左") ? "track_left" : "track_right");
+	if (t.includes("跟随") || t.includes("跟拍")) push("follow");
+	if (t.includes("升降") || t.includes("升") || t.includes("降")) push("pedestal_up");
+	if (t.includes("环绕")) push("orbit");
+	if (t.includes("手持") || t.includes("晃动")) push("handheld");
+	if (t.includes("低机位") || t.includes("仰拍") || t.includes("仰")) push("low_angle");
+	if (t.includes("高机位") || t.includes("俯拍") || t.includes("俯")) push("high_angle");
+	if (t.includes("过肩")) push("over_shoulder");
+	if (out.length === 0) push("static");
+	return out;
+}
+/** 从中文文本归一化到构图（可选）。 */
+function normalizeComposition(text) {
+	if (text === void 0 || text === "") return void 0;
+	const t = text.trim();
+	if (t.includes("三分")) return "rule_of_thirds";
+	if (t.includes("中心") || t.includes("居中")) return "center";
+	if (t.includes("引导")) return "leading_line";
+	if (t.includes("前景")) return "foreground";
+	if (t.includes("低机位")) return "low";
+	if (t.includes("俯拍") || t.includes("俯视")) return "overhead";
+	if (t.includes("对称")) return "symmetry";
+}
+/** 从中文文本归一化到光效列表。 */
+function normalizeLightings(text) {
+	if (text === void 0 || text === "") return ["soft"];
+	const t = text.trim();
+	const out = [];
+	const push = (id) => {
+		if (!out.includes(id)) out.push(id);
+	};
+	if (t.includes("顺光")) push("front");
+	if (t.includes("侧光") || t.includes("伦勃朗")) push(t.includes("伦勃朗") ? "rembrandt" : "side");
+	if (t.includes("逆光")) push("back");
+	if (t.includes("顶光")) push("top");
+	if (t.includes("霓虹")) push("neon");
+	if (t.includes("硬光")) push("hard");
+	if (t.includes("柔光")) push("soft");
+	if (t.includes("氛围") || t.includes("情绪")) push("mood");
+	if (t.includes("高反差")) push("contrast");
+	if (out.length === 0) push("soft");
+	return out;
+}
+/** 取词条中文（ZHs 合并句子）。 */
+function sizeZh(id) {
+	return SHOT_SIZES.find((e) => e.id === id)?.zh ?? "中景";
+}
+function cameraZh(ids) {
+	if (ids === void 0 || ids.length === 0) return "固定机位";
+	return CAMERA_MOVES.filter((e) => ids.includes(e.id)).map((e) => e.zh).join(" + ");
+}
+function lightZh(ids) {
+	if (ids === void 0 || ids.length === 0) return "柔光";
+	return LIGHTINGS.filter((e) => ids.includes(e.id)).map((e) => e.zh).join(" + ");
+}
+//#endregion
+//#region src/story-beat-language.ts
+/** 从中文归一化叙事功能（未知回退 exposition）。 */
+function normalizeStoryFunction(text) {
+	if (text === void 0 || text === "") return "exposition";
+	const t = text.trim();
+	if (t.includes("铺垫")) return "exposition";
+	if (t.includes("冲突")) return "conflict";
+	if (t.includes("转折")) return "turn";
+	if (t.includes("高潮")) return "climax";
+	if (t.includes("收束")) return "resolve";
+	if (t.includes("伏笔")) return "foreshadow";
+	if (t.includes("人物塑造")) return "character";
+	return "exposition";
+}
+/** 从中文文本归一化情绪词列表（可含→箭头链）。 */
+function normalizeEmotions(text) {
+	if (text === void 0 || text === "") return ["calm"];
+	const t = text.trim();
+	const out = [];
+	const push = (id) => {
+		if (!out.includes(id)) out.push(id);
+	};
+	if (t.includes("平静")) push("calm");
+	if (t.includes("淡然")) push("indifferent");
+	if (t.includes("期待")) push("expectant");
+	if (t.includes("好奇")) push("curious");
+	if (t.includes("警觉")) push("alert");
+	if (t.includes("压抑")) push("suppressed");
+	if (t.includes("隐忍")) push("enduring");
+	if (t.includes("担忧")) push("worried");
+	if (t.includes("焦躁")) push("irritable");
+	if (t.includes("不安")) push("uneasy");
+	if (t.includes("惊惧")) push("terrified");
+	if (t.includes("愤怒")) push("angry");
+	if (t.includes("崩溃")) push("collapsing");
+	if (t.includes("决绝")) push("resolute");
+	if (t.includes("痛心")) push("grieved");
+	if (t.includes("释然")) push("relieved");
+	if (t.includes("悲凉")) push("bittersweet");
+	if (t.includes("得意")) push("triumphant");
+	if (t.includes("重生")) push("reborn");
+	if (t.includes("麻木")) push("numb");
+	if (out.length === 0) push("calm");
+	return out;
+}
+//#endregion
 //#region src/engine.ts
 /**
 * Novel engine — the host half's core: LLM-driven story-bible extraction,
@@ -3835,8 +4167,11 @@ async function generateStoryboardTable(ctx, config, project, outputDir, chapterN
 		system: [
 			"你是一位从业 10 年的电影导演兼分镜师，专长网文改编影视化。",
 			"任务：把「剧情骨架」的每一个节拍展开为 1-3 个电影镜头，输出分镜表——只做画面层，禁止新增或改变剧情（骨架是只读输入）。",
-			"输出合法 JSON 对象：{\"shots\": [{\"beatId\": \"骨架节拍id\", \"shot\": \"景别\", \"camera\": \"机位与运镜\", \"duration\": 秒数, \"visual\": \"画面内容\", \"line\": \"台词/旁白\", \"sound\": \"音效\", \"light\": \"光效\", \"prevState\": \"承接上一镜头结尾状态\", \"nextState\": \"本镜头结束状态\", \"characters\": [\"出镜角色名\"]}]}",
-			"景别取值：远景/全景/中景/近景/特写。",
+			"输出合法 JSON 对象：{\"shots\": [{\"beatId\": \"骨架节拍id\", \"shot\": \"景别\", \"camera\": \"机位与运镜\", \"composition\": \"构图\", \"duration\": 秒数, \"visual\": \"画面内容\", \"line\": \"台词/旁白\", \"sound\": \"音效\", \"light\": \"光效\", \"prevState\": \"承接上一镜头结尾状态\", \"nextState\": \"本镜头结束状态\", \"characters\": [\"出镜角色名\"]}]}",
+			"景别取值（只能从这些词中选一）：大远景/远景/全景/中景/中近景/近景/特写/大特写。",
+			"运镜取值（可组合，用加号连接）：固定机位/推近/拉远/左摇/右摇/左横移/右横移/跟随/升镜/降镜/环绕/手持晃动/低机位仰拍/高机位俯拍/过肩镜头。",
+			"光效取值（可组合，用加号连接）：顺光/侧光/逆光/顶光/伦勃朗光/霓虹光/硬光/柔光/氛围光/高反差。",
+			"构图取值（可选，只能从这些词中选一）：三分法/中心对称/引导线/前景遮挡/低机位/俯拍/对称构图。",
 			"硬性要求：",
 			"【视觉风格】（必须内嵌进 visual/light 的画面措辞与光效描述）：",
 			...styleLines,
@@ -3862,27 +4197,21 @@ async function generateStoryboardTable(ctx, config, project, outputDir, chapterN
 			body.replace(/^#\s+.*$/m, "").trim().slice(0, 3e3)
 		].filter((s) => s !== "").join("\n\n"),
 		temperature: .3,
-		maxTokens: Math.max(config.maxTokens, 6e3),
+		maxTokens: Math.max(config.maxTokens, 16e3),
 		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) : "",
+		shot: normalizeShotSize(entry.shot),
+		camera: normalizeCameras(entry.camera),
+		composition: normalizeComposition(entry.composition),
 		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) : "",
+		light: normalizeLightings(entry.light),
 		prevState: typeof entry.prevState === "string" ? entry.prevState.trim().slice(0, 150) : "",
 		nextState: typeof entry.nextState === "string" ? entry.nextState.trim().slice(0, 150) : "",
 		characters: sanitizeCharacters(entry.characters, 4)
@@ -3940,12 +4269,12 @@ async function generateStoryboardPrompts(ctx, config, project, outputDir, chapte
 			const ref = c.imageUrl !== void 0 ? "（参考图）" : "";
 			return c.name + "：" + anchor + ref;
 		}).join("；");
-		return `[${s.id}] 节拍${s.beatId} · ${s.shot} · ${s.camera} · ${s.duration}s
+		return `[${s.id}] 节拍${s.beatId} · ${sizeZh(s.shot)} · ${cameraZh(s.camera)} · ${s.duration}s
 出场：${s.characters !== void 0 && s.characters.length > 0 ? s.characters.join("、") : "（未标注）"}
 定妆：${makeUp !== "" ? makeUp : "（未绑定漫剧卡）"}
 画面：${s.visual}
 台词：${s.line !== "" ? s.line : "（无）"}
-光效：${s.light !== "" ? s.light : "（无）"}
+光效：${lightZh(s.light) !== "" ? lightZh(s.light) : "（无）"}
 承接：${s.prevState} → ${s.nextState}`;
 	}).join("\n\n");
 	const raw = parseJsonObject(await complete(ctx, config, {
@@ -3970,7 +4299,7 @@ async function generateStoryboardPrompts(ctx, config, project, outputDir, chapte
 			"只输出 JSON 对象。"
 		].filter((x) => x !== "").join("\n\n"),
 		temperature: .3,
-		maxTokens: Math.max(config.maxTokens, 6e3),
+		maxTokens: Math.max(config.maxTokens, 16e3),
 		reasoning: config.analysisReasoning ?? "low"
 	}));
 	const shotIds = new Set(table.shots.map((s) => s.id));
@@ -4005,7 +4334,9 @@ async function generateStoryboardSkeleton(ctx, config, project, outputDir, chapt
 		system: [
 			"你是一位从业 15 年的电影编剧，专长网文改编影视化，深谙三幕结构与节拍（beat）写作。",
 			"任务：把这一章改编成影视化「剧情骨架」——只做故事层，不做画面。",
-			"输出合法 JSON 对象：{\"arc\": \"本章弧线一句话（起承转合，20-60字）\", \"beats\": [{\"event\": \"事件一句话（发生了什么）\", \"emotion\": \"人物情绪走向（如 压抑→隐忍→惊惧）\", \"function\": \"铺垫|冲突|转折|高潮|收束|伏笔|人物塑造\", \"cause\": \"承接上一节拍的原因（可省略）\"}], \"characters\": [\"出镜角色名1\", \"出镜角色名2\"]}",
+			"输出合法 JSON 对象：{\"arc\": \"本章弧线一句话（起承转合，20-60字）\", \"beats\": [{\"event\": \"事件一句话（发生了什么）\", \"emotion\": \"人物情绪走向（情绪词数组）\", \"function\": \"铺垫|冲突|转折|高潮|收束|伏笔|人物塑造\", \"cause\": \"承接上一节拍的原因（可省略）\"}], \"characters\": [\"出镜角色名1\", \"出镜角色名2\"]}",
+			"情绪词取值（从这些词中选 1-3 个，用数组输出，按情绪发展顺序）：平静/淡然/期待/好奇/警觉/压抑/隐忍/担忧/焦躁/不安/惊惧/愤怒/崩溃/决绝/痛心/释然/悲凉/得意/重生/麻木。",
+			"功能取值（只能从这些词中选一）：铺垫/冲突/转折/高潮/收束/伏笔/人物塑造。",
 			"硬性要求：",
 			"1. beats 数量 4-9 个，严格按时间顺序，因果链完整：前一个 beat 的结果是后一个 beat 的原因。",
 			"2. 必须覆盖本章全部剧情要点与正文关键事件，遗漏关键事件视为失败。",
@@ -4025,20 +4356,11 @@ async function generateStoryboardSkeleton(ctx, config, project, outputDir, chapt
 		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 : "铺垫",
+		emotion: Array.isArray(entry.emotion) ? normalizeEmotions(entry.emotion.filter((x) => typeof x === "string").join("→")) : normalizeEmotions(typeof entry.emotion === "string" ? entry.emotion : void 0),
+		function: normalizeStoryFunction(typeof entry.function === "string" ? entry.function : void 0),
 		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("模型未输出有效节拍链，请重试");
@@ -4100,6 +4422,209 @@ async function reverseOutlineFromChapters(ctx, config, project, outputDir, onPro
 	return outline.trim();
 }
 /**
+* 改编模式 P0：全文分析 → 原文设定卡片 / 可改范围矩阵。
+* 拆章统计 + 取样正文，让 LLM 一次输出结构化 JSON：
+* { bookName, outline, dimensions: [{key,title,mutability,current,evidence,candidates,impact,risk}] }。
+*/
+async function analyzeAdaptation(ctx, config, text) {
+	const chapters = splitBookText(text).filter((c) => c.body.length >= 50);
+	if (chapters.length === 0) throw new Error("未能从全文拆出章节（内容过短或无章节结构）");
+	const sampleBodies = [];
+	const n = chapters.length;
+	const pick = (i) => {
+		const c = chapters[i];
+		if (c !== void 0) sampleBodies.push("第" + c.no + "章《" + (c.title || "无题") + "》\n" + c.body.slice(0, 1200));
+	};
+	pick(0);
+	if (n > 3) {
+		pick(Math.floor(n / 3));
+		pick(Math.floor(2 * n / 3));
+	}
+	if (n > 1) pick(n - 1);
+	const raw = parseJsonObject(await complete(ctx, config, {
+		system: "你是改编策划分析助手。",
+		user: [
+			"你是一位资深网文编辑兼改编策划。下面给你一部已完结/连载小说的若干章正文节选。请通读并输出该书的「原文设定卡片」与「可改范围矩阵」。",
+			"输出合法 JSON 对象：",
+			"{\"bookName\": \"书名\", \"outline\": \"一句话主线梗概（100字内）\", \"dimensions\": [{\"key\":\"realm\",\"title\":\"大世界\",\"mutability\":\"big|small|free|locked|visual\",\"current\":\"当前值\",\"evidence\":\"证据（出现章节/频次）\",\"candidates\":[\"候选1\",\"候选2\"],\"impact\":\"改了会影响什么\",\"risk\":\"high|medium|low\"}]}",
+			"dimensions 至少覆盖以下维度（key/title）：realm 大世界、cultivation 修为体系、protagonist 主角、goldenFinger 金手指、supporting 配角与势力人物名、faction 势力/组织、style 文风与叙事、ending 结局走向、timeline 时间线/编年、foreshadow 伏笔/暗线。",
+			"mutability 取值：locked=建议保留、big=可改影响大、small=可改影响小、free=可自由改、visual=仅视觉包装。",
+			"每个 dimension.current 必须忠于文本，能引用原文就用原文（尤其角色名/境界名/势力名/金手指名）。",
+			"重要：所有字符串值内部不得包含换行符；JSON 必须在一段内完整结束；直接输出 JSON，不要 Markdown 代码块。"
+		].join("\n") + "\n\n" + sampleBodies.join("\n\n---\n\n"),
+		temperature: .3,
+		maxTokens: Math.max(config.maxTokens, 6e3),
+		reasoning: config.analysisReasoning ?? "low"
+	}));
+	const bookName = typeof raw.bookName === "string" ? raw.bookName.trim() : "未命名";
+	const dims = Array.isArray(raw.dimensions) ? raw.dimensions.filter((d) => typeof d === "object" && d !== null).map((d) => normalizeAdaptationDimension(d)).filter((d) => d !== null) : [];
+	let outline;
+	try {
+		outline = await reverseOutlineFromAdaptationText(ctx, config, chapters);
+	} catch {
+		outline = typeof raw.outline === "string" && raw.outline.trim() !== "" ? raw.outline.trim() : void 0;
+	}
+	return {
+		bookName,
+		chapters: chapters.length,
+		outline,
+		dimensions: dims,
+		note: "基于节选分析（首/中/末取样）+ 反推大纲。如需逐章全文级深度分析请后续启用全文流式入口。"
+	};
+}
+/** 校验并归一化一行的改编维度数据（来自 LLM）。 */
+function normalizeAdaptationDimension(d) {
+	const key = typeof d.key === "string" ? d.key : "";
+	const title = typeof d.title === "string" ? d.title : "";
+	if (key === "" || title === "") return null;
+	const mutability = [
+		"locked",
+		"big",
+		"small",
+		"free",
+		"visual"
+	].includes(d.mutability) ? d.mutability : "small";
+	const risk = [
+		"high",
+		"medium",
+		"low"
+	].includes(d.risk) ? d.risk : "medium";
+	return {
+		key,
+		title,
+		mutability,
+		current: typeof d.current === "string" ? d.current : "",
+		evidence: typeof d.evidence === "string" ? d.evidence : void 0,
+		candidates: Array.isArray(d.candidates) ? d.candidates.filter((x) => typeof x === "string") : [],
+		impact: typeof d.impact === "string" ? d.impact : "",
+		risk
+	};
+}
+/** 从全文拆出的章节节选反推全书总纲（Markdown），用于改编 P0 的「反推大纲」。 */
+async function reverseOutlineFromAdaptationText(ctx, config, chapters) {
+	const n = chapters.length;
+	const sample = [];
+	const count = Math.min(n, 20);
+	for (let i = 0; i < count; i++) {
+		const c = chapters[Math.floor(i * n / count)];
+		if (c === void 0) continue;
+		sample.push("第" + c.no + "章《" + (c.title || "无题") + "》\n" + c.body.slice(0, 600));
+	}
+	return (await complete(ctx, config, {
+		system: [
+			"你是一位经验丰富的小说主编。根据下面若干章节的正文节选，反推出这本书的总纲（可作为后续改编与章节续写的骨架）。",
+			"要求：",
+			"1. 第一行写《书名》（可从正文推断，否则《未命名》）。",
+			"2. 按故事弧线划分卷/部分：每卷给卷名与主旨（标注覆盖章节范围）。",
+			"3. 对每章列出：章节号 + 标题 + 一句话核心情节。",
+			"4. 最后给出：全书主线、主要人物弧线、已埋设待回收的伏笔清单。",
+			"5. 输出纯文本 Markdown 结构（# 一级标题、## 二级标题、- 列表），不要寒暄，不要其他输出。"
+		].join("\n"),
+		user: sample.join("\n\n---\n\n"),
+		temperature: .4,
+		maxTokens: Math.max(config.maxTokens, 6e3),
+		reasoning: config.analysisReasoning ?? "low"
+	})).trim();
+}
+/** 改编方案：由用户勾选的维度与新值，生成 LLM 映射表/规则/影响清单。 */
+async function proposeAdaptation(ctx, config, text, selections, dimensions) {
+	const raw = parseJsonObject(await complete(ctx, config, {
+		system: "你是改编策划。",
+		user: [
+			"下面给出改编决策：用户想改哪些维度、改成什么值。请生成一份可执行的「改编方案」。",
+			"要求输出合法 JSON 对象：",
+			"{\"mappings\": [{\"source\":\"原值\",\"target\":\"新值\",\"scope\":\"name|realm|faction|term|other\",\"note\":\"说明\"}], \"rules\": {\"preserve\":[\"必须保留的要素\"],\"change\":[\"允许改变的要素\"],\"constraints\":[\"改编红线/一致性要求\"]}, \"impacts\": [{\"item\":\"受影响项\",\"detail\":\"说明\",\"risk\":\"high|medium|low\",\"chapters\":[章号]}]}",
+			"mappings 需把用户确认的新值展开为「原→新」条目（如主角名/境界名/势力名/术语），并补充用户未填但关联的必改项（如改了修为体系名，相关的境界名一并列映射）。",
+			"rules.preserve 至少包含：故事骨架、人物动机、伏笔逻辑、爽点结构。",
+			"impacts 列出每个改动会影响的内容（术语/角色/章节/伏笔），能定位章号尽量定位；无法定位则给章节区间提示。",
+			"重要：所有字符串值内部不得包含换行符；JSON 必须在一段内完整结束；直接输出 JSON，不要 Markdown 代码块。",
+			"",
+			"用户要改：",
+			selections.map((s) => "- " + s.title + "（" + s.key + "）：" + s.current + " → " + s.target).join("\n"),
+			"",
+			"原文可改矩阵（已分析）：",
+			(dimensions ?? []).map((d) => "- " + d.title + "：" + d.current + "（可改度：" + d.mutability + "，风险：" + d.risk + "）").join("\n")
+		].join("\n"),
+		temperature: .3,
+		maxTokens: Math.max(config.maxTokens, 6e3),
+		reasoning: config.analysisReasoning ?? "low"
+	}));
+	return { proposal: {
+		mappings: Array.isArray(raw.mappings) ? raw.mappings.filter((m) => typeof m === "object" && m !== null).map((m) => normalizeAdaptationMapping(m)).filter((m) => m !== null) : [],
+		rules: normalizeAdaptationRules(raw.rules),
+		impacts: Array.isArray(raw.impacts) ? raw.impacts.filter((i) => typeof i === "object" && i !== null).map((i) => normalizeAdaptationImpact(i)) : []
+	} };
+}
+/** 剧本术语替换执行：按映射表做精确替换并统计命中。 */
+function applyAdaptationReplacements(text, mappings) {
+	const seen = /* @__PURE__ */ new Set();
+	const unique = mappings.filter((m) => {
+		const s = m.source.trim();
+		if (s === "" || s === m.target.trim()) return false;
+		if (seen.has(s)) return false;
+		seen.add(s);
+		return true;
+	}).sort((a, b) => b.source.length - a.source.length);
+	let adapted = text;
+	const hits = [];
+	for (const m of unique) {
+		const count = adapted.split(m.source).length - 1;
+		if (count > 0) adapted = adapted.split(m.source).join(m.target);
+		hits.push({
+			source: m.source,
+			target: m.target,
+			count
+		});
+	}
+	return {
+		adaptedText: adapted,
+		hits
+	};
+}
+/** 校验归一化一条映射（来自 LLM）。 */
+function normalizeAdaptationMapping(m) {
+	const source = typeof m.source === "string" ? m.source.trim() : "";
+	const target = typeof m.target === "string" ? m.target.trim() : "";
+	if (source === "" || target === "") return null;
+	return {
+		source,
+		target,
+		scope: [
+			"name",
+			"realm",
+			"faction",
+			"term",
+			"other"
+		].includes(m.scope) ? m.scope : "other",
+		note: typeof m.note === "string" ? m.note : void 0
+	};
+}
+/** 校验归一化改编规则（来自 LLM）。 */
+function normalizeAdaptationRules(r) {
+	const obj = typeof r === "object" && r !== null ? r : {};
+	const arr = (v) => Array.isArray(v) ? v.filter((x) => typeof x === "string") : [];
+	return {
+		preserve: arr(obj.preserve),
+		change: arr(obj.change),
+		constraints: arr(obj.constraints)
+	};
+}
+/** 校验归一化一条影响项（来自 LLM）。 */
+function normalizeAdaptationImpact(i) {
+	const risk = [
+		"high",
+		"medium",
+		"low"
+	].includes(i.risk) ? i.risk : "medium";
+	const chapters = Array.isArray(i.chapters) ? i.chapters.filter((x) => typeof x === "number") : void 0;
+	return {
+		item: typeof i.item === "string" ? i.item : "",
+		detail: typeof i.detail === "string" ? i.detail : "",
+		risk,
+		chapters: chapters !== void 0 && chapters.length > 0 ? chapters : void 0
+	};
+}
+/**
 * 摘要 + 事实抽取合并为一次 LLM 调用（省一次调用与一次正文输入，
 * 批量生成时整体开销约省 25%）。
 * @returns 摘要与新增事实条数（失败返回空，调用方 best-effort）。
@@ -5113,10 +5638,11 @@ var ProductionRunner = class {
 	}
 	applyDraft(project, chapter, draft, report) {
 		const config = this.deps.getConfig();
+		const outputDir = this.bookDir ?? config.outputDir;
 		const fileName = chapterFileName(chapter);
-		mkdirSync(config.outputDir, { recursive: true });
-		const targetPath = join(config.outputDir, fileName);
-		if (existsSync(targetPath)) copyFileSync(targetPath, join(config.outputDir, `${fileName.replace(/\.md$/, "")}.bak.md`));
+		mkdirSync(outputDir, { recursive: true });
+		const targetPath = join(outputDir, fileName);
+		if (existsSync(targetPath)) copyFileSync(targetPath, join(outputDir, `${fileName.replace(/\.md$/, "")}.bak.md`));
 		writeFileSync(targetPath, `# 第${chapter.no}章 ${chapter.title}\n\n${draft}\n`, "utf8");
 		chapter.pendingDraft = void 0;
 		chapter.chars = draft.length;
@@ -5130,17 +5656,11 @@ var ProductionRunner = class {
 		}
 		chapter.error = void 0;
 		project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-		saveProject(config.outputDir, project);
+		saveProject(outputDir, project);
 	}
 };
 //#endregion
 //#region src/protocol.ts
-/**
-* dsh-novel-forge — shared protocol between the host half (Node) and the
-* browser half (web GUI). Route paths, request/response shapes, the project
-* state file format, and the NDJSON generation stream frames all live here so
-* both halves spell exactly one vocabulary.
-*/
 /** The /api/dsh-novel-forge route family (same-origin, loopback-fenced). */
 const NOVEL_API = {
 	status: "/api/dsh-novel-forge/status",
@@ -5238,7 +5758,25 @@ const NOVEL_API = {
 	/** 生产单状态（含进度统计与日志）。 */
 	runStatus: "/api/dsh-novel-forge/run/status",
 	config: "/api/dsh-novel-forge/config",
-	openFolder: "/api/dsh-novel-forge/open-folder"
+	openFolder: "/api/dsh-novel-forge/open-folder",
+	/** 作者资产库/总数据：读取个人跨书资产（笔法/红线/套路/角色模板/世界观模板）。 */
+	authorAssets: "/api/dsh-novel-forge/author-assets",
+	/** 作者资产库：新增/更新一条资产（upsert by id）。 */
+	authorAssetsUpsert: "/api/dsh-novel-forge/author-assets/upsert",
+	/** 作者资产库：删除一条资产。 */
+	authorAssetsRemove: "/api/dsh-novel-forge/author-assets/remove",
+	/** 作者资产库：导入默认（书架书的写作资产/角色 + 内置全局库）批量沉淀。 */
+	authorAssetsImportDefault: "/api/dsh-novel-forge/author-assets/import-default",
+	/** 改编模式：上传全文 → 分析 → 原文设定卡片/可改范围矩阵。 */
+	adaptAnalyze: "/api/dsh-novel-forge/adapt/analyze",
+	/** 改编模式：确认要改的维度 → 生成映射表/改编规则/联动影响清单。 */
+	adaptPropose: "/api/dsh-novel-forge/adapt/propose",
+	/** 改编模式：执行术语替换（全局替换 + 命中统计 + 改编文本预览）。 */
+	adaptExecute: "/api/dsh-novel-forge/adapt/execute",
+	/** 主题自定义背景：上传图片（POST，存盘并返回服务端 URL）。 */
+	themeBackgroundUpload: "/api/dsh-novel-forge/theme/background",
+	/** 主题自定义背景：读取已上传文件（GET prefix，/theme/background/<name>）。 */
+	themeBackgroundGet: "/api/dsh-novel-forge/theme/background"
 };
 //#endregion
 //#region src/docx.ts
@@ -6030,6 +6568,169 @@ async function* runAssistantTurn(ctx, config, project, outputDir, userMessage) {
 	}
 }
 //#endregion
+//#region src/author-assets.ts
+/**
+* 作者资产库/总数据（跨书）— 按作者维度聚合的可复用资产。
+* 与书架同惯例持久化到 ~/.dsh/dsh-novel-forge-author-assets.json。
+* 提供读取/持久化/新增或更新/删除，以及「导入默认」：把书架书的写作资产/角色 + 
+* 内置全局库（题材/反AI规则/风格模板/推进模式）批量沉淀成资产条目（默认库）。
+*/
+/** 作者资产库配置文件路径。 */
+function authorAssetsFile() {
+	return join(homedir(), ".dsh", "dsh-novel-forge-author-assets.json");
+}
+/** 默认空资产库。 */
+function defaultLibrary() {
+	return {
+		version: 1,
+		items: []
+	};
+}
+/** 读取作者资产库（不存在/损坏则返回空库，不抛错）。 */
+function loadAuthorAssets() {
+	const file = authorAssetsFile();
+	if (!existsSync(file)) return defaultLibrary();
+	try {
+		let raw = readFileSync(file, "utf8");
+		if (raw.charCodeAt(0) === 65279) raw = raw.slice(1);
+		const parsed = JSON.parse(raw);
+		if (!Array.isArray(parsed.items)) return defaultLibrary();
+		return {
+			version: 1,
+			items: parsed.items
+		};
+	} catch {
+		return defaultLibrary();
+	}
+}
+/** 持久化作者资产库。 */
+function saveAuthorAssets(library) {
+	const file = authorAssetsFile();
+	mkdirSync(join(homedir(), ".dsh"), { recursive: true });
+	writeFileSync(file, JSON.stringify(library, null, 2), "utf8");
+}
+/** 按 id 更新一条资产；不存在则追加。 */
+function upsertAuthorAsset(input) {
+	const library = loadAuthorAssets();
+	const idx = library.items.findIndex((a) => a.id === input.id);
+	const now = (/* @__PURE__ */ new Date()).toISOString();
+	if (idx >= 0) {
+		const prev = library.items[idx];
+		if (prev !== void 0) library.items[idx] = {
+			...prev,
+			...input,
+			id: prev.id,
+			createdAt: prev.createdAt,
+			updatedAt: now
+		};
+	} else library.items.push({
+		...input,
+		createdAt: input.createdAt !== "" ? input.createdAt : now,
+		updatedAt: now
+	});
+	saveAuthorAssets(library);
+	return library;
+}
+/** 删除一条资产；返回更新后的资产库。 */
+function removeAuthorAsset(id) {
+	const library = loadAuthorAssets();
+	library.items = library.items.filter((a) => a.id !== id);
+	saveAuthorAssets(library);
+	return library;
+}
+/**
+* 导入默认：把书架所有书的写作资产/角色 + 内置全局库批量沉淀到作者资产库。
+* 按 `kind:name` 去重（已存在则跳过），不覆盖用户已有条目。
+* @returns 更新后的资产库。
+*/
+function importDefaultAuthorAssets() {
+	const library = loadAuthorAssets();
+	const seen = new Set(library.items.map((a) => a.kind + ":" + a.name));
+	const now = (/* @__PURE__ */ new Date()).toISOString();
+	const push = (kind, name, summary, content, tags, sourceBooks, structured) => {
+		const key = kind + ":" + name.trim();
+		if (name.trim() === "" || seen.has(key)) return;
+		seen.add(key);
+		library.items.push({
+			id: "aa-" + Date.now().toString(36) + "-" + randomBytes(3).toString("hex"),
+			kind,
+			name: name.trim(),
+			summary: summary.trim(),
+			content: content.trim(),
+			sourceBooks,
+			tags,
+			structured,
+			createdAt: now,
+			updatedAt: now
+		});
+	};
+	for (const g of flattenGenres(BUILTIN_GENRE_LIBRARY)) push("genre", g.name, g.description, g.description, ["内置", "题材"], [], {
+		description: g.description,
+		children: (g.children ?? []).map((c) => c.name)
+	});
+	for (const r of BUILTIN_ANTI_AI_RULES) push("antiAi", r.name, r.avoid, "避免：" + r.avoid + "\n修正：" + r.fix, ["内置", "反AI"], [], {
+		avoid: r.avoid,
+		fix: r.fix,
+		detectPatterns: r.detectPatterns
+	});
+	for (const t of BUILTIN_STYLE_TEMPLATES) push("style", t.name, t.description, "分类：" + t.category + "\n适用：" + t.applicableGenres.join("、") + "\n叙述：" + t.proseRules.join("；") + "\n台词：" + t.dialogueRules.join("；") + "\n语言：" + t.languageRules.join("；") + "\n节奏：" + t.rhythmRules.join("；"), ["内置", "风格模板"], [], {
+		category: t.category,
+		applicableGenres: t.applicableGenres
+	});
+	for (const p of BUILTIN_PROGRESSION_MODES) push("progression", p.name, p.driver, "驱动：" + p.driver + "\n期待：" + p.readerExpectation + "\n兑现：" + p.payoffs.join("；") + "\n风险：" + p.risks.join("；"), ["内置", "推进"], [], {
+		driver: p.driver,
+		primary: p.primary
+	});
+	const shelf = loadBookshelf();
+	for (const book of shelf.books) {
+		const project = loadProject(book.outputDir);
+		if (project === void 0) continue;
+		const src = [project.bookName];
+		const assets = project.assets;
+		if (assets !== void 0) {
+			if (assets.genre !== void 0) push("genre", assets.genre.name, assets.genre.description, assets.genre.description, ["书", "题材"], src, { description: assets.genre.description });
+			if (assets.primaryProgression !== void 0) push("progression", assets.primaryProgression.name, assets.primaryProgression.driver, "驱动：" + assets.primaryProgression.driver + "\n期待：" + assets.primaryProgression.readerExpectation, src, [], {
+				driver: assets.primaryProgression.driver,
+				primary: true
+			});
+			for (const p of assets.auxiliaryProgressions ?? []) push("progression", p.name, p.driver, "驱动：" + p.driver + "\n期待：" + p.readerExpectation, src, [], {
+				driver: p.driver,
+				primary: false
+			});
+			for (const r of assets.antiAiRules ?? []) push("antiAi", r.name, r.avoid, "避免：" + r.avoid + "\n修正：" + r.fix, src, [], {
+				avoid: r.avoid,
+				fix: r.fix,
+				detectPatterns: r.detectPatterns
+			});
+			for (const s of assets.styleAssets ?? []) push("style", s.name, s.proseRules.join("；"), "叙述：" + s.proseRules.join("；") + "\n台词：" + s.dialogueRules.join("；") + "\n描写：" + s.descriptionRules.join("；") + "\n边界：" + s.boundaries.join("；"), src, [], { sourceText: s.sourceText });
+		}
+		for (const role of project.roles ?? []) {
+			const persona = ("身份：" + role.identity + "\n性格：" + role.traits.join("、") + "\n目标：" + role.goals + "\n关系：" + role.relations.join("、") + "\n成长线：" + (role.arc.length > 0 ? role.arc.join(" > ") : "—") + "\n知情度：" + role.knowledge.join("、")).trim();
+			push("roleTemplate", role.name, role.identity, persona, src, [], {
+				roleLabel: role.roleLabel,
+				traits: role.traits,
+				relations: role.relations,
+				arc: role.arc,
+				knowledge: role.knowledge
+			});
+		}
+	}
+	saveAuthorAssets(library);
+	return library;
+}
+/** 拍平题材库（含子题材，父级名称并入 tag）。 */
+function flattenGenres(nodes, parentName) {
+	const out = [];
+	for (const n of nodes) {
+		out.push({
+			...n,
+			name: parentName !== void 0 ? parentName + "/" + n.name : n.name
+		});
+		if (n.children.length > 0) out.push(...flattenGenres(n.children, parentName !== void 0 ? parentName + "/" + n.name : n.name));
+	}
+	return out;
+}
+//#endregion
 //#region src/routes.ts
 /** Cap on JSON request bodies (generous: cover images travel as base64). */
 const MAX_JSON_BODY_BYTES = 64 * 1024 * 1024;
@@ -8083,12 +8784,24 @@ function makeRoutes(deps) {
 		handler: async (req, res) => {
 			if (!guard(req, res, "POST")) return;
 			const dir = getConfig().outputDir;
-			exec(`explorer "${dir.replace(/"/g, "")}"`, (error) => {
-				if (error) writeJson(res, 500, {
+			const child = spawn("explorer", [dir], { shell: false });
+			let responded = false;
+			child.on("error", (error) => {
+				if (responded) return;
+				responded = true;
+				writeJson(res, 500, {
 					ok: false,
 					error: error.message
 				});
-				else writeJson(res, 200, { ok: true });
+			});
+			child.on("exit", (code) => {
+				if (responded) return;
+				responded = true;
+				if (code === 0) writeJson(res, 200, { ok: true });
+				else writeJson(res, 500, {
+					ok: false,
+					error: `explorer 退出码 ${code}`
+				});
 			});
 		}
 	};
@@ -8454,6 +9167,191 @@ function makeRoutes(deps) {
 		ctx,
 		getConfig
 	});
+	const runStartRoute = {
+		kind: "exact",
+		path: NOVEL_API.runStart,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const body = await readJsonBody(req);
+			const project = loadProject(getConfig().outputDir);
+			if (project === void 0) {
+				writeJson(res, 400, { error: "输出目录中没有项目" });
+				return;
+			}
+			const startNo = Number.isInteger(body?.startNo) && body.startNo >= 1 ? body.startNo : 1;
+			let endNo;
+			if (Number.isInteger(body?.endNo) && body.endNo >= startNo) endNo = body.endNo;
+			else if (Number.isInteger(body?.count) && body.count >= 1 && body.count <= 200) endNo = Math.max(0, ...project.chapters.map((c) => c.no)) + body.count;
+			else {
+				writeJson(res, 400, { error: "请提供 endNo 或 count（1-200）" });
+				return;
+			}
+			try {
+				writeJson(res, 200, await runner.start(startNo, endNo));
+			} catch (error) {
+				writeJson(res, 409, { error: error.message });
+			}
+		}
+	};
+	const runControlRoute = {
+		kind: "exact",
+		path: NOVEL_API.runControl,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const body = await readJsonBody(req);
+			if (runner.status() === null) {
+				writeJson(res, 400, { error: "没有生产单" });
+				return;
+			}
+			if (body?.action === "pause") runner.pause();
+			else if (body?.action === "resume") runner.resume();
+			else if (body?.action === "stop") runner.stop();
+			else {
+				writeJson(res, 400, { error: "action 须为 pause / resume / stop" });
+				return;
+			}
+			writeJson(res, 200, runner.status());
+		}
+	};
+	const runStatusRoute = {
+		kind: "exact",
+		path: NOVEL_API.runStatus,
+		handler: (req, res) => {
+			if (!guard(req, res, "GET")) return;
+			writeJson(res, 200, runner.status());
+		}
+	};
+	const authorAssetsRoute = {
+		kind: "exact",
+		path: NOVEL_API.authorAssets,
+		handler: (req, res) => {
+			if (!guard(req, res, "GET")) return;
+			writeJson(res, 200, { assets: loadAuthorAssets() });
+		}
+	};
+	const authorAssetsUpsertRoute = {
+		kind: "exact",
+		path: NOVEL_API.authorAssetsUpsert,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const asset = (await readJsonBody(req))?.asset;
+			if (asset === void 0 || asset.name.trim() === "" || asset.content.trim() === "") {
+				writeJson(res, 400, { error: "asset 须含 name / content" });
+				return;
+			}
+			writeJson(res, 200, { assets: upsertAuthorAsset(asset) });
+		}
+	};
+	const authorAssetsRemoveRoute = {
+		kind: "exact",
+		path: NOVEL_API.authorAssetsRemove,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const id = (await readJsonBody(req))?.id ?? "";
+			if (id === "") {
+				writeJson(res, 400, { error: "id 必填" });
+				return;
+			}
+			writeJson(res, 200, { assets: removeAuthorAsset(id) });
+		}
+	};
+	const authorAssetsImportDefaultRoute = {
+		kind: "exact",
+		path: NOVEL_API.authorAssetsImportDefault,
+		handler: (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			writeJson(res, 200, { assets: importDefaultAuthorAssets() });
+		}
+	};
+	const adaptAnalyzeRoute = {
+		kind: "exact",
+		path: NOVEL_API.adaptAnalyze,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			if (!getConfig().enableAdaptMode) {
+				writeJson(res, 404, { error: "改编模式未开启" });
+				return;
+			}
+			const body = await readJsonBody(req);
+			const config = getConfig();
+			let text = body?.text?.trim() ?? "";
+			if (text === "" && body?.filePath !== void 0 && body.filePath !== "") try {
+				text = readFileSync(body.filePath, "utf8");
+			} catch (err) {
+				writeJson(res, 400, { error: "读取文件失败：" + err.message });
+				return;
+			}
+			if (text.length < 200) {
+				writeJson(res, 400, { error: "全文内容过短（<200 字符），请上传完整小说文本" });
+				return;
+			}
+			try {
+				writeJson(res, 200, await analyzeAdaptation(ctx, config, text));
+			} catch (err) {
+				writeJson(res, 400, { error: err.message });
+			}
+		}
+	};
+	const adaptProposeRoute = {
+		kind: "exact",
+		path: NOVEL_API.adaptPropose,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			if (!getConfig().enableAdaptMode) {
+				writeJson(res, 404, { error: "改编模式未开启" });
+				return;
+			}
+			const body = await readJsonBody(req);
+			const config = getConfig();
+			const text = (body?.text ?? "").trim();
+			const selections = body?.selections ?? [];
+			if (text.length < 200 || selections.length === 0) {
+				writeJson(res, 400, { error: "请提供全文与至少一条要改的维度" });
+				return;
+			}
+			try {
+				writeJson(res, 200, await proposeAdaptation(ctx, config, text, selections, body?.dimensions));
+			} catch (err) {
+				writeJson(res, 400, { error: err.message });
+			}
+		}
+	};
+	const adaptExecuteRoute = {
+		kind: "exact",
+		path: NOVEL_API.adaptExecute,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			if (!getConfig().enableAdaptMode) {
+				writeJson(res, 404, { error: "改编模式未开启" });
+				return;
+			}
+			const body = await readJsonBody(req);
+			const text = body?.text ?? "";
+			const mappings = body?.mappings ?? [];
+			if (text.length < 200 || mappings.length === 0) {
+				writeJson(res, 400, { error: "请提供全文与映射表" });
+				return;
+			}
+			if (body?.mode === "rewrite") {
+				writeJson(res, 400, { error: "rewrite 模式尚未实现，请使用 replace（术语替换）" });
+				return;
+			}
+			const { adaptedText, hits } = applyAdaptationReplacements(text, mappings);
+			writeJson(res, 200, {
+				adaptedText,
+				mappings: mappings.length,
+				hits
+			});
+		}
+	};
+	const THEME_BG_DIR = join(homedir(), ".dsh", "dsh-novel-forge-assets");
+	const MIME_BY_EXT = {
+		png: "image/png",
+		jpg: "image/jpeg",
+		jpeg: "image/jpeg",
+		webp: "image/webp",
+		gif: "image/gif"
+	};
 	return [
 		statusRoute,
 		loadOutlineRoute,
@@ -8513,58 +9411,65 @@ function makeRoutes(deps) {
 		storyboardTableRoute,
 		storyboardPromptsRoute,
 		breakdownRoute,
+		runStartRoute,
+		runControlRoute,
+		runStatusRoute,
+		authorAssetsRoute,
+		authorAssetsUpsertRoute,
+		authorAssetsRemoveRoute,
+		authorAssetsImportDefaultRoute,
+		adaptAnalyzeRoute,
+		adaptProposeRoute,
+		adaptExecuteRoute,
 		{
 			kind: "exact",
-			path: NOVEL_API.runStart,
+			path: NOVEL_API.themeBackgroundUpload,
 			handler: async (req, res) => {
 				if (!guard(req, res, "POST")) return;
-				const body = await readJsonBody(req);
-				const project = loadProject(getConfig().outputDir);
-				if (project === void 0) {
-					writeJson(res, 400, { error: "输出目录中没有项目" });
+				const dataUrl = (await readJsonBody(req))?.dataUrl ?? "";
+				const m = /^data:image\/(png|jpeg|jpg|webp|gif);base64,(.+)$/i.exec(dataUrl);
+				if (m === null) {
+					writeJson(res, 400, { error: "仅支持 PNG/JPG/WebP/GIF 图片" });
 					return;
 				}
-				const startNo = Number.isInteger(body?.startNo) && body.startNo >= 1 ? body.startNo : 1;
-				let endNo;
-				if (Number.isInteger(body?.endNo) && body.endNo >= startNo) endNo = body.endNo;
-				else if (Number.isInteger(body?.count) && body.count >= 1 && body.count <= 200) endNo = Math.max(0, ...project.chapters.map((c) => c.no)) + body.count;
-				else {
-					writeJson(res, 400, { error: "请提供 endNo 或 count（1-200）" });
+				const ext = m[1].toLowerCase() === "jpg" ? "jpeg" : m[1].toLowerCase();
+				const buf = Buffer.from(m[2], "base64");
+				if (buf.length === 0) {
+					writeJson(res, 400, { error: "图片数据为空" });
 					return;
 				}
-				try {
-					writeJson(res, 200, await runner.start(startNo, endNo));
-				} catch (error) {
-					writeJson(res, 409, { error: error.message });
-				}
+				mkdirSync(THEME_BG_DIR, { recursive: true });
+				const name = "theme-bg-" + Date.now().toString(36) + "-" + randomBytes(3).toString("hex") + "." + ext;
+				writeFileSync(join(THEME_BG_DIR, name), buf);
+				writeJson(res, 200, { url: NOVEL_API.themeBackgroundGet + "/" + name });
 			}
 		},
 		{
-			kind: "exact",
-			path: NOVEL_API.runControl,
-			handler: async (req, res) => {
-				if (!guard(req, res, "POST")) return;
-				const body = await readJsonBody(req);
-				if (runner.status() === null) {
-					writeJson(res, 400, { error: "没有生产单" });
+			kind: "prefix",
+			path: NOVEL_API.themeBackgroundGet,
+			handler: (req, res) => {
+				if (!guard(req, res, "GET")) return;
+				let pathName = "";
+				try {
+					pathName = new URL(req.url ?? "", "http://localhost").pathname;
+				} catch {}
+				const name = basename(pathName);
+				if (!name.startsWith("theme-bg-")) {
+					writeJson(res, 404, { error: "not found" });
 					return;
 				}
-				if (body?.action === "pause") runner.pause();
-				else if (body?.action === "resume") runner.resume();
-				else if (body?.action === "stop") runner.stop();
-				else {
-					writeJson(res, 400, { error: "action 须为 pause / resume / stop" });
+				const file = join(THEME_BG_DIR, name);
+				if (!existsSync(file)) {
+					writeJson(res, 404, { error: "not found" });
 					return;
 				}
-				writeJson(res, 200, runner.status());
-			}
-		},
-		{
-			kind: "exact",
-			path: NOVEL_API.runStatus,
-			handler: (req, res) => {
-				if (!guard(req, res, "GET")) return;
-				writeJson(res, 200, runner.status());
+				const ext = extname(file).slice(1);
+				const type = MIME_BY_EXT[ext] ?? "application/octet-stream";
+				res.writeHead(200, {
+					"content-type": type,
+					"cache-control": "public, max-age=31536000"
+				});
+				res.end(readFileSync(file));
 			}
 		}
 	];
@@ -8628,7 +9533,11 @@ const Config = z.object({
 	})).default([]),
 	imageApiKey: z.string().default(""),
 	imageApiModel: z.string().default(""),
-	imageApiEnabled: z.boolean().default(false)
+	imageApiEnabled: z.boolean().default(false),
+	themeBackground: z.string().default(""),
+	themeBackgroundBlur: z.number().default(0),
+	themeOpacity: z.number().default(100),
+	enableAdaptMode: z.boolean().default(false)
 });
 /** Schema defaults, re-read for hand-built test contexts. */
 const DEFAULT_ANNOUNCE = true;
@@ -8681,7 +9590,11 @@ function resolveConfig(value) {
 		imageApiModel: (() => {
 			return ((value?.imageModels ?? []).find((m) => m.enabled) ?? (value?.imageModels ?? [])[0])?.model ?? value?.imageApiModel;
 		})(),
-		imageApiEnabled: value?.imageApiEnabled ?? false
+		imageApiEnabled: value?.imageApiEnabled ?? false,
+		themeBackground: value?.themeBackground ?? "",
+		themeBackgroundBlur: value?.themeBackgroundBlur ?? 0,
+		themeOpacity: value?.themeOpacity ?? 100,
+		enableAdaptMode: value?.enableAdaptMode ?? false
 	};
 }
 /** 生图默认接口地址（豆包 ark，OpenAI 兼容）。 */
@@ -8719,6 +9632,11 @@ function apply(ctx, config) {
 		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;
+		if (patch.themeBackground !== void 0) next.themeBackground = patch.themeBackground;
+		if (patch.themeBackgroundBlur !== void 0) next.themeBackgroundBlur = patch.themeBackgroundBlur;
+		if (patch.themeOpacity !== void 0) next.themeOpacity = patch.themeOpacity;
+		if (patch.enableAdaptMode !== void 0) next.enableAdaptMode = patch.enableAdaptMode;
+		if (patch.imageModels !== void 0) next.imageModels = patch.imageModels;
 		const settings = ctx.get("settings");
 		if (settings !== void 0) await settings.update(NOVEL_SETTINGS_NAMESPACE, next);
 		else current = () => ({