dsh-vscode-mode 0.20.4 → 0.20.5

package/lib/index.js

@@ -2409,6 +2409,17 @@ async function resolveTarget(ctx, session, path) {
 	return fs.resolve(path, cwd ? { cwd } : {});
 }
 /**
+* 按已知工作区目录解析目标路径：跨实例只读路径在无 live 会话时使用。
+* @author ddj 2026年10月28号
+* @param ctx DSH 上下文
+* @param cwd 工作区绝对路径（live 投影或持久化 header）
+* @param path 客户端请求路径
+* @returns 解析后的目标
+*/
+async function resolveTargetIn(ctx, cwd, path) {
+	return ctx.get("fs").resolve(path, cwd ? { cwd } : {});
+}
+/**
 * 严格读取旧 sidecar：仅确认确实不存在时才允许从空记录迁移。
 * @author ddj 2026年09月30号
 * @param ctx DSH 上下文
@@ -6263,6 +6274,10 @@ function registerRoutes(ctx, config, handleRpc, onWarning) {
 }
 //#endregion
 //#region src/registry.ts
+/** sessionId → cwd 冷读缓存：header.cwd 建会话后不可变，故只增不改。 */
+const coldCwdCache = /* @__PURE__ */ new Map();
+/** 冷读缓存上限：超出后整表清空，避免长跑实例无限累积。 */
+const COLD_CWD_CACHE_MAX = 2048;
 /** 按 sessionId 取会话；缺省时仅当唯一活跃会话才返回。 */
 function sessionOf(ctx, sessionId) {
 	const sessions = ctx.get("sessions");
@@ -6290,6 +6305,78 @@ function bucketOf(registry, ctx, cwd) {
 		return map;
 	});
 }
