@waterwx/dsh-novel-forge 1.1.4 → 1.1.5

package/lib/index.js

@@ -65,8 +65,12 @@ const NOVEL_API = {
 	cover: "/api/dsh-novel-forge/blurb/cover",
 	/** 剧情线管理：增删改 + 关联章节。 */
 	plotlines: "/api/dsh-novel-forge/plotlines",
+	/** 角色库：AI 提炼 / 采纳 / 更新 / 删除。 */
+	roles: "/api/dsh-novel-forge/roles",
 	/** 作者复盘补跑：对已写章节补齐 authorReview（全书流式 / 单章 JSON）。 */
 	reviewBackfill: "/api/dsh-novel-forge/review/backfill",
+	/** 章节复位：generating 卡死 → pending（可重新生成）。 */
+	chapterReset: "/api/dsh-novel-forge/chapter/reset",
 	/** 敏感词检查：全书已写章节或指定文本。 */
 	sensitiveCheck: "/api/dsh-novel-forge/sensitive-check",
 	config: "/api/dsh-novel-forge/config",
@@ -1426,6 +1430,19 @@ function writeSystemPrompt(project) {
 				if (Array.isArray(card.knowledge) && card.knowledge.length > 0) sections.push(`  已知信息（该角色知道的：${card.knowledge.join("；")}；未列出的信息该角色一律不知道，不得写其知晓或提及）`);
 			}
 		}
+		const roleLib = project.roles ?? [];
+		if (roleLib.length > 0) {
+			const labelName = {
+				protagonist: "主角",
+				female_lead: "女主",
+				female_support: "女配",
+				support: "配角",
+				antagonist: "反派",
+				extra: "路人"
+			};
+			sections.push("角色库（出场角色按定位规格刻画互动）：");
+			for (const r of roleLib) sections.push(`- ${r.name}（${labelName[r.roleLabel]}）：${r.identity}${r.relations.length > 0 ? `；关系：${r.relations.join("、")}` : ""}`);
+		}
 		if (bible.redLines.length > 0) sections.push("写作红线（违反即失败）：\n" + bible.redLines.map((r) => `- ${r}`).join("\n"));
 		if (bible.style.length > 0) sections.push("风格要求：\n" + bible.style.map((r) => `- ${r}`).join("\n"));
 	}
@@ -1772,6 +1789,70 @@ async function refreshPlotlineProgress(ctx, config, project, line) {
 	}));
 	return typeof raw.progress === "string" ? raw.progress.trim().slice(0, 300) : "";
 }
