dsh-vscode-mode 0.22.0 → 0.23.0

package/lib/index.js

@@ -43,7 +43,7 @@ const RESOURCE_TOOLS = /* @__PURE__ */ new Set([
 * @param path Workspace or agent cwd.
 * @returns Comparable path with a stable root representation.
 */
-function normalizePath(path) {
+function normalizePath$1(path) {
 	const raw = String(path ?? "").replace(/\\/g, "/");
 	const windows = /^[a-z]:/i.test(raw) || raw.startsWith("//");
 	const value = (windows ? win32.normalize(raw) : posix.normalize(raw)).replace(/\\/g, "/").replace(/\/+$/, "") || "/";
@@ -58,12 +58,12 @@ function normalizePath(path) {
 */
 function matchWorkspace(cwd, paths) {
 	if (!cwd) return void 0;
-	const target = normalizePath(cwd);
+	const target = normalizePath$1(cwd);
 	const matches = paths.filter((path) => {
-		const root = normalizePath(path);
+		const root = normalizePath$1(path);
 		return target === root || target.startsWith(root === "/" ? root : root + "/");
 	});
-	matches.sort((a, b) => normalizePath(b).length - normalizePath(a).length);
+	matches.sort((a, b) => normalizePath$1(b).length - normalizePath$1(a).length);
 	return matches[0];
 }
 const isProjectEntry = isProjectEntryId;
@@ -684,6 +684,15 @@ function debugLogFile(cwd, home = dshHome()) {
 function archiveDbFile(cwd, home = dshHome()) {
 	return join(home, PLUGIN_ID, "data", "archive", hashOf(cwd) + ".sqlite");
 }
+/**
+* 快捷菜单配置文本（用户数据，不受缓存清理预算约束，跨工作区共享一份）。
+* @author ddj 2026年10月30号
+* @param home DSH home（测试可注入）
+* @returns 快捷菜单配置绝对路径
+*/
+function quickMenuFile(home = dshHome()) {
+	return join(home, PLUGIN_ID, "data", "quick-menu.json");
+}
 /** 插件包 assets 目录（import.meta.url 派生；config.imageDir 可覆盖，见 imageDirOf）。 */
 function assetsDirOf(moduleUrl) {
 	return join(dirname(fileURLToPath(moduleUrl)), "..", "assets");
@@ -5418,7 +5427,7 @@ const SKILL_PREFIXES = ["dsh-vscodemode-"];
 /** 技能发现来源标签（skill-explorer 归入 "System bundled" 组）。 */
 const SKILL_SOURCE = "bundled";
 /** 目录式技能的文件名。 */
-const SKILL_FILE = "SKILL.md";
+const SKILL_FILE$1 = "SKILL.md";
 /** DSH 技能名语法（与 @deepseek-ai/dsh-skill 的 SKILL_NAME 一致：下划线非法）。 */
 const SKILL_NAME_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 /** 不受支持的遗留字段 → 规范字段（官方同样拒绝，避免写错键位却静默无效果）。 */
@@ -5596,7 +5605,7 @@ function hasGroupPrefix(name) {
 * @returns 候选文件绝对路径；不构成技能时返回 undefined
 */
 function skillFileOf(dir, entry) {
-	if (entry.isDirectory()) return join(dir, entry.name, SKILL_FILE);
+	if (entry.isDirectory()) return join(dir, entry.name, SKILL_FILE$1);
 	if (entry.isFile() && entry.name.endsWith(".md")) return join(dir, entry.name);
 }
 /**
@@ -8139,97 +8148,107 @@ const WRITE_TOOLS = [
 /** 单文件文本上限：超过即标注 oversized，不静默截断。 */
 const MAX_TEXT = 1048576;
 /**
-* @author ddj 2026年10月29号
+* @author ddj 2026年10月30号
 * @description: 安装写文件采集；读写失败只影响待审来源，绝不影响用户工具本身。
 * @param ctx Host 生命周期
 * @param sink 已确认写入的接收方
 * @returns 可释放的采集器
 */
-function installPendingCapture(ctx, sink) {
-	const busy = /* @__PURE__ */ new Set();
-	let stopped = false;
-	ctx.on("tools/execute", aroundTool);
-	return { dispose };
-	/**
-	* @author ddj 2026年10月29号
-	* @description: 写工具执行前后各读一次，内容变化才上报。
-	* @param exec 工具分发上下文
-	* @param next 原始分发
-	* @returns 原始工具结果，永不因采集失败而改变
-	*/
-	async function aroundTool(exec, next) {
-		const session = exec.agent?.session;
-		const path = exec.arguments?.file_path ?? exec.arguments?.path;
-		if (stopped || !session?.id || typeof path !== "string" || !WRITE_TOOLS.includes(exec.name)) return next();
-		const cwd = cwdOf(session);
-		if (!cwd) return next();
-		let before = null;
-		let identity = null;
+function installPending(ctx, sink) {
+	const state = {
+		busy: /* @__PURE__ */ new Set(),
+		stopped: false
+	};
+	ctx.on("tools/execute", (exec, next) => aroundTool(ctx, state, sink, exec, next));
+	return { dispose() {
+		state.stopped = true;
+		state.busy.clear();
+	} };
+}
+/**
+* @author ddj 2026年10月30号
+* @description: 判定本次调用是否值得采集；不值得时返回 null，调用方直接透传原始分发。
+* @param ctx Host 生命周期
+* @param state 采集状态
+* @param exec 工具分发上下文
+* @returns 采集计划或 null
+*/
+async function planOf(ctx, state, exec) {
+	const session = exec.agent?.session;
+	const requested = exec.arguments?.file_path ?? exec.arguments?.path;
+	if (state.stopped || !session?.id || typeof requested !== "string") return null;
+	if (!WRITE_TOOLS.includes(String(exec.name))) return null;
+	const cwd = cwdOf(session);
+	if (!cwd) return null;
+	const fs = ctx.get("fs");
+	const target = await resolveTarget(ctx, session, requested);
+	const identity = fs.processPath(target);
+	if (typeof identity !== "string" || !identity || state.busy.has(identity)) return null;
+	const before = await readText(fs, target);
+	if (before !== null && before.length > MAX_TEXT) return null;
+	return {
+		cwd: String(cwd),
+		sessionId: String(session.id),
+		path: requested,
+		identity,
+		before,
+		session
+	};
+}
+/**
+* @author ddj 2026年10月30号
+* @description: 写工具执行前后各读一次，内容变化才上报；任何采集异常都不改变工具结果。
+* @param ctx Host 生命周期
+* @param state 采集状态
+* @param sink 已确认写入的接收方
+* @param exec 工具分发上下文
+* @param next 原始分发
+* @returns 原始工具结果
+*/
+async function aroundTool(ctx, state, sink, exec, next) {
+	let plan = null;
+	try {
+		plan = await planOf(ctx, state, exec);
+	} catch (error) {
+		log.debug("待审采集跳过：" + String(error));
+	}
+	if (!plan) return next();
+	state.busy.add(plan.identity);
+	try {
+		return await next();
+	} finally {
+		state.busy.delete(plan.identity);
 		try {
-			const fs = ctx.get("fs");
-			const target = await resolveTarget(ctx, session, path);
-			const key = fs.processPath(target);
-			if (typeof key !== "string" || !key) return next();
-			if (busy.has(key)) return next();
-			before = await readText(fs, target);
-			if (before !== null && before.length > MAX_TEXT) return next();
-			identity = key;
-			busy.add(key);
+			reportWrite(ctx, sink, plan);
 		} catch (error) {
-			log.debug("待审采集跳过：" + String(error));
-			return next();
-		}
-		try {
-			return await next();
-		} finally {
-			if (identity !== null) {
-				const key = identity;
-				try {
-					report(String(cwd), String(session.id), String(path), key, before, exec);
-				} catch (error) {
-					log.debug("待审上报失败：" + String(error));
-				}
-				busy.delete(key);
-			}
+			log.debug("待审上报失败：" + String(error));
 		}
 	}
-	/**
-	* @author ddj 2026年10月29号
-	* @description: 写后读回并比较，内容一致视为无净变化不产生条目。
-	* @param cwd 工作区
-	* @param sessionId 会话
-	* @param path 展示路径
-	* @param identity 目标身份
-	* @param before 写前内容
-	* @param exec 工具分发上下文
-	* @returns 无
-	*/
-	function report(cwd, sessionId, path, identity, before, exec) {
-		const fs = ctx.get("fs");
-		resolveTarget(ctx, exec.agent.session, path).then(async (target) => {
-			const after = await readText(fs, target);
-			if (after !== null && after.length > MAX_TEXT) return;
-			if (before === after) return;
-			sink({
-				cwd,
-				sessionId,
-				path,
-				identity,
-				before,
-				after,
-				now: Date.now()
-			});
-		}).catch((error) => log.debug("待审读回失败：" + String(error)));
-	}
-	/**
-	* @author ddj 2026年10月29号
-	* @description: 释放监听。
-	* @returns 无
-	*/
-	function dispose() {
-		stopped = true;
-		busy.clear();
-	}
+}
+/**
+* @author ddj 2026年10月29号
+* @description: 写后读回并比较，内容一致视为无净变化不产生条目。
+* @param ctx Host 生命周期
+* @param sink 已确认写入的接收方
+* @param plan 采集计划
+* @returns 无；读回失败只记日志
+*/
+function reportWrite(ctx, sink, plan) {
+	const fs = ctx.get("fs");
+	resolveTarget(ctx, plan.session, plan.path).then(async (target) => {
+		const after = await readText(fs, target);
+		if (after !== null && after.length > MAX_TEXT) return;
+		if (plan.before === after) return;
+		sink({
+			cwd: plan.cwd,
+			sessionId: plan.sessionId,
+			path: plan.path,
+			identity: plan.identity,
+			before: plan.before,
+			after,
+			now: Date.now()
+		});
+	}).catch((error) => log.debug("待审读回失败：" + String(error)));
 }
 /**
 * @author ddj 2026年10月29号
@@ -9300,7 +9319,12 @@ CREATE TABLE IF NOT EXISTS pending_history (
   snapshot TEXT NOT NULL, created_at INTEGER NOT NULL,
   state TEXT NOT NULL DEFAULT 'applied');
 `;
-/** v1 历史表补 state 列（rebuild 成本高于一次 ALTER）。 */
+/**
+* @author ddj 2026年10月29号
+* @description: v1 历史表补 state 列（rebuild 成本高于一次 ALTER）。
+* @param db 已打开的工作区库
+* @returns 无
+*/
 function migrateHistory(db) {
 	if (db.prepare("PRAGMA table_info(pending_history)").all().some((column) => column.name === "state")) return;
 	db.exec("ALTER TABLE pending_history ADD COLUMN state TEXT NOT NULL DEFAULT 'applied'");
@@ -9502,7 +9526,12 @@ function flagsOfRow(row) {
 }
 //#endregion
 //#region src/pending/store.ts
-/** 统计一次差异的增删行数。 */
+/**
+* @author ddj 2026年10月29号
+* @description: 统计一次差异的增删行数；非文本差异统一记 0/0。
+* @param entry 待审条目
+* @returns 增删行数
+*/
 function countsOf(entry) {
 	const diff = diffOf(entry);
 	if (diff.kind !== "text") return {
@@ -9739,11 +9768,11 @@ function writerFor(fs, cwd, identity, expected, signal, policy, allowCreate = fa
 			ok: false,
 			reason: "diverged"
 		};
-		const info = await fs.stat(target, signal).catch(() => void 0);
+		const currentStat = await fs.stat(target, signal).catch(() => void 0);
 		try {
-			await fs.writeText(target, content ?? "", info ? {
+			await fs.writeText(target, content ?? "", currentStat ? {
 				kind: "replaceIfVersion",
-				version: info.version
+				version: currentStat.version
 			} : void 0, signal, policy);
 			const readBack = await readText(fs, target);
 			if ((content ?? "") !== (readBack ?? "")) return {
@@ -10014,6 +10043,39 @@ function reasonOf(error) {
 	return typeof code === "string" ? code : String(error);
 }
 //#endregion
+//#region src/shared/pathKey.ts
+/**
+* 路径比较口径：Host 与客户端共用同一套「远端 / 盘符 / 相对路径」判定，只在平台折叠上分工。
+* @author ddj 2026年10月30号
+*/
+/** 远端仓库身份：`scheme://...` 区分大小写，绝不能折叠。 */
+const REMOTE = /^[a-z]+:\/\//i;
+/** 盘符绝对路径：大小写不敏感与宿主平台无关，两边都必须折叠。 */
+const DRIVE = /^[a-z]:\//i;
+/**
+* @author ddj 2026年10月30号
+* @description: 统一分隔符为 `/`，其余字符原样保留。
+* @param path 原始路径
+* @returns 反斜杠已归一化的路径
+*/
+function unifiedPath(path) {
+	return path.replace(/\\/g, "/");
+}
+/**
+* @author ddj 2026年10月30号
+* @description: 生成路径比较键。盘符路径恒折叠大小写；其余路径是否折叠由调用方按运行平台决定
+* （Host 在 Windows 上折叠，客户端不在宿主进程里，取 false）。
+* @param path 原始路径
+* @param foldCase 非盘符路径是否折叠大小写
+* @returns 比较键
+*/
+function pathKeyFor(path, foldCase) {
+	const unified = unifiedPath(path);
+	if (REMOTE.test(unified)) return unified;
+	if (DRIVE.test(unified)) return unified.toLowerCase();
+	return foldCase ? unified.toLowerCase() : unified;
+}
+//#endregion
 //#region src/shared/pendingReview.ts
 /** 待审条目在面板列表里的 id 前缀；客户端与 Host 共用这一份口径。 */
 const PENDING_PREFIX = "pending:";
@@ -10037,15 +10099,12 @@ function stableSeq(id) {
 }
 /**
 * @author ddj 2026年10月29号
-* @description: 统一路径比较口径，消除分隔符与 Windows 大小写差异；远端身份保留原大小写。
+* @description: Host 侧的路径比较口径：远端身份保留大小写，其余按运行平台折叠。
 * @param path 路径
 * @returns 比较键
 */
 function pathKey$1(path) {
-	const unified = path.replace(/\\/g, "/");
-	if (/^[a-z]+:\/\//i.test(unified)) return unified;
-	if (/^[a-z]:\//i.test(unified)) return unified.toLowerCase();
-	return process.platform === "win32" ? unified.toLowerCase() : unified;
+	return pathKeyFor(path, process.platform === "win32");
 }
 /**
 * @author ddj 2026年10月30号
@@ -12208,6 +12267,131 @@ function installRulesSection(ctx, dirs = userRuleDirs()) {
 	return true;
 }
 //#endregion
+//#region src/skillCatalog.ts
+/**
+* dsh-vscode-mode host — 技能候选枚举（全局技能 + 当前工作区技能）。
+*
+* 为什么要另起一条通道：本插件原有的 `skills.ts` 只管「随包分发的技能组」
+* （<包根>/skills，按 SKILL_PREFIXES 前缀白名单过滤）；而快捷菜单「绑定技能」需要的是
+* 用户能自由增删的两类技能目录，与 DSH 文件系统 skill provider 的两个根一致：
+* - 全局技能：`$DSH_HOME/skills`（provider rank 400 / user-dsh）
+* - 工作区技能：`<projectRoot>/.dsh/skills`（provider rank 100 / project-dsh）
+* 只读、不写盘、不缓存：每次打开配置弹窗重扫一遍（目录数量级很小）。
+*
+* 作者 ddj 2026年10月30号
+*/
+/** 单个根目录最多枚举的技能数（防失控目录拖垮弹窗）。 */
+const SKILL_CATALOG_CAP = 200;
+/** 向上找项目根的层数上限（防异常路径下的长链遍历）。 */
+const ROOT_DEPTH_CAP = 8;
+/** 目录式技能的清单文件名。 */
+const SKILL_FILE = "SKILL.md";
+/**
+* 从 cwd 向上找项目根（含 .git 的最近祖先；找不到回落 cwd）。
+* @author ddj 2026年10月30号
+* @param cwd 起始目录
+* @returns 项目根绝对路径；cwd 缺失时 undefined
+*/
+function projectRootOf(cwd) {
+	if (cwd === void 0 || cwd === "") return void 0;
+	let current = cwd;
+	for (let depth = 0; depth < ROOT_DEPTH_CAP; depth += 1) {
+		const parent = join(current, "..");
+		if (entryExists(join(current, ".git"))) return current;
+		if (parent === current) break;
+		current = parent;
+	}
+	return cwd;
+}
+/**
+* 探测路径是否存在（同步存在性判断，避免为一次 up-walk 引入异步瀑布）。
+* @author ddj 2026年10月30号
+* @param path 绝对路径
+* @returns 存在为 true
+*/
+function entryExists(path) {
+	try {
+		statSync(path);
+		return true;
+	} catch {
+		return false;
+	}
+}
+/**
+* 技能根目录（全局 + 当前工作区）。
+* @author ddj 2026年10月30号
+* @param cwd 当前工作区
+* @returns 两个根的绝对路径
+*/
+function skillRootsOf(cwd) {
+	const projectRoot = projectRootOf(cwd);
+	const project = projectRoot === void 0 ? "" : join(projectRoot, ".dsh", "skills");
+	return {
+		user: join(dshHome(), "skills"),
+		project,
+		projectRoot
+	};
+}
+/**
+* 扫描单个技能根（深度 1：<root>/<名>/SKILL.md 或 <root>/<名>.md）。
+* 目录缺失/读失败/frontmatter 非法 → 跳过该条（不抛、不返回半成品）。
+* @author ddj 2026年10月30号
+* @param dir 技能根目录
+* @param source 来源标记
+* @returns 通过校验的技能（按名字排序，受 SKILL_CATALOG_CAP 约束）
+*/
+async function listRootSkills(dir, source) {
+	if (dir === "") return [];
+	const ordered = [...await readdir(dir, { withFileTypes: true }).catch(() => [])].sort((left, right) => left.name.localeCompare(right.name)).slice(0, SKILL_CATALOG_CAP);
+	const found = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const entry of ordered) {
+		const info = await readSkillInfo(entry.name.endsWith(".md") ? join(dir, entry.name) : join(dir, entry.name, SKILL_FILE), source).catch(() => void 0);
+		if (info === void 0 || seen.has(info.name)) continue;
+		seen.add(info.name);
+		found.push(info);
+	}
+	return found.sort((left, right) => left.name.localeCompare(right.name));
+}
+/**
+* 读取并解析单个技能文件。
+* @author ddj 2026年10月30号
+* @param file 技能文件绝对路径
+* @param source 来源标记
+* @returns 技能元信息；文件缺失/不可读/frontmatter 非法时 undefined
+*/
+async function readSkillInfo(file, source) {
+	const text = await readFile(file, "utf8").catch(() => void 0);
+	if (text === void 0) return void 0;
+	const parsed = parseSkillMd(text);
+	if (!isParsedSkill(parsed)) return void 0;
+	return {
+		name: parsed.name,
+		description: parsed.description,
+		path: file,
+		source
+	};
+}
+/**
+* 枚举技能候选（全局 + 当前工作区；只读，永不抛）。
+* @author ddj 2026年10月30号
+* @param cwd 当前工作区（缺失时只枚举全局根）
+* @returns 技能候选快照
+*/
+async function listSkillCatalog(cwd) {
+	const roots = skillRootsOf(cwd);
+	const user = await listRootSkills(roots.user, "user");
+	const project = await listRootSkills(roots.project, "project");
+	return roots.projectRoot === void 0 ? {
+		user,
+		project
+	} : {
+		user,
+		project,
+		projectRoot: roots.projectRoot
+	};
+}
+//#endregion
 //#region src/snippets.ts
 /**
 * dsh-vscode-mode host — 代码片段管理（VS Code 兼容 .code-snippets 文件）。
@@ -12564,106 +12748,687 @@ async function snippetsEntries(ctx, workspacePath) {
 	if (workspacePath && registered) await load(projectSnippetsDir(workspacePath), "project");
 	return { entries: flattenSnippetEntries(loaded) };
 }
-//#endregion
-//#region src/shared/externalOpen.ts
-const OPEN_TTL_MS = 6e4;
-const OPEN_ID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/** 提示词长度上限。 */
+const QUICK_MENU_PROMPT_CAP = 8192;
+/** 技能名合法形态。 */
+const QUICK_MENU_SKILL_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/** 未命名项兜底名。 */
+const FALLBACK_NAME = "未命名";
 /**
-* Detect the host platform without importing node builtins.
-* @author ddj 2026年09月28号
-* @returns Platform name, or an empty string outside Node.
+* 数值夹取（NaN/非有限回落到 fallback）。
+* @author ddj 2026年10月30号
+* @param value 原始值
+* @param min 下限
+* @param max 上限
+* @param fallback 非法值兜底
+* @returns 夹取后的数值
 */
-function platformName() {
-	return typeof process === "object" && process !== null ? String(process.platform) : "";
+function clampNumber(value, min, max, fallback) {
+	const number = typeof value === "number" && Number.isFinite(value) ? value : fallback;
+	if (number < min) return min;
+	if (number > max) return max;
+	return number;
 }
 /**
-* Compare profile directories by physical identity, not by spelling.
-* Windows accepts either separator and folds case; other platforms stay exact.
-* @author ddj 2026年09月28号
-* @param left Declared profile directory.
-* @param right Expected profile directory.
-* @param platform Platform name for separator and case rules.
-* @returns Whether both name the same profile.
+* 取对象形态（非对象/数组返回 null）。
+* @author ddj 2026年10月30号
+* @param value 原始值
+* @returns 普通对象或 null
 */
-function sameProfile(left, right, platform = platformName()) {
-	if (platform === "win32") {
-		const fold = (value) => value.replace(/\//g, "\\").replace(/\\+$/, "").toLowerCase();
-		return fold(left) === fold(right);
-	}
-	return left.replace(/\/+$/, "") === right.replace(/\/+$/, "");
+function asRecord$1(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return null;
+	return value;
 }
-/** @public @author ddj 2026年09月28号
-* Validate the open-only envelope before accepting filesystem input.
-* @param value Parsed untrusted JSON.
-* @param profile Exact expected profile directory.
-* @param now Current epoch milliseconds.
-* @param platform Platform name used for profile identity.
-* @returns A typed request or null.
+/**
+* 取字符串（非字符串回落空串）。
+* @author ddj 2026年10月30号
+* @param value 原始值
+* @returns 字符串
 */
-function parseInboxOpen(value, profile, now = Date.now(), platform = platformName()) {
-	if (!value || typeof value !== "object") return null;
-	const row = value;
-	const keys = [
-		"version",
-		"requestId",
-		"profile",
-		"paths",
-		"line",
-		"column",
-		"createdAt"
-	];
-	if (Object.keys(row).some((key) => !keys.includes(key))) return null;
-	if (row.version !== 1 || typeof row.profile !== "string" || !sameProfile(row.profile, profile, platform) || typeof row.requestId !== "string" || !OPEN_ID.test(row.requestId)) return null;
-	if (typeof row.createdAt !== "number" || !Number.isSafeInteger(row.createdAt)) return null;
-	if (now - row.createdAt >= 6e4 || row.createdAt > now + 5e3) return null;
-	if (!Array.isArray(row.paths) || !row.paths.length || row.paths.length > 20) return null;
-	if (!row.paths.every((path) => typeof path === "string" && path.length <= 8192 && !/[\u0000-\u001f]/.test(path) && /^(?:\/|[a-z]:[\\/]|\\\\)/i.test(path))) return null;
-	for (const key of ["line", "column"]) if (row[key] !== void 0 && (!Number.isSafeInteger(row[key]) || Number(row[key]) < 1)) return null;
-	return row;
+function asString$1(value) {
+	return typeof value === "string" ? value : "";
 }
-//#endregion
-//#region src/externalHandoff.ts
-const pending = /* @__PURE__ */ new Map();
-const LEASE_MS = 3e4;
-let lastPollAt = 0;
-/** @public @author ddj 2026年09月28号
-* Queue a bounded request without replacing earlier opens.
-* @param req Paths and navigation coordinates.
-* @param token Optional inbox request ID.
-* @param createdAt Original producer timestamp; queue ingestion never extends it.
-* @returns Presence and stable request token.
+/**
+* 文本截断（超长补省略号）。
+* @author ddj 2026年10月30号
+* @param text 原文
+* @param cap 上限字符数
+* @returns 截断后文本
 */
-function handoffOpen(req, token = randomUUID(), createdAt = Date.now()) {
-	prunePending();
-	const clients = Date.now() - lastPollAt <= 15e3 ? 1 : 0;
-	if (!Number.isSafeInteger(createdAt) || createdAt + 6e4 <= Date.now()) return {
-		token,
-		clients
-	};
-	if (!pending.has(token)) {
-		if (pending.size >= 128) throw new Error("外部打开队列已满");
-		pending.set(token, {
-			...req,
-			paths: [...req.paths],
-			token,
-			at: createdAt
-		});
-	}
+function cutText(text, cap) {
+	if (text.length <= cap) return text;
+	return text.slice(0, Math.max(0, cap - 1)) + "…";
+}
+/**
+* 归一化工作区路径（统一分隔符、去尾分隔符、win32 转小写），用于比较而非展示。
+* @author ddj 2026年10月30号
+* @param path 原始路径
+* @returns 归一化路径
+*/
+function normalizePath(path) {
+	const unified = path.trim().replace(/\//g, "\\").replace(/\\+$/, "");
+	if (unified === "") return "";
+	return unified.toLowerCase();
+}
+/**
+* 默认文档（首次打开菜单时的初始状态）。
+* @author ddj 2026年10月30号
+* @returns 默认文档
+*/
+function defaultDoc() {
 	return {
-		token,
-		clients
+		version: 1,
+		revision: 0,
+		updatedAt: "",
+		enabled: true,
+		clickAction: "send",
+		maxDepth: 3,
+		launcher: {
+			x: null,
+			y: null
+		},
+		items: []
 	};
 }
-/** @public @author ddj 2026年09月28号
-* Claim one request; repeated heartbeats renew this client's active lease.
-* @param args Authenticated page identity.
-* @returns A leased request or null.
+/**
+* 归一化限定工作区列表（去空、去重、归一化；空结果回落到 null=全部）。
+* @author ddj 2026年10月30号
+* @param raw 原始值
+* @returns 限定列表或 null
 */
-function pollPending(args) {
-	lastPollAt = Date.now();
-	prunePending();
-	if (!args?.clientId || args.clientId.length > 128) return null;
-	const active = [...pending.values()].find((row) => row.clientId === args.clientId && row.success === void 0);
+function normalizeWorkspaces(raw) {
+	if (!Array.isArray(raw)) return null;
+	const out = [];
+	for (const entry of raw) {
+		if (typeof entry !== "string") continue;
+		const normalized = normalizePath(entry);
+		if (normalized === "") continue;
+		if (out.includes(normalized)) continue;
+		out.push(normalized);
+	}
+	return out.length > 0 ? out : null;
+}
+/**
+* 绑定规则的稳定键（校验、去重、内联正文映射共用）。
+* @author ddj 2026年10月30号
+* @param binding 规则绑定
+* @returns 键
+*/
+function bindingKey(binding) {
+	const workspace = normalizePath(binding.workspacePath ?? "");
+	return binding.scope + "|" + workspace + "|" + binding.file;
+}
+/**
+* 归一化单条规则绑定（scope/file 必填，项目规则必须带工作区）。
+* @author ddj 2026年10月30号
+* @param raw 原始值
+* @returns 绑定或 null
+*/
+function normalizeRule(raw) {
+	const record = asRecord$1(raw);
+	if (!record) return null;
+	const file = asString$1(record.file).trim();
+	if (file === "") return null;
+	const scope = record.scope === "project" ? "project" : "user";
+	const binding = {
+		scope,
+		file
+	};
+	if (scope === "project") {
+		const workspacePath = asString$1(record.workspacePath).trim();
+		if (workspacePath === "") return null;
+		binding.workspacePath = workspacePath;
+	}
+	if (record.origin === "current" || record.origin === "legacy") binding.origin = record.origin;
+	return binding;
+}
+/**
+* 归一化规则绑定列表（去重 + 上限）。
+* @author ddj 2026年10月30号
+* @param raw 原始值
+* @returns 绑定列表
+*/
+function normalizeRules(raw) {
+	if (!Array.isArray(raw)) return [];
+	const out = [];
+	for (const entry of raw) {
+		const binding = normalizeRule(entry);
+		if (!binding) continue;
+		if (out.some((existing) => bindingKey(existing) === bindingKey(binding))) continue;
+		out.push(binding);
+	}
+	return out.slice(0, 24);
+}
+/**
+* 归一化技能名列表（只保留 kebab-case，去重 + 上限）。
+* @author ddj 2026年10月30号
+* @param raw 原始值
+* @returns 技能名列表
+*/
+function normalizeSkills(raw) {
+	if (!Array.isArray(raw)) return [];
+	const out = [];
+	for (const entry of raw) {
+		if (typeof entry !== "string") continue;
+		const name = entry.trim();
+		if (name === "" || !QUICK_MENU_SKILL_RE.test(name)) continue;
+		if (out.includes(name)) continue;
+		out.push(name);
+	}
+	return out.slice(0, 24);
+}
+/**
+* 归一化单个菜单项（非法类型/缺 id 返回 null）。
+* @author ddj 2026年10月30号
+* @param raw 原始值
+* @returns 菜单项或 null
+*/
+function normalizeItem(raw) {
+	const record = asRecord$1(raw);
+	if (!record) return null;
+	const type = record.type === "group" ? "group" : "button";
+	const id = asString$1(record.id).trim();
+	if (id === "") return null;
+	const name = cutText(asString$1(record.name).trim() || FALLBACK_NAME, 40);
+	const order = clampNumber(record.order, 0, 999, 100);
+	const rawParent = record.parentId;
+	const base = {
+		id,
+		type,
+		name,
+		order,
+		parentId: typeof rawParent === "string" && rawParent.trim() !== "" ? rawParent.trim() : null,
+		workspaces: normalizeWorkspaces(record.workspaces)
+	};
+	if (type === "group") return {
+		...base,
+		type: "group"
+	};
+	const button = {
+		...base,
+		type: "button",
+		prompt: cutText(asString$1(record.prompt), QUICK_MENU_PROMPT_CAP),
+		skills: normalizeSkills(record.skills),
+		rules: normalizeRules(record.rules),
+		ruleMode: record.ruleMode === "inline" ? "inline" : "reference"
+	};
+	if (record.clickAction === "send" || record.clickAction === "fill") button.clickAction = record.clickAction;
+	return button;
+}
+/**
+* 判断从起点上溯的父链是否会回到目标项（环检测；超深链也按非法处理）。
+* @author ddj 2026年10月30号
+* @param byId id → 项
+* @param startId 起点父 id
+* @param targetId 目标项 id
+* @returns 是否成环
+*/
+function chainHas(byId, startId, targetId) {
+	let current = startId;
+	let guard = 0;
+	while (current !== null) {
+		if (current === targetId) return true;
+		if (guard > 7) return true;
+		const parent = byId.get(current);
+		if (!parent) return false;
+		current = parent.parentId;
+		guard += 1;
+	}
+	return false;
+}
+/**
+* 修补父链问题：父不存在/父是按钮/自指/形成环时把子项上抬到最近合法祖组或顶层。
+* @author ddj 2026年10月30号
+* @param items 归一化后的项
+* @returns 修补后的项
+*/
+function repairParents(items) {
+	const byId = /* @__PURE__ */ new Map();
+	for (const item of items) byId.set(item.id, item);
+	for (const item of items) {
+		let resolved = item.parentId;
+		let guard = 0;
+		while (resolved !== null && guard <= 7) {
+			const parent = byId.get(resolved);
+			if (!parent) {
+				resolved = null;
+				break;
+			}
+			if (parent.type === "group") break;
+			resolved = parent.parentId;
+			guard += 1;
+		}
+		if (resolved !== null && chainHas(byId, resolved, item.id)) resolved = null;
+		item.parentId = resolved;
+	}
+	return items;
+}
+/**
+* 按父级分组重排优先级（order 归一为 10/20/30…，保证展示稳定且无并列）。
+* @author ddj 2026年10月30号
+* @param items 菜单项
+* @returns 同一数组（就地写入 order）
+*/
+function normalizeOrder(items) {
+	const groups = /* @__PURE__ */ new Map();
+	for (const item of items) {
+		const key = item.parentId ?? "";
+		const bucket = groups.get(key);
+		if (bucket) bucket.push(item);
+		else groups.set(key, [item]);
+	}
+	for (const bucket of groups.values()) {
+		bucket.sort((left, right) => {
+			if (left.order !== right.order) return left.order - right.order;
+			if (left.name !== right.name) return left.name < right.name ? -1 : 1;
+			return left.id < right.id ? -1 : 1;
+		});
+		bucket.forEach((item, index) => {
+			item.order = (index + 1) * 10;
+		});
+	}
+	return items;
+}
+/**
+* 归一化整份文档（任何脏数据都收敛到可用形态，绝不抛错）。
+* @author ddj 2026年10月30号
+* @param raw 原始值（JSON.parse 结果或任意 unknown）
+* @returns 合法文档
+*/
+function normalizeDoc(raw) {
+	const fallback = defaultDoc();
+	const record = asRecord$1(raw);
+	if (!record) return fallback;
+	const rawItems = Array.isArray(record.items) ? record.items : [];
+	const seen = /* @__PURE__ */ new Set();
+	const items = [];
+	for (const entry of rawItems) {
+		const item = normalizeItem(entry);
+		if (!item || seen.has(item.id)) continue;
+		seen.add(item.id);
+		items.push(item);
+		if (items.length >= 200) break;
+	}
+	const x = typeof record.launcher === "object" && record.launcher !== null ? asRecord$1(record.launcher) : null;
+	return {
+		version: 1,
+		revision: Math.floor(clampNumber(record.revision, 0, Number.MAX_SAFE_INTEGER, 0)),
+		updatedAt: cutText(asString$1(record.updatedAt), 40),
+		enabled: typeof record.enabled === "boolean" ? record.enabled : true,
+		clickAction: record.clickAction === "fill" ? "fill" : "send",
+		maxDepth: Math.round(clampNumber(record.maxDepth, 1, 5, 3)),
+		launcher: {
+			x: x && typeof x.x === "number" && Number.isFinite(x.x) ? x.x : null,
+			y: x && typeof x.y === "number" && Number.isFinite(x.y) ? x.y : null
+		},
+		items: normalizeOrder(repairParents(items))
+	};
+}
+/**
+* 结构迁移入口（当前只有 v1；后续版本在此收敛旧结构）。
+* @author ddj 2026年10月30号
+* @param raw 原始值
+* @returns 合法文档
+*/
+function migrateDoc(raw) {
+	return normalizeDoc(raw);
+}
+/**
+* 序列化文档（host 落盘与导入导出共用）。
+* @author ddj 2026年10月30号
+* @param doc 文档
+* @returns JSON 文本
+*/
+function serializeDoc(doc) {
+	return JSON.stringify(normalizeDoc(doc), null, 2);
+}
+/**
+* 解析文档文本（解析失败返回默认文档并给出告警文案）。
+* @author ddj 2026年10月30号
+* @param text 文件内容
+* @returns 文档 + 可选告警
+*/
+function parseDoc(text) {
+	try {
+		return { doc: migrateDoc(JSON.parse(text)) };
+	} catch (error) {
+		const reason = error instanceof Error ? error.message : String(error);
+		return {
+			doc: defaultDoc(),
+			warning: "快捷菜单配置解析失败（" + reason + "），已回落默认配置"
+		};
+	}
+}
+//#endregion
+//#region src/quickMenu.ts
+/**
+* dsh-vscode-mode host — 快捷菜单配置的读写（~/.dsh/dsh-vscode-mode/data/quick-menu.json）。
+*
+* 为什么单独成模块：菜单项是用户数据而不是界面镜像——不能落在 cache/（会被 sweep、
+* 且与 uiState 共享 512KB 预算），也不适合塞进 Config schema（嵌套 JSON 不参与校验）。
+* 写入约定：revision 乐观并发 + 同文件串行队列 + tmp 原子替换 + 单代 .bak 备份，
+* 解析失败时把原文件另存 .bad-<ts>.json 再回落默认文档，绝不让坏文件阻塞功能。
+* 作者 ddj 2026年10月30号
+*/
+/** mtime 缓存（文件未变则复用解析结果，避免每次打开菜单都读盘）。 */
+const stateCache = /* @__PURE__ */ new Map();
+/** 同文件写队列尾（串行化并发写入；队列清空即移除条目，与 uiState 同套路）。 */
+const writeChains$1 = /* @__PURE__ */ new Map();
+/**
+* 把写任务挂到该文件的队尾串行执行（前序失败不影响后续）。
+* @author ddj 2026年10月30号
+* @param file 目标文件绝对路径
+* @param run 实际写操作
+* @returns 本次写操作结果
+*/
+function chainWrite$1(file, run) {
+	const next = (writeChains$1.get(file) ?? Promise.resolve()).then(run, run);
+	const tail = next.then(() => void 0, () => void 0);
+	writeChains$1.set(file, tail);
+	tail.then(() => {
+		if (writeChains$1.get(file) === tail) writeChains$1.delete(file);
+	});
+	return next;
+}
+/**
+* 读取文件修改时间（缺失/不可读返回 0）。
+* @author ddj 2026年10月30号
+* @param file 文件路径
+* @returns mtime 毫秒
+*/
+async function mtimeOf(file) {
+	try {
+		return (await stat(file)).mtimeMs;
+	} catch {
+		return 0;
+	}
+}
+/**
+* 原子写文本（先写 .tmp 再改名，缺目录自动建；失败时尽量清掉临时文件）。
+* @author ddj 2026年10月30号
+* @param file 目标文件
+* @param text 文本
+*/
+async function writeAtomic(file, text) {
+	await mkdir(dirname(file), { recursive: true });
+	const temporary = file + ".tmp";
+	await writeFile(temporary, text, "utf8");
+	await rename(temporary, file);
+}
+/**
+* 把坏文件另存为 .bad-<ts>.json（尽力而为，失败不影响主流程）。
+* @author ddj 2026年10月30号
+* @param file 源文件
+* @returns 备份路径（失败为 null）
+*/
+async function backupCorrupt(file) {
+	const target = file + ".bad-" + Date.now() + ".json";
+	try {
+		await copyFile(file, target);
+		return target;
+	} catch {
+		return null;
+	}
+}
+/**
+* 把上一次内容写成单代备份（quick-menu.bak.json）。
+* @author ddj 2026年10月30号
+* @param file 源文件
+*/
+async function backupPrevious(file) {
+	try {
+		await copyFile(file, file.replace(/\.json$/, "") + ".bak.json");
+	} catch {}
+}
+/**
+* 读盘并归一（绕过缓存；文件缺失按默认文档处理）。
+* @author ddj 2026年10月30号
+* @param file 文件路径
+* @returns 文档 + 告警 + mtime
+*/
+async function loadFile(file) {
+	const mtime = await mtimeOf(file);
+	if (mtime === 0) return {
+		doc: defaultDoc(),
+		mtime: 0
+	};
+	let text = "";
+	try {
+		text = await readFile(file, "utf8");
+	} catch (error) {
+		const reason = error instanceof Error ? error.message : String(error);
+		return {
+			doc: defaultDoc(),
+			warning: "快捷菜单配置读取失败（" + reason + "），已回落默认配置",
+			mtime
+		};
+	}
+	const parsed = parseDoc(text);
+	if (!parsed.warning) return {
+		doc: parsed.doc,
+		mtime
+	};
+	const backup = await backupCorrupt(file);
+	const doc = parsed.doc;
+	try {
+		await writeAtomic(file, serializeDoc(doc));
+	} catch {}
+	const hint = backup ? "已备份为 " + backup : "备份失败";
+	return {
+		doc,
+		warning: parsed.warning + "（" + hint + "）",
+		mtime
+	};
+}
+/**
+* 读取快捷菜单文档（mtime 未变时复用缓存）。
+* @author ddj 2026年10月30号
+* @param home DSH home（测试可注入）
+* @returns 文档 + 告警
+*/
+async function readQuickMenu(home) {
+	const file = quickMenuFile(home);
+	const mtime = await mtimeOf(file);
+	const cached = stateCache.get(file);
+	if (cached && cached.mtime === mtime) return cached;
+	const state = await loadFile(file);
+	stateCache.set(file, state);
+	return state;
+}
+/**
+* 校验待保存文档的硬性上限（超出即拒绝，避免静默截断用户数据）。
+* @author ddj 2026年10月30号
+* @param doc 待保存文档
+* @returns 错误文案（合法为 null）
+*/
+function checkLimits(doc) {
+	if (doc.items.length > 200) return "菜单项超过上限（200 项）";
+	if (Buffer.byteLength(serializeDoc(doc), "utf8") > 262144) return "配置超出容量上限（262144 字节）";
+	return null;
+}
+/**
+* 保存文档（revision 不匹配即判定为并发冲突，返回磁盘最新文档）。
+* @author ddj 2026年10月30号
+* @param doc 客户端提交的完整文档
+* @param baseRevision 客户端读到的 revision
+* @param home DSH home（测试可注入）
+* @returns 保存结果
+*/
+async function saveQuickMenu(doc, baseRevision, home) {
+	const file = quickMenuFile(home);
+	return chainWrite$1(file, async () => {
+		const limit = checkLimits(doc);
+		if (limit) return {
+			ok: false,
+			error: limit
+		};
+		const current = await loadFile(file);
+		if (current.doc.revision !== baseRevision) return {
+			ok: false,
+			error: "配置已被其他窗口修改，请重新加载后再保存",
+			doc: current.doc
+		};
+		const next = normalizeDoc(doc);
+		next.launcher = current.doc.launcher;
+		next.revision = current.doc.revision + 1;
+		next.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+		try {
+			await backupPrevious(file);
+			await writeAtomic(file, serializeDoc(next));
+		} catch (error) {
+			return {
+				ok: false,
+				error: "快捷菜单配置写入失败：" + (error instanceof Error ? error.message : String(error))
+			};
+		}
+		const state = {
+			doc: next,
+			mtime: await mtimeOf(file)
+		};
+		stateCache.set(file, state);
+		return {
+			ok: true,
+			doc: next
+		};
+	});
+}
+/**
+* 只更新悬浮按钮坐标（不推进 revision，避免拖拽把正在编辑的表单顶掉）。
+* @author ddj 2026年10月30号
+* @param launcher 坐标（null 表示回到输入框锚点）
+* @param home DSH home（测试可注入）
+* @returns 保存结果
+*/
+async function patchLauncher(launcher, home) {
+	const file = quickMenuFile(home);
+	return chainWrite$1(file, async () => {
+		const next = {
+			...(await loadFile(file)).doc,
+			launcher: {
+				x: launcher.x,
+				y: launcher.y
+			},
+			updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+		};
+		try {
+			await writeAtomic(file, serializeDoc(next));
+		} catch (error) {
+			return {
+				ok: false,
+				error: "保存悬浮按钮位置失败：" + (error instanceof Error ? error.message : String(error))
+			};
+		}
+		const state = {
+			doc: next,
+			mtime: await mtimeOf(file)
+		};
+		stateCache.set(file, state);
+		return {
+			ok: true,
+			doc: next
+		};
+	});
+}
+//#endregion
+//#region src/shared/externalOpen.ts
+const OPEN_TTL_MS = 6e4;
+const OPEN_ID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/**
+* Detect the host platform without importing node builtins.
+* @author ddj 2026年09月28号
+* @returns Platform name, or an empty string outside Node.
+*/
+function platformName() {
+	return typeof process === "object" && process !== null ? String(process.platform) : "";
+}
+/**
+* Compare profile directories by physical identity, not by spelling.
+* Windows accepts either separator and folds case; other platforms stay exact.
+* @author ddj 2026年09月28号
+* @param left Declared profile directory.
+* @param right Expected profile directory.
+* @param platform Platform name for separator and case rules.
+* @returns Whether both name the same profile.
+*/
+function sameProfile(left, right, platform = platformName()) {
+	if (platform === "win32") {
+		const fold = (value) => value.replace(/\//g, "\\").replace(/\\+$/, "").toLowerCase();
+		return fold(left) === fold(right);
+	}
+	return left.replace(/\/+$/, "") === right.replace(/\/+$/, "");
+}
+/** @public @author ddj 2026年09月28号
+* Validate the open-only envelope before accepting filesystem input.
+* @param value Parsed untrusted JSON.
+* @param profile Exact expected profile directory.
+* @param now Current epoch milliseconds.
+* @param platform Platform name used for profile identity.
+* @returns A typed request or null.
+*/
+function parseInboxOpen(value, profile, now = Date.now(), platform = platformName()) {
+	if (!value || typeof value !== "object") return null;
+	const row = value;
+	const keys = [
+		"version",
+		"requestId",
+		"profile",
+		"paths",
+		"line",
+		"column",
+		"createdAt"
+	];
+	if (Object.keys(row).some((key) => !keys.includes(key))) return null;
+	if (row.version !== 1 || typeof row.profile !== "string" || !sameProfile(row.profile, profile, platform) || typeof row.requestId !== "string" || !OPEN_ID.test(row.requestId)) return null;
+	if (typeof row.createdAt !== "number" || !Number.isSafeInteger(row.createdAt)) return null;
+	if (now - row.createdAt >= 6e4 || row.createdAt > now + 5e3) return null;
+	if (!Array.isArray(row.paths) || !row.paths.length || row.paths.length > 20) return null;
+	if (!row.paths.every((path) => typeof path === "string" && path.length <= 8192 && !/[\u0000-\u001f]/.test(path) && /^(?:\/|[a-z]:[\\/]|\\\\)/i.test(path))) return null;
+	for (const key of ["line", "column"]) if (row[key] !== void 0 && (!Number.isSafeInteger(row[key]) || Number(row[key]) < 1)) return null;
+	return row;
+}
+//#endregion
+//#region src/externalHandoff.ts
+const pending = /* @__PURE__ */ new Map();
+const LEASE_MS = 3e4;
+let lastPollAt = 0;
+/** @public @author ddj 2026年09月28号
+* Queue a bounded request without replacing earlier opens.
+* @param req Paths and navigation coordinates.
+* @param token Optional inbox request ID.
+* @param createdAt Original producer timestamp; queue ingestion never extends it.
+* @returns Presence and stable request token.
+*/
+function handoffOpen(req, token = randomUUID(), createdAt = Date.now()) {
+	prunePending();
+	const clients = Date.now() - lastPollAt <= 15e3 ? 1 : 0;
+	if (!Number.isSafeInteger(createdAt) || createdAt + 6e4 <= Date.now()) return {
+		token,
+		clients
+	};
+	if (!pending.has(token)) {
+		if (pending.size >= 128) throw new Error("外部打开队列已满");
+		pending.set(token, {
+			...req,
+			paths: [...req.paths],
+			token,
+			at: createdAt
+		});
+	}
+	return {
+		token,
+		clients
+	};
+}
+/** @public @author ddj 2026年09月28号
+* Claim one request; repeated heartbeats renew this client's active lease.
+* @param args Authenticated page identity.
+* @returns A leased request or null.
+*/
+function pollPending(args) {
+	lastPollAt = Date.now();
+	prunePending();
+	if (!args?.clientId || args.clientId.length > 128) return null;
+	const active = [...pending.values()].find((row) => row.clientId === args.clientId && row.success === void 0);
 	if (active && Date.now() - (active.leaseAt ?? 0) < LEASE_MS) {
 		active.leaseAt = Date.now();
 		return null;
@@ -15335,38 +16100,67 @@ function reviewHandlers(ctx, registry) {
 //#endregion
 //#region src/pendingRpc.ts
 /**
-* @author ddj 2026年10月29号
-* @description: 待审投影处理器。读路径允许跨实例冷读，写路径必须本端 live 会话。
+* @author ddj 2026年10月30号
+* @description: 解析会话工作区并预热记录桶；读路径也走它，避免冷读时桶未就绪。
 * @param ctx Host 上下文
 * @param registry 工作区记录桶缓存
-* @returns 待审相关处理器表
+* @param sessionId 请求作用域
+* @returns 工作区路径
 */
-function pendingHandlers(ctx, registry) {
-	/** @private @author ddj 2026年10月29号 @param sessionId 请求作用域 @returns 工作区 */
-	async function workspace(sessionId) {
-		const scope = await resolveScope(ctx, sessionId);
-		if ("err" in scope) throw new Error("会话不存在或没有工作区");
-		await bucketOf(registry, ctx, scope.cwd);
-		return scope.cwd;
-	}
-	/** @private @author ddj 2026年10月29号 @param sessionId 请求作用域 @returns 本端 live 会话的工作区 */
-	async function liveWorkspace(sessionId) {
-		const cwd = await workspace(sessionId);
-		if (!sessionOf(ctx, sessionId)) throw new Error("写入要求本端活跃会话");
-		return cwd;
-	}
-	/**
-	* @private
-	* @author ddj 2026年10月30号
-	* @description: 面板列表里的条目 id 带待审前缀（用于和官方条目区分），
-	* 而待审内核按原始身份存取；各处理器统一走 pendingRawId 剥掉前缀。
-	* @param id 请求里的条目 id
-	* @returns 待审内核使用的原始 id
-	*/
-	const rawId = pendingRawId;
+async function workspaceOf(ctx, registry, sessionId) {
+	const scope = await resolveScope(ctx, sessionId);
+	if ("err" in scope) throw new Error("会话不存在或没有工作区");
+	await bucketOf(registry, ctx, scope.cwd);
+	return scope.cwd;
+}
+/**
+* @author ddj 2026年10月30号
+* @description: 写路径专用的工作区解析：本端没有该会话就直接拒绝，不做跨实例写。
+* @param ctx Host 上下文
+* @param registry 工作区记录桶缓存
+* @param sessionId 请求作用域
+* @returns 工作区路径
+*/
+async function writeWorkspaceOf(ctx, registry, sessionId) {
+	const cwd = await workspaceOf(ctx, registry, sessionId);
+	if (!sessionOf(ctx, sessionId)) throw new Error("写入要求本端活跃会话");
+	return cwd;
+}
+/**
+* @author ddj 2026年10月30号
+* @description: 把异常归一成可播报文案，避免处理器各自重复三元表达式。
+* @param error 捕获到的异常
+* @returns 错误文案
+*/
+function failureOf(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+/**
+* @author ddj 2026年10月30号
+* @description: 按会话策略包装 shell：执行器默认按 workspace-write 跑，本机无可用沙箱后端会直接拒绝。
+* @param raw 原始 shell 能力
+* @param policy 会话沙箱策略
+* @returns 带策略的 shell 视图
+*/
+function shellOf(raw, policy) {
+	return {
+		resolve: (request) => raw.resolve(policy ? {
+			...request,
+			sandboxPolicy: policy
+		} : request),
+		execute: (spec) => raw.execute(spec)
+	};
+}
+/**
+* @author ddj 2026年10月30号
+* @description: 读路径处理器：列表与详情，允许跨实例冷读。
+* @param kit 作用域能力
+* @returns 处理器表
+*/
+function readHandlers(kit) {
 	return {
 		"edrv.pending.list": async (args) => {
-			const cwd = await workspace(args.sessionId);
+			const cwd = await kit.read(args.sessionId);
 			const page = loadPage(cwd, args.sessionId);
 			for (const item of page.items) trackPendingCover(cwd, item.path, true);
 			return {
@@ -15375,7 +16169,7 @@ function pendingHandlers(ctx, registry) {
 			};
 		},
 		"edrv.pending.detail": async (args) => {
-			const detail = loadDetail(await workspace(args.sessionId), rawId(args.id));
+			const detail = loadDetail(await kit.read(args.sessionId), pendingRawId(args.id));
 			return detail ? {
 				ok: true,
 				detail
@@ -15383,39 +16177,49 @@ function pendingHandlers(ctx, registry) {
 				ok: false,
 				error: "待审条目不存在"
 			};
-		},
+		}
+	};
+}
+/**
+* @author ddj 2026年10月30号
+* @description: 判定处理器：Keep/Revert 与已解决条目移除，都会改变待审状态。
+* @param kit 作用域能力
+* @returns 处理器表
+*/
+function decideHandlers(kit) {
+	return {
 		"edrv.pending.decide": async (args) => {
-			const cwd = await liveWorkspace(args.sessionId);
+			const cwd = await kit.write(args.sessionId);
+			const id = pendingRawId(args.id);
 			try {
-				const id = rawId(args.id);
-				const result = await applyDecide(ctx.get("fs"), cwd, {
+				const policy = policyOf(kit.ctx, sessionOf(kit.ctx, args.sessionId));
+				const result = await applyDecide(kit.ctx.get("fs"), cwd, {
 					...args,
 					id
-				}, void 0, policyOf(ctx, sessionOf(ctx, args.sessionId)));
+				}, void 0, policy);
 				if (!result.ok) return {
 					ok: false,
 					error: result.reason
 				};
 				const detail = loadDetail(cwd, id);
-				if (!detail) return {
-					ok: false,
-					error: "待审条目不存在"
-				};
-				return {
+				return detail ? {
 					ok: true,
 					item: detail.item,
 					wrote: result.wrote
+				} : {
+					ok: false,
+					error: "待审条目不存在"
 				};
 			} catch (error) {
 				return {
 					ok: false,
-					error: error instanceof Error ? error.message : String(error)
+					error: failureOf(error)
 				};
 			}
 		},
 		"edrv.pending.remove": async (args) => {
-			const cwd = await liveWorkspace(args.sessionId);
-			const id = rawId(args.id);
+			const cwd = await kit.write(args.sessionId);
+			const id = pendingRawId(args.id);
 			const path = loadEntries(cwd).find((stored) => stored.entry.id === id)?.entry.path;
 			const removed = removeEntry(cwd, id, args.revision);
 			if (removed && path) trackPendingCover(cwd, path, false);
@@ -15423,49 +16227,59 @@ function pendingHandlers(ctx, registry) {
 				ok: true,
 				removed
 			};
-		},
-		"edrv.pending.history": async (args) => {
-			const cwd = await liveWorkspace(args.sessionId);
-			try {
-				const result = await undoDecide(ctx.get("fs"), cwd, args, void 0, policyOf(ctx, sessionOf(ctx, args.sessionId)));
-				if (!result.ok) return {
-					ok: false,
-					error: result.reason
-				};
-				return {
-					ok: true,
-					item: result.item,
-					wrote: result.wrote
-				};
-			} catch (error) {
-				return {
-					ok: false,
-					error: error instanceof Error ? error.message : String(error)
-				};
-			}
-		},
+		}
+	};
+}
+/**
+* @author ddj 2026年10月30号
+* @description: 历史处理器：撤销/重做一次决定。
+* @param kit 作用域能力
+* @returns 处理器表
+*/
+function historyHandlers(kit) {
+	return { "edrv.pending.history": async (args) => {
+		const cwd = await kit.write(args.sessionId);
+		const policy = policyOf(kit.ctx, sessionOf(kit.ctx, args.sessionId));
+		try {
+			const result = await undoDecide(kit.ctx.get("fs"), cwd, args, void 0, policy);
+			return result.ok ? {
+				ok: true,
+				item: result.item,
+				wrote: result.wrote
+			} : {
+				ok: false,
+				error: result.reason
+			};
+		} catch (error) {
+			return {
+				ok: false,
+				error: failureOf(error)
+			};
+		}
+	} };
+}
+/**
+* @author ddj 2026年10月30号
+* @description: 投影维护处理器：从版本库导入、按磁盘现状刷新单条。
+* @param kit 作用域能力
+* @returns 处理器表
+*/
+function refreshHandlers(kit) {
+	return {
 		"edrv.pending.import": async (args) => {
-			const cwd = await liveWorkspace(args.sessionId);
-			const raw = ctx.get("shell");
+			const cwd = await kit.write(args.sessionId);
+			const raw = kit.ctx.get("shell");
 			if (!raw) return {
 				ok: false,
 				error: "当前环境没有 shell 能力，无法读取版本库基线"
 			};
-			const policy = policyOf(ctx, sessionOf(ctx, args.sessionId));
-			const shell = {
-				resolve: (request) => raw.resolve(policy ? {
-					...request,
-					sandboxPolicy: policy
-				} : request),
-				execute: (spec) => raw.execute(spec)
-			};
+			const policy = policyOf(kit.ctx, sessionOf(kit.ctx, args.sessionId));
 			try {
-				const result = await importFromVcs(shell, cwd, args.sessionId, {
+				const result = await importFromVcs(shellOf(raw, policy), cwd, args.sessionId, {
 					includeUntracked: args.includeUntracked,
 					path: args.path
 				});
-				const page = loadPage(cwd, args.sessionId);
-				for (const item of page.items) trackPendingCover(cwd, item.path, true);
+				for (const item of loadPage(cwd, args.sessionId).items) trackPendingCover(cwd, item.path, true);
 				return {
 					ok: true,
 					imported: result.imported,
@@ -15474,20 +16288,20 @@ function pendingHandlers(ctx, registry) {
 			} catch (error) {
 				return {
 					ok: false,
-					error: error instanceof Error ? error.message : String(error)
+					error: failureOf(error)
 				};
 			}
 		},
 		"edrv.pending.refresh": async (args) => {
-			const cwd = await liveWorkspace(args.sessionId);
-			const id = rawId(args.id);
+			const cwd = await kit.write(args.sessionId);
+			const id = pendingRawId(args.id);
 			const stored = loadEntries(cwd).find((entry) => entry.entry.id === id);
 			if (!stored) return {
 				ok: false,
 				error: "待审条目不存在"
 			};
-			const session = sessionOf(ctx, args.sessionId);
-			const fs = ctx.get("fs");
+			const fs = kit.ctx.get("fs");
+			const session = sessionOf(kit.ctx, args.sessionId);
 			const content = await readText(fs, await fs.resolve(id, {
 				cwd,
 				agent: session
@@ -15505,6 +16319,26 @@ function pendingHandlers(ctx, registry) {
 		}
 	};
 }
+/**
+* @author ddj 2026年10月29号
+* @description: 待审投影处理器表：按用途拆成读/判定/历史/维护四组，便于分别收敛权限。
+* @param ctx Host 上下文
+* @param registry 工作区记录桶缓存
+* @returns 待审相关处理器表
+*/
+function pendingHandlers(ctx, registry) {
+	const kit = {
+		ctx,
+		read: (sessionId) => workspaceOf(ctx, registry, sessionId),
+		write: (sessionId) => writeWorkspaceOf(ctx, registry, sessionId)
+	};
+	return {
+		...readHandlers(kit),
+		...decideHandlers(kit),
+		...historyHandlers(kit),
+		...refreshHandlers(kit)
+	};
+}
 //#endregion
 //#region src/missingReview.ts
 /** Missing historical files: frozen, whole-file deletion reviews. */
@@ -17914,6 +18748,19 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 				};
 			}
 		},
+		"skills.list": async (args) => {
+			try {
+				return {
+					ok: true,
+					...await listSkillCatalog(args?.cwd)
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					error: "读取技能候选失败：" + String(error)
+				};
+			}
+		},
 		"snippets.list": async () => {
 			try {
 				return {
@@ -17977,6 +18824,60 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 					error: "读取代码片段条目失败：" + String(error)
 				};
 			}
+		},
+		"quickMenu.get": async () => {
+			try {
+				const state = await readQuickMenu();
+				return {
+					ok: true,
+					doc: state.doc,
+					warning: state.warning
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					error: "读取快捷菜单失败：" + String(error)
+				};
+			}
+		},
+		"quickMenu.save": async (args) => {
+			try {
+				const result = await saveQuickMenu(args.doc, args.baseRevision);
+				if (!result.ok) return {
+					ok: false,
+					error: result.error
+				};
+				return {
+					ok: true,
+					doc: result.doc
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					error: "保存快捷菜单失败：" + String(error)
+				};
+			}
+		},
+		"quickMenu.launcher": async (args) => {
+			try {
+				const result = await patchLauncher({
+					x: args.x,
+					y: args.y
+				});
+				if (!result.ok) return {
+					ok: false,
+					error: result.error
+				};
+				return {
+					ok: true,
+					doc: result.doc
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					error: "保存悬浮按钮位置失败：" + String(error)
+				};
+			}
 		}
 	};
 }
@@ -28415,7 +29316,7 @@ function attachRuntime(ctx, runtime) {
 		evidence.persist(cwd, snapshot);
 		return true;
 	});
-	const pending = installPendingCapture(ctx, (write) => {
+	const pending = installPending(ctx, (write) => {
 		try {
 			trackPendingCover(write.cwd, write.path, true);
 		} catch {}