dsh-vscode-mode 0.8.0 → 0.9.0

package/lib/index.js

@@ -191,6 +191,17 @@ function tortoiseLaunchArgv(exe, action, absPath) {
 		"/path:" + absPath
 	];
 }
+/**
+* 是否属于「工作副本变更」（`normal`/`external` 不算；`ignored` 由开关决定是否收录）。
+* @author ddj 2026年09月16号
+* @param entry 变更条目
+* @returns 是否计入变更清单
+*/
+function isSvnChange(entry) {
+	if (entry.status === "normal" || entry.status === "external") return false;
+	if (entry.status === "ignored") return false;
+	return true;
+}
 /** W2-6 内容护栏嗅探窗（字符数；NUL/U+FFFD 只看前 8K，全量扫描大文本得不偿失）。 */
 const GUARD_SNIFF_CHARS = 8192;
 /**
@@ -208,6 +219,148 @@ function contentGuardOf(text) {
 	if (window.includes("�")) return { encodingHint: true };
 	return {};
 }
+/**
+* 分区名（changelist 名）合法性校验：返回错误文案，合法返回 null。
+* 规则：去首尾空白后非空、不以 `-` 开头（防被 svn 当成选项解析）、长度 ≤ 上限。
+* client 预检 + host 权威校验共用，避免两处漂移。
+* @author ddj 2026年09月23号
+* @param name 用户输入的分区名
+* @returns 错误文案；合法为 null
+*/
+function svnChangelistNameErrorOf(name) {
+	const trimmed = String(name ?? "").trim();
+	if (!trimmed) return "分区名不能为空";
+	if (trimmed.startsWith("-")) return "分区名不能以 - 开头";
+	if (trimmed.length > 64) return "分区名最长 64 字符";
+	return null;
+}
+/** AI 方案分析条目数上限（超出仅按路径分析并标记截断）。 */
+const AI_PLAN_PATHS_CAP = 1500;
+/** AI 方案 diff 上下文字节上限（超出降级 paths-only）。 */
+const AI_PLAN_DIFF_CAP = 2097152;
+/** AI 方案 LLM 调用超时（毫秒；推理模型 + 高思考档位 + diff 上下文实测 120s 不够（huoshan/glm-5.3-flash），放宽到 5 分钟）。 */
+const AI_PLAN_TIMEOUT_MS = 3e5;
+/** 松散数组取值（非数组按空处理；AI 输出形状容错）。 */
+function listOf(raw) {
+	return Array.isArray(raw) ? raw : [];
+}
+/**
+* AI 方案条目解析（宽松：接受 `{path, reason}` 或裸路径字符串；反斜杠归一为 `/`）。
+* @author ddj 2026年09月23号
+* @param raw 原始元素
+* @returns 解析结果（不可解析返回 null——非路径垃圾不作数）
+*/
+function planItemOf(raw) {
+	const obj = typeof raw === "string" ? { path: raw } : raw && typeof raw === "object" ? raw : null;
+	if (!obj) return null;
+	const path = typeof obj.path === "string" ? obj.path.trim().replace(/\\/g, "/") : "";
+	if (!path) return null;
+	const reason = typeof obj.reason === "string" ? obj.reason.trim().slice(0, 120) : "";
+	return reason ? {
+		path,
+		reason
+	} : { path };
+}
+/**
+* AI 方案分组解析（宽松：name + paths 数组；路径逐个规范化）。
+* @author ddj 2026年09月23号
+* @param raw 原始元素
+* @returns 解析结果（无合法名返回 null）
+*/
+function planGroupOf(raw) {
+	if (!raw || typeof raw !== "object") return null;
+	const obj = raw;
+	const name = typeof obj.name === "string" ? obj.name.trim() : "";
+	if (!name) return null;
+	const paths = [];
+	for (const p of listOf(obj.paths)) {
+		const path = typeof p === "string" ? p.trim().replace(/\\/g, "/") : "";
+		if (path) paths.push(path);
+	}
+	const reason = typeof obj.reason === "string" ? obj.reason.trim().slice(0, 120) : "";
+	return reason ? {
+		name,
+		paths,
+		reason
+	} : {
+		name,
+		paths
+	};
+}
+/**
+* AI 方案归一化（纯函数）：以真实变更清单为白名单裁决三段建议。
+* - 幻觉路径（不在清单中）/状态不符（revert 须 versioned、ignore 须 unversioned）→ 丢弃并计数；
+* - 互斥优先级 revert > ignore > group（同一路径至多归一段，还原后条目消失故优先）；
+* - 组名过 svnChangelistNameErrorOf、组数上限 AI_PLAN_GROUPS_CAP，空组剔除。
+* @author ddj 2026年09月23号
+* @param raw AI 输出解析结果（形状不定，内部容错）
+* @param entries 真实变更清单（白名单来源）
+* @returns 归一化方案与被丢弃的候选路径数
+*/
+function normalizeAiPlan(raw, entries) {
+	const plan = {
+		groups: [],
+		reverts: [],
+		ignores: []
+	};
+	if (!raw || typeof raw !== "object") return {
+		plan,
+		dropped: 0
+	};
+	const byPath = /* @__PURE__ */ new Map();
+	for (const entry of entries) if (entry?.path) byPath.set(entry.path, entry);
+	const claimed = /* @__PURE__ */ new Set();
+	let dropped = 0;
+	/** 单条裁决：真实存在 + 状态符合 + 未被更高优先级段认领。 */
+	const accept = (path, wantVersioned) => {
+		const entry = byPath.get(path);
+		if (!entry || !isSvnChange(entry) || entry.versioned !== wantVersioned || claimed.has(path)) {
+			dropped++;
+			return false;
+		}
+		claimed.add(path);
+		return true;
+	};
+	const src = raw;
+	for (const el of listOf(src.reverts)) {
+		const item = planItemOf(el);
+		if (item && accept(item.path, true)) plan.reverts.push(item);
+	}
+	for (const el of listOf(src.ignores)) {
+		const item = planItemOf(el);
+		if (item && accept(item.path, false)) plan.ignores.push(item);
+	}
+	for (const el of listOf(src.groups)) {
+		const group = planGroupOf(el);
+		if (!group) {
+			const obj = el && typeof el === "object" ? el : null;
+			for (const p of listOf(obj?.paths)) if (typeof p === "string" && p.trim()) dropped++;
+			continue;
+		}
+		const nameError = svnChangelistNameErrorOf(group.name) !== null;
+		const over = plan.groups.length >= 20;
+		const valid = [];
+		for (const path of group.paths) {
+			if (nameError || over) {
+				dropped++;
+				continue;
+			}
+			if (accept(path, true)) valid.push(path);
+		}
+		if (valid.length && !nameError && !over) plan.groups.push(group.reason ? {
+			name: group.name,
+			paths: valid,
+			reason: group.reason
+		} : {
+			name: group.name,
+			paths: valid
+		});
+	}
+	return {
+		plan,
+		dropped
+	};
+}
 //#endregion
 //#region src/shared/nativeOpen.ts
 /**
@@ -424,16 +577,19 @@ function bindHostLog(ctx) {
 * 插件 Config schema，见 runSettingsInstall 四策略：legacy/service/forms/none）。
 * 缺失/任一策略失败时插件仍可加载（fileOpenTool 降级为配置值，compat 报告可见），
 * 全程 try/catch，不产生未捕获 rejection。
-* 作者 ddj 2026年08月24号 / 2026年08月26号 / 2026年09月02号 / 2026年09月22号
+* 作者 ddj 2026年08月24号 / 2026年08月26号 / 2026年09月02号 / 2026年09月22号 / 2026年09月23号
 */
 const FILE_OPEN_SETTINGS_NS = "dsh-vscode-mode";
 const FILE_OPEN_DEFAULT = "auto";
