@waterwx/dsh-novel-forge 1.3.3 → 1.4.1

package/lib/index.js

@@ -1,5 +1,5 @@
 import { homedir } from "node:os";
-import { join } from "node:path";
+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";
@@ -690,6 +690,25 @@ const COMPLIANCE_REDLINES = [
 ];
 /** Project state file name inside the output dir. */
 const PROJECT_FILE = "novel-project.json";
+/** 智能解码文本文件：UTF-8 BOM / UTF-16 BOM / UTF-8（严格校验）/ GB18030 回退。 */
+function decodeTextSmart(buf) {
+	if (buf.length >= 3 && buf[0] === 239 && buf[1] === 187 && buf[2] === 191) return buf.subarray(3).toString("utf8");
+	if (buf.length >= 2 && buf[0] === 255 && buf[1] === 254) return buf.subarray(2).toString("utf16le");
+	const utf8 = buf.toString("utf8");
+	const bad = countReplacementChars(utf8);
+	if (bad === 0) return utf8;
+	try {
+		const gbk = new TextDecoder("gb18030").decode(buf);
+		if (countReplacementChars(gbk) < bad) return gbk;
+	} catch {}
+	return utf8;
+}
+/** 统计替换字符 U+FFFD 数量（UTF-8 乱码检测）。 */
+function countReplacementChars(s) {
+	let n = 0;
+	for (let i = 0; i < s.length; i++) if (s.charCodeAt(i) === 65533) n++;
+	return n;
+}
 /** Sanitize a file name: keep CJK/alphanumerics/space/dash/underscore. */
 function safeFileName(name) {
 	return name.replace(/[\\/:*?"<>|]/g, "").replace(/\s+/g, " ").trim().slice(0, 60);
@@ -1167,7 +1186,7 @@ async function complete(ctx, config, options) {
 		system: options.system,
 		maxTokens: options.maxTokens ?? config.maxTokens,
 		temperature: options.temperature ?? .7,
-		reasoningEffort: ReasoningEffortId(config.reasoningEffort ?? "off")
+		reasoningEffort: ReasoningEffortId(options.reasoning ?? config.reasoningEffort ?? "off")
 	};
 	const assembler = new BlockAssembler();
 	for await (const chunk of ctx.llm.stream(request)) assembler.push(chunk);
@@ -1293,7 +1312,8 @@ async function extractBible(ctx, config, outline, project) {
 		system: bibleSystemPrompt(),
 		user,
 		temperature: .4,
-		maxTokens: Math.max(config.maxTokens, 16e3)
+		maxTokens: Math.max(config.maxTokens, 16e3),
+		reasoning: config.analysisReasoning ?? "low"
 	}));
 	const strArray = (value) => Array.isArray(value) ? value.filter((v) => typeof v === "string" && v.trim() !== "") : [];
 	const characters = Array.isArray(raw.characters) ? raw.characters.filter((v) => typeof v === "object" && v !== null).map((entry) => ({
@@ -1756,7 +1776,8 @@ async function suggestPlotlines(ctx, config, project) {
 			"只输出 JSON 数组。"
 		].join("\n\n"),
 		temperature: .6,
-		maxTokens: Math.max(config.maxTokens, 4e3)
+		maxTokens: Math.max(config.maxTokens, 4e3),
+		reasoning: config.analysisReasoning ?? "low"
 	}));
 	const lines = [];
 	const kinds = /* @__PURE__ */ new Set([
@@ -1803,7 +1824,8 @@ async function refreshPlotlineProgress(ctx, config, project, line) {
 			"只输出 JSON 对象。"
 		].join("\n\n"),
 		temperature: .3,
-		maxTokens: Math.max(config.maxTokens, 2e3)
+		maxTokens: Math.max(config.maxTokens, 2e3),
+		reasoning: config.analysisReasoning ?? "low"
 	}));
 	return typeof raw.progress === "string" ? raw.progress.trim().slice(0, 300) : "";
 }
