dsh-vscode-mode 0.14.6 → 0.14.8

package/lib/index.js

@@ -10,6 +10,7 @@ import { Buffer as Buffer$1 } from "node:buffer";
 import { execFile, spawn, spawnSync } from "node:child_process";
 import z from "@deepseek-ai/schemastery";
 import { inflateRawSync } from "node:zlib";
+import { StringDecoder } from "node:string_decoder";
 //#region src/hostImport.ts
 /** Host-anchored optional package imports. @author ddj 2026年09月28号 */
 /**
@@ -1371,6 +1372,21 @@ function tortoiseLaunchArgv(exe, action, absPath) {
 		"/path:" + absPath
 	];
 }
+/** 条目状态 → 中文说明（徽标 tooltip / 面板行 tooltip）。 */
+const SVN_STATUS_LABEL = {
+	normal: "未修改",
+	added: "已添加（待提交）",
+	deleted: "已删除（待提交）",
+	replaced: "已替换",
+	conflicted: "冲突",
+	missing: "缺失（已被外部删除）",
+	unversioned: "未纳入版本控制",
+	obstructed: "类型冲突（被同名的其他类型占用）",
+	ignored: "已被忽略",
+	modified: "已修改",
+	external: "外部定义",
+	incomplete: "不完整（需 cleanup）"
+};
 /**
 * 是否属于「工作副本变更」（`normal`/`external` 不算；`ignored` 由开关决定是否收录）。
 * @author ddj 2026年09月16号
@@ -1382,6 +1398,21 @@ function isSvnChange(entry) {
 	if (entry.status === "ignored") return false;
 	return true;
 }
+/**
+* 文件夹聚合决胜优先级（强→弱）：冲突/障碍/缺失等 danger 态先于常规修改，
+* 未版本控制最弱；未列出的状态（normal/external/ignored）不参与聚合。
+*/
+const SVN_FOLDER_STATUS_RANK = {
+	conflicted: 90,
+	obstructed: 80,
+	missing: 70,
+	incomplete: 60,
+	deleted: 50,
+	replaced: 40,
+	modified: 30,
+	added: 20,
+	unversioned: 10
+};
 /** W2-6 内容护栏嗅探窗（字符数；NUL/U+FFFD 只看前 8K，全量扫描大文本得不偿失）。 */
 const GUARD_SNIFF_CHARS = 8192;
 /**
@@ -4190,6 +4221,103 @@ function reconstructOriginal(records, content) {
 		}))
 	};
 }
+/**
+* @public
+* @author ddj 2026年10月10号
+* 判断记录是否完全未决策；缺少逐块状态时沿用 pending 的 call 状态。
+* @param record 审查记录
+* @returns 未归档、未覆盖且没有用户决策时为 true
+*/
+function fullyPending(record) {
+	return !record.archived && !record.superseded && record.decisions.call === "pending" && record.decisions.perHunk.every((value) => value === "pending");
+}
+/**
+* @public
+* @author ddj 2026年10月10号
+* 比较整组 hunk 是否逐块精确逆反；不把新建或纯 no-op 当作抵消。
+* @param prior 先前修改的差异块
+* @param later 后续修改的差异块
+* @returns 文本归一化后整组逆反且包含真实修改时为 true
+*/
+function hunksInverse(prior, later) {
+	if (!prior.length || prior.length !== later.length) return false;
+	let changed = false;
+	for (let idx = 0; idx < prior.length; idx++) {
+		const a = normalizeHunk(prior[idx]);
+		const b = normalizeHunk(later[idx]);
+		if (a.oldText !== b.newText || a.newText !== b.oldText) return false;
+		if (!isNoopHunk(a)) changed = true;
+	}
+	return changed;
+}
+/**
+* @private
+* @author ddj 2026年10月10号
+* 同路径优先按捕获批次排序；旧记录仅使用有效时间，不拿 callId 伪造先后证据。
+* @param a 第一条记录
+* @param b 第二条记录
+* @returns 负数表示 a 更早，零表示先后无法区分
+*/
+function recordOrder(a, b) {
+	if (a.path !== b.path) return a.path.localeCompare(b.path);
+	if (Number.isInteger(a.batch) && Number.isInteger(b.batch) && a.batch > 0 && b.batch > 0 && a.batch !== b.batch) return a.batch - b.batch;
+	const delta = Date.parse(a.at) - Date.parse(b.at);
+	return Number.isFinite(delta) ? delta : 0;
+}
+/**
+* @private
+* @author ddj 2026年10月10号
+* 确认完整文件快照往返，防止相同文本在不同位置的反向修改被误隐藏。
+* @param prior 先前记录
+* @param later 后续记录
+* @returns 两端快照互换且文件存在性未变化时为 true；缺少证据时保留审查
+*/
+function snapshotsRestore(prior, later) {
+	if (prior.create || later.create) return false;
+	if (typeof prior.before !== "string" || typeof prior.after !== "string" || typeof later.before !== "string" || typeof later.after !== "string") return false;
+	return normalizeForCompare(prior.before) === normalizeForCompare(later.after) && normalizeForCompare(prior.after) === normalizeForCompare(later.before);
+}
+/**
+* @public
+* @author ddj 2026年10月10号
+* 查找最近一条未决的整记录逆反；必须有文件快照证明原内容确实恢复。
+* @param records 工作区记录（不修改输入）
+* @param record 新记录
+* @returns 可安全配对的先前记录，证据不足或部分撤销时为 null
+*/
+function findInversePrior(records, record) {
+	if (!fullyPending(record)) return null;
+	let found = null;
+	for (const prior of records) {
+		if (prior.callId === record.callId || prior.path !== record.path || !fullyPending(prior)) continue;
+		if (recordOrder(prior, record) >= 0 || !hunksInverse(prior.hunks, record.hunks)) continue;
+		if (!snapshotsRestore(prior, record)) continue;
+		if (!found || recordOrder(found, prior) < 0) found = prior;
+	}
+	return found;
+}
+/**
+* @public
+* @author ddj 2026年10月10号
+* 按捕获顺序贪心配对历史抵消记录，每条最多使用一次；桶上限为 200。
+* @param records 工作区记录（不修改输入或记录状态）
+* @returns 可以整对归档的记录对
+*/
+function findCanceledPairs(records) {
+	const available = [];
+	const pairs = [];
+	const ordered = [...records].sort(recordOrder);
+	for (const record of ordered) {
+		const prior = findInversePrior(available, record);
+		if (!prior) {
+			if (fullyPending(record)) available.push(record);
+			continue;
+		}
+		pairs.push([prior, record]);
+		available.splice(available.indexOf(prior), 1);
+	}
+	return pairs;
+}
 /** 文件当前最大批次号（无记录为 0）。 */
 function fileMaxBatch(records, path) {
 	let m = 0;
@@ -5076,6 +5204,44 @@ async function autoArchiveStale(ctx, session, cwd, bucket) {
 	return stale.length;
 }
 /**
+* @public
+* @author ddj 2026年10月10号
+* 归档整记录精确抵消对；捕获时仅检查新记录，列表维护时检查整个桶。
+* @param ctx DSH 上下文
+* @param session 当前会话
+* @param cwd 工作区
+* @param bucket 活跃记录桶
+* @param record 可选的新捕获记录
+* @returns 本次归档记录数（不是配对数）
+* @throws 归档失败时恢复内存标志并透传错误，已保存的捕获记录不受影响
+*/
+async function archiveCanceled(ctx, session, cwd, bucket, record) {
+	const records = [...bucket.values()];
+	const prior = record ? findInversePrior(records, record) : null;
+	const canceled = (record ? prior ? [[prior, record]] : [] : findCanceledPairs(records)).flat();
+	if (!canceled.length) return 0;
+	const original = canceled.map((rec) => ({
+		rec,
+		at: rec.at,
+		superseded: rec.superseded
+	}));
+	const at = (/* @__PURE__ */ new Date()).toISOString();
+	for (const rec of canceled) {
+		rec.superseded = true;
+		rec.at = at;
+	}
+	try {
+		await archiveRecords(ctx, session, cwd, bucket, canceled, "编辑过程自抵消（新增后还原），自动跳过审查");
+	} catch (error) {
+		for (const item of original) {
+			item.rec.superseded = item.superseded;
+			item.rec.at = item.at;
+		}
+		throw error;
+	}
+	return canceled.length;
+}
+/**
 * 追加归档条目（按 cwd+path+batch 合并，同 callId 去重）。
 * @author ddj 2026年09月30号
 * @param ctx DSH 上下文
@@ -6334,6 +6500,11 @@ async function persistRecord(ctx, registry, session, cwd, record) {
 		for (const [callId, rec] of prior) bucket.set(callId, rec);
 		throw error;
 	}
+	try {
+		await archiveCanceled(ctx, session, cwd, bucket, record);
+	} catch (error) {
+		log.warn("archive canceled edits failed: " + String(error));
+	}
 }
 /**
 * 捕获一次工具执行结果（tools/result）：edit/write/remote_ssh_write 成功时
@@ -9135,6 +9306,18 @@ async function ensureOpenBridge(ctx, baseUrl) {
 	await writeOpenConfig(ctx, dir, baseUrl, inbox);
 	return join(dir, "dsh-open.ini");
 }
+/** @public @author ddj 2026年10月12号
+* Provision the active profile's independent bridge at startup (desktop or web).
+* Mirrors unityInstall's per-profile bridge without requiring a registered project,
+* so Unity can select either target. Unknown profile returns null instead of failing.
+* @param ctx Active host context.
+* @param baseUrl Selected public Web URL (unused for desktop wake).
+* @returns Absolute profile bridge INI path, or null when no owned profile is active.
+*/
+async function ensureActiveBridge(ctx, baseUrl) {
+	if (!findProfileDir(ctx)) return null;
+	return ensureOpenBridge(ctx, baseUrl);
+}
 /** @private @author ddj 2026年09月28号
 * Replace a bridge file atomically without following a preexisting file link.
 * @param path Destination in the validated bridge directory.
@@ -11409,6 +11592,7 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 					staleChecked = true;
 					const staleStart = performance.now();
 					await autoArchiveStale(ctx, sc.session, sc.cwd, bucket);
+					await archiveCanceled(ctx, sc.session, sc.cwd, bucket);
 					staleMs = performance.now() - staleStart;
 				}
 			}
@@ -18407,6 +18591,592 @@ var SvnUpdateJobs = class {
 		};
 	}
 };
+//#endregion
+//#region src/shared/svnExplorer.ts
+const ICON_KIND = {
+	normal: "clean",
+	modified: "modified",
+	replaced: "modified",
+	added: "added",
+	deleted: "deleted",
+	missing: "deleted",
+	incomplete: "conflict",
+	obstructed: "conflict",
+	conflicted: "conflict",
+	unversioned: "unversioned",
+	ignored: "ignored",
+	external: "external"
+};
+/** @public @author ddj 2026年10月09号 @param entry Local status. @returns Effective content/property status. */
+function localStatusOf(entry) {
+	if (entry.props === "conflicted") return "conflicted";
+	if (entry.status === "normal" && entry.props === "modified") return "modified";
+	return entry.status;
+}
+/** @private @author ddj 2026年10月09号 @param path Relative path. @returns Ancestors, excluding self/root. */
+function parentsOf(path) {
+	const result = [];
+	let dir = path;
+	while (dir.includes("/")) {
+		dir = dir.slice(0, dir.lastIndexOf("/"));
+		result.push(dir);
+	}
+	return result;
+}
+/** @public @author ddj 2026年10月09号 @param index Confirmed snapshot. @param path Row path. @param isDir Directory row. @returns Overlay or null; absent entries never imply clean. */
+function explorerMarkOf(index, path, isDir) {
+	if (!index) return null;
+	let entry = index.entries.get(path);
+	if (!entry) for (const parent of parentsOf(path)) {
+		const ancestor = index.entries.get(parent);
+		if (ancestor?.status === "ignored" || ancestor?.status === "unversioned") {
+			entry = ancestor;
+			break;
+		}
+	}
+	let status = entry ? localStatusOf(entry) : null;
+	const agg = isDir ? index.folders.get(path) : null;
+	if (agg && (!status || (SVN_FOLDER_STATUS_RANK[agg.status] ?? 0) > (SVN_FOLDER_STATUS_RANK[status] ?? 0))) status = agg.status;
+	if (!status) return null;
+	if (status === "normal" && (entry?.versioned !== true || isDir && index.truncated)) return null;
+	const title = status === "normal" ? "本地正常（已受控，未修改；不表示仓库无更新）" : SVN_STATUS_LABEL[status];
+	return {
+		kind: ICON_KIND[status],
+		title: title + (agg ? "；子项 " + agg.count + " 处变更" : "")
+	};
+}
+/** @public @author ddj 2026年10月09号 @param path WC-relative path. @param prefix Session path under WC. @returns Session-relative path or null outside session. */
+function explorerPathOf(path, prefix) {
+	if (!prefix || prefix === ".") return path;
+	return path.startsWith(prefix + "/") ? path.slice(prefix.length + 1) : null;
+}
+//#endregion
+//#region src/svnExplorer.ts
+/** Covers measured 125415-entry WC while bounding retained RPC objects, not XML bytes. */
+const EXPLORER_CAP = 25e4;
+/** @public @author ddj 2026年10月10号 @param raw Untrusted RPC request. @returns Whether bounded relative row/invalidation paths and tokens are legal. */
+function viewArgsValid(raw) {
+	if (!raw || typeof raw !== "object") return false;
+	const args = raw;
+	if (!Array.isArray(args.rows) || args.rows.length > 1e3) return false;
+	if (args.reason && ![
+		"read",
+		"paths",
+		"full",
+		"calibrate"
+	].includes(args.reason)) return false;
+	if (args.paths && (!Array.isArray(args.paths) || args.paths.length > 256 || !args.paths.every(viewPathValid))) return false;
+	if (!args.rows.every((row) => row && typeof row.isDir === "boolean" && viewPathValid(row.path))) return false;
+	if (args.rows.reduce((bytes, row) => bytes + Buffer.byteLength(JSON.stringify(row.path)) + 80, 0) > 245760) return false;
+	if ([args.clientId, args.eventId].some((id) => id !== void 0 && (typeof id !== "string" || !id || id.length > 128))) return false;
+	if (args.reason && args.reason !== "read" && (!args.clientId || !args.eventId)) return false;
+	return [args.revision, args.generation].every((n) => n === void 0 || Number.isSafeInteger(n) && n >= 0);
+}
+/** @private @author ddj 2026年10月10号 @param path Untrusted relative path. @returns No absolute/traversal/control characters; max row size bounds JSON. */
+function viewPathValid(path) {
+	if (typeof path !== "string" || path.length > 1024 || /[\x00-\x1f]/.test(path)) return false;
+	const normalized = path.replace(/\\/g, "/");
+	return !normalized.startsWith("/") && !/^[A-Za-z]:/.test(normalized) && !normalized.split("/").includes("..");
+}
+/** @public @author ddj 2026年10月10号 @param queue Scope-owned index. @param scopeId Canonical scope. @param prefix WC prefix. @param args Rows and consistency token. @returns Compact rows; page mismatch returns no mixed-version data. */
+function explorerViewOf(queue, scopeId, prefix, args) {
+	const state = queue.state();
+	const mismatch = args.revision !== void 0 && args.revision !== state.revision || args.generation !== void 0 && args.generation !== state.generation;
+	const rows = mismatch ? [] : args.rows.map((row) => {
+		const { mark, count } = queue.data.mark(row.path, row.isDir);
+		return {
+			path: row.path,
+			kind: mark?.kind ?? null,
+			count,
+			stale: queue.stale(row.path, row.isDir)
+		};
+	});
+	return {
+		scopeId,
+		prefix,
+		...state,
+		mismatch,
+		rows
+	};
+}
+/** @public @author ddj 2026年10月09号 @param xml Collected CLI output. @returns True only for a complete status document. */
+function statusXmlValid(xml) {
+	return /^\s*(?:<\?xml[^>]*>\s*)?<status(?:\s[^>]*)?>/.test(xml) && /<\/status>\s*$/.test(xml);
+}
+/** @public @author ddj 2026年10月09号 @param entries WC-relative statuses. @param prefix Session prefix. @returns Session-relative subset. */
+function scopeEntriesOf(entries, prefix) {
+	const scoped = [];
+	for (const entry of entries) {
+		const path = explorerPathOf(entry.path, prefix);
+		if (path !== null) scoped.push({
+			...entry,
+			path
+		});
+	}
+	return scoped;
+}
+//#endregion
+//#region src/svnExplorerCache.ts
+const QUIET_MS = 300;
+const MAX_WAIT_MS = 1e3;
+const EVENT_CAP$1 = 512;
+/** @public @author ddj 2026年10月10号 @param path Validated relative path. @param windows Case-insensitive platform. @returns Canonical lookup key, preserving row spelling separately. */
+function explorerKey(path, windows = process.platform === "win32") {
+	const normalized = path.replace(/\\/g, "/").replace(/^\.\//, "").replace(/\/+$/, "");
+	return windows ? normalized.toLowerCase() : normalized;
+}
+/** @private @author ddj 2026年10月10号 @param path Canonical descendant. @param root Canonical subtree. @returns Segment-bound membership including root. */
+function within(path, root) {
+	return !root || path === root || path.startsWith(root + "/");
+}
+/** @private @author ddj 2026年10月10号 @param path Canonical entry. @returns Ancestors excluding virtual scope root. */
+function ancestors(path) {
+	const parents = [];
+	let parent = path;
+	while (parent.includes("/")) {
+		parent = parent.slice(0, parent.lastIndexOf("/"));
+		parents.push(parent);
+	}
+	return parents;
+}
+/** @public @author ddj 2026年10月10号 @param paths Changed paths. @param windows Platform matching. @returns Minimal parent subtree set; empty root means full scan. */
+function scanRootsOf(paths, windows = process.platform === "win32") {
+	const roots = [];
+	for (const raw of paths) {
+		const path = explorerKey(raw, windows);
+		const parent = path.includes("/") ? path.slice(0, path.lastIndexOf("/")) : "";
+		if (roots.some((root) => within(parent, root))) continue;
+		for (let i = roots.length - 1; i >= 0; i--) if (within(roots[i], parent)) roots.splice(i, 1);
+		roots.push(parent);
+	}
+	return roots;
+}
+/** @public @author ddj 2026年10月10号 Retains authoritative entries and decrementable ancestor counts; no client-wide payload. */
+var ExplorerIndex = class {
+	windows;
+	index = {
+		entries: /* @__PURE__ */ new Map(),
+		folders: /* @__PURE__ */ new Map(),
+		truncated: false
+	};
+	counts = /* @__PURE__ */ new Map();
+	children = /* @__PURE__ */ new Map();
+	/** @public @author ddj 2026年10月10号 @param windows Case-insensitive lookup mode. */
+	constructor(windows = process.platform === "win32") {
+		this.windows = windows;
+	}
+	/** @private @author ddj 2026年10月10号 @param entry Entry contribution. @param delta Add or remove. Updates strongest status after downgrade. */
+	contribute(entry, delta) {
+		const status = localStatusOf(entry);
+		if (status === "normal" || status === "ignored" || status === "external") return;
+		for (const parent of ancestors(entry.path)) {
+			const counts = this.counts.get(parent) ?? /* @__PURE__ */ new Map();
+			const next = (counts.get(status) ?? 0) + delta;
+			if (next > 0) counts.set(status, next);
+			else counts.delete(status);
+			if (!counts.size) {
+				this.counts.delete(parent);
+				this.index.folders.delete(parent);
+				continue;
+			}
+			this.counts.set(parent, counts);
+			let strongest = "normal";
+			let count = 0;
+			for (const [item, n] of counts) {
+				count += n;
+				if ((SVN_FOLDER_STATUS_RANK[item] ?? 0) > (SVN_FOLDER_STATUS_RANK[strongest] ?? 0)) strongest = item;
+			}
+			this.index.folders.set(parent, {
+				status: strongest,
+				count
+			});
+		}
+	}
+	/** @private @author ddj 2026年10月10号 @param path Canonical entry. Build direct child membership, including implicit ancestors. */
+	link(path) {
+		let child = path;
+		while (child) {
+			const parent = child.includes("/") ? child.slice(0, child.lastIndexOf("/")) : "";
+			const siblings = this.children.get(parent) ?? /* @__PURE__ */ new Set();
+			siblings.add(child);
+			this.children.set(parent, siblings);
+			child = parent;
+		}
+	}
+	/** @private @author ddj 2026年10月10号 @param path Removed entry. Prune only empty implicit ancestors; retained siblings remain indexed. */
+	unlink(path) {
+		let child = path;
+		while (child && !this.index.entries.has(child) && !this.children.get(child)?.size) {
+			const parent = child.includes("/") ? child.slice(0, child.lastIndexOf("/")) : "";
+			this.children.delete(child);
+			const siblings = this.children.get(parent);
+			siblings?.delete(child);
+			if (!siblings?.size) this.children.delete(parent);
+			child = parent;
+		}
+	}
+	/** @private @author ddj 2026年10月10号 @param roots Subtree membership roots. @returns Retained affected entries only; no whole-index iteration for local replacement. */
+	members(roots) {
+		const result = /* @__PURE__ */ new Set(), pending = [...roots], visited = /* @__PURE__ */ new Set();
+		while (pending.length) {
+			const path = pending.pop();
+			if (visited.has(path)) continue;
+			visited.add(path);
+			if (this.index.entries.has(path)) result.add(path);
+			for (const child of this.children.get(path) ?? []) pending.push(child);
+		}
+		return [...result];
+	}
+	/** @public @author ddj 2026年10月10号 @param roots Replaced session-relative subtrees. @param result Complete or bounded scan. @throws Capacity mismatch on partial replacement; caller must full-calibrate. */
+	replace(roots, result) {
+		const keys = roots.map((root) => explorerKey(root, this.windows));
+		const full = keys.includes("");
+		const incoming = /* @__PURE__ */ new Map();
+		for (const entry of result.entries) {
+			const path = explorerKey(entry.path, this.windows);
+			if (keys.some((root) => within(path, root))) incoming.set(path, {
+				...entry,
+				path
+			});
+		}
+		const removed = full ? [] : this.members(keys);
+		if (!full && (result.truncated || this.index.entries.size - removed.length + incoming.size > 25e4)) throw new Error("局部 SVN 状态不完整，需要全量校准");
+		if (full) this.clear();
+		else for (const path of removed) {
+			this.contribute(this.index.entries.get(path), -1);
+			this.index.entries.delete(path);
+			this.unlink(path);
+		}
+		for (const [path, entry] of incoming) {
+			this.index.entries.set(path, entry);
+			this.link(path);
+			this.contribute(entry, 1);
+		}
+		if (full) this.index.truncated = result.truncated;
+	}
+	/** @public @author ddj 2026年10月10号 Release retained entries and aggregation counters. */
+	clear() {
+		this.index.entries.clear();
+		this.index.folders.clear();
+		this.counts.clear();
+		this.children.clear();
+	}
+	/** @public @author ddj 2026年10月10号 @param path Display row spelling. @param isDir Directory row. @returns Exact/ancestor mark and dirty descendant count. */
+	mark(path, isDir) {
+		const key = explorerKey(path, this.windows);
+		return {
+			mark: explorerMarkOf(this.index, key, isDir),
+			count: isDir ? this.index.folders.get(key)?.count ?? 0 : 0
+		};
+	}
+};
+/** @public @author ddj 2026年10月10号 Two retained scope indexes; active work is never evicted to satisfy a new reader. */
+var ExplorerScopes = class {
+	scopes = /* @__PURE__ */ new Map();
+	/** @public @author ddj 2026年10月10号 @param key Canonical root/session key. @param scan Scanner bound to this scope. @param now Clock. @param windows Matching. @returns Shared owner; refuses new scopes if all retained owners are busy. */
+	get(key, scan, now = Date.now, windows = process.platform === "win32") {
+		const existing = this.scopes.get(key);
+		if (existing) {
+			this.scopes.delete(key);
+			this.scopes.set(key, existing);
+			return existing;
+		}
+		if (this.scopes.size >= 2) {
+			const idle = [...this.scopes].find(([, queue]) => queue.idle());
+			if (!idle) throw new Error("SVN 状态扫描繁忙，请稍后重试");
+			idle[1].dispose();
+			this.scopes.delete(idle[0]);
+		}
+		const queue = new ExplorerQueue(scan, now, windows);
+		this.scopes.set(key, queue);
+		return queue;
+	}
+	/** @public @author ddj 2026年10月10号 Release all scoped work and retained state. */
+	dispose() {
+		for (const queue of this.scopes.values()) queue.dispose();
+		this.scopes.clear();
+	}
+};
+/** @public @author ddj 2026年10月10号 Coalesces generations without swallowing changes arriving during a scan. */
+var ExplorerQueue = class {
+	scan;
+	now;
+	windows;
+	data;
+	generation = 0;
+	observed = 0;
+	revision = 0;
+	confirmedAt = 0;
+	scanMs = 0;
+	error = "";
+	fullDirty = false;
+	dirty = /* @__PURE__ */ new Set();
+	active = null;
+	timer = null;
+	pendingSince = null;
+	lastEventAt = 0;
+	controller = null;
+	flight = null;
+	stopped = false;
+	events = /* @__PURE__ */ new Set();
+	staleRoots = null;
+	/** @public @author ddj 2026年10月10号 @param scan Managed scoped scan. @param now Injectable clock. @param windows Canonical path matching. */
+	constructor(scan, now = Date.now, windows = process.platform === "win32") {
+		this.scan = scan;
+		this.now = now;
+		this.windows = windows;
+		this.data = new ExplorerIndex(windows);
+	}
+	/** @public @author ddj 2026年10月10号 @param change Path/full invalidation and idempotency token. @returns Whether a new change was registered. */
+	invalidate(change = { full: true }) {
+		if (this.stopped || change.event && this.events.has(change.event)) return false;
+		if (change.event) {
+			this.events.add(change.event);
+			if (this.events.size > EVENT_CAP$1) this.events.delete(this.events.values().next().value);
+		}
+		this.generation++;
+		this.staleRoots = null;
+		this.lastEventAt = this.now();
+		if (this.pendingSince === null) this.pendingSince = this.lastEventAt;
+		if (change.full || !change.paths?.length || !this.confirmedAt || this.data.index.truncated) this.fullDirty = true;
+		for (const path of change.paths ?? []) this.dirty.add(explorerKey(path, this.windows));
+		if (this.dirty.size > 256 || scanRootsOf([...this.dirty], this.windows).length > 32) this.fullDirty = true;
+		if (this.fullDirty) this.dirty.clear();
+		this.schedule();
+		return true;
+	}
+	/** @private @author ddj 2026年10月10号 Tail debounce has a hard max wait; active scans retain one merged follow-up batch. */
+	schedule() {
+		if (this.stopped || this.active || this.pendingSince === null) return;
+		if (this.timer) clearTimeout(this.timer);
+		const delay = Math.max(0, Math.min(this.lastEventAt + QUIET_MS, this.pendingSince + MAX_WAIT_MS) - this.now());
+		this.timer = setTimeout(() => {
+			this.timer = null;
+			this.launch();
+		}, delay);
+	}
+	/** @private @author ddj 2026年10月10号 Starts one scan, snapshots generation and dirtiness before yielding. */
+	launch() {
+		if (this.stopped || this.active || this.pendingSince === null) return;
+		const roots = this.fullDirty ? [""] : scanRootsOf([...this.dirty], this.windows);
+		const generation = this.generation;
+		this.fullDirty = false;
+		this.dirty.clear();
+		this.pendingSince = null;
+		this.active = roots;
+		this.staleRoots = null;
+		this.controller = new AbortController();
+		this.flight = this.run(roots, generation, this.controller.signal);
+	}
+	/** @private @author ddj 2026年10月10号 @param roots Scan subtrees. @param generation Captured invalidation generation. @param signal Owner disposal. Applies known evidence but never confirms newer dirty paths. */
+	async run(roots, generation, signal) {
+		const started = this.now();
+		try {
+			const result = await this.scan(roots, signal);
+			if (this.stopped) return;
+			this.data.replace(result.roots ?? roots, result);
+			this.observed = generation;
+			this.revision++;
+			this.error = "";
+			if (generation === this.generation && !result.truncated) this.confirmedAt = this.now();
+		} catch (failure) {
+			if (this.stopped) return;
+			this.error = String(failure);
+			this.fullDirty = true;
+		} finally {
+			this.scanMs = Math.max(0, this.now() - started);
+			this.active = null;
+			this.staleRoots = null;
+			this.controller = null;
+			this.flight = null;
+			this.schedule();
+		}
+	}
+	/** @public @author ddj 2026年10月10号 @param path Display row. @param isDir Directory membership. @returns Whether evidence intersects active/queued changes or incomplete state. */
+	stale(path, isDir) {
+		if (!this.confirmedAt || this.fullDirty || this.data.index.truncated) return true;
+		const key = explorerKey(path, this.windows);
+		return (this.staleRoots ??= [...this.active ?? [], ...scanRootsOf([...this.dirty], this.windows)]).some((root) => within(key, root) || isDir && within(root, key));
+	}
+	/** @public @author ddj 2026年10月10号 @returns Lightweight scope metadata; freshness is independent of cache TTL. */
+	state() {
+		return {
+			revision: this.revision,
+			generation: this.generation,
+			observedGeneration: this.observed,
+			confirmedAt: this.confirmedAt,
+			complete: this.confirmedAt > 0 && !this.data.index.truncated && !this.fullDirty && !this.active && !this.dirty.size,
+			refreshing: this.active !== null || this.timer !== null,
+			scanMs: this.scanMs,
+			error: this.error
+		};
+	}
+	/** @public @author ddj 2026年10月10号 @returns First-load confirmation; warm callers project immediately with stale flags. */
+	async initial() {
+		if (this.stopped) throw new Error("SVN 状态调度已释放");
+		if (this.confirmedAt || this.revision || this.error) return;
+		if (this.pendingSince === null && !this.active) this.invalidate({ full: true });
+		if (this.timer) {
+			clearTimeout(this.timer);
+			this.timer = null;
+		}
+		this.launch();
+		await this.flight;
+	}
+	/** @public @author ddj 2026年10月10号 @returns Whether an owner may evict this scope without killing shared work. */
+	idle() {
+		return !this.active && !this.timer;
+	}
+	/** @public @author ddj 2026年10月10号 Abort owned scans and timers; late completions cannot restore state. */
+	dispose() {
+		this.stopped = true;
+		if (this.timer) clearTimeout(this.timer);
+		this.timer = null;
+		this.controller?.abort(/* @__PURE__ */ new Error("SVN 状态调度已释放"));
+		this.dirty.clear();
+		this.events.clear();
+		this.data.clear();
+	}
+};
+//#endregion
+//#region src/svnStatusStream.ts
+/** Bounded SVN XML framing; retain statuses, never the entire verbose document. @author ddj 2026年10月09号 */
+/** @public @author ddj 2026年10月09号 @param handle Managed pipe process. @param parse Status semantics. @param cap Entry bound. @param timeout Deadline. @returns EOF-validated statuses. @throws CLI, timeout or framing failure; never retries with inherit. */
+async function readStatusPipe(handle, parse, cap, timeout, signal) {
+	const reader = new SvnStatusReader(parse, cap);
+	/** @private @author ddj 2026年10月09号 Consume raw chunks through stream EOF, not just direct process exit. */
+	async function consume() {
+		if (!handle.stdout) throw new Error("SVN 状态管道不可用，未确认正常状态");
+		for await (const chunk of handle.stdout) reader.push(chunk);
+	}
+	let timer;
+	const expired = new Promise((_, reject) => {
+		timer = setTimeout(() => reject(/* @__PURE__ */ new Error("读取 SVN 图标状态超时")), timeout);
+		timer.unref?.();
+	});
+	let abort;
+	const cancelled = new Promise((_, reject) => {
+		abort = () => reject(signal?.reason ?? /* @__PURE__ */ new Error("SVN 状态扫描已取消"));
+		if (signal?.aborted) abort();
+		else signal?.addEventListener("abort", abort, { once: true });
+	});
+	try {
+		const [outcome] = await Promise.race([
+			Promise.all([handle.done, consume()]),
+			expired,
+			cancelled
+		]);
+		if ((outcome.exitCode ?? outcome.code) !== 0) throw new Error(handle.collected?.stderr?.readFrom(0).text || "SVN 状态命令失败");
+		return reader.finish();
+	} catch (error) {
+		try {
+			await handle.terminate?.();
+		} catch {}
+		throw error;
+	} finally {
+		if (timer) clearTimeout(timer);
+		if (abort) signal?.removeEventListener("abort", abort);
+	}
+}
+const TAG_CAP = 65536;
+const STREAM_CAP = 536870912;
+/** @public @author ddj 2026年10月09号 Validates framing through EOF, including entries beyond the retained cap. */
+var SvnStatusReader = class {
+	parse;
+	cap;
+	decoder = new StringDecoder("utf8");
+	buffer = "";
+	bytes = 0;
+	stack = [];
+	opened = false;
+	closed = false;
+	entry = "";
+	changelist = "";
+	entries = [];
+	truncated = false;
+	/** @public @author ddj 2026年10月09号 @param parse Existing status semantics. @param cap Retained entry bound. */
+	constructor(parse, cap) {
+		this.parse = parse;
+		this.cap = cap;
+	}
+	/** @public @author ddj 2026年10月09号 @param chunk Raw pipe chunk. @throws Byte/tag limits or invalid framing. */
+	push(chunk) {
+		this.bytes += Buffer.byteLength(chunk);
+		if (this.bytes > STREAM_CAP) throw new Error("SVN 状态流超过 512 MiB 安全上限");
+		this.feed(typeof chunk === "string" ? chunk : this.decoder.write(chunk));
+	}
+	/** @private @author ddj 2026年10月09号 @param text Decoded chunk. Process each complete tag once; partial tags stay bounded. */
+	feed(text) {
+		this.buffer += text;
+		let cursor = 0;
+		while (cursor < this.buffer.length) {
+			const start = this.buffer.indexOf("<", cursor);
+			const end = start < 0 ? -1 : this.buffer.indexOf(">", start);
+			const tail = start < 0 ? this.buffer.length : start;
+			if (!this.stack.length && this.buffer.slice(cursor, tail).trim()) this.invalid();
+			if (end < 0) {
+				cursor = tail;
+				break;
+			}
+			if (end - start > TAG_CAP) this.invalid();
+			this.tag(this.buffer.slice(start, end + 1));
+			cursor = end + 1;
+		}
+		this.buffer = this.buffer.slice(cursor);
+		if (this.buffer.length > TAG_CAP) this.invalid();
+	}
+	/** @private @author ddj 2026年10月09号 @param token Complete XML tag. Validate nesting and capture only entry/wc-status attributes. */
+	tag(token) {
+		if (token.startsWith("<?xml ") && !this.opened && !this.stack.length) return;
+		const match = /^<(\/?)([\w-]+)\b([^>]*?)(\/?)>$/.exec(token);
+		if (!match || this.closed) this.invalid();
+		const [, closing, name, attrs, self] = match;
+		if (closing) {
+			if (this.stack.pop() !== name) this.invalid();
+			if (name === "entry") this.saveEntry();
+			if (name === "changelist") this.changelist = "";
+			if (name === "status") this.closed = true;
+			return;
+		}
+		if (!this.stack.length) {
+			if (name !== "status" || this.opened || self) this.invalid();
+			this.opened = true;
+		}
+		if (name === "changelist") this.changelist = attrOf(attrs, "name");
+		if (name === "entry") this.entry = token.replace(/\/>$/, ">");
+		if (name === "wc-status" && this.entry) this.entry += "<wc-status" + attrs + "/>";
+		if (!self) this.stack.push(name);
+		else if (name === "entry") this.saveEntry();
+	}
+	/** @private @author ddj 2026年10月09号 Preserve existing property/tree-conflict/path semantics and bounded statuses. */
+	saveEntry() {
+		const result = this.parse(this.entry + "</entry>", 1);
+		this.entry = "";
+		for (const entry of result.entries) {
+			if (this.entries.length >= this.cap) {
+				this.truncated = true;
+				continue;
+			}
+			this.entries.push(this.changelist ? {
+				...entry,
+				changelist: this.changelist
+			} : entry);
+		}
+	}
+	/** @private @author ddj 2026年10月09号 @throws Invalid/missing/truncated XML; never produces a clean snapshot. */
+	invalid() {
+		throw new Error("SVN 状态输出为空或不完整，未确认正常状态");
+	}
+	/** @public @author ddj 2026年10月09号 @returns Confirmed snapshot only after complete stream EOF. @throws Invalid framing. */
+	finish() {
+		this.feed(this.decoder.end());
+		if (!this.opened || !this.closed || this.stack.length || this.buffer.trim()) this.invalid();
+		return {
+			entries: this.entries,
+			truncated: this.truncated
+		};
+	}
+};
 /** CLI 探测超时。 */
 const CLI_GRACE_MS = 6e3;
 /** svn update 超时（大工作副本留足预算）。 */
@@ -18603,7 +19373,7 @@ function parseStatusXml(xml, cap = CHANGES_CAP) {
 		}
 		if (!pendingPath) continue;
 		const item = attrOf(hit.attrs, "item") || "modified";
-		const status = KNOWN_ITEM_STATUS.has(item) ? item : "modified";
+		const status = attrOf(hit.attrs, "tree-conflicted") === "true" ? "conflicted" : KNOWN_ITEM_STATUS.has(item) ? item : "modified";
 		const path = changePathOf(pendingPath);
 		if (!path) {
 			pendingPath = null;
@@ -18734,7 +19504,8 @@ function parseRemoteStatusXml(xml, wcRoot, cap = CHANGES_CAP) {
 		const repos = /<repos-status\b([^>]*?)\/?>/.exec(match[2]);
 		if (!repos) continue;
 		const item = attrOf(repos[1], "item");
-		if (!item || item === "none") continue;
+		const props = attrOf(repos[1], "props");
+		if ((!item || item === "none" || item === "normal") && props !== "modified") continue;
 		const rawPath = attrOf(match[1], "path");
 		const rel = relPathOfAbs(rawPath, wcRoot) ?? changePathOf(rawPath);
 		if (!rel) continue;
@@ -18744,7 +19515,7 @@ function parseRemoteStatusXml(xml, wcRoot, cap = CHANGES_CAP) {
 		}
 		outdated.push({
 			path: rel,
-			item
+			item: item && item !== "none" && item !== "normal" ? item : "modified"
 		});
 	}
 	return {
@@ -18839,6 +19610,9 @@ function createSvnRpc(deps) {
 	const updateRootCache = /* @__PURE__ */ new Map();
 	/** 变更清单缓存（键 = 工作副本根；TTL 短，仅合并同一轮 UI 的多处拉取）。 */
 	const changesCache = /* @__PURE__ */ new Map();
+	/** Explorer snapshots are bounded and short-lived; concurrent scans share one subprocess. */
+	const explorerCache = /* @__PURE__ */ new Map();
+	const explorerFlight = /* @__PURE__ */ new Map();
 	/** 混合通道方案收件箱（key = 工作副本根；覆盖式入箱 + TTL，见 svn.aiPlanSubmit/Pending）。 */
 	const planInbox = /* @__PURE__ */ new Map();
 	/** 工作副本根 relative-url 缓存（日志路径映射用；探测失败也缓存空串避免反复 spawn）。 */
@@ -19382,8 +20156,151 @@ function createSvnRpc(deps) {
 			output: [...notes, ...failures].join("\n")
 		};
 	};
+	/** @private @author ddj 2026年10月10号 @param root Native WC root. @param prefix Session prefix. @param paths Subtree targets. @returns Existing parent roots, merged with segment boundaries; missing session forces full. */
+	const scopeRootsOf = async (root, prefix, paths) => {
+		const roots = [];
+		for (const raw of paths) {
+			let path = raw;
+			while (path) {
+				try {
+					if ((await stat(join(root, prefix, path))).isDirectory()) break;
+				} catch {}
+				path = path.includes("/") ? path.slice(0, path.lastIndexOf("/")) : "";
+			}
+			if (roots.some((parent) => !parent || path === parent || path.startsWith(parent + "/"))) continue;
+			for (let i = roots.length - 1; i >= 0; i--) if (!path || roots[i].startsWith(path + "/")) roots.splice(i, 1);
+			roots.push(path);
+		}
+		return roots;
+	};
+	/** @private @author ddj 2026年10月10号 @param cwd Session directory. @param root WC root. @param roots Bounded subtrees. @param signal Owner disposal. @returns Confirmed local statuses; malformed/pipe-empty output rejects. */
+	const scanExplorer = async (cwd, root, roots = [""], signal) => {
+		const target = svnPathOf(cwd, root, "");
+		if (target === null) throw new Error("工作区不在 SVN 根目录内");
+		const spawn = subprocess();
+		if (!spawn) throw new Error("缺少 subprocess 服务");
+		const fs = ctx.get("fs");
+		const realRoot = fs?.resolve && fs?.processPath ? fs.processPath(await fs.resolve(root, {})) : root;
+		const validRoots = await scopeRootsOf(realRoot, target, roots);
+		const targets = validRoots.map((path) => {
+			const rel = [target === "." ? "" : target, path].filter(Boolean).join("/") || ".";
+			return rel.includes("@") ? rel + "@" : rel;
+		});
+		const parsed = await readStatusPipe(spawn({
+			argv: [
+				settings.svn().svnPath.trim() || "svn",
+				"--non-interactive",
+				"status",
+				"--xml",
+				"--verbose",
+				"--no-ignore",
+				"--",
+				...targets
+			],
+			cwd: realRoot,
+			stdio: {
+				stdout: "pipe",
+				stderr: { maxBytes: OUTPUT_CAP },
+				stdin: "ignore"
+			},
+			graceMs: STATUS_GRACE_MS
+		}), parseStatusXml, EXPLORER_CAP, STATUS_GRACE_MS, signal);
+		return {
+			entries: scopeEntriesOf(parsed.entries, target),
+			truncated: parsed.truncated,
+			roots: validRoots
+		};
+	};
+	/** @private @author ddj 2026年10月09号 @param cwd Session directory. @param root WC root. @param force Bypass TTL. @returns Shared bounded scan; old cache entries are evicted. */
+	const explorerOf = async (cwd, root, force) => {
+		const pending = explorerFlight.get(cwd);
+		if (pending) return pending;
+		const hit = explorerCache.get(cwd);
+		if (!force && hit && now() - hit.at < 5e3) return hit;
+		const work = scanExplorer(cwd, root);
+		explorerFlight.set(cwd, work);
+		try {
+			const result = await work;
+			explorerCache.delete(cwd);
+			if (explorerCache.size >= 2) explorerCache.delete(explorerCache.keys().next().value);
+			explorerCache.set(cwd, {
+				at: now(),
+				...result
+			});
+			return result;
+		} finally {
+			explorerFlight.delete(cwd);
+		}
+	};
+	const explorerScopes = new ExplorerScopes();
+	/** @private @author ddj 2026年10月10号 @param args Validated view projection. @returns Scope-isolated compact evidence; no repository contact. */
+	const viewExplorer = async (args) => {
+		if (!viewArgsValid(args)) return {
+			ok: false,
+			error: "SVN 图标请求无效或超出行数/路径上限"
+		};
+		const sc = await requireSvnSession(ctx, args.sessionId);
+		if ("err" in sc) return {
+			ok: false,
+			error: sc.err
+		};
+		const status = await statusOf(sc.cwd);
+		if (!status.managed || !status.wcRoot || !status.svnCli) return {
+			ok: false,
+			error: "SVN 工作副本或命令不可用"
+		};
+		try {
+			const root = status.wcRoot;
+			const scopeId = JSON.stringify([explorerKey(root), explorerKey(sc.cwd)]);
+			/** @private @author ddj 2026年10月10号 @param roots Scoped subtrees. @param signal Owner disposal. @returns Streamed scan. */
+			const scan = (roots, signal) => scanExplorer(sc.cwd, root, roots, signal);
+			const queue = explorerScopes.get(scopeId, scan, now);
+			const reason = args.reason ?? "read";
+			if (reason !== "read" && (reason !== "calibrate" || now() - queue.state().confirmedAt > 5e3)) queue.invalidate({
+				full: reason !== "paths",
+				paths: args.paths,
+				event: JSON.stringify([args.clientId, args.eventId])
+			});
+			await queue.initial();
+			return {
+				ok: true,
+				...explorerViewOf(queue, scopeId, svnPathOf(sc.cwd, root, "") ?? ".", args)
+			};
+		} catch (error) {
+			return {
+				ok: false,
+				error: "读取 SVN 图标状态失败：" + String(error)
+			};
+		}
+	};
 	return {
 		handlers: {
+			"svn.explorerView": viewExplorer,
+			/** @public @author ddj 2026年10月09号 @param args Session and refresh flag. @returns Read-only explorer snapshot; no repository contact. */
+			"svn.explorerStatus": async (args) => {
+				const sc = await requireSvnSession(ctx, args.sessionId);
+				if ("err" in sc) return {
+					ok: false,
+					error: sc.err
+				};
+				const status = await statusOf(sc.cwd);
+				if (!status.managed || !status.wcRoot || !status.svnCli) return {
+					ok: false,
+					error: "SVN 工作副本或命令不可用"
+				};
+				try {
+					return {
+						ok: true,
+						...await explorerOf(sc.cwd, status.wcRoot, args.force === true),
+						prefix: svnPathOf(sc.cwd, status.wcRoot, "") ?? "."
+					};
+				} catch (error) {
+					return {
+						ok: false,
+						error: "读取 SVN 图标状态失败：" + String(error)
+					};
+				}
+			},
 			"svn.status": async (args) => {
 				const sc = await requireSvnSession(ctx, args.sessionId);
 				if ("err" in sc) return {
@@ -19841,17 +20758,27 @@ function createSvnRpc(deps) {
 					error: "svn 命令不可用（可在设置页配置 svn 路径）"
 				};
 				try {
+					const target = svnPathOf(sc.cwd, status.wcRoot, rel);
+					if (target === null) return {
+						ok: false,
+						error: "路径不在 SVN 工作副本内"
+					};
 					const argv = [
 						"status",
 						"-u",
-						"--xml"
+						"--xml",
+						"--",
+						target
 					];
-					if (rel) argv.push("--", rel);
 					const outcome = await runSvn(status.wcRoot, argv, REMOTE_GRACE_MS, SUM_OUTPUT_CAP);
 					if (outcome.code !== 0) return {
 						ok: false,
 						error: "远端检查失败：" + tailOfText([outcome.stderr, outcome.stdout].filter(Boolean).join("\n"))
 					};
+					if (!statusXmlValid(outcome.stdout)) return {
+						ok: false,
+						error: "远端状态输出为空或不完整"
+					};
 					return {
 						ok: true,
 						...parseRemoteStatusXml(outcome.stdout, status.wcRoot)
@@ -20452,6 +21379,8 @@ function createSvnRpc(deps) {
 			}
 		},
 		dispose: () => {
+			explorerScopes.dispose();
+			explorerCache.clear();
 			updateJobs.dispose();
 			updateRootCache.clear();
 		}
@@ -21682,18 +22611,47 @@ var DapSession = class {
 	earlyTermHint() {
 		return "会话在初始化完成前终止（attach/连接目标失败）" + (this.extId === "nromanov.dotrush" && this.extPath ? "；适配器日志：" + join(this.extPath, "bin", "DebuggerMono", "logs", "Error.log") : "；请查看适配器自身日志与宿主日志 [dap-adapter] 段");
 	}
-	/** findFileReq 反向应答：按完整 chunkname 排序工作区候选并缓存首命中。 */
+	/**
+	* 按当前语言过滤并排序源码候选，供反向应答与栈帧解析共用。
+	* @private
+	* @author ddj 2026年10月09号
+	* @param chunk 适配器上报的源码标识
+	* @returns 语言合法、按路径相关度排序的候选
+	*/
+	async sourceCandidates(chunk) {
+		const files = await this.deps.findFiles(this.workspacePath, chunk);
+		const exts = this.frameExts();
+		return rankSourceCandidates(chunk, exts.length ? files.filter((file) => hasSourceExtension(file, exts)) : files, this.workspacePath);
+	}
+	/**
+	* 更新源码标识及 basename 缓存；无合法候选时删除旧映射。
+	* @private
+	* @author ddj 2026年10月09号
+	* @param chunk 适配器上报的源码标识
+	* @param file 合法候选首项，空值表示未解析
+	* @description 副作用：更新当前会话源码缓存
+	*/
+	cacheSource(chunk, file) {
+		for (const key of [sourceKeyOf(chunk), sourceKeyOf(sourceBaseOf(chunk))]) {
+			if (!key) continue;
+			if (file) this.sourceFiles.set(key, file);
+			else this.sourceFiles.delete(key);
+		}
+	}
+	/**
+	* findFileReq 反向应答：只返回当前语言合法源码并缓存首命中。
+	* @private
+	* @author ddj 2026年10月09号
+	* @param body 反向请求参数
+	* @description 副作用：更新源码缓存并发送 findFileRsp
+	*/
 	async respondFindFile(body) {
 		const seq = typeof body.seq === "number" ? body.seq : -1;
 		const chunk = String(body.file ?? "");
-		const files = await this.deps.findFiles(this.workspacePath, chunk);
+		const files = await this.sourceCandidates(chunk);
 		log.debug("[dap-trace] findFileReq seq=" + seq + " chunk=" + chunk + " candidates=" + files.length + " first=" + (files[0] ?? ""));
 		this.deps.trace?.(this.workspacePath, "[DEBUG findFileReq] seq=" + seq + " chunk=" + chunk + " candidates=" + files.length + " first=" + (files[0] ?? ""));
-		const first = files[0];
-		if (first) {
-			this.sourceFiles.set(sourceKeyOf(chunk), first);
-			this.sourceFiles.set(sourceKeyOf(sourceBaseOf(chunk)), first);
-		}
+		this.cacheSource(chunk, files[0] ?? "");
 		this.send({
 			seq: this.msgSeq++,
 			type: "request",
@@ -21831,25 +22789,40 @@ var DapSession = class {
 			this.error = void 0;
 		}
 	}
-	/** 适配器上报路径 → 帧视图（file 始终保留可打开的规范路径）。 */
+	/**
+	* 适配器源码标识转帧视图；完整合法路径优先，错误语言缓存须重新解析。
+	* @private
+	* @author ddj 2026年10月09号
+	* @param item 适配器栈帧
+	* @param index 栈帧下标（EmmyLua frameId）
+	* @returns 保留原始行号、只含合法源码路径的帧视图
+	* @description 副作用：按需查找源码并更新会话缓存
+	*/
 	async frameViewOf(item, index) {
 		const raw = item;
 		const source = raw.source ?? {};
 		const sourcePath = typeof source.path === "string" ? source.path : "";
 		const sourceName = typeof source.name === "string" ? source.name : "";
+		const exts = this.frameExts();
 		const cached = this.sourceFiles.get(sourceKeyOf(sourcePath)) ?? this.sourceFiles.get(sourceKeyOf(sourceName));
-		let selected = cached || sourcePath || sourceName;
-		const needsLookup = !selected || !hasSourceExtension(selected, this.frameExts());
+		const validPath = sourcePath && !isBareChunk(sourcePath) && (exts.length ? hasSourceExtension(sourcePath, exts) : sourceBaseOf(sourcePath).includes("."));
+		const validCache = cached && (!exts.length || hasSourceExtension(cached, exts));
+		let selected = validPath ? sourcePath : validCache ? cached : sourcePath || sourceName;
+		const needsLookup = !validPath && !validCache;
+		if (cached && !validCache) {
+			this.cacheSource(sourcePath, "");
+			this.cacheSource(sourceName, "");
+		}
 		log.debug("[dap-trace] frame rawPath=" + sourcePath + " name=" + sourceName + " cached=" + (cached ?? "") + " needsLookup=" + needsLookup + " selected=" + selected);
 		this.deps.trace?.(this.workspacePath, "[DEBUG frame] rawPath=" + sourcePath + " name=" + sourceName + " cached=" + (cached ?? "") + " needsLookup=" + needsLookup + " selected=" + selected);
-		if (!cached && needsLookup) {
-			const candidates = await this.deps.findFiles(this.workspacePath, sourceName || sourcePath);
+		if (needsLookup) {
+			const candidates = await this.sourceCandidates(sourceName || sourcePath);
 			log.debug("[dap-trace] frameLookup source=" + (sourceName || sourcePath) + " candidates=" + candidates.length + " first=" + (candidates[0] ?? ""));
 			this.deps.trace?.(this.workspacePath, "[DEBUG frameLookup] source=" + (sourceName || sourcePath) + " candidates=" + candidates.length + " first=" + (candidates[0] ?? ""));
 			if (candidates[0]) {
 				selected = candidates[0];
-				this.sourceFiles.set(sourceKeyOf(sourceName || sourcePath), candidates[0]);
-			} else if (isBareChunk(sourceName || sourcePath)) selected = "";
+				this.cacheSource(sourceName || sourcePath, candidates[0]);
+			} else if (exts.length || isBareChunk(sourceName || sourcePath)) selected = "";
 		}
 		const finalFile = selected ? sourcePathOf(selected, this.workspacePath) : "";
 		log.debug("[dap-trace] frameFinal name=" + sourceName + " file=" + finalFile + " line=" + String(raw.line ?? 0));
@@ -22211,6 +23184,16 @@ async function apply(ctx, config) {
 	await installPlanTool(ctx, submitPlan);
 	ctx.effect(mountInbox, "vscode-mode:open-inbox");
 	ctx.effect(() => shellMenuLifecycle(ctx), "vscode-mode:integration");
+	/** @author ddj 2026年10月12号 @returns Active-profile bridge disposer; failures never block boot. */
+	async function provisionBridge() {
+		try {
+			await ensureActiveBridge(ctx, await integrationBaseUrlOf(ctx));
+		} catch (error) {
+			noteWarning("外部打开桥接未就绪：" + String(error));
+		}
+		return () => {};
+	}
+	ctx.effect(provisionBridge, "vscode-mode:bridge");
 	sweepTreeCache();
 	await logCompatSummary(ctx, warnings);
 	log.info("编辑差异审查已装配（认证路由、项目 MCP 作用域、SVN 方案工具与外部打开通道）");