dsh-vscode-mode 0.21.0 → 0.21.2

package/README.md

@@ -477,18 +477,19 @@ DSH 每次启动监听随机端口，`http://127.0.0.1:<port>` 就是浏览器 o
 
 官方 `dsh plugin` 方式，三选一。下面以 `web` profile 为例；Desktop 或其他命名
 profile 请替换为实际目标，不要把示例目录当成当前运行 profile。升级前可阅读
-**v0.21.0** 新增 XLSX 基础编辑与浏览器导出副本，原件不自动写回，高级应用通过官方 Host 打开；官方差异定位统一 BOM 与 LF/CRLF/混合行尾口径，并区分内容缺失和多处命中。定位修复不扩展 CRLF patch Undo 能力，目标官方记录 ↑/↓ 的真实点击验收仍保留缺口。保留 **v0.20.5** 跨 DSH 实例只读互通——桌面端与 Web 端各自运行独立宿主时，官方审查列表/详情与工作区只读接口改按持久化会话头的 cwd 解析，另一实例创建的会话也能只读打开官方差异栏，写入类接口仍要求本端活跃会话。保留 **v0.20.4** 统一两套差异栏外观——非官方记录栏角标由内部术语「侧车记录」改为「历史改动」，悬停说明 Keep 只标记已看过、不改写磁盘，Undo 逐项校验后写回，两者都不影响官方审查；官方元数据不可用时给出可读原因与重试按钮，不再静默降级；「会话没在当前端激活」由红色告警改为中性说明。保留 v0.20.3 修复官方差异全部无法定位时差异栏无提示、上下箭头静默禁用（显示「无可跳转」与失效原因，Keep 说明只标记已采纳、不改写磁盘，会话缺失等宿主错误改为可读提示）、v0.20.2 的 MCP 状态告警收敛与原生确认弹窗，以及 v0.20.1 的文件内差异展示、块级/文件级安全审查和跨分页批量操作。升级后重启 DSH 并刷新页面；持久化与回退边界见 [0.20.0 发布说明](docs/release-0.20.0.md)；从 0.14.2 或更旧版本升级还须阅读
+**v0.21.2** 的新版 DSH 会话 Controller 与 MCP 公开工具目录适配：任务发送按目标会话持有生命周期，受理不明时不跨通道重发；文件范围引用的剪贴板与降级文本保留行区间；MCP 初始化失败增加脱敏持久化诊断。当前 Web Host 已完成真实 CodeGraph 调用，但首次连接偶发超时根因尚未证实，不宣称已修复，见 [0.21.2 发布说明](docs/release-0.21.2.md)。保留以下历史版本能力与验收边界：
+**v0.21.1** 修复缺失历史文件：按完整快照显示整文件删除，Keep 保留删除、Undo 安全恢复快照，预览只读且拒绝覆盖重新出现的文件；真实 GUI 验收缺口已明确保留，见 [0.21.1 发布说明](docs/release-0.21.1.md)。保留 **v0.21.0** 新增 XLSX 基础编辑与浏览器导出副本，原件不自动写回，高级应用通过官方 Host 打开；官方差异定位统一 BOM 与 LF/CRLF/混合行尾口径，并区分内容缺失和多处命中。定位修复不扩展 CRLF patch Undo 能力，目标官方记录 ↑/↓ 的真实点击验收仍保留缺口。保留 **v0.20.5** 跨 DSH 实例只读互通——桌面端与 Web 端各自运行独立宿主时，官方审查列表/详情与工作区只读接口改按持久化会话头的 cwd 解析，另一实例创建的会话也能只读打开官方差异栏，写入类接口仍要求本端活跃会话。保留 **v0.20.4** 统一两套差异栏外观——非官方记录栏角标由内部术语「侧车记录」改为「历史改动」，悬停说明 Keep 只标记已看过、不改写磁盘，Undo 逐项校验后写回，两者都不影响官方审查；官方元数据不可用时给出可读原因与重试按钮，不再静默降级；「会话没在当前端激活」由红色告警改为中性说明。保留 v0.20.3 修复官方差异全部无法定位时差异栏无提示、上下箭头静默禁用（显示「无可跳转」与失效原因，Keep 说明只标记已采纳、不改写磁盘，会话缺失等宿主错误改为可读提示）、v0.20.2 的 MCP 状态告警收敛与原生确认弹窗，以及 v0.20.1 的文件内差异展示、块级/文件级安全审查和跨分页批量操作。升级后重启 DSH 并刷新页面；持久化与回退边界见 [0.20.0 发布说明](docs/release-0.20.0.md)；从 0.14.2 或更旧版本升级还须阅读
 [0.14.3 数据迁移与回退说明](docs/release-0.14.3.md)。
 
 ```bash
 # ① Git 安装（clone + prepare 构建；推荐打固定 tag）
-dsh plugin --profile web add github:Lenonss/DSH_VsCodeMode#v0.21.0
+dsh plugin --profile web add github:Lenonss/DSH_VsCodeMode#v0.21.2
 
 # ② npm 注册表（发布到 npm 后）
-dsh plugin --profile web add dsh-vscode-mode@0.21.0
+dsh plugin --profile web add dsh-vscode-mode@0.21.2
 
 # ③ GitHub Release tgz 直装（Release asset 可用后）
-dsh plugin --profile web add https://github.com/Lenonss/DSH_VsCodeMode/releases/download/v0.21.0/dsh-vscode-mode-0.21.0.tgz
+dsh plugin --profile web add https://github.com/Lenonss/DSH_VsCodeMode/releases/download/v0.21.2/dsh-vscode-mode-0.21.2.tgz
 ```
 
 > **DSH 版本政策（0.17.0 起）**：六项 DSH peer 仍统一声明为 `*`，另以