@@ -1813,6 +1835,8 @@ async function extractRoles(ctx, config, project) {
 		"你是一位网文角色库管理员。请根据本书的大纲、设定、编年录与章节摘要，提炼完整的角色库。",
 		"覆盖原则：所有在编年录/章节中实际出场或有名有姓的角色都应收录；无名的功能性人物（如\"矮胖姑娘\"）用其身份简称收录并标注。",
 		"数量控制：最多输出 10 个角色，宁缺毋滥；路人级一次带过的不要收录。",
+		"重要：正文中若有明确的主角与主要反派，必须分别以 protagonist / antagonist 收录，禁止遗漏；反派确实未出场时才可省略。",
+		"输出优先级：主角（protagonist）与主要反派（antagonist）必须优先输出并完整刻画，其次女主/重要配角；判断不出名字时用正文中的身份称呼。",
 		"每个角色输出：",
 		"1. name：角色名（或身份简称）。主角/有名配角必须用正文中实际出现的人名（如「沈放」），禁止用「主角（38岁超市理货员）」这类把身份塞进名字的占位名；正文确实没点名时才可用身份简称（如「富商」「灰衣老人」）。",
 		"2. roleLabel：定位——protagonist=主角；female_lead=女主（唯一知己/感情线核心，无后宫前提下只此一位）；female_support=重要女配；support=普通配角；antagonist=反派；extra=路人/背景。",
@@ -1830,28 +1854,50 @@ async function extractRoles(ctx, config, project) {
 	].join("\n");
 	const written = project.chapters.filter((c) => c.status !== "pending" && c.status !== "generating");
 	const existingRoles = project.roles ?? [];
+	const sampleChapters = written.length <= 6 ? written : (() => {
+		const picked = /* @__PURE__ */ new Set();
+		for (let i = 0; i < 3 && i < written.length; i++) picked.add(i);
+		const step = Math.max(1, Math.floor(written.length / 4));
+		for (let i = step; i < written.length - 2; i += step) picked.add(i);
+		for (let i = Math.max(0, written.length - 2); i < written.length; i++) picked.add(i);
+		return [...picked].sort((a, b) => a - b).map((i) => written[i]);
+	})();
 	const excerptParts = [];
-	for (const chapter of written.slice(0, 3)) {
+	for (const chapter of sampleChapters) {
 		const body = readChapterFile(config.outputDir, chapter);
 		if (body === void 0) continue;
 		const text = body.replace(/^#.*$/gm, "").trim();
-		if (text.length > 0) excerptParts.push(`第${chapter.no}章《${chapter.title}》\n${text.slice(0, 2400)}`);
+		if (text.length > 0) excerptParts.push(`第${chapter.no}章《${chapter.title}》\n${text.slice(0, 1500)}`);
 	}
-	const raw = parseJsonArray(await complete(ctx, config, {
+	const user = [
+		`书名：《${project.bookName}》`,
+		existingRoles.length > 0 ? `已收录角色（跳过，不要输出）：${existingRoles.map((r) => r.name).join("、")}` : "",
+		`大纲（节选前 3000 字）：\n${project.outline.slice(0, 3e3)}`,
+		excerptParts.length > 0 ? `已写正文摘录（角色姓名/身份/关系以正文为准）：\n${excerptParts.join("\n\n")}` : "",
+		project.bible !== void 0 && project.bible.characters.length > 0 ? `已有角色卡（补充信息）：\n${project.bible.characters.map((c) => `- ${c.name}（${c.role}）：${c.traits.join("、")}${c.goals !== "" ? `；目标：${c.goals}` : ""}`).join("\n")}` : "",
+		(project.facts ?? []).length > 0 ? `编年录（最近 30 条）：\n${(project.facts ?? []).slice(-30).map((f) => `[第${f.chapterNo}章] ${f.text.slice(0, 60)}`).join("\n")}` : "",
+		written.length > 0 ? `已写章节标题（${written.length} 章）：\n${written.map((c) => `第${c.no}章《${c.title}》`).join("、")}` : "",
+		"只输出 JSON 数组。"
+	].join("\n\n");
+	let text = await complete(ctx, config, {
 		system,
-		user: [
-			`书名：《${project.bookName}》`,
-			existingRoles.length > 0 ? `已收录角色（跳过，不要输出）：${existingRoles.map((r) => r.name).join("、")}` : "",
-			`大纲（节选前 3000 字）：\n${project.outline.slice(0, 3e3)}`,
-			excerptParts.length > 0 ? `已写正文摘录（角色姓名/身份/关系以正文为准）：\n${excerptParts.join("\n\n")}` : "",
-			project.bible !== void 0 && project.bible.characters.length > 0 ? `已有角色卡（补充信息）：\n${project.bible.characters.map((c) => `- ${c.name}（${c.role}）：${c.traits.join("、")}${c.goals !== "" ? `；目标：${c.goals}` : ""}`).join("\n")}` : "",
-			(project.facts ?? []).length > 0 ? `编年录（最近 60 条）：\n${(project.facts ?? []).slice(-60).map((f) => `[第${f.chapterNo}章] ${f.text.slice(0, 80)}`).join("\n")}` : "",
-			written.length > 0 ? `已写章节标题（${written.length} 章）：\n${written.map((c) => `第${c.no}章《${c.title}》`).join("、")}` : "",
-			"只输出 JSON 数组。"
-		].join("\n\n"),
+		user,
 		temperature: .3,
-		maxTokens: Math.max(config.maxTokens, 24e3)
-	}));
+		maxTokens: Math.max(config.maxTokens, 24e3),
+		reasoning: config.analysisReasoning ?? "low"
+	});
+	let raw = parseJsonArray(text);
+	const hasProtagonist = raw.some((e) => typeof e === "object" && e !== null && e.roleLabel === "protagonist");
+	if (raw.length === 0 || !hasProtagonist) {
+		text = await complete(ctx, config, {
+			system: system + (raw.length === 0 ? "\n上一次输出为空或格式不正确。请直接输出 JSON 数组（即使只有一个角色也要输出），不要输出其他文字。" : "\n上一次输出中缺少主角（roleLabel 为 protagonist 的角色）。请重新输出完整 JSON 数组，务必包含正文中的主角。"),
+			user,
+			temperature: .3,
+			maxTokens: Math.max(config.maxTokens, 24e3),
+			reasoning: config.analysisReasoning ?? "low"
+		});
+		raw = parseJsonArray(text);
+	}
 	const labels = /* @__PURE__ */ new Set([
 		"protagonist",
 		"female_lead",
@@ -1921,7 +1967,8 @@ async function extractScenes(ctx, config, project) {
 			"只输出 JSON 数组。"
 		].filter((s) => s !== "").join("\n"),
 		temperature: .4,
-		maxTokens: Math.max(config.maxTokens, 12e3)
+		maxTokens: Math.max(config.maxTokens, 12e3),
+		reasoning: config.analysisReasoning ?? "low"
 	}));
 	const strArr = (v) => Array.isArray(v) ? v.filter((x) => typeof x === "string" && x.trim() !== "") : [];
 	const str = (v) => typeof v === "string" ? v.trim() : "";
@@ -1948,6 +1995,175 @@ async function extractScenes(ctx, config, project) {
 	}
 	return scenes;
 }
+/** 从 txt/md 全本文本拆章（纯逻辑，不落盘）：识别章节头、剥离重复标题、去重、排序并统一重新编号。 */
+function splitBookText(raw) {
+	const lines = raw.split(/\r?\n/);
+	const chapterHead = /^\s*(?:#\s*)?第\s*(\d+|[一二三四五六七八九十百千]+)\s*[章回节卷]\s*(.*?)\s*$/;
+	const cnOnlyHead = /^\s*(?:#\s*)?([一二三四五六七八九十百千万零〇]{1,6})(?:[、.．:：]\s*(.*?)\s*)?$/;
+	const specialHead = /^\s*(?:#\s*)?(序章|序言|楔子|引子|前言|开篇|尾声|终章|大结局|番外(?:篇|章)?|后记|完结感言|上架感言|作者的话)\s*[：:、.\s]*(.*?)\s*$/;
+	const enHead = /^\s*(?:#\s*)?chapter\s+(\d+)\s*[.:：、\-\s]*(.*?)\s*$/i;
+	const cnNum = {
+		一: 1,
+		二: 2,
+		三: 3,
+		四: 4,
+		五: 5,
+		六: 6,
+		七: 7,
+		八: 8,
+		九: 9,
+		十: 10,
+		百: 100,
+		千: 1e3
+	};
+	const parseCn = (s) => {
+		if (/^\d+$/.test(s)) return Number(s);
+		let total = 0;
+		let section = 0;
+		for (const ch of s) {
+			const v = cnNum[ch];
+			if (v === void 0) return 0;
+			if (v >= 10) {
+				total += (section > 0 ? section : 1) * v;
+				section = 0;
+			} else section = v;
+		}
+		return total + section;
+	};
+	const chunks = [];
+	let current = null;
+	let specialSeq = 0;
+	for (const line of lines) {
+		const m = chapterHead.exec(line);
+		if (m !== null) {
+			const no = parseCn(m[1]);
+			if (current !== null) chunks.push(current);
+			current = {
+				sortKey: no > 0 ? no : chunks.length + 1,
+				title: (m[2] ?? "").trim(),
+				body: []
+			};
+			continue;
+		}
+		const mc = cnOnlyHead.exec(line);
+		if (mc !== null) {
+			const no = parseCn(mc[1]);
+			if (current !== null) chunks.push(current);
+			const t = (mc[2] ?? "").trim();
+			current = {
+				sortKey: no > 0 ? no : chunks.length + 1,
+				title: t !== "" ? t : "第" + mc[1] + "章",
+				body: []
+			};
+			continue;
+		}
+		const ms = specialHead.exec(line);
+		if (ms !== null) {
+			specialSeq++;
+			const name = ms[1];
+			const front = /序章|序言|楔子|引子|前言|开篇/.test(name);
+			const title = (ms[2] ?? "").trim();
+			if (current !== null) chunks.push(current);
+			current = {
+				sortKey: front ? specialSeq * .001 : 999999 + specialSeq * .001,
+				title: title !== "" ? title : name,
+				body: []
+			};
+			continue;
+		}
+		const me = enHead.exec(line);
+		if (me !== null) {
+			if (current !== null) chunks.push(current);
+			current = {
+				sortKey: Number(me[1]),
+				title: (me[2] ?? "").trim(),
+				body: []
+			};
+			continue;
+		}
+		if (current !== null) current.body.push(line);
+	}
+	if (current !== null) chunks.push(current);
+	if (chunks.length === 0) throw new Error("未识别到章节（需要\"第X章\"格式、中文数字章节（一、二、三…）、序章/楔子/尾声等章节标题、英文 Chapter N，或带 # 的章节标题）");
+	const stripHead = (b) => {
+		let i = 0;
+		while (i < b.length) {
+			const t = b[i].trim();
+			if (t === "" || chapterHead.test(t) || cnOnlyHead.test(t) || specialHead.test(t) || enHead.test(t)) i++;
+			else break;
+		}
+		return b.slice(i).join("\n").trim();
+	};
+	const byKey = /* @__PURE__ */ new Map();
+	for (const c of chunks) {
+		const len = stripHead(c.body).length;
+		const ex = byKey.get(c.sortKey);
+		if (ex === void 0 || len > stripHead(ex.body).length) byKey.set(c.sortKey, c);
+	}
+	return [...byKey.values()].sort((a, b) => a.sortKey - b.sortKey).map((c, i) => ({
+		no: i + 1,
+		title: c.title,
+		body: stripHead(c.body)
+	}));
+}
+/** 拆章预览（不落盘）：章节编号/标题/字数 + 跳过清单。 */
+function previewBookText(raw) {
+	const chapters = [];
+	const skipped = [];
+	for (const c of splitBookText(raw)) {
+		if (c.body.length < 50) {
+			skipped.push("第" + c.no + "章" + (c.title !== "" ? "「" + c.title + "」" : "") + "（内容过短，已跳过）");
+			continue;
+		}
+		chapters.push({
+			no: c.no,
+			title: c.title !== "" ? c.title : "第" + c.no + "章",
+			chars: c.body.length
+		});
+	}
+	return {
+		chapters,
+		skipped
+	};
+}
+/** 从全本文本导入（浏览器上传 / 服务器文件共用）：建项目、写章节文件、保存。 */
+function importBookTextFromText(raw, outputDir, bookName) {
+	const project = createProject(bookName);
+	mkdirSync(outputDir, { recursive: true });
+	const skipped = [];
+	for (const c of splitBookText(raw)) {
+		const body = c.body;
+		if (body.length < 50) {
+			skipped.push("第" + c.no + "章" + (c.title !== "" ? "「" + c.title + "」" : "") + "（内容过短，已跳过）");
+			continue;
+		}
+		const chapter = {
+			no: c.no,
+			volume: 0,
+			title: c.title !== "" ? c.title : "第" + c.no + "章",
+			beats: "",
+			targetChars: 0,
+			status: "written",
+			file: "",
+			chars: 0
+		};
+		chapter.file = chapterFileName(chapter);
+		writeFileSync(join(outputDir, chapter.file), "# 第" + c.no + "章 " + chapter.title + "\n\n" + body + "\n", "utf8");
+		chapter.chars = body.length;
+		project.chapters.push(chapter);
+	}
+	project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+	saveProject(outputDir, project);
+	return {
+		bookName,
+		chapters: project.chapters.length,
+		skipped
+	};
+}
+/** 从 txt/md 全本文件导入：编码自适应读取后拆章建项目，status=written（待审稿）。 */
+function importBookText(filePath, outputDir) {
+	return importBookTextFromText(decodeTextSmart(readFileSync(filePath)), outputDir, basename(filePath, extname(filePath)).slice(0, 40) || "导入小说");
+}
 /**
 * 为单个角色提炼「动漫形象描述词」：扫描该角色出场的已写章节正文，
 * 截取含外貌描写的段落，交给 LLM 提炼中文描述 + 英文绘图标签。
@@ -2078,7 +2294,8 @@ async function extractRoleVisual(ctx, config, project, outputDir, roleName) {
 			"只输出 JSON 对象。"
 		].join("\n\n"),
 		temperature: .4,
-		maxTokens: Math.max(config.maxTokens, 12e3)
+		maxTokens: Math.max(config.maxTokens, 12e3),
+		reasoning: config.analysisReasoning ?? "low"
 	}));
 	const zh = typeof raw.zh === "string" ? raw.zh.trim().slice(0, 500) : "";
 	const en = typeof raw.en === "string" ? raw.en.trim().slice(0, 1500) : "";
@@ -2151,7 +2368,8 @@ async function generateRolePromptKit(ctx, config, project, roleName) {
 			"只输出 JSON 对象。"
 		].join("\n\n"),
 		temperature: .4,
-		maxTokens: Math.max(config.maxTokens, 12e3)
+		maxTokens: Math.max(config.maxTokens, 12e3),
+		reasoning: config.analysisReasoning ?? "low"
 	}));
 	const str = (v) => typeof v === "string" ? v.trim() : "";
 	const pair = (v) => {
@@ -2196,7 +2414,8 @@ async function extractVisualRules(ctx, config, project) {
 			"只输出 JSON 数组。"
 		].filter((s) => s !== "").join("\n\n"),
 		temperature: .3,
-		maxTokens: Math.max(config.maxTokens, 4e3)
+		maxTokens: Math.max(config.maxTokens, 4e3),
+		reasoning: config.analysisReasoning ?? "low"
 	})).map((r) => typeof r === "string" ? r.trim().slice(0, 80) : "").filter((r) => r !== "").slice(0, 8);
 }
 /**
@@ -2232,7 +2451,8 @@ async function suggestOutlines(ctx, config, idea, count = 3, exclude = []) {
 			"只输出 JSON 数组。"
 		].join("\n\n"),
 		temperature: .85,
-		maxTokens: Math.max(config.maxTokens, 12e3)
+		maxTokens: Math.max(config.maxTokens, 12e3),
+		reasoning: config.analysisReasoning ?? "low"
 	}));
 	const candidates = [];
 	for (const entry of parsed) {
@@ -2302,7 +2522,8 @@ async function breakdownBook(ctx, config, project, outputDir, scope = "recent",
 				system: noteSystem,
 				user: noteUser,
 				temperature: .2,
-				maxTokens: Math.max(config.maxTokens, 3e3)
+				maxTokens: Math.max(config.maxTokens, 3e3),
+				reasoning: config.analysisReasoning ?? "low"
 			}));
 			const pick = (k) => Array.isArray(raw[k]) ? raw[k].filter((x) => typeof x === "string" && x.trim() !== "").map((x) => x.trim().slice(0, 120)).slice(0, 4) : [];
 			notes.push(`【第${ch.no}章《${ch.title}》】\n摘要：${typeof raw.summary === "string" ? raw.summary.slice(0, 200) : ""}\n剧情：${pick("plotPoints").join("；")}\n人物：${pick("characters").join("；")}\n设定：${pick("worldbuilding").join("；")}\n写法：${pick("styleTechniques").join("；")}\n卖点：${pick("marketHighlights").join("；")}\n短板信号：${pick("weaknessSignals").join("；") || "（无明显短板信号）"}`);
@@ -2374,7 +2595,8 @@ async function breakdownBook(ctx, config, project, outputDir, scope = "recent",
 			system: sec.system,
 			user: `分析范围：${selected.length} 章（${scope === "all" ? "全书" : scope === "recent" ? "最近 20 章" : "指定卷"}）。\n\n章节笔记：\n${notesText}`,
 			temperature: .3,
-			maxTokens: Math.max(config.maxTokens, 6e3)
+			maxTokens: Math.max(config.maxTokens, 6e3),
+			reasoning: config.analysisReasoning ?? "low"
 		}));
 		sections.push({
 			key: sec.key,
@@ -2828,6 +3050,48 @@ async function summarizeChapter(ctx, config, project, outputDir, chapterNo) {
 	return chapter.summary;
 }
 /**
+* 反向推大纲：从已写章节正文反推出全书总纲（分卷 + 章节要点 + 主线/人物弧线/伏笔清单）。
+* 两阶段：分批提取章节事件摘要 → 汇总生成大纲。不修改章节/设定，只返回大纲文本。
+*/
+async function reverseOutlineFromChapters(ctx, config, project, outputDir, onProgress) {
+	const written = project.chapters.filter((c) => c.status !== "pending" && c.status !== "generating" && c.status !== "error").filter((c) => readChapterFile(outputDir, c) !== void 0).sort((a, b) => a.no - b.no);
+	if (written.length === 0) throw new Error("本书还没有已写章节，无法反推大纲");
+	const BATCH = 10;
+	const notes = [];
+	const total = written.length;
+	for (let i = 0; i < written.length; i += BATCH) {
+		const note = await complete(ctx, config, {
+			system: "你是一位网文编辑。下面是一本书若干章正文的节选。请为每一章输出一行「事件摘要」，格式严格为：第N章《标题》：关键事件+主角状态变化+新增伏笔或线索。每章恰好一行，不要空行，不要评价，不要输出其他内容。",
+			user: written.slice(i, i + BATCH).map((c) => {
+				const body = readChapterFile(outputDir, c) ?? "";
+				return "第" + c.no + "章《" + (c.title || "无题") + "》\n" + body.replace(/^#\s+.*$/m, "").trim().slice(0, 1e3);
+			}).join("\n\n---\n\n"),
+			temperature: .2,
+			maxTokens: Math.max(config.maxTokens, 3e3),
+			reasoning: config.analysisReasoning ?? "low"
+		});
+		notes.push(note.trim());
+		onProgress?.(Math.min(i + BATCH, total), total, "章节摘要");
+	}
+	onProgress?.(total, total, "生成大纲");
+	const outline = await complete(ctx, config, {
+		system: [
+			"你是一位经验丰富的小说主编。根据下面全书各章事件摘要，反推出这本书的总纲（大纲），可直接作为后续写作依据。要求：",
+			"1. 第一行写《书名》（从摘要中的书名或内容推断，若无则用《未命名》）。",
+			"2. 按故事弧线划分卷/部分：每卷给出卷名与主旨（标注覆盖章节范围）。",
+			"3. 每一章列出：章节号 + 标题 + 一句话核心情节（若原章无标题可自拟）。",
+			"4. 最后给出：全书主线、主要人物弧线、已埋设待回收的伏笔清单。",
+			"5. 输出为纯文本 Markdown 结构（# 一级标题、## 二级标题、- 列表），不要多余寒暄。"
+		].join("\n"),
+		user: notes.join("\n\n"),
+		temperature: .4,
+		maxTokens: Math.max(config.maxTokens, 6e3),
+		reasoning: config.analysisReasoning ?? "low"
+	});
+	onProgress?.(total, total, "完成");
+	return outline.trim();
+}
+/**
 * 摘要 + 事实抽取合并为一次 LLM 调用（省一次调用与一次正文输入，
 * 批量生成时整体开销约省 25%）。
 * @returns 摘要与新增事实条数（失败返回空，调用方 best-effort）。
@@ -3032,7 +3296,8 @@ async function generateBlurb(ctx, config, project, partial = "") {
 			partial.trim() !== "" ? `已有开头草稿（请保留其内容与语气，续写补全为完整简介）：\n${partial.trim()}` : "请全量生成一份完整简介。"
 		].filter((s) => s !== "").join("\n\n"),
 		temperature: .7,
-		maxTokens: Math.max(config.maxTokens, 4e3)
+		maxTokens: Math.max(config.maxTokens, 4e3),
+		reasoning: config.analysisReasoning ?? "low"
 	})).replace(/^["'「『]|["'」』]$/g, "").replace(/^简介[：:]\s*/, "").trim().slice(0, 600);
 }
 /**
@@ -3194,7 +3459,8 @@ async function extractWorld(ctx, config, project) {
 			"只输出 JSON 对象。"
 		].filter((s) => s !== "").join("\n\n"),
 		temperature: .3,
-		maxTokens: Math.max(config.maxTokens, 12e3)
+		maxTokens: Math.max(config.maxTokens, 12e3),
+		reasoning: config.analysisReasoning ?? "low"
 	}));
 	const str = (value) => typeof value === "string" ? value.trim() : "";
 	const objArray = (value) => Array.isArray(value) ? value.filter((v) => typeof v === "object" && v !== null) : [];
@@ -3333,7 +3599,8 @@ async function suggestForeshadows(ctx, config, project) {
 		system: foreshadowSystemPrompt(),
 		user,
 		temperature: .5,
-		maxTokens: Math.max(config.maxTokens, 12e3)
+		maxTokens: Math.max(config.maxTokens, 12e3),
+		reasoning: config.analysisReasoning ?? "low"
 	}));
 	const existing = new Set(project.foreshadows.map((f) => f.description));
 	const created = [];
@@ -3501,6 +3768,25 @@ function seedBookshelfFromOutputDir(outputDir) {
 	createBook(loadProject(outputDir)?.bookName ?? outputDir.split(/[\\/]/).pop() ?? "未命名小说", outputDir);
 	return true;
 }
+/** 导入已有项目目录到书架：校验 novel-project.json，已存在则直接激活。 */
+function importDir(outputDir) {
+	const project = loadProject(outputDir);
+	if (project === void 0) throw new Error(`目录中未找到有效的 novel-project.json：${outputDir}`);
+	const store = loadBookshelf();
+	const existed = store.books.find((b) => b.outputDir === outputDir);
+	if (existed !== void 0) {
+		store.activeBookId = existed.id;
+		saveBookshelf(store);
+		return {
+			book: existed,
+			existed: true
+		};
+	}
+	return {
+		book: createBook(project.bookName !== "" ? project.bookName : outputDir.split(/[\\/]/).pop() ?? "未命名小说", outputDir),
+		existed: false
+	};
+}
 /** 激活一本书。 */
 function activateBook(id) {
 	const store = loadBookshelf();
@@ -3878,6 +4164,12 @@ const NOVEL_API = {
 	/** 清空助手对话记录。 */
 	assistantClear: "/api/dsh-novel-forge/assistant/clear",
 	bookshelf: "/api/dsh-novel-forge/bookshelf",
+	/** 导入已有项目目录（含 novel-project.json）到书架。 */
+	bookshelfImportDir: "/api/dsh-novel-forge/bookshelf/import-dir",
+	/** 导入 txt/md 全本：拆章建项目并登记书架。 */
+	bookshelfImportText: "/api/dsh-novel-forge/bookshelf/import-text",
+	/** 导入 txt/md 全本：拆章预览（不落盘）。 */
+	bookshelfImportTextPreview: "/api/dsh-novel-forge/bookshelf/import-text/preview",
 	/** 重置项目（可选携带新大纲）：清空设定/卷/章节/伏笔/资产/事实库。 */
 	reset: "/api/dsh-novel-forge/reset",
 	/** 全书一致性质检：LLM 扫描已生成章节，输出矛盾问题清单。 */
@@ -3912,6 +4204,8 @@ const NOVEL_API = {
 	sensitiveCheck: "/api/dsh-novel-forge/sensitive-check",
 	/** 开书想法 → AI 补全大纲：输入一句话想法，生成 2-3 个可选大纲方案。 */
 	outlineSuggest: "/api/dsh-novel-forge/outline/suggest",
+	/** 反推大纲：从已写章节正文反向生成全书总纲（NDJSON 流）。 */
+	outlineReverse: "/api/dsh-novel-forge/outline/reverse",
 	/** 拆书分析：对已写章节做结构/人物/文风/卖点四维体检（两阶段：源笔记→分节分析）。 */
 	breakdown: "/api/dsh-novel-forge/breakdown",
 	/** 漫剧分镜生成：章节 → 角色锚点 + 分镜表（可适配豆包/Seedance/SD）。 */
@@ -4718,7 +5012,7 @@ async function* runAssistantTurn(ctx, config, project, outputDir, userMessage) {
 //#endregion
 //#region src/routes.ts
 /** Cap on JSON request bodies (generous: cover images travel as base64). */
-const MAX_JSON_BODY_BYTES = 16 * 1024 * 1024;
+const MAX_JSON_BODY_BYTES = 64 * 1024 * 1024;
 /** Loopback-only fence (mirrors the family plugins' pairing routes). */
 function isLoopbackRequest(request) {
 	const address = request.socket.remoteAddress;
@@ -5729,6 +6023,90 @@ function makeRoutes(deps) {
 			writeJson(res, 200, bookshelfSnapshot(loadBookshelf()));
 		}
 	};
+	/** 导入已有项目目录（Mode A）：校验 novel-project.json，登记/激活书架。 */
+	const bookshelfImportDirRoute = {
+		kind: "exact",
+		path: NOVEL_API.bookshelfImportDir,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const outputDir = (await readJsonBody(req))?.outputDir?.trim();
+			if (outputDir === void 0 || outputDir === "") {
+				writeJson(res, 400, { error: "outputDir 不能为空" });
+				return;
+			}
+			try {
+				const { book, existed } = importDir(outputDir);
+				writeJson(res, 200, {
+					book,
+					existed
+				});
+			} catch (err) {
+				writeJson(res, 400, { error: err instanceof Error ? err.message : String(err) });
+			}
+		}
+	};
+	/** 导入 txt/md 全本（Mode B）：拆章落盘建项目，登记书架。支持浏览器上传（text+fileName）与服务器本地文件（filePath）两种模式。 */
+	const bookshelfImportTextRoute = {
+		kind: "exact",
+		path: NOVEL_API.bookshelfImportText,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const body = await readJsonBody(req);
+			try {
+				if (body?.text !== void 0 && body.text.length > 0) {
+					const bookName = (body.fileName ?? "").replace(/\.[^.]+$/, "").trim().slice(0, 40) || "导入小说";
+					const outDir = body?.outputDir?.trim() !== void 0 && body.outputDir.trim() !== "" ? body.outputDir.trim() : defaultOutputDirFor(bookName);
+					const result = importBookTextFromText(body.text, outDir, bookName);
+					const { book } = importDir(outDir);
+					writeJson(res, 200, {
+						...result,
+						book
+					});
+					return;
+				}
+				const filePath = body?.filePath?.trim();
+				if (filePath === void 0 || filePath === "") {
+					writeJson(res, 400, { error: "filePath 不能为空（或请上传文件内容）" });
+					return;
+				}
+				if (!existsSync(filePath)) {
+					writeJson(res, 400, { error: `文件不存在：${filePath}` });
+					return;
+				}
+				const bookName = basename(filePath, extname(filePath)).slice(0, 40) || "导入小说";
+				const outDir = body?.outputDir?.trim() !== void 0 && body.outputDir.trim() !== "" ? body.outputDir.trim() : defaultOutputDirFor(bookName);
+				const result = importBookText(filePath, outDir);
+				const { book } = importDir(outDir);
+				writeJson(res, 200, {
+					...result,
+					book
+				});
+			} catch (err) {
+				writeJson(res, 400, { error: err instanceof Error ? err.message : String(err) });
+			}
+		}
+	};
+	/** 上传全文做拆章预览（不落盘、不登记书架）。 */
+	const bookshelfImportTextPreviewRoute = {
+		kind: "exact",
+		path: NOVEL_API.bookshelfImportTextPreview,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const body = await readJsonBody(req);
+			if (body?.text === void 0 || body.text.length === 0) {
+				writeJson(res, 400, { error: "text 不能为空" });
+				return;
+			}
+			try {
+				writeJson(res, 200, {
+					bookName: (body.fileName ?? "").replace(/\.[^.]+$/, "").trim().slice(0, 40) || "导入小说",
+					...previewBookText(body.text)
+				});
+			} catch (err) {
+				writeJson(res, 400, { error: err instanceof Error ? err.message : String(err) });
+			}
+		}
+	};
 	/** 全书一致性质检。 */
 	const auditRoute = {
 		kind: "exact",
@@ -6510,6 +6888,52 @@ function makeRoutes(deps) {
 			}
 		}
 	};
+	/** 反推大纲：从已写章节正文反向生成全书总纲（NDJSON 流式进度）。 */
+	const outlineReverseRoute = {
+		kind: "exact",
+		path: NOVEL_API.outlineReverse,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const config = getConfig();
+			const project = requireProject(res);
+			if (project === void 0) return;
+			res.writeHead(200, {
+				"content-type": "application/x-ndjson; charset=utf-8",
+				"cache-control": "no-cache",
+				"x-accel-buffering": "no",
+				"referrer-policy": "no-referrer"
+			});
+			const send = (frame) => {
+				res.write(JSON.stringify(frame) + "\n");
+			};
+			try {
+				const outline = await reverseOutlineFromChapters(ctx, config, project, config.outputDir, (done, total, phase) => {
+					send({
+						type: "outline-progress",
+						done,
+						total,
+						phase
+					});
+				});
+				project.outline = outline;
+				project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+				saveProject(config.outputDir, project);
+				send({
+					type: "outline-done",
+					outline,
+					chars: outline.length
+				});
+			} catch (error) {
+				send({
+					type: "error",
+					no: 0,
+					message: error.message
+				});
+			} finally {
+				res.end();
+			}
+		}
+	};
 	/** 拆书分析：对已写章节做结构/人物/文风/卖点体检（两阶段：源笔记→分节分析）。 */
 	const breakdownRoute = {
 		kind: "exact",
@@ -6652,6 +7076,9 @@ function makeRoutes(deps) {
 		bookshelfRoute,
 		bookshelfActivateRoute,
 		bookshelfRemoveRoute,
+		bookshelfImportDirRoute,
+		bookshelfImportTextRoute,
+		bookshelfImportTextPreviewRoute,
 		resetRoute,
 		auditRoute,
 		charactersRefreshRoute,
@@ -6672,6 +7099,7 @@ function makeRoutes(deps) {
 		configRoute,
 		openFolderRoute,
 		outlineSuggestRoute,
+		outlineReverseRoute,
 		breakdownRoute,
 		{
 			kind: "exact",
@@ -6766,6 +7194,12 @@ const Config = z.object({
 		"high",
 		"max"
 	]).default("off"),
+	analysisReasoning: z.union([
+		"off",
+		"low",
+		"high",
+		"max"
+	]).default("low"),
 	chapterChars: z.number().default(3500),
 	maxTokens: z.number().default(12e3),
 	reviewPassScore: z.number().default(70),
@@ -6783,6 +7217,7 @@ const DEFAULT_OUTPUT_DIR = join(homedir(), ".dsh", "novels");
 const DEFAULT_PROVIDER = "deepseek-official";
 const DEFAULT_MODEL = "deepseek-v4-flash";
 const DEFAULT_REASONING_EFFORT = "off";
+const DEFAULT_ANALYSIS_REASONING = "low";
 const DEFAULT_CHAPTER_CHARS = 3500;
 const DEFAULT_MAX_TOKENS = 12e3;
 const DEFAULT_REVIEW_PASS_SCORE = 70;
@@ -6801,6 +7236,7 @@ function resolveConfig(value) {
 		provider: value?.provider ?? DEFAULT_PROVIDER,
 		model: value?.model ?? DEFAULT_MODEL,
 		reasoningEffort: value?.reasoningEffort ?? DEFAULT_REASONING_EFFORT,
+		analysisReasoning: value?.analysisReasoning ?? DEFAULT_ANALYSIS_REASONING,
 		chapterChars: value?.chapterChars ?? DEFAULT_CHAPTER_CHARS,
 		maxTokens: value?.maxTokens ?? DEFAULT_MAX_TOKENS,
 		reviewPassScore: value?.reviewPassScore ?? DEFAULT_REVIEW_PASS_SCORE,
@@ -6835,6 +7271,7 @@ function apply(ctx, config) {
 		if (patch.provider !== void 0) next.provider = patch.provider;
 		if (patch.model !== void 0) next.model = patch.model;
 		if (patch.reasoningEffort !== void 0) next.reasoningEffort = patch.reasoningEffort;
+		if (patch.analysisReasoning !== void 0) next.analysisReasoning = patch.analysisReasoning;
 		if (patch.chapterChars !== void 0) next.chapterChars = patch.chapterChars;
 		if (patch.maxTokens !== void 0) next.maxTokens = patch.maxTokens;
 		if (patch.reviewPassScore !== void 0) next.reviewPassScore = patch.reviewPassScore;