@waterwx/dsh-novel-forge 1.3.0-alpha → 1.3.1-alpha

package/lib/index.js

@@ -3653,6 +3653,16 @@ function renderTensionBlock(project, chapterNo) {
 * @param project 项目状态。
 * @returns 问题清单（可能为空）。
 */
+/**
+* run 型问题（连续同值 / 连续高位 / 连续低位）的受影响章号。
+* 返回**完整区间**而不是首尾两点：中间章同样受这条曲线问题影响，
+* 面板要能在每一章上给出「一键按建议修订」，合并层也要能把建议落到中间章。
+*/
+function runChapters(from, to) {
+	const out = [];
+	for (let no = from; no <= to; no++) out.push(no);
+	return out;
+}
 function detectTensionIssues(project) {
 	const values = [...project.chapters ?? []].sort((a, b) => a.no - b.no).map((c) => ({
 		no: c.no,
@@ -3681,7 +3691,7 @@ function detectTensionIssues(project) {
 				const from = values[i - run + 1].no;
 				issues.push({
 					severity: "medium",
-					chapters: [from, values[i].no],
+					chapters: runChapters(from, values[i].no),
 					item: `第${from}-${values[i].no}章张力几乎无变化（连续 ${run} 章）`,
 					suggestion: "安排一次明显抬升或一次释放，让曲线有起伏，避免读者疲劳。"
 				});
@@ -3695,7 +3705,7 @@ function detectTensionIssues(project) {
 			highRun++;
 			if (highRun === 3) issues.push({
 				severity: "medium",
-				chapters: [v.no - 2, v.no],
+				chapters: runChapters(v.no - 2, v.no),
 				item: `连续 ${highRun} 章处在高位（≥80），缺少呼吸口`,
 				suggestion: "高潮之后补一章缓冲（关系推进、信息消化或日常），再进入下一轮对抗。"
 			});
@@ -3708,7 +3718,7 @@ function detectTensionIssues(project) {
 			lowRun++;
 			if (lowRun === 5) issues.push({
 				severity: "high",
-				chapters: [v.no - 4, v.no],
+				chapters: runChapters(v.no - 4, v.no),
 				item: `连续 ${lowRun} 章张力低于 40，推进可能偏慢`,
 				suggestion: "提前兑现一个目标、抛出一个新风险，或让配角线产生冲撞。"
 			});
@@ -4413,6 +4423,8 @@ const NOVEL_API = {
 	usageReset: "/api/dsh-novel-forge/usage/reset",
 	/** 章节历史版本（快照）。 */
 	snapshot: "/api/dsh-novel-forge/snapshot",
+	/** 修订指令合并（POST：汇总审稿/时间线/张力为一轮）。 */
+	revisionPlan: "/api/dsh-novel-forge/revision/plan",
 	/** 张力曲线（GET 数据 / POST 设置）。 */
 	tension: "/api/dsh-novel-forge/tension",
 	/** 提示词槽位（GET 列表 / POST 写入）。 */
@@ -9293,6 +9305,204 @@ function defaultOutputDirFor(bookName) {
 	const clean = bookName.replace(/[\\/:*?"<>|]/g, "").trim().slice(0, 40) || "未命名小说";
 	return join(homedir(), ".dsh", "novels", clean);
 }
+const REVISION_SOURCE_LABELS = {
+	review: "审稿",
+	timeline: "时间线",
+	tension: "张力"
+};
+/** 固定优先级：数值越小越先改。 */
+function revisionPriority(source, severity) {
+	if (source === "review") return severity === "high" ? 0 : severity === "medium" ? 3 : 4;
+	if (source === "timeline") return severity === "high" ? 1 : 3;
+	return severity === "high" ? 2 : 2;
+}
+/** 同优先级的来源次序：审稿 > 时间线 > 张力（同级时先改让本章"判不过"的那一类）。 */
+const SOURCE_RANK = {
+	review: 0,
+	timeline: 1,
+	tension: 2
+};
+/**
+* 条目在**来源内部**的原始序号（id 末段）。
+* 必须按数值比较：字符串比较会得到 0,1,10,11,2… 的顺序，
+* 于是截断时先丢「第 3 条意见」却留下「第 11 条」——等于把靠前的意见丢了。
+*/
+function sequenceOf(item) {
+	const tail = item.id.slice(item.id.lastIndexOf(":") + 1);
+	const n = Number.parseInt(tail, 10);
+	return Number.isFinite(n) ? n : 0;
+}
+/** 去重键：同源 + 归一化问题描述（忽略空白与标点差异）。 */
+function dedupeKey(item) {
+	return `${item.source}|${item.item.replace(/[\s，。、；：,.!?！？"'"'（）()【】\[\]]/g, "").slice(0, 60)}`;
+}
+/** 排序 + 去重 + 截断。去重时保留优先级更高的那条，并累加 count。 */
+function mergeRevisionItems(items, cap = 8) {
+	const sorted = [...items].sort((a, b) => {
+		const byPriority = revisionPriority(a.source, a.severity) - revisionPriority(b.source, b.severity);
+		if (byPriority !== 0) return byPriority;
+		if (a.chapterNo !== b.chapterNo) return a.chapterNo - b.chapterNo;
+		if (a.source !== b.source) return SOURCE_RANK[a.source] - SOURCE_RANK[b.source];
+		const bySequence = sequenceOf(a) - sequenceOf(b);
+		if (bySequence !== 0) return bySequence;
+		return a.id.localeCompare(b.id);
+	});
+	const seen = /* @__PURE__ */ new Map();
+	const unique = [];
+	for (const item of sorted) {
+		const key = dedupeKey(item);
+		const dup = seen.get(key);
+		if (dup !== void 0) {
+			dup.count = (dup.count ?? 1) + 1;
+			continue;
+		}
+		seen.set(key, item);
+		unique.push(item);
+	}
+	const kept = unique.slice(0, cap);
+	return {
+		items: kept,
+		omitted: Math.max(0, unique.length - kept.length)
+	};
+}
+/** 时间线/张力问题是否落在目标章上（chapters 为空视为全书级，跟随目标章）。 */
+function matchesChapter(chapters, target) {
+	if (target === void 0) return true;
+	const list = chapters ?? [];
+	if (list.length === 0) return true;
+	return list.includes(target);
+}
+function pickChapterNo(chapters, target, fallback) {
+	if (target !== void 0 && matchesChapter(chapters, target)) return target;
+	return chapters?.[0] ?? fallback;
+}
+function timelineToItems(issues, target) {
+	const out = [];
+	issues.forEach((issue, i) => {
+		if (!matchesChapter(issue.chapters, target)) return;
+		out.push({
+			id: `timeline:${i}:${pickChapterNo(issue.chapters, target, 0)}`,
+			source: "timeline",
+			severity: issue.severity,
+			chapterNo: pickChapterNo(issue.chapters, target, 0),
+			item: issue.item,
+			suggestion: issue.suggestion
+		});
+	});
+	return out;
+}
+function tensionToItems(issues, target) {
+	const out = [];
+	issues.forEach((issue, i) => {
+		if (!matchesChapter(issue.chapters, target)) return;
+		out.push({
+			id: `tension:${i}:${pickChapterNo(issue.chapters, target, 0)}`,
+			source: "tension",
+			severity: issue.severity,
+			chapterNo: pickChapterNo(issue.chapters, target, 0),
+			item: issue.item,
+			suggestion: issue.suggestion
+		});
+	});
+	return out;
+}
+/** 汇总一章（或全书）的三类建议。纯函数，不改项目状态。 */
+function collectRevisionItems(project, options = {}) {
+	const target = options.chapterNo;
+	const items = [];
+	const chapters = (project.chapters ?? []).filter((c) => target === void 0 || c.no === target);
+	const explicit = options.reviewIssues;
+	if (explicit !== void 0) explicit.forEach((issue, i) => {
+		items.push({
+			id: `review:${target ?? 0}:${i}`,
+			source: "review",
+			severity: issue.severity,
+			chapterNo: target ?? 0,
+			item: issue.item,
+			suggestion: issue.suggestion
+		});
+	});
+	else for (const chapter of chapters) for (const [i, issue] of (chapter.review?.issues ?? []).entries()) items.push({
+		id: `review:${chapter.no}:${i}`,
+		source: "review",
+		severity: issue.severity,
+		chapterNo: chapter.no,
+		item: issue.item,
+		suggestion: issue.suggestion
+	});
+	if (options.includeTimeline ?? true) items.push(...timelineToItems(detectTimelineIssues(project), target));
+	if (options.includeTension ?? true) items.push(...tensionToItems(detectTensionIssues(project), target));
+	return items;
+}
+/** 渲染修订指令。格式与历史「按审稿意见修订」保持同族，模型无需重新学习。 */
+function renderRevisionInstruction(items, title = "按合并建议修订") {
+	const counts = {
+		review: 0,
+		timeline: 0,
+		tension: 0
+	};
+	for (const item of items) counts[item.source] += item.count ?? 1;
+	return `${title}${`（审稿 ${counts.review} · 时间线 ${counts.timeline} · 张力 ${counts.tension}）`}：\n${items.map((item) => {
+		const tag = `【${REVISION_SOURCE_LABELS[item.source]}·${item.severity}】`;
+		const where = item.chapterNo > 0 ? `第${item.chapterNo}章 ` : "";
+		const repeat = (item.count ?? 1) > 1 ? `（合并同类 ${item.count} 条）` : "";
+		const suggestion = item.suggestion.trim() === "" ? "" : `\n建议：${item.suggestion.trim()}`;
+		return `${tag}${where}${item.item}${repeat}${suggestion}`;
+	}).join("\n")}`;
+}
+/**
+* 构造验证基准：把时间线/张力条目转成「上一轮意见」的编号项，
+* 与审稿意见合并成一份报告。复核模型据此逐条核对，避免
+* 「审稿说已解决、时间线说没改」这类互相打架的判定。
+*/
+function buildRevisionBaseline(items, base) {
+	const issues = items.map((item) => ({
+		severity: item.severity,
+		item: item.source === "review" ? item.item : `[${REVISION_SOURCE_LABELS[item.source]}] ${item.item}`,
+		suggestion: item.suggestion
+	}));
+	return {
+		score: base?.score ?? 0,
+		passed: false,
+		verdict: base?.verdict ?? "本轮修订基准",
+		issues,
+		riskScore: base?.riskScore,
+		aiFlavor: base?.aiFlavor,
+		aiPhrases: base?.aiPhrases,
+		reviewedAt: base?.reviewedAt ?? (/* @__PURE__ */ new Date()).toISOString()
+	};
+}
+/** 汇总 → 排序 → 指令 → 基准。面板与生产单都走这里。 */
+function buildRevisionPlan(project, options = {}) {
+	const merged = mergeRevisionItems(collectRevisionItems(project, options), options.cap ?? 8);
+	const counts = {
+		review: 0,
+		timeline: 0,
+		tension: 0
+	};
+	for (const item of merged.items) counts[item.source] += item.count ?? 1;
+	return {
+		items: merged.items,
+		instruction: renderRevisionInstruction(merged.items, options.title),
+		counts,
+		omitted: merged.omitted,
+		baseline: buildRevisionBaseline(merged.items, options.baseReport)
+	};
+}
+/** 一行摘要，用于日志与面板提示（"审稿 3 · 时间线 1 · 张力 1，另截断 2 条"）。 */
+function describeRevisionPlan(plan) {
+	const parts = [];
+	if (plan.counts.review > 0) parts.push(`审稿 ${plan.counts.review}`);
+	if (plan.counts.timeline > 0) parts.push(`时间线 ${plan.counts.timeline}`);
+	if (plan.counts.tension > 0) parts.push(`张力 ${plan.counts.tension}`);
+	const head = parts.length === 0 ? "无可修订条目" : parts.join(" · ");
+	return plan.omitted > 0 ? `${head}（另截断 ${plan.omitted} 条）` : head;
+}
+/** 待办文本（生产单只提示不阻塞时写入项目待办，供作者人工决定）。 */
+function revisionTodoText(item) {
+	const where = item.chapterNo > 0 ? `第${item.chapterNo}章` : "全书";
+	return `[${REVISION_SOURCE_LABELS[item.source]}] ${where}：${item.item}`;
+}
 //#endregion
 //#region src/run.ts
 /**
@@ -9480,6 +9690,51 @@ var ProductionRunner = class {
 			chapter.status = "pending";
 			await this.produce(project, chapter);
 		}
+		this.auditChapterAdvisories(chapter.no);
+	}
+	/**
+	* 出章即核对曲线（建议性，不阻塞）：
+	* 规则初筛得到的时间线矛盾 + 张力曲线偏差写进运行日志；本章已完结时再落成项目待办。
+	* 默认**不**触发任何自动修订——要看/要改由作者在面板发起「一键按建议修订」；
+	* 只有当本章因审稿 high 本来就要修订时，这些问题才搭同一轮车（见 handleRejected），
+	* 因此不额外增加轮次，也不会出现「改完甲又违反乙」。
+	*/
+	auditChapterAdvisories(chapterNo) {
+		const config = this.deps.getConfig();
+		const outputDir = this.bookDir ?? config.outputDir;
+		const project = loadProject(outputDir);
+		if (project === void 0) return;
+		const chapter = project.chapters.find((c) => c.no === chapterNo);
+		if (chapter === void 0) return;
+		const plan = buildRevisionPlan(project, {
+			chapterNo,
+			reviewIssues: [],
+			includeTimeline: true,
+			includeTension: true
+		});
+		if (plan.items.length === 0) return;
+		this.log(`第${chapterNo}章 曲线/时间线核对：${describeRevisionPlan(plan)}——建议性提示，未自动改动`);
+		if (chapter.status !== "approved") return;
+		if (plan.counts.timeline === 0 && plan.counts.tension === 0) return;
+		const todos = project.todos ??= [];
+		const added = [];
+		for (const item of plan.items.slice(0, 3)) {
+			const text = revisionTodoText(item);
+			if (todos.some((t) => t.text === text)) continue;
+			todos.unshift({
+				id: `td-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`,
+				text,
+				source: "risk",
+				done: false,
+				createdAt: (/* @__PURE__ */ new Date()).toISOString()
+			});
+			added.push(text);
+		}
+		if (added.length > 0) {
+			project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+			saveProject(outputDir, project);
+			this.log(`第${chapterNo}章 已登记 ${added.length} 条建议性待办（可在时间线/张力面板一键按建议修订）`);
+		}
 	}
 	/** 完整质量门：生成 → 摘要+事实 → 伏笔标记 → 审稿 → 作者复盘。 */
 	async produce(project, chapter) {
@@ -9560,7 +9815,8 @@ var ProductionRunner = class {
 		const config = getConfig();
 		const outputDir = this.bookDir ?? config.outputDir;
 		const no = chapter.no;
-		const highs = (chapter.review?.issues ?? []).filter((i) => i.severity === "high");
+		const report = chapter.review;
+		const highs = (report?.issues ?? []).filter((i) => i.severity === "high");
 		if (highs.length === 0) {
 			chapter.status = "approved";
 			project.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
@@ -9569,9 +9825,15 @@ var ProductionRunner = class {
 			this.log(`第${no}章 豁免通过（无 high）`);
 			return;
 		}
-		this.log(`第${no}章 修订（${highs.length} 个 high）…`);
+		let plan = buildRevisionPlan(project, {
+			chapterNo: no,
+			reviewIssues: highs,
+			baseReport: report
+		});
+		this.log(`第${no}章 修订（${describeRevisionPlan(plan)}）…`);
+		if (plan.omitted > 0) this.log(`第${no}章 修订指令已截断 ${plan.omitted} 条（超出单轮上限，优先级低者留待下一轮）`);
 		for (let round = 1; round <= 2; round++) {
-			const instr = "按审稿意见修订（优先处理）：\n" + highs.map((h) => `[${h.severity}] ${h.item}${h.suggestion !== "" ? `\n建议：${h.suggestion}` : ""}`).join("\n\n");
+			const instr = plan.instruction;
 			try {
 				for await (const _step of rewriteChapterStream(ctx, config, project, outputDir, no, instr, void 0));
 			} catch (error) {
@@ -9585,7 +9847,7 @@ var ProductionRunner = class {
 				this.log(`第${no}章 第${round}轮草稿缺失，重试`);
 				continue;
 			}
-			const verify = await reviewChapterText(ctx, config, fresh, draft, chapter.review);
+			const verify = await reviewChapterText(ctx, config, fresh, draft, plan.baseline);
 			const highs2 = (verify.issues ?? []).filter((i) => i.severity === "high");
 			if (verify.passed || highs2.length === 0) {
 				this.applyDraft(fresh, freshCh, draft, verify);
@@ -9594,9 +9856,14 @@ var ProductionRunner = class {
 				return;
 			}
 			this.log(`第${no}章 第${round}轮仍不过（${highs2.length} high）`);
+			plan = buildRevisionPlan(fresh ?? project, {
+				chapterNo: no,
+				reviewIssues: highs2,
+				baseReport: verify
+			});
 		}
 		if (this.state !== null) this.state.pendingManual.push(no);
-		this.log(`第${no}章  两轮修订仍不过 → 保留草稿待人工`);
+		this.log(`第${no}章  2 轮修订仍不过 → 保留草稿待人工`);
 	}
 	applyDraft(project, chapter, draft, report) {
 		const config = this.deps.getConfig();
@@ -13046,6 +13313,49 @@ function makeRoutes(deps) {
 			}
 		}
 	};
+	/** 修订指令合并：POST { op: 'plan', chapterNo, reviewIssues? } → 一份合并指令 + 验证基准。
+	*  面板与生产单共用，保证「同一章只改一轮」；张力/时间线问题默认只是建议（advisory）。 */
+	const revisionPlanRoute = {
+		kind: "exact",
+		path: NOVEL_API.revisionPlan,
+		handler: async (req, res) => {
+			if (!guard(req, res, "POST")) return;
+			const config = getConfig();
+			const body = await readJsonBody(req);
+			const project = loadProject(resolveOutputDir(config, body?.bookId));
+			if (project === void 0) {
+				writeJson(res, 400, { error: "输出目录中没有项目" });
+				return;
+			}
+			const chapterNo = body?.chapterNo;
+			if (chapterNo !== void 0 && !project.chapters.some((c) => c.no === chapterNo)) {
+				writeJson(res, 404, { error: `章节 ${String(chapterNo)} 不在计划中` });
+				return;
+			}
+			const chapter = chapterNo === void 0 ? void 0 : project.chapters.find((c) => c.no === chapterNo);
+			try {
+				const plan = buildRevisionPlan(project, {
+					chapterNo,
+					reviewIssues: body?.reviewIssues,
+					includeTimeline: body?.includeTimeline,
+					includeTension: body?.includeTension,
+					baseReport: chapter?.review,
+					cap: 8
+				});
+				writeJson(res, 200, {
+					chapterNo: chapterNo ?? 0,
+					items: plan.items,
+					instruction: plan.instruction,
+					counts: plan.counts,
+					omitted: plan.omitted,
+					baseline: plan.baseline,
+					summary: describeRevisionPlan(plan)
+				});
+			} catch (error) {
+				writeJson(res, 500, { error: error.message });
+			}
+		}
+	};
 	/** 章节历史版本：GET 列表；POST op=create|restore|remove|prune。 */
 	const snapshotRoute = {
 		kind: "exact",
@@ -14928,6 +15238,7 @@ function makeRoutes(deps) {
 		llmPromptRoute,
 		usageResetRoute,
 		timelineRoute,
+		revisionPlanRoute,
 		snapshotRoute,
 		tensionRoute,
 		promptSlotsRoute,
@@ -15113,7 +15424,7 @@ const DEFAULT_AUTO_REVIEW_AFTER_REVISE = true;
 /** Order of the announcement section within the tool-guidance band. */
 const SECTION_ORDER = 160;
 /** Model-facing announcement: plugin presence, capabilities, and limits. */
-const NOVEL_GUIDANCE = "本机已安装 dsh-novel-forge 插件（AI 编译小说工作台）：侧边栏「小说工坊」入口。能力：读取 docx 大纲或粘贴大纲文本；用 LLM 提炼道藏（人设/世界观/金手指规则/写作红线）；生成卷计划与章节计划；逐章调用 LLM 生成 3000-4000 字正文并保存为 Markdown（默认输出到用户主目录 ~/.dsh/novels）；每章自动生成摘要（叙事记忆）、自动 AI 审稿（人设/设定/红线/文笔/爽点/逻辑），支持按审稿意见重写、去 AI 味润色、暗线（伏笔）管理、批量连写与全本导出（txt/md）。限制：生成消耗 LLM API 额度；输出目录与模型可在插件设置中修改；章节正文质量取决于大纲完整度。用户提到「小说 / 大纲 / 写小说 / 章节 / 审稿 / 润色」时即指本插件，请据此协作。";
+const NOVEL_GUIDANCE = "本机已安装 dsh-novel-forge 插件（AI 编译小说工作台）：侧边栏「小说工坊」入口。能力：读取 docx 大纲、粘贴大纲文本或把 txt 全本拆章导入；用 LLM 提炼道藏（人设/世界观/金手指规则/写作红线）与大世界（境界/区域/势力）；生成卷计划与结构化章节计划（本章目标/剧情要点/必达项/义务合约/章末钩子）；逐章生成 3000-4000 字正文并保存为 Markdown（默认输出到用户主目录 ~/.dsh/novels）；每章自动生成摘要与编年录事实、抽取故事时间线（故事内时间/地点/在场角色/事件）、自动 AI 审稿（人设/设定/红线/文笔/爽点/逻辑/反 AI/呈现/合规九维）与作者复盘；支持按审稿意见合并修订（审稿 high + 时间线矛盾 + 张力偏差合成一轮，每章最多两轮后转人工）、去 AI 味润色、章节历史版本回滚、暗线（伏笔）管理、剧情线与角色库、张力曲线、全书一致性质检与敏感词扫描、分范围导出与项目备份、批量连写（生产单，可暂停/续跑）。限制：所有 AI 操作消耗 LLM API 额度；输出目录与模型可在插件设置中修改；章节正文质量取决于大纲完整度；张力/时间线问题默认只是建议（写日志与待办），不会自动改正文。用户提到「小说 / 大纲 / 写小说 / 章节 / 审稿 / 润色」时即指本插件，请据此协作。";
 /** Resolve a config-like value into the full runtime config. */
 function resolveConfig(value) {
 	return {

package/lib/types/client/api.d.ts

@@ -3,7 +3,7 @@
  * fetch, same origin; generation/rewrite/polish ride NDJSON streams read
  * incrementally.
  */
-import { type AssetsPatch, type AssetsResponse, type AddModelRequest, type AddModelResponse, type LlmModelsResponse, type LlmProvidersResponse, type LlmVendorsResponse, type RemoveProviderRequest, type RemoveProviderResponse, type BibleResponse, type ChapterResponse, type ConfigPatch, type ExportResponse, type ForeshadowRequest, type ForeshadowResponse, type JobFrame, type LoadOutlineResponse, type AdaptExecuteRequest, type AdaptRewriteFrame, type AdaptMaterializeSaveRequest, type AdaptMaterializeSaveResponse, type PluginUpdateResponse, type LlmTestResponse, type NovelConfig, type PlanResponse, type ReviewReport, type StatusResponse, type StyleEngineRequest, type StyleAsset, type VolumesResponse } from '../protocol.ts';
+import { type AssetsPatch, type AssetsResponse, type AddModelRequest, type AddModelResponse, type LlmModelsResponse, type LlmProvidersResponse, type LlmVendorsResponse, type RemoveProviderRequest, type RemoveProviderResponse, type BibleResponse, type ChapterResponse, type ConfigPatch, type ExportResponse, type ForeshadowRequest, type ForeshadowResponse, type JobFrame, type LoadOutlineResponse, type AdaptExecuteRequest, type AdaptRewriteFrame, type AdaptMaterializeSaveRequest, type AdaptMaterializeSaveResponse, type PluginUpdateResponse, type LlmTestResponse, type NovelConfig, type PlanResponse, type ReviewReport, type RevisionPlanResponse, type StatusResponse, type StyleEngineRequest, type StyleAsset, type VolumesResponse } from '../protocol.ts';
 /** Error carrying the route's JSON error message. */
 export declare class NovelApiError extends Error {
     constructor(message: string);
@@ -39,6 +39,14 @@ export declare class NovelApi {
     chapterCheck(no: number, text: string, previousReport?: ReviewReport): Promise<{
         report: ReviewReport;
     }>;
+    /**
+     * 修订指令合并：把本章的审稿意见（勾选项）+ 时间线矛盾 + 张力偏差合成**一份**指令。
+     * 面板所有「按意见修订 / 一键按建议修订」入口都先走这里，保证同一章只改一轮。
+     */
+    revisionPlan(no: number, reviewIssues?: ReviewReport['issues'], opts?: {
+        includeTimeline?: boolean;
+        includeTension?: boolean;
+    }): Promise<RevisionPlanResponse>;
     /** 保存手动编辑的正文（自动备份 .bak；带报告则沿用落盘，否则保存后自动审稿）。 */
     chapterSave(no: number, text: string, report?: ReviewReport): Promise<import('../protocol.ts').ChapterSaveResponse>;
     patchConfig(patch: ConfigPatch): Promise<{

package/lib/types/client/locales.d.ts

@@ -1,57 +1,36 @@
 /**
- * dsh-novel-forge — locale dictionaries (zh / en).
+ * dsh-novel-forge — 面板文案词典（简体中文单语）。
+ *
+ * 定位说明：小说工坊面板是**中文单语界面**——这里就是全部用户可见文案的唯一定义处，
+ * 键位即类型（`NovelKey`），新增文案请同时在此登记，不要散落到组件里硬编码。
+ * 文档层（README / docs / CHANGELOG）仍提供英文对照，那是给人读的，不是界面语言。
  */
-/** zh dictionary. */
+/** 面板文案（简体中文）。 */
 export declare const zh: {
     readonly 'entry.label': "小说工坊";
     readonly 'entry.tooltip': "AI 编译小说工作台：总纲 → 道藏 → 卷计划 → 章节计划 → 逐章生成+审稿";
-    readonly 'panel.title': "小说工坊";
     readonly 'common.close': "关闭";
     readonly 'common.loading': "加载中…";
-    readonly 'common.save': "保存";
     readonly 'common.error': "错误";
-    readonly 'common.success': "成功";
-    readonly 'common.generating': "生成中…";
     readonly 'common.chars': "字";
     readonly 'tab.workflow': "工作台";
     readonly 'tab.overview': "总纲";
     readonly 'tab.plan': "章节";
-    readonly 'tab.bible': "道藏";
-    readonly 'tab.foreshadow': "暗线";
     readonly 'tab.assistant': "AI 编辑 Agent";
     readonly 'tab.settings': "设置";
-    readonly 'workflow.title': "创作工作台";
-    readonly 'workflow.step1': "① 加载总纲";
-    readonly 'workflow.step2': "② 提炼道藏";
-    readonly 'workflow.step3': "③ 规划卷";
-    readonly 'workflow.step4': "④ 生成章节计划";
-    readonly 'workflow.step5': "⑤ 逐章写作 + AI 审稿";
-    readonly 'workflow.step6': "⑥ 润色 / 导出";
-    readonly 'workflow.loadOutline': "读取总纲";
-    readonly 'workflow.genBible': "提炼道藏";
     readonly 'workflow.genVolumes': "生成卷计划";
-    readonly 'workflow.genPlan': "生成章节计划";
-    readonly 'workflow.done': "已完成";
-    readonly 'workflow.todo': "待办";
     readonly 'workflow.bibleDone': "道藏已生成（{n} 条规则 / {c} 个人物 / {r} 条红线）";
     readonly 'workflow.volumesDone': "卷计划已生成（{n} 卷）";
     readonly 'workflow.planDone': "章节计划已生成（{n} 章）";
-    readonly 'workflow.progress': "进度：总纲 ✓ · 道藏 {bible} · 卷 {volumes} · 计划 {plan} · 已完成 {done}/{total} 章";
-    readonly 'overview.loadDocx': "从 docx 读取总纲";
-    readonly 'overview.loadDocxDefault': "读取默认总纲";
     readonly 'overview.loadingOutline': "正在解析 docx…";
     readonly 'overview.outlineHint': "总纲文本（可编辑）";
     readonly 'overview.outlineChars': "总纲字数";
     readonly 'overview.saveOutline': "保存总纲";
     readonly 'overview.saved': "总纲已保存";
     readonly 'overview.bookName': "书名";
-    readonly 'overview.loadCustom': "指定 docx 路径";
-    readonly 'overview.loadCustomHint': "绝对路径，留空使用默认";
     readonly 'plan.generate': "生成章节计划";
     readonly 'plan.generateHint': "章节数量";
     readonly 'plan.count': "章";
-    readonly 'plan.empty': "暂无章节计划，请先生成";
-    readonly 'plan.chapter': "章";
     readonly 'plan.pending': "待生成";
     readonly 'plan.generating': "生成中";
     readonly 'plan.written': "待审稿";
@@ -63,21 +42,15 @@ export declare const zh: {
     readonly 'plan.rewrite': "修订";
     readonly 'plan.review': "审稿";
     readonly 'plan.polish': "去AI味";
-    readonly 'plan.writeAll': "批量生成全部";
     readonly 'plan.writeAllPending': "批量生成剩余";
-    readonly 'plan.generated': "已生成";
-    readonly 'plan.progress': "进度";
     readonly 'plan.beats': "剧情要点";
     readonly 'plan.reviewReport': "审稿报告";
     readonly 'plan.reviewScore': "评分";
     readonly 'plan.reviewVerdict': "总评";
-    readonly 'plan.reviewIssues': "问题清单";
     readonly 'plan.reviewPass': "通过";
     readonly 'plan.reviewFail': "未通过";
-    readonly 'plan.approve': "手动通过";
     readonly 'plan.summary': "章节摘要";
     readonly 'plan.volumes': "卷";
-    readonly 'plan.noVolume': "未分卷";
     readonly 'bible.title': "道藏";
     readonly 'bible.gen': "提炼道藏";
     readonly 'bible.genre': "题材基调";
@@ -89,7 +62,6 @@ export declare const zh: {
     readonly 'foreshadow.title': "暗线管理";
     readonly 'foreshadow.suggest': "建议暗线";
     readonly 'foreshadow.none': "暂无暗线";
-    readonly 'foreshadow.status': "状态";
     readonly 'foreshadow.planned': "计划中";
     readonly 'foreshadow.planted': "已埋设";
     readonly 'foreshadow.progressing': "推进中";
@@ -99,7 +71,6 @@ export declare const zh: {
     readonly 'foreshadow.plantedAt': "埋设于";
     readonly 'foreshadow.setPlanted': "标记已埋设";
     readonly 'foreshadow.setResolved': "标记已回收";
-    readonly 'tab.facts': "编年录";
     readonly 'tab.plotlines': "剧情线";
     readonly 'plotlines.hint': "主线/支线/人物线/悬念线的推进管理：章节生成时会注入未完结的线，要求每章至少推进一条；关联章节记录推进节点。";
     readonly 'plotlines.empty': "还没有剧情线——长篇小说建议先建主线与几条支线。";
@@ -121,11 +92,7 @@ export declare const zh: {
     readonly 'plotlines.cancel': "取消";
     readonly 'plotlines.edit': "编辑";
     readonly 'plotlines.remove': "删除";
-    readonly 'plotlines.linkChapter': "关联本章";
     readonly 'plotlines.chapters': "已关联";
-    readonly 'plotlines.workflowTitle': "剧情线进度";
-    readonly 'plotlines.workflowEmpty': "未建剧情线（去「剧情线」页创建）";
-    readonly 'sensitive.title': "敏感词检查";
     readonly 'sensitive.scanAll': " 全书敏感词检查";
     readonly 'sensitive.hint': "内置违禁词库硬匹配（政治/擦边/暴力/辱骂/广告/其他），发布前建议检查；只做提示，是否修改由你判断。";
     readonly 'sensitive.clean': " 未命中任何违禁词（扫描 {n} 章）";
@@ -135,9 +102,6 @@ export declare const zh: {
     readonly 'facts.title': "编年录 / 时间线（{n} 条）";
     readonly 'facts.hint': "每章生成后自动抽取「已确立事实」（人物状态/境界资源/关系变化/伏笔落地），最近 20 条注入后续章节生成，保证长期一致。";
     readonly 'facts.backfill': "回填历史章节事实";
-    readonly 'facts.backfilled': "已从历史章节回填 {n} 条事实";
-    readonly 'settings.title': "设置";
-    readonly 'settings.outlinePath': "默认大纲路径";
     readonly 'settings.outputDir': "输出目录";
     readonly 'settings.provider': "模型提供商";
     readonly 'settings.model': "模型";
@@ -146,13 +110,7 @@ export declare const zh: {
     readonly 'settings.edit': "编辑";
     readonly 'settings.delete': "删除";
     readonly 'settings.modelCustomPlaceholder': "输入任意模型 id";
-    readonly 'settings.savedModels': "我的模型";
-    readonly 'settings.modelCards': "模型卡片（内置 + 已添加）";
-    readonly 'settings.savedModelName': "名称";
-    readonly 'settings.addModel': "添加模型";
-    readonly 'settings.catalogRefresh': "刷新厂商";
     readonly 'settings.refreshModels': "刷新模型";
-    readonly 'settings.savedModelsHint': "手动添加常用模型（provider + 模型 id），点击即可切换当前模型；厂商模式会写入 DSH 凭据并注册路由。";
     readonly 'settings.testConnection': "测试连通";
     readonly 'settings.testRunning': "测试中";
     readonly 'settings.testOk': "连通";
@@ -167,15 +125,9 @@ export declare const zh: {
     readonly 'settings.reasoning.low': "low · 低思考";
     readonly 'settings.reasoning.high': "high · 高思考";
     readonly 'settings.reasoning.max': "max · 最高思考（质检/推演）";
-    readonly 'settings.theme': "主题";
-    readonly 'settings.themeLiquid': "iOS 液态玻璃（绿）";
-    readonly 'settings.themeNeumorph': "新拟物（双阴影）";
-    readonly 'settings.themeHint': "存于浏览器本地，即时生效";
     readonly 'settings.chapterChars': "每章目标字数";
     readonly 'settings.maxTokens': "单章最大输出 tokens";
     readonly 'settings.reviewPassScore': "审稿通过分数（0-100）";
-    readonly 'settings.editorFontSize': "编辑器字号（仅编辑页显示）";
-    readonly 'settings.editorFontSizeHint': "存于浏览器本地，不影响其他设备";
     readonly 'settings.autoReview': "生成后自动审稿";
     readonly 'settings.autoAuthorReview': "生成后自动作者复盘";
     readonly 'settings.autoAuthorReviewHint': "复盘钩子兑现/结尾钩子/剧情线推进/连续性/节奏趋势，每章约 2000 token";
@@ -184,7 +136,6 @@ export declare const zh: {
     readonly 'settings.save': "保存设置";
     readonly 'settings.saved': "设置已保存";
     readonly 'settings.openFolder': "打开输出文件夹";
-    readonly 'settings.export': "导出";
     readonly 'settings.exportTxt': "导出 TXT";
     readonly 'settings.exportMd': "导出 Markdown";
     readonly 'settings.exported': "已导出：{file}（{chars} 字，{chapters} 章）";
@@ -194,19 +145,12 @@ export declare const zh: {
     readonly 'progress.error': "第 {no} 章失败：{message}";
     readonly 'progress.rewriting': "正在修订第 {no} 章…";
     readonly 'progress.polishing': "正在润色第 {no} 章…";
-    readonly 'progress.empty': "生成/审稿进度将显示在这里";
     readonly 'assistant.hint': "和 AI 编辑 Agent 讨论剧情、人设、暗线；达成一致后可让它直接修改总纲、道藏、章节内容。";
     readonly 'assistant.placeholder': "例如：我想让第 2 章结尾加一个悬念——墟境里传来爷爷的声音…";
     readonly 'assistant.send': "发送";
-    readonly 'assistant.toolStart': " 执行操作：{name}…";
-    readonly 'assistant.toolDone': "✓ {name} 完成：{detail}";
-    readonly 'assistant.toolError': "✗ {name} 失败：{detail}";
     readonly 'assistant.empty': "还没有对话。和 AI 编辑 Agent 聊聊剧情吧。";
     readonly 'status.projectNone': "输出目录中还没有项目。请先加载大纲。";
     readonly 'status.files': "已生成文件";
-    readonly 'api.error': "请求失败";
 };
-/** en dictionary (fallback). */
-export declare const en: Record<string, string>;
-/** Keys type for the zh dictionary. */
+/** 面板文案键位（= zh 词典的键）。 */
 export type NovelKey = keyof typeof zh;

package/lib/types/client/panel/TensionView.d.ts

@@ -10,5 +10,9 @@
 import type { NovelApi } from '../api.ts';
 export interface TensionViewProps {
     api: NovelApi;
+    /** 一键按建议修订（合并审稿/张力/时间线后改这一章；由父级统一发起）。 */
+    onRevise?: (chapterNo: number) => void;
+    /** 外部忙碌态（修订进行中时禁用按钮）。 */
+    busy?: boolean;
 }
-export default function TensionView({ api }: TensionViewProps): JSX.Element;
+export default function TensionView({ api, onRevise, busy: outerBusy }: TensionViewProps): JSX.Element;

package/lib/types/client/panel/TimelineView.d.ts

@@ -10,5 +10,9 @@ export interface TimelineViewProps {
     api: NovelApi;
     /** 章节号列表（用于「抽取本章」下拉）。 */
     chapters: number[];
+    /** 一键按建议修订（合并审稿/时间线/张力后改这一章；由父级统一发起）。 */
+    onRevise?: (chapterNo: number) => void;
+    /** 外部忙碌态（修订进行中时禁用按钮）。 */
+    busy?: boolean;
 }
-export default function TimelineView({ api, chapters }: TimelineViewProps): JSX.Element;
+export default function TimelineView({ api, chapters, onRevise, busy: outerBusy }: TimelineViewProps): JSX.Element;