@@ -829,6 +830,8 @@ Keep All / Undo All 却是亮的。修复：单文件 Keep / Undo 覆盖冲突
 完整变更见 [GitHub Releases](https://github.com/Lenonss/DSH_VsCodeMode/releases)。
 近期关键版本：
 
+- **v0.21.2**：适配新版 DSH Session Controller 与 MCP 公开工具目录；固定目标任务发送持有会话直到完成或卸载，受理不明时不跨通道重发。范围文件引用的模型文本、剪贴板与纯文本降级保持一致。MCP 初始化失败记录阶段、耗时和脱敏错误链；迁移官方 native/PTC 执行器集成测试并增加可选真实 CodeGraph stdio 验证。当前 Web Host 真实工具调用已通过，首次连接偶发超时根因仍未证实；不自动部署或重启。见 [发布说明](docs/release-0.21.2.md)。
+- **v0.21.1**：缺失历史文件读取完整快照并整文件显示删除行；Keep 保留删除，Undo 安全恢复当前展示快照，不覆盖重新出现的文件。删除预览只读，单文件和批量操作统一处理，记录变化或证据不足时停止。真实 GUI 验收缺口已获用户接受；发布不自动部署，升级后重启 DSH 并刷新页面。见 [发布说明](docs/release-0.21.1.md)。
 - **v0.21.0**：新增 XLSX 基础编辑、多工作表与浏览器导出副本，原件不自动写回；不支持结构只读预览，高级应用经官方 Host 打开原件。编辑状态仅在当前页面内保留，不承诺刷新或崩溃恢复。官方差异定位统一 BOM 与 LF/CRLF/混合行尾口径，区分内容缺失与多处命中，保持原始字节及写回校验边界；不扩展 CRLF patch Undo 能力，目标官方记录 ↑/↓ 的真实点击仍未验收。升级后重启 DSH 并刷新页面；发布不自动部署当前实例。
 - **v0.20.5**：**跨实例官方审查数据只读互通**——桌面端与 Web 端各自运行独立 DSH 宿主时，会话只存在于创建它的宿主内存里，插件原先一律用本进程的活跃会话解析工作区，另一端打开官方差异栏会拿到「会话不存在」并退化成历史改动栏。现在官方审查列表/详情与工作区只读接口（文件读取、原始字节、分页文本、记录桶、归档列表、目录列表、界面状态镜像）改为按持久化会话头的 cwd 解析：只要会话在共享的 `~/.dsh/sessions` 下留有会话头，其他实例即可只读访问它的官方审查数据；写入类接口（保存、回滚、采纳/拒绝、批量决策）仍要求本端活跃会话，避免两个宿主并发写同一工作区的审查库。已知限制：会话内 `cd` 过的记录只能按创建时的 cwd 冷读；桌面端本版本未重新部署，反向仍不可用。升级后重启 DSH 并刷新页面。
 - **v0.20.4**：**两套差异栏不再互相冒充，内部术语退出界面**——插件本来并存官方审查栏与另一条历史记录栏（旧机制把每次改动留痕写进工作区 `.dsh-edit-review.json`），过去两者外观相同、无任何标识，容易被误认为插件未升级。现在非官方栏使用与官方栏同一套版式，但角标改为「历史改动」并在悬浮说明里讲清：这些改动没有进入官方审查列表，Keep 只标记看过、不改文件，Undo 会校验后写回，两者都不影响官方审查；设置页的「侧车摘要」一并对齐为日常说法。官方元数据通道失败（`edrv.review.list` 报错，如 `会话不存在`，或宿主未提供官方文件导航）时，在栏上方给出可读原因与重试按钮，不再静默降级；其中「会话没在当前端激活」由红色告警改为中性说明并存原始详情，真正的磁盘/回滚冲突错误仍保持红色。仅调整展示层，未改动数据库结构、决策语义与回退校验。

package/lib/client.js

@@ -377810,6 +377810,44 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			return regions;
 		}
 		//#endregion
