@waterwx/dsh-novel-forge 1.7.2 → 1.7.3

package/lib/index.js

@@ -2,7 +2,7 @@ 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 { fileURLToPath } from "node:url";
 import { BlockAssembler, ReasoningEffortId, createAssistantMessage, createUserMessage } from "@deepseek-ai/dsh-llm";
@@ -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("模型未输出有效节拍链，请重试");
@@ -5113,10 +5435,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 +5453,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",
@@ -8083,12 +8400,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}`
+				});
 			});
 		}
 	};
@@ -8719,6 +9048,7 @@ 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.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 = () => ({