-/** AI 内联补全配置默认值（默认关闭；路由空 = 自动；档位空 = 跟随模型默认）。 */
+/** AI 配置默认值（补全默认关；路由空 = 自动；档位空 = 跟随模型默认；任务模型空 = 跟随补全配置）。 */
 const AI_CONFIG_DEFAULT = {
 	enabled: false,
 	provider: "",
 	model: "",
-	effort: ""
+	effort: "",
+	taskProvider: "",
+	taskModel: "",
+	taskEffort: ""
 };
 let depsPromise;
 /**
@@ -745,46 +901,132 @@ async function updateSection(provider, ns, patch, expectedRevision) {
 * 字段集 = fileOpenTool/keybindings/sidebarMinWidth/maxOpenEditors/integrationBaseUrl/
 * aiInline/aiProvider/aiModel/aiEffort/svnPath/tortoisePath/nativeOpenExts，全部带默认值
 * （Config 启动校验在 undefined/空配置下自动填充，rc/alpha 两代 cordis 均通过）。
-* @author ddj 2026年09月22号
+* options.volatile：DSH 0.1.7 线的 Config 导出专用——SettingsForms.describe 只下发
+* 含 volatile 字段的 entry（volatileForm 门槛），不标记则 ns 永不出现在 describe、
+* client configForms 恒 unavailable；且字段须位于固定 object 路径（keybindings 整个
+* object 标记、子键不标）。section 安装路径（legacy/service）**不标**：rc/0.1.6 的
+* register→resolve 无该门槛，标了反而让 scope.get() 返回引用污染读取。
+* 标记经 markVolatile 能力守卫：z 无 .volatile()（旧 schemastery）或调用抛错时保持
+* 原字段并记录观测态，模块加载绝不抛错（降级=维持现状，兼容性报告可见）。
+* @author ddj 2026年09月22号（2026年09月23号 增补 options.volatile 与观测）
 * @param z schemastery 命名空间（静态 import 或动态加载均可）
+* @param options volatile：是否按 0.1.7 Config 语义标记字段
 * @returns schemastery object schema
 */
