dsh-vscode-mode 0.23.2 → 0.23.4

package/lib/index.js

@@ -7649,6 +7649,25 @@ function reviewPage(cwd, cursor = 0, history = false, path) {
 		}))]
 	};
 }
+/**
+* @public
+* @author ddj 2026年10月31号
+* @description: 该文件是否还有未处理的官方待审改动。缺失文件预览据此区分「需要去差异栏 Keep 结案」
+* 与「记录都已处理、可直接关闭标签页」，避免已结案的删除文件继续提示待审。
+* @param cwd Migrated workspace
+* @param path Host path of the file
+* @returns 存在未决官方记录时为 true
+*/
+function officialPending(cwd, path) {
+	if (typeof path !== "string") return false;
+	const db = dbFor(cwd);
+	if (!db.prepare("SELECT 1 FROM sqlite_master WHERE name='review_files' AND type='table'").get()) return false;
+	if (path.length > 1 && path[1] === ":") {
+		const folded = path.split(String.fromCharCode(92)).join("/").toLowerCase();
+		return !!db.prepare("SELECT 1 FROM review_files WHERE current=1 AND decision='pending' AND lower(replace(identity,char(92),'/'))=? LIMIT 1").get(folded);
+	}
+	return !!db.prepare("SELECT 1 FROM review_files WHERE current=1 AND decision='pending' AND identity=? LIMIT 1").get(path);
+}
 /** @public @author ddj 2026年10月26号 @param cwd Migrated workspace. @param path Legacy write target. @returns Whether any official version owns the file, including decided history. */
 function hasOfficial(cwd, path) {
 	if (typeof path !== "string") return false;
@@ -7926,20 +7945,31 @@ function installCapture(ctx, onSnapshot) {
 			log.warn("官方历史补采不可用：缺少 sessionQuery；后续实时事件仍会采集");
 			return;
 		}
+		const source = ctx.get("workspaceChanges");
+		if (!source?.summary) {
+			log.warn("官方历史补采不可用：缺少 workspaceChanges；后续实时事件仍会采集");
+			return;
+		}
 		try {
 			if (session.header?.cwd) {
 				await loadBucket(ctx, session.header.cwd);
 				await repairPaths(session.header.cwd, resolvePath);
 			}
 			const events = await query.listEvents(session.id);
+			let expired = 0;
 			for (const event of events) {
 				if (event.type !== "workspace/changes" || event.seq < (session.inheritedEventCount ?? 0)) continue;
+				if (!source.summary(session.id, event.seq)) {
+					expired += 1;
+					continue;
+				}
 				const window = await query.readEvent({
 					sessionId: session.id,
 					seq: event.seq
 				});
 				collector.enqueue(session, window.target);
 			}
+			if (expired) log.info(`官方历史补采跳过 ${expired} 轮已失效事件：官方 summary 不跨宿主重启保留，实时事件照常采集`);
 		} catch (error) {
 			log.warn("官方历史补采失败：" + String(error));
 		}
@@ -16015,6 +16045,39 @@ function batchSnapshot(cwd, pending) {
 	};
 }
 /**
+* @private
+* @author ddj 2026年10月31号
+* @description: 文件已在磁盘删除时修正官方记录的能力说明。Keep 只写审查库、仍可结案，
+* Undo 需要读写源文件、必然不可用：把「缺少原始字节」这种误导性原因换成可执行说明。
+* 只改文案与 undo 位，不参与判定写入。
+* @param ctx Host 能力
+* @param cwd 工作区
+* @param detail 官方记录详情
+* @param capability 已按冷/热端调整过的能力
+* @returns 修正后的能力；无法确认删除时原样返回
+*/
+async function absenceCapability(ctx, cwd, detail, capability) {
+	if (!capability.keep) return capability;
+	if (detail.diff.kind === "text" && !detail.diff.after) return {
+		...capability,
+		undo: false,
+		reason: "该记录删除了这个文件：Keep 按删除结案；Undo 需要完整文件内容，官方差异只有片段，不可用。"
+	};
+	const fs = ctx.get("fs");
+	if (!fs) return capability;
+	try {
+		const target = await resolveTargetIn(ctx, cwd, detail.item.currentPath);
+		if (await fs.stat(target)) return capability;
+	} catch {
+		return capability;
+	}
+	return {
+		...capability,
+		undo: false,
+		reason: "文件已在磁盘删除：Keep 按删除结案；Undo 需要读写该文件，当前不可用。"
+	};
+}
+/**
 * @public
 * @author ddj 2026年10月26号 / 2026年10月28号
 * @description: 审查 RPC 处理器。工作区一律由 host 解析，绝不采信调用方 cwd：
@@ -16160,7 +16223,7 @@ function reviewHandlers(ctx, registry) {
 					error: "官方审查记录不存在"
 				};
 			}
-			const capability = liveCapabilityOf(detail.capability, scope.live, false);
+			const capability = await absenceCapability(ctx, cwd, detail, liveCapabilityOf(detail.capability, scope.live, false));
 			log.debug(`[review] detail live=${scope.live ? 1 : 0} id=${args.id} found=1 keep=${capability.keep ? 1 : 0} undo=${capability.undo ? 1 : 0}`);
 			return {
 				ok: true,
@@ -16470,6 +16533,29 @@ function pendingHandlers(ctx, registry) {
 /** Missing historical files: frozen, whole-file deletion reviews. */
 const frozen = /* @__PURE__ */ new Map();
 const locks = /* @__PURE__ */ new Set();