+		//#region src/client/missingReview.ts
+		/** @public @author ddj 2026年10月28号 @param review Frozen complete snapshot. @returns One whole-file deletion, including empty files; no invented current lines. */
+		function missingRegion(review) {
+			return {
+				callId: review.callIds[0],
+				idx: 0,
+				start: 1,
+				end: 1,
+				oldStart: 1,
+				oldLines: splitLines(review.content.replace(/\r\n/g, "\n")),
+				newLines: [],
+				whole: true,
+				status: "pending",
+				create: false,
+				superseded: false,
+				sourceKind: "missing"
+			};
+		}
+		/** @public @author ddj 2026年10月28号 @param paths Batch paths. @param api Guarded Host access. @returns Missing paths handled once; a partial failure stops before legacy hunk writes. @throws Missing evidence, changed lifecycle or Host decision failure. */
+		async function missingBatch(paths, api) {
+			const candidates = [];
+			for (const path of new Set(paths)) {
+				api.guard();
+				const result = await api.query(path);
+				if (!result.ok) throw new Error(result.error);
+				if (result.review) candidates.push(result.review);
+			}
+			const completed = /* @__PURE__ */ new Set();
+			for (const review of candidates) {
+				api.guard();
+				const result = await api.decide(review, api.operation(review));
+				if (!result.ok) throw new Error(`已处理 ${completed.size} 个删除文件，其余未处理。${result.error}`);
+				completed.add(review.path);
+				api.committed(review, result.callIds);
+			}
+			return completed;
+		}
+		//#endregion
 		//#region src/client/editorModelState.ts
 		/** Monaco 编辑器实例选择器（限定在插件编辑器行内，排除官方预览等其它 Monaco）。 */
 		const EDITOR_MODEL_SELECTOR = ".edrv-editor-row .monaco-editor";
@@ -382728,7 +382766,10 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				onUndoAll: props.onUndoAllFiles,
 				keepTitle: "把这批历史改动全部标记为已看过（只改记录，不动磁盘文件）",
 				undoTitle: "逐项撤销这些历史改动；缺少证据或遇到冲突即停止"
