dsh-vscode-mode 0.23.3 → 0.23.4

package/README.md

@@ -533,13 +533,13 @@ profile 请替换为实际目标，不要把示例目录当成当前运行 profi
 
 ```bash
 # ① Git 安装（clone + prepare 构建；推荐打固定 tag）
-dsh plugin --profile web add github:Lenonss/DSH_VsCodeMode#v0.23.1
+dsh plugin --profile web add github:Lenonss/DSH_VsCodeMode#v0.23.4
 
 # ② npm 注册表（发布到 npm 后）
-dsh plugin --profile web add dsh-vscode-mode@0.23.1
+dsh plugin --profile web add dsh-vscode-mode@0.23.4
 
 # ③ GitHub Release tgz 直装（Release asset 可用后）
-dsh plugin --profile web add https://github.com/Lenonss/DSH_VsCodeMode/releases/download/v0.23.1/dsh-vscode-mode-0.23.1.tgz
+dsh plugin --profile web add https://github.com/Lenonss/DSH_VsCodeMode/releases/download/v0.23.4/dsh-vscode-mode-0.23.4.tgz
 ```
 
 > **DSH 版本政策（0.17.0 起）**：六项 DSH peer 仍统一声明为 `*`，另以
@@ -880,6 +880,7 @@ Keep All / Undo All 却是亮的。修复：单文件 Keep / Undo 覆盖冲突
 完整变更见 [GitHub Releases](https://github.com/Lenonss/DSH_VsCodeMode/releases)。
 近期关键版本：
 
+- **v0.23.4**：修复桌面端点计划卡「查看全文」会先闪开一页官方计划预览、随即自动关闭。根因：官方卡片走 `ctx.sidebarRight.openResource(planAddress(callId))`，而本插件以 extension 优先级认领了 `dsh-resource://plan/**` 与 `dsh-resource://plan-review/**`，于是侧栏先按本插件类型建出一个页签（正文「正在打开计划预览…」），挂载后才把计划转进「文件编辑」、再把这个页签关掉——用户看到的就是这次建而即关。现由新增 `src/client/planDirect.ts` 在装配期包装 `sidebarRight.openResource`：只接管「2 段计划地址 + 会话为在屏会话」，正文依次取回顾卡片的 `params.planReview`、插件侧地址→正文缓存、可选 `resources.source()` 资源流（上限 1.5s），拿到正文后经 `requestOpen(..., { preview: true })` 直通本插件编辑器的只读计划页签，不再创建侧栏页签；非计划地址、跨会话与 subagent 5 段地址、正文不可得、编辑器 5s 未回执、以及服务对象只读导致包装赋值失败，一律回落原生 `openResource`，原「认领 + 挂载后转移」链路保留为后备。`openReceipt` 新增可选 `timeoutMs`，`planState` 新增有界（64 条）地址→正文缓存并由 live `exit_plan_mode` 写入。验证：typecheck 0 error；`tests/planDirect.test.ts`（新增 9 例）、`tests/planBridge.test.ts`（13）、`tests/planState.test.ts`（10）、`tests/openReceipt.test.ts`（9）四套 41/41；`npm run build` 双 bundle 通过（含客户端产物完整性校验）；浏览器确认新 bundle 已加载且 Console 无「计划直通装配失败」；GUI 点按由用户在本机 Web 端手动复验后发布。见 [发布说明](docs/release-0.23.4.md)。
 - **v0.23.3**：修复 issue #13（已删除文件的差异条目把人卡死）与 #12（重启后成串「采集不完整」）。①文件在磁盘上被删掉时，客户端申请整文件删除预览被「已有官方审查记录」拒绝，而拒绝只是一条普通 `Error`，于是落到通用加载失败分支——「文件加载失败：…」+ 进度钉在 0%、重试同错、标签页关不掉；`edrv.review.detail` 还把 Undo 不可用解释成「缺少可验证的原始字节」，而真实原因是文件已不在。现缺失文件预览的可预期拒绝带稳定码（`official-covered` / `official-decided` / `no-records` / `no-evidence` / `too-large`），客户端据此显示「文件已在磁盘删除（· 有官方待审改动）」终态：标题 + 原因 + 重试 / 关闭标签页，不再画 0% 进度条；官方待审记录在磁盘已删除时给出「Keep 按删除结案、Undo 需要读写该文件」的准确原因（Keep 语义不变，仍只写共享审查库），记录都已结案时提示可直接关闭；`!review` 的磁盘状态抖动改为最多重读 2 次后给终态，消除缺失↔重现的无限递归。v0.22.0 起 `hasOfficial()` 已用 `typeof path !== 'string'` 守卫堵掉把不透明 FsTarget 绑进 SQL 导致的 `Unknown named parameter 'targetKey'`，本版不再复现。②官方 `workspace/changes` 的 summary 只存在宿主内存里，插件启动补采原先无条件把历史事件全部入队，重启后每一轮都必然抛「summary 已失效或尚不可用」并写成不可修复的 `gap`（面板成串「轮次 N 采集不完整」）；现补采先 `summary()` 探测再入队，失效事件只记一条汇总日志。验证：typecheck 与基线同为 37 个既有错误（`fflate/browser` 依赖缺失）、零新增；定向单测 111/111（含新增 `tests/deletedFileReview.test.ts` 5 例与 `tests/officialBackfill.test.ts` 2 例）、EditorView 相关 82/82；`npm run build` 四个 bundle 通过。见 [发布说明](docs/release-0.23.3.md)。
 - **v0.23.2**：修复 Keep 在非活跃端（桌面端）点了没反应，两处成因。①`edrv.review.decide` 原先一律要求本端活跃会话，而能力位只按审查库推导，会话在另一实例时按钮亮着、点击后抛错被兜底成 HTTP 500。现按写入副作用区分：官方记录 Keep 只写共享审查库（`BEGIN IMMEDIATE` + 幂等键 + 版本 CAS），冷端放行；官方 Undo（校验证据并写回源文件）与待审投影条目（本机 JSON 无跨进程锁）仍限活跃端，返回可读跨端原因而非 500；详情新增 `capability.live`，冷端禁用 Undo 并说明、Keep 提示补「写入共享审查库，仍可执行」。②已结算待审投影的 `capability.keep` 恒为假，却因排在 `items[0]`、同路径官方待审行被历史过滤，把官方记录挤出差异栏（表现为「待审 0」+Keep 禁用+点击无反应）；现 `pendingPageOf()` 剔除已结算投影，官方记录重新成为审查目标。另详情未加载时点 Keep 不再静默失败；打开文件时若某条官方记录的改动已全部不在当前文件中（无可定位差异且缓冲区干净），自动按 Keep 结案（只标记不写盘），差异栏不再显示「本记录 N 处改动均已不在当前文件中」；官方元数据首次载入期间差异栏显示 `—` 而非按历史记录报数，重启瞬间不再闪出几十条假待审。验证：typecheck 0 error、目标单测 57/57、build 通过、真实审查库探针确认首条回到官方记录且 `capability={keep:true,undo:true,live:true}`；桌面端 GUI 点按验收因重启后恢复的是另一个会话未完成，缺口保留。发布不自动部署，升级后重启 DSH 并刷新页面。见 [发布说明](docs/release-0.23.2.md)。
 - **v0.23.1**：修复 Keep All / Undo All 在待审超过一页时必定中止——批量按钮原先复用分页接口并把每页的展示用计数当全量总数校验，官方待审 150 条时先报「待审记录在分页期间变化」或最终报「待审记录数量不完整」，实际 0 项被决策。现改为一次性完整快照（`edrv.review.list` 新增 `all: true`，服务端循环取全并与历史改动投影去重，`nextCursor: null`、`pending` 为真实总数），客户端单次取快照、校验唯一且仍待审后逐项决策；超过 2000 条明确拒绝并提示分批，途中变化仍整批中止不部分写入。差异栏浏览仍走原分页接口。本版未在重启后的 GUI 点按验证，缺口保留；发布不自动部署，升级后重启 DSH 并刷新页面。见 [发布说明](docs/release-0.23.1.md)。

package/lib/client.js

@@ -2613,7 +2613,7 @@ window.__ModuleLoader__.load({
 		* @param line Optional target line.
 		* @param column Optional target column.
 		* @param sessionId Owning session, required for routing.
-		* @param options Explicit preview, read-only plan document and optional cancellation signal.
+		* @param options Explicit preview, read-only plan document, cancellation signal and receipt deadline.
 		* @returns Actual completion; timeout and disposal are false.
 		*/
 		function requestOpen(path, line, column, sessionId = "", options = {}) {
@@ -2647,7 +2647,7 @@ window.__ModuleLoader__.load({
 					request,
 					finish
 				});
-				timer = setTimeout(() => finish(false), 2e4);
+				timer = setTimeout(() => finish(false), options.timeoutMs ?? 2e4);
 				openEditorView(null);
 				window.dispatchEvent(new CustomEvent("edrv:open-request", { detail: request }));
 			});
@@ -376030,6 +376030,8 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 		//#endregion
 		//#region src/client/planState.ts
 		const associated = /* @__PURE__ */ new Map();
+		/** 地址 → 已解析计划正文（只留内存，供后续点击省掉一次资源解析）。 */
+		const documents = /* @__PURE__ */ new Map();
 		/** @private @author ddj 2026年10月08号 @param value JSON candidate. @returns Object or empty record. */
 		function record(value) {
 			return value !== null && typeof value === "object" ? value : {};
@@ -376096,9 +376098,25 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			associated.set(sessionId, paths);
 			if (associated.size > 32) associated.delete(associated.keys().next().value);
 		}
+		/** @public @author ddj 2026年10月31号
+		* 记住一份已解析计划，供「查看全文」时免去资源解析。
+		* @param plan 已解析计划。
+		* @returns 无；只缓存合法地址与正文，超过上限按插入序淘汰。
+		*/
+		function rememberPlan(plan) {
+			const valid = planDocument(plan.address, plan);
+			if (valid === void 0) return;
+			documents.set(valid.address, valid);
+			if (documents.size > 64) documents.delete(documents.keys().next().value);
+		}
+		/** @public @author ddj 2026年10月31号 @param address 官方资源地址。 @returns 已缓存的计划正文。 */
+		function cachedPlan(address) {
+			return documents.get(address);
+		}
 		/** @public @author ddj 2026年10月08号 Clear associations when the plugin unloads. */
 		function clearPlanState() {
 			associated.clear();
+			documents.clear();
 		}
 		/** @public @author ddj 2026年10月08号
 		* Reduce only live append deltas; hydration, pagination, reconnect and duplicate sequences never open plans.
@@ -376134,6 +376152,7 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 					if (event.type === "tool/result") return void 0;
 					const plan = planDocument("dsh-resource://plan/" + encodeURIComponent(sessionId) + "/" + encodeURIComponent(id), { markdown: call.args.plan });
 					if (plan) {
+						rememberPlan(plan);
 						remember(id);
 						return { plan };
 					}
@@ -412357,19 +412376,269 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			return directTranslate();
 		}
 		//#endregion
-		//#region src/client/planBridge.ts
-		/** Optional DSH plan integration; no provider or approval UI replacement. @author ddj 2026年10月08号 */
-		const CLAIM_ID = "dsh-vscode-mode/plan";
-		const CLAIM_KIND = "edrvPlan";
-		const EMPTY_RESOURCE = { status: "none" };
-		/** @private @author ddj 2026年10月08号 @param ctx Optional context. @param name Service name. @returns Service or undefined without gating plugin activation. */
-		function optional(ctx, name) {
+		//#region src/client/planDirect.ts
+		/**
+		* dsh-vscode-mode client — 计划地址直通。
+		*
+		* 背景：官方计划卡片「查看全文」调 `ctx.sidebarRight.openResource(planAddress)`，
+		* 侧栏会先创建计划页签、再由本插件认领并立刻关闭，桌面端表现为「快速打开又迅速关闭」。
+		* 本模块在装配时包装该服务方法：能直接拿到计划正文时改为把只读计划送进「文件编辑」，
+		* 不再创建侧栏页签；地址不属于在屏会话、正文暂不可得、编辑器未回执或包装未生效时
+		* 一律回落原方法，官方页签与原认领转交链路继续作为后备。
+		* 作者 ddj 2026年10月31号
+		*/
+		/** 正文解析上限：超过即回落官方页签，避免点击后长时间无反馈。 */
+		const RESOLVE_MS = 1500;
+		/** 编辑器回执上限：超过即回落官方页签。 */
+		const ROUTE_MS = 5e3;
+		/** @public @author ddj 2026年10月31号
+		* 可选探测客户端服务，缺失或抛错时返回 undefined。
+		* @param ctx 客户端上下文（只需 get）。
+		* @param name 服务名。
+		* @returns 服务实例，或 undefined（不阻断装配）。
+		*/
+		function optionalService(ctx, name) {
 			try {
 				return ctx.get(name);
 			} catch {
 				return;
 			}
 		}
+		/** @public @author ddj 2026年10月31号
+		* 包装官方 openResource，把本会话的计划地址改为直通插件编辑器。
+		* @param ctx 客户端上下文（可选服务一律 ctx.get 探测）。
+		* @param service 官方 sidebarRight 服务；仅在赋值生效时留下包装。
+		* @returns 供路由回退使用的原方法，以及卸载时中止在途并还原的清理函数。
+		*/
+		function installPlanDirect(ctx, service) {
+			const original = service.openResource;
+			const pending = /* @__PURE__ */ new Map();
+			let closed = false;
+			let installed = false;
+			/** @private @author ddj 2026年10月31号
+			* 解码地址段（畸形编码一律视为不可接管）。
+			* @param address 官方资源地址。
+			* @returns 去掉协议前缀后的解码段。
+			*/
+			function decode(address) {
+				try {
+					return address.split("/").slice(3).map(decodeURIComponent);
+				} catch {
+					return;
+				}
+			}
+			/** @private @author ddj 2026年10月31号
+			* 判断该地址是否由本插件接管：只认两段式计划地址，且归属当前在屏会话。
+			* @param address 官方资源地址。
+			* @returns 可接管的会话 id，其他情况 undefined（回落原方法）。
+			*/
+			function take(address) {
+				if (closed || !isPlanAddress(address)) return void 0;
+				const segments = decode(address);
+				if (segments?.length !== 2) return void 0;
+				const current = readSessionScope(ctx).sessionId ?? "";
+				return current !== "" && segments[0] === current ? current : void 0;
+			}
+			/** @private @author ddj 2026年10月31号
+			* 读官方参数里随页签携带的计划正文（临时回顾页签走这里）。
+			* @param address 官方资源地址。
+			* @param options 官方 openResource 参数。
+			* @returns 计划正文，或不带正文时 undefined。
+			*/
+			function inline(address, options) {
+				const params = options?.params;
+				if (params === null || typeof params !== "object") return void 0;
+				return planDocument(address, params.planReview);
+			}
+			/** @private @author ddj 2026年10月31号
+			* 打开计划资源流。
+			* @param services resources 服务。
+			* @param address 官方资源地址。
+			* @returns 资源流；服务缺失或抛错时 undefined。
+			*/
+			function streamOf(services, address) {
+				try {
+					return services?.source?.(address);
+				} catch {
+					return;
+				}
+			}
+			/** @private @author ddj 2026年10月31号
+			* 从资源快照读已就绪的计划正文。
+			* @param address 官方资源地址。
+			* @param stream 计划资源流。
+			* @returns 计划正文；未就绪、失败或内容不完整时 undefined。
+			*/
+			function planOf(address, stream) {
+				let snapshot;
+				try {
+					snapshot = stream.getSnapshot?.();
+				} catch {
+					return;
+				}
+				const state = snapshot !== null && typeof snapshot === "object" ? snapshot : {};
+				return state.status === "live" ? planDocument(address, state.value) : void 0;
+			}
+			/** @private @author ddj 2026年10月31号
+			* 订阅资源快照变化。
+			* @param stream 计划资源流。
+			* @param listener 变更监听。
+			* @returns 退订函数；订阅面缺失或抛错时为 no-op。
+			*/
+			function watchStream(stream, listener) {
+				try {
+					const off = stream.subscribe?.(listener);
+					return typeof off === "function" ? off : () => void 0;
+				} catch {
+					return () => void 0;
+				}
+			}
+			/** @private @author ddj 2026年10月31号
+			* 回落官方方法（包装外的原入口）。
+			* @param address 官方资源地址。
+			* @param options 官方参数。
+			* @returns 无；失败只记日志，不影响点击链路。
+			*/
+			function native(address, options) {
+				if (typeof original !== "function") return;
+				try {
+					original.call(service, address, options);
+				} catch (error) {
+					log$2.warn("官方计划页签回退失败：" + String(error));
+				}
+			}
+			/** @private @author ddj 2026年10月31号
+			* 把已解析的计划送进插件编辑器；地址级在途合并，重复点击不叠开。
+			* @param plan 计划正文。
+			* @param session 归属会话。
+			* @param address 官方资源地址。
+			* @param options 官方参数（回落时原样透传）。
+			* @returns 无；未就绪或失败时回落官方页签，但不劫持已切换的会话。
+			*/
+			function direct(plan, session, address, options) {
+				if (closed || pending.has(address)) return;
+				const controller = new AbortController();
+				pending.set(address, () => {
+					pending.delete(address);
+					controller.abort();
+				});
+				rememberPlan(plan);
+				/** @private @author ddj 2026年10月31号 @param ok 编辑器是否就绪。 @returns 无；失败时回落官方页签。 */
+				function settle(ok) {
+					pending.delete(address);
+					if (ok || closed || readSessionScope(ctx).sessionId !== session) return;
+					native(address, options);
+				}
+				requestOpen(null, void 0, void 0, session, {
+					preview: true,
+					plan,
+					signal: controller.signal,
+					timeoutMs: ROUTE_MS
+				}).then(settle, (error) => {
+					log$2.warn("计划直通失败：" + String(error));
+					settle(false);
+				});
+			}
+			/** @private @author ddj 2026年10月31号
+			* 从计划资源异步解析正文，就绪后直通；超时或无法解析回落官方页签。
+			* @param address 官方资源地址。
+			* @param session 归属会话。
+			* @param options 官方参数。
+			* @returns 无。
+			*/
+			function lookup(address, session, options) {
+				const stream = streamOf(optionalService(ctx, "resources"), address);
+				if (stream === void 0) {
+					native(address, options);
+					return;
+				}
+				const early = planOf(address, stream);
+				if (early !== void 0) {
+					direct(early, session, address, options);
+					return;
+				}
+				if (closed || pending.has(address)) return;
+				let timer;
+				let stop;
+				let done = false;
+				/** @private @author ddj 2026年10月31号 @param ok 是否已拿到正文。 @returns 无；幂等收尾，清定时器、退订、释放地址。 */
+				function finish(ok) {
+					if (done) return;
+					done = true;
+					if (timer !== void 0) clearTimeout(timer);
+					stop?.();
+					pending.delete(address);
+					if (!ok && !closed) native(address, options);
+				}
+				pending.set(address, () => finish(false));
+				timer = setTimeout(() => finish(false), RESOLVE_MS);
+				stop = watchStream(stream, () => {
+					const plan = planOf(address, stream);
+					if (plan === void 0) return;
+					finish(true);
+					direct(plan, session, address, options);
+				});
+			}
+			/** @private @author ddj 2026年10月31号 @param address 官方资源地址。 @param options 官方参数。 @returns 无；包装后的 openResource 入口。 */
+			function open(address, options) {
+				const session = take(address);
+				if (session === void 0) {
+					native(address, options);
+					return;
+				}
+				const known = inline(address, options) ?? cachedPlan(address);
+				if (known !== void 0) {
+					direct(known, session, address, options);
+					return;
+				}
+				lookup(address, session, options);
+			}
+			/** @private @author ddj 2026年10月31号 @returns 无；赋值后校验，未生效即降级为原认领转交链路。 */
+			function mount() {
+				if (typeof original !== "function") return;
+				try {
+					service.openResource = open;
+				} catch (error) {
+					log$2.warn("计划直通装配失败：" + String(error));
+				}
+				installed = service.openResource === open;
+				if (installed) return;
+				try {
+					service.openResource = original;
+				} catch {}
+			}
+			/** @private @author ddj 2026年10月31号 @returns 无；仅在包装仍是自己时还原（HMR 安全）。 */
+			function unmount() {
+				if (!installed || service.openResource !== open) return;
+				try {
+					service.openResource = original;
+				} catch (error) {
+					log$2.warn("计划直通还原失败：" + String(error));
+				}
+				installed = false;
+			}
+			/** @private @author ddj 2026年10月31号 @returns 无；卸载时先标记关闭，再中止在途并还原官方方法。 */
+			function dispose() {
+				if (closed) return;
+				closed = true;
+				for (const cancel of [...pending.values()]) try {
+					cancel();
+				} catch {}
+				pending.clear();
+				unmount();
+			}
+			mount();
+			return {
+				dispose,
+				native
+			};
+		}
+		//#endregion
+		//#region src/client/planBridge.ts
+		/** Optional DSH plan integration; no provider or approval UI replacement. @author ddj 2026年10月08号 */
+		const CLAIM_ID = "dsh-vscode-mode/plan";
+		const CLAIM_KIND = "edrvPlan";
+		const EMPTY_RESOURCE = { status: "none" };
 		/** @private @author ddj 2026年10月08号 @param tab Current tab. @returns Native plan fallback options, preserving transient review parameters. */
 		function nativeOptions(tab) {
 			return {
@@ -412377,8 +412646,8 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				params: tab?.navigation?.params
 			};
 		}
-		/** @private @author ddj 2026年10月08号 @param ctx Optional context. @param official Sidebar services. @returns Transfer component with native fallback and cancellable receipts. */
-		function planRouter(ctx, official) {
+		/** @private @author ddj 2026年10月08号 @param ctx Optional context. @param official Sidebar services. @param native Official openResource bypass. @returns Transfer component with native fallback and cancellable receipts. */
+		function planRouter(ctx, official, native) {
 			const transfers = /* @__PURE__ */ new Map();
 			/** @private @author ddj 2026年10月08号 @param all Plugin disposal. Cancel scope-stale transfers, not transfers merely hidden by the editor mount. */
 			function cancel(all = false) {
@@ -412408,7 +412677,7 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				function openNative() {
 					if (typeof official.service.openResource !== "function") return;
 					try {
-						official.service.openResource(address, nativeOptions(tab));
+						native(address, nativeOptions(tab));
 						tab?.actions?.close?.();
 					} catch (error) {
 						log$2.warn("计划官方查看器回退失败：" + String(error));
@@ -412475,18 +412744,21 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 				canOpen: isPlanAddress,
 				title: () => "计划预览"
 			});
-			const router = planRouter(ctx, official);
+			const direct = installPlanDirect(ctx, official.service);
+			const router = planRouter(ctx, official, direct.native);
 			try {
 				const offBody = ctx.slots.inject(OFFICIAL_SLOT_NAME, () => ctx.slots.register({
 					name: OFFICIAL_SLOT_NAME,
 					key: CLAIM_ID
 				}, router.body));
 				return () => {
+					direct.dispose();
 					router.dispose();
 					if (typeof offBody === "function") offBody();
 					offType();
 				};
 			} catch (error) {
+				direct.dispose();
 				router.dispose();
 				offType();
 				throw error;
@@ -412502,7 +412774,7 @@ td.UniverTableCell, th.UniverTableCell{mso-padding-alt:0cm 5.4pt 0cm 5.4pt;}
 			/** @private @author ddj 2026年10月08号 @param id Owning session. @returns Valid borrowed feed, or undefined on older/incompatible services. */
 			function sourceOf(id) {
 				try {
-					const sessions = optional(ctx, "sessions");
+					const sessions = optionalService(ctx, "sessions");
 					if (!id || typeof sessions?.binding !== "function") return void 0;
 					const feed = sessions.binding(id)?.eventSource;
 					return typeof feed?.getSnapshot === "function" && typeof feed.subscribe === "function" ? feed : void 0;

package/lib/client.js.map

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: package/lib/client.js.map
-size: 35677585 bytes
-sha256: df1afa8466a7852d100cfbc6a1f44e61beabd3b1808a262562e920ac06b96865
+size: 35694036 bytes
+sha256: 5a0053a6aa5733ebef51b077a624f0fc5bcf1a9c555232c357762a7eb8bdf2ef

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.23.3",
+  "version": "0.23.4",
   "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 DSH 0.1.5+ 官方右侧 Sidebar 与对话同屏）+ 命令栏（Ctrl+Shift+P）与可扩展指令系统 + VS Code 兼容代码片段（.code-snippets 全局/项目，IntelliSense 展开）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚）+ SVN 集成（侧栏变更面板/日志弹窗/并排差异）+ 语言服务器（LSP）智能（跳转定义/引用/hover/大纲 + VSIX 扩展市场安装），状态持久化到工作区旁车，界面状态（页签/光标/侧栏/编辑 Tab/导航历史）镜像到 DSH home 跨重启恢复",
   "icon": "assets/icon.svg",
   "keywords": [
@@ -84,7 +84,7 @@
     "vitest": "^3.2.4"
   },
   "scripts": {
-    "build": "tsdown",
+    "build": "tsdown && node scripts/check-client-artifacts.mjs lib",
     "build:client": "tsdown",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run && node --test tests/nativeOpen.test.mjs",

package/src/client/openReceipt.ts

@@ -4,7 +4,7 @@ import { createRequestId } from './requestId.js'
 import type { PlanDocument } from './planState.js'
 
 export interface EditorRequest { requestId: string; sessionId: string; path: string | null; line?: number; column?: number; preview?: boolean; plan?: PlanDocument }
-export interface OpenOptions { preview?: boolean; plan?: PlanDocument; signal?: AbortSignal }
+export interface OpenOptions { preview?: boolean; plan?: PlanDocument; signal?: AbortSignal; timeoutMs?: number }
 interface Waiter { request: EditorRequest; finish: (success: boolean) => void; claimed?: boolean }
 const waiters = new Map<string, Waiter>()
 
@@ -37,7 +37,7 @@ export function finishOpen(requestId: string, success: boolean, error?: string):
  * @param line Optional target line.
  * @param column Optional target column.
  * @param sessionId Owning session, required for routing.
- * @param options Explicit preview, read-only plan document and optional cancellation signal.
+ * @param options Explicit preview, read-only plan document, cancellation signal and receipt deadline.
  * @returns Actual completion; timeout and disposal are false.
  */
 export function requestOpen(path: string | null, line?: number, column?: number, sessionId = '', options: OpenOptions = {}): Promise<boolean> {
@@ -60,7 +60,7 @@ export function requestOpen(path: string | null, line?: number, column?: number,
     function abort(): void { finish(false) }
     options.signal?.addEventListener('abort', abort, { once: true })
     waiters.set(request.requestId, { request, finish })
-    timer = setTimeout(() => finish(false), 20_000)
+    timer = setTimeout(() => finish(false), options.timeoutMs ?? 20_000)
     openEditorView(null)
     window.dispatchEvent(new CustomEvent('edrv:open-request', { detail: request }))
   })

package/src/client/planBridge.ts

@@ -2,6 +2,7 @@
 import React from 'react'
 import { requestOpen } from './openReceipt.js'
 import { createPlanFeed, clearPlanState, isPlanAddress, planDocument, type PlanWindow, type PlanOpen } from './planState.js'
+import { installPlanDirect, optionalService, type PlanOpenOptions } from './planDirect.js'
 import { detectOfficial, OFFICIAL_SLOT_NAME, type OfficialSidebar } from './officialSidebar.js'
 import { readSessionScope, subscribeScope } from './sessionScope.js'
 import { log } from './log.js'
@@ -22,16 +23,12 @@ const CLAIM_ID = 'dsh-vscode-mode/plan'
 const CLAIM_KIND = 'edrvPlan'
 const EMPTY_RESOURCE = { status: 'none' }
 
-/** @private @author ddj 2026年10月08号 @param ctx Optional context. @param name Service name. @returns Service or undefined without gating plugin activation. */
-function optional(ctx: PlanContext, name: string): unknown {
-  try { return ctx.get(name) } catch { return undefined }
-}
 /** @private @author ddj 2026年10月08号 @param tab Current tab. @returns Native plan fallback options, preserving transient review parameters. */
 function nativeOptions(tab: PlanTab | undefined): { kind: string; params?: unknown } {
   return { kind: 'plan', params: tab?.navigation?.params }
 }
-/** @private @author ddj 2026年10月08号 @param ctx Optional context. @param official Sidebar services. @returns Transfer component with native fallback and cancellable receipts. */
-function planRouter(ctx: PlanContext, official: OfficialSidebar) {
+/** @private @author ddj 2026年10月08号 @param ctx Optional context. @param official Sidebar services. @param native Official openResource bypass. @returns Transfer component with native fallback and cancellable receipts. */
+function planRouter(ctx: PlanContext, official: OfficialSidebar, native: (address: string, options?: PlanOpenOptions) => void) {
   const transfers = new Map<string, { controller: AbortController; sessionId: string }>()
   /** @private @author ddj 2026年10月08号 @param all Plugin disposal. Cancel scope-stale transfers, not transfers merely hidden by the editor mount. */
   function cancel(all = false): void {
@@ -60,7 +57,7 @@ function planRouter(ctx: PlanContext, official: OfficialSidebar) {
     function openNative(): void {
       if (typeof official.service.openResource !== 'function') return
       try {
-        official.service.openResource(address, nativeOptions(tab))
+        native(address, nativeOptions(tab))
         tab?.actions?.close?.()
       } catch (error) { log.warn('计划官方查看器回退失败：' + String(error)) }
     }
@@ -99,11 +96,12 @@ function registerPlan(ctx: PlanContext, official: OfficialSidebar): () => void {
     patterns: ['dsh-resource://plan/**', 'dsh-resource://plan-review/**'],
     canOpen: isPlanAddress, title: () => '计划预览',
   })
-  const router = planRouter(ctx, official)
+  const direct = installPlanDirect(ctx, official.service)
+  const router = planRouter(ctx, official, direct.native)
   try {
     const offBody = ctx.slots.inject(OFFICIAL_SLOT_NAME, () => ctx.slots.register({ name: OFFICIAL_SLOT_NAME, key: CLAIM_ID }, router.body))
-    return () => { router.dispose(); if (typeof offBody === 'function') offBody(); offType() }
-  } catch (error) { router.dispose(); offType(); throw error }
+    return () => { direct.dispose(); router.dispose(); if (typeof offBody === 'function') offBody(); offType() }
+  } catch (error) { direct.dispose(); router.dispose(); offType(); throw error }
 }
 /** @private @author ddj 2026年10月08号 @param ctx Context. @returns Current-session feed subscription, cancelling pending opens on scope change. */
 function watchPlans(ctx: PlanContext): () => void {
@@ -116,7 +114,7 @@ function watchPlans(ctx: PlanContext): () => void {
   /** @private @author ddj 2026年10月08号 @param id Owning session. @returns Valid borrowed feed, or undefined on older/incompatible services. */
   function sourceOf(id: string): EventSource | undefined {
     try {
-      const sessions = optional(ctx, 'sessions') as Sessions | undefined
+      const sessions = optionalService(ctx, 'sessions') as Sessions | undefined
       if (!id || typeof sessions?.binding !== 'function') return undefined
       const feed = sessions.binding(id)?.eventSource
       return typeof feed?.getSnapshot === 'function' && typeof feed.subscribe === 'function' ? feed : undefined

package/src/client/planDirect.ts

@@ -0,0 +1,266 @@
+/**
+ * dsh-vscode-mode client — 计划地址直通。
+ *
+ * 背景：官方计划卡片「查看全文」调 `ctx.sidebarRight.openResource(planAddress)`，
+ * 侧栏会先创建计划页签、再由本插件认领并立刻关闭，桌面端表现为「快速打开又迅速关闭」。
+ * 本模块在装配时包装该服务方法：能直接拿到计划正文时改为把只读计划送进「文件编辑」，
+ * 不再创建侧栏页签；地址不属于在屏会话、正文暂不可得、编辑器未回执或包装未生效时
+ * 一律回落原方法，官方页签与原认领转交链路继续作为后备。
+ * 作者 ddj 2026年10月31号
+ */
+
+import { log } from './log.js'
+import { requestOpen } from './openReceipt.js'
+import { cachedPlan, isPlanAddress, planDocument, rememberPlan, type PlanDocument } from './planState.js'
+import { readSessionScope } from './sessionScope.js'
+
+//region 对外结构面
+
+/** 官方 openResource 的可选参数（临时回顾页签的正文在 params.planReview 里）。 */
+export interface PlanOpenOptions { kind?: string; params?: unknown }
+
+/** sidebarRight 的最小结构面：只接管 openResource 的调用。 */
+export interface PlanServiceLike { openResource?: (address: string, options?: PlanOpenOptions) => void }
+
+/** 直通装配结果：native 绕过包装回落原方法，dispose 中止在途并条件还原。 */
+export interface PlanDirect {
+  dispose: () => void
+  native: (address: string, options?: PlanOpenOptions) => void
+}
+
+/** 资源流最小结构面（@deepseek-ai/dsh-client-resources 为可选依赖）。 */
+interface ResourceStream { getSnapshot?: () => unknown; subscribe?: (listener: () => void) => unknown }
+
+/** resources 服务最小结构面。 */
+interface ResourcesLike { source?: (address: string) => ResourceStream | undefined }
+
+//endregion
+
+/** 正文解析上限：超过即回落官方页签，避免点击后长时间无反馈。 */
+const RESOLVE_MS = 1_500
+/** 编辑器回执上限：超过即回落官方页签。 */
+const ROUTE_MS = 5_000
+
+/** @public @author ddj 2026年10月31号
+ * 可选探测客户端服务，缺失或抛错时返回 undefined。
+ * @param ctx 客户端上下文（只需 get）。
+ * @param name 服务名。
+ * @returns 服务实例，或 undefined（不阻断装配）。
+ */
+export function optionalService(ctx: { get: (name: string) => unknown }, name: string): unknown {
+  try { return ctx.get(name) } catch { return undefined }
+}
+
+/** @public @author ddj 2026年10月31号
+ * 包装官方 openResource，把本会话的计划地址改为直通插件编辑器。
+ * @param ctx 客户端上下文（可选服务一律 ctx.get 探测）。
+ * @param service 官方 sidebarRight 服务；仅在赋值生效时留下包装。
+ * @returns 供路由回退使用的原方法，以及卸载时中止在途并还原的清理函数。
+ */
+export function installPlanDirect(ctx: { get: (name: string) => unknown }, service: PlanServiceLike): PlanDirect {
+  const original = service.openResource
+  const pending = new Map<string, () => void>()
+  let closed = false
+  let installed = false
+
+  //region 判定与参数
+
+  /** @private @author ddj 2026年10月31号
+   * 解码地址段（畸形编码一律视为不可接管）。
+   * @param address 官方资源地址。
+   * @returns 去掉协议前缀后的解码段。
+   */
+  function decode(address: string): string[] | undefined {
+    try { return address.split('/').slice(3).map(decodeURIComponent) } catch { return undefined }
+  }
+
+  /** @private @author ddj 2026年10月31号
+   * 判断该地址是否由本插件接管：只认两段式计划地址，且归属当前在屏会话。
+   * @param address 官方资源地址。
+   * @returns 可接管的会话 id，其他情况 undefined（回落原方法）。
+   */
+  function take(address: string): string | undefined {
+    if (closed || !isPlanAddress(address)) return undefined
+
+    const segments = decode(address)
+    if (segments?.length !== 2) return undefined
+
+    const current = readSessionScope(ctx).sessionId ?? ''
+    return current !== '' && segments[0] === current ? current : undefined
+  }
+
+  /** @private @author ddj 2026年10月31号
+   * 读官方参数里随页签携带的计划正文（临时回顾页签走这里）。
+   * @param address 官方资源地址。
+   * @param options 官方 openResource 参数。
+   * @returns 计划正文，或不带正文时 undefined。
+   */
+  function inline(address: string, options?: PlanOpenOptions): PlanDocument | undefined {
+    const params = options?.params
+    if (params === null || typeof params !== 'object') return undefined
+    return planDocument(address, (params as { planReview?: unknown }).planReview)
+  }
+
+  //endregion
+
+  //region 资源解析
+
+  /** @private @author ddj 2026年10月31号
+   * 打开计划资源流。
+   * @param services resources 服务。
+   * @param address 官方资源地址。
+   * @returns 资源流；服务缺失或抛错时 undefined。
+   */
+  function streamOf(services: ResourcesLike | undefined, address: string): ResourceStream | undefined {
+    try { return services?.source?.(address) } catch { return undefined }
+  }
+
+  /** @private @author ddj 2026年10月31号
+   * 从资源快照读已就绪的计划正文。
+   * @param address 官方资源地址。
+   * @param stream 计划资源流。
+   * @returns 计划正文；未就绪、失败或内容不完整时 undefined。
+   */
+  function planOf(address: string, stream: ResourceStream): PlanDocument | undefined {
+    let snapshot: unknown
+    try { snapshot = stream.getSnapshot?.() } catch { return undefined }
+
+    const state = snapshot !== null && typeof snapshot === 'object' ? snapshot as { status?: unknown; value?: unknown } : {}
+    return state.status === 'live' ? planDocument(address, state.value) : undefined
+  }
+
+  /** @private @author ddj 2026年10月31号
+   * 订阅资源快照变化。
+   * @param stream 计划资源流。
+   * @param listener 变更监听。
+   * @returns 退订函数；订阅面缺失或抛错时为 no-op。
+   */
+  function watchStream(stream: ResourceStream, listener: () => void): () => void {
+    try {
+      const off = stream.subscribe?.(listener)
+      return typeof off === 'function' ? off as () => void : () => undefined
+    } catch { return () => undefined }
+  }
+
+  //endregion
+
+  //region 直通与回落
+
+  /** @private @author ddj 2026年10月31号
+   * 回落官方方法（包装外的原入口）。
+   * @param address 官方资源地址。
+   * @param options 官方参数。
+   * @returns 无；失败只记日志，不影响点击链路。
+   */
+  function native(address: string, options?: PlanOpenOptions): void {
+    if (typeof original !== 'function') return
+    try { original.call(service, address, options) } catch (error) { log.warn('官方计划页签回退失败：' + String(error)) }
+  }
+
+  /** @private @author ddj 2026年10月31号
+   * 把已解析的计划送进插件编辑器；地址级在途合并，重复点击不叠开。
+   * @param plan 计划正文。
+   * @param session 归属会话。
+   * @param address 官方资源地址。
+   * @param options 官方参数（回落时原样透传）。
+   * @returns 无；未就绪或失败时回落官方页签，但不劫持已切换的会话。
+   */
+  function direct(plan: PlanDocument, session: string, address: string, options?: PlanOpenOptions): void {
+    if (closed || pending.has(address)) return
+
+    const controller = new AbortController()
+    pending.set(address, () => { pending.delete(address); controller.abort() })
+    rememberPlan(plan)
+
+    /** @private @author ddj 2026年10月31号 @param ok 编辑器是否就绪。 @returns 无；失败时回落官方页签。 */
+    function settle(ok: boolean): void {
+      pending.delete(address)
+      if (ok || closed || readSessionScope(ctx).sessionId !== session) return
+      native(address, options)
+    }
+    requestOpen(null, undefined, undefined, session, { preview: true, plan, signal: controller.signal, timeoutMs: ROUTE_MS })
+      .then(settle, (error: unknown) => { log.warn('计划直通失败：' + String(error)); settle(false) })
+  }
+
+  /** @private @author ddj 2026年10月31号
+   * 从计划资源异步解析正文，就绪后直通；超时或无法解析回落官方页签。
+   * @param address 官方资源地址。
+   * @param session 归属会话。
+   * @param options 官方参数。
+   * @returns 无。
+   */
+  function lookup(address: string, session: string, options?: PlanOpenOptions): void {
+    const stream = streamOf(optionalService(ctx, 'resources') as ResourcesLike | undefined, address)
+    if (stream === undefined) { native(address, options); return }
+
+    const early = planOf(address, stream)
+    if (early !== undefined) { direct(early, session, address, options); return }
+    if (closed || pending.has(address)) return
+
+    let timer: ReturnType<typeof setTimeout> | undefined
+    let stop: (() => void) | undefined
+    let done = false
+
+    /** @private @author ddj 2026年10月31号 @param ok 是否已拿到正文。 @returns 无；幂等收尾，清定时器、退订、释放地址。 */
+    function finish(ok: boolean): void {
+      if (done) return
+      done = true
+      if (timer !== undefined) clearTimeout(timer)
+      stop?.()
+      pending.delete(address)
+      if (!ok && !closed) native(address, options)
+    }
+    pending.set(address, () => finish(false))
+    timer = setTimeout(() => finish(false), RESOLVE_MS)
+    stop = watchStream(stream, () => {
+      const plan = planOf(address, stream)
+      if (plan === undefined) return
+      finish(true)
+      direct(plan, session, address, options)
+    })
+  }
+
+  //endregion
+
+  //region 装配
+
+  /** @private @author ddj 2026年10月31号 @param address 官方资源地址。 @param options 官方参数。 @returns 无；包装后的 openResource 入口。 */
+  function open(address: string, options?: PlanOpenOptions): void {
+    const session = take(address)
+    if (session === undefined) { native(address, options); return }
+
+    const known = inline(address, options) ?? cachedPlan(address)
+    if (known !== undefined) { direct(known, session, address, options); return }
+    lookup(address, session, options)
+  }
+
+  /** @private @author ddj 2026年10月31号 @returns 无；赋值后校验，未生效即降级为原认领转交链路。 */
+  function mount(): void {
+    if (typeof original !== 'function') return
+    try { service.openResource = open } catch (error) { log.warn('计划直通装配失败：' + String(error)) }
+    installed = service.openResource === open
+    if (installed) return
+    try { service.openResource = original } catch { /* 只读服务：保持原状 */ }
+  }
+
+  /** @private @author ddj 2026年10月31号 @returns 无；仅在包装仍是自己时还原（HMR 安全）。 */
+  function unmount(): void {
+    if (!installed || service.openResource !== open) return
+    try { service.openResource = original } catch (error) { log.warn('计划直通还原失败：' + String(error)) }
+    installed = false
+  }
+
+  /** @private @author ddj 2026年10月31号 @returns 无；卸载时先标记关闭，再中止在途并还原官方方法。 */
+  function dispose(): void {
+    if (closed) return
+    closed = true
+    for (const cancel of [...pending.values()]) { try { cancel() } catch { /* 收尾失败不影响卸载 */ } }
+    pending.clear()
+    unmount()
+  }
+
+  mount()
+  return { dispose, native }
+
+  //endregion
+}

package/src/client/planState.ts

@@ -4,6 +4,8 @@ export interface PlanOpen { path?: string; plan?: PlanDocument }
 export interface PlanEntry { type?: string; event: { type: string; seq?: number; data: unknown } }
 export interface PlanWindow { revision: number; entries: readonly PlanEntry[]; change: { kind: string; entries?: readonly PlanEntry[] } }
 const associated = new Map<string, Set<string>>()
+/** 地址 → 已解析计划正文（只留内存，供后续点击省掉一次资源解析）。 */
+const documents = new Map<string, PlanDocument>()
 
 /** @private @author ddj 2026年10月08号 @param value JSON candidate. @returns Object or empty record. */
 function record(value: unknown): Record<string, unknown> {
@@ -59,8 +61,24 @@ function associate(sessionId: string, path: string, cwd: string): void {
   associated.set(sessionId, paths)
   if (associated.size > 32) associated.delete(associated.keys().next().value!)
 }
+/** @public @author ddj 2026年10月31号
+ * 记住一份已解析计划，供「查看全文」时免去资源解析。
+ * @param plan 已解析计划。
+ * @returns 无；只缓存合法地址与正文，超过上限按插入序淘汰。
+ */
+export function rememberPlan(plan: PlanDocument): void {
+  const valid = planDocument(plan.address, plan)
+  if (valid === undefined) return
+
+  documents.set(valid.address, valid)
+  if (documents.size > 64) documents.delete(documents.keys().next().value!)
+}
+
+/** @public @author ddj 2026年10月31号 @param address 官方资源地址。 @returns 已缓存的计划正文。 */
+export function cachedPlan(address: string): PlanDocument | undefined { return documents.get(address) }
+
 /** @public @author ddj 2026年10月08号 Clear associations when the plugin unloads. */
-export function clearPlanState(): void { associated.clear() }
+export function clearPlanState(): void { associated.clear(); documents.clear() }
 
 /** @public @author ddj 2026年10月08号
  * Reduce only live append deltas; hydration, pagination, reconnect and duplicate sequences never open plans.
@@ -91,7 +109,7 @@ export function createPlanFeed(sessionId: string, cwd = '') {
       if (event.type === 'tool/result') return undefined
       const address = 'dsh-resource://plan/' + encodeURIComponent(sessionId) + '/' + encodeURIComponent(id)
       const plan = planDocument(address, { markdown: call.args.plan })
-      if (plan) { remember(id); return { plan } }
+      if (plan) { rememberPlan(plan); remember(id); return { plan } }
       return undefined
     }
     if (!settled || !['write', 'edit'].includes(call.name) || typeof call.args.file_path !== 'string') return undefined