+/**
+* @public
+* @author ddj 2026年10月31号
+* @description: 给缺失文件预览的可预期拒绝挂稳定错误码。客户端据此显示终态说明，
+* 而不是把内部错误原文当「加载失败」反复重试；也不让上游把 SQLite 报错原文透给编辑器。
+* @param code 稳定错误码（official-covered / no-records / no-evidence / too-large）
+* @param message 可读原因
+* @returns 带 code 的 Error
+*/
+function refusal(code, message) {
+	return Object.assign(new Error(message), { code });
+}
+/**
+* @public
+* @author ddj 2026年10月31号
+* @description: 从任意错误里取回缺失文件预览的稳定拒绝码；不是本模块抛出的错误一律返回 undefined。
+* @param error 捕获到的错误
+* @returns 稳定拒绝码或 undefined
+*/
+function refusalCodeOf(error) {
+	const code = error?.code;
+	return code === "official-covered" || code === "official-decided" || code === "no-records" || code === "no-evidence" || code === "too-large" ? code : void 0;
+}
 /** @private @author ddj 2026年10月28号 @param target Resolved absolute path. @returns Platform file identity. */
 function fileKey(target) {
 	const normalized = resolve(target).replace(/\\/g, "/");
@@ -16520,13 +16606,16 @@ async function fileAbsent(ctx, cwd, path) {
 async function missingReview(ctx, session, cwd, bucket, path) {
 	const abs = targetPathOf(ctx, await resolveTargetIn(ctx, cwd, path));
 	if (!abs) throw new Error("无法解析目标文件路径");
-	if (hasOfficial(cwd, path) || hasOfficial(cwd, abs)) throw new Error("该文件已有官方审查记录，请使用官方审查入口");
+	if (hasOfficial(cwd, path) || hasOfficial(cwd, abs)) {
+		if (!officialPending(cwd, abs) && !officialPending(cwd, path)) throw refusal("official-decided", "该文件已在磁盘删除，官方审查记录均已处理：可直接关闭该标签页");
+		throw refusal("official-covered", "该文件已有官方审查记录（磁盘上已删除）：请在差异栏对该待审条目执行 Keep 结案；整文件删除预览只适用于待审历史记录");
+	}
 	if (!await fileAbsent(ctx, cwd, abs)) throw new Error("文件已重新出现，请刷新");
 	const records = await fileRecords(ctx, cwd, bucket, abs);
 	const latest = records.at(-1);
-	if (!records.some((record) => !record.archived && !recordResolved(record))) throw new Error("没有待审历史记录");
-	if (!latest || typeof latest.after !== "string") throw new Error("缺少可靠的完整历史快照，无法展示或恢复；不会用局部差异拼接文件");
-	if (Buffer.byteLength(latest.after, "utf8") > 8388608) throw new Error("历史快照过大，无法整文件预览");
+	if (!records.some((record) => !record.archived && !recordResolved(record))) throw refusal("no-records", "磁盘上已没有该文件，且没有待审历史记录：可直接关闭该标签页");
+	if (!latest || typeof latest.after !== "string") throw refusal("no-evidence", "磁盘上已没有该文件，且缺少可靠的完整历史快照，无法展示或恢复；不会用局部差异拼接文件");
+	if (Buffer.byteLength(latest.after, "utf8") > 8388608) throw refusal("too-large", "磁盘上已没有该文件，且历史快照过大，无法整文件预览");
 	for (const [token, item] of frozen) if (item.expires < Date.now()) frozen.delete(token);
 	if (frozen.size >= 256) throw new Error("缺失文件预览过多，请稍后重试");
 	const view = {
@@ -17316,9 +17405,11 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 					review: await missingReview(ctx, sc.session, sc.cwd, bucket, args.path)
 				};
 			} catch (error) {
+				const code = refusalCodeOf(error);
 				return {
 					ok: false,
-					error: String(error)
+					error: String(error),
+					...code ? { code } : {}
 				};
 			}
 		},