-			}), busy ? /* @__PURE__ */ react$1.default.createElement("div", {
+			}), props.missingDeletion ? /* @__PURE__ */ react$1.default.createElement("div", {
+				className: "edrv-review-notice",
+				role: "status"
+			}, "文件已删除 · 展示最后记录快照。Keep 保留删除；Undo 恢复展示的完整快照。") : null, busy ? /* @__PURE__ */ react$1.default.createElement("div", {
 				className: "edrv-review-notice",
 				role: "status"
 			}, "正在处理历史改动…") : null, down ? /* @__PURE__ */ react$1.default.createElement("div", {
@@ -382766,7 +382807,7 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				icon: barIcon("undo"),
 				onClick: props.onUndoFile,
 				disabled: !canDecide,
-				title: SIDECAR_UNDO_TITLE
+				title: props.missingDeletion ? "恢复展示的完整历史快照（不会覆盖重新出现的文件）" : SIDECAR_UNDO_TITLE
 			}, "Undo"), /* @__PURE__ */ react$1.default.createElement(_deepseek_ai_dsh_client_ui_primitives.Button, {
 				size: "sm",
 				variant: "primary",
@@ -382774,7 +382815,7 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				icon: barIcon("check"),
 				onClick: props.onAcceptFile,
 				disabled: !canDecide,
-				title: SIDECAR_KEEP_TITLE
+				title: props.missingDeletion ? "保持文件删除并结清覆盖的待审历史记录，不写文件" : SIDECAR_KEEP_TITLE
 			}, "Keep"), /* @__PURE__ */ react$1.default.createElement(_deepseek_ai_dsh_client_ui_primitives.Button, {
 				size: "sm",
 				variant: "ghost",
@@ -384367,25 +384408,57 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			if (!range || range.endLine < range.startLine) return mention;
 			return range.startLine === range.endLine ? `${mention} L${range.startLine}` : `${mention} L${range.startLine}-${range.endLine}`;
 		}
-		/** 构造 DSH 文件引用插入载荷（source=reference，发送序列化为 mention(+range) 文本）。
+		/** 构造 DSH 文件引用插入载荷，模型文本、剪贴板投影与降级文本共用完整行区间。
+		* @public
+		* @author ddj 2026年10月28号
+		* @returns 引用载荷与含可选行区间的完整引用文本
 		* @param path 目标路径（相对 cwd 或绝对）
 		* @param cwd 会话工作区目录（可选）
 		* @param range 行区间（可选）
 		* @param appearance 引用外观：'file'（默认）| 'folder'
 		*/
 		function buildFileRef(path, cwd, range, appearance = "file") {
-			const mention = mentionOf(path, cwd);
+			const mention = refOf(mentionOf(path, cwd), range);
 			return {
 				mention,
 				reference: {
 					source: REF_SOURCE,
-					ref: refOf(mention, range),
+					ref: mention,
 					label: labelOf(path, range),
 					appearance,
 					clipboardText: mention
 				}
 			};
 		}
+		/** @private @author ddj 2026年10月28号 @param ctx Lifecycle owner. @param sessions Public Controller. @param id Fixed target. @param text Task body. @returns Acceptance; failures never retry another transport. @sideEffects Retains one generation until completion or unload. */
+		async function sendOwned(ctx, sessions, id, text) {
+			const controller = new AbortController();
+			const reference = sessions.retain(id, {
+				source: "controllerOperation",
+				signal: controller.signal
+			});
+			let released = false;
+			/** @private @author ddj 2026年10月28号 Cancel pending admission and release this exact generation once. */
+			function release() {
+				if (released) return;
+				released = true;
+				controller.abort();
+				reference.release();
+			}
+			let remove;
+			try {
+				remove = ctx.effect?.(() => release, "vscode-mode: task session reference");
+				const binding = await reference.ready;
+				if (controller.signal.aborted) return false;
+				return (await binding.session.prompt([{
+					type: "text",
+					text
+				}], "queue", controller.signal)).ok === true;
+			} finally {
+				release();
+				remove?.();
+			}
+		}
 		/** apiproxy wire 端点（POST /api/<method>；浏览器同源 fetch 自带 cookie 鉴权；实证 401=未鉴权而非 404）。 */
 		const SESSION_CREATE_PATH = "/api/session/create";
 		/** apiproxy wire 端点：发送任务（session/prompt；点击即发送方案）。 */
@@ -384484,8 +384557,9 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 		}
 		/**
 		* 新建独立会话承载旁路任务（02-deep-session-prompt：深度分析不污染当前对话）。
-		* 主路径 = apiproxy wire 直调（不依赖 service 面形态猜测）；回落 remote.session.create
-		* 与旧 sessions.create 两代 service 面（宽松解析）。任一步不符返回 ok:false，调用方降级。
+		* 优先公开 sessions.create；旧 Host 按能力选择 remote 或 wire，调用后不换通道重试。
+		* 受理状态不明时返回 ok:false，不重复创建会话。
+		* @author ddj 2026年10月28号
 		* @author ddj 2026年09月23号
 		* @param ctx 客户端服务上下文（remote.session + sessions，仅回落用）
 		* @param cwd 新会话工作区目录（与当前会话同工作区）
@@ -384502,32 +384576,25 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 						id
 					};
 				}
-			} catch {}
+				if (typeof sessions?.create === "function") return { ok: false };
+			} catch {
+				return { ok: false };
+			}
 			try {
 				const remote = ctx.get("remote.session");
 				if (typeof remote?.create === "function") {
 					const payload = cwd ? { cwd } : {};
-					for (const arg of [
-						slotArg(payload),
-						{ request: {
-							rpcId: mintRpcId(),
-							payload
-						} },
-						{
-							rpcId: mintRpcId(),
-							payload
-						},
-						payload
-					]) try {
-						const r = rpcOk(await remote.create(arg));
-						const id = r.value;
-						if (r.ok && typeof id?.sessionId === "string") return {
-							ok: true,
-							id: id.sessionId
-						};
-					} catch {}
+					const receipt = rpcOk(await remote.create(slotArg(payload)));
+					const created = receipt.value;
+					if (receipt.ok && typeof created?.sessionId === "string") return {
+						ok: true,
+						id: created.sessionId
+					};
+					return { ok: false };
 				}
-			} catch {}
+			} catch {
+				return { ok: false };
+			}
 			try {
 				const id = await apiSessionCreate(cwd);
 				if (id) return {
@@ -384549,7 +384616,7 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			try {
 				const sessions = ctx.get("sessions");
 				const conversation = ctx.get("conversation");
-				const actx = sessions?.scope?.(sessionId);
+				const actx = typeof sessions?.binding === "function" ? sessions.binding(sessionId)?.ctx : sessions?.scope?.(sessionId);
 				const shell = actx && conversation?.input?.for?.(actx);
 				return shell && typeof shell.insertReference === "function" ? shell : void 0;
 			} catch {
@@ -384666,13 +384733,15 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			/**
 			* 新建独立会话（02-deep-session-prompt：旁路任务不污染当前对话）。
 			* 闭包持有真服务 ctx（面板 SidebarCtx 无 .get，会话操作必须经此门面）；
-			* 创建后尽力 `sessions.open(id)` 切换视图（缺失不致命，草稿仍可写入）。
+			* 新版仅返回已登记身份，视图选择由宿主负责；旧版保留可用的 open/select。
+			* @author ddj 2026年10月28号
 			* @author ddj 2026年09月23号
 			* @param cwd 新会话工作区目录（与当前会话同工作区）
 			* @returns 新会话结果（失败供降级）
 			*/
 			const startDraftSession = async (cwd) => {
 				const result = await newDraftSession(ctx, cwd);
+				if (typeof ctx.get("sessions")?.retain === "function") return result;
 				if (result.ok && result.id) try {
 					const sessions = ctx.get("sessions");
 					sessions?.materializeScope?.(result.id);
@@ -384685,30 +384754,23 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			};
 			/**
 			* 发送任务给目标会话 agent（点击即发送方案：任务落地会话即非 blank，列表可见）。
-			* 主路径 wire 直发 session/prompt；回落 remote.session.prompt service 面。
-			* @author ddj 2026年09月23号
+			* 新版持有目标 Controller 到 prompt 结束；旧版按能力选择唯一通道，不跨通道重发。
+			* @author ddj 2026年09月23号 / 2026年10月28号
 			* @param sessionId 目标会话 id
 			* @param text 任务文本
 			* @returns 是否受理
 			*/
 			const sendTask = async (sessionId, text) => {
 				if (!sessionId) return false;
-				const composerOnce = async () => {
+				try {
+					const sessions = ctx.get("sessions");
+					if (typeof sessions?.retain === "function") return await sendOwned(ctx, sessions, sessionId, text);
 					const input = inputFor(ctx, sessionId);
-					if (input && typeof input.setDraft === "function" && typeof input.submit === "function") {
+					if (typeof input?.setDraft === "function" && typeof input.submit === "function") {
 						input.setDraft(text);
 						input.submit();
 						return true;
 					}
-					return false;
-				};
-				try {
-					for (let attempt = 3; attempt > 0; attempt--) {
-						if (await composerOnce()) return true;
-						if (attempt > 1) await new Promise((resolve) => setTimeout(resolve, 500));
-					}
-				} catch {}
-				try {
 					const remote = ctx.get("remote.session");
 					if (typeof remote?.prompt === "function") {
 						const payload = {
@@ -384719,26 +384781,12 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 								text
 							}]
 						};
-						for (const arg of [
-							slotArg(payload),
-							{ request: {
-								rpcId: mintRpcId(),
-								payload
-							} },
-							{
-								rpcId: mintRpcId(),
-								payload
-							},
-							payload
-						]) try {
-							if (rpcOk(await remote.prompt(arg)).ok) return true;
-						} catch {}
+						return rpcOk(await remote.prompt(slotArg(payload))).ok;
 					}
-				} catch {}
-				try {
 					return await apiSessionPrompt(sessionId, text);
-				} catch {}
-				return false;
+				} catch {
+					return false;
+				}
 			};
 			return {
 				appendReference,
@@ -393389,6 +393437,9 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			const [dirtyMap, setDirtyMap] = react$1.default.useState({});
 			const [content, setContent] = react$1.default.useState(null);
 			const [contentPath, setContentPath] = react$1.default.useState(null);
+			const [missingPreview, setMissingPreview] = react$1.default.useState(null);
+			const missingRef = react$1.default.useRef(/* @__PURE__ */ new Map());
+			const missingNow = missingPreview?.path === active && missingPreview?.sessionId === sessionId ? missingPreview : null;
 			const [receiptLoad, setReceiptLoad] = react$1.default.useState(null);
 			const [imageSrc, setImageSrc] = react$1.default.useState(null);
 			const [imgSize, setImgSize] = react$1.default.useState(null);
@@ -393751,7 +393802,10 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			const regions = react$1.default.useMemo(() => {
 				const trace = isDebug() && contentReady && currentRecords.length > 0;
 				const start = trace ? performance.now() : 0;
-				const next = officialDetail ? reviewRegions(officialDetail.diff, officialDetail.item.id, officialDetail.blocks ?? [], contentReady ? content : null) : diffRegions(currentRecords, contentReady ? content : null).filter((r) => !r.superseded);
+				let next;
+				if (officialDetail) next = reviewRegions(officialDetail.diff, officialDetail.item.id, officialDetail.blocks ?? [], contentReady ? content : null);
+				else if (missingNow && contentReady) next = missingNow.resolved ? [] : [missingRegion(missingNow)];
+				else next = diffRegions(currentRecords, contentReady ? content : null).filter((r) => !r.superseded);
 				if (trace) try {
 					dbg(sessionId, `[DEBUG diffRegions] records=${currentRecords.length} bytes=${content.length} regions=${next.length} ms=${(performance.now() - start).toFixed(1)}`);
 				} catch (e) {}
@@ -393761,7 +393815,16 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				content,
 				contentPath,
 				active,
-				officialDetail
+				officialDetail,
+				missingNow
+			]);
+			react$1.default.useEffect(() => {
+				editorRef.current?.updateOptions({ readOnly: !!missingNow });
+			}, [
+				missingNow,
+				active,
+				content,
+				monaco
 			]);
 			const pendingRegions = react$1.default.useMemo(() => regions.filter((r) => r.status === ST.PENDING && !r.stale), [regions]);
 			const staleRegions = react$1.default.useMemo(() => regions.filter((r) => r.status === ST.PENDING && r.stale), [regions]);
@@ -394236,7 +394299,13 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				/** @author ddj 2026年09月28号 @param res Disk content for a still-clean cached model. */
 				const accept = (res) => {
 					if (!loadCurrent(path, sequence) || dirtyRef.current[path] || model.getValue() !== before) return;
+					if (res?.code === "file-missing") {
+						loadMissing(path, sid, sequence);
+						return;
+					}
 					if (!res?.ok) return;
+					missingRef.current.delete(path);
+					setMissingPreview(null);
 					mark(res.version);
 					if (res.content === before) return;
 					saveViewState(path);
@@ -394259,6 +394328,48 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			* @param force 强制走 RPC（reloadFile 用，跳过 model 复用）
 			* @param version 已知磁盘版本（缺省走 RPC 返回值）
 			*/
+			/** @private @author ddj 2026年10月28号 @param path Missing text file. @param sid Owning session. @param seq Loader generation. @sideEffects Loads deletion evidence without creating or saving the file. */
+			async function loadMissing(path, sid, seq) {
+				try {
+					const result = await rpc("edrv.missingReview", {
+						sessionId: sid,
+						path
+					});
+					if (!loadCurrent(path, seq)) return;
+					if (!result.ok) {
+						failLoad(path, sid, seq, result.error);
+						return;
+					}
+					if (!result.review) {
+						loadContent(path, sid, true);
+						return;
+					}
+					if (dirtyRef.current[path] || savingRef.current.has(path)) {
+						failLoad(path, sid, seq, "文件已删除，但有未保存编辑；请先处理本地缓冲");
+						return;
+					}
+					const preview = {
+						...result.review,
+						sessionId: sid,
+						keepId: crypto.randomUUID(),
+						undoId: crypto.randomUUID()
+					};
+					missingRef.current.set(path, preview);
+					setMissingPreview(preview);
+					setContent("");
+					setContentPath(path);
+					setLoadError(null);
+					setError(null);
+					stampLoad(path, sid, seq);
+					setLoadStage({
+						progress: 100,
+						message: "文件已删除 · 展示最后记录快照"
+					});
+					setStatus("文件已删除 · 展示最后记录快照（只读）");
+				} catch (cause) {
+					if (loadCurrent(path, seq)) failLoad(path, sid, seq, String(cause));
+				}
+			}
 			const loadContent = (path, sid, force, version) => {
 				const seq = ++loadSeqRef.current;
 				setReceiptLoad({
@@ -394319,7 +394430,7 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 					loadPdf(path, sid, seq, force === true, version);
 					return;
 				}
-				const cachedModel = force ? null : modelsRef.current.get(path);
+				const cachedModel = force || missingRef.current.has(path) ? null : modelsRef.current.get(path);
 				if (cachedModel) {
 					setContent(cachedModel.getValue());
 					setContentPath(path);
@@ -394346,6 +394457,8 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 					} catch (e) {}
 					if (!loadCurrent(path, seq)) return;
 					if (res && res.ok) {
+						missingRef.current.delete(path);
+						setMissingPreview(null);
 						mark(res.version, true);
 						setContent(res.content);
 						setContentPath(path);
@@ -394356,6 +394469,10 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 						}));
 						setStatus("已加载");
 					} else {
+						if (res?.code === "file-missing") {
+							loadMissing(path, sid, seq);
+							return;
+						}
 						if (res?.code === "file-too-large") setLargeCandidate(JSON.stringify([
 							scope,
 							sid,
@@ -394606,6 +394723,7 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 					});
 					return;
 				}
+				if (change.kind === "deleted" && change.path === activeRef.current && !dirtyRef.current[change.path] && !savingRef.current.has(change.path)) loadContent(change.path, sessionId, true);
 				const kind = change.kind === "deleted" ? "deleted" : "conflict";
 				markDiskFlag(readSync(scope, change.path) ?? {
 					path: change.path,
@@ -395591,6 +395709,10 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			/** @private @author ddj 2026年10月14号 @param path Canonical path. @param manual Explicit save. @returns Guarded save, never another pane's content. */
 			function saveDocument(path, manual) {
 				if (isExcelPath(path)) return Promise.resolve({ ok: false });
+				if (missingRef.current.has(path)) {
+					setStatus("删除预览只读；请使用 Keep / Undo");
+					return Promise.resolve({ ok: false });
+				}
 				const model = modelsRef.current.get(path);
 				if (!model) return Promise.resolve({ ok: false });
 				const store = documents();
@@ -395662,7 +395784,7 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				const ed = editorRef.current;
 				const model = ed?.getModel();
 				const path = [...modelsRef.current].find(([, item]) => item === model)?.[0];
-				if (!ed || !path) return;
+				if (!ed || !path || missingRef.current.has(path)) return;
 				setDirtyMap((d) => Object.assign({}, d, { [path]: true }));
 				touchTab(path);
 				setStatus("编辑中…");
@@ -395796,6 +395918,7 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				const side = layoutRef.current === "side";
 				const ed = m.editor.create(node, {
 					value: "",
+					readOnly: missingRef.current.has(activeRef.current),
 					language: "plaintext",
 					theme: themeNameOf(),
 					fontFamily: "var(--ds-font-family-code, ui-monospace, monospace)",
@@ -396443,6 +396566,7 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			* @returns Promise<boolean> 是否成功
 			*/
 			const actHunk = (region, reject, silent) => {
+				if (region.sourceKind === "missing") return decideMissing(reject);
 				if (region.sourceKind === "official") return decideOfficial(reject, region.id);
 				const method = reject ? "edrv.reject" : "edrv.accept";
 				const trace = isDebug();
@@ -396612,7 +396736,57 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 					batchBusyRef.current = false;
 				}
 			}
+			/** @private @author ddj 2026年10月28号 @param reject Restore the shown snapshot instead of keeping absence. @returns Safe whole-file decision, never a hunk reversal. */
+			async function decideMissing(reject) {
+				if (batchBusyRef.current || !missingNow || missingNow.resolved) return false;
+				const preview = missingNow;
+				const lifetime = reviewLifeRef.current;
+				batchBusyRef.current = true;
+				setReviewBatchBusy(true);
+				try {
+					guardReviewAll(reject, lifetime);
+					const result = await rpc("edrv.missingDecide", {
+						sessionId,
+						token: preview.token,
+						operationId: reject ? preview.undoId : preview.keepId,
+						undo: reject
+					});
+					if (!lifetime?.live) return false;
+					if (!result.ok) {
+						setError(result.error);
+						return false;
+					}
+					setRecords((previous) => Object.fromEntries(Object.entries(previous).filter(([id]) => !result.callIds.includes(id))));
+					missingRef.current.set(preview.path, {
+						...preview,
+						resolved: true
+					});
+					if (activeRef.current === preview.path) {
+						if (reject) loadContent(preview.path, sessionId, true);
+						else setMissingPreview({
+							...preview,
+							resolved: true
+						});
+					}
+					refreshRecords();
+					emitRefresh({
+						scope,
+						paths: [preview.path],
+						kind: "structure"
+					});
+					setStatus(reject ? "已恢复展示的完整历史快照" : "已保留文件删除");
+					setError(null);
+					return true;
+				} catch (cause) {
+					if (lifetime?.live) setError(String(cause));
+					return false;
+				} finally {
+					batchBusyRef.current = false;
+					if (lifetime?.live) setReviewBatchBusy(false);
+				}
+			}
 			const acceptFile = () => {
+				if (missingNow && !officialDetail) return decideMissing(false);
 				if (officialDetail) return decideOfficial(false);
 				if (batchBusyRef.current || !decideRegions.length) return;
 				batchBusyRef.current = true;
@@ -396631,6 +396805,7 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				});
 			};
 			const undoFile = () => {
+				if (missingNow && !officialDetail) return decideMissing(true);
 				if (officialDetail) return decideOfficial(true);
 				if (batchBusyRef.current || !decideRegions.length) return;
 				batchBusyRef.current = true;
@@ -396668,24 +396843,85 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			* @author ddj 2026年08月20号
 			* @param reject true=全部不采纳（回滚），false=全部采纳
 			*/
-			const actAllPending = (reject) => {
+			const actAllPending = async (reject) => {
 				if (batchBusyRef.current || !allPending.length) return;
+				const lifetime = reviewLifeRef.current;
 				batchBusyRef.current = true;
 				const list = reject ? [...allPending].sort((a, b) => a.at < b.at ? 1 : a.at > b.at ? -1 : b.idx - a.idx) : allPending;
 				const paths = [...new Set(list.map((r) => records[r.callId]?.path).filter(Boolean))];
-				return actMany(list.map((r) => itemOf(r, reject))).then((result) => {
-					batchBusyRef.current = false;
-					reloadFile(true);
+				try {
+					const handled = await missingBatch(paths, {
+						query: async (path) => {
+							const cached = missingRef.current.get(path);
+							if (cached?.sessionId === sessionId && !cached.resolved) return {
+								ok: true,
+								review: cached
+							};
+							const result = await rpc("edrv.missingReview", {
+								sessionId,
+								path
+							});
+							if (result.ok && result.review) {
+								const preview = {
+									...result.review,
+									sessionId,
+									keepId: crypto.randomUUID(),
+									undoId: crypto.randomUUID()
+								};
+								missingRef.current.set(path, preview);
+								return {
+									ok: true,
+									review: preview
+								};
+							}
+							return result;
+						},
+						decide: (preview, operationId) => rpc("edrv.missingDecide", {
+							sessionId,
+							token: preview.token,
+							operationId,
+							undo: reject
+						}),
+						guard: () => guardReviewAll(reject, lifetime),
+						operation: (preview) => reject ? preview.undoId : preview.keepId,
+						committed: (preview, callIds) => {
+							if (!lifetime?.live) return;
+							missingRef.current.set(preview.path, {
+								...preview,
+								resolved: true
+							});
+							setRecords((previous) => Object.fromEntries(Object.entries(previous).filter(([id]) => !callIds.includes(id))));
+							if (!reject && sameFile(activeRef.current, preview.path)) setMissingPreview({
+								...preview,
+								path: activeRef.current,
+								sessionId,
+								resolved: true
+							});
+							emitRefresh({
+								scope,
+								paths: [preview.path],
+								kind: "structure"
+							});
+						}
+					});
+					guardReviewAll(reject, lifetime);
+					const remaining = list.filter((item) => !handled.has(records[item.callId]?.path));
+					const result = await actMany(remaining.map((item) => itemOf(item, reject)));
+					if (!lifetime?.live) return;
+					if (reject || !missingNow) reloadFile(true);
 					emitRefresh({
 						scope,
-						paths: paths.length ? paths : void 0,
+						paths,
 						kind: "structure"
 					});
-					setStatus(decideStatus(reject ? "已不采纳 " : "已采纳 ", result));
-					if (result.fail) setError(result.fail + " 处差异处理失败（可能已被后续修改影响），可刷新后重试");
-				}).catch(() => {
+					setStatus(decideStatus(reject ? "已不采纳 " : "已采纳 ", result) + `；删除文件 ${handled.size} 个`);
+					if (result.fail) setError(result.fail + " 处差异处理失败，可刷新后重试");
+				} catch (cause) {
+					if (lifetime?.live) setError(String(cause));
+				} finally {
 					batchBusyRef.current = false;
-				});
+					if (lifetime?.live) refreshRecords();
+				}
 			};
 			/** @private @author ddj 2026年10月27号 @param reject Undo requires every local buffer to be saved. @param token Starting session lifetime. @returns Throws before the next mutation when unsafe. */
 			function guardReviewAll(reject, token) {
@@ -398286,6 +398522,7 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			const reviewErrorText = !rawReviewError ? void 0 : sessionDown ? SESSION_DOWN_NOTICE : sessionErrorText(rawReviewError);
 			const buildDockSnapshot = () => ({
 				mode: editorDockMode(active),
+				missingDeletion: !!missingNow,
 				official: officialFile ? {
 					sessionId,
 					page: review.page,