dsh-vscode-mode 0.4.6 → 0.5.1

package/lib/index.js

@@ -1,5 +1,5 @@
 import { createRequire } from "node:module";
-import { chmod, copyFile, cp, mkdir, readFile, readdir, rename, rm, stat, writeFile } from "node:fs/promises";
+import { chmod, copyFile, cp, mkdir, readFile, readdir, rename, rm, stat, truncate, writeFile } from "node:fs/promises";
 import { basename, dirname, extname, join, normalize, resolve, sep } from "node:path";
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, symlinkSync, watch, writeFileSync } from "node:fs";
 import { fileURLToPath, pathToFileURL } from "node:url";
@@ -149,6 +149,40 @@ const SHELL_MENU_LEAF = "DSHEditor";
 /** 深链基址默认值（DSH Web GUI 默认端口，dsh-web.cmd 实证）。 */
 const INTEGRATION_BASE_DEFAULT = "http://127.0.0.1:3080";
 //#endregion
+//#region src/shared/svn.ts
+/** TortoiseSVN 缺省安装目录（Windows；对齐 SvnHelper 的 TortoiseSVN.path 默认值）。 */
+const TORTOISE_DIR_DEFAULT = "C:\\Program Files\\TortoiseSVN";
+/** TortoiseSVN 主程序名。 */
+const TORTOISE_EXE = "TortoiseProc.exe";
+/** SvnAction → TortoiseProc /command: 参数（全部同名，显式映射防拼写漂移）。 */
+function tortoiseCommandOf(action) {
+	return {
+		update: "update",
+		commit: "commit",
+		log: "log",
+		diff: "diff",
+		blame: "blame",
+		revert: "revert"
+	}[action];
+}
+/**
+* TortoiseProc 启动 argv（纯函数）。
+* Windows CRT 引号规则：node 对含空格参数整体加引号，子进程 CommandLineToArgvW
+* 还原为单参数，TortoiseSVN 解析器取 `/path:` 后全串为路径——无 shell 注入面。
+* @author ddj 2026年09月16号
+* @param exe TortoiseProc.exe 绝对路径
+* @param action Tortoise 动作
+* @param absPath 目标绝对路径（文件/目录）
+* @returns argv 数组（无 shell 插值）
+*/
+function tortoiseLaunchArgv(exe, action, absPath) {
+	return [
+		exe,
+		"/command:" + tortoiseCommandOf(action),
+		"/path:" + absPath
+	];
+}
+//#endregion
 //#region src/shared/logger.ts
 /**
 * dsh-vscode-mode — 统一日志核心（双面共享，平台中立）。
@@ -416,6 +450,16 @@ function baseValueOf(config) {
 	const raw = config?.integrationBaseUrl;
 	return typeof raw === "string" && raw.trim() ? raw.trim() : INTEGRATION_BASE_DEFAULT;
 }
+/** 配置/设置里的 svn CLI 覆盖（空 = 从 PATH 解析 'svn'）。 */
+function svnPathValueOf(config) {
+	const raw = config?.svnPath;
+	return typeof raw === "string" ? raw.trim() : "";
+}
+/** 配置/设置里的 TortoiseSVN 目录（空 = 默认安装目录）。 */
+function tortoiseDirValueOf(config) {
+	const raw = config?.tortoisePath;
+	return typeof raw === "string" && raw.trim() ? raw.trim() : TORTOISE_DIR_DEFAULT;
+}
 /**
 * 安装设置 section（版本自适应；任一策略不可用返回 false 不抛错）。
 * @author ddj 2026年08月24号 / 2026年09月02号
@@ -440,7 +484,9 @@ async function installOpenSettingsSection(ctx, ns, entry, hooks, loader = loadSe
 		aiInline: deps.z.boolean().default(AI_CONFIG_DEFAULT.enabled),
 		aiProvider: deps.z.string().default(AI_CONFIG_DEFAULT.provider),
 		aiModel: deps.z.string().default(AI_CONFIG_DEFAULT.model),
-		aiEffort: deps.z.string().default(AI_CONFIG_DEFAULT.effort)
+		aiEffort: deps.z.string().default(AI_CONFIG_DEFAULT.effort),
+		svnPath: deps.z.string().default(""),
+		tortoisePath: deps.z.string().default(TORTOISE_DIR_DEFAULT)
 	}), entry, {
 		setSource: (source) => hooks.setSource(source),
 		onChange: hooks.onChange
@@ -483,13 +529,31 @@ function setupOpenSettings(ctx, config, onChange) {
 		const stored = (provider?.describe?.({ redactSecrets: true })?.find((item) => item.ns === FILE_OPEN_SETTINGS_NS))?.value;
 		aiCurrent = stored !== void 0 ? aiValueOf(stored) : aiCurrent;
 	};
+	/** SVN 路径当前值（settings 未就绪回退配置值）。 */
+	let svnCurrent = {
+		svnPath: svnPathValueOf(config),
+		tortoisePath: tortoiseDirValueOf(config)
+	};
+	const svnSync = (stored) => {
+		svnCurrent = {
+			svnPath: svnPathValueOf(stored),
+			tortoisePath: tortoiseDirValueOf(stored)
+		};
+	};
+	/** 读取 settings 存储值（describe 未就绪返回 undefined）。 */
+	const storedValue = () => {
+		return provider?.describe?.({ redactSecrets: true })?.find((item) => item.ns === FILE_OPEN_SETTINGS_NS)?.value;
+	};
 	installOpenSettingsSection(ctx, FILE_OPEN_SETTINGS_NS, {
 		fileOpenTool: current,
-		integrationBaseUrl: baseValueOf(config)
+		integrationBaseUrl: baseValueOf(config),
+		svnPath: svnCurrent.svnPath,
+		tortoisePath: svnCurrent.tortoisePath
 	}, {
 		setSource: (source) => {
 			notify(source().fileOpenTool);
 			aiCurrent = aiValueOf(source());
+			svnSync(source());
 			syncRevision();
 		},
 		onChange: settingsChange
@@ -497,6 +561,7 @@ function setupOpenSettings(ctx, config, onChange) {
 	ctx.inject?.(["settings"], (settingsCtx) => {
 		provider = settingsCtx.get("settings");
 		aiSync();
+		svnSync(storedValue());
 		syncRevision();
 	});
 	return {
@@ -518,6 +583,7 @@ function setupOpenSettings(ctx, config, onChange) {
 			syncRevision();
 		},
 		ai: () => aiCurrent,
+		svn: () => svnCurrent,
 		aiUpdate: async (patch, expectedRevision) => {
 			if (!provider?.update) {
 				if (patch.enabled !== void 0) aiCurrent.enabled = patch.enabled;
@@ -758,10 +824,17 @@ function inDshRange(version, range) {
 	}
 	return true;
 }
-/** 版本线标签：报告与文档展示版本归属；不可解析返回 '未知'。 */
+/**
+* 版本线标签：报告与文档展示版本归属；不可解析返回 '未知'。
+* 逐线自新到旧匹配，先命中先返回（区间无上界，故顺序即优先级）。
+* @author ddj 2026年09月02号 / 2026年09月18号
+* @param input 版本串（如 '0.1.6-alpha.2'）
+* @returns 版本线标签
+*/
 function familyLabel(input) {
 	const version = parseDshVersion(input);
 	if (!version) return "未知";
+	if (inDshRange(version, { from: "0.1.6-alpha.2" })) return "0.1.6-alpha.2 及更新（会话多实例共存 + 回合改动卡片 + Office 侧栏预览 + 侧栏浏览器）";
 	if (inDshRange(version, { from: "0.1.6-alpha.1" })) return "0.1.6-alpha 及更新（MCP SDK v2 + Web 侧边栏终端 + 文件链接默认侧栏预览）";
 	if (inDshRange(version, { from: "0.1.5-alpha.1" })) return "0.1.5-alpha 及更新（官方右侧 Sidebar 编辑区 + sidebar.panellist）";
 	if (inDshRange(version, { from: "0.1.3-alpha.1" })) return "0.1.3-alpha 及更新（对话文件链接=remote.session.openWorkspacePath）";
@@ -1699,7 +1772,7 @@ function detectGuards(ctx) {
 	}];
 }
 /** 已实测覆盖的最高 DSH 版本（适配矩阵上界，超过则提示，见 buildReport）。 */
-const TESTED_DSH_MAX = "0.1.6-alpha.1";
+const TESTED_DSH_MAX = "0.1.6-alpha.2";
 /** 版本适配机制状态行：DSH 版本探测 + 设置 section 安装策略。 */
 function versionAdapters(dshVersion) {
 	const adapters = [];
@@ -1745,7 +1818,7 @@ async function buildReport(ctx, options) {
 	if (settingsInstallStrategy() === "none") warnings.push("设置 section 安装不可用：" + settingsInstallNote());
 	const parsed = parseDshVersion(dshVersion);
 	const testedMax = parseDshVersion(TESTED_DSH_MAX);
-	if (parsed && testedMax && compareDshVersions(parsed, testedMax) > 0) warnings.push("DSH " + dshVersion + " 高于已实测版本（0.1.6-alpha.1）：设置 API 按能力探测运行，异常时请回报适配矩阵");
+	if (parsed && testedMax && compareDshVersions(parsed, testedMax) > 0) warnings.push("DSH " + dshVersion + " 高于已实测版本（0.1.6-alpha.2）：设置 API 按能力探测运行，异常时请回报适配矩阵");
 	for (const guard of guards) if (!guard.active && guard.note) warnings.push(guard.note);
 	return {
 		pluginVersion: options?.version ?? pluginVersionOf(),
@@ -6444,12 +6517,13 @@ async function revealInExplorer(ctx, absPath, isDir) {
 //#endregion
 //#region src/debugLog.ts
 /**
-* dsh-vscode-mode host — 诊断文件通道（client 上报 → 缓冲批量落盘）。
+* dsh-vscode-mode host — 诊断文件通道（client 上报 → 缓冲批量落盘）+ 日志文件管理。
 * 通道：edrv.debug RPC → 内存缓冲（满/空闲触发）→ 串行读改写
 *       `~/.dsh/dsh-vscode-mode/logs/debug.<cwdHash>.log`（512KB 上限截断保留尾部）。
 * 设计：console 不一定落盘，文件可靠；写失败静默忽略（调试日志不阻塞业务）。
-* 迁移自 src/rpc.ts（enqueueDebug/flushDebug），逻辑一字不改，仅终端回显改走统一日志器。
-* 作者 ddj 2026-09-08
+* 管理：edrv.dlog.* RPC 用的清单/尾部读取/清空三能力；file 参数一律先过
+*       isDebugLogName 白名单（纯文件名、无路径分隔），杜绝穿越出日志根。
+* 作者 ddj 2026-09-08 / 2026-09-17
 */
 /** cwd → 内存缓冲：行数组 + 累计字节数 + 待触发 flush 定时器（攒批落盘，避免每条日志全文件读改写）。 */
 const debugBuffers = /* @__PURE__ */ new Map();
@@ -6463,8 +6537,19 @@ const DEBUG_BUF_CAP = 32768;
 const DEBUG_FLUSH_IDLE_MS = 1e3;
 /** cwd → 已清理旧工作区 debug 日志标记（一次性）。 */
 const debugLegacyCleaned = /* @__PURE__ */ new Set();
-/** 诊断回显日志器（终端回显统一带 `[dsh-vscode-mode:debug]` 前缀）。 */
+/** 诊断回显日志器（终端回显统一带 `[dsh-vscode-mode:debug]` 前缀，级别跟随上报级别）。 */
 const debugLog = log.child("debug");
+/** 诊断日志文件名白名单（cwd hash 命名；请求回传的 file 参数必须整名匹配，防路径穿越）。 */
+const DEBUG_LOG_NAME = /^debug\.[0-9a-f]{16}\.log$/;
+/**
+* 文件名是否为合法诊断日志名（白名单整名匹配，杜绝路径穿越）。
+* @author ddj 2026年09月17号
+* @param name 请求回传的文件名（可为空）
+* @returns 是否合法
+*/
+function isDebugLogName(name) {
+	return typeof name === "string" && DEBUG_LOG_NAME.test(name);
+}
 /**
 * 批量落盘一条 debug 日志缓冲：读旧文件 → 追加 → 超上限截断保留尾部 → 一次写回。
 * 串行链保证同一 cwd 的读改写不交错丢行；写失败静默忽略（调试日志不阻塞业务）。
@@ -6490,20 +6575,23 @@ function flushDebug(cwd, batch) {
 	return task;
 }
 /**
-* 记录一条 client 上报的诊断日志：入队缓冲批量落盘 + 终端回显（`[dsh-vscode-mode:debug]` 前缀）。
-* @author ddj 2026年09月08号
+* 记录一条 client 上报的诊断日志：入队缓冲批量落盘 + 终端回显（级别跟随，缺省 debug）。
+* 落盘行格式 `<iso> [level] text`；级别标记在入队时补齐，flush 侧无感。
+* @author ddj 2026年09月08号 / 2026年09月17号
 * @param _ctx DSH 上下文（入参保留：诊断通道按 cwd 隔离，当前不需要 ctx，未来过滤用）
 * @param cwd 工作区（日志文件按 cwd hash 隔离）
 * @param text 单条日志文本（不含换行）
+* @param level 日志级别（缺省 debug；落盘行与终端回显均带此级别）
 */
-function debugRecord(_ctx, cwd, text) {
+function debugRecord(_ctx, cwd, text, level = "debug") {
+	const tagged = "[" + level + "] " + text;
 	const st = debugBuffers.get(cwd) ?? {
 		lines: [],
 		len: 0,
 		timer: null
 	};
-	st.lines.push(text);
-	st.len += text.length;
+	st.lines.push(tagged);
+	st.len += tagged.length;
 	const flush = () => {
 		st.timer = null;
 		const batch = st.lines;
@@ -6516,7 +6604,65 @@ function debugRecord(_ctx, cwd, text) {
 		flush();
 	} else if (!st.timer) st.timer = setTimeout(flush, DEBUG_FLUSH_IDLE_MS);
 	debugBuffers.set(cwd, st);
-	debugLog.error(text);
+	debugLog[level](text);
+}
+/**
+* 清单：日志根下全部诊断日志文件（名字/字节/mtime；非法名跳过），mtime 新的在前。
+* @author ddj 2026年09月17号
+* @param home DSH home（测试可注入；缺省按环境解析）
+* @returns 清单项数组
+*/
+async function listDebugLogs(home = dshHome()) {
+	const names = await readdir(pluginLogRoot(home)).catch(() => []);
+	const items = [];
+	for (const name of names) {
+		if (!isDebugLogName(name)) continue;
+		const info = await stat(join(pluginLogRoot(home), name)).catch(() => null);
+		if (!info?.isFile()) continue;
+		items.push({
+			name,
+			bytes: info.size,
+			mtimeMs: info.mtimeMs
+		});
+	}
+	items.sort((a, b) => b.mtimeMs - a.mtimeMs);
+	return items;
+}
+/**
+* 尾部读取一份诊断日志：保留文件尾 maxBytes 字节（缺省 256KB），truncated 标记截头。
+* 单文件本体受 DEBUG_LOG_CAP=512KB 约束，整读为字符串的成本可接受。
+* @author ddj 2026年09月17号
+* @param name 日志文件名（isDebugLogName 白名单校验，非法直接 null）
+* @param maxBytes 尾部保留字节数（缺省 256KB）
+* @param home DSH home（测试可注入）
+* @returns 读取结果；文件不存在或名字非法返回 null
+*/
+async function readDebugLog(name, maxBytes = 262144, home = dshHome()) {
+	if (!isDebugLogName(name)) return null;
+	const target = join(pluginLogRoot(home), name);
+	const info = await stat(target).catch(() => null);
+	if (!info?.isFile()) return null;
+	const text = await readFile(target, "utf8").catch(() => null);
+	if (text === null) return null;
+	const cut = Math.max(0, text.length - maxBytes);
+	return {
+		name,
+		path: target,
+		content: cut > 0 ? text.slice(cut) : text,
+		size: info.size,
+		truncated: cut > 0
+	};
+}
+/**
+* 清空一份诊断日志（truncate 到 0，保留文件本身）。
+* @author ddj 2026年09月17号
+* @param name 日志文件名（isDebugLogName 白名单校验）
+* @param home DSH home（测试可注入）
+* @returns 是否清空成功（文件不存在视为未成功，文案由调用方给）
+*/
+async function clearDebugLog(name, home = dshHome()) {
+	if (!isDebugLogName(name)) return false;
+	return await truncate(join(pluginLogRoot(home), name)).then(() => true).catch(() => false);
 }
 //#endregion
 //#region src/perf.ts
@@ -7152,10 +7298,11 @@ async function integrationBaseUrlOf(ctx) {
 	return (typeof value?.integrationBaseUrl === "string" ? value.integrationBaseUrl.trim() : "") || "http://127.0.0.1:3080";
 }
 /** 各方法 handler 表（类型由 shared/rpc 的 RpcHandlerMap 约束）。 */
-function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearcher = newContentSearcher(ctx), lspHandlers, aiHandlers, fileVersions) {
+function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearcher = newContentSearcher(ctx), lspHandlers, aiHandlers, fileVersions, svnHandlers) {
 	return {
 		...lspHandlers ?? {},
 		...aiHandlers ?? {},
+		...svnHandlers ?? {},
 		"edrv.list": async (args) => {
 			const sc = await requireSession(ctx, args.sessionId);
 			if ("err" in sc) return {
@@ -7574,9 +7721,68 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 				ok: false,
 				error: sc.err
 			};
-			debugRecord(ctx, sc.cwd, String(args.text ?? ""));
+			debugRecord(ctx, sc.cwd, String(args.text ?? ""), args.level);
 			return { ok: true };
 		},
+		"edrv.dlog.list": async (args) => {
+			const sc = await requireSession(ctx, args.sessionId);
+			if ("err" in sc) return {
+				ok: false,
+				error: sc.err
+			};
+			const files = await listDebugLogs();
+			const current = basename(debugLogFile(sc.cwd));
+			return {
+				ok: true,
+				root: pluginLogRoot(),
+				files,
+				current
+			};
+		},
+		"edrv.dlog.read": async (args) => {
+			const sc = await requireSession(ctx, args.sessionId);
+			if ("err" in sc) return {
+				ok: false,
+				error: sc.err
+			};
+			const name = isDebugLogName(args.file) ? args.file : basename(debugLogFile(sc.cwd));
+			const read = await readDebugLog(name, Math.min(Math.max(args.maxBytes ?? 262144, 1024), 524288));
+			if (!read) return {
+				ok: false,
+				error: "日志不存在：" + name + "（开启诊断日志并触发一次操作后生成）"
+			};
+			return {
+				ok: true,
+				...read
+			};
+		},
+		"edrv.dlog.clear": async (args) => {
+			const sc = await requireSession(ctx, args.sessionId);
+			if ("err" in sc) return {
+				ok: false,
+				error: sc.err
+			};
+			const name = isDebugLogName(args.file) ? args.file : basename(debugLogFile(sc.cwd));
+			if (!await clearDebugLog(name)) return {
+				ok: false,
+				error: "清空失败：日志不存在或名字非法"
+			};
+			return {
+				ok: true,
+				name
+			};
+		},
+		"edrv.dlog.reveal": async () => {
+			const revealed = await revealInExplorer(ctx, pluginLogRoot(), true);
+			if (!revealed.ok) return {
+				ok: false,
+				error: revealed.error
+			};
+			return {
+				ok: true,
+				opened: true
+			};
+		},
 		"edrv.searchFiles": async (args) => {
 			const sc = await requireSession(ctx, args.sessionId);
 			if ("err" in sc) return {
@@ -8335,8 +8541,8 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 * 统一入口：按方法分发到 handler 表。
 * @author ddj 2026年08月20号 / 2026年08月26号
 */
-async function handleRpc(ctx, registry, method, args, searcher = newSearcher(ctx), contentSearcher = newContentSearcher(ctx), lspHandlers, aiHandlers, fileVersions) {
-	const handler = buildHandlers(ctx, registry, searcher, contentSearcher, lspHandlers, aiHandlers, fileVersions)[method];
+async function handleRpc(ctx, registry, method, args, searcher = newSearcher(ctx), contentSearcher = newContentSearcher(ctx), lspHandlers, aiHandlers, fileVersions, svnHandlers) {
+	const handler = buildHandlers(ctx, registry, searcher, contentSearcher, lspHandlers, aiHandlers, fileVersions, svnHandlers)[method];
 	if (!handler) return {
 		ok: false,
 		error: "未知方法: " + String(method)
@@ -11882,58 +12088,1636 @@ function createFileVersions(ctx) {
 	};
 }
 //#endregion
-//#region src/index.ts
+//#region src/svnXml.ts
 /**
-* @dsh-external 生态 → dsh-vscode-mode：DSH 上的类 VSCode 编码体验（Host 半入口）。
-* 职责：装配 capture（tools/result 捕获 edit/write 差异）、RPC 分发（edrv.* / mcp.* / vscode.* / compat）、
-*       webServer 路由（/edrv/rpc、/edrv/assets/*、/edrv/vendor/*）、工作区旁车持久化、
-*       兼容层装配（依赖守卫 + 重复装配自诊断 + 启动日志兼容性报告）。
-* 结构：shared/（双面契约） + model/store/capture/workspace/revert/registry/rpc/routes/compat（host 模块）
-*       + log/debugLog（统一日志：bindHostLog 绑定 ctx.logger，edrv.debug 诊断文件通道）。
-* 作者 ddj 2026-08-20
+* dsh-vscode-mode host — SVN XML 解析基元（零第三方依赖，可单测）。
+*
+* 为什么单独成模块：svn 的 `--xml` 输出结构简单且高度同形（`<entry attr="...">` 族 +
+* 文本节点），status/log/info 三处解析共用同一套「实体反转义 + 取属性 + 单趟标签扫描」，
+* 各自实现会重复踩同一批坑（实测两次：闭标签被当成新条目、路径含 `&` 需反转义）。
+*
+* 设计约束：不引 XML 库——输出有上限保护，且只需识别少数字段，正则单趟扫描足够且可确定测试。
+* 作者 ddj 2026年09月16号
+*/
+/** XML 实体表（`&amp;` 等命名实体）。 */
+const NAMED_ENTITY = {
+	amp: "&",
+	lt: "<",
+	gt: ">",
+	quot: "\"",
+	apos: "'"
+};
+/**
+* XML 实体反转义（命名实体 + 十进制/十六进制数字引用）。
+* 实测场景：工作副本路径含 `&` 时 svn 输出 `a&amp;b.txt`，不反转义会把实体写进 UI。
+* 无法识别的引用原样保留（不猜）。
+* @author ddj 2026年09月16号
+* @param text 原始文本
+* @returns 反转义后的文本
+*/
+function unescapeXml(text) {
+	if (typeof text !== "string" || !text.includes("&")) return text ?? "";
+	return text.replace(/&(#x?[0-9a-fA-F]+|[a-zA-Z]+);/g, (whole, body) => {
+		if (body.startsWith("#x") || body.startsWith("#X")) {
+			const code = Number.parseInt(body.slice(2), 16);
+			return Number.isFinite(code) ? String.fromCodePoint(code) : whole;
+		}
+		if (body.startsWith("#")) {
+			const code = Number.parseInt(body.slice(1), 10);
+			return Number.isFinite(code) ? String.fromCodePoint(code) : whole;
+		}
+		return NAMED_ENTITY[body] ?? whole;
+	});
+}
+/**
+* 取标签属性值（`path="..."`；未命中返回空串）。属性值自动反转义。
+* @author ddj 2026年09月16号
+* @param tag 标签原文（含属性部分）
+* @param name 属性名
+* @returns 属性值；缺失返回 ''
 */
-const name = "dsh-vscode-mode";
-const inject = [
-	"sessions",
-	"fs",
-	"webServer",
-	"loader",
-	"tools",
-	"workspaceRegistry",
-	"agents"
-];
+function attrOf(tag, name) {
+	const hit = new RegExp(name + "\\s*=\\s*\"([^\"]*)\"").exec(tag);
+	return hit ? unescapeXml(hit[1]) : "";
+}
 /**
-* 装配插件：挂事件监听、注册路由、安装兼容层。
-* @author ddj 2026年08月20号
-* @param ctx DSH 上下文（sessions/fs/webServer 由 inject 提供；sandboxPolicy/subprocess 惰性获取）
-* @param config 插件配置（可选 imageDir 覆盖图标目录）
+* 取标签的文本内容（`<msg>...</msg>` 形式，支持换行）。
+* 与 attrOf 互补：SVN 的提交信息/作者/日期是文本节点而非属性。
+* @author ddj 2026年09月16号
+* @param xml 源文本
+* @param tag 标签名
+* @returns 反转义后的内容；缺失返回 ''
 */
-function apply(ctx, config) {
-	bindHostLog(ctx);
-	const registry = /* @__PURE__ */ new Map();
-	const searcher = newSearcher(ctx);
-	const contentSearcher = newContentSearcher(ctx);
-	/** LSP 服务器管理器（语言智能：跳转/引用/大纲；诊断行带模块内前缀如 [lsp-manager]）。 */
-	const lspManager = createLspManager((line) => log.debug(line));
-	/** 兼容性警告收集（route 护栏等写入，启动日志一并输出）。 */
-	const warnings = [];
-	/** 设置状态（fileOpenTool + AI 补全配置读写；settings 不可用时内存态降级）。 */
-	const openSettings = setupOpenSettings(ctx, config, () => {});
-	/** LSP 配置为配置值模式：插件组合配置 + 会话内运行时覆盖（原 settings section 命名空间不合法，见 lsp/config.ts）。 */
-	/** 规则注入 section（~/.dsh/rules 与 <工作区>/.dsh/rules；旧版 DSH 无 systemPrompt 时静默降级）。 */
-	const rulesInstalled = installRulesSection(ctx);
-	if (!rulesInstalled) log.warn("未检测到 systemPrompt 服务，规则仅可管理不注入");
-	/** 插件自带技能组（<包根>/skills，惰性获取 skills 服务；返回值仅表示"已调度"，实际结果见 skillGroupState）。 */
-	const skillsDispatched = installSkillGroup(ctx);
-	if (!skillsDispatched) log.warn("技能组未调度，插件技能组不可用");
-	/** LSP RPC 与会话清理（一次性创建，tracker 状态跨请求保留）。 */
-	const lspRpc = createLspRpc({
-		ctx,
-		pluginConfig: config,
-		manager: lspManager
+function textOf(xml, tag) {
+	const hit = new RegExp("<" + tag + ">([\\s\\S]*?)</" + tag + ">").exec(xml);
+	return hit ? unescapeXml(hit[1]) : "";
+}
+/**
+* 单趟扫描指定标签族（只识别 name 集合内的标签，其余忽略）。
+*
+* 调用方须自行处理「闭标签不等于新条目」——`<wc-status>`/`<logentry>` 的闭标签无属性，
+* 若当成新条目会产出多余的空记录（P2 实测踩过）。
+*
+* @author ddj 2026年09月16号
+* @param xml 源文本
+* @param names 关注的标签名集合
+* @returns 命中序列
+*/
+function scanXmlTags(xml, names) {
+	if (typeof xml !== "string" || !xml || !names.length) return [];
+	const alternation = names.map((name) => name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|");
+	const re = new RegExp("<(/?)(" + alternation + ")\\b([^>]*?)(/?)>", "g");
+	const hits = [];
+	let match;
+	while ((match = re.exec(xml)) !== null) hits.push({
+		closing: match[1] === "/",
+		name: match[2],
+		attrs: match[3],
+		selfClosing: match[4] === "/"
 	});
-	const lspHandlers = lspRpc.handlers;
-	const aiHandlers = createAiRpc({
+	return hits;
+}
+/**
+* 解析数字属性（`revision="123"`）；非法/缺失返回 undefined。
+* @author ddj 2026年09月16号
+* @param tag 标签原文
+* @param name 属性名
+* @returns 数字或 undefined
+*/
+function numAttrOf(tag, name) {
+	const raw = attrOf(tag, name);
+	if (raw === "") return void 0;
+	const value = Number.parseInt(raw, 10);
+	return Number.isFinite(value) ? value : void 0;
+}
+//#endregion
+//#region src/svnText.ts
+/** 输出载荷上限（1MB，与 runSvn stdio 限额一致）。 */
+const TEXT_OUTPUT_CAP = 1 << 20;
+/**
+* 命令输出是否成功。
+* @author ddj 2026年09月16号
+* @param code 退出码
+* @returns 是否成功
+*/
+function isOkCode(code) {
+	return code === 0;
+}
+/**
+* 合并 stdout/stderr 为单一诊断文本（去空、截断到上限）。
+* @author ddj 2026年09月16号
+* @param stdout 标准输出
+* @param stderr 标准错误
+* @param cap 上限
+* @returns 合并文本
+*/
+function mergeOutput(stdout, stderr, cap = TEXT_OUTPUT_CAP) {
+	return [stdout, stderr].filter((item) => item && item.trim()).join("\n").trim().slice(0, cap);
+}
+/**
+* 取文本尾部（错误提示只带末尾关键信息）。
+* @author ddj 2026年09月16号
+* @param text 原始文本
+* @param max 保留长度
+* @returns 末尾片段
+*/
+function tailOfText(text, max = 400) {
+	const trim = String(text ?? "").trim();
+	if (trim.length <= max) return trim || "无输出";
+	return "…" + trim.slice(-max);
+}
+/**
+* svn update 的逐条结果行状态字母表（`svn help update` 的「A  Added / U  Updated …」）。
+* 保留中文字面量以覆盖本地化输出；未识别字母不生成条目（宁缺勿错）。
+*/
+const UPDATE_ACTION_LABEL = {
+	A: "已添加",
+	U: "已更新",
+	D: "已删除",
+	G: "已合并",
+	C: "冲突",
+	E: "已存在",
+	R: "已替换",
+	" ": "无变化"
+};
+/** update 结果行：行首若干空白 + 单字母 + 空白 + 路径（路径可含空格，取整段）。 */
+const UPDATE_LINE_RE = /^([ADGCEUR]|\s{3})\s{2,}(\S.*)$/;
+/**
+* 解析 `svn update` 文本输出为**条目级**结构化结果（附冲突清单与一行摘要）。
+*
+* 为什么不能只给摘要：update 是「逐文件状态」语义，用户需要看到哪些文件被更新、
+* 哪些冲突（实测冲突行 `C    conf.txt` + 末尾 `Summary of conflicts:` 段）。
+* update 不接受 `--xml`（实测：`Subcommand 'update' doesn't accept option '--xml'`），
+* 故只能文本解析；解析不出条目时保留 revision/冲突摘要等既有字段，保证不退化。
+*
+* @author ddj 2026年09月16号
+* @param stdout 标准输出
+* @param stderr 标准错误
+* @param code 退出码
+* @returns 结构化结果（entries 为条目级明细；conflicts 为冲突路径清单）
+*/
+function updateResultOf(stdout, stderr, code) {
+	const output = mergeOutput(stdout, stderr);
+	const matches = [...output.matchAll(/(?:revision|版本)\s*\.?\s*(\d+)/gi)];
+	const revision = matches.length ? Number(matches[matches.length - 1][1]) : void 0;
+	const entries = [];
+	const conflicts = [];
+	for (const line of output.split(/\r?\n/)) {
+		const hit = UPDATE_LINE_RE.exec(line);
+		if (hit) {
+			const action = hit[1].trim();
+			const path = hit[2].trim();
+			if (path && entries.length < 4e3) entries.push({
+				action,
+				path,
+				label: UPDATE_ACTION_LABEL[action] ?? action
+			});
+			if (action === "C" && conflicts.length < 64) conflicts.push(path);
+			continue;
+		}
+		const loose = /^(?:\s?[A-Z_ ]?C)\s+(\S.*)$/.exec(line);
+		if (loose && conflicts.length < 64) {
+			const path = loose[1].trim();
+			if (!conflicts.includes(path)) conflicts.push(path);
+		}
+	}
+	const conflictText = conflicts.length ? "，冲突 " + conflicts.length + " 项" : "";
+	return {
+		summary: revision !== void 0 ? "已更新到修订版 r" + revision + conflictText : "更新完成" + conflictText,
+		revision,
+		conflicts,
+		entries,
+		output
+	};
+}
+/**
+* 解析 revert/add/commit 等批量命令输出为「计数 + 摘要」。
+* @author ddj 2026年09月16号
+* @param stdout 标准输出
+* @param stderr 标准错误
+* @param code 退出码
+* @param verb 动作动词（中文摘要用）
+* @returns 动作结果载荷
+*/
+function batchResultOf(stdout, stderr, code, verb) {
+	const output = mergeOutput(stdout, stderr);
+	const count = (stdout.match(/^(?:Reverted|A|Adding|Skipped|Deleting|D)\b/gm) ?? []).length;
+	return {
+		count,
+		summary: !isOkCode(code) ? verb + "失败" + (output ? "：" + tailOfText(output) : "") : verb + "完成" + (count ? "（" + count + " 项）" : ""),
+		output
+	};
+}
+/**
+* Show All（P1-7）专用条目上限：比默认 `LOG_CAP` 高一个量级，仍留护栏。
+*
+* 取舍依据（蓝图 §5 P1-7）：真全量（省略 `-l`）在超大仓库会拉取上百 MB XML，
+* 且 DSH 输出收集器超限**保留尾部**（见 `svn.ts` `LOG_OUTPUT_CAP` 教训）→ 宁可有界。
+* 实测（2026-09-18，IslandSplash_BugFix `Assets`，svn 1.14.5）：`-l 5000` → 5000 条 /
+* 18.86MB / 30.1s；根路径 `-g` 300 条全历史 > 600s 未返回（真全量 + `-g` 不可行）。
+*/
+const SVN_LOG_SHOW_ALL_CAP = 5e3;
+/** 合法日志动作字母。 */
+const LOG_ACTIONS = /* @__PURE__ */ new Set([
+	"A",
+	"D",
+	"R",
+	"M"
+]);
+/**
+* merged 条目的最大解析深度（P1-5）：实测最深 1 层，更深递归未观察到，
+* 故按「可能更深」实现递归但有界，防病态输入无限下钻。
+*/
+const LOG_MERGE_DEPTH = 8;
+/**
+* 把仓库绝对路径映射为工作区相对路径。
+*
+* `relativeUrl` 形如 `^/trunk`（来自 `svn info --xml`）；仓库路径 `/trunk/sub/x.txt`
+* 剥前缀后得 `sub/x.txt`。注意 relative-url 是 **URL 编码形态**（实测：空格 = `%20`、
+* 中文 = `%E9..`），而 log --xml 的 path 是明文，比对前必须先解码。
+* 前缀不完全匹配（跨分支/外部定义）返回 null——宁可在 UI 标注「仓库外」也不要硬拼出
+* 错误路径导致打开失败。
+*
+* @author ddj 2026年09月16号 / 2026年09月17号
+* @param repoPath 仓库绝对路径（`/trunk/...`）
+* @param relativeUrl 工作副本根的 relative-url（`^/trunk`，URL 编码形态）
+* @returns 工作区相对路径；不在根下返回 null
+*/
+function mapRepoPath(repoPath, relativeUrl) {
+	const repo = String(repoPath ?? "").replace(/\/+$/, "");
+	const encoded = String(relativeUrl ?? "").replace(/^\^/, "").replace(/\/+$/, "");
+	let prefix = encoded;
+	try {
+		prefix = decodeURIComponent(encoded);
+	} catch (e) {}
+	if (!repo) return null;
+	if (!prefix) return null;
+	if (repo === prefix) return "";
+	if (!repo.startsWith(prefix + "/")) return null;
+	return repo.slice(prefix.length + 1);
+}
+/**
+* 解析 `svn log --xml -v` 输出为日志条目列表。
+*
+* 实现：顺序扫描（非按块切分）——`parseLogEntry` 会连**嵌套内容**一起消费，
+* 并返回本条结束位置，故顶层循环天然只收顶层条目，嵌套归各自的父条目。
+* 每条内取 author/date/msg 与 `<paths>` 段；`<path attrs>文本</path>` 的属性在标签上、
+* 路径在标签之间。闭标签不得当作新条目（P2 在 status 解析上踩过同一个坑）。
+*
+* P1-5（`-g`）：被合并的修订是**嵌套 `<logentry>`**（位于父条目 `</msg>` 之后，可并列多个），
+* 收进父条目的 `merged`；`cap` 只约束顶层条目（实测 `-l` 亦只约束顶层，总条数可超 `-l`）。
+*
+* @author ddj 2026年09月16号 / 2026年09月18号
+* @param xml log --xml 的 stdout
+* @param relativeUrl 工作副本根的 relative-url（用于路径映射；缺省则不映射）
+* @param cap 顶层条目上限
+* @returns 日志条目与是否截断
+*/
+function parseLogXml(xml, relativeUrl = "", cap = 500) {
+	const entries = [];
+	let truncated = false;
+	if (typeof xml !== "string" || !xml) return {
+		entries,
+		truncated
+	};
+	let from = xml.indexOf("<logentry");
+	while (from >= 0) {
+		if (entries.length >= cap) {
+			truncated = true;
+			break;
+		}
+		const scanned = parseLogEntry(xml, from, relativeUrl, 0);
+		if (!scanned) break;
+		entries.push(scanned.entry);
+		from = xml.indexOf("<logentry", scanned.end);
+	}
+	return {
+		entries,
+		truncated
+	};
+}
+/**
+* 解析 `at` 处的一条 logentry（连嵌套内容一起消费；P1-5 递归 merged）。
+*
+* @author ddj 2026年09月18号
+* @param xml 日志 XML 全文
+* @param at `<logentry` 的起始下标
+* @param relativeUrl 工作副本根的 relative-url
+* @param depth 当前嵌套深度（顶层 0）
+* @returns 条目与「本条结束下标」；起始处不是 logentry 时返回 null
+*/
+function parseLogEntry(xml, at, relativeUrl, depth) {
+	const attrs = tagTailOf(xml, at, "logentry");
+	if (attrs === null) return null;
+	const revision = numAttrOf(attrs, "revision");
+	if (revision === void 0) return null;
+	const bodyFrom = at + 9 + attrs.length + 1;
+	let end = entryEndOf(xml, bodyFrom, depth);
+	const body = xml.slice(bodyFrom, end);
+	const entry = {
+		revision,
+		author: textOf(body, "author"),
+		date: textOf(body, "date"),
+		message: textOf(body, "msg"),
+		paths: parseLogPaths(body, relativeUrl)
+	};
+	const reverse = attrOf(attrs, "reverse-merge");
+	if (reverse) entry.reverseMerge = reverse === "true";
+	if (depth < LOG_MERGE_DEPTH) {
+		const nested = parseMergedOf(xml, bodyFrom, end, relativeUrl, depth);
+		if (nested.list.length) entry.merged = nested.list;
+		end = nested.end;
+	}
+	return {
+		entry,
+		end
+	};
+}
+/**
+* 取 `at` 处标签的属性串（`<name` 之后到首个 `>` 之间）。
+* @author ddj 2026年09月18号
+* @param xml XML 全文
+* @param at `<name` 的起始下标
+* @param name 标签名
+* @returns 属性串（已 trim）；该处不是该标签的开标签时返回 null
+*/
+function tagTailOf(xml, at, name) {
+	if (!xml.startsWith("<" + name, at)) return null;
+	const gt = xml.indexOf(">", at);
+	if (gt < 0) return null;
+	const tag = xml.slice(at + 1 + name.length, gt);
+	return tag.trim().endsWith("/") ? null : tag;
+}
+/**
+* 求条目结束下标：从正文起点扫描，跳过全部嵌套条目所用的闭标签。
+*
+* 实现按「先看下一个 `<logentry` 起点、再看当前深度的 `</logentry>`」取舍，
+* 因而支持更深层级（深层闭标签由深层那次递归消费，不会提前终止本层）。
+* @author ddj 2026年09月18号
+* @param xml XML 全文
+* @param from 正文起点（开标签 `>` 之后）
+* @param depth 本条目深度
+* @returns 本条 `</logentry>` 之后的绝对下标
+*/
+function entryEndOf(xml, from, depth) {
+	let scan = from;
+	let level = depth;
+	while (scan < xml.length) {
+		const openAt = xml.indexOf("<logentry", scan);
+		const closeAt = xml.indexOf("</logentry>", scan);
+		if (closeAt < 0) return xml.length;
+		if (openAt >= 0 && openAt < closeAt) {
+			const attrs = tagTailOf(xml, openAt, "logentry");
+			if (attrs === null) {
+				scan = openAt + 9;
+				continue;
+			}
+			scan = entryEndOf(xml, openAt + 9 + attrs.length + 1, level + 1);
+			continue;
+		}
+		if (level <= depth) return closeAt + 11;
+		level -= 1;
+		scan = closeAt + 11;
+	}
+	return xml.length;
+}
+/**
+* 解析块内全部并列嵌套 logentry（P1-5）；`end` 随之推进到本条目结束处。
+*
+* @author ddj 2026年09月18号
+* @param xml XML 全文
+* @param from 正文起点（开标签 `>` 之后）
+* @param end 本条目结束下标（深度扫描的结果）
+* @param relativeUrl 工作副本根的 relative-url
+* @param depth 父条目深度
+* @returns 嵌套条目列表与推进后的结束下标
+*/
+function parseMergedOf(xml, from, end, relativeUrl, depth) {
+	const list = [];
+	let scan = from;
+	while (scan < end) {
+		const openAt = xml.indexOf("<logentry", scan);
+		if (openAt < 0 || openAt >= end) break;
+		const nested = parseLogEntry(xml, openAt, relativeUrl, depth + 1);
+		if (!nested) {
+			scan = openAt + 9;
+			continue;
+		}
+		list.push(nested.entry);
+		scan = nested.end;
+		end = Math.max(end, nested.end);
+	}
+	return {
+		list,
+		end
+	};
+}
+/**
+* 解析单条日志的 `<paths>` 段为变更路径列表。
+* @author ddj 2026年09月16号
+* @param block 单条 logentry 原文
+* @param relativeUrl 工作副本根的 relative-url
+* @returns 变更路径列表
+*/
+function parseLogPaths(block, relativeUrl) {
+	const section = /<paths>([\s\S]*?)<\/paths>/.exec(block);
+	if (!section) return [];
+	const out = [];
+	const re = /<path\b([^>]*?)\/?>([\s\S]*?)<\/path>/g;
+	let m;
+	while ((m = re.exec(section[1])) !== null) {
+		const attrs = m[1];
+		const rawPath = unescapeXml(m[2]).trim();
+		if (!rawPath) continue;
+		const action = attrOf(attrs, "action");
+		out.push({
+			path: rawPath,
+			relPath: mapRepoPath(rawPath, relativeUrl),
+			action: LOG_ACTIONS.has(action) ? action : "M",
+			kind: attrOf(attrs, "kind") || void 0,
+			copyFrom: attrOf(attrs, "copyfrom-path") || void 0,
+			copyFromRev: numAttrOf(attrs, "copyfrom-rev"),
+			propMods: attrOf(attrs, "prop-mods") === "true",
+			textMods: attrOf(attrs, "text-mods") === "true"
+		});
+	}
+	return out;
+}
+/**
+* 从 `svn info --xml` 输出解析工作副本版号（P1-9；目录目标返回 null——版号加粗仅对文件目标）。
+* @author ddj 2026年09月17号
+* @param xml svn info --xml 输出
+* @returns 工作副本版号（无 commit 节点或目录 = null）
+*/
+function parseSvnInfoRevision(xml) {
+	const text = String(xml ?? "");
+	if (!text.includes("<entry")) return null;
+	if ((/<entry[^>]*\bkind="([^"]*)"/.exec(text)?.[1] ?? "") === "dir") return null;
+	const at = /<commit[^>]*\brevision="(\d+)"/.exec(text);
+	return at ? Number(at[1]) : null;
+}
+/** CLI 探测超时。 */
+const CLI_GRACE_MS = 6e3;
+/** svn update 超时（大工作副本留足预算）。 */
+const UPDATE_GRACE_MS = 18e4;
+/** TortoiseProc 发射超时预算（不 await done，仅约束服务侧资源）。 */
+const TORTOISE_GRACE_MS = 6e5;
+/** 前台置顶助手超时预算（轮询 ≤8s + PowerShell 启动余量）。 */
+const HELPER_GRACE_MS = 2e4;
+/** 输出载荷上限（1MB，对齐 runSvn stdio 限额；文本解析上限见 svnText.TEXT_OUTPUT_CAP）。 */
+const OUTPUT_CAP = TEXT_OUTPUT_CAP;
+/**
+* 日志拉取的 stdout 上限：默认窗口 LOG_CAP=500 条、Show All 上限 SVN_LOG_SHOW_ALL_CAP=5000 条。
+*
+* 实测（2026-09-18，IslandSplash_BugFix `Assets`，svn 1.14.5）：`-l 500` → 2.52MB / 2.0s，
+* `-l 5000` → 18.86MB / 30.1s（约 3.8~5KB/条，含中文路径与提交信息）。故取 64MB 留约 3× 余量，
+* `-g`（merged）单条更大也吃这份余量。
+* 实测教训（勿复踩）：默认 1MB 上限时收集器保留**尾部**，Assets 全量 100 条（1.19MB）
+* 恰好把最新的 52 条挤出（用户报「显示的数据不对」）。
+* @author ddj 2026年09月17号 / 2026年09月18号
+*/
+const LOG_OUTPUT_CAP = 67108864;
+/** 变更条目上限（防超大工作副本撑爆载荷）。 */
+const CHANGES_CAP = 4e3;
+/** `svn status --xml` 超时（大工作副本留足预算）。 */
+const STATUS_GRACE_MS = 12e4;
+/** 其他只读子命令（cat/info）超时。 */
+const READ_GRACE_MS = 3e4;
+/** revert/add 超时。 */
+const MUTATE_GRACE_MS = 12e4;
+/** 文本读取上限（对齐 rpc.ts READ_CAP：>8MB 拒绝整文件读取/差异）。 */
+const READ_CAP = 8388608;
+/** 工作副本根向上查找（≤10 层，命中含 .svn 的最近祖先）。 */
+const SVN_ROOT_MAX_DEPTH = 10;
+/** 默认存在性探测（node fs；异常一律按不存在）。 */
+const defaultExists = async (path) => {
+	try {
+		await stat(path);
+		return true;
+	} catch {
+		return false;
+	}
+};
+/**
+* 从 cwd 向上查找 SVN 工作副本根（.svn 目录/文件均算，SvnHelper 同口径）。
+* `.svn` 判定与平台无关（Linux/macOS 亦为目录），无需平台参数。
+* @author ddj 2026年09月16号
+* @param cwd 起始绝对路径
+* @param exists 存在性探测（测试注入）
+* @returns 工作副本根绝对路径；未命中返回 null
+*/
+async function findSvnRoot(cwd, exists = defaultExists) {
+	let dir = cwd;
+	for (let depth = 0; dir && depth < SVN_ROOT_MAX_DEPTH; depth += 1) {
+		if (await exists(join(dir, ".svn"))) return dir;
+		const parent = dirname(dir);
+		if (parent === dir) return null;
+		dir = parent;
+	}
+	return null;
+}
+/**
+* 解析 TortoiseProc.exe（候选序：设置目录 → bin 子目录 → 默认安装目录 → PATH 逐项）。
+* @author ddj 2026年09月16号
+* @param dirSetting 设置里的 TortoiseSVN 目录（空 = 默认）
+* @param exists 存在性探测（测试注入）
+* @param platform 目标平台（非 win32 恒 null）
+* @param pathEnv PATH 环境变量（测试注入）
+* @returns TortoiseProc.exe 绝对路径；不可用返回 null
+*/
+async function findTortoiseProc(dirSetting, exists = defaultExists, platform = process.platform, pathEnv = process.env?.PATH) {
+	if (platform !== "win32") return null;
+	const dir = dirSetting && dirSetting.trim() ? dirSetting.trim() : "";
+	const candidates = [dir && join(dir, "bin", "TortoiseProc.exe"), dir && join(dir, "TortoiseProc.exe")].filter((item) => Boolean(item));
+	for (const entry of (pathEnv ?? "").split(";")) {
+		const trim = entry.trim();
+		if (trim) candidates.push(join(trim, TORTOISE_EXE));
+	}
+	for (const candidate of candidates) if (await exists(candidate)) return candidate;
+	return null;
+}
+/**
+* 本插件已自研的 SVN 能力（「自研替换时间线」的推进点）。
+*
+* 每完成一个阶段就把对应能力加进来：client 会据此隐藏被覆盖的 TortoiseProc 项，
+* 避免自研项与官方同名项并列、用户误点到官方弹窗。
+* 当前：差异（P2「与基线比较」）、还原（P2 `revert -R`）、日志（P3 日志弹窗）。
+* 待补：提交（P4 完成后加入 'commit'）；追溯无自研计划（P5 另议），故不含 'blame'。
+*/
+const SVN_FEATURES = [
+	"diff",
+	"revert",
+	"log"
+];
+/** `svn status --xml` 的 `<wc-status item="...">` 合法取值（未知值一律按 modified 兜底）。 */
+const KNOWN_ITEM_STATUS = /* @__PURE__ */ new Set([
+	"normal",
+	"added",
+	"deleted",
+	"replaced",
+	"conflicted",
+	"missing",
+	"unversioned",
+	"obstructed",
+	"ignored",
+	"modified",
+	"external",
+	"incomplete"
+]);
+/** 受版本控制判据：unversioned/ignored 之外均为版本化条目。 */
+const UNVERSIONED_STATUS = /* @__PURE__ */ new Set(["unversioned", "ignored"]);
+/**
+* 归一化 XML 中的条目路径为工作区相对路径（`/` 分隔、无前导 `./`）。
+* XML 路径相对「执行 status 时的 cwd」（实测 Windows 下用 `\`），故 host 必须以
+* 工作副本根为 cwd 执行，这里只做分隔符与形态归一；`''`/`.` 表示根自身。
+* @author ddj 2026年09月16号
+* @param raw XML path 属性原文（已反转义）
+* @returns 归一化路径；根自身返回 ''
+*/
+function changePathOf(raw) {
+	const stripped = String(raw ?? "").replace(/\\/g, "/").trim().replace(/^(?:\.\/)+/, "").replace(/\/+$/, "");
+	return stripped === "." ? "" : stripped;
+}
+/**
+* 解析 `svn status --xml` 输出为变更清单（纯函数，无第三方 XML 依赖）。
+*
+* 结构要点（实测 svn 1.14.5）：
+* - `<target path="..."><entry path="..."><wc-status item="..." props="..." revision="..."/></entry>...`
+* - 登记过 changelist 的条目被抽到 `<changelist name="...">` 块内（与 target 平级），
+*   故解析必须按块回填 changelist 名，不能只看 `<entry>`。
+* - 根自身条目（`path="."`）在属性被改时出现，`item="normal"` 不代表变更；路径为空的
+*   条目一律跳过，避免把根当成变更项展示。
+*
+* @author ddj 2026年09月16号
+* @param xml status --xml 的 stdout
+* @param cap 条目上限（超出标记 truncated）
+* @returns 变更清单与是否截断
+*/
+function parseStatusXml(xml, cap = CHANGES_CAP) {
+	const entries = [];
+	let truncated = false;
+	if (typeof xml !== "string" || !xml) return {
+		entries,
+		truncated
+	};
+	let changelist = "";
+	let pendingPath = null;
+	for (const hit of scanXmlTags(xml, [
+		"changelist",
+		"entry",
+		"wc-status"
+	])) {
+		if (hit.name === "changelist") {
+			changelist = hit.closing ? "" : attrOf(hit.attrs, "name");
+			continue;
+		}
+		if (hit.name === "entry") {
+			pendingPath = hit.closing ? null : attrOf(hit.attrs, "path");
+			continue;
+		}
+		if (hit.closing) {
+			pendingPath = null;
+			continue;
+		}
+		if (!pendingPath) continue;
+		const item = attrOf(hit.attrs, "item") || "modified";
+		const status = KNOWN_ITEM_STATUS.has(item) ? item : "modified";
+		const path = changePathOf(pendingPath);
+		if (!path) {
+			pendingPath = null;
+			continue;
+		}
+		if (entries.length >= cap) truncated = true;
+		else {
+			const props = attrOf(hit.attrs, "props");
+			const revision = numAttrOf(hit.attrs, "revision");
+			entries.push({
+				path,
+				status,
+				props: props === "modified" || props === "conflicted" ? props : "none",
+				versioned: !UNVERSIONED_STATUS.has(status),
+				...changelist ? { changelist } : {},
+				...revision !== void 0 && revision >= 0 ? { revision } : {}
+			});
+		}
+		if (hit.selfClosing) pendingPath = null;
+	}
+	return {
+		entries,
+		truncated
+	};
+}
+/** 进程名（去路径去 .exe；前台助手用）。 */
+function processNameOf(exe) {
+	return (exe.split(/[\\/]/).pop() ?? exe).replace(/\.exe$/i, "");
+}
+/**
+* 前台置顶助手 argv（纯函数）。
+* 背景：Windows 前台锁——后台进程（DSH host）启动的窗口默认抢不到前台（任务栏闪烁），
+* 前台进程的子进程才继承置顶权（SvnHelper 依赖 VSCode 在前台故无此问题）。
+* 方案：独立 PowerShell 助手轮询新进程主窗口，SwitchToThisWindow 强制切换
+* （任务栏同源 API，无前台权限也可切窗）；脚本内不含任何用户数据（按进程名发现），无注入面。
+* @author ddj 2026年09月16号
+* @param processName 目标进程名（不带 .exe）
+* @returns powershell 助手 argv
+*/
+function foregroundHelperArgv(processName) {
+	return [
+		"powershell",
+		"-NoProfile",
+		"-NonInteractive",
+		"-WindowStyle",
+		"Hidden",
+		"-Command",
+		[
+			"$cut = (Get-Date).AddSeconds(-2)",
+			"$deadline = $cut.AddSeconds(8)",
+			"$h = [IntPtr]::Zero",
+			"while ((Get-Date) -lt $deadline) {",
+			"  Start-Sleep -Milliseconds 150",
+			"  $p = Get-Process -Name \"" + processName + "\" -ErrorAction SilentlyContinue | Where-Object { $_.StartTime -ge $cut -and $_.MainWindowHandle -ne 0 } | Sort-Object StartTime -Descending | Select-Object -First 1",
+			"  if ($p) { $h = $p.MainWindowHandle; break }",
+			"}",
+			"if ($h -ne [IntPtr]::Zero) {",
+			"  Add-Type -Namespace W -Name N -MemberDefinition '[DllImport(\"user32.dll\")] public static extern void SwitchToThisWindow(IntPtr h, bool a);'",
+			"  [W.N]::SwitchToThisWindow($h, $true)",
+			"}"
+		].join("\n")
+	];
+}
+/** host 会话/工作区前置（对齐 rpc.ts requireSession 的错误文案）。 */
+async function requireSvnSession(ctx, sessionId) {
+	const session = sessionOf(ctx, sessionId);
+	if (!session) return { err: "会话不存在" };
+	const cwd = cwdOf(session);
+	if (!cwd) return { err: "会话无工作区" };
+	return { cwd };
+}
+/** 工作区相对路径归一（'' 合法 = 工作区根；非法含越界/绝对路径返回 null）。 */
+function safeRel(raw) {
+	if (raw === void 0 || raw === null || raw === "") return "";
+	if (typeof raw !== "string") return null;
+	const rel = raw.replace(/\\/g, "/").replace(/^\.\//, "").replace(/\/+$/, "");
+	if (rel === "") return "";
+	if (rel === ".." || rel.startsWith("../") || rel.includes("/../")) return null;
+	if (/^[A-Za-z]:/.test(rel) || rel.startsWith("/")) return null;
+	return rel;
+}
+/**
+* 创建 svn.* RPC handlers（缓存随装配生命周期；lsp/ai 同模式并入 buildHandlers）。
+* @author ddj 2026年09月16号
+* @param deps ctx + 设置读取面 + 可注入时钟
+* @returns handlers（Partial<RpcHandlerMap> 形状）
+*/
+function createSvnRpc(deps) {
+	const { ctx, settings } = deps;
+	const now = deps.now ?? (() => Date.now());
+	const findRoot = deps.findRoot ?? ((cwd) => findSvnRoot(cwd));
+	const findTortoise = deps.findTortoise ?? ((dir) => findTortoiseProc(dir));
+	const statusCache = /* @__PURE__ */ new Map();
+	/** 变更清单缓存（键 = 工作副本根；TTL 短，仅合并同一轮 UI 的多处拉取）。 */
+	const changesCache = /* @__PURE__ */ new Map();
+	/** 工作副本根 relative-url 缓存（日志路径映射用；探测失败也缓存空串避免反复 spawn）。 */
+	const urlCache = /* @__PURE__ */ new Map();
+	let cliProbe = null;
+	const subprocess = () => {
+		const sub = ctx.get("subprocess");
+		if (!sub || typeof sub.spawn !== "function") return null;
+		return sub.spawn.bind(sub);
+	};
+	/** svn CLI 探测（inherit stdio 只取退出码；TTL 缓存按 exe 键）。 */
+	const probeCli = async (exe) => {
+		const at = now();
+		if (cliProbe && cliProbe.exe === exe && at - cliProbe.at < 3e5) return cliProbe.ok;
+		let ok = false;
+		const spawn = subprocess();
+		if (spawn) try {
+			const outcome = await spawn({
+				argv: [
+					exe,
+					"--version",
+					"--quiet"
+				],
+				cwd: tmpdir(),
+				stdio: {
+					stdout: "inherit",
+					stderr: "inherit",
+					stdin: "ignore"
+				},
+				graceMs: CLI_GRACE_MS
+			}).done;
+			ok = (outcome?.exitCode ?? outcome?.code) === 0;
+		} catch {
+			ok = false;
+		}
+		cliProbe = {
+			at,
+			exe,
+			ok
+		};
+		return ok;
+	};
+	/** 合成状态（managed/svnCli/tortoise），带 TTL 缓存。 */
+	const statusOf = async (cwd, force = false) => {
+		const at = now();
+		const hit = statusCache.get(cwd);
+		if (!force && hit && at - hit.at < 6e4) return hit.payload;
+		const configured = settings.svn();
+		const cliExe = configured.svnPath.trim() || "svn";
+		const wcRoot = await findRoot(cwd);
+		const svnCli = await probeCli(cliExe);
+		const tortoiseExe = await findTortoise(configured.tortoisePath);
+		const payload = {
+			managed: wcRoot !== null,
+			wcRoot,
+			svnCli,
+			tortoise: tortoiseExe !== null,
+			svnFeatures: SVN_FEATURES,
+			svnPath: cliExe,
+			tortoiseExe: tortoiseExe ?? ""
+		};
+		statusCache.set(cwd, {
+			at,
+			payload
+		});
+		return payload;
+	};
+	/**
+	* 运行 svn CLI（管道收集；spawn 级失败回退 inherit，输出降级为空）。
+	* @author ddj 2026年08月26号 / 2026年09月17号
+	* @param cwd 运行目录
+	* @param argv 参数（不含可执行文件名；自动加 --non-interactive）
+	* @param graceMs 进程宽限
+	* @param stdoutCap stdout 收集上限（缺省 1MB；大载荷场景如日志拉取需显式放大）
+	* @returns 退出码与输出
+	*/
+	const runSvn = async (cwd, argv, graceMs, stdoutCap = OUTPUT_CAP) => {
+		const spawn = subprocess();
+		if (!spawn) throw new Error("缺少 subprocess 服务");
+		const fs = ctx.get("fs");
+		let realCwd = cwd;
+		if (fs?.resolve && fs?.processPath) realCwd = fs.processPath(await fs.resolve(cwd, {}));
+		const exe = settings.svn().svnPath.trim() || "svn";
+		const attempt = (mode) => spawn({
+			argv: [
+				exe,
+				"--non-interactive",
+				...argv
+			],
+			cwd: realCwd,
+			stdio: mode === "pipe" ? {
+				stdout: { maxBytes: stdoutCap },
+				stderr: { maxBytes: OUTPUT_CAP },
+				stdin: "ignore"
+			} : {
+				stdout: "inherit",
+				stderr: "inherit",
+				stdin: "ignore"
+			},
+			graceMs
+		});
+		try {
+			const handle = attempt("pipe");
+			const outcome = await handle.done;
+			const stdout = handle.collected?.stdout?.readFrom(0).text ?? "";
+			const stderr = handle.collected?.stderr?.readFrom(0).text ?? "";
+			return {
+				code: outcome?.exitCode ?? outcome?.code ?? null,
+				stdout,
+				stderr
+			};
+		} catch {
+			const outcome = await attempt("inherit").done;
+			return {
+				code: outcome?.exitCode ?? outcome?.code ?? null,
+				stdout: "",
+				stderr: ""
+			};
+		}
+	};
+	/** 发射 TortoiseProc（GUI 长驻：不 await done，no-op catch 防未处理 rejection）。 */
+	const launchTortoise = (exe, action, absPath) => {
+		const spawn = subprocess();
+		if (!spawn) throw new Error("缺少 subprocess 服务");
+		spawn({
+			argv: tortoiseLaunchArgv(exe, action, absPath),
+			cwd: dirname(absPath),
+			stdio: {
+				stdout: "inherit",
+				stderr: "inherit",
+				stdin: "ignore"
+			},
+			graceMs: TORTOISE_GRACE_MS
+		}).done.catch(() => {});
+		if ((deps.platform ?? process.platform) !== "win32") return;
+		try {
+			spawn({
+				argv: foregroundHelperArgv(processNameOf(exe)),
+				cwd: tmpdir(),
+				stdio: {
+					stdout: "inherit",
+					stderr: "inherit",
+					stdin: "ignore"
+				},
+				graceMs: HELPER_GRACE_MS
+			}).done.catch(() => {});
+		} catch {}
+	};
+	/**
+	* 读取并缓存工作副本变更（`svn status --xml --no-ignore`，以工作副本根为 cwd 执行）。
+	*
+	* 为什么固定以 wcRoot 为 cwd：XML 里的 path 是相对「执行时的 cwd」的（实测 Windows 用
+	* `\`），固定根目录后路径即为「工作副本根相对」，与 client 的 scope/树路径口径一致；
+	* 恒带 `--no-ignore` 取全集（默认不返回 ignored），显示开关交给客户端，避免为开关重跑。
+	* @author ddj 2026年09月16号
+	* @param wcRoot 工作副本根绝对路径
+	* @param force 跳过 TTL 强制重查
+	* @returns 变更清单与截断标记
+	*/
+	const changesOf = async (wcRoot, force = false) => {
+		const at = now();
+		const hit = changesCache.get(wcRoot);
+		if (!force && hit && at - hit.at < 5e3) return hit.value;
+		const outcome = await runSvn(wcRoot, [
+			"status",
+			"--xml",
+			"--no-ignore"
+		], STATUS_GRACE_MS);
+		if (outcome.code !== 0) throw new Error(tailOfText([outcome.stderr, outcome.stdout].filter(Boolean).join("\n")));
+		const value = parseStatusXml(outcome.stdout);
+		changesCache.set(wcRoot, {
+			at,
+			value
+		});
+		return value;
+	};
+	/**
+	* 批量路径动作公共流程（revert/add 共用）：会话 → 路径白名单与上限 → 受管理校验 → 执行。
+	* 路径一律以工作副本根为 cwd 传入（`--` 之后），避免以 cwd 为基准产生歧义。
+	* @author ddj 2026年09月16号
+	* @param verb 动作动词（摘要用）
+	* @param verbArgs 子命令与选项（如 ['revert','-R']）
+	* @param sessionId 会话 id
+	* @param paths 工作区相对路径列表
+	* @returns 动作结果或错误
+	*/
+	const mutate = async (verb, verbArgs, sessionId, paths) => {
+		const sc = await requireSvnSession(ctx, sessionId);
+		if ("err" in sc) return {
+			ok: false,
+			error: sc.err
+		};
+		if (!Array.isArray(paths) || !paths.length) return {
+			ok: false,
+			error: "未选择任何路径"
+		};
+		if (paths.length > 64) return {
+			ok: false,
+			error: "一次最多处理 64 个路径"
+		};
+		const rels = [];
+		for (const item of paths) {
+			const rel = safeRel(item);
+			if (rel === null || rel === "") return {
+				ok: false,
+				error: "路径不合法"
+			};
+			rels.push(rel);
+		}
+		const status = await statusOf(sc.cwd);
+		if (!status.managed || !status.wcRoot) return {
+			ok: false,
+			error: "当前工作区不受 SVN 管理"
+		};
+		if (!status.svnCli) return {
+			ok: false,
+			error: "svn 命令不可用（可在设置页配置 svn 路径）"
+		};
+		try {
+			const outcome = await runSvn(status.wcRoot, [
+				...verbArgs,
+				"--",
+				...rels
+			], MUTATE_GRACE_MS);
+			const result = batchResultOf(outcome.stdout, outcome.stderr, outcome.code, verb);
+			changesCache.delete(status.wcRoot);
+			if (outcome.code !== 0) return {
+				ok: false,
+				error: verb + "失败：" + (result.output ? tailOfText(result.output) : "未知错误")
+			};
+			return {
+				ok: true,
+				count: result.count,
+				summary: result.summary,
+				output: result.output
+			};
+		} catch (error) {
+			return {
+				ok: false,
+				error: verb + "失败：" + String(error)
+			};
+		}
+	};
+	/**
+	* 读取并缓存工作副本根的 `relative-url`（`^/trunk`），供日志路径映射用。
+	* 与状态探测同 TTL 量级：仓库切换（switch/relocate）是低频操作，缓存 60s 足够且省一次 spawn。
+	* @author ddj 2026年09月16号
+	* @param wcRoot 工作副本根
+	* @returns relative-url（探测失败返回 ''）
+	*/
+	const relativeUrlOf = async (wcRoot) => {
+		const at = now();
+		const hit = urlCache.get(wcRoot);
+		if (hit && at - hit.at < 6e4) return hit.value;
+		let value = "";
+		try {
+			const outcome = await runSvn(wcRoot, ["info", "--xml"], READ_GRACE_MS);
+			if (outcome.code === 0) value = textOf(outcome.stdout, "relative-url");
+		} catch {
+			value = "";
+		}
+		urlCache.set(wcRoot, {
+			at,
+			value
+		});
+		return value;
+	};
+	/**
+	* 拉取提交日志（`svn log --xml -v`）。
+	* 必须显式 `-r HEAD:1`：实测默认范围是 `BASE:1`，工作副本落后时几乎拿不到日志。
+	* @author ddj 2026年09月16号 / 2026年09月18号
+	* @param wcRoot 工作副本根
+	* @param target 目标相对路径（'' = 根）
+	* @param limit 条数上限
+	* @param opts stopOnCopy（P1-4）/ range（P1-6）/ showMerged（P1-5，argv `-g`）
+	* @param cap 条数硬上限（P1-7 Show All 传 SVN_LOG_SHOW_ALL_CAP，默认 LOG_CAP）
+	* @returns 日志条目与截断标记
+	*/
+	const logOf = async (wcRoot, target, limit, opts = {}, cap = 500) => {
+		const capped = Math.max(1, Math.min(cap, Math.floor(limit) || 100));
+		const relativeUrl = await relativeUrlOf(wcRoot);
+		const argv = [
+			"log",
+			"-r",
+			opts.range ? String(opts.range.start) + ":" + String(opts.range.end) : "HEAD:1",
+			"-l",
+			String(capped),
+			"--xml",
+			"-v"
+		];
+		if (opts.stopOnCopy) argv.push("--stop-on-copy");
+		if (opts.showMerged) argv.push("-g");
+		if (target) argv.push("--", target);
+		const outcome = await runSvn(wcRoot, argv, READ_GRACE_MS, LOG_OUTPUT_CAP);
+		if (outcome.code !== 0) throw new Error(tailOfText([outcome.stderr, outcome.stdout].filter(Boolean).join("\n")));
+		const parsed = parseLogXml(outcome.stdout, relativeUrl);
+		return {
+			entries: parsed.entries,
+			truncated: parsed.entries.length >= capped,
+			limit: capped
+		};
+	};
+	/**
+	* 读取单文件某版本的左右两侧内容（`cat -r REV` vs `cat -r REV-1`）。
+	*
+	* 左侧在「该路径在该版本不存在」时（实测新增文件报 E195012）返回 null 而非报错：
+	* 这正是「新增」的正常语义，UI 应把左侧渲染为空而不是弹错误。
+	* @author ddj 2026年09月16号
+	* @param wcRoot 工作副本根
+	* @param rel 工作区相对路径
+	* @param revision 目标版本
+	* @returns 双侧内容
+	*/
+	const diffRevSides = async (wcRoot, rel, revision) => {
+		const rightOutcome = await runSvn(wcRoot, [
+			"cat",
+			"-r",
+			String(revision),
+			"--",
+			rel
+		], READ_GRACE_MS);
+		if (rightOutcome.code !== 0) return {
+			left: null,
+			right: null,
+			reason: "not-exist",
+			error: tailOfText(rightOutcome.stderr || rightOutcome.stdout)
+		};
+		const prev = revision - 1;
+		if (prev < 1) return {
+			left: null,
+			right: rightOutcome.stdout,
+			reason: "not-exist"
+		};
+		const leftOutcome = await runSvn(wcRoot, [
+			"cat",
+			"-r",
+			String(prev),
+			"--",
+			rel
+		], READ_GRACE_MS);
+		if (leftOutcome.code !== 0) return {
+			left: null,
+			right: rightOutcome.stdout,
+			reason: "not-exist"
+		};
+		return {
+			left: leftOutcome.stdout,
+			right: rightOutcome.stdout
+		};
+	};
+	/**
+	* 读取单文件两个指定版本的左右两侧内容（P1-2 比较两个修订；与 diffRevSides 同口径）。
+	*
+	* 任一侧 cat 失败返回 null + reason（新增/删除侧为正常业务分支），UI 渲染为空而非报错。
+	* @author ddj 2026年09月17号
+	* @param wcRoot 工作副本根
+	* @param rel 工作区相对路径
+	* @param revA 左侧版本（选中顺序在前）
+	* @param revB 右侧版本（选中顺序在后）
+	* @returns 双侧内容
+	*/
+	const pairSides = async (wcRoot, rel, revA, revB) => {
+		const sides = [];
+		for (const rev of [revA, revB]) {
+			const outcome = await runSvn(wcRoot, [
+				"cat",
+				"-r",
+				String(rev),
+				"--",
+				rel
+			], READ_GRACE_MS);
+			if (outcome.code !== 0) sides.push({
+				rev,
+				text: null,
+				reason: "not-exist",
+				error: tailOfText(outcome.stderr || outcome.stdout)
+			});
+			else sides.push({
+				rev,
+				text: outcome.stdout
+			});
+		}
+		return {
+			left: sides[0].text,
+			right: sides[1].text,
+			reason: sides[0].reason ?? sides[1].reason,
+			error: sides[0].error ?? sides[1].error
+		};
+	};
+	return { handlers: {
+		"svn.status": async (args) => {
+			const sc = await requireSvnSession(ctx, args.sessionId);
+			if ("err" in sc) return {
+				ok: false,
+				error: sc.err
+			};
+			return {
+				ok: true,
+				...await statusOf(sc.cwd, args.force === true)
+			};
+		},
+		"svn.changes": 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) return {
+				ok: false,
+				error: "当前工作区不受 SVN 管理"
+			};
+			if (!status.svnCli) return {
+				ok: false,
+				error: "svn 命令不可用（可在设置页配置 svn 路径）"
+			};
+			try {
+				const result = await changesOf(status.wcRoot, args.force === true);
+				return {
+					ok: true,
+					wcRoot: status.wcRoot,
+					...result
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					error: "读取变更失败：" + String(error)
+				};
+			}
+		},
+		"svn.diffBase": async (args) => {
+			const sc = await requireSvnSession(ctx, args.sessionId);
+			if ("err" in sc) return {
+				ok: false,
+				error: sc.err
+			};
+			const rel = safeRel(args.path);
+			if (rel === null || rel === "") return {
+				ok: false,
+				error: "路径不合法"
+			};
+			const status = await statusOf(sc.cwd);
+			if (!status.managed || !status.wcRoot) return {
+				ok: false,
+				error: "当前工作区不受 SVN 管理"
+			};
+			if (!status.svnCli) return {
+				ok: false,
+				error: "svn 命令不可用（可在设置页配置 svn 路径）"
+			};
+			const fs = ctx.get("fs");
+			if (!fs?.resolve || !fs?.stat || !fs?.readText) return {
+				ok: false,
+				error: "缺少 fs"
+			};
+			try {
+				const target = await fs.resolve(rel, { cwd: sc.cwd });
+				const info = await fs.stat(target);
+				if (!info || info.type !== "file") return {
+					ok: false,
+					error: "文件不存在"
+				};
+				if ((info.size ?? 0) > READ_CAP) return {
+					ok: false,
+					error: "文件过大（>8MB），不支持基线差异"
+				};
+				const working = await fs.readText(target);
+				const outcome = await runSvn(status.wcRoot, [
+					"cat",
+					"-r",
+					"BASE",
+					"--",
+					rel
+				], READ_GRACE_MS);
+				if (outcome.code !== 0) {
+					const text = (outcome.stderr || outcome.stdout).trim();
+					return {
+						ok: true,
+						base: null,
+						working,
+						reason: /pristine|E200009/i.test(text) ? "no-pristine" : "cat-failed",
+						error: tailOfText(text)
+					};
+				}
+				return {
+					ok: true,
+					base: outcome.stdout,
+					working
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					error: "读取基线失败：" + String(error)
+				};
+			}
+		},
+		"svn.revert": async (args) => {
+			return mutate("还原", ["revert", "-R"], args.sessionId, args.paths);
+		},
+		"svn.add": async (args) => {
+			return mutate("加入版本控制", ["add"], args.sessionId, args.paths);
+		},
+		"svn.log": async (args) => {
+			const sc = await requireSvnSession(ctx, args.sessionId);
+			if ("err" in sc) return {
+				ok: false,
+				error: sc.err
+			};
+			const rel = safeRel(args.path);
+			if (rel === null) return {
+				ok: false,
+				error: "路径不合法"
+			};
+			const status = await statusOf(sc.cwd);
+			if (!status.managed || !status.wcRoot) return {
+				ok: false,
+				error: "当前工作区不受 SVN 管理"
+			};
+			if (!status.svnCli) return {
+				ok: false,
+				error: "svn 命令不可用（可在设置页配置 svn 路径）"
+			};
+			try {
+				return {
+					ok: true,
+					...await logOf(status.wcRoot, rel, args.limit ?? 100, {
+						stopOnCopy: args.stopOnCopy === true,
+						showMerged: args.showMerged === true,
+						range: args.startRev && args.endRev ? {
+							start: Math.floor(args.startRev),
+							end: Math.floor(args.endRev)
+						} : null
+					}, SVN_LOG_SHOW_ALL_CAP),
+					target: rel
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					error: "读取日志失败：" + String(error)
+				};
+			}
+		},
+		"svn.diffRev": async (args) => {
+			const sc = await requireSvnSession(ctx, args.sessionId);
+			if ("err" in sc) return {
+				ok: false,
+				error: sc.err
+			};
+			const rel = safeRel(args.path);
+			if (rel === null || rel === "") return {
+				ok: false,
+				error: "路径不合法"
+			};
+			const revision = Number(args.revision);
+			if (!Number.isFinite(revision) || revision < 1) return {
+				ok: false,
+				error: "版本号不合法"
+			};
+			const status = await statusOf(sc.cwd);
+			if (!status.managed || !status.wcRoot) return {
+				ok: false,
+				error: "当前工作区不受 SVN 管理"
+			};
+			if (!status.svnCli) return {
+				ok: false,
+				error: "svn 命令不可用（可在设置页配置 svn 路径）"
+			};
+			try {
+				return {
+					ok: true,
+					...await diffRevSides(status.wcRoot, rel, Math.floor(revision))
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					error: "读取版本差异失败：" + String(error)
+				};
+			}
+		},
+		"svn.diffPair": async (args) => {
+			const sc = await requireSvnSession(ctx, args.sessionId);
+			if ("err" in sc) return {
+				ok: false,
+				error: sc.err
+			};
+			const rel = safeRel(args.path);
+			if (rel === null || rel === "") return {
+				ok: false,
+				error: "路径不合法"
+			};
+			const revA = Number(args.revA);
+			const revB = Number(args.revB);
+			if (!Number.isFinite(revA) || revA < 1 || !Number.isFinite(revB) || revB < 1) return {
+				ok: false,
+				error: "版本号不合法"
+			};
+			const status = await statusOf(sc.cwd);
+			if (!status.managed || !status.wcRoot) return {
+				ok: false,
+				error: "当前工作区不受 SVN 管理"
+			};
+			if (!status.svnCli) return {
+				ok: false,
+				error: "svn 命令不可用（可在设置页配置 svn 路径）"
+			};
+			try {
+				return {
+					ok: true,
+					...await pairSides(status.wcRoot, rel, Math.floor(revA), Math.floor(revB))
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					error: "读取版本差异失败：" + String(error)
+				};
+			}
+		},
+		"svn.diffWorking": async (args) => {
+			const sc = await requireSvnSession(ctx, args.sessionId);
+			if ("err" in sc) return {
+				ok: false,
+				error: sc.err
+			};
+			const rel = safeRel(args.path);
+			if (rel === null || rel === "") return {
+				ok: false,
+				error: "路径不合法"
+			};
+			const revision = Number(args.revision);
+			if (!Number.isFinite(revision) || revision < 1) return {
+				ok: false,
+				error: "版本号不合法"
+			};
+			const status = await statusOf(sc.cwd);
+			if (!status.managed || !status.wcRoot) return {
+				ok: false,
+				error: "当前工作区不受 SVN 管理"
+			};
+			if (!status.svnCli) return {
+				ok: false,
+				error: "svn 命令不可用（可在设置页配置 svn 路径）"
+			};
+			const fs = ctx.get("fs");
+			if (!fs?.resolve || !fs?.stat || !fs?.readText) return {
+				ok: false,
+				error: "缺少 fs"
+			};
+			try {
+				const resolved = await fs.resolve(rel, { cwd: sc.cwd });
+				const info = await fs.stat(resolved);
+				if (!info || info.type !== "file") return {
+					ok: false,
+					error: "文件不存在"
+				};
+				if ((info.size ?? 0) > READ_CAP) return {
+					ok: false,
+					error: "文件过大（>8MB），不支持与工作副本比较"
+				};
+				const working = await fs.readText(resolved);
+				const leftOutcome = await runSvn(status.wcRoot, [
+					"cat",
+					"-r",
+					String(Math.floor(revision)),
+					"--",
+					rel
+				], READ_GRACE_MS);
+				if (leftOutcome.code !== 0) return {
+					ok: true,
+					left: null,
+					right: working,
+					reason: "not-exist",
+					error: tailOfText((leftOutcome.stderr || leftOutcome.stdout).trim())
+				};
+				return {
+					ok: true,
+					left: leftOutcome.stdout,
+					right: working
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					error: "读取工作副本差异失败：" + String(error)
+				};
+			}
+		},
+		"svn.wcRev": async (args) => {
+			const sc = await requireSvnSession(ctx, args.sessionId);
+			if ("err" in sc) return {
+				ok: false,
+				error: sc.err
+			};
+			const rel = safeRel(args.path);
+			if (rel === null || rel === "") return {
+				ok: true,
+				revision: null
+			};
+			const status = await statusOf(sc.cwd);
+			if (!status.managed || !status.wcRoot) return {
+				ok: false,
+				error: "当前工作区不受 SVN 管理"
+			};
+			if (!status.svnCli) return {
+				ok: false,
+				error: "svn 命令不可用（可在设置页配置 svn 路径）"
+			};
+			const outcome = await runSvn(status.wcRoot, [
+				"info",
+				"--xml",
+				"--",
+				rel
+			], READ_GRACE_MS);
+			if (outcome.code !== 0) return {
+				ok: true,
+				revision: null
+			};
+			return {
+				ok: true,
+				revision: parseSvnInfoRevision(outcome.stdout)
+			};
+		},
+		"svn.cleanup": 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) return {
+				ok: false,
+				error: "当前工作区不受 SVN 管理"
+			};
+			if (!status.svnCli) return {
+				ok: false,
+				error: "svn 命令不可用（可在设置页配置 svn 路径）"
+			};
+			const argv = ["cleanup"];
+			if (args.removeUnversioned === true) argv.push("--remove-unversioned");
+			if (args.removeIgnored === true) argv.push("--remove-ignored");
+			try {
+				const outcome = await runSvn(status.wcRoot, argv, MUTATE_GRACE_MS);
+				const result = batchResultOf(outcome.stdout, outcome.stderr, outcome.code, "清理");
+				if (outcome.code !== 0) return {
+					ok: false,
+					error: "清理失败：" + tailOfText(result.output)
+				};
+				changesCache.delete(status.wcRoot);
+				return {
+					ok: true,
+					...result
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					error: "清理失败：" + String(error)
+				};
+			}
+		},
+		"svn.update": async (args) => {
+			const sc = await requireSvnSession(ctx, args.sessionId);
+			if ("err" in sc) return {
+				ok: false,
+				error: sc.err
+			};
+			const rel = safeRel(args.path);
+			if (rel === null) return {
+				ok: false,
+				error: "路径不合法"
+			};
+			const status = await statusOf(sc.cwd);
+			if (!status.managed) return {
+				ok: false,
+				error: "当前工作区不受 SVN 管理"
+			};
+			if (!status.svnCli) return {
+				ok: false,
+				error: "svn 命令不可用（可在设置页配置 svn 路径）"
+			};
+			try {
+				const outcome = await runSvn(sc.cwd, ["update", rel || "."], UPDATE_GRACE_MS);
+				const result = updateResultOf(outcome.stdout, outcome.stderr, outcome.code);
+				if (outcome.code !== 0) return {
+					ok: false,
+					error: "更新失败：" + tailOfText(result.output)
+				};
+				return {
+					ok: true,
+					...result
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					error: "更新失败：" + String(error)
+				};
+			}
+		},
+		"svn.tortoise": async (args) => {
+			const sc = await requireSvnSession(ctx, args.sessionId);
+			if ("err" in sc) return {
+				ok: false,
+				error: sc.err
+			};
+			const action = args.action;
+			if (action !== "update" && action !== "commit" && action !== "log" && action !== "diff" && action !== "blame" && action !== "revert") return {
+				ok: false,
+				error: "未知动作: " + String(action)
+			};
+			const rel = safeRel(args.path);
+			if (rel === null) return {
+				ok: false,
+				error: "路径不合法"
+			};
+			const status = await statusOf(sc.cwd);
+			if (!status.managed) return {
+				ok: false,
+				error: "当前工作区不受 SVN 管理"
+			};
+			if (!status.tortoise) return {
+				ok: false,
+				error: "TortoiseProc.exe 不可用（仅 Windows；可在设置页配置目录）"
+			};
+			const fs = ctx.get("fs");
+			if (!fs?.resolve || !fs?.stat || !fs?.processPath) return {
+				ok: false,
+				error: "缺少 fs"
+			};
+			try {
+				const target = await fs.resolve(rel || ".", { cwd: sc.cwd });
+				if (!await fs.stat(target)) return {
+					ok: false,
+					error: "路径不存在"
+				};
+				const abs = fs.processPath(target);
+				launchTortoise(status.tortoiseExe, action, abs);
+				return {
+					ok: true,
+					launched: abs
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					error: "启动 TortoiseSVN 失败：" + String(error)
+				};
+			}
+		}
+	} };
+}
+//#endregion
+//#region src/index.ts
+/**
+* @dsh-external 生态 → dsh-vscode-mode：DSH 上的类 VSCode 编码体验（Host 半入口）。
+* 职责：装配 capture（tools/result 捕获 edit/write 差异）、RPC 分发（edrv.* / mcp.* / vscode.* / compat）、
+*       webServer 路由（/edrv/rpc、/edrv/assets/*、/edrv/vendor/*）、工作区旁车持久化、
+*       兼容层装配（依赖守卫 + 重复装配自诊断 + 启动日志兼容性报告）。
+* 结构：shared/（双面契约） + model/store/capture/workspace/revert/registry/rpc/routes/compat（host 模块）
+*       + log/debugLog（统一日志：bindHostLog 绑定 ctx.logger，edrv.debug 诊断文件通道）。
+* 作者 ddj 2026-08-20
+*/
+const name = "dsh-vscode-mode";
+const inject = [
+	"sessions",
+	"fs",
+	"webServer",
+	"loader",
+	"tools",
+	"workspaceRegistry",
+	"agents"
+];
+/**
+* 装配插件：挂事件监听、注册路由、安装兼容层。
+* @author ddj 2026年08月20号
+* @param ctx DSH 上下文（sessions/fs/webServer 由 inject 提供；sandboxPolicy/subprocess 惰性获取）
+* @param config 插件配置（可选 imageDir 覆盖图标目录）
+*/
+function apply(ctx, config) {
+	bindHostLog(ctx);
+	const registry = /* @__PURE__ */ new Map();
+	const searcher = newSearcher(ctx);
+	const contentSearcher = newContentSearcher(ctx);
+	/** LSP 服务器管理器（语言智能：跳转/引用/大纲；诊断行带模块内前缀如 [lsp-manager]）。 */
+	const lspManager = createLspManager((line) => log.debug(line));
+	/** 兼容性警告收集（route 护栏等写入，启动日志一并输出）。 */
+	const warnings = [];
+	/** 设置状态（fileOpenTool + AI 补全配置读写；settings 不可用时内存态降级）。 */
+	const openSettings = setupOpenSettings(ctx, config, () => {});
+	/** LSP 配置为配置值模式：插件组合配置 + 会话内运行时覆盖（原 settings section 命名空间不合法，见 lsp/config.ts）。 */
+	/** 规则注入 section（~/.dsh/rules 与 <工作区>/.dsh/rules；旧版 DSH 无 systemPrompt 时静默降级）。 */
+	const rulesInstalled = installRulesSection(ctx);
+	if (!rulesInstalled) log.warn("未检测到 systemPrompt 服务，规则仅可管理不注入");
+	/** 插件自带技能组（<包根>/skills，惰性获取 skills 服务；返回值仅表示"已调度"，实际结果见 skillGroupState）。 */
+	const skillsDispatched = installSkillGroup(ctx);
+	if (!skillsDispatched) log.warn("技能组未调度，插件技能组不可用");
+	/** LSP RPC 与会话清理（一次性创建，tracker 状态跨请求保留）。 */
+	const lspRpc = createLspRpc({
+		ctx,
+		pluginConfig: config,
+		manager: lspManager
+	});
+	const lspHandlers = lspRpc.handlers;
+	const aiHandlers = createAiRpc({
+		ctx,
+		settings: openSettings
+	}).handlers;
+	const svnHandlers = createSvnRpc({
 		ctx,
 		settings: openSettings
 	}).handlers;
@@ -11954,7 +13738,7 @@ function apply(ctx, config) {
 		const sid = session?.id;
 		if (typeof sid === "string") lspRpc.disposeSession(sid);
 	});
-	registerRoutes(ctx, config, (method, args) => handleRpc(ctx, registry, method, args, searcher, contentSearcher, lspHandlers, aiHandlers, fileVersions), (warning) => warnings.push(warning));
+	registerRoutes(ctx, config, (method, args) => handleRpc(ctx, registry, method, args, searcher, contentSearcher, lspHandlers, aiHandlers, fileVersions, svnHandlers), (warning) => warnings.push(warning));
 	installIsolation(ctx);
 	ctx.effect(() => shellMenuLifecycle(ctx));
 	sweepTreeCache();