+/**
+* 解析会话作用域：优先本进程 live 会话；未命中时冷读持久化会话头取 cwd。
+* 仅供只读 RPC 使用——桌面端与 Web 端各有独立宿主，会话只在创建端 live，
+* 但审查数据按 cwd 落盘、跨实例可读；写类 RPC 必须另行要求 live 会话。
+* @author ddj 2026年10月28号
+* @param ctx DSH 上下文（可选探测 sessions 与 sessionQuery）
+* @param sessionId 目标会话 id（冷读必需；缺省时只认唯一活跃会话）
+* @returns 会话作用域，或与 requireSession 同源的错误文案
+*/
+async function resolveScope(ctx, sessionId) {
+	const session = sessionOf(ctx, sessionId);
+	if (session) {
+		const cwd = cwdOfSession(ctx, session);
+		return cwd ? {
+			session,
+			cwd
+		} : { err: SESSION_NO_WORKSPACE_ERROR };
+	}
+	const cwd = await coldCwdOf(ctx, sessionId);
+	return cwd ? { cwd } : { err: SESSION_MISSING_ERROR };
+}
+/**
+* 冷读持久化会话头的 cwd：走 DSH sessionQuery 的持久化视图，不读事件日志、不碰写句柄。
+* @author ddj 2026年10月28号
+* @param ctx DSH 上下文
+* @param sessionId 目标会话 id
+* @returns 绝对路径；服务缺失、查无此会话或读取失败时 null（失败语义等同 live 未命中）
+*/
+async function coldCwdOf(ctx, sessionId) {
+	if (!sessionId) return null;
+	const cached = coldCwdCache.get(sessionId);
+	if (cached) return cached;
+	const query = ctx?.get?.("sessionQuery");
+	if (!query) return null;
+	try {
+		const cwd = (await findColdRecord(query, sessionId))?.header?.cwd;
+		if (typeof cwd !== "string" || !cwd) return null;
+		rememberColdCwd(sessionId, cwd);
+		return cwd;
+	} catch {
+		return null;
+	}
+}
+/**
+* 在 sessionQuery 的持久化会话视图里定位一条记录（优先精确过滤，其次整表列举）。
+* 两种能力都缺失时返回 null，调用方回落原有「会话不存在」。
+* @author ddj 2026年10月28号
+* @param query ctx.sessionQuery 服务（不同 DSH 版本能力不同）
+* @param sessionId 目标会话 id
+* @returns 会话记录；无此会话或能力缺失时 null
+*/
+async function findColdRecord(query, sessionId) {
+	const filterable = typeof query.filterSessions === "function";
+	const listable = typeof query.listSessions === "function";
+	if (!filterable && !listable) return null;
+	const records = filterable ? await query.filterSessions([{
+		kind: "id",
+		values: [sessionId]
+	}]) : await query.listSessions();
+	if (!Array.isArray(records)) return null;
+	return records.find((item) => item?.header?.id === sessionId) ?? null;
+}
+/**
+* 记录冷读结果（header.cwd 不可变，可长期复用）。
+* @author ddj 2026年10月28号
+* @param sessionId 目标会话 id
+* @param cwd 已确认的绝对工作区路径
+*/
+function rememberColdCwd(sessionId, cwd) {
+	if (coldCwdCache.size >= COLD_CWD_CACHE_MAX) coldCwdCache.clear();
+	coldCwdCache.set(sessionId, cwd);
+}
 //#endregion
 //#region src/remoteWorkspace.ts
 /**
@@ -12963,15 +13050,29 @@ function finishUndo(cwd, request) {
 }
 //#endregion
 //#region src/reviewRpc.ts
-/** @public @author ddj 2026年10月26号 @param ctx Host. @param registry Workspace cache. @returns Handlers resolving workspace from the live authenticated session, never caller cwd. */
+/**
+* @public
+* @author ddj 2026年10月26号 / 2026年10月28号
+* @description: 审查 RPC 处理器。工作区一律由 host 解析，绝不采信调用方 cwd：
+* 读路径优先 live 会话、其次冷读持久化会话头（跨实例只读）；写路径仍须 live 会话。
+* @param ctx Host 上下文
+* @param registry 工作区记录桶缓存
+* @returns 审查相关处理器表
+*/
 function reviewHandlers(ctx, registry) {
-	/** @private @author ddj 2026年10月26号 @param sessionId Request scope. @returns Migrated workspace, or explicit failure without fallback. */
+	/** @private @author ddj 2026年10月28号 @param sessionId 请求作用域 @returns 已迁移工作区（允许跨实例冷读） */
 	async function workspace(sessionId) {
-		const session = sessionOf(ctx, sessionId);
-		const cwd = cwdOfSession(ctx, session);
-		if (!session || !cwd) throw new Error("会话不存在或没有工作区");
-		await bucketOf(registry, ctx, cwd);
-		return cwd;
+		const scope = await resolveScope(ctx, sessionId);
+		if ("err" in scope) throw new Error("会话不存在或没有工作区");
+		await bucketOf(registry, ctx, scope.cwd);
+		return scope.cwd;
+	}
+	/** @private @author ddj 2026年10月28号 @param sessionId 请求作用域 @returns 本端 live 会话的工作区；冷读作用域一律拒绝写入 */
+	async function liveWorkspace(sessionId) {
+		const scope = await resolveScope(ctx, sessionId);
+		if ("err" in scope || !scope.session) throw new Error("会话不存在或没有工作区");
+		await bucketOf(registry, ctx, scope.cwd);
+		return scope.cwd;
 	}
 	return {
 		"edrv.review.list": async (args) => {
@@ -12991,7 +13092,7 @@ function reviewHandlers(ctx, registry) {
 			};
 		},
 		"edrv.review.decide": async (args) => {
-			const cwd = await workspace(args.sessionId);
+			const cwd = await liveWorkspace(args.sessionId);
 			try {
 				return {
 					ok: true,
@@ -13092,7 +13193,7 @@ async function readTargetOf(ctx, sc, path) {
 	const fs = ctx.get("fs");
 	if (!fs) return { err: "缺少 fs" };
 	try {
-		const target = await resolveTarget(ctx, sc.session, path);
+		const target = await resolveTargetIn(ctx, sc.cwd, path);
 		debugRecord(ctx, sc.cwd, "[DEBUG path.resolve] input=" + String(path ?? "") + " resolved=" + fs.processPath(target), "debug");
 		const info = await fs.stat(target);
 		if (!info || info.type !== "file") return {
@@ -13504,7 +13605,7 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 			const start = performance.now();
 			let staleMs = 0;
 			let staleChecked = false;
-			const sc = await requireSession(ctx, args.sessionId);
+			const sc = await resolveScope(ctx, args.sessionId);
 			if ("err" in sc) return {
 				ok: false,
 				error: sc.err
@@ -13512,7 +13613,7 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 			const bucket = await bucketOf(registry, ctx, sc.cwd);
 			const loadMs = performance.now() - start;
 			const want = Array.isArray(args.callIds) ? new Set(args.callIds) : null;
-			if (!want && args.skipStale !== true) {
+			if (sc.session && !want && args.skipStale !== true) {
 				const now = Date.now();
 				if (now - (staleCheckedAt.get(sc.cwd) ?? 0) > STALE_CHECK_MIN_MS) {
 					staleCheckedAt.set(sc.cwd, now);
@@ -13547,7 +13648,7 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 		* @author ddj 2026年09月28号
 		*/
 		"edrv.uiState.get": async (args) => {
-			const sc = await requireSession(ctx, args.sessionId);
+			const sc = await resolveScope(ctx, args.sessionId);
 			if ("err" in sc) return {
 				ok: false,
 				error: sc.err
@@ -13564,7 +13665,7 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 		* @author ddj 2026年09月28号 / 2026年09月29号
 		*/
 		"edrv.uiState.set": async (args) => {
-			const sc = await requireSession(ctx, args.sessionId);
+			const sc = await resolveScope(ctx, args.sessionId);
 			if ("err" in sc) return {
 				ok: false,
 				error: sc.err
@@ -13642,14 +13743,14 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 		},
 		/** @author ddj 2026年10月22号 @param args Read-only request. @returns Bounded official range read, or unsupported on older providers; never bypasses Host IO. */
 		"edrv.textPage": async (args) => {
-			const sc = await requireSession(ctx, args.sessionId);
+			const sc = await resolveScope(ctx, args.sessionId);
 			if ("err" in sc) return {
 				ok: false,
 				error: sc.err,
 				reason: "read-failed"
 			};
 			try {
-				const target = await resolveTarget(ctx, sc.session, args.path);
+				const target = await resolveTargetIn(ctx, sc.cwd, args.path);
 				const fs = ctx.get("fs");
 				if (typeof fs?.readByteRange !== "function" || typeof fs.stat !== "function") return readTextPage(void 0, args);
 				const targetKey = typeof target === "string" ? target : target.targetKey;
@@ -13721,7 +13822,7 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 					resolvedPath: snippetTarget
 				};
 			}
-			const sc = await requireSession(ctx, args.sessionId);
+			const sc = await resolveScope(ctx, args.sessionId);
 			if ("err" in sc) return {
 				ok: false,
 				error: sc.err
@@ -13760,7 +13861,7 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 			}
 		},
 		"edrv.readBinary": async (args) => {
-			const sc = await requireSession(ctx, args.sessionId);
+			const sc = await resolveScope(ctx, args.sessionId);
 			if ("err" in sc) return {
 				ok: false,
 				error: sc.err
@@ -13829,7 +13930,7 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 			};
 		},
 		"edrv.original": async (args) => {
-			const sc = await requireSession(ctx, args.sessionId);
+			const sc = await resolveScope(ctx, args.sessionId);
 			if ("err" in sc) return {
 				ok: false,
 				error: sc.err
@@ -13840,7 +13941,7 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 				error: "缺少 fs"
 			};
 			try {
-				const target = await resolveTarget(ctx, sc.session, args.path);
+				const target = await resolveTargetIn(ctx, sc.cwd, args.path);
 				debugRecord(ctx, sc.cwd, "[DEBUG path.resolve] input=" + String(args.path ?? "") + " resolved=" + fs.processPath(target), "debug");
 				const info = await fs.stat(target);
 				if (!info || info.type !== "file") return {
@@ -14000,7 +14101,7 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 			}
 		},
 		"edrv.archiveList": async (args) => {
-			const sc = await requireSession(ctx, args.sessionId);
+			const sc = await resolveScope(ctx, args.sessionId);
 			if ("err" in sc) return {
 				ok: false,
 				error: sc.err
@@ -14022,7 +14123,7 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 			}
 		},
 		"edrv.archivePage": async (args) => {
-			const sc = await requireSession(ctx, args.sessionId);
+			const sc = await resolveScope(ctx, args.sessionId);
 			if ("err" in sc) return {
 				ok: false,
 				error: sc.err
@@ -14046,7 +14147,7 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 			}
 		},
 		"edrv.archiveRead": async (args) => {
-			const sc = await requireSession(ctx, args.sessionId);
+			const sc = await resolveScope(ctx, args.sessionId);
 			if ("err" in sc) return {
 				ok: false,
 				error: sc.err
@@ -14257,7 +14358,7 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 			}
 		},
 		"edrv.listDir": async (args) => {
-			const sc = await requireSession(ctx, args.sessionId);
+			const sc = await resolveScope(ctx, args.sessionId);
 			if ("err" in sc) return {
 				ok: false,
 				error: sc.err