-function buildSettingsSchema(z) {
-	return z.object({
-		fileOpenTool: z.string().default(FILE_OPEN_DEFAULT),
-		keybindings: z.object(keybindingsShape(z)).default({ ...KEYBINDING_DEFAULTS }),
-		sidebarMinWidth: z.number().default(300),
-		maxOpenEditors: z.number().default(10),
-		integrationBaseUrl: z.string().default(INTEGRATION_BASE_DEFAULT),
-		aiInline: z.boolean().default(AI_CONFIG_DEFAULT.enabled),
-		aiProvider: z.string().default(AI_CONFIG_DEFAULT.provider),
-		aiModel: z.string().default(AI_CONFIG_DEFAULT.model),
-		aiEffort: z.string().default(AI_CONFIG_DEFAULT.effort),
-		svnPath: z.string().default(""),
-		tortoisePath: z.string().default(TORTOISE_DIR_DEFAULT),
-		nativeOpenExts: z.string().default(DEFAULT_NATIVE_CSV)
-	});
+function buildSettingsSchema(z, options) {
+	const wantVolatile = options?.volatile === true;
+	let marked = 0;
+	const withVol = (field) => {
+		if (!wantVolatile) return field;
+		const result = markVolatile(field);
+		if (result.marked) marked += 1;
+		return result.field;
+	};
+	const shape = {
+		fileOpenTool: withVol(z.string().default(FILE_OPEN_DEFAULT)),
+		keybindings: withVol(z.object(keybindingsShape(z)).default({ ...KEYBINDING_DEFAULTS })),
+		sidebarMinWidth: withVol(z.number().default(300)),
+		maxOpenEditors: withVol(z.number().default(10)),
+		integrationBaseUrl: withVol(z.string().default(INTEGRATION_BASE_DEFAULT)),
+		aiInline: withVol(z.boolean().default(AI_CONFIG_DEFAULT.enabled)),
+		aiProvider: withVol(z.string().default(AI_CONFIG_DEFAULT.provider)),
+		aiModel: withVol(z.string().default(AI_CONFIG_DEFAULT.model)),
+		aiEffort: withVol(z.string().default(AI_CONFIG_DEFAULT.effort)),
+		aiTaskProvider: withVol(z.string().default(AI_CONFIG_DEFAULT.taskProvider)),
+		aiTaskModel: withVol(z.string().default(AI_CONFIG_DEFAULT.taskModel)),
+		aiTaskEffort: withVol(z.string().default(AI_CONFIG_DEFAULT.taskEffort)),
+		svnPath: withVol(z.string().default("")),
+		tortoisePath: withVol(z.string().default(TORTOISE_DIR_DEFAULT)),
+		nativeOpenExts: withVol(z.string().default(DEFAULT_NATIVE_CSV))
+	};
+	if (wantVolatile) configVolatile = {
+		requested: true,
+		marked,
+		total: Object.keys(shape).length
+	};
+	return z.object(shape);
+}
+let configVolatile = {
+	requested: false,
+	marked: 0,
+	total: 0
+};
+/**
+* 读取 Config volatile 标记观测（0.1.7 设置页可用性的构建期判据）。
+* @author ddj 2026年09月23号
+* @returns 观测态（requested=是否按 Config 语义构建；marked/total=成功标记字段数）
+*/
+function configVolatileState() {
+	return configVolatile;
+}
+/**
+* 为已完成 default 链的 schema 字段追加 volatile 标记（能力守卫）。
+* @author ddj 2026年09月23号
+* @param field schema 字段（两代 schemastery 兼容面，可能没有 volatile 方法）
+* @returns 处理后字段与是否成功标记
+*/
+function markVolatile(field) {
+	const target = field;
+	if (!target || typeof target.volatile !== "function") return {
+		field,
+		marked: false
+	};
+	try {
+		return {
+			field: target.volatile(),
+			marked: true
+		};
+	} catch {
+		return {
+			field,
+			marked: false
+		};
+	}
+}
+/** cosmokit volatile 引用写协议符号（Symbol.for 跨拷贝一致，同 cosmokit.isVolatile 判据）。 */
+const VOLATILE_WRITE = Symbol.for("cosmokit.volatile.write");
+/**
+* 解引用 0.1.7 volatile 配置引用（普通值直传）。
+* cordis resolveConfig 会把 .volatile() 字段解析成稳定引用，直接读会得到引用对象；
+* 不解引用则配置回退值全部落入默认值分支。
+* @author ddj 2026年09月23号
+* @param value 配置字段原始值
+* @returns 引用的当前快照，或原值
+*/
+function unref(value) {
+	if (value !== null && typeof value === "object" && VOLATILE_WRITE in value) return value.get();
+	return value;
+}
+/**
+* 读插件组合配置字段并解引用（配置读取唯一入口）。
+* @author ddj 2026年09月23号
+* @param config 插件组合配置（apply 收到的 Config 值）
+* @param key 字段名
+* @returns 字段值（引用已解包；缺失为 undefined）
+*/
+function configField(config, key) {
+	return unref(config?.[key]);
 }
 function normalizeValue(value) {
 	if (typeof value !== "string" || value.trim() === "") return FILE_OPEN_DEFAULT;
 	return value.trim();
 }
 function configValue(config) {
-	return normalizeValue(config?.fileOpenTool);
+	return normalizeValue(configField(config, "fileOpenTool"));
 }
 /** 配置/设置里的深链基址（缺省/非法回退默认值）。 */
 function baseValueOf(config) {
-	const raw = config?.integrationBaseUrl;
+	const raw = configField(config, "integrationBaseUrl");
 	return typeof raw === "string" && raw.trim() ? raw.trim() : INTEGRATION_BASE_DEFAULT;
 }
 /** 配置/设置里的 svn CLI 覆盖（空 = 从 PATH 解析 'svn'）。 */
 function svnPathValueOf(config) {
-	const raw = config?.svnPath;
+	const raw = configField(config, "svnPath");
 	return typeof raw === "string" ? raw.trim() : "";
 }
 /** 配置/设置里的 TortoiseSVN 目录（空 = 默认安装目录）。 */
 function tortoiseDirValueOf(config) {
-	const raw = config?.tortoisePath;
+	const raw = configField(config, "tortoisePath");
 	return typeof raw === "string" && raw.trim() ? raw.trim() : TORTOISE_DIR_DEFAULT;
 }
 /**
@@ -816,7 +1058,10 @@ function aiValueOf(stored) {
 		enabled: raw.aiInline === true,
 		provider: typeof raw.aiProvider === "string" ? raw.aiProvider : AI_CONFIG_DEFAULT.provider,
 		model: typeof raw.aiModel === "string" ? raw.aiModel : AI_CONFIG_DEFAULT.model,
-		effort: typeof raw.aiEffort === "string" ? raw.aiEffort : AI_CONFIG_DEFAULT.effort
+		effort: typeof raw.aiEffort === "string" ? raw.aiEffort : AI_CONFIG_DEFAULT.effort,
+		taskProvider: typeof raw.aiTaskProvider === "string" ? raw.aiTaskProvider : AI_CONFIG_DEFAULT.taskProvider,
+		taskModel: typeof raw.aiTaskModel === "string" ? raw.aiTaskModel : AI_CONFIG_DEFAULT.taskModel,
+		taskEffort: typeof raw.aiTaskEffort === "string" ? raw.aiTaskEffort : AI_CONFIG_DEFAULT.taskEffort
 	};
 }
 /**
@@ -876,8 +1121,11 @@ function setupOpenSettings(ctx, config, onChange) {
 	});
 	ctx.inject?.(["settings"], (settingsCtx) => {
 		provider = settingsCtx.get("settings");
-		aiSync();
-		svnSync(storedValue());
+		const stored = storedValue();
+		const section = stored;
+		if (section?.fileOpenTool !== void 0) notify(section.fileOpenTool);
+		aiCurrent = stored !== void 0 ? aiValueOf(stored) : aiCurrent;
+		svnSync(stored);
 		syncRevision();
 	});
 	return {
@@ -916,6 +1164,18 @@ function setupOpenSettings(ctx, config, onChange) {
 				stored.effort = patch.effort;
 				body.aiEffort = patch.effort;
 			}
+			if (patch.taskProvider !== void 0) {
+				stored.taskProvider = patch.taskProvider;
+				body.aiTaskProvider = patch.taskProvider;
+			}
+			if (patch.taskModel !== void 0) {
+				stored.taskModel = patch.taskModel;
+				body.aiTaskModel = patch.taskModel;
+			}
+			if (patch.taskEffort !== void 0) {
+				stored.taskEffort = patch.taskEffort;
+				body.aiTaskEffort = patch.taskEffort;
+			}
 			if (!(await updateSection(provider, "dsh-vscode-mode", body, expectedRevision)).ok) {
 				aiCurrent = stored;
 				return aiCurrent;
@@ -2082,8 +2342,10 @@ function detectGuards(ctx) {
 	}];
 }
 /** 已实测覆盖的最高 DSH 版本（适配矩阵上界，超过则提示，见 buildReport）。 */
-const TESTED_DSH_MAX = "0.1.7-alpha.1";
-/** 版本适配机制状态行：DSH 版本探测 + 设置 section 安装策略。 */
+const TESTED_DSH_MAX = "0.1.7-alpha.2";
+/** Config volatile 标记起效的版本线（此前设置走 section 安装，与 volatile 无关）。 */
+const CONFIG_VOLATILE_MIN = "0.1.7-alpha.1";
+/** 版本适配机制状态行：DSH 版本探测 + 设置 section 安装策略 + Config volatile 标记。 */
 function versionAdapters(dshVersion) {
 	const adapters = [];
 	const parsed = parseDshVersion(dshVersion);
@@ -2108,11 +2370,20 @@ function versionAdapters(dshVersion) {
 		active: strategy === "legacy" || strategy === "service" || strategy === "forms",
 		note: settingsInstallNote()
 	});
+	const volatileState = configVolatileState();
+	if (volatileState.requested) {
+		const volatileOk = volatileState.total > 0 && volatileState.marked === volatileState.total;
+		adapters.push({
+			name: "Config volatile 字段（0.1.7 设置页）",
+			active: volatileOk,
+			note: volatileOk ? volatileState.marked + "/" + volatileState.total + " 已标记（SettingsForms 可下发本插件 ns）" : volatileState.marked + "/" + volatileState.total + " 已标记：schemastery 依赖过旧无 .volatile()，0.1.7 设置页不可用"
+		});
+	}
 	return adapters;
 }
 /**
 * 构建完整兼容性报告（RPC 与启动日志共用）。
-* @author ddj 2026年08月24号 / 2026年09月02号
+* @author ddj 2026年08月24号 / 2026年09月02号 / 2026年09月23号
 * @param ctx DSH host 上下文
 * @param options 测试注入：depsAvailable 跳过动态导入、version 固定插件版本、dshVersion 固定 DSH 版本
 * @returns 兼容性报告
@@ -2128,7 +2399,10 @@ 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.7-alpha.1）：设置 API 按能力探测运行，异常时请回报适配矩阵");
+	if (parsed && testedMax && compareDshVersions(parsed, testedMax) > 0) warnings.push("DSH " + dshVersion + " 高于已实测版本（0.1.7-alpha.2）：设置 API 按能力探测运行，异常时请回报适配矩阵");
+	const volatileState = configVolatileState();
+	const volatileMin = parseDshVersion(CONFIG_VOLATILE_MIN);
+	if (volatileState.requested && volatileState.marked < volatileState.total && parsed && volatileMin && compareDshVersions(parsed, volatileMin) >= 0) warnings.push("插件 Config volatile 标记不完整（" + volatileState.marked + "/" + volatileState.total + "）：@deepseek-ai/schemastery 依赖过旧，0.1.7 设置页不可用（重装插件依赖后重启 DSH）");
 	for (const guard of guards) if (!guard.active && guard.note) warnings.push(guard.note);
 	return {
 		pluginVersion: options?.version ?? pluginVersionOf(),
@@ -2530,7 +2804,7 @@ function normalizeRecord(raw) {
 			...Number.isInteger(item.beforeEnd) ? { beforeEnd: item.beforeEnd } : {}
 		};
 	}) : [];
-	const toolName = r.toolName === "write" ? "write" : "edit";
+	const toolName = r.toolName === "write" || r.toolName === "remote_ssh_write" ? r.toolName : "edit";
 	const rawDecisions = r.decisions && typeof r.decisions === "object" ? r.decisions : {};
 	const call = rawDecisions.call === "accepted" || rawDecisions.call === "rejected" ? rawDecisions.call : "pending";
 	const rawPerHunk = Array.isArray(rawDecisions.perHunk) ? rawDecisions.perHunk : [];
@@ -2989,6 +3263,149 @@ function bucketOf(registry, ctx, cwd) {
 	});
 }
 //#endregion
+//#region src/remoteWorkspace.ts
+/**
+* dsh-vscode-mode host — dsh-remote-ssh 远程工作区探测与镜像↔远端路径映射。
+* 背景（issue #7）：dsh-remote-ssh 的「原生远程工作区」cwd 指向本机镜像目录
+* （如 ~/.dsh/remote-workspaces/<id>，根下含 .remote-ssh.json {profileId, host,
+* user, remotePath}），agent 的 remote_ssh_write 直写远端；差异审查需要把
+* 远端参数路径映射回镜像（捕获/读/决策复用本地链路），并把展示路径翻译成远端形态。
+* 判据与上游 dsh-remote-ssh 的 findMirrorRoot 对齐（host/user/remotePath 必填、
+* 向上 ≤8 层有界）；纯函数为主，node:fs 仅用于标记读取（带 60s TTL 缓存）。
+* 作者 ddj 2026年09月23号
+*/
+/** dsh-remote-ssh 工作区标记文件名。 */
+const MARKER = ".remote-ssh.json";
+/** 向上探测的最大层数（含 cwd 自身；与上游 findMirrorRoot 的 8 层有界一致）。 */
+const MAX_DEPTH = 8;
+/** 探测结果 TTL（edrv.list 为 5s 轮询，避免每轮都做文件 IO）。 */
+const TTL_MS = 6e4;
+/** cwd → { at, ws } 探测缓存（含阴性结果）。 */
+const cache$2 = /* @__PURE__ */ new Map();
+/**
+* 标记内容 → 远程工作区（host/user/remotePath 缺任一字段判非法，与上游一致）。
+* @author ddj 2026年09月23号
+* @param root 标记所在目录
+* @param raw 标记文件文本
+* @returns 合法返回 RemoteWs；非法返回 null
+*/
+function markerWsOf(root, raw) {
+	try {
+		const info = JSON.parse(raw);
+		if (typeof info.host !== "string" || !info.host) return null;
+		if (typeof info.user !== "string" || !info.user) return null;
+		if (typeof info.remotePath !== "string" || !info.remotePath) return null;
+		const ws = {
+			root,
+			host: info.host,
+			user: info.user,
+			remotePath: info.remotePath
+		};
+		if (typeof info.profileId === "string" && info.profileId) ws.profileId = info.profileId;
+		return ws;
+	} catch {
+		return null;
+	}
+}
+/**
+* 从 cwd 起向上有界探测标记（不走缓存）。
+* @author ddj 2026年09月23号
+* @param cwd 会话工作区根
+* @returns 命中合法标记返回 RemoteWs；否则 null
+*/
+function walkRemoteWs(cwd) {
+	let dir = cwd;
+	for (let i = 0; i < MAX_DEPTH; i++) {
+		try {
+			const ws = markerWsOf(dir, readFileSync(join(dir, MARKER), "utf8"));
+			if (ws) return ws;
+		} catch {}
+		const parent = dirname(dir);
+		if (parent === dir) break;
+		dir = parent;
+	}
+	return null;
+}
+/**
+* 探测工作区是否为 dsh-remote-ssh 远程工作区（cwd 或向上 ≤8 层找 .remote-ssh.json）。
+* 结果按 cwd 缓存 60s（含阴性）；标记变更后可用 clearWsCache 立即重置。
+* @author ddj 2026年09月23号
+* @param cwd 会话工作区根（可空）
+* @returns 远程工作区信息；非远程或标记非法返回 null
+*/
+function findRemoteWs(cwd) {
+	if (!cwd) return null;
+	const now = Date.now();
+	const hit = cache$2.get(cwd);
+	if (hit && now - hit.at < TTL_MS) return hit.ws;
+	const ws = walkRemoteWs(cwd);
+	cache$2.set(cwd, {
+		at: now,
+		ws
+	});
+	return ws;
+}
+/**
+* 前缀剥离：path 必须严格位于 root 之下；等于 root 或不匹配返回 null。
+* @author ddj 2026年09月23号
+* @param path 待剥离路径（posix 形态）
+* @param root 前缀（posix 形态、无尾斜杠）
+* @returns 相对段；不匹配返回 null
+*/
+function prefixRel(path, root) {
+	if (path === root || !path.startsWith(root + "/")) return null;
+	return path.slice(root.length + 1);
+}
+/**
+* 远端参数路径 → 相对远端工作区目录的相对段。
+* 支持：相对路径（工具语义即基于远端工作区目录）、绝对路径且 remotePath 为绝对
+* 形态并为其前缀、`~` 形态且 remotePath 同为 `~` 前缀；Windows 盘符形态按
+* 非远端语义拒绝。含 `..` 逃逸或空相对段返回 null。
+* @author ddj 2026年09月23号
+* @param argPath remote_ssh_write 的 path 参数
+* @param ws 远程工作区
+* @returns posix 相对段；不可映射返回 null
+*/
+function remoteRelOf(argPath, ws) {
+	const path = argPath.replace(/\\/g, "/").replace(/^\.\//, "");
+	if (!path) return null;
+	const root = ws.remotePath.replace(/\\/g, "/").replace(/\/+$/, "");
+	if (!root) return null;
+	let rel;
+	if (path.startsWith("/")) rel = root.startsWith("/") ? prefixRel(path, root) : null;
+	else if (path === "~" || path.startsWith("~/")) rel = root.startsWith("~/") ? prefixRel(path, root) : null;
+	else if (/^[A-Za-z]:\//.test(path)) rel = null;
+	else rel = path;
+	if (rel === null || rel.split("/").some((seg) => seg === "..")) return null;
+	return rel;
+}
+/**
+* 远端工具参数路径 → 本机镜像绝对路径。
+* @author ddj 2026年09月23号
+* @param argPath remote_ssh_write 的 path 参数
+* @param ws 远程工作区
+* @returns 镜像内绝对路径；镜像外/前缀形态不一致/逃逸返回 null
+*/
+function mirrorTargetOf(argPath, ws) {
+	const rel = remoteRelOf(argPath, ws);
+	return rel === null ? null : join(ws.root, rel);
+}
+/**
+* 镜像内绝对路径 → 远端展示路径（remotePath + 相对段，posix 拼接）。
+* @author ddj 2026年09月23号
+* @param mirrorAbs 镜像内绝对路径（通常是记录 path）
+* @param ws 远程工作区
+* @returns 远端路径；不在镜像根下返回 null（调用方回落原 path）
+*/
+function remoteDisplayOf(mirrorAbs, ws) {
+	const path = mirrorAbs.replace(/\\/g, "/");
+	const root = ws.root.replace(/\\/g, "/").replace(/\/+$/, "");
+	if (!root) return null;
+	const rel = prefixRel(path, root);
+	if (rel === null || rel.split("/").some((seg) => seg === "..")) return null;
+	return ws.remotePath.replace(/\/+$/, "") + "/" + rel;
+}
+//#endregion
 //#region src/tree.ts
 /** 目录在文件前、名称按小写字母序的比较器（对齐 VSCode 资源管理器习惯）。 */
 function entryOrder(a, b) {
@@ -3443,6 +3860,16 @@ async function listDirCached(ctx, cwd, rel, force) {
 }
 //#endregion
 //#region src/capture.ts
+/**
+* dsh-vscode-mode host — 捕获层：监听 tools/result，把 edit/write/remote_ssh_write
+* 差异落成审查记录。
+* 迁移自原 src/index.ts 的 tools/result 处理；2026-09-23（issue #7）增补
+* remote_ssh_write：远端工作区会话里 agent 直写远端的全量覆写——before 取本地
+* 镜像快照、after 取参数 content，捕获后把同一内容**写穿**回镜像（node:fs 直写，
+* 刻意不走 ctx.fs，避开 dsh-remote-ssh 写桥的重复推送与补丁次序问题），使镜像 =
+* 远端最新内容，读/stale/决策口径与远端一致。
+* 作者 ddj 2026-08-20（2026-09-23 扩展 remote_ssh_write 捕获）
+*/
 /** 校验并提取工具 result meta 中的文件 hunk。 */
 function validHunks(raw) {
 	if (!Array.isArray(raw)) return [];
@@ -3480,8 +3907,190 @@ function fallbackHunks(toolName, args, before, after, create) {
 	return [];
 }
 /**
-* 捕获一次工具执行结果（tools/result）：edit/write 成功时构造记录、
-* 递增文件批次、融合归档被后续修改取代的旧差异、落盘。
+* 是否为纳入审查的编辑类工具（本地 edit/write + 远端 remote_ssh_write）。
+* @author ddj 2026年09月23号
+* @param name 工具名
+* @returns 纳入审查返回 true
+*/
+function isCapturable(name) {
+	return name === "edit" || name === "write" || name === "remote_ssh_write";
+}
+/**
+* 本地 edit/write 执行结果 → 审查记录（原 captureToolResult 主体语义不变）。
+* @author ddj 2026年09月23号
+* @param exec 工具执行描述
+* @param args 工具参数
+* @param result 工具执行结果
+* @returns 记录；hunk 为空或缺 callId 返回 null
+*/
+function buildLocalRecord(exec, args, result) {
+	const value = result.value;
+	const path = value && typeof value.path === "string" ? value.path : args.file_path;
+	if (typeof path !== "string" || !path) return null;
+	const before = value && typeof value.before === "string" ? value.before : null;
+	const after = value && typeof value.after === "string" ? value.after : typeof args.content === "string" ? args.content : null;
+	const create = exec.name === "write" && !!value && value.before === null;
+	const callHunk = exec.name === "edit" && typeof args.old_string === "string" && typeof args.new_string === "string" ? {
+		oldText: args.old_string,
+		newText: args.new_string
+	} : null;
+	const metaHunks = validHunks(result.meta?.diffs);
+	const hunks = annotateHunks(metaHunks.length ? metaHunks : fallbackHunks(String(exec.name), args, before, after, create), before, after);
+	if (!hunks.length || typeof exec.callId !== "string") return null;
+	return {
+		callId: exec.callId,
+		toolName: exec.name === "write" ? "write" : "edit",
+		path,
+		before,
+		after,
+		baseFingerprint: fingerprint(before),
+		afterFingerprint: fingerprint(after),
+		legacy: false,
+		conflict: false,
+		create,
+		callHunk,
+		hunks,
+		decisions: {
+			call: "pending",
+			perHunk: hunks.map(() => "pending")
+		},
+		note: create ? "新建文件：全部拒绝将删除该文件" : before === null ? "未捕获修改前内容（大文件）" : null,
+		superseded: false,
+		archived: false,
+		batch: 0,
+		at: (/* @__PURE__ */ new Date()).toISOString()
+	};
+}
+/**
+* 读取镜像文件当前内容（node:fs 直读；缺失 → missing，非文件/过大/读失败 → unreadable）。
+* @author ddj 2026年09月23号
+* @param absPath 镜像内绝对路径
+* @returns 读取状态
+*/
+async function readMirrorState(absPath) {
+	let info;
+	try {
+		info = await stat(absPath);
+	} catch {
+		return { kind: "missing" };
+	}
+	if (!info.isFile()) return { kind: "unreadable" };
+	if ((info.size ?? 0) > 8388608) return { kind: "unreadable" };
+	try {
+		return {
+			kind: "content",
+			content: await readFile(absPath, "utf8")
+		};
+	} catch {
+		return { kind: "unreadable" };
+	}
+}
+/**
+* 把远端写入内容写穿回本地镜像（node:fs 直写 + mkdir -p 父目录）。
+* 刻意不用 ctx.fs：避免触发 dsh-remote-ssh 写桥把相同内容再推回远端。
+* @author ddj 2026年09月23号
+* @param absPath 镜像内绝对路径
+* @param content 远端写入后的完整内容
+* @returns 成功返回 null；失败返回错误文案（不抛）
+*/
+async function syncMirrorFile(absPath, content) {
+	try {
+		await mkdir(dirname(absPath), { recursive: true });
+		await writeFile(absPath, content, "utf8");
+		return null;
+	} catch (error) {
+		return String(error);
+	}
+}
+/**
+* 远端记录的 note 组装（新建/未捕获 before/镜像外路径/写穿失败可叠加）。
+* @author ddj 2026年09月23号
+* @param create 镜像中目标不存在（远端新建）
+* @param before 镜像快照内容（null = 未捕获）
+* @param mirrorAbs 可映射的镜像绝对路径（null = 路径不在镜像内）
+* @param syncErr 写穿失败原因（null = 成功）
+* @returns note 文本；无需提示返回 null
+*/
+function remoteNoteOf(create, before, mirrorAbs, syncErr) {
+	const notes = [];
+	if (!mirrorAbs) notes.push("远端路径不在工作区镜像内（仅记录，无法本地审查）");
+	else if (create) notes.push("新建文件：全部拒绝将删除该文件");
+	else if (before === null) notes.push("未捕获修改前内容（大文件）");
+	if (syncErr) notes.push("远端内容写回镜像失败（记录仍已保存）：" + syncErr);
+	return notes.length ? notes.join("；") : null;
+}
+/**
+* remote_ssh_write 执行 → 审查记录（含镜像写穿，issue #7）。
+* 非远程工作区、参数不合法或内容无变化返回 null（不产生记录）。
+* @author ddj 2026年09月23号
+* @param cwd 会话工作区（远程会话即镜像根）
+* @param exec 工具执行描述
+* @param args 工具参数（path 相对远端工作区目录，或绝对/`~` 形态）
+* @returns 记录；不满足捕获条件返回 null
+*/
+async function buildRemoteRecord(cwd, exec, args) {
+	const ws = findRemoteWs(cwd);
+	if (!ws) return null;
+	const argPath = typeof args.path === "string" ? args.path : "";
+	const after = typeof args.content === "string" ? args.content : null;
+	if (!argPath || after === null || typeof exec.callId !== "string") return null;
+	const mirrorAbs = mirrorTargetOf(argPath, ws);
+	const state = mirrorAbs ? await readMirrorState(mirrorAbs) : { kind: "unreadable" };
+	const before = state.kind === "content" ? state.content : null;
+	const create = state.kind === "missing";
+	if (before !== null && before === after) return null;
+	const syncErr = mirrorAbs ? await syncMirrorFile(mirrorAbs, after) : null;
+	const hunks = annotateHunks([{
+		oldText: before,
+		newText: after
+	}], before, after);
+	return {
+		callId: exec.callId,
+		toolName: "remote_ssh_write",
+		path: mirrorAbs ?? argPath,
+		before,
+		after,
+		baseFingerprint: fingerprint(before),
+		afterFingerprint: fingerprint(after),
+		legacy: false,
+		conflict: false,
+		create,
+		callHunk: null,
+		hunks,
+		decisions: {
+			call: "pending",
+			perHunk: hunks.map(() => "pending")
+		},
+		note: remoteNoteOf(create, before, mirrorAbs, syncErr),
+		superseded: false,
+		archived: false,
+		batch: 0,
+		at: (/* @__PURE__ */ new Date()).toISOString()
+	};
+}
+/**
+* 记录入桶：按工作区分桶（缺失先加载）、按文件递增批次、裁剪、落盘。
+* @author ddj 2026年09月23号
+* @param ctx DSH 上下文
+* @param registry 工作区记录桶注册表
+* @param session 会话
+* @param cwd 会话工作区
+* @param record 待入桶记录
+*/
+async function persistRecord(ctx, registry, session, cwd, record) {
+	let bucket = registry.get(cwd);
+	if (!bucket) {
+		bucket = await loadBucket(ctx, cwd);
+		registry.set(cwd, bucket);
+	}
+	record.batch = fileMaxBatch(bucket, record.path) + 1;
+	bucket.set(record.callId, record);
+	prune(bucket);
+	await saveBucket(ctx, cwd, bucket, session);
+}
+/**
+* 捕获一次工具执行结果（tools/result）：edit/write/remote_ssh_write 成功时
+* 构造记录、递增文件批次、落盘；远端写入额外做镜像写穿（issue #7）。
 * @author ddj 2026年08月20号
 * @param ctx DSH 上下文
 * @param registry 工作区记录桶注册表
@@ -3490,58 +4099,17 @@ function fallbackHunks(toolName, args, before, after, create) {
 */
 async function captureToolResult(ctx, registry, exec, result) {
 	const session = exec?.agent?.session;
-	if (!session || exec?.name !== "edit" && exec?.name !== "write") return;
-	if (result?.isError || !result?.value) return;
+	if (!session || !isCapturable(exec?.name)) return;
+	if (result?.isError) return;
+	if (exec.name !== "remote_ssh_write" && !result?.value) return;
 	try {
 		const cwd = cwdOf(session);
 		if (!cwd) return;
-		const value = result.value;
 		const args = exec.arguments || {};
-		const path = typeof value.path === "string" ? value.path : args.file_path;
-		if (typeof path !== "string" || !path) return;
-		const before = typeof value.before === "string" ? value.before : null;
-		const after = typeof value.after === "string" ? value.after : typeof args.content === "string" ? args.content : null;
-		const create = exec.name === "write" && value.before === null;
-		const callHunk = exec.name === "edit" && typeof args.old_string === "string" && typeof args.new_string === "string" ? {
-			oldText: args.old_string,
-			newText: args.new_string
-		} : null;
-		const metaHunks = validHunks(result.meta?.diffs);
-		const hunks = annotateHunks(metaHunks.length ? metaHunks : fallbackHunks(exec.name, args, before, after, create), before, after);
-		if (!hunks.length || typeof exec.callId !== "string") return;
-		const record = {
-			callId: exec.callId,
-			toolName: exec.name,
-			path,
-			before,
-			after,
-			baseFingerprint: fingerprint(before),
-			afterFingerprint: fingerprint(after),
-			legacy: false,
-			conflict: false,
-			create,
-			callHunk,
-			hunks,
-			decisions: {
-				call: "pending",
-				perHunk: hunks.map(() => "pending")
-			},
-			note: create ? "新建文件：全部拒绝将删除该文件" : before === null ? "未捕获修改前内容（大文件）" : null,
-			superseded: false,
-			archived: false,
-			batch: 0,
-			at: (/* @__PURE__ */ new Date()).toISOString()
-		};
-		let bucket = registry.get(cwd);
-		if (!bucket) {
-			bucket = await loadBucket(ctx, cwd);
-			registry.set(cwd, bucket);
-		}
-		record.batch = fileMaxBatch(bucket, path) + 1;
-		bucket.set(exec.callId, record);
-		prune(bucket);
-		await saveBucket(ctx, cwd, bucket, session);
-		invalidateIndex(ctx, cwd, path);
+		const record = exec.name === "remote_ssh_write" ? await buildRemoteRecord(cwd, exec, args) : buildLocalRecord(exec, args, result);
+		if (!record) return;
+		await persistRecord(ctx, registry, session, cwd, record);
+		invalidateIndex(ctx, cwd, record.path);
 	} catch (error) {
 		log.error("capture failed: " + String(error));
 	}
@@ -7772,8 +8340,8 @@ function patchInsertPerfConfig(text) {
 const staleCheckedAt = /* @__PURE__ */ new Map();
 /** stale 自动清理最小间隔。 */
 const STALE_CHECK_MIN_MS = 1e4;
-/** 记录 → 客户端视图（不含 before 全文，仅长度）。 */
-function recView(record) {
+/** 记录 → 客户端视图（不含 before 全文，仅长度）；远程工作区附远端展示路径（issue #7）。 */
+function recView(record, ws = null) {
 	return {
 		callId: record.callId,
 		toolName: record.toolName,
@@ -7790,7 +8358,8 @@ function recView(record) {
 		afterFingerprint: record.afterFingerprint ?? null,
 		conflict: record.conflict === true,
 		legacy: record.legacy === true,
-		at: record.at
+		at: record.at,
+		...ws ? { displayPath: remoteDisplayOf(record.path, ws) ?? void 0 } : {}
 	};
 }
 /** 会话/工作区公共前置：返回 {session,cwd} 或错误文案。 */
@@ -7920,6 +8489,7 @@ async function afterManualSave(ctx, registry, sc, path) {
 async function applyDecisions(ctx, session, cwd, bucket, items) {
 	const results = [];
 	const resolved = [];
+	const ws = findRemoteWs(cwd);
 	let changed = false;
 	for (const item of items) {
 		const record = bucket.get(item.callId);
@@ -7954,7 +8524,7 @@ async function applyDecisions(ctx, session, cwd, bucket, items) {
 		const result = {
 			callId: item.callId,
 			ok: true,
-			record: recView(record)
+			record: recView(record, ws)
 		};
 		if (revertedStale) result.stale = true;
 		results.push(result);
@@ -8109,10 +8679,11 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 				}
 			}
 			const out = [];
+			const ws = findRemoteWs(sc.cwd);
 			for (const rec of bucket.values()) {
 				if (!want && rec.archived) continue;
 				if (want && !want.has(rec.callId)) continue;
-				out.push(recView(rec));
+				out.push(recView(rec, ws));
 			}
 			out.sort((a, b) => a.at < b.at ? -1 : 1);
 			return {
@@ -8418,7 +8989,9 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 				ok: false,
 				error: sc.err
 			};
-			const entries = parseArchive(await readArchiveText(ctx, sc.cwd)).filter((b) => b.cwd === sc.cwd).map((b) => {
+			const batches = parseArchive(await readArchiveText(ctx, sc.cwd)).filter((b) => b.cwd === sc.cwd);
+			const ws = findRemoteWs(sc.cwd);
+			const entries = batches.map((b) => {
 				const recs = Array.isArray(b.records) ? b.records : [];
 				const sum = recs.reduce((s, r) => {
 					const sm = r.summary || {
@@ -8442,6 +9015,7 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 					at: b.at,
 					lastAt: b.lastAt || b.at,
 					path: b.path,
+					...ws ? { displayPath: remoteDisplayOf(b.path, ws) ?? void 0 } : {},
 					batch: b.batch ?? null,
 					reason: b.reason ?? null,
 					nRecords: recs.length,
@@ -13227,6 +13801,29 @@ async function routeOf(llm, cfg) {
 	};
 }
 /**
+* AI 任务模型路由（非补全场景如 AI 智能整理）：任务配置优先，空则回落补全配置链。
+* 回落序：taskProvider/taskModel 双非空直用 → routeOf（补全配置 → 自动首个）；
+* effort 同序：taskEffort 非空用之，否则 cfg.effort（空串 = 不携带）。
+* @author ddj 2026年09月23号
+* @param llm llm 运行时
+* @param cfg AI 配置（含可选任务模型字段）
+* @returns 路由（provider/model/effort）；不可路由返回 null
+*/
+async function taskRouteOf(llm, cfg) {
+	const effort = cfg.taskEffort || cfg.effort || "";
+	if (cfg.taskProvider && cfg.taskModel) return {
+		provider: cfg.taskProvider,
+		model: cfg.taskModel,
+		effort
+	};
+	const base = await routeOf(llm, cfg);
+	if (!base) return null;
+	return {
+		...base,
+		effort
+	};
+}
+/**
 * 单次 AI 内联补全。
 * @author ddj
 * @param deps 服务依赖
@@ -13512,6 +14109,126 @@ function createFileVersions(ctx) {
 	};
 }
 //#endregion
+//#region src/ai/svnTriage.ts
+/** 方案生成最大输出 token（三段 JSON 上限；再大是幻觉温床）。 */
+const AI_PLAN_MAX_TOKENS = 8192;
+/** 系统指令：输出唯一 JSON + 三段判据 + 硬约束（不虚构路径/一路径一类）。 */
+const AI_PLAN_SYSTEM = [
+	"你是 SVN 变更整理助手。根据给出的工作副本变更清单（可能附 diff），产出整理方案，",
+	"输出唯一 JSON 对象，除 JSON 外不得输出任何文本（不要围栏、不要解释）：",
+	"{",
+	"  \"groups\": [{ \"name\": \"英文短名\", \"paths\": [\"路径1\"], \"reason\": \"分组理由\" }],",
+	"  \"reverts\": [{ \"path\": \"路径\", \"reason\": \"还原理由\" }],",
+	"  \"ignores\": [{ \"path\": \"路径\", \"reason\": \"忽略理由\" }]",
+	"}",
+	"规则：",
+	"1. 只可使用清单中出现的路径，绝不虚构或改写路径。",
+	"2. 每个路径至多归入一段（groups/reverts/ignores 互斥），拿不准的路径三段都不列。",
+	"3. groups：按功能主题把待提交改动分入 changelist 组；name 用简短英文（不以 - 开头），",
+	"   同一主题合并为一组，组数尽量少。",
+	"4. reverts：仅针对受版本控制的改动建议还原——行尾/空白噪音、误改、试验性改动等。",
+	"5. ignores：仅针对未版本化的条目建议忽略——构建产物、缓存、日志、临时文件等生成物。",
+	"6. reason 用简短中文一句话说明判定依据。"
+].join("\n");
+/**
+* 构造分析用户段：变更清单行（status | path | changelist）+ 可选 diff 上下文。
+* @author ddj 2026年09月23号
+* @param entries 变更清单（调用方已按 AI_PLAN_PATHS_CAP 截断）
+* @param diffText diff 文本（null = paths-only 降级）
+* @param truncated 清单是否已截断（prompt 注明，防 AI 误以为是全集）
+* @returns 用户消息文本
+*/
+function buildAiPrompt(entries, diffText, truncated = false) {
+	const lines = entries.map((entry) => entry.status + " | " + entry.path + (entry.changelist ? " | " + entry.changelist : ""));
+	let text = (truncated ? "变更清单（已截断，仅分析所列条目；status | path | changelist）：" : "变更清单（status | path | changelist）：") + "\n" + lines.join("\n");
+	if (diffText) text += "\n\n变更 diff（unified，0 上下文行）：\n" + diffText;
+	else text += "\n\n（无 diff 上下文，仅按路径与状态判断）";
+	return text;
+}
+/**
+* 解析 AI 输出 JSON：剥 ``` 围栏 → 取首个 `{` 至末个 `}` → JSON.parse。
+* 失败抛带原文摘要的错误（调用方整体报错零执行，不静默降级）。
+* @author ddj 2026年09月23号
+* @param text 模型输出原文
+* @returns 解析出的对象（形状由 normalizeAiPlan 容错）
+*/
+function parseAiPlanJson(text) {
+	const raw = String(text ?? "");
+	const start = raw.indexOf("{");
+	const end = raw.lastIndexOf("}");
+	if (start < 0 || end <= start) throw new Error("AI 输出不含 JSON 对象：" + raw.slice(0, 200));
+	const body = raw.slice(start, end + 1);
+	try {
+		return JSON.parse(body);
+	} catch (error) {
+		throw new Error("AI 输出无法解析为 JSON：" + String(error) + "（原文摘要：" + body.slice(0, 200) + "）");
+	}
+}
+/**
+* 一次 AI 智能整理分析（一次性非会话流式调用）。
+* llm 缺失/不可路由/流失败/解析失败一律抛错，由 handler 转 `{ok:false, error}`（零执行）。
+* @author ddj 2026年09月23号
+* @param ctx DSH 上下文（取 llm）
+* @param cfg AI 配置（任务模型路由优先，回落补全配置）
+* @param prompt 用户段（buildAiPrompt 产物）
+* @returns 原始方案对象与模型标识
+*/
+async function svnAiPlanOf(ctx, cfg, prompt) {
+	const llm = llmOf(ctx);
+	if (!llm) throw new Error("llm 服务不可用（请检查 DSH 模型配置）");
+	const route = await taskRouteOf(llm, cfg);
+	if (!route) throw new Error("未找到可用模型（请检查 DSH 模型配置）");
+	const controller = new AbortController();
+	let timedOut = false;
+	const timer = setTimeout(() => {
+		timedOut = true;
+		controller.abort(/* @__PURE__ */ new Error("timeout"));
+	}, AI_PLAN_TIMEOUT_MS);
+	try {
+		const stream = llm.stream({
+			provider: route.provider,
+			model: route.model,
+			...route.effort ? { reasoningEffort: route.effort } : {},
+			messages: [{
+				role: "user",
+				content: [{
+					type: "text",
+					text: prompt
+				}],
+				source: { kind: "user" }
+			}],
+			system: AI_PLAN_SYSTEM,
+			temperature: .2,
+			maxTokens: AI_PLAN_MAX_TOKENS,
+			signal: controller.signal
+		});
+		let text = "";
+		let failNote = "";
+		for await (const chunk of stream) {
+			const c = chunk;
+			if (c.type === "text-delta") text += c.text;
+			else if (c.type === "finish") {
+				const kind = c.reason?.kind;
+				if (kind === "error" || kind === "aborted") {
+					const failure = c.reason.failure;
+					failNote = "模型流失败 " + (failure?.code ?? kind) + ": " + (failure?.message ?? "模型调用失败");
+				}
+				break;
+			}
+		}
+		if (failNote) throw new Error(failNote);
+		return {
+			raw: parseAiPlanJson(text),
+			model: route.provider + "/" + route.model
+		};
+	} catch (error) {
+		if (timedOut) throw new Error("AI 分析超时（" + Math.round(AI_PLAN_TIMEOUT_MS / 1e3) + "s）：可在设置页调低任务模型思考强度或换更快模型");
+		throw error;
+	} finally {
+		clearTimeout(timer);
+	}
+}
+//#endregion
 //#region src/svnXml.ts
 /**
 * dsh-vscode-mode host — SVN XML 解析基元（零第三方依赖，可单测）。
@@ -14076,6 +14793,22 @@ async function findTortoiseProc(dirSetting, exists = defaultExists, platform = p
 	return null;
 }
 /**
+* svn:ignore 名称合法性校验（host 权威；防换行注入 propset 值与路径穿越）。
+* 规则：去空白后非空、无换行、无路径分隔符、不以 `-` 开头（防被 svn 当选项解析）。
+* @author ddj 2026年09月23号
+* @param name 待写入的忽略名（basename / 通配模式）
+* @returns 错误文案；合法为 null
+*/
+function ignoreNameErrorOf(name) {
+	if (typeof name !== "string") return "忽略名必须是字符串";
+	const trimmed = name.trim();
+	if (!trimmed) return "忽略名不能为空";
+	if (/[\r\n]/.test(trimmed)) return "忽略名不能包含换行";
+	if (trimmed.includes("/") || trimmed.includes("\\")) return "忽略名不能包含路径分隔符";
+	if (trimmed.startsWith("-")) return "忽略名不能以 - 开头";
+	return null;
+}
+/**
 * 本插件已自研的 SVN 能力（「自研替换时间线」的推进点）。
 *
 * 每完成一个阶段就把对应能力加进来：client 会据此隐藏被覆盖的 TortoiseProc 项，
@@ -14380,6 +15113,8 @@ function createSvnRpc(deps) {
 	const statusCache = /* @__PURE__ */ new Map();
 	/** 变更清单缓存（键 = 工作副本根；TTL 短，仅合并同一轮 UI 的多处拉取）。 */
 	const changesCache = /* @__PURE__ */ new Map();
+	/** 混合通道方案收件箱（key = 工作副本根；覆盖式入箱 + TTL，见 svn.aiPlanSubmit/Pending）。 */
+	const planInbox = /* @__PURE__ */ new Map();
 	/** 工作副本根 relative-url 缓存（日志路径映射用；探测失败也缓存空串避免反复 spawn）。 */
 	const urlCache = /* @__PURE__ */ new Map();
 	let cliProbe = null;
@@ -14809,6 +15544,63 @@ function createSvnRpc(deps) {
 		};
 		return merged.binary || merged.encodingHint ? merged : {};
 	};
+	/**
+	* svn:ignore 写入执行（AI 整理执行段③）：逐目录 `propget` 读既有值 → 合并去重 → `propset`。
+	* 不整体覆盖（保留团队既有 ignore）；逐目录失败收集不中断，全部失败才 ok:false。
+	* @author ddj 2026年09月23号
+	* @param wcRoot 工作副本根
+	* @param items 目录聚合写入项（dir 已归一，根为 '.'）
+	* @returns 新增计数/摘要/原文
+	*/
+	const ignoreApplyOf = async (wcRoot, items) => {
+		let count = 0;
+		const notes = [];
+		const failures = [];
+		for (const item of items) {
+			const getOutcome = await runSvn(wcRoot, [
+				"propget",
+				"svn:ignore",
+				"--",
+				item.dir
+			], READ_GRACE_MS);
+			if (getOutcome.code !== 0) {
+				failures.push(item.dir + " 读取失败：" + tailOfText(getOutcome.stderr || getOutcome.stdout));
+				continue;
+			}
+			const merged = [...getOutcome.stdout.split(/\r?\n/).map((line) => line.trim()).filter(Boolean)];
+			let added = 0;
+			for (const name of item.names) {
+				if (merged.includes(name)) continue;
+				merged.push(name);
+				added++;
+			}
+			if (!added) {
+				notes.push(item.dir + "：无新增（已在忽略列表）");
+				continue;
+			}
+			const setOutcome = await runSvn(wcRoot, [
+				"propset",
+				"svn:ignore",
+				merged.join("\n"),
+				"--",
+				item.dir
+			], MUTATE_GRACE_MS);
+			if (setOutcome.code !== 0) {
+				failures.push(item.dir + " 写入失败：" + tailOfText(setOutcome.stderr || setOutcome.stdout));
+				continue;
+			}
+			count += added;
+			notes.push(item.dir + "：新增 " + added + " 项");
+		}
+		const ok = failures.length < items.length;
+		const summary = failures.length ? "svn:ignore 写入 " + count + " 项；失败 " + failures.length + " 个目录" : count > 0 ? "svn:ignore 写入 " + count + " 项" : "无新增忽略项";
+		return {
+			ok,
+			count,
+			summary,
+			output: [...notes, ...failures].join("\n")
+		};
+	};
 	return { handlers: {
 		"svn.status": async (args) => {
 			const sc = await requireSvnSession(ctx, args.sessionId);
@@ -14924,6 +15716,26 @@ function createSvnRpc(deps) {
 		"svn.add": async (args) => {
 			return mutate("加入版本控制", ["add"], args.sessionId, args.paths);
 		},
+		/**
+		* 分区（changelist）批量操作：关联或解除工作副本条目的 changelist 登记。
+		* 复用 mutate 全套护栏（路径白名单 / BATCH_PATHS_CAP / 超时 / 变更缓存作废）；
+		* 分区名 host 权威校验（`-` 开头会被 svn 当成选项解析），remove 分支不需要名字。
+		* @author ddj 2026年09月23号
+		* @param args.paths 工作区相对路径列表
+		* @param args.name 目标分区名（remove 时忽略）
+		* @param args.remove true = 移出分区（`changelist --remove`）
+		* @returns 批量动作结果
+		*/
+		"svn.changelist": async (args) => {
+			if (args.remove !== true) {
+				const nameError = svnChangelistNameErrorOf(String(args.name ?? ""));
+				if (nameError) return {
+					ok: false,
+					error: nameError
+				};
+			}
+			return mutate(args.remove === true ? "移出分区" : "分区", args.remove === true ? ["changelist", "--remove"] : ["changelist", String(args.name ?? "").trim()], args.sessionId, args.paths);
+		},
 		"svn.log": async (args) => {
 			const sc = await requireSvnSession(ctx, args.sessionId);
 			if ("err" in sc) return {
@@ -15353,35 +16165,255 @@ function createSvnRpc(deps) {
 				ok: false,
 				error: "缺少 fs"
 			};
-			const sizes = [];
-			for (const raw of list) {
+			const sizeOne = async (raw) => {
 				const rel = safeRel(raw);
-				if (rel === null || rel === "") {
-					sizes.push({
-						path: String(raw ?? ""),
-						size: null
-					});
-					continue;
-				}
+				if (rel === null || rel === "") return {
+					path: String(raw ?? ""),
+					size: null
+				};
 				try {
 					const resolved = await fs.resolve(rel, { cwd: sc.cwd });
 					const info = await fs.stat(resolved);
-					sizes.push({
+					return {
 						path: rel,
 						size: info && info.type === "file" ? info.size ?? null : null
-					});
+					};
 				} catch {
-					sizes.push({
+					return {
 						path: rel,
 						size: null
-					});
+					};
 				}
-			}
+			};
+			const sizes = [];
+			const BATCH = 16;
+			for (let start = 0; start < list.length; start += BATCH) sizes.push(...await Promise.all(list.slice(start, start + BATCH).map(sizeOne)));
 			return {
 				ok: true,
 				sizes
 			};
 		},
+		/**
+		* AI 智能整理分析（只读）：拉最新变更 → 附 diff 上下文（超限降级 paths-only）→
+		* LLM 流式产出 JSON → normalizeAiPlan 以真实清单白名单归一。任何失败零执行只报错。
+		* @author ddj 2026年09月23号
+		* @param args.sessionId 会话 id
+		* @returns 三段方案 + 分析元信息（条目数/是否含 diff/丢弃数/模型）
+		*/
+		"svn.aiPlan": 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 { entries } = await changesOf(status.wcRoot, true);
+				let diffText = null;
+				try {
+					const outcome = await runSvn(status.wcRoot, [
+						"diff",
+						"-x",
+						"-U0"
+					], READ_GRACE_MS, AI_PLAN_DIFF_CAP);
+					if (outcome.code === 0 && outcome.stdout.trim() && outcome.stdout.length < 2097152) diffText = outcome.stdout;
+				} catch {}
+				const capped = entries.length > AI_PLAN_PATHS_CAP;
+				const used = capped ? entries.slice(0, AI_PLAN_PATHS_CAP) : entries;
+				const diffIncluded = diffText !== null && !capped;
+				const prompt = buildAiPrompt(used, diffIncluded ? diffText : null, capped);
+				const cfg = settings.ai ? settings.ai() : {
+					enabled: true,
+					provider: "",
+					model: "",
+					effort: ""
+				};
+				const result = await svnAiPlanOf(ctx, cfg, prompt);
+				const { plan, dropped } = normalizeAiPlan(result.raw, entries);
+				return {
+					ok: true,
+					plan,
+					entriesCount: entries.length,
+					diffIncluded,
+					dropped,
+					model: result.model
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					error: String(error instanceof Error ? error.message : error)
+				};
+			}
+		},
+		/**
+		* AI 智能整理执行段③：按目录合并写入 svn:ignore 属性（propget 合并，不整体覆盖）。
+		* 复用受管理/svnCli 校验与变更缓存作废语义（对齐 mutate）。
+		* @author ddj 2026年09月23号
+		* @param args.items 目录聚合写入项（dir + 该目录下新增忽略名）
+		* @returns 新增计数/摘要/原文
+		*/
+		"svn.ignore": async (args) => {
+			const sc = await requireSvnSession(ctx, args.sessionId);
+			if ("err" in sc) return {
+				ok: false,
+				error: sc.err
+			};
+			const items = Array.isArray(args.items) ? args.items : [];
+			if (!items.length) return {
+				ok: false,
+				error: "未选择任何路径"
+			};
+			const clean = [];
+			let total = 0;
+			for (const item of items) {
+				const rel = safeRel(item?.dir);
+				if (rel === null) return {
+					ok: false,
+					error: "路径不合法"
+				};
+				const names = Array.isArray(item?.names) ? item.names : [];
+				if (!names.length) return {
+					ok: false,
+					error: "忽略名列表为空"
+				};
+				const checked = [];
+				for (const name of names) {
+					const nameError = ignoreNameErrorOf(name);
+					if (nameError) return {
+						ok: false,
+						error: nameError
+					};
+					checked.push(String(name).trim());
+				}
+				total += checked.length;
+				if (total > 64) return {
+					ok: false,
+					error: "一次最多处理 64 个路径"
+				};
+				clean.push({
+					dir: rel === "" ? "." : rel,
+					names: checked
+				});
+			}
+			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 ignoreApplyOf(status.wcRoot, clean);
+				changesCache.delete(status.wcRoot);
+				if (!result.ok) return {
+					ok: false,
+					error: result.summary + (result.output ? "\n" + tailOfText(result.output) : "")
+				};
+				return {
+					ok: true,
+					count: result.count,
+					summary: result.summary,
+					output: result.output
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					error: "svn:ignore 写入失败：" + String(error)
+				};
+			}
+		},
+		/**
+		* 混合通道投递口（01-hybrid-deep-analysis）：会话 agent 深度分析后 POST 方案入收件箱。
+		* 只读 + 内存态：经 normalizeAiPlan 以最新变更清单白名单归一（幻觉路径丢弃计数），
+		* 零接受拒收（防 agent 空转误报成功）；覆盖式入箱（新投递顶掉旧件）。
+		* @author ddj 2026年09月23号
+		* @param args.plan agent 产出的方案 JSON（形状宽松，归一兜底）
+		* @returns 接受路径数与丢弃数
+		*/
+		"svn.aiPlanSubmit": 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 { entries } = await changesOf(status.wcRoot, true);
+				const { plan, dropped } = normalizeAiPlan(args.plan, entries);
+				const accepted = plan.reverts.length + plan.ignores.length + plan.groups.reduce((n, group) => n + group.paths.length, 0);
+				if (!accepted) return {
+					ok: false,
+					error: "方案为空：无任何路径通过白名单校验（丢弃 " + dropped + " 项）"
+				};
+				planInbox.set(status.wcRoot, {
+					plan,
+					dropped,
+					at: now()
+				});
+				return {
+					ok: true,
+					accepted,
+					dropped
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					error: "方案投递失败：" + String(error)
+				};
+			}
+		},
+		/**
+		* 混合通道取件口：面板轮询取收件箱方案。
+		* since = 注入时刻——早于它的旧投递不算新件（防上一轮残留被误认为本轮结果）；
+		* TTL 过期返回 plan:null。非破坏性读取（重复取到同一份由 client 侧取件即停消化）。
+		* @author ddj 2026年09月23号
+		* @param args.since 注入时刻时间戳（缺省 0 = 取任意件）
+		* @returns 方案与元信息（无新件 plan 为 null）
+		*/
+		"svn.aiPlanPending": 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 管理"
+			};
+			const hit = planInbox.get(status.wcRoot);
+			const since = Number(args.since) || 0;
+			if (!hit || hit.at < since || now() - hit.at > 18e5) return {
+				ok: true,
+				plan: null,
+				dropped: 0,
+				at: 0
+			};
+			return {
+				ok: true,
+				plan: hit.plan,
+				dropped: hit.dropped,
+				at: hit.at
+			};
+		},
 		"svn.wcRev": async (args) => {
 			const sc = await requireSvnSession(ctx, args.sessionId);
 			if ("err" in sc) return {
@@ -17171,11 +18203,14 @@ const inject = [
 * 字段集与 installOpenSettingsSection 的 section schema 同源（buildSettingsSchema），
 * 全字段带默认值——undefined/空配置经 schemastery 校验自动填充（rc/alpha 两代
 * cordis 均读该导出，实测 4.0.0-rc.8 与 0.1.7 行为一致，校验必过）。
-* 运行时解析：@deepseek-ai/schemastery 经插件自身 node_modules（link/dev/npm 安装
-* 三形态均在 peer/dev 依赖面内，先于宿主树命中）。
-* @author ddj 2026年09月22号
-*/
-const Config = buildSettingsSchema(z);
+* volatile: true —— 0.1.7 的 SettingsForms.describe 只下发含 volatile 字段的 entry
+* （volatileForm 门槛），漏标则 ns 不出现 → client configForms 恒 unavailable →
+* 设置页「设置服务暂不可用」；同时 volatile 字段由 Loader 就地提交免重载。
+* 运行时解析：@deepseek-ai/schemastery 经插件自身 dependencies（link/dev/npm 安装
+* 三形态一致，钉 ~3.18.4 —— 3.18.1 起才有 .volatile()，低版本经 markVolatile 守卫降级）。
+* @author ddj 2026年09月22号（2026年09月23号 增补 volatile 标记）
+*/
+const Config = buildSettingsSchema(z, { volatile: true });
 /**
 * 装配插件：挂事件监听、注册路由、安装兼容层。
 * @author ddj 2026年08月20号