+/** ✨ AI 从全书提炼角色库：大纲 + 道藏 + 编年录 + 章节摘要 → 结构化角色清单。 */
+async function extractRoles(ctx, config, project) {
+	const system = [
+		"你是一位网文角色库管理员。请根据本书的大纲、设定、编年录与章节摘要，提炼完整的角色库。",
+		"覆盖原则：所有在编年录/章节中实际出场或有名有姓的角色都应收录；无名的功能性人物（如\"矮胖姑娘\"）用其身份简称收录并标注。",
+		"数量控制：最多输出 10 个角色，宁缺毋滥；路人级一次带过的不要收录。",
+		"每个角色输出：",
+		"1. name：角色名（或身份简称）。",
+		"2. roleLabel：定位——protagonist=主角；female_lead=女主（唯一知己/感情线核心，无后宫前提下只此一位）；female_support=重要女配；support=普通配角；antagonist=反派；extra=路人/背景。",
+		"3. identity：身份一句话（宗门/势力/血脉/职业）。",
+		"4. traits：3-6 个性格标签。",
+		"5. goals：目标与动机一句话。",
+		"6. relations：关系网数组，格式[\"角色名（关系）\", ...]。",
+		"7. arc：成长线数组，格式[\"阶段：说明\", ...]（如\"出场：祭品身份\"/\"转折：祭祀被中断脱身\"）。",
+		"8. knowledge：该角色已经知道的关键信息（3-8 条），不知道的信息不要写进去。",
+		"精简要求：identity 控制在 30 字内；traits 3-6 个短标签；goals 60 字内；relations 2-5 条；arc 2-4 条；knowledge 每条 40 字内。整体输出量要紧凑，避免冗长。",
+		"重要：用户消息里列出的「已收录角色」绝不要再次输出——这些角色已经在角色库里，跳过它们，只提炼未收录的。",
+		"输出必须是合法 JSON 数组，不要输出其他文字：[{\"name\":\"...\", \"roleLabel\":\"...\", \"identity\":\"...\", \"traits\":[...], \"goals\":\"...\", \"relations\":[...], \"arc\":[...], \"knowledge\":[...]}]",
+		"重要：所有字符串值内部不得包含换行符，JSON 必须在一段内完整结束。",
+		"重要：直接输出 JSON 结果本身，不要把思考过程写在输出里。"
+	].join("\n");
+	const written = project.chapters.filter((c) => c.status !== "pending" && c.status !== "generating");
+	const existingRoles = project.roles ?? [];
+	const raw = parseJsonArray(await complete(ctx, config, {
+		system,
+		user: [
+			`书名：《${project.bookName}》`,
+			existingRoles.length > 0 ? `已收录角色（跳过，不要输出）：${existingRoles.map((r) => r.name).join("、")}` : "",
+			`大纲（节选前 3000 字）：\n${project.outline.slice(0, 3e3)}`,
+			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"),
+		temperature: .3,
+		maxTokens: Math.max(config.maxTokens, 24e3)
+	}));
+	const labels = /* @__PURE__ */ new Set([
+		"protagonist",
+		"female_lead",
+		"female_support",
+		"support",
+		"antagonist",
+		"extra"
+	]);
+	const strArr = (v) => Array.isArray(v) ? v.filter((x) => typeof x === "string" && x.trim() !== "") : [];
+	const roles = [];
+	for (const entry of raw) {
+		if (typeof entry !== "object" || entry === null) continue;
+		const name = typeof entry.name === "string" ? entry.name.trim().slice(0, 30) : "";
+		if (name === "") continue;
+		roles.push({
+			name,
+			roleLabel: labels.has(entry.roleLabel) ? entry.roleLabel : "support",
+			identity: typeof entry.identity === "string" ? entry.identity.slice(0, 100) : "",
+			traits: strArr(entry.traits).map((t) => t.slice(0, 20)).slice(0, 8),
+			goals: typeof entry.goals === "string" ? entry.goals.slice(0, 200) : "",
+			relations: strArr(entry.relations).map((r) => r.slice(0, 60)).slice(0, 10),
+			arc: strArr(entry.arc).map((a) => a.slice(0, 120)).slice(0, 10),
+			knowledge: strArr(entry.knowledge).map((k) => k.slice(0, 120)).slice(0, 12)
+		});
+	}
+	return roles;
+}
 /** 🩺 剧情健康检查：基于已写章节数/各线状态/编年录，判断是否需要新线及添加时机。 */
 async function analyzePlotlineHealth(ctx, config, project) {
 	const system = [
@@ -3144,8 +3225,19 @@ async function chatOnce(ctx, config, system, history) {
 	const messages = historyToMessages(history);
 	const last = messages[messages.length - 1];
 	if (last?.role === "user" && Array.isArray(last.content)) {
-		const text = last.content.find((b) => b.type === "text");
-		if (text !== void 0 && typeof text.text === "string") text.text += "\n\n（回复格式提醒：如果你需要执行任何操作，你的回复必须【只包含】一个 <dsh-action name=\"工具名\">{\"参数\":值}</dsh-action> 标签，禁止先说话、禁止解释、禁止铺垫；如果你只是在回答或讨论，正常回复即可，不要输出标签。）";
+		const blocks = last.content;
+		const idx = blocks.findIndex((b) => b.type === "text");
+		if (idx !== -1) {
+			const textBlock = blocks[idx];
+			const newBlocks = blocks.map((b, i) => i === idx ? {
+				...textBlock,
+				text: textBlock.text + "\n\n（回复格式提醒：如果你需要执行任何操作，你的回复必须【只包含】一个 <dsh-action name=\"工具名\">{\"参数\":值}</dsh-action> 标签，禁止先说话、禁止解释、禁止铺垫；如果你只是在回答或讨论，正常回复即可，不要输出标签。）"
+			} : b);
+			messages[messages.length - 1] = {
+				...last,
+				content: newBlocks
+			};
+		}
 	}
 	const request = {
 		provider: config.provider,
@@ -3182,9 +3274,29 @@ async function* runAssistantTurn(ctx, config, project, outputDir, userMessage) {
 	/** 已提示模型输出动作标签的次数（0 = 尚未提示；超过上限则按纯文字回复结束，防死循环）。 */
 	let nudged = 0;
 	const MAX_NUDGES = 6;
+	/** 连续收到 hex 乱码回复的次数（≥2 次判定 LLM 侧异常，放弃本轮避免死循环）。 */
+	let garbleCount = 0;
 	for (;;) {
 		if (round++ > 20) break;
 		const reply = await chatOnce(ctx, config, system, history);
+		if (reply.length > 120 && /^[0-9a-fA-F\s]+$/.test(reply.slice(0, 2e3))) {
+			garbleCount++;
+			if (garbleCount >= 2) {
+				const garbleEntry = {
+					role: "assistant",
+					content: "（模型本次返回了异常编码内容，已忽略；请重新描述你的问题。）",
+					ts: (/* @__PURE__ */ new Date()).toISOString()
+				};
+				history.push(garbleEntry);
+				appendHistory(outputDir, garbleEntry);
+				yield {
+					frame: "delta",
+					text: garbleEntry.content
+				};
+				return;
+			}
+			continue;
+		}
 		const action = extractAction(reply);
 		if (action === void 0) {
 			const intendsAction = /(改|修改|修订|重写|替换|调整|生成|新增|删除|导出|看看|查看|调出|读一下|加上|加一个|去掉|删掉|把.+改成|定位|处理|转轨|检查|确认|搜索|找一下|列一下|查一下|查一遍|查一查|再查|查查|核实|核对|清点|盘点|看一下|看下|继续)/.test(reply);
@@ -3530,6 +3642,15 @@ function makeRoutes(deps) {
 			seedBookshelfFromOutputDir(config.outputDir);
 			const project = loadProject(config.outputDir);
 			if (project !== void 0) {
+				const staleMs = 600 * 1e3;
+				for (const c of project.chapters) if (c.status === "generating" && c.generatingAt !== void 0) {
+					const started = new Date(c.generatingAt).getTime();
+					if (Number.isFinite(started) && Date.now() - started > staleMs) {
+						c.status = "pending";
+						c.error = void 0;
+						c.generatingAt = void 0;
+					}
+				}
 				syncProjectWithDisk(project, config.outputDir);
 				saveProject(config.outputDir, project);
 			}
@@ -3718,6 +3839,7 @@ function makeRoutes(deps) {
 			});
 			chapter.status = "generating";
 			chapter.error = void 0;
+			chapter.generatingAt = (/* @__PURE__ */ new Date()).toISOString();
 			saveProject(config.outputDir, project);
 			const send = (frame) => {
 				res.write(JSON.stringify(frame) + "\n");
@@ -4233,604 +4355,700 @@ function makeRoutes(deps) {
 			writeJson(res, 200, { ok: true });
 		}
 	};
-	return [
-		statusRoute,
-		loadOutlineRoute,
-		saveOutlineRoute,
-		bibleRoute,
-		volumesRoute,
-		planRoute,
-		generateRoute,
-		reviewRoute,
-		rewriteRoute,
-		polishRoute,
-		draftApplyRoute,
-		draftDiscardRoute,
-		summaryRoute,
-		foreshadowRoute,
-		exportRoute,
-		chapterRoute,
-		chapterCheckRoute,
-		chapterSaveRoute,
-		{
-			kind: "exact",
-			path: NOVEL_API.assets,
-			handler: async (req, res) => {
-				if (req.method !== "GET" && req.method !== "POST") {
-					writeJson(res, 405, { error: "method not allowed (expected GET or POST)" });
+	const assetsRoute = {
+		kind: "exact",
+		path: NOVEL_API.assets,
+		handler: async (req, res) => {
+			if (req.method !== "GET" && req.method !== "POST") {
+				writeJson(res, 405, { error: "method not allowed (expected GET or POST)" });
+				return;
+			}
+			if (!isLoopbackRequest(req)) {
+				writeJson(res, 403, { error: "forbidden: loopback-only" });
+				return;
+			}
+			const config = getConfig();
+			const project = loadProject(config.outputDir);
+			const projectAssets = project?.assets ?? emptyProjectAssets();
+			if (req.method === "POST") {
+				const body = await readJsonBody(req);
+				if (body === void 0) {
+					writeJson(res, 400, { error: "无效的 JSON" });
 					return;
 				}
-				if (!isLoopbackRequest(req)) {
-					writeJson(res, 403, { error: "forbidden: loopback-only" });
+				if (project === void 0) {
+					writeJson(res, 400, { error: "请先加载大纲创建项目" });
 					return;
 				}
-				const config = getConfig();
-				const project = loadProject(config.outputDir);
-				const projectAssets = project?.assets ?? emptyProjectAssets();
-				if (req.method === "POST") {
-					const body = await readJsonBody(req);
-					if (body === void 0) {
-						writeJson(res, 400, { error: "无效的 JSON" });
-						return;
-					}
-					if (project === void 0) {
-						writeJson(res, 400, { error: "请先加载大纲创建项目" });
-						return;
-					}
-					if (body.genre !== void 0) projectAssets.genre = body.genre;
-					if (body.primaryProgression !== void 0) projectAssets.primaryProgression = body.primaryProgression;
-					if (body.auxiliaryProgressions !== void 0) projectAssets.auxiliaryProgressions = body.auxiliaryProgressions;
-					if (body.antiAiRules !== void 0) projectAssets.antiAiRules = body.antiAiRules;
-					if (body.styleAssets !== void 0) projectAssets.styleAssets = body.styleAssets;
-					projectAssets.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-					project.assets = projectAssets;
+				if (body.genre !== void 0) projectAssets.genre = body.genre;
+				if (body.primaryProgression !== void 0) projectAssets.primaryProgression = body.primaryProgression;
+				if (body.auxiliaryProgressions !== void 0) projectAssets.auxiliaryProgressions = body.auxiliaryProgressions;
+				if (body.antiAiRules !== void 0) projectAssets.antiAiRules = body.antiAiRules;
+				if (body.styleAssets !== void 0) projectAssets.styleAssets = body.styleAssets;
+				projectAssets.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+				project.assets = projectAssets;
+				project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+				saveProject(config.outputDir, project);
+			}
+			writeJson(res, 200, {
+				projectAssets,
+				genreLibrary: BUILTIN_GENRE_LIBRARY,
+				antiAiLibrary: BUILTIN_ANTI_AI_RULES,
+				styleTemplates: BUILTIN_STYLE_TEMPLATES,
+				progressionLibrary: BUILTIN_PROGRESSION_MODES
+			});
+		}
+	};
+	const styleEngineRoute = {
+		kind: "exact",
+		path: NOVEL_API.styleEngine,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const config = getConfig();
+			const project = loadProject(config.outputDir);
+			const body = await readJsonBody(req);
+			const sample = body?.sampleText?.trim();
+			if (sample === void 0 || sample.length < 50) {
+				writeJson(res, 400, { error: "样本文本过短（<50 字符），请粘贴一段能代表目标风格的文字" });
+				return;
+			}
+			try {
+				const rules = await extractStyleAsset(ctx, config, sample);
+				const styleAsset = {
+					name: (body?.name?.trim() !== "" && body?.name !== void 0 ? body.name : `风格资产 ${Date.now().toString(36)}`).slice(0, 40),
+					...rules,
+					sourceText: sample.slice(0, 3e3),
+					createdAt: (/* @__PURE__ */ new Date()).toISOString()
+				};
+				if (project !== void 0) {
+					project.assets ??= emptyProjectAssets();
+					project.assets.styleAssets ??= [];
+					project.assets.styleAssets.push(styleAsset);
+					project.assets.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
 					project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
 					saveProject(config.outputDir, project);
 				}
-				writeJson(res, 200, {
-					projectAssets,
-					genreLibrary: BUILTIN_GENRE_LIBRARY,
-					antiAiLibrary: BUILTIN_ANTI_AI_RULES,
-					styleTemplates: BUILTIN_STYLE_TEMPLATES,
-					progressionLibrary: BUILTIN_PROGRESSION_MODES
-				});
+				writeJson(res, 200, { styleAsset });
+			} catch (error) {
+				writeJson(res, 500, { error: error.message });
 			}
-		},
-		{
-			kind: "exact",
-			path: NOVEL_API.styleEngine,
-			handler: async (req, res) => {
-				if (!guard(req, res, "POST")) return;
-				const config = getConfig();
-				const project = loadProject(config.outputDir);
-				const body = await readJsonBody(req);
-				const sample = body?.sampleText?.trim();
-				if (sample === void 0 || sample.length < 50) {
-					writeJson(res, 400, { error: "样本文本过短（<50 字符），请粘贴一段能代表目标风格的文字" });
+		}
+	};
+	const bookshelfRoute = {
+		kind: "exact",
+		path: NOVEL_API.bookshelf,
+		handler: async (req, res) => {
+			if (req.method === "GET") {
+				if (!isLoopbackRequest(req)) {
+					writeJson(res, 403, { error: "forbidden: loopback-only" });
 					return;
 				}
-				try {
-					const rules = await extractStyleAsset(ctx, config, sample);
-					const styleAsset = {
-						name: (body?.name?.trim() !== "" && body?.name !== void 0 ? body.name : `风格资产 ${Date.now().toString(36)}`).slice(0, 40),
-						...rules,
-						sourceText: sample.slice(0, 3e3),
-						createdAt: (/* @__PURE__ */ new Date()).toISOString()
-					};
-					if (project !== void 0) {
-						project.assets ??= emptyProjectAssets();
-						project.assets.styleAssets ??= [];
-						project.assets.styleAssets.push(styleAsset);
-						project.assets.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-						project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-						saveProject(config.outputDir, project);
-					}
-					writeJson(res, 200, { styleAsset });
-				} catch (error) {
-					writeJson(res, 500, { error: error.message });
-				}
+				seedBookshelfFromOutputDir(getConfig().outputDir);
+				writeJson(res, 200, bookshelfSnapshot(loadBookshelf()));
+				return;
 			}
-		},
-		assistantRoute,
-		assistantHistoryRoute,
-		assistantClearRoute,
-		{
-			kind: "exact",
-			path: NOVEL_API.bookshelf,
-			handler: async (req, res) => {
-				if (req.method === "GET") {
-					if (!isLoopbackRequest(req)) {
-						writeJson(res, 403, { error: "forbidden: loopback-only" });
-						return;
-					}
-					seedBookshelfFromOutputDir(getConfig().outputDir);
-					writeJson(res, 200, bookshelfSnapshot(loadBookshelf()));
-					return;
-				}
-				if (req.method === "POST") {
-					if (!isLoopbackRequest(req)) {
-						writeJson(res, 403, { error: "forbidden: loopback-only" });
-						return;
-					}
-					const body = await readJsonBody(req);
-					const bookName = body?.bookName?.trim();
-					if (bookName === void 0 || bookName === "") {
-						writeJson(res, 400, { error: "bookName 不能为空" });
-						return;
-					}
-					const outputDir = body?.outputDir?.trim() !== "" && body?.outputDir !== void 0 ? body.outputDir : defaultOutputDirFor(bookName);
-					const book = createBook(bookName, outputDir);
-					const outline = body?.outline?.trim();
-					if (outline !== void 0 && outline.length >= 50) {
-						const project = createProject(outline);
-						saveProject(outputDir, project);
-						renameBook(book.id, project.bookName);
-					}
-					writeJson(res, 200, bookshelfSnapshot(loadBookshelf()));
+			if (req.method === "POST") {
+				if (!isLoopbackRequest(req)) {
+					writeJson(res, 403, { error: "forbidden: loopback-only" });
 					return;
 				}
-				writeJson(res, 405, { error: "method not allowed (expected GET or POST)" });
-			}
-		},
-		{
-			kind: "exact",
-			path: "/api/dsh-novel-forge/bookshelf/activate",
-			handler: async (req, res) => {
-				if (!guard(req, res, "POST")) return;
 				const body = await readJsonBody(req);
-				if (body?.id === void 0 || body.id === "") {
-					writeJson(res, 400, { error: "id 不能为空" });
+				const bookName = body?.bookName?.trim();
+				if (bookName === void 0 || bookName === "") {
+					writeJson(res, 400, { error: "bookName 不能为空" });
 					return;
 				}
-				if (activateBook(body.id) === void 0) {
-					writeJson(res, 404, { error: `书 ${body.id} 不存在` });
-					return;
+				const outputDir = body?.outputDir?.trim() !== "" && body?.outputDir !== void 0 ? body.outputDir : defaultOutputDirFor(bookName);
+				const book = createBook(bookName, outputDir);
+				const outline = body?.outline?.trim();
+				if (outline !== void 0 && outline.length >= 50) {
+					const project = createProject(outline);
+					saveProject(outputDir, project);
+					renameBook(book.id, project.bookName);
 				}
 				writeJson(res, 200, bookshelfSnapshot(loadBookshelf()));
+				return;
 			}
-		},
-		{
-			kind: "exact",
-			path: "/api/dsh-novel-forge/bookshelf/remove",
-			handler: async (req, res) => {
-				if (!guard(req, res, "POST")) return;
-				const body = await readJsonBody(req);
-				if (body?.id === void 0 || body.id === "") {
-					writeJson(res, 400, { error: "id 不能为空" });
-					return;
-				}
-				if (!removeBook(body.id)) {
-					writeJson(res, 404, { error: `书 ${body.id} 不存在` });
-					return;
-				}
-				writeJson(res, 200, bookshelfSnapshot(loadBookshelf()));
+			writeJson(res, 405, { error: "method not allowed (expected GET or POST)" });
+		}
+	};
+	/** 重置项目：清空设定/卷/章节计划/正文/伏笔/资产/事实库（可携带新大纲）。 */
+	const resetRoute = {
+		kind: "exact",
+		path: NOVEL_API.reset,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const config = getConfig();
+			const project = loadProject(config.outputDir);
+			if (project === void 0) {
+				writeJson(res, 400, { error: "输出目录中没有项目，无需重置" });
+				return;
 			}
-		},
-		{
-			kind: "exact",
-			path: NOVEL_API.reset,
-			handler: async (req, res) => {
-				if (!guard(req, res, "POST")) return;
-				const config = getConfig();
-				const project = loadProject(config.outputDir);
-				if (project === void 0) {
-					writeJson(res, 400, { error: "输出目录中没有项目，无需重置" });
-					return;
-				}
-				const outline = (await readJsonBody(req))?.outline?.trim();
-				if (outline !== void 0 && outline.length >= 50) {
-					project.outline = outline;
-					project.bookName = createProject(outline).bookName;
-				}
-				project.bible = void 0;
-				project.volumes = void 0;
-				project.chapters = [];
-				project.foreshadows = [];
-				project.assets = emptyProjectAssets();
-				project.facts = [];
+			const outline = (await readJsonBody(req))?.outline?.trim();
+			if (outline !== void 0 && outline.length >= 50) {
+				project.outline = outline;
+				project.bookName = createProject(outline).bookName;
+			}
+			project.bible = void 0;
+			project.volumes = void 0;
+			project.chapters = [];
+			project.foreshadows = [];
+			project.assets = emptyProjectAssets();
+			project.facts = [];
+			project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+			saveProject(config.outputDir, project);
+			writeJson(res, 200, {
+				ok: true,
+				bookName: project.bookName
+			});
+		}
+	};
+	const bookshelfActivateRoute = {
+		kind: "exact",
+		path: "/api/dsh-novel-forge/bookshelf/activate",
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const body = await readJsonBody(req);
+			if (body?.id === void 0 || body.id === "") {
+				writeJson(res, 400, { error: "id 不能为空" });
+				return;
+			}
+			if (activateBook(body.id) === void 0) {
+				writeJson(res, 404, { error: `书 ${body.id} 不存在` });
+				return;
+			}
+			writeJson(res, 200, bookshelfSnapshot(loadBookshelf()));
+		}
+	};
+	const bookshelfRemoveRoute = {
+		kind: "exact",
+		path: "/api/dsh-novel-forge/bookshelf/remove",
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const body = await readJsonBody(req);
+			if (body?.id === void 0 || body.id === "") {
+				writeJson(res, 400, { error: "id 不能为空" });
+				return;
+			}
+			if (!removeBook(body.id)) {
+				writeJson(res, 404, { error: `书 ${body.id} 不存在` });
+				return;
+			}
+			writeJson(res, 200, bookshelfSnapshot(loadBookshelf()));
+		}
+	};
+	/** 全书一致性质检。 */
+	const auditRoute = {
+		kind: "exact",
+		path: NOVEL_API.audit,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const config = getConfig();
+			const project = requireProject(res);
+			if (project === void 0) return;
+			try {
+				writeJson(res, 200, {
+					issues: await auditBook(ctx, config, project, config.outputDir),
+					auditedChapters: project.chapters.filter((c) => c.status !== "pending" && c.status !== "generating").length,
+					auditedAt: (/* @__PURE__ */ new Date()).toISOString()
+				});
+			} catch (error) {
+				writeJson(res, 500, { error: error.message });
+			}
+		}
+	};
+	/** 角色卡刷新（出场统计精确化 + LLM 聚合状态）。 */
+	const charactersRefreshRoute = {
+		kind: "exact",
+		path: NOVEL_API.charactersRefresh,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const config = getConfig();
+			const project = requireProject(res);
+			if (project === void 0) return;
+			try {
+				const cards = await refreshCharacters(ctx, config, project, config.outputDir);
+				project.roleStatus = cards;
 				project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
 				saveProject(config.outputDir, project);
+				writeJson(res, 200, { cards });
+			} catch (error) {
+				writeJson(res, 500, { error: error.message });
+			}
+		}
+	};
+	/** 事实库回填：对历史已生成章节批量抽取事实。 */
+	const factsBackfillRoute = {
+		kind: "exact",
+		path: NOVEL_API.factsBackfill,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const config = getConfig();
+			const project = requireProject(res);
+			if (project === void 0) return;
+			try {
 				writeJson(res, 200, {
 					ok: true,
-					bookName: project.bookName
+					filled: await backfillFacts(ctx, config, project, config.outputDir)
 				});
+			} catch (error) {
+				writeJson(res, 500, { error: error.message });
 			}
-		},
-		{
-			kind: "exact",
-			path: NOVEL_API.audit,
-			handler: async (req, res) => {
-				if (!guard(req, res, "POST")) return;
-				const config = getConfig();
-				const project = requireProject(res);
-				if (project === void 0) return;
-				try {
-					writeJson(res, 200, {
-						issues: await auditBook(ctx, config, project, config.outputDir),
-						auditedChapters: project.chapters.filter((c) => c.status !== "pending" && c.status !== "generating").length,
-						auditedAt: (/* @__PURE__ */ new Date()).toISOString()
-					});
-				} catch (error) {
-					writeJson(res, 500, { error: error.message });
-				}
+		}
+	};
+	/** 设定圣经局部修补（世界观规则/红线/风格）。 */
+	const biblePatchRoute = {
+		kind: "exact",
+		path: NOVEL_API.biblePatch,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const config = getConfig();
+			const project = requireProject(res);
+			if (project === void 0) return;
+			if (project.bible === void 0) {
+				writeJson(res, 400, { error: "尚未生成道藏，请先生成" });
+				return;
 			}
-		},
-		{
-			kind: "exact",
-			path: NOVEL_API.charactersRefresh,
-			handler: async (req, res) => {
-				if (!guard(req, res, "POST")) return;
-				const config = getConfig();
-				const project = requireProject(res);
-				if (project === void 0) return;
-				try {
-					writeJson(res, 200, { cards: await refreshCharacters(ctx, config, project, config.outputDir) });
-				} catch (error) {
-					writeJson(res, 500, { error: error.message });
+			const body = await readJsonBody(req);
+			if (Array.isArray(body?.worldRules)) project.bible.worldRules = body.worldRules.filter((r) => r.trim() !== "");
+			if (Array.isArray(body?.redLines)) project.bible.redLines = body.redLines.filter((r) => r.trim() !== "");
+			if (Array.isArray(body?.style)) project.bible.style = body.style.filter((r) => r.trim() !== "");
+			if (Array.isArray(body?.characters)) project.bible.characters = body.characters.filter((c) => c !== void 0 && c !== null && typeof c.name === "string" && c.name.trim() !== "").map((c) => ({
+				name: c.name.trim(),
+				role: [
+					"protagonist",
+					"supporting",
+					"antagonist",
+					"other"
+				].includes(c.role) ? c.role : "other",
+				traits: Array.isArray(c.traits) ? c.traits.filter((t) => typeof t === "string" && t.trim() !== "") : [],
+				goals: typeof c.goals === "string" ? c.goals : "",
+				relations: typeof c.relations === "string" ? c.relations : "",
+				knowledge: Array.isArray(c.knowledge) ? c.knowledge.filter((k) => typeof k === "string" && k.trim() !== "") : void 0
+			}));
+			project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+			saveProject(config.outputDir, project);
+			writeJson(res, 200, { bible: project.bible });
+		}
+	};
+	/** 小说简介：AI 生成/补全，或手动保存。 */
+	const blurbRoute = {
+		kind: "exact",
+		path: NOVEL_API.blurb,
+		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);
+			try {
+				if (body?.action === "save") {
+					const text = body.text?.trim() ?? "";
+					project.blurb = text;
+					project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+					saveProject(config.outputDir, project);
+					writeJson(res, 200, { blurb: text });
+					return;
 				}
+				const partial = body?.partial?.trim() ?? "";
+				const blurb = await generateBlurb(ctx, config, project, partial);
+				project.blurb = blurb;
+				project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+				saveProject(config.outputDir, project);
+				writeJson(res, 200, { blurb });
+			} catch (error) {
+				writeJson(res, 500, { error: error.message });
 			}
-		},
-		{
-			kind: "exact",
-			path: NOVEL_API.factsBackfill,
-			handler: async (req, res) => {
-				if (!guard(req, res, "POST")) return;
-				const config = getConfig();
-				const project = requireProject(res);
-				if (project === void 0) return;
-				try {
-					writeJson(res, 200, {
-						ok: true,
-						filled: await backfillFacts(ctx, config, project, config.outputDir)
-					});
-				} catch (error) {
-					writeJson(res, 500, { error: error.message });
+		}
+	};
+	/** 封面：GET 读取（dataUrl）；POST 上传（base64）或移除。 */
+	const coverRoute = {
+		kind: "exact",
+		path: NOVEL_API.cover,
+		handler: async (req, res) => {
+			const config = getConfig();
+			if (req.method === "GET") {
+				if (!isLoopbackRequest(req)) {
+					writeJson(res, 403, { error: "forbidden: loopback-only" });
+					return;
 				}
-			}
-		},
-		{
-			kind: "exact",
-			path: NOVEL_API.biblePatch,
-			handler: async (req, res) => {
-				if (!guard(req, res, "POST")) return;
-				const config = getConfig();
-				const project = requireProject(res);
-				if (project === void 0) return;
-				if (project.bible === void 0) {
-					writeJson(res, 400, { error: "尚未生成道藏，请先生成" });
+				const dirParam = new URL(req.url ?? "/", "http://localhost").searchParams.get("dir");
+				const targetDir = dirParam !== null && dirParam !== "" ? dirParam : config.outputDir;
+				const coverPath = loadProject(targetDir)?.coverPath;
+				if (coverPath === void 0 || coverPath === "") {
+					writeJson(res, 200, { dataUrl: null });
 					return;
 				}
-				const body = await readJsonBody(req);
-				if (Array.isArray(body?.worldRules)) project.bible.worldRules = body.worldRules.filter((r) => r.trim() !== "");
-				if (Array.isArray(body?.redLines)) project.bible.redLines = body.redLines.filter((r) => r.trim() !== "");
-				if (Array.isArray(body?.style)) project.bible.style = body.style.filter((r) => r.trim() !== "");
-				if (Array.isArray(body?.characters)) project.bible.characters = body.characters.filter((c) => c !== void 0 && c !== null && typeof c.name === "string" && c.name.trim() !== "").map((c) => ({
-					name: c.name.trim(),
-					role: [
-						"protagonist",
-						"supporting",
-						"antagonist",
-						"other"
-					].includes(c.role) ? c.role : "other",
-					traits: Array.isArray(c.traits) ? c.traits.filter((t) => typeof t === "string" && t.trim() !== "") : [],
-					goals: typeof c.goals === "string" ? c.goals : "",
-					relations: typeof c.relations === "string" ? c.relations : "",
-					knowledge: Array.isArray(c.knowledge) ? c.knowledge.filter((k) => typeof k === "string" && k.trim() !== "") : void 0
-				}));
-				project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-				saveProject(config.outputDir, project);
-				writeJson(res, 200, { bible: project.bible });
+				const file = join(targetDir, coverPath);
+				if (!existsSync(file)) {
+					writeJson(res, 200, { dataUrl: null });
+					return;
+				}
+				writeJson(res, 200, { dataUrl: `data:${coverPath.toLowerCase().endsWith(".png") ? "image/png" : coverPath.toLowerCase().endsWith(".jpg") || coverPath.toLowerCase().endsWith(".jpeg") ? "image/jpeg" : coverPath.toLowerCase().endsWith(".webp") ? "image/webp" : "image/png"};base64,${readFileSync(file).toString("base64")}` });
+				return;
 			}
-		},
-		{
-			kind: "exact",
-			path: NOVEL_API.blurb,
-			handler: async (req, res) => {
+			if (req.method === "POST") {
 				if (!guard(req, res, "POST")) return;
-				const config = getConfig();
 				const project = requireProject(res);
 				if (project === void 0) return;
 				const body = await readJsonBody(req);
 				try {
-					if (body?.action === "save") {
-						const text = body.text?.trim() ?? "";
-						project.blurb = text;
-						project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-						saveProject(config.outputDir, project);
-						writeJson(res, 200, { blurb: text });
-						return;
-					}
-					const partial = body?.partial?.trim() ?? "";
-					const blurb = await generateBlurb(ctx, config, project, partial);
-					project.blurb = blurb;
-					project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-					saveProject(config.outputDir, project);
-					writeJson(res, 200, { blurb });
-				} catch (error) {
-					writeJson(res, 500, { error: error.message });
-				}
-			}
-		},
-		{
-			kind: "exact",
-			path: NOVEL_API.cover,
-			handler: async (req, res) => {
-				const config = getConfig();
-				if (req.method === "GET") {
-					if (!isLoopbackRequest(req)) {
-						writeJson(res, 403, { error: "forbidden: loopback-only" });
-						return;
-					}
-					const dirParam = new URL(req.url ?? "/", "http://localhost").searchParams.get("dir");
-					const targetDir = dirParam !== null && dirParam !== "" ? dirParam : config.outputDir;
-					const coverPath = loadProject(targetDir)?.coverPath;
-					if (coverPath === void 0 || coverPath === "") {
-						writeJson(res, 200, { dataUrl: null });
-						return;
-					}
-					const file = join(targetDir, coverPath);
-					if (!existsSync(file)) {
-						writeJson(res, 200, { dataUrl: null });
-						return;
-					}
-					writeJson(res, 200, { dataUrl: `data:${coverPath.toLowerCase().endsWith(".png") ? "image/png" : coverPath.toLowerCase().endsWith(".jpg") || coverPath.toLowerCase().endsWith(".jpeg") ? "image/jpeg" : coverPath.toLowerCase().endsWith(".webp") ? "image/webp" : "image/png"};base64,${readFileSync(file).toString("base64")}` });
-					return;
-				}
-				if (req.method === "POST") {
-					if (!guard(req, res, "POST")) return;
-					const project = requireProject(res);
-					if (project === void 0) return;
-					const body = await readJsonBody(req);
-					try {
-						if (body?.action === "remove") {
-							if (project.coverPath !== void 0 && project.coverPath !== "") {
-								const oldFile = join(config.outputDir, project.coverPath);
-								if (existsSync(oldFile)) rmSync(oldFile, { force: true });
-							}
-							project.coverPath = void 0;
-							project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-							saveProject(config.outputDir, project);
-							writeJson(res, 200, {
-								ok: true,
-								coverPath: null
-							});
-							return;
-						}
-						const dataUrl = body?.dataUrl ?? "";
-						const match = /^data:(image\/(?:png|jpeg|jpg|webp));base64,(.+)$/s.exec(dataUrl);
-						if (match === null) {
-							writeJson(res, 400, { error: "封面须为 PNG/JPEG/WebP 的 base64 data URL" });
-							return;
-						}
-						const mime = match[1];
-						const fileName = `cover.${mime === "image/png" ? "png" : mime === "image/webp" ? "webp" : "jpg"}`;
-						const targetPath = join(config.outputDir, fileName);
-						const oldPath = project.coverPath;
-						mkdirSync(config.outputDir, { recursive: true });
-						writeFileSync(targetPath, Buffer.from(match[2], "base64"));
-						if (oldPath !== void 0 && oldPath !== "" && oldPath !== fileName) {
-							const oldFile = join(config.outputDir, oldPath);
+					if (body?.action === "remove") {
+						if (project.coverPath !== void 0 && project.coverPath !== "") {
+							const oldFile = join(config.outputDir, project.coverPath);
 							if (existsSync(oldFile)) rmSync(oldFile, { force: true });
 						}
-						project.coverPath = fileName;
+						project.coverPath = void 0;
 						project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
 						saveProject(config.outputDir, project);
 						writeJson(res, 200, {
 							ok: true,
-							coverPath: fileName
+							coverPath: null
 						});
-					} catch (error) {
-						writeJson(res, 500, { error: error.message });
+						return;
 					}
-					return;
-				}
-				writeJson(res, 405, { error: "method not allowed (expected GET or POST)" });
-			}
-		},
-		{
-			kind: "exact",
-			path: NOVEL_API.world,
-			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);
-				try {
-					if (body?.action === "save" && body.world !== void 0) {
-						project.world = {
-							realms: Array.isArray(body.world.realms) ? body.world.realms : [],
-							regions: Array.isArray(body.world.regions) ? body.world.regions : [],
-							factions: Array.isArray(body.world.factions) ? body.world.factions : []
-						};
-						project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-						saveProject(config.outputDir, project);
-						writeJson(res, 200, { world: project.world });
+					const dataUrl = body?.dataUrl ?? "";
+					const match = /^data:(image\/(?:png|jpeg|jpg|webp));base64,(.+)$/s.exec(dataUrl);
+					if (match === null) {
+						writeJson(res, 400, { error: "封面须为 PNG/JPEG/WebP 的 base64 data URL" });
 						return;
 					}
-					const world = await extractWorld(ctx, config, project);
-					project.world = world;
+					const mime = match[1];
+					const fileName = `cover.${mime === "image/png" ? "png" : mime === "image/webp" ? "webp" : "jpg"}`;
+					const targetPath = join(config.outputDir, fileName);
+					const oldPath = project.coverPath;
+					mkdirSync(config.outputDir, { recursive: true });
+					writeFileSync(targetPath, Buffer.from(match[2], "base64"));
+					if (oldPath !== void 0 && oldPath !== "" && oldPath !== fileName) {
+						const oldFile = join(config.outputDir, oldPath);
+						if (existsSync(oldFile)) rmSync(oldFile, { force: true });
+					}
+					project.coverPath = fileName;
 					project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
 					saveProject(config.outputDir, project);
-					writeJson(res, 200, { world });
+					writeJson(res, 200, {
+						ok: true,
+						coverPath: fileName
+					});
 				} catch (error) {
 					writeJson(res, 500, { error: error.message });
 				}
+				return;
 			}
-		},
-		{
-			kind: "exact",
-			path: NOVEL_API.rename,
-			handler: async (req, res) => {
-				if (!guard(req, res, "POST")) return;
-				const config = getConfig();
-				const project = requireProject(res);
-				if (project === void 0) return;
-				const bookName = (await readJsonBody(req))?.bookName?.trim();
-				if (bookName === void 0 || bookName === "") {
-					writeJson(res, 400, { error: "书名不能为空" });
+			writeJson(res, 405, { error: "method not allowed (expected GET or POST)" });
+		}
+	};
+	/** 大世界：AI 提炼或手动保存（境界体系/区域/势力）。 */
+	const worldRoute = {
+		kind: "exact",
+		path: NOVEL_API.world,
+		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);
+			try {
+				if (body?.action === "save" && body.world !== void 0) {
+					project.world = {
+						realms: Array.isArray(body.world.realms) ? body.world.realms : [],
+						regions: Array.isArray(body.world.regions) ? body.world.regions : [],
+						factions: Array.isArray(body.world.factions) ? body.world.factions : []
+					};
+					project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+					saveProject(config.outputDir, project);
+					writeJson(res, 200, { world: project.world });
 					return;
 				}
-				project.bookName = bookName.slice(0, 60);
+				const world = await extractWorld(ctx, config, project);
+				project.world = world;
 				project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
 				saveProject(config.outputDir, project);
-				const store = loadBookshelf();
-				if (store.activeBookId !== null) renameBook(store.activeBookId, project.bookName);
-				writeJson(res, 200, { bookName: project.bookName });
+				writeJson(res, 200, { world });
+			} catch (error) {
+				writeJson(res, 500, { error: error.message });
 			}
-		},
-		{
-			kind: "exact",
-			path: NOVEL_API.plotlines,
-			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.plotlines === void 0) project.plotlines = [];
-				const op = body?.op;
-				if (op === "add" && body?.line !== void 0) {
+		}
+	};
+	/** 重命名当前书：同步项目 bookName 与书架条目。 */
+	const renameRoute = {
+		kind: "exact",
+		path: NOVEL_API.rename,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const config = getConfig();
+			const project = requireProject(res);
+			if (project === void 0) return;
+			const bookName = (await readJsonBody(req))?.bookName?.trim();
+			if (bookName === void 0 || bookName === "") {
+				writeJson(res, 400, { error: "书名不能为空" });
+				return;
+			}
+			project.bookName = bookName.slice(0, 60);
+			project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+			saveProject(config.outputDir, project);
+			const store = loadBookshelf();
+			if (store.activeBookId !== null) renameBook(store.activeBookId, project.bookName);
+			writeJson(res, 200, { bookName: project.bookName });
+		}
+	};
+	/** 剧情线管理：增删改 + 关联章节（主线/支线/人物线/悬念线）。 */
+	const plotlinesRoute = {
+		kind: "exact",
+		path: NOVEL_API.plotlines,
+		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.plotlines === void 0) project.plotlines = [];
+			const op = body?.op;
+			if (op === "add" && body?.line !== void 0) {
+				const line = body.line;
+				project.plotlines.push({
+					id: line.id !== "" ? line.id : `pl-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`,
+					name: line.name.slice(0, 40),
+					kind: line.kind,
+					goal: line.goal.slice(0, 300),
+					progress: line.progress.slice(0, 300),
+					status: line.status,
+					chapters: Array.isArray(line.chapters) ? line.chapters.filter((n) => typeof n === "number") : [],
+					createdAt: line.createdAt !== "" ? line.createdAt : (/* @__PURE__ */ new Date()).toISOString()
+				});
+			} else if (op === "update" && body?.line !== void 0 && body.line.id !== "") {
+				const idx = project.plotlines.findIndex((l) => l.id === body.line.id);
+				if (idx !== -1) {
 					const line = body.line;
-					project.plotlines.push({
-						id: line.id !== "" ? line.id : `pl-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`,
+					project.plotlines[idx] = {
+						...project.plotlines[idx],
 						name: line.name.slice(0, 40),
 						kind: line.kind,
 						goal: line.goal.slice(0, 300),
 						progress: line.progress.slice(0, 300),
-						status: line.status,
-						chapters: Array.isArray(line.chapters) ? line.chapters.filter((n) => typeof n === "number") : [],
-						createdAt: line.createdAt !== "" ? line.createdAt : (/* @__PURE__ */ new Date()).toISOString()
-					});
-				} else if (op === "update" && body?.line !== void 0 && body.line.id !== "") {
-					const idx = project.plotlines.findIndex((l) => l.id === body.line.id);
-					if (idx !== -1) {
-						const line = body.line;
-						project.plotlines[idx] = {
-							...project.plotlines[idx],
-							name: line.name.slice(0, 40),
-							kind: line.kind,
-							goal: line.goal.slice(0, 300),
-							progress: line.progress.slice(0, 300),
-							status: line.status
-						};
-					}
-				} else if (op === "remove" && body?.id !== void 0) project.plotlines = project.plotlines.filter((l) => l.id !== body.id);
-				else if (op === "link" && body?.id !== void 0 && typeof body.chapterNo === "number" && body.chapterNo > 0) {
-					const line = project.plotlines.find((l) => l.id === body.id);
-					if (line !== void 0 && !line.chapters.includes(body.chapterNo)) {
-						line.chapters.push(body.chapterNo);
-						if (line.status === "active" && line.progress === "") line.progress = `推进至第 ${body.chapterNo} 章`;
-					}
-				} else if (op === "suggest") try {
-					const suggestions = await suggestPlotlines(ctx, config, project);
-					writeJson(res, 200, {
-						plotlines: project.plotlines,
-						suggestions
-					});
-					return;
-				} catch (error) {
-					writeJson(res, 500, { error: `AI 建议失败：${error.message}` });
-					return;
+						status: line.status
+					};
 				}
-				else if (op === "refresh" && body?.id !== void 0) {
-					const line = project.plotlines.find((l) => l.id === body.id);
-					if (line === void 0) {
-						writeJson(res, 404, { error: "剧情线不存在" });
-						return;
-					}
-					try {
-						line.progress = await refreshPlotlineProgress(ctx, config, project, line);
-						project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-						saveProject(config.outputDir, project);
-						writeJson(res, 200, { plotlines: project.plotlines });
-						return;
-					} catch (error) {
-						writeJson(res, 500, { error: `刷新进度失败：${error.message}` });
-						return;
-					}
-				} else if (op === "health") try {
-					const health = await analyzePlotlineHealth(ctx, config, project);
-					writeJson(res, 200, {
-						plotlines: project.plotlines,
-						health
-					});
-					return;
-				} catch (error) {
-					writeJson(res, 500, { error: `健康检查失败：${error.message}` });
+			} else if (op === "remove" && body?.id !== void 0) project.plotlines = project.plotlines.filter((l) => l.id !== body.id);
+			else if (op === "link" && body?.id !== void 0 && typeof body.chapterNo === "number" && body.chapterNo > 0) {
+				const line = project.plotlines.find((l) => l.id === body.id);
+				if (line !== void 0 && !line.chapters.includes(body.chapterNo)) {
+					line.chapters.push(body.chapterNo);
+					if (line.status === "active" && line.progress === "") line.progress = `推进至第 ${body.chapterNo} 章`;
+				}
+			} else if (op === "suggest") try {
+				const suggestions = await suggestPlotlines(ctx, config, project);
+				writeJson(res, 200, {
+					plotlines: project.plotlines,
+					suggestions
+				});
+				return;
+			} catch (error) {
+				writeJson(res, 500, { error: `AI 建议失败：${error.message}` });
+				return;
+			}
+			else if (op === "refresh" && body?.id !== void 0) {
+				const line = project.plotlines.find((l) => l.id === body.id);
+				if (line === void 0) {
+					writeJson(res, 404, { error: "剧情线不存在" });
 					return;
 				}
-				else if (op === "plan") try {
-					const health = await analyzePlotlineHealth(ctx, config, project);
-					const plan = await designPlotlinePlan(ctx, config, project, health);
-					writeJson(res, 200, {
-						plotlines: project.plotlines,
-						health,
-						plan
-					});
+				try {
+					line.progress = await refreshPlotlineProgress(ctx, config, project, line);
+					project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+					saveProject(config.outputDir, project);
+					writeJson(res, 200, { plotlines: project.plotlines });
 					return;
 				} catch (error) {
-					writeJson(res, 500, { error: `剧情方案生成失败：${error.message}` });
+					writeJson(res, 500, { error: `刷新进度失败：${error.message}` });
 					return;
 				}
-				project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-				saveProject(config.outputDir, project);
-				writeJson(res, 200, { plotlines: project.plotlines });
+			} else if (op === "health") try {
+				const health = await analyzePlotlineHealth(ctx, config, project);
+				writeJson(res, 200, {
+					plotlines: project.plotlines,
+					health
+				});
+				return;
+			} catch (error) {
+				writeJson(res, 500, { error: `健康检查失败：${error.message}` });
+				return;
 			}
-		},
-		{
-			kind: "exact",
-			path: NOVEL_API.sensitiveCheck,
-			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 hits = [];
-				let scanned = 0;
-				if (body?.text !== void 0) for (const hit of checkSensitiveText(body.text)) hits.push({
-					chapterNo: 0,
+			else if (op === "plan") try {
+				const health = await analyzePlotlineHealth(ctx, config, project);
+				const plan = await designPlotlinePlan(ctx, config, project, health);
+				writeJson(res, 200, {
+					plotlines: project.plotlines,
+					health,
+					plan
+				});
+				return;
+			} catch (error) {
+				writeJson(res, 500, { error: `剧情方案生成失败：${error.message}` });
+				return;
+			}
+			project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+			saveProject(config.outputDir, project);
+			writeJson(res, 200, { plotlines: project.plotlines });
+		}
+	};
+	/** 敏感词检查：指定章节 / 任意文本 / 全书已写章节。 */
+	const sensitiveRoute = {
+		kind: "exact",
+		path: NOVEL_API.sensitiveCheck,
+		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 hits = [];
+			let scanned = 0;
+			if (body?.text !== void 0) for (const hit of checkSensitiveText(body.text)) hits.push({
+				chapterNo: 0,
+				word: hit.word,
+				category: hit.category,
+				count: hit.count
+			});
+			else if (typeof body?.chapterNo === "number") {
+				const chapter = project.chapters.find((c) => c.no === body.chapterNo);
+				if (chapter !== void 0) {
+					const text = readChapterFile(config.outputDir, chapter);
+					if (text !== void 0) {
+						scanned = 1;
+						for (const hit of checkSensitiveText(text)) hits.push({
+							chapterNo: chapter.no,
+							word: hit.word,
+							category: hit.category,
+							count: hit.count
+						});
+					}
+				}
+			} else if (body?.all === true) for (const chapter of project.chapters) {
+				if (chapter.status === "pending" || chapter.status === "generating") continue;
+				const text = readChapterFile(config.outputDir, chapter);
+				if (text === void 0) continue;
+				scanned++;
+				for (const hit of checkSensitiveText(text)) hits.push({
+					chapterNo: chapter.no,
 					word: hit.word,
 					category: hit.category,
 					count: hit.count
 				});
-				else if (typeof body?.chapterNo === "number") {
-					const chapter = project.chapters.find((c) => c.no === body.chapterNo);
-					if (chapter !== void 0) {
-						const text = readChapterFile(config.outputDir, chapter);
-						if (text !== void 0) {
-							scanned = 1;
-							for (const hit of checkSensitiveText(text)) hits.push({
-								chapterNo: chapter.no,
-								word: hit.word,
-								category: hit.category,
-								count: hit.count
-							});
-						}
-					}
-				} else if (body?.all === true) for (const chapter of project.chapters) {
-					if (chapter.status === "pending" || chapter.status === "generating") continue;
-					const text = readChapterFile(config.outputDir, chapter);
-					if (text === void 0) continue;
-					scanned++;
-					for (const hit of checkSensitiveText(text)) hits.push({
-						chapterNo: chapter.no,
-						word: hit.word,
-						category: hit.category,
-						count: hit.count
-					});
-				}
-				else {
-					writeJson(res, 400, { error: "请提供 chapterNo / text / all 之一" });
-					return;
-				}
+			}
+			else {
+				writeJson(res, 400, { error: "请提供 chapterNo / text / all 之一" });
+				return;
+			}
+			writeJson(res, 200, {
+				hits,
+				scannedChapters: scanned
+			});
+		}
+	};
+	/** 角色库：AI 提炼 / 采纳 / 更新 / 删除。 */
+	const rolesRoute = {
+		kind: "exact",
+		path: NOVEL_API.roles,
+		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.roles === void 0) project.roles = [];
+			const op = body?.op;
+			if (op === "extract") try {
+				const candidates = await extractRoles(ctx, config, project);
 				writeJson(res, 200, {
-					hits,
-					scannedChapters: scanned
+					roles: project.roles,
+					candidates
 				});
+				return;
+			} catch (error) {
+				writeJson(res, 500, { error: `角色提炼失败：${error.message}` });
+				return;
 			}
-		},
+			else if ((op === "adopt" || op === "update") && body?.role !== void 0) {
+				const r = body.role;
+				const idx = project.roles.findIndex((x) => x.name === r.name);
+				if (idx === -1) project.roles.push(r);
+				else project.roles[idx] = r;
+			} else if (op === "remove" && body?.name !== void 0) project.roles = project.roles.filter((x) => x.name !== body.name);
+			project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+			saveProject(config.outputDir, project);
+			writeJson(res, 200, { roles: project.roles });
+		}
+	};
+	/** 章节复位：generating 卡死 → pending（可重新生成）。 */
+	const chapterResetRoute = {
+		kind: "exact",
+		path: NOVEL_API.chapterReset,
+		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;
+			}
+			const chapter = project.chapters.find((c) => c.no === no);
+			if (chapter === void 0) {
+				writeJson(res, 404, { error: `章节 ${no} 不在计划中` });
+				return;
+			}
+			chapter.status = "pending";
+			chapter.error = void 0;
+			chapter.generatingAt = void 0;
+			project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+			saveProject(config.outputDir, project);
+			writeJson(res, 200, {
+				ok: true,
+				no
+			});
+		}
+	};
+	return [
+		statusRoute,
+		loadOutlineRoute,
+		saveOutlineRoute,
+		bibleRoute,
+		volumesRoute,
+		planRoute,
+		generateRoute,
+		reviewRoute,
+		rewriteRoute,
+		polishRoute,
+		draftApplyRoute,
+		draftDiscardRoute,
+		summaryRoute,
+		foreshadowRoute,
+		exportRoute,
+		chapterRoute,
+		chapterCheckRoute,
+		chapterSaveRoute,
+		assetsRoute,
+		styleEngineRoute,
+		assistantRoute,
+		assistantHistoryRoute,
+		assistantClearRoute,
+		bookshelfRoute,
+		bookshelfActivateRoute,
+		bookshelfRemoveRoute,
+		resetRoute,
+		auditRoute,
+		charactersRefreshRoute,
+		factsBackfillRoute,
+		biblePatchRoute,
+		blurbRoute,
+		coverRoute,
+		worldRoute,
+		renameRoute,
+		plotlinesRoute,
+		rolesRoute,
+		sensitiveRoute,
 		{
 			kind: "exact",
 			path: NOVEL_API.reviewBackfill,
@@ -4914,6 +5132,7 @@ function makeRoutes(deps) {
 				res.end();
 			}
 		},
+		chapterResetRoute,
 		{
 			kind: "exact",
 			path: NOVEL_API.config,