@waterwx/dsh-novel-forge 1.8.0 → 1.10.0

package/lib/index.js

@@ -1,4 +1,4 @@
-import { homedir } from "node:os";
+import { homedir, tmpdir } from "node:os";
 import { basename, extname, join } from "node:path";
 import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
 import z from "schemastery";
@@ -529,6 +529,157 @@ const BUILTIN_PROGRESSION_MODES = [
 		primary: false
 	}
 ];
+/** 剧情桥段库：可复用情节套路（作者阅读经验沉淀，非某本书的剧情线）。 */
+const BUILTIN_PLOT_BEATS = [
+	{
+		key: "play-weak",
+		name: "扮猪吃虎",
+		category: "装逼打脸",
+		summary: "主角示弱/隐藏实力，关键时刻亮出獠牙，反差打脸。",
+		position: "前期/中期",
+		preconditions: ["主角有远超表面的实力", "有旁观者低估他"],
+		payoffSource: [
+			"身份反差",
+			"实力揭晓时众人错愕",
+			"质疑者被打脸"
+		],
+		combos: ["打脸", "身份揭露"],
+		taboos: ["示弱太久读者憋屈", "反转无铺垫"],
+		applicableGenres: [
+			"都市",
+			"玄幻",
+			"仙侠"
+		]
+	},
+	{
+		key: "face-slap",
+		name: "打脸",
+		category: "装逼打脸",
+		summary: "挑衅者趾高气扬，主角一击让其灰头土脸，情绪宣泄。",
+		position: "任何",
+		preconditions: ["挑衅者有明确的优越感", "主角有强出一截的底牌"],
+		payoffSource: ["当众羞辱反杀", "围观者态度反转"],
+		combos: ["扮猪吃虎", "大比"],
+		taboos: ["连续无新意打脸", "羞辱过头读者不适"],
+		applicableGenres: [
+			"都市",
+			"玄幻",
+			"仙侠"
+		]
+	},
+	{
+		key: "broken-engagement",
+		name: "退婚/反悔",
+		category: "身份逆袭",
+		summary: "被退婚/被轻视→用实力打回，顺势立目标。",
+		position: "开局/前期",
+		preconditions: ["主角处于弱势", "退婚方势利"],
+		payoffSource: ["被轻贱→反杀", "立下目标"],
+		combos: ["打脸", "金手指亮相"],
+		taboos: ["拖大几十章才洗", "女主误会太久"],
+		applicableGenres: [
+			"玄幻",
+			"都市",
+			"豪门"
+		]
+	},
+	{
+		key: "auction-bargain",
+		name: "拍卖会捡漏",
+		category: "机缘",
+		summary: "主角在拍卖会上用独到眼光/信息差捞到被低估的宝物。",
+		position: "中期",
+		preconditions: ["主角有识货能力/金手指", "现场有争夺者"],
+		payoffSource: ["捡漏爽", "争夺者懊悔"],
+		combos: ["渔翁得利", "宝物升级"],
+		taboos: ["全程顺风顺水无波折", "宝物无后续用处"],
+		applicableGenres: [
+			"玄幻",
+			"仙侠",
+			"都市"
+		]
+	},
+	{
+		key: "secret-realm",
+		name: "秘境/夺宝",
+		category: "机缘",
+		summary: "秘境开启，主角入内夺宝/悟道，或遇强敌/阴谋。",
+		position: "中期/后期",
+		preconditions: ["秘境有明确利益", "竞争者众多"],
+		payoffSource: ["机缘得宝", "危机中成长"],
+		combos: ["夺宝", "绝境翻盘"],
+		taboos: ["宝物白给", "危机虎头蛇尾"],
+		applicableGenres: [
+			"仙侠",
+			"玄幻",
+			"悬疑"
+		]
+	},
+	{
+		key: "misunderstanding",
+		name: "误会/解释不清",
+		category: "情感拉扯",
+		summary: "一方误解另一方的行为，情绪拉满后解开。",
+		position: "任何",
+		preconditions: ["信息不对称", "两方都在意关系"],
+		payoffSource: ["误会造痛", "和解破冰"],
+		combos: ["关系拉扯", "身份揭露"],
+		taboos: ["误会拖太久", "为虐而虐"],
+		applicableGenres: [
+			"都市",
+			"情感",
+			"古言"
+		]
+	},
+	{
+		key: "last-stand",
+		name: "绝境翻盘",
+		category: "战斗",
+		summary: "主角被逼到绝境，借助底牌/意志完成反杀。",
+		position: "高潮",
+		preconditions: ["主角实力明显劣势", "有破局底牌"],
+		payoffSource: ["绝处逢生", "反派嚣张后被打脸"],
+		combos: ["金手指爆发", "打脸"],
+		taboos: ["开挂太突兀", "翻盘无代价"],
+		applicableGenres: [
+			"玄幻",
+			"武侠",
+			"无限流"
+		]
+	},
+	{
+		key: "tournament",
+		name: "大比/比试",
+		category: "升级打脸",
+		summary: "宗门/势力大比，主角一路过关，暴露实力、收获名声。",
+		position: "中期/后期",
+		preconditions: ["有正式舞台", "有看客与对手"],
+		payoffSource: ["连胜升级", "众目睽睽下打脸"],
+		combos: ["打脸", "身份揭露"],
+		taboos: ["比赛水太多", "对手全送脸"],
+		applicableGenres: [
+			"仙侠",
+			"玄幻",
+			"体育竞技"
+		]
+	},
+	{
+		key: "identity-reveal",
+		name: "身份揭露",
+		category: "反转",
+		summary: "主角/配角的隐藏身份在关键时点揭开，颠覆认知。",
+		position: "中期/后期",
+		preconditions: ["身份有可埋伏的线索", "揭开时机能引爆情绪"],
+		payoffSource: ["认知颠覆", "立场反转"],
+		combos: ["打脸", "误会解开"],
+		taboos: ["毫无伏笔硬揭", "身份设定无意义"],
+		applicableGenres: [
+			"悬疑",
+			"古言",
+			"玄幻"
+		]
+	}
+];
 /** 默认（空）项目写作资产。 */
 function emptyProjectAssets() {
 	return {
@@ -1186,6 +1337,215 @@ function normalizeEmotions(text) {
 	return out;
 }
 //#endregion
+//#region src/protocol.ts
+/** The /api/dsh-novel-forge route family (same-origin, loopback-fenced). */
+const NOVEL_API = {
+	status: "/api/dsh-novel-forge/status",
+	loadOutline: "/api/dsh-novel-forge/load-outline",
+	saveOutline: "/api/dsh-novel-forge/save-outline",
+	plan: "/api/dsh-novel-forge/plan",
+	volumes: "/api/dsh-novel-forge/volumes",
+	bible: "/api/dsh-novel-forge/bible",
+	assets: "/api/dsh-novel-forge/assets",
+	styleEngine: "/api/dsh-novel-forge/style-engine",
+	generate: "/api/dsh-novel-forge/generate",
+	review: "/api/dsh-novel-forge/review",
+	rewrite: "/api/dsh-novel-forge/rewrite",
+	polish: "/api/dsh-novel-forge/polish",
+	/** 采纳待确认草稿（润色/重写产物）覆盖正文文件。 */
+	draftApply: "/api/dsh-novel-forge/draft/apply",
+	/** 放弃待确认草稿，保留原稿。 */
+	draftDiscard: "/api/dsh-novel-forge/draft/discard",
+	summary: "/api/dsh-novel-forge/summary",
+	foreshadow: "/api/dsh-novel-forge/foreshadow",
+	exportBook: "/api/dsh-novel-forge/export",
+	chapter: "/api/dsh-novel-forge/chapter",
+	/** 审查任意正文文本（作者手动编辑后，不落盘）。 */
+	chapterCheck: "/api/dsh-novel-forge/chapter/check",
+	/** 保存手动编辑的正文（自动备份 .bak）。 */
+	chapterSave: "/api/dsh-novel-forge/chapter/save",
+	assistant: "/api/dsh-novel-forge/assistant",
+	assistantHistory: "/api/dsh-novel-forge/assistant-history",
+	/** 清空助手对话记录。 */
+	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",
+	/** 漫剧方案管理：create/remove/activate。 */
+	manhuaPlans: "/api/dsh-novel-forge/manhua/plans",
+	/** 漫剧角色库：从分镜提名（规则+LLM两段式）/ 建卡 / 更新 / 删除 / 形象锚点 / 精修提示词。 */
+	mangaRoles: "/api/dsh-novel-forge/manga/roles",
+	/** 分镜·编剧级：单章 → 剧情骨架（节拍链）。 */
+	storyboardSkeleton: "/api/dsh-novel-forge/storyboard/skeleton",
+	/** 分镜·导演级：骨架 → 分镜表（镜头级）。 */
+	storyboardTable: "/api/dsh-novel-forge/storyboard/table",
+	/** 分镜·提示词级：分镜表 → 即梦可粘贴视频提示词。 */
+	storyboardPrompts: "/api/dsh-novel-forge/storyboard/prompts",
+	/** 生图接口连通性测试（设置页每个模型条目用）。 */
+	imageTest: "/api/dsh-novel-forge/image-test",
+	/** LLM 模型连通性测试：真实最小调用，验证 Key / 端点 / 模型可用。 */
+	llmTest: "/api/dsh-novel-forge/llm-test",
+	/** 添加模型：厂商直填 key 或自定义路由，写进 DSH 凭据与 llm-pi-ai 路由。 */
+	addModel: "/api/dsh-novel-forge/llm-add",
+	/** 运行时厂商目录（DSH pi-ai 可配置提供方 + 内置适配器）。 */
+	llmVendors: "/api/dsh-novel-forge/llm-vendors",
+	/** 查询某个 provider 当前可用的模型（添加成功后可即时刷新）。 */
+	llmModels: "/api/dsh-novel-forge/llm-models",
+	/** 已注册的提供方路由列表（提供方管理）。 */
+	llmProviders: "/api/dsh-novel-forge/llm-providers",
+	/** 移除一个提供方。 */
+	llmRemove: "/api/dsh-novel-forge/llm-remove",
+	/** 重置项目（可选携带新大纲）：清空设定/卷/章节/伏笔/资产/事实库。 */
+	reset: "/api/dsh-novel-forge/reset",
+	/** 全书一致性质检：LLM 扫描已生成章节，输出矛盾问题清单。 */
+	audit: "/api/dsh-novel-forge/audit",
+	/** 角色卡刷新：基于事实库与各章摘要聚合角色当前状态。 */
+	charactersRefresh: "/api/dsh-novel-forge/characters/refresh",
+	/** 事实库回填：对历史已生成章节批量抽取事实（旧章节无事实记录时用）。 */
+	factsBackfill: "/api/dsh-novel-forge/facts/backfill",
+	/** 设定圣经局部修补（如世界观规则编辑）。 */
+	biblePatch: "/api/dsh-novel-forge/bible/patch",
+	/** 小说简介：生成（AI）/补全（AI）/保存。 */
+	blurb: "/api/dsh-novel-forge/blurb",
+	/** 重命名当前书（同步项目与书架条目）。 */
+	rename: "/api/dsh-novel-forge/rename",
+	/** 大世界：AI 提炼 / 保存结构化数据（境界/区域/势力）。 */
+	world: "/api/dsh-novel-forge/world",
+	/** 封面：GET 读取（dataUrl）/ POST 上传或移除。 */
+	cover: "/api/dsh-novel-forge/blurb/cover",
+	/** 剧情线管理：增删改 + 关联章节。 */
+	plotlines: "/api/dsh-novel-forge/plotlines",
+	/** 角色库：AI 提炼 / 采纳 / 更新 / 删除。 */
+	roles: "/api/dsh-novel-forge/roles",
+	scenes: "/api/dsh-novel-forge/scenes",
+	visualRules: "/api/dsh-novel-forge/visual-rules",
+	/** 作者复盘补跑：对已写章节补齐 authorReview（全书流式 / 单章 JSON）。 */
+	reviewBackfill: "/api/dsh-novel-forge/review/backfill",
+	/** 章节复位：generating 卡死 → pending（可重新生成）。 */
+	chapterReset: "/api/dsh-novel-forge/chapter/reset",
+	/** 章节直接通过：作者对 rejected/written 章节行使最终决定权。 */
+	chapterApprove: "/api/dsh-novel-forge/chapter/approve",
+	/** 敏感词检查：全书已写章节或指定文本。 */
+	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）。 */
+	/** 漫剧分集计划：读一卷 → 按故事弧线分集（高潮拆集/过渡并章）。 */
+	/** 漫画脚本：章节 → 分页分格漫画脚本（含角色视觉锚点）。 */
+	/** 生产单：启动批量生产（计划补足 + 逐章生成 + 被拒分级处理）。 */
+	runStart: "/api/dsh-novel-forge/run/start",
+	/** 生产单控制：pause / resume / stop。 */
+	runControl: "/api/dsh-novel-forge/run/control",
+	/** 生产单状态（含进度统计与日志）。 */
+	runStatus: "/api/dsh-novel-forge/run/status",
+	config: "/api/dsh-novel-forge/config",
+	openFolder: "/api/dsh-novel-forge/open-folder",
+	/** 插件自更新：在 DSH profile 目录拉取最新 npm 版（下载后需重启 DSH 生效）。 */
+	pluginUpdate: "/api/dsh-novel-forge/plugin/update",
+	/** 作者资产库/总数据：读取个人跨书资产（笔法/红线/套路/角色模板/世界观模板）。 */
+	authorAssets: "/api/dsh-novel-forge/author-assets",
+	/** 作者资产库：新增/更新一条资产（upsert by id）。 */
+	authorAssetsUpsert: "/api/dsh-novel-forge/author-assets/upsert",
+	/** 作者资产库：删除一条资产。 */
+	authorAssetsRemove: "/api/dsh-novel-forge/author-assets/remove",
+	/** 作者资产库：导入默认（书架书的写作资产/角色 + 内置全局库）批量沉淀。 */
+	authorAssetsImportDefault: "/api/dsh-novel-forge/author-assets/import-default",
+	/** 改编模式：上传全文 → 分析 → 原文设定卡片/可改范围矩阵。 */
+	adaptAnalyze: "/api/dsh-novel-forge/adapt/analyze",
+	/** 改编模式：确认要改的维度 → 生成映射表/改编规则/联动影响清单。 */
+	adaptPropose: "/api/dsh-novel-forge/adapt/propose",
+	/** 改编模式：执行术语替换（全局替换 + 命中统计 + 改编文本预览）。 */
+	adaptExecute: "/api/dsh-novel-forge/adapt/execute",
+	/** 改编模式：保存改编全文为新书（原书保留，登记书架）。 */
+	adaptSave: "/api/dsh-novel-forge/adapt/save",
+	/** 改编模式：从源全文 + 编辑后方案提炼新书资料并保存为「待写新书」。 */
+	adaptMaterialize: "/api/dsh-novel-forge/adapt/materialize",
+	/** 改编模式：rewrite 逐章重写（NDJSON 流式进度）。 */
+	adaptRewriteStream: "/api/dsh-novel-forge/adapt/rewrite-stream",
+	/** 改编模式：把预览/微调后的新书资料写入并登记书架。 */
+	adaptMaterializeSave: "/api/dsh-novel-forge/adapt/materialize-save",
+	/** 主题自定义背景：上传图片（POST，存盘并返回服务端 URL）。 */
+	themeBackgroundUpload: "/api/dsh-novel-forge/theme/background",
+	/** 主题自定义背景：读取已上传文件（GET prefix，/theme/background/<name>）。 */
+	themeBackgroundGet: "/api/dsh-novel-forge/theme/background"
+};
+/** 预置的常见厂商（id=provider 路由；添加模型下拉兜底用，其余厂商由运行时目录动态补充）。 */
+const LLM_VENDORS = [
+	{
+		id: "deepseek-official",
+		name: "DeepSeek",
+		route: "deepseek-official",
+		apiKeyEnv: "DEEPSEEK_API_KEY",
+		defaultModel: "deepseek-v4-flash",
+		models: [
+			"deepseek-v4-flash",
+			"deepseek-v4-pro",
+			"deepseek-chat",
+			"deepseek-reasoner"
+		],
+		builtin: true
+	},
+	{
+		id: "zai-coding-cn",
+		name: "智谱 GLM",
+		route: "zai-coding-cn",
+		apiKeyEnv: "ZAI_CODING_CN_API_KEY",
+		defaultModel: "glm-5.3-flash",
+		models: [
+			"glm-4.5-air",
+			"glm-4.7",
+			"glm-5-turbo",
+			"glm-5.1",
+			"glm-5.2",
+			"glm-5.3",
+			"glm-5.3-flash",
+			"glm-5v-turbo"
+		]
+	},
+	{
+		id: "qwen-token-plan-cn",
+		name: "千问百炼",
+		route: "qwen-token-plan-cn",
+		apiKeyEnv: "QWEN_TOKEN_PLAN_CN_API_KEY",
+		defaultModel: "qwen3.7-max",
+		models: [
+			"qwen3.6-flash",
+			"qwen3.6-plus",
+			"qwen3.7-max",
+			"qwen3.7-plus",
+			"qwen3.8-max",
+			"qwen3.8-max-preview"
+		]
+	},
+	{
+		id: "openrouter",
+		name: "OpenRouter",
+		route: "openrouter",
+		apiKeyEnv: "OPENROUTER_API_KEY",
+		defaultModel: "z-ai/glm-5.3-flash",
+		models: [
+			"z-ai/glm-4.6",
+			"z-ai/glm-4.7",
+			"z-ai/glm-5",
+			"z-ai/glm-5-turbo",
+			"z-ai/glm-5.1",
+			"z-ai/glm-5.2",
+			"z-ai/glm-5.3-flash",
+			"auto",
+			"deepseek/deepseek-v4-flash",
+			"anthropic/claude-sonnet-4.6"
+		]
+	}
+];
+//#endregion
 //#region src/engine.ts
 /**
 * Novel engine — the host half's core: LLM-driven story-bible extraction,
@@ -3630,6 +3990,225 @@ async function testImageEndpoint(baseURL, apiKey, model) {
 		};
 	}
 }
+/** LLM 连通性失败的错误码 → 人话（供设置页“测试连通”回显）。 */
+const LLM_TEST_ERROR_HINT = {
+	NO_ADAPTER: "提供商路由不存在或未启用",
+	UNKNOWN_MODEL: "模型不在该提供商的目录里",
+	MISSING_CREDENTIAL: "API Key 未配置（检查 DSH 凭据里的引用）",
+	INVALID_CREDENTIAL: "API Key 格式无效",
+	AUTH: "认证失败：API Key 无效或无权限",
+	RATE_LIMIT: "触发提供商限流，请稍后再试",
+	QUOTA: "配额/余额不足",
+	CONTEXT_WINDOW_EXCEEDED: "上下文超限（测试调用不应触发，请核实模型配置）",
+	EMPTY_RESPONSE: "端点连通但返回空响应（模型可能暂不可用）",
+	TIMEOUT: "连接超时",
+	ABORTED: "测试超时（30 秒无响应）",
+	UNSUPPORTED_REASONING_EFFORT: "推理档位不受此模型支持"
+};
+function describeLlmTestError(err) {
+	const code = typeof err.code === "string" ? err.code : "";
+	const hint = code !== "" ? LLM_TEST_ERROR_HINT[code] : void 0;
+	const detail = err.message !== "" ? err.message : "未知错误";
+	return hint !== void 0 ? `${hint}（${detail}）` : detail;
+}
+/** 对选中的提供商/模型发一次最小真实调用（maxTokens=16），验证 Key / 端点 / 模型可用。 */
+async function testLlmModel(ctx, provider, model) {
+	const start = Date.now();
+	const request = {
+		provider,
+		model,
+		messages: [createUserMessage({
+			content: [{
+				type: "text",
+				text: "只回复两个字：OK"
+			}],
+			source: {
+				kind: "plugin",
+				plugin: "dsh-novel-forge"
+			}
+		})],
+		maxTokens: 16,
+		temperature: 0
+	};
+	const controller = new AbortController();
+	const timer = setTimeout(() => controller.abort(), 3e4);
+	try {
+		const assembler = new BlockAssembler();
+		let sawBlock = false;
+		for await (const chunk of ctx.llm.stream({
+			...request,
+			signal: controller.signal
+		})) {
+			assembler.push(chunk);
+			if (chunk.type === "block-end") {
+				sawBlock = true;
+				break;
+			}
+		}
+		if (sawBlock) return {
+			ok: true,
+			ms: Date.now() - start
+		};
+		const finish = assembler.finish;
+		if (finish !== void 0 && (finish.kind === "error" || finish.kind === "aborted")) {
+			const failure = finish.failure;
+			throw Object.assign(new Error(failure.message), { code: failure.code });
+		}
+		return {
+			ok: true,
+			ms: Date.now() - start
+		};
+	} catch (error) {
+		const err = error;
+		return {
+			ok: false,
+			ms: Date.now() - start,
+			code: err.code,
+			message: describeLlmTestError(err)
+		};
+	} finally {
+		clearTimeout(timer);
+	}
+}
+/** 确保 pi-ai 的一条 provider 路由存在（settings seam 深度合并，保留已有字段）。 */
+async function ensurePiAiProvider(ctx, route, cfg) {
+	const settings = ctx.get("settings");
+	if (settings === void 0) throw new Error("DSH settings 服务不可用，无法注册路由");
+	await settings.update("llm-pi-ai", { providers: { [route]: cfg } });
+}
+/** 运行时厂商目录：DSH pi-ai 可配置提供方 + 内置适配器，作为「添加模型」下拉。 */
+async function listLlmVendors(ctx) {
+	const map = /* @__PURE__ */ new Map();
+	for (const v of LLM_VENDORS) map.set(v.route, {
+		id: v.route,
+		name: v.name,
+		models: v.models,
+		apiKeyEnv: v.apiKeyEnv,
+		builtin: v.builtin
+	});
+	try {
+		for (const p of ctx.llm.listConfigurableProviders()) if (!map.has(p.provider)) map.set(p.provider, {
+			id: p.provider,
+			name: p.displayName !== "" ? p.displayName : p.provider,
+			models: [],
+			apiKeyEnv: "PI_AI_" + p.provider.toUpperCase().replace(/[^A-Z0-9]+/g, "_") + "_API_KEY"
+		});
+	} catch {}
+	try {
+		for (const p of ctx.llm.listProviders()) if (!map.has(p.id)) map.set(p.id, {
+			id: p.id,
+			name: p.name !== "" && p.name !== p.id ? p.name : p.id,
+			models: [],
+			builtin: true
+		});
+	} catch {}
+	return { vendors: [...map.values()] };
+}
+/** 查询某个 provider 当前可用模型（添加成功后可即时刷新下拉）。 */
+async function listLlmModels(ctx, provider) {
+	if (provider.trim() === "") return { models: [] };
+	try {
+		return { models: (await ctx.llm.listModels(provider.trim())).map((m) => ({
+			id: m.id,
+			name: m.name
+		})) };
+	} catch {
+		return { models: [] };
+	}
+}
+/** 当前已注册的提供方路由列表（提供方管理卡片）。 */
+async function listLlmProviders(ctx) {
+	try {
+		return { providers: ctx.llm.listProviders().map((p) => ({
+			id: p.id,
+			name: p.name !== "" && p.name !== p.id ? p.name : p.id
+		})) };
+	} catch {
+		return { providers: [{
+			id: "deepseek-official",
+			name: "DeepSeek"
+		}] };
+	}
+}
+/** 移除一个提供方：unset 凭据 ref + 移除 llm-pi-ai providers 路由。 */
+async function removeLlmProvider(ctx, req) {
+	const provider = (req.provider ?? "").trim();
+	if (provider === "") throw new Error("缺少 provider");
+	if (provider === "deepseek-official") throw new Error("内置 DeepSeek 提供方不可删除");
+	const creds = ctx.get("credentials");
+	if (creds?.unset !== void 0 && req.apiKeyEnv !== void 0 && req.apiKeyEnv.trim() !== "") await creds.unset(req.apiKeyEnv.trim());
+	const settings = ctx.get("settings");
+	if (settings?.mutate !== void 0) await settings.mutate("llm-pi-ai", [{
+		op: "unset",
+		path: ["providers", provider]
+	}]);
+	return {
+		ok: true,
+		message: "已移除提供方 " + provider
+	};
+}
+/**
+* 添加模型（DSH 同款体验）：厂商直填 API Key，或自定义 OpenAI 兼容路由。
+* 写入 DSH 凭据 refs，并（必要时）注册/更新 llm-pi-ai provider 路由。
+*/
+async function registerLlmModel(ctx, req) {
+	const apiKey = req.apiKey?.trim() ?? "";
+	const model = req.model?.trim() ?? "";
+	if (apiKey === "") throw new Error("API Key 不能为空");
+	if (model === "") throw new Error("模型 id 不能为空");
+	const creds = ctx.get("credentials");
+	if (creds === void 0) throw new Error("DSH credentials 服务不可用，无法写入 API Key");
+	let route;
+	let env;
+	let displayName;
+	let message;
+	if (req.mode === "vendor") {
+		const vendorId = (req.vendor ?? "").trim();
+		if (vendorId === "") throw new Error("请选择厂商");
+		const v = LLM_VENDORS.find((x) => x.route === vendorId);
+		route = vendorId;
+		env = req.apiKeyEnv?.trim() || v?.apiKeyEnv || "PI_AI_" + vendorId.toUpperCase().replace(/[^A-Z0-9]+/g, "_") + "_API_KEY";
+		displayName = v?.name ?? vendorId;
+		const isBuiltin = v?.builtin === true || vendorId === "deepseek-official";
+		await creds.set(env, apiKey);
+		if (isBuiltin) message = "已写入 DSH 凭据（" + env + "）";
+		else {
+			await ensurePiAiProvider(ctx, route, { apiKeyEnv: env });
+			message = "已写入 DSH 凭据并注册路由 " + route;
+		}
+	} else {
+		route = (req.provider ?? "").trim();
+		const baseURL = (req.baseURL ?? "").trim();
+		if (route === "") throw new Error("自定义模式需填提供商路由 id");
+		if (baseURL === "") throw new Error("自定义模式需填接口地址 (baseURL)");
+		env = "NOVEL_CUSTOM_" + route.toUpperCase().replace(/[^A-Z0-9]+/g, "_") + "_API_KEY";
+		displayName = req.name?.trim() || "Custom " + route;
+		await creds.set(env, apiKey);
+		await ensurePiAiProvider(ctx, route, {
+			displayName,
+			apiKeyEnv: env,
+			api: "openai-completions",
+			baseURL,
+			models: [{ id: model }],
+			compat: {
+				supportsDeveloperRole: false,
+				maxTokensField: "max_tokens"
+			}
+		});
+		message = "已写入 DSH 凭据并注册路由 " + route;
+	}
+	return {
+		ok: true,
+		saved: {
+			id: "saved-" + Date.now().toString(36) + "-" + Math.random().toString(36).slice(2, 6),
+			name: req.name?.trim() || displayName + " · " + model,
+			provider: route,
+			model
+		},
+		provider: route,
+		message
+	};
+}
 /** 底层：按形象锚点调用生图接口生成定妆图（不写库；写库由上层调用方负责）。 */
 async function generateReferenceImageFrom(config, anchor, style = "", modelId) {
 	if (config.imageApiEnabled !== true) throw new Error("生图未启用，请在设置中启用一个生图模型");
@@ -4624,30 +5203,286 @@ function normalizeAdaptationImpact(i) {
 		chapters: chapters !== void 0 && chapters.length > 0 ? chapters : void 0
 	};
 }
-/**
-* 摘要 + 事实抽取合并为一次 LLM 调用（省一次调用与一次正文输入，
-* 批量生成时整体开销约省 25%）。
-* @returns 摘要与新增事实条数（失败返回空，调用方 best-effort）。
-*/
-async function summarizeAndExtractFacts(ctx, config, project, outputDir, chapterNo) {
-	const chapter = project.chapters.find((c) => c.no === chapterNo);
-	if (chapter === void 0) return {
-		summary: "",
-		factCount: 0
-	};
-	const body = readChapterFile(outputDir, chapter);
-	if (body === void 0) return {
-		summary: "",
-		factCount: 0
-	};
-	const raw = parseJsonObject(await complete(ctx, config, {
-		system: [
-			"你是一位网文编辑。请为下面一章做两件事，输出合法 JSON 对象：",
-			"{\"summary\": \"120-200字摘要，含关键事件/主角状态变化（境界资源伤势心境）/新增伏笔线索/角色关系变化，客观陈述不评价\", \"facts\": [\"已确立事实1\", \"…3-6条\"]}",
-			"facts 指：本章明确写出的、对后续有约束力的事实——人物当前状态、重要关系变化、地点与时间线、已落地或新增的伏笔线索、关键道具去向。",
-			"重要：所有字符串值内部不得包含换行符，JSON 必须在一段内完整结束。"
-		].join("\n"),
-		user: body.replace(/^#\s+.*$/m, "").trim(),
+/** 改编模式 rewrite：逐章 LLM 重写（结构性改写，不只是换词）。
+* @returns 改写后的全文 + 逐章结果 + 保留原章的章号。 */
+async function rewriteAdaptationBook(ctx, config, text, mappings, rules, options = {}) {
+	const chapters = splitBookText(text).filter((c) => c.body.length >= 50);
+	if (chapters.length === 0) throw new Error("未能从全文拆出章节（内容过短或无章节结构）");
+	const startNo = options.startNo ?? 1;
+	const endNo = options.endNo ?? 0;
+	const inWindow = (c) => c.no >= startNo && (endNo <= 0 || c.no <= endNo);
+	const windowChapters = chapters.filter(inWindow);
+	const cap = options.maxChapters !== void 0 && options.maxChapters > 0 ? Math.min(options.maxChapters, windowChapters.length) : windowChapters.length;
+	const toRewrite = windowChapters.slice(0, cap);
+	const toRewriteNos = new Set(toRewrite.map((c) => c.no));
+	const total = toRewrite.length;
+	let completed = 0;
+	const mappingBlock = mappings.length > 0 ? "映射表（原值 → 新值）：\n" + mappings.map((m) => `- ${m.source} → ${m.target}（${m.scope}）${m.note !== void 0 && m.note !== "" ? "：" + m.note : ""}`).join("\n") : "";
+	const ruleBlock = rules !== void 0 ? [
+		rules.preserve.length > 0 ? "必须保留：\n" + rules.preserve.map((x) => `- ${x}`).join("\n") : "",
+		rules.change.length > 0 ? "允许改变：\n" + rules.change.map((x) => `- ${x}`).join("\n") : "",
+		rules.constraints.length > 0 ? "改编红线/一致性要求：\n" + rules.constraints.map((x) => `- ${x}`).join("\n") : ""
+	].filter((s) => s !== "").join("\n") : "";
+	const system = [
+		"你是一位资深网文改编编剧。你会收到某一章的正文，以及本书的改编映射表与改编规则。",
+		"任务：把这一章按改编方案**重写**成新版本（结构性改编，不只是换词）。",
+		"要求：",
+		"1. 严格遵守映射表（原值→新值），正文中所有源值都要替换为新值；涉及改名/改体系/改势力时，相关表述一起调整，使上下文自洽。",
+		"2. 改编规则：必须保留的内容不得破坏（故事骨架/人物动机/伏笔逻辑/爽点结构）；允许改变的内容可以放开调整；红线/一致性要求必须遵守。",
+		"3. 若某个改动牵动叙事（如结局走向/时间线/世界观），要把这章的叙述顺势改得通顺、可信。",
+		"4. 输出**只包含这一章重写后的正文**，不要重复标题，不要任何解释、开头或结尾。",
+		"5. 字数与原章基本相当（允许 ±20%）。"
+	].join("\n");
+	const adaptedParts = [];
+	const rewritten = [];
+	const skipped = [];
+	const hits = applyAdaptationReplacements(text, mappings).hits;
+	for (const c of chapters) {
+		const title = applyAdaptationMappings(c.title, mappings) || c.title;
+		if (!toRewriteNos.has(c.no)) {
+			adaptedParts.push("# 第" + c.no + "章 " + title + "\n\n" + c.body.trim() + "\n");
+			continue;
+		}
+		const user = [
+			mappingBlock,
+			ruleBlock,
+			"第 " + c.no + " 章《" + c.title + "》：",
+			c.body
+		].filter((s) => s !== "").join("\n\n");
+		let body = "";
+		try {
+			body = stripRewriteHeading(await complete(ctx, config, {
+				system,
+				user,
+				temperature: .7,
+				maxTokens: Math.max(config.maxTokens, Math.min(16e3, c.body.length * 3)),
+				reasoning: config.analysisReasoning ?? "low"
+			}));
+			if (body.length < 50) body = "";
+		} catch {
+			body = "";
+		}
+		if (body === "") {
+			skipped.push(c.no);
+			body = c.body;
+		}
+		adaptedParts.push("# 第" + c.no + "章 " + title + "\n\n" + body.trim() + "\n");
+		rewritten.push({
+			no: c.no,
+			title,
+			chars: body.length
+		});
+		completed++;
+		options.onProgress?.({
+			completed,
+			total,
+			no: c.no,
+			title
+		});
+	}
+	return {
+		adaptedText: adaptedParts.join("\n"),
+		rewritten,
+		skipped,
+		hits
+	};
+}
+/** 去掉 LLM 输出可能带上的 Markdown 标题行。 */
+function stripRewriteHeading(out) {
+	return out.split(/\r?\n/).filter((line) => !/^\s*#/.test(line)).join("\n").trim();
+}
+/**
+* 改编模式 P3：从源全文 + 用户编辑后的改编方案，提炼新书资料并保存为「待写新书」。
+* 流程：源文导入临时项目 → 复用 extractBible/extractRoles/extractWorld 提炼 →
+* 按映射表把术语/人名/势力映射到新书命名层 → planVolumes/planChapters 生成待写计划 → 保存。
+* @returns 提炼后的新书资料（不含书架 book，由路由负责登记书架）。
+*/
+async function materializeAdaptedBook(ctx, config, args) {
+	const bookName = (args.bookName ?? "").trim().slice(0, 40) || "改编新书";
+	const outDir = (args.outputDir ?? "").trim();
+	if (outDir === "") throw new Error("未指定新书输出目录");
+	const mappings = args.proposal?.mappings ?? [];
+	const tmpDir = join(tmpdir(), "dsh-novel-forge-adapt-" + Date.now().toString(36) + "-" + Math.random().toString(36).slice(2, 8));
+	try {
+		importBookTextFromText(args.text, tmpDir, bookName);
+		const sourceProject = loadProject(tmpDir);
+		if (sourceProject === void 0) throw new Error("临时项目创建失败");
+		const sourceConfig = {
+			...config,
+			outputDir: tmpDir
+		};
+		const srcOutline = (args.outline ?? "").trim() !== "" ? (args.outline ?? "").trim() : fallbackSourceOutline(sourceProject);
+		sourceProject.outline = srcOutline;
+		let bible = await extractBible(ctx, sourceConfig, srcOutline, sourceProject);
+		sourceProject.bible = bible;
+		const roles = await extractRoles(ctx, sourceConfig, sourceProject);
+		const world = await extractWorld(ctx, sourceConfig, sourceProject);
+		const adaptedOutline = applyAdaptationMappings(srcOutline, mappings);
+		bible = applyMappingsToBible(bible, mappings);
+		const adaptedRoles = applyMappingsToRoles(roles, mappings);
+		const adaptedWorld = applyMappingsToWorld(world, mappings);
+		const project = createProject(bookName);
+		project.bookName = bookName;
+		project.outline = adaptedOutline;
+		project.bible = bible;
+		project.roles = adaptedRoles;
+		project.world = adaptedWorld;
+		project.volumes = await planVolumes(ctx, config, adaptedOutline);
+		project.chapters = await planChapters(ctx, config, project, Math.max(1, Math.min(args.chapterCount ?? 30, 500)));
+		return {
+			bookName,
+			outline: adaptedOutline,
+			bible,
+			roles: adaptedRoles,
+			world: adaptedWorld,
+			volumes: project.volumes ?? [],
+			chapters: project.chapters,
+			outputDir: outDir
+		};
+	} finally {
+		try {
+			rmSync(tmpDir, {
+				recursive: true,
+				force: true
+			});
+		} catch {}
+	}
+}
+/** 把预览/微调后的新书资料写入输出目录并返回摘要（书架登记由路由负责）。 */
+function saveMaterializedBook(outDir, bookName, data) {
+	const project = createProject(bookName);
+	project.bookName = bookName;
+	project.outline = data.outline;
+	project.bible = data.bible;
+	project.roles = data.roles;
+	project.world = data.world;
+	project.volumes = data.volumes;
+	project.chapters = data.chapters;
+	saveProject(outDir, project);
+	return {
+		bookName,
+		chapters: data.chapters.length,
+		outputDir: outDir
+	};
+}
+/** 把一份文本按映射表做全局替换（复用术语替换执行器）。 */
+function applyAdaptationMappings(text, mappings) {
+	return applyAdaptationReplacements(text, mappings).adaptedText;
+}
+/** 改编设定圣经：把人名/术语/势力按映射表替换。 */
+function applyMappingsToBible(bible, mappings) {
+	const t = (s) => applyAdaptationMappings(s, mappings);
+	return {
+		...bible,
+		genre: t(bible.genre),
+		worldRules: bible.worldRules.map(t),
+		redLines: bible.redLines.map(t),
+		style: bible.style.map(t),
+		characters: bible.characters.map((c) => ({
+			...c,
+			name: t(c.name),
+			traits: c.traits.map(t),
+			goals: t(c.goals),
+			relations: t(c.relations),
+			knowledge: c.knowledge?.map(t)
+		}))
+	};
+}
+/** 改编角色库：把人名/身份/标签/关系/成长/知情度按映射表替换。 */
+function applyMappingsToRoles(roles, mappings) {
+	const t = (s) => applyAdaptationMappings(s, mappings);
+	return roles.map((role) => ({
+		...role,
+		name: t(role.name),
+		identity: t(role.identity),
+		traits: role.traits.map(t),
+		goals: t(role.goals),
+		relations: role.relations.map(t),
+		arc: role.arc.map(t),
+		knowledge: role.knowledge.map(t),
+		imagePrompt: role.imagePrompt !== void 0 ? {
+			...role.imagePrompt,
+			zh: t(role.imagePrompt.zh),
+			en: t(role.imagePrompt.en),
+			tags: role.imagePrompt.tags.map(t),
+			source: role.imagePrompt.source !== void 0 ? t(role.imagePrompt.source) : void 0
+		} : void 0,
+		expressions: role.expressions?.map(t),
+		promptKit: role.promptKit !== void 0 ? {
+			...role.promptKit,
+			portrait: {
+				...role.promptKit.portrait,
+				zh: t(role.promptKit.portrait.zh),
+				en: t(role.promptKit.portrait.en)
+			},
+			sheet: {
+				...role.promptKit.sheet,
+				zh: t(role.promptKit.sheet.zh),
+				en: t(role.promptKit.sheet.en)
+			},
+			expressions: role.promptKit.expressions.map((e) => ({
+				...e,
+				zh: t(e.zh),
+				en: t(e.en)
+			})),
+			details: {
+				...role.promptKit.details,
+				zh: t(role.promptKit.details.zh),
+				en: t(role.promptKit.details.en)
+			}
+		} : void 0
+	}));
+}
+/** 改编大世界：境界/区域/势力名按映射表替换。 */
+function applyMappingsToWorld(world, mappings) {
+	const t = (s) => applyAdaptationMappings(s, mappings);
+	return {
+		realms: world.realms.map((x) => ({
+			name: t(x.name),
+			description: t(x.description)
+		})),
+		regions: world.regions.map((x) => ({
+			name: t(x.name),
+			description: t(x.description),
+			faction: x.faction !== void 0 ? t(x.faction) : void 0
+		})),
+		factions: world.factions.map((x) => ({
+			name: t(x.name),
+			kind: t(x.kind),
+			description: t(x.description),
+			region: x.region !== void 0 ? t(x.region) : void 0
+		}))
+	};
+}
+/** 反推大纲缺失时的兜底：用源书章节标题占位（可到工作区重新生成）。 */
+function fallbackSourceOutline(project) {
+	const heads = project.chapters.map((c) => `第${c.no}章《${c.title}》：${c.beats !== void 0 && c.beats !== "" ? c.beats : ""}`).join("\n");
+	return `# 《${project.bookName}》\n\n（反推大纲缺失，以下为章节标题占位，可在小说工坊重新生成大纲。）\n\n${heads}`;
+}
+/**
+* 摘要 + 事实抽取合并为一次 LLM 调用（省一次调用与一次正文输入，
+* 批量生成时整体开销约省 25%）。
+* @returns 摘要与新增事实条数（失败返回空，调用方 best-effort）。
+*/
+async function summarizeAndExtractFacts(ctx, config, project, outputDir, chapterNo) {
+	const chapter = project.chapters.find((c) => c.no === chapterNo);
+	if (chapter === void 0) return {
+		summary: "",
+		factCount: 0
+	};
+	const body = readChapterFile(outputDir, chapter);
+	if (body === void 0) return {
+		summary: "",
+		factCount: 0
+	};
+	const raw = parseJsonObject(await complete(ctx, config, {
+		system: [
+			"你是一位网文编辑。请为下面一章做两件事，输出合法 JSON 对象：",
+			"{\"summary\": \"120-200字摘要，含关键事件/主角状态变化（境界资源伤势心境）/新增伏笔线索/角色关系变化，客观陈述不评价\", \"facts\": [\"已确立事实1\", \"…3-6条\"]}",
+			"facts 指：本章明确写出的、对后续有约束力的事实——人物当前状态、重要关系变化、地点与时间线、已落地或新增的伏笔线索、关键道具去向。",
+			"重要：所有字符串值内部不得包含换行符，JSON 必须在一段内完整结束。"
+		].join("\n"),
+		user: body.replace(/^#\s+.*$/m, "").trim(),
 		temperature: .2,
 		maxTokens: Math.max(config.maxTokens, 5e3)
 	}));
@@ -5660,125 +6495,6 @@ var ProductionRunner = class {
 	}
 };
 //#endregion
-//#region src/protocol.ts
-/** The /api/dsh-novel-forge route family (same-origin, loopback-fenced). */
-const NOVEL_API = {
-	status: "/api/dsh-novel-forge/status",
-	loadOutline: "/api/dsh-novel-forge/load-outline",
-	saveOutline: "/api/dsh-novel-forge/save-outline",
-	plan: "/api/dsh-novel-forge/plan",
-	volumes: "/api/dsh-novel-forge/volumes",
-	bible: "/api/dsh-novel-forge/bible",
-	assets: "/api/dsh-novel-forge/assets",
-	styleEngine: "/api/dsh-novel-forge/style-engine",
-	generate: "/api/dsh-novel-forge/generate",
-	review: "/api/dsh-novel-forge/review",
-	rewrite: "/api/dsh-novel-forge/rewrite",
-	polish: "/api/dsh-novel-forge/polish",
-	/** 采纳待确认草稿（润色/重写产物）覆盖正文文件。 */
-	draftApply: "/api/dsh-novel-forge/draft/apply",
-	/** 放弃待确认草稿，保留原稿。 */
-	draftDiscard: "/api/dsh-novel-forge/draft/discard",
-	summary: "/api/dsh-novel-forge/summary",
-	foreshadow: "/api/dsh-novel-forge/foreshadow",
-	exportBook: "/api/dsh-novel-forge/export",
-	chapter: "/api/dsh-novel-forge/chapter",
-	/** 审查任意正文文本（作者手动编辑后，不落盘）。 */
-	chapterCheck: "/api/dsh-novel-forge/chapter/check",
-	/** 保存手动编辑的正文（自动备份 .bak）。 */
-	chapterSave: "/api/dsh-novel-forge/chapter/save",
-	assistant: "/api/dsh-novel-forge/assistant",
-	assistantHistory: "/api/dsh-novel-forge/assistant-history",
-	/** 清空助手对话记录。 */
-	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",
-	/** 漫剧方案管理：create/remove/activate。 */
-	manhuaPlans: "/api/dsh-novel-forge/manhua/plans",
-	/** 漫剧角色库：从分镜提名（规则+LLM两段式）/ 建卡 / 更新 / 删除 / 形象锚点 / 精修提示词。 */
-	mangaRoles: "/api/dsh-novel-forge/manga/roles",
-	/** 分镜·编剧级：单章 → 剧情骨架（节拍链）。 */
-	storyboardSkeleton: "/api/dsh-novel-forge/storyboard/skeleton",
-	/** 分镜·导演级：骨架 → 分镜表（镜头级）。 */
-	storyboardTable: "/api/dsh-novel-forge/storyboard/table",
-	/** 分镜·提示词级：分镜表 → 即梦可粘贴视频提示词。 */
-	storyboardPrompts: "/api/dsh-novel-forge/storyboard/prompts",
-	/** 生图接口连通性测试（设置页每个模型条目用）。 */
-	imageTest: "/api/dsh-novel-forge/image-test",
-	/** 重置项目（可选携带新大纲）：清空设定/卷/章节/伏笔/资产/事实库。 */
-	reset: "/api/dsh-novel-forge/reset",
-	/** 全书一致性质检：LLM 扫描已生成章节，输出矛盾问题清单。 */
-	audit: "/api/dsh-novel-forge/audit",
-	/** 角色卡刷新：基于事实库与各章摘要聚合角色当前状态。 */
-	charactersRefresh: "/api/dsh-novel-forge/characters/refresh",
-	/** 事实库回填：对历史已生成章节批量抽取事实（旧章节无事实记录时用）。 */
-	factsBackfill: "/api/dsh-novel-forge/facts/backfill",
-	/** 设定圣经局部修补（如世界观规则编辑）。 */
-	biblePatch: "/api/dsh-novel-forge/bible/patch",
-	/** 小说简介：生成（AI）/补全（AI）/保存。 */
-	blurb: "/api/dsh-novel-forge/blurb",
-	/** 重命名当前书（同步项目与书架条目）。 */
-	rename: "/api/dsh-novel-forge/rename",
-	/** 大世界：AI 提炼 / 保存结构化数据（境界/区域/势力）。 */
-	world: "/api/dsh-novel-forge/world",
-	/** 封面：GET 读取（dataUrl）/ POST 上传或移除。 */
-	cover: "/api/dsh-novel-forge/blurb/cover",
-	/** 剧情线管理：增删改 + 关联章节。 */
-	plotlines: "/api/dsh-novel-forge/plotlines",
-	/** 角色库：AI 提炼 / 采纳 / 更新 / 删除。 */
-	roles: "/api/dsh-novel-forge/roles",
-	scenes: "/api/dsh-novel-forge/scenes",
-	visualRules: "/api/dsh-novel-forge/visual-rules",
-	/** 作者复盘补跑：对已写章节补齐 authorReview（全书流式 / 单章 JSON）。 */
-	reviewBackfill: "/api/dsh-novel-forge/review/backfill",
-	/** 章节复位：generating 卡死 → pending（可重新生成）。 */
-	chapterReset: "/api/dsh-novel-forge/chapter/reset",
-	/** 章节直接通过：作者对 rejected/written 章节行使最终决定权。 */
-	chapterApprove: "/api/dsh-novel-forge/chapter/approve",
-	/** 敏感词检查：全书已写章节或指定文本。 */
-	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）。 */
-	/** 漫剧分集计划：读一卷 → 按故事弧线分集（高潮拆集/过渡并章）。 */
-	/** 漫画脚本：章节 → 分页分格漫画脚本（含角色视觉锚点）。 */
-	/** 生产单：启动批量生产（计划补足 + 逐章生成 + 被拒分级处理）。 */
-	runStart: "/api/dsh-novel-forge/run/start",
-	/** 生产单控制：pause / resume / stop。 */
-	runControl: "/api/dsh-novel-forge/run/control",
-	/** 生产单状态（含进度统计与日志）。 */
-	runStatus: "/api/dsh-novel-forge/run/status",
-	config: "/api/dsh-novel-forge/config",
-	openFolder: "/api/dsh-novel-forge/open-folder",
-	/** 作者资产库/总数据：读取个人跨书资产（笔法/红线/套路/角色模板/世界观模板）。 */
-	authorAssets: "/api/dsh-novel-forge/author-assets",
-	/** 作者资产库：新增/更新一条资产（upsert by id）。 */
-	authorAssetsUpsert: "/api/dsh-novel-forge/author-assets/upsert",
-	/** 作者资产库：删除一条资产。 */
-	authorAssetsRemove: "/api/dsh-novel-forge/author-assets/remove",
-	/** 作者资产库：导入默认（书架书的写作资产/角色 + 内置全局库）批量沉淀。 */
-	authorAssetsImportDefault: "/api/dsh-novel-forge/author-assets/import-default",
-	/** 改编模式：上传全文 → 分析 → 原文设定卡片/可改范围矩阵。 */
-	adaptAnalyze: "/api/dsh-novel-forge/adapt/analyze",
-	/** 改编模式：确认要改的维度 → 生成映射表/改编规则/联动影响清单。 */
-	adaptPropose: "/api/dsh-novel-forge/adapt/propose",
-	/** 改编模式：执行术语替换（全局替换 + 命中统计 + 改编文本预览）。 */
-	adaptExecute: "/api/dsh-novel-forge/adapt/execute",
-	/** 主题自定义背景：上传图片（POST，存盘并返回服务端 URL）。 */
-	themeBackgroundUpload: "/api/dsh-novel-forge/theme/background",
-	/** 主题自定义背景：读取已上传文件（GET prefix，/theme/background/<name>）。 */
-	themeBackgroundGet: "/api/dsh-novel-forge/theme/background"
-};
-//#endregion
 //#region src/docx.ts
 /**
 * docx outline extraction: a .docx is a zip whose word/document.xml holds the
@@ -6664,23 +7380,14 @@ function importDefaultAuthorAssets() {
 			updatedAt: now
 		});
 	};
-	for (const g of flattenGenres(BUILTIN_GENRE_LIBRARY)) push("genre", g.name, g.description, g.description, ["内置", "题材"], [], {
-		description: g.description,
-		children: (g.children ?? []).map((c) => c.name)
-	});
-	for (const r of BUILTIN_ANTI_AI_RULES) push("antiAi", r.name, r.avoid, "避免：" + r.avoid + "\n修正：" + r.fix, ["内置", "反AI"], [], {
-		avoid: r.avoid,
-		fix: r.fix,
-		detectPatterns: r.detectPatterns
-	});
-	for (const t of BUILTIN_STYLE_TEMPLATES) push("style", t.name, t.description, "分类：" + t.category + "\n适用：" + t.applicableGenres.join("、") + "\n叙述：" + t.proseRules.join("；") + "\n台词：" + t.dialogueRules.join("；") + "\n语言：" + t.languageRules.join("；") + "\n节奏：" + t.rhythmRules.join("；"), ["内置", "风格模板"], [], {
-		category: t.category,
-		applicableGenres: t.applicableGenres
-	});
-	for (const p of BUILTIN_PROGRESSION_MODES) push("progression", p.name, p.driver, "驱动：" + p.driver + "\n期待：" + p.readerExpectation + "\n兑现：" + p.payoffs.join("；") + "\n风险：" + p.risks.join("；"), ["内置", "推进"], [], {
-		driver: p.driver,
-		primary: p.primary
-	});
+	const builtinKinds = /* @__PURE__ */ new Set([
+		"genre",
+		"antiAi",
+		"progression",
+		"style",
+		"plotBeat"
+	]);
+	library.items = library.items.filter((a) => !(a.tags.includes("内置") && builtinKinds.has(a.kind) && (a.sourceBooks ?? []).length === 0));
 	const shelf = loadBookshelf();
 	for (const book of shelf.books) {
 		const project = loadProject(book.outputDir);
@@ -6705,7 +7412,8 @@ function importDefaultAuthorAssets() {
 			for (const s of assets.styleAssets ?? []) push("style", s.name, s.proseRules.join("；"), "叙述：" + s.proseRules.join("；") + "\n台词：" + s.dialogueRules.join("；") + "\n描写：" + s.descriptionRules.join("；") + "\n边界：" + s.boundaries.join("；"), src, [], { sourceText: s.sourceText });
 		}
 		for (const role of project.roles ?? []) {
-			const persona = ("身份：" + role.identity + "\n性格：" + role.traits.join("、") + "\n目标：" + role.goals + "\n关系：" + role.relations.join("、") + "\n成长线：" + (role.arc.length > 0 ? role.arc.join(" > ") : "—") + "\n知情度：" + role.knowledge.join("、")).trim();
+			if (role.roleLabel !== "protagonist" && role.roleLabel !== "female_lead") continue;
+			const persona = ("定位：" + role.roleLabel + "\n身份：" + role.identity + "\n性格：" + role.traits.join("、") + "\n目标：" + role.goals + "\n关系：" + role.relations.join("、") + "\n成长线：" + (role.arc.length > 0 ? role.arc.join(" > ") : "—") + "\n知情度：" + role.knowledge.join("、")).trim();
 			push("roleTemplate", role.name, role.identity, persona, src, [], {
 				roleLabel: role.roleLabel,
 				traits: role.traits,
@@ -6718,18 +7426,6 @@ function importDefaultAuthorAssets() {
 	saveAuthorAssets(library);
 	return library;
 }
-/** 拍平题材库（含子题材，父级名称并入 tag）。 */
-function flattenGenres(nodes, parentName) {
-	const out = [];
-	for (const n of nodes) {
-		out.push({
-			...n,
-			name: parentName !== void 0 ? parentName + "/" + n.name : n.name
-		});
-		if (n.children.length > 0) out.push(...flattenGenres(n.children, parentName !== void 0 ? parentName + "/" + n.name : n.name));
-	}
-	return out;
-}
 //#endregion
 //#region src/routes.ts
 /** Cap on JSON request bodies (generous: cover images travel as base64). */
@@ -7604,7 +8300,8 @@ function makeRoutes(deps) {
 				genreLibrary: BUILTIN_GENRE_LIBRARY,
 				antiAiLibrary: BUILTIN_ANTI_AI_RULES,
 				styleTemplates: BUILTIN_STYLE_TEMPLATES,
-				progressionLibrary: BUILTIN_PROGRESSION_MODES
+				progressionLibrary: BUILTIN_PROGRESSION_MODES,
+				plotBeatLibrary: BUILTIN_PLOT_BEATS
 			});
 		}
 	};
@@ -8805,6 +9502,42 @@ function makeRoutes(deps) {
 			});
 		}
 	};
+	/** 插件自更新：在 DSH profile 目录拉取最新 npm 版（仅下载，需重启 DSH 生效）。 */
+	const pluginUpdateRoute = {
+		kind: "exact",
+		path: NOVEL_API.pluginUpdate,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const profileDir = join(homedir(), ".dsh", "profiles", "web");
+			writeJson(res, 200, await new Promise((resolve) => {
+				const child = spawn("pnpm", ["add", "@waterwx/dsh-novel-forge@latest"], {
+					cwd: profileDir,
+					shell: true
+				});
+				let acc = "";
+				child.stdout.on("data", (d) => {
+					acc += String(d);
+				});
+				child.stderr.on("data", (d) => {
+					acc += String(d);
+				});
+				child.on("error", (error) => resolve({
+					ok: false,
+					message: "无法执行更新：" + error.message
+				}));
+				child.on("close", (code) => {
+					if (code === 0) resolve({
+						ok: true,
+						message: "已更新到最新版本，请重启 DSH 生效。"
+					});
+					else resolve({
+						ok: false,
+						message: "更新失败（退出码 " + code + "）：" + acc.slice(-400)
+					});
+				});
+			}));
+		}
+	};
 	/** 开书想法 → AI 大纲：2-3 个可选方案（支持暂留换批：count 只补空槽 + exclude 避开已留方向）。 */
 	const outlineSuggestRoute = {
 		kind: "exact",
@@ -8917,6 +9650,99 @@ function makeRoutes(deps) {
 			}
 		}
 	};
+	/** LLM 连通性测试：对选中的提供商/模型发一次最小真实调用。 */
+	const llmTestRoute = {
+		kind: "exact",
+		path: NOVEL_API.llmTest,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const body = await readJsonBody(req);
+			const provider = (body?.provider ?? "").trim();
+			const model = (body?.model ?? "").trim();
+			if (provider === "" || model === "") {
+				writeJson(res, 400, { error: "provider 与 model 必填" });
+				return;
+			}
+			writeJson(res, 200, await testLlmModel(ctx, provider, model));
+		}
+	};
+	/** 添加模型：厂商直填 API Key，或自定义 OpenAI 兼容路由（写 DSH 凭据 + router）。 */
+	const addModelRoute = {
+		kind: "exact",
+		path: NOVEL_API.addModel,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const body = await readJsonBody(req);
+			if (body === void 0) {
+				writeJson(res, 400, { error: "缺少请求体" });
+				return;
+			}
+			try {
+				writeJson(res, 200, await registerLlmModel(ctx, body));
+			} catch (error) {
+				writeJson(res, 500, { error: `添加模型失败：${error.message}` });
+			}
+		}
+	};
+	/** 运行时厂商目录（DSH pi-ai 可配置提供方 + 内置适配器）。 */
+	const llmVendorsRoute = {
+		kind: "exact",
+		path: NOVEL_API.llmVendors,
+		handler: async (req, res) => {
+			if (!guard(req, res, "GET")) return;
+			try {
+				writeJson(res, 200, await listLlmVendors(ctx));
+			} catch (error) {
+				writeJson(res, 500, { error: `读取厂商目录失败：${error.message}` });
+			}
+		}
+	};
+	/** 查询某个 provider 当前可用的模型（添加成功后可即时刷新下拉）。 */
+	const llmModelsRoute = {
+		kind: "exact",
+		path: NOVEL_API.llmModels,
+		handler: async (req, res) => {
+			if (!guard(req, res, "GET")) return;
+			const url = new URL(req.url ?? "", "http://localhost");
+			const provider = decodeURIComponent((url.searchParams.get("provider") ?? "").trim());
+			try {
+				writeJson(res, 200, await listLlmModels(ctx, provider));
+			} catch (error) {
+				writeJson(res, 500, { error: `读取模型列表失败：${error.message}` });
+			}
+		}
+	};
+	/** 已注册的提供方路由列表（提供方管理卡片）。 */
+	const llmProvidersRoute = {
+		kind: "exact",
+		path: NOVEL_API.llmProviders,
+		handler: async (req, res) => {
+			if (!guard(req, res, "GET")) return;
+			try {
+				writeJson(res, 200, await listLlmProviders(ctx));
+			} catch (error) {
+				writeJson(res, 500, { error: `读取提供方列表失败：${error.message}` });
+			}
+		}
+	};
+	/** 移除一个提供方（unset key + 移除 llm-pi-ai 路由）。 */
+	const llmRemoveRoute = {
+		kind: "exact",
+		path: NOVEL_API.llmRemove,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const body = await readJsonBody(req);
+			if (body === void 0) {
+				writeJson(res, 400, { error: "缺少请求体" });
+				return;
+			}
+			try {
+				writeJson(res, 200, await removeLlmProvider(ctx, body));
+			} catch (error) {
+				writeJson(res, 500, { error: `移除提供方失败：${error.message}` });
+			}
+		}
+	};
 	/** 分镜·导演级：骨架 → 分镜表（镜头级）。 */
 	const storyboardTableRoute = {
 		kind: "exact",
@@ -9333,17 +10159,223 @@ function makeRoutes(deps) {
 				return;
 			}
 			if (body?.mode === "rewrite") {
-				writeJson(res, 400, { error: "rewrite 模式尚未实现，请使用 replace（术语替换）" });
+				try {
+					const result = await rewriteAdaptationBook(ctx, getConfig(), text, mappings, body?.rules, {
+						maxChapters: body?.maxChapters,
+						startNo: body?.startNo,
+						endNo: body?.endNo
+					});
+					writeJson(res, 200, {
+						adaptedText: result.adaptedText,
+						mappings: mappings.length,
+						hits: result.hits,
+						mode: "rewrite",
+						rewritten: result.rewritten,
+						skipped: result.skipped
+					});
+				} catch (err) {
+					writeJson(res, 400, { error: err instanceof Error ? err.message : String(err) });
+				}
 				return;
 			}
 			const { adaptedText, hits } = applyAdaptationReplacements(text, mappings);
 			writeJson(res, 200, {
 				adaptedText,
 				mappings: mappings.length,
-				hits
+				hits,
+				mode: "replace"
 			});
 		}
 	};
+	/** rewrite 逐章重写：NDJSON 流式进度（支持分段 startNo/endNo）。 */
+	const adaptRewriteStreamRoute = {
+		kind: "exact",
+		path: NOVEL_API.adaptRewriteStream,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			if (!getConfig().enableAdaptMode) {
+				writeJson(res, 404, { error: "改编模式未开启" });
+				return;
+			}
+			const body = await readJsonBody(req);
+			const text = body?.text ?? "";
+			const mappings = body?.mappings ?? [];
+			if (text.length < 200 || mappings.length === 0) {
+				writeJson(res, 400, { error: "请提供全文与映射表" });
+				return;
+			}
+			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 result = await rewriteAdaptationBook(ctx, getConfig(), text, mappings, body?.rules, {
+					maxChapters: body?.maxChapters,
+					startNo: body?.startNo,
+					endNo: body?.endNo,
+					onProgress: (info) => send({
+						type: "progress",
+						completed: info.completed,
+						total: info.total,
+						no: info.no,
+						title: info.title
+					})
+				});
+				send({
+					type: "done",
+					result: {
+						adaptedText: result.adaptedText,
+						mappings: mappings.length,
+						hits: result.hits,
+						mode: "rewrite",
+						rewritten: result.rewritten,
+						skipped: result.skipped
+					}
+				});
+			} catch (err) {
+				send({
+					type: "error",
+					message: err instanceof Error ? err.message : String(err)
+				});
+			} finally {
+				res.end();
+			}
+		}
+	};
+	/** 保存改编全文为新书（原书保留，登记书架）。 */
+	const adaptSaveRoute = {
+		kind: "exact",
+		path: NOVEL_API.adaptSave,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			if (!getConfig().enableAdaptMode) {
+				writeJson(res, 404, { error: "改编模式未开启" });
+				return;
+			}
+			const body = await readJsonBody(req);
+			const text = (body?.text ?? "").trim();
+			if (text.length < 200) {
+				writeJson(res, 400, { error: "改编全文内容过短（<200 字符）" });
+				return;
+			}
+			const bookName = (body?.bookName ?? "").trim().slice(0, 40) || "改编新书";
+			const outDir = (body?.outputDir ?? "").trim() !== "" && body?.outputDir !== void 0 && body.outputDir.trim() !== "" ? body.outputDir.trim() : defaultOutputDirFor(bookName);
+			const occupied = loadBookshelf().books.find((b) => b.outputDir === outDir);
+			if (occupied !== void 0 && occupied.bookName !== bookName) {
+				writeJson(res, 409, { error: `目录已被《${occupied.bookName}》占用，请更换书名或输出目录` });
+				return;
+			}
+			try {
+				const result = importBookTextFromText(text, outDir, bookName);
+				const outline = (body?.outline ?? "").trim();
+				if (outline !== "") {
+					const project = loadProject(outDir);
+					if (project !== void 0) {
+						project.outline = outline;
+						saveProject(outDir, project);
+					}
+				}
+				const { book } = importDir(outDir);
+				writeJson(res, 200, {
+					book,
+					bookName: result.bookName,
+					chapters: result.chapters,
+					skipped: result.skipped,
+					outputDir: outDir
+				});
+			} catch (err) {
+				writeJson(res, 400, { error: err instanceof Error ? err.message : String(err) });
+			}
+		}
+	};
+	/** 从源全文 + 编辑后方案提炼新书资料并保存为「待写新书」。 */
+	const adaptMaterializeRoute = {
+		kind: "exact",
+		path: NOVEL_API.adaptMaterialize,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			if (!getConfig().enableAdaptMode) {
+				writeJson(res, 404, { error: "改编模式未开启" });
+				return;
+			}
+			const body = await readJsonBody(req);
+			const text = (body?.text ?? "").trim();
+			if (text.length < 200) {
+				writeJson(res, 400, { error: "源书全文内容过短（<200 字符）" });
+				return;
+			}
+			const proposal = body?.proposal;
+			if (proposal === void 0 || proposal.mappings.length === 0) {
+				writeJson(res, 400, { error: "请先提供至少一条映射的改编方案" });
+				return;
+			}
+			const bookName = (body?.bookName ?? "").trim().slice(0, 40) || "改编新书";
+			const outDir = (body?.outputDir ?? "").trim() !== "" && body?.outputDir !== void 0 && body.outputDir.trim() !== "" ? body.outputDir.trim() : defaultOutputDirFor(bookName);
+			const occupied = loadBookshelf().books.find((b) => b.outputDir === outDir);
+			if (occupied !== void 0 && occupied.bookName !== bookName) {
+				writeJson(res, 409, { error: `目录已被《${occupied.bookName}》占用，请更换书名或输出目录` });
+				return;
+			}
+			try {
+				writeJson(res, 200, await materializeAdaptedBook(ctx, getConfig(), {
+					text,
+					bookName,
+					outputDir: outDir,
+					outline: body?.outline,
+					proposal,
+					chapterCount: body?.chapterCount
+				}));
+			} catch (err) {
+				writeJson(res, 400, { error: err instanceof Error ? err.message : String(err) });
+			}
+		}
+	};
+	/** 保存预览/微调后的新书资料为新书（原书保留，登记书架）。 */
+	const adaptMaterializeSaveRoute = {
+		kind: "exact",
+		path: NOVEL_API.adaptMaterializeSave,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			if (!getConfig().enableAdaptMode) {
+				writeJson(res, 404, { error: "改编模式未开启" });
+				return;
+			}
+			const body = await readJsonBody(req);
+			if (body === void 0 || body === null || (body.outline ?? "").trim() === "") {
+				writeJson(res, 400, { error: "请提供改编后总纲" });
+				return;
+			}
+			const bookName = (body.bookName ?? "").trim().slice(0, 40) || "改编新书";
+			const outDir = (body.outputDir ?? "").trim() !== "" && body.outputDir !== void 0 && body.outputDir.trim() !== "" ? body.outputDir.trim() : defaultOutputDirFor(bookName);
+			const occupied = loadBookshelf().books.find((b) => b.outputDir === outDir);
+			if (occupied !== void 0 && occupied.bookName !== bookName) {
+				writeJson(res, 409, { error: `目录已被《${occupied.bookName}》占用，请更换书名或输出目录` });
+				return;
+			}
+			try {
+				const result = saveMaterializedBook(outDir, bookName, {
+					outline: body.outline,
+					bible: body.bible,
+					roles: body.roles,
+					world: body.world,
+					volumes: body.volumes,
+					chapters: body.chapters
+				});
+				const { book } = importDir(outDir);
+				writeJson(res, 200, {
+					...result,
+					book
+				});
+			} catch (err) {
+				writeJson(res, 400, { error: err instanceof Error ? err.message : String(err) });
+			}
+		}
+	};
 	const THEME_BG_DIR = join(homedir(), ".dsh", "dsh-novel-forge-assets");
 	const MIME_BY_EXT = {
 		png: "image/png",
@@ -9402,12 +10434,19 @@ function makeRoutes(deps) {
 		chapterApproveRoute,
 		configRoute,
 		openFolderRoute,
+		pluginUpdateRoute,
 		outlineSuggestRoute,
 		outlineReverseRoute,
 		manhuaPlansRoute,
 		styleImageRoute,
 		storyboardSkeletonRoute,
 		imageTestRoute,
+		llmTestRoute,
+		addModelRoute,
+		llmVendorsRoute,
+		llmModelsRoute,
+		llmProvidersRoute,
+		llmRemoveRoute,
 		storyboardTableRoute,
 		storyboardPromptsRoute,
 		breakdownRoute,
@@ -9421,6 +10460,10 @@ function makeRoutes(deps) {
 		adaptAnalyzeRoute,
 		adaptProposeRoute,
 		adaptExecuteRoute,
+		adaptSaveRoute,
+		adaptMaterializeRoute,
+		adaptMaterializeSaveRoute,
+		adaptRewriteStreamRoute,
 		{
 			kind: "exact",
 			path: NOVEL_API.themeBackgroundUpload,
@@ -9537,7 +10580,7 @@ const Config = z.object({
 	themeBackground: z.string().default(""),
 	themeBackgroundBlur: z.number().default(0),
 	themeOpacity: z.number().default(100),
-	enableAdaptMode: z.boolean().default(false)
+	enableAdaptMode: z.boolean().default(true)
 });
 /** Schema defaults, re-read for hand-built test contexts. */
 const DEFAULT_ANNOUNCE = true;
@@ -9594,7 +10637,7 @@ function resolveConfig(value) {
 		themeBackground: value?.themeBackground ?? "",
 		themeBackgroundBlur: value?.themeBackgroundBlur ?? 0,
 		themeOpacity: value?.themeOpacity ?? 100,
-		enableAdaptMode: value?.enableAdaptMode ?? false
+		enableAdaptMode: value?.enableAdaptMode ?? true
 	};
 }
 /** 生图默认接口地址（豆包 ark，OpenAI 兼容）。 */