dsh-vscode-mode 0.11.0 → 0.12.0

package/lib/index.js

@@ -118,6 +118,8 @@ async function refreshMcp(ctx, id) {
 * `|` 连接多个候选（任一命中即触发），如 `Alt+ArrowLeft|Ctrl+Alt+-`。
 * 约束：本模块被 host 与 client 两半共用，**禁止 import client 侧模块**（React/浏览器 API）。
 * 与 client/ui/commandCatalog 的一致性由 tests/commands.test.ts 断言兜底。
+* 官方机制（2026-10）：SHORTCUT_PROFILES 描述各命令在官方 ctx.shortcuts 的 profile 默认键位
+* （由 client 注册官方服务时使用）；chordToBinding/bindingToChord 负责插件弦与官方绑定互转。
 * 作者 ddj 2026年08月26号 / 2026年09月10号
 */
 /** 命令 id → 默认键位（可为多候选）。命令目录以此为准，新增命令只需加一项。 */
@@ -900,6 +902,9 @@ async function updateSection(provider, ns, patch, expectedRevision) {
 * 构建设置 section schema（install 路径与插件 Config 声明共用，保证两代形状同源）。
 * 字段集 = fileOpenTool/keybindings/sidebarMinWidth/maxOpenEditors/integrationBaseUrl/
 * aiInline/aiProvider/aiModel/aiEffort/svnPath/tortoisePath/nativeOpenExts，全部带默认值
+* （keybindings 自 2026-10 起废弃停写：键位持久化归官方 shortcuts 存储
+*   userData/keybindings.json / dsh.keybindings.v1；字段保留仅为旧档迁移读取与降级回滚，
+*   见 client/shortcutsOfficial.ts 的 migrateLegacyKeybindings。）
 * （Config 启动校验在 undefined/空配置下自动填充，rc/alpha 两代 cordis 均通过）。
 * options.volatile：DSH 0.1.7 线的 Config 导出专用——SettingsForms.describe 只下发
 * 含 volatile 字段的 entry（volatileForm 门槛），不标记则 ns 永不出现在 describe、
@@ -5429,7 +5434,7 @@ async function restoreFile(ctx, session, rec) {
 //#region src/rules.ts
 /**
 * dsh-vscode-mode host — 规则管理（Codebuddy/Cursor 式 .mdc 规则）。
-* - 存储：用户规则 ~/.dsh/rules/*.mdc；项目规则 <工作区>/.dsh/rules/*.mdc（随仓库共享）。
+* - 存储：用户规则 DSH_HOME/rules + ~/.dsh/rules（当前目录优先）；项目规则 <工作区>/.dsh/rules。
 * - 格式：frontmatter（description / alwaysApply / globs / enabled）+ markdown 正文；
 *   类型映射 总是=always / 自动=auto(globs) / 手动=manual(仅索引)；enabled 为本插件扩展字段，缺省 true。
 * - 生效：host 注册 systemPrompt.section（order 400），每次装配同步读取（mtime 缓存），
@@ -5452,7 +5457,7 @@ const SECTION_NAME = "dsh-vscode-mode:rules";
 /** section 顺序：persona(0) 与 PLAN_POLICY(500) 之间，规则先于计划策略被读到。 */
 const SECTION_ORDER = 400;
 /**
-* 用户规则目录（~/.dsh/rules）。
+* 当前用户规则目录（DSH_HOME/rules）。
 * @author ddj 2026年09月03号
 * @param home DSH home（缺省自动解析）
 * @returns 绝对路径
@@ -5460,6 +5465,27 @@ const SECTION_ORDER = 400;
 function userRulesDir(home = dshHome()) {
 	return join(home, "rules");
 }
+/** DSH_HOME 改变时仍读取系统用户目录的旧规则；相同路径不重复加载。 */
+function userRuleDirs(activeHome = dshHome(), systemHome = homedir()) {
+	const current = resolve(userRulesDir(activeHome));
+	const legacy = resolve(userRulesDir(join(systemHome, ".dsh")));
+	const key = (path) => process.platform === "win32" ? path.toLowerCase() : path;
+	return key(current) === key(legacy) ? { current } : {
+		current,
+		legacy
+	};
+}
+function userDirOf(origin, dirs) {
+	if (origin === void 0 || origin === "current") return dirs.current;
+	if (origin === "legacy" && dirs.legacy) return dirs.legacy;
+	throw new Error("无效的用户规则来源");
+}
+/** 同名时当前目录优先；禁用的当前规则也应遮蔽旧目录规则。 */
+function mergeUserRules(current, legacy, fileOf) {
+	const key = (rule) => process.platform === "win32" ? fileOf(rule).toLowerCase() : fileOf(rule);
+	const seen = new Set(current.map(key));
+	return [...current, ...legacy.filter((rule) => !seen.has(key(rule)))].sort((a, b) => fileOf(a).localeCompare(fileOf(b)));
+}
 /**
 * 项目规则目录（<工作区>/.dsh/rules）。
 * @author ddj 2026年09月03号
@@ -5663,18 +5689,28 @@ function renderRulesSection(user, project, workspacePath) {
 	return [renderScope("用户规则（用户配置，必须遵守）", user), workspacePath ? renderScope("项目规则（工作区 " + workspacePath + "，必须遵守）", project) : ""].filter(Boolean).join("\n");
 }
 /** 单目录规则元信息列表（仅 *.mdc，最多 RULE_DIR_CAP 个；目录缺失返回空）。 */
-async function listRulesDir(dir, scope) {
-	const mdcs = (await readdir(dir).catch(() => [])).filter((name) => name.endsWith(".mdc")).sort().slice(0, RULE_DIR_CAP);
+async function listRulesDir(dir, scope, origin) {
+	const mdcs = (await readdir(dir).catch((error) => {
+		if (error.code === "ENOENT") return [];
+		throw error;
+	})).filter((name) => name.endsWith(".mdc")).sort().slice(0, RULE_DIR_CAP);
 	const out = [];
 	for (const file of mdcs) {
 		const absPath = join(dir, file);
-		const info = await stat(absPath).catch(() => null);
+		const info = await stat(absPath).catch((error) => {
+			if (error.code === "ENOENT") return null;
+			throw error;
+		});
 		if (!info || !info.isFile()) continue;
-		const parsed = parseRuleMdc(await readFile(absPath, "utf8").catch(() => ""));
-		out.push(toRuleInfo(scope, file, absPath, parsed, info.size, info.mtimeMs));
+		const parsed = parseRuleMdc(await readFile(absPath, "utf8"));
+		out.push(toRuleInfo(scope, file, absPath, parsed, info.size, info.mtimeMs, origin));
 	}
 	return out;
 }
+/** 列表与注入共用当前目录优先的合并约定。 */
+async function listUserRules(dirs = userRuleDirs()) {
+	return mergeUserRules(await listRulesDir(dirs.current, "user", "current"), dirs.legacy ? await listRulesDir(dirs.legacy, "user", "legacy") : [], (rule) => rule.file);
+}
 /** 已注册 workspace 列表（项目 Tab 与写入校验共用）。 */
 function workspaceList$1(ctx) {
 	return (ctx.get("workspaceRegistry")?.list?.() ?? []).filter((item) => Boolean(item) && typeof item.path === "string" && item.path !== "");
@@ -5691,10 +5727,16 @@ function requireWorkspace$2(ctx, workspacePath) {
 	if (!workspace) throw new Error("项目未注册为 DSH workspace，不能管理项目规则");
 	return workspace;
 }
-/** 按作用域解析规则目录（project 先过 requireWorkspace）。 */
-function dirOf$1(ctx, scope, workspacePath) {
-	if (scope === "project") return projectRulesDir(requireWorkspace$2(ctx, workspacePath).path);
-	return userRulesDir();
+/** 按作用域解析规则目录；客户端路径和未识别的来源均不作为目标使用。 */
+function dirOf$1(ctx, ref, dirs) {
+	const invalid = validateRuleFile(ref.file);
+	if (invalid) throw new Error(invalid);
+	if (ref.scope === "project") {
+		if (ref.origin !== void 0) throw new Error("项目规则不能指定用户规则来源");
+		return projectRulesDir(requireWorkspace$2(ctx, ref.workspacePath).path);
+	}
+	if (ref.scope !== "user") throw new Error("无效的规则作用域");
+	return userDirOf(ref.origin, dirs);
 }
 /**
 * 规则总列表：用户规则 + 各已注册工作区的项目规则。
@@ -5702,8 +5744,8 @@ function dirOf$1(ctx, scope, workspacePath) {
 * @param ctx DSH 上下文
 * @returns rules.list 载荷
 */
-async function rulesList(ctx) {
-	const user = await listRulesDir(userRulesDir(), "user");
+async function rulesList(ctx, dirs = userRuleDirs()) {
+	const user = await listUserRules(dirs);
 	const projects = [];
 	for (const workspace of workspaceList$1(ctx)) {
 		const dir = projectRulesDir(workspace.path);
@@ -5728,8 +5770,8 @@ async function rulesList(ctx) {
 * @param ref 作用域 + 文件名（+ 项目工作区）
 * @returns 文件全文
 */
-async function rulesRead(ctx, ref) {
-	const dir = dirOf$1(ctx, ref.scope, ref.workspacePath);
+async function rulesRead(ctx, ref, dirs = userRuleDirs()) {
+	const dir = dirOf$1(ctx, ref, dirs);
 	return readFile(join(dir, ref.file), "utf8");
 }
 /**
@@ -5743,12 +5785,13 @@ async function rulesRead(ctx, ref) {
 * @param mtime 修改时间毫秒
 * @returns 规则元信息
 */
-function toRuleInfo(scope, file, absPath, parsed, size, mtime) {
+function toRuleInfo(scope, file, absPath, parsed, size, mtime, origin) {
 	return {
 		scope,
 		file,
 		absPath,
-		relHint: scope === "project" ? ".dsh/rules/" : "rules/",
+		...scope === "user" ? { origin: origin ?? "current" } : {},
+		relHint: scope === "project" ? ".dsh/rules/" : origin === "legacy" ? "~/.dsh/rules/" : "rules/",
 		description: parsed.description,
 		type: ruleTypeOf(parsed),
 		globs: parsed.globs,
@@ -5765,10 +5808,8 @@ function toRuleInfo(scope, file, absPath, parsed, size, mtime) {
 * @param input 保存入参
 * @returns 保存后的规则元信息
 */
-async function rulesSave(ctx, input) {
-	const invalid = validateRuleFile(input.file);
-	if (invalid) throw new Error(invalid);
-	const dir = dirOf$1(ctx, input.scope, input.workspacePath);
+async function rulesSave(ctx, input, dirs = userRuleDirs()) {
+	const dir = dirOf$1(ctx, input, dirs);
 	await mkdir(dir, { recursive: true });
 	const absPath = join(dir, input.file);
 	const content = String(input.content ?? "");
@@ -5779,15 +5820,15 @@ async function rulesSave(ctx, input) {
 		await fs.writeText(target, content, void 0, void 0, fullPolicy$2(ctx));
 	} else await writeFile(absPath, content, "utf8");
 	const info = await stat(absPath).catch(() => null);
-	return toRuleInfo(input.scope, input.file, absPath, parseRuleMdc(content), info?.size ?? Buffer$1.byteLength(content), info?.mtimeMs ?? Date.now());
+	return toRuleInfo(input.scope, input.file, absPath, parseRuleMdc(content), info?.size ?? Buffer$1.byteLength(content), info?.mtimeMs ?? Date.now(), input.origin);
 }
 /**
 * 删除一条规则文件（project 作用域同样先过 workspace 注册校验）。
 * @author ddj 2026年09月03号
 * @param ref 作用域 + 文件名（+ 项目工作区）
 */
-async function rulesRemove(ctx, ref) {
-	const dir = dirOf$1(ctx, ref.scope, ref.workspacePath);
+async function rulesRemove(ctx, ref, dirs = userRuleDirs()) {
+	const dir = dirOf$1(ctx, ref, dirs);
 	await rm(join(dir, ref.file), { force: true });
 }
 /**
@@ -5797,8 +5838,8 @@ async function rulesRemove(ctx, ref) {
 * @param enabled 目标状态
 * @returns 更新后的规则元信息
 */
-async function rulesToggle(ctx, ref, enabled) {
-	const dir = dirOf$1(ctx, ref.scope, ref.workspacePath);
+async function rulesToggle(ctx, ref, enabled, dirs = userRuleDirs()) {
+	const dir = dirOf$1(ctx, ref, dirs);
 	const absPath = join(dir, ref.file);
 	const text = await readRuleText(ctx, ref, absPath);
 	if (text === null) throw new Error("规则文件不存在：" + ref.file);
@@ -5809,7 +5850,10 @@ async function rulesToggle(ctx, ref, enabled) {
 }
 /** 按作用域读规则全文：project 与写盘同通道走 ctx fs，user 走 node fs；缺失返回 null。 */
 async function readRuleText(ctx, ref, absPath) {
-	if (ref.scope !== "project") return readFile(absPath, "utf8").catch(() => null);
+	if (ref.scope !== "project") return readFile(absPath, "utf8").catch((error) => {
+		if (error.code === "ENOENT") return null;
+		throw error;
+	});
 	const fs = ctx.get("fs");
 	if (!fs) throw new Error("缺少 fs 服务");
 	const target = await fs.resolve(".dsh/rules/" + ref.file, { cwd: requireWorkspace$2(ctx, ref.workspacePath).path });
@@ -5833,24 +5877,24 @@ async function rulesSaveContent(ctx, ref, absPath, content) {
 /** 重建单条规则元信息（toggle 后回传 UI；stat 失败时用内容长度 + 当前时间兜底）。 */
 async function ruleInfoOf(ref, absPath, content) {
 	const info = await stat(absPath).catch(() => null);
-	return toRuleInfo(ref.scope, ref.file, absPath, parseRuleMdc(content), info?.size ?? Buffer$1.byteLength(content), info?.mtimeMs ?? Date.now());
+	return toRuleInfo(ref.scope, ref.file, absPath, parseRuleMdc(content), info?.size ?? Buffer$1.byteLength(content), info?.mtimeMs ?? Date.now(), ref.origin);
 }
 const injCache = /* @__PURE__ */ new Map();
 /**
-* 同步读取一个规则目录（装配 provider 内专用）：仅 *.mdc，mtime 缓存，异常静默为空。
+* 同步读取一个规则目录（装配 provider 内专用）：仅 *.mdc，mtime 缓存；缺失视为空。
 * @author ddj 2026年09月03号
 * @param dir 规则目录
 * @param scope 作用域
-* @param relHint 相对提示
+* @param origin 用户规则来源
 * @returns 已加载规则列表
 */
-function readRulesSync(dir, scope) {
-	if (!existsSync(dir)) return [];
+function readRulesSync(dir, scope, origin) {
 	let names;
 	try {
 		names = readdirSync(dir);
-	} catch {
-		return [];
+	} catch (error) {
+		if (error.code === "ENOENT") return [];
+		throw error;
 	}
 	const out = [];
 	for (const file of names.filter((name) => name.endsWith(".mdc")).sort().slice(0, RULE_DIR_CAP)) {
@@ -5858,8 +5902,9 @@ function readRulesSync(dir, scope) {
 		let info;
 		try {
 			info = statSync(absPath);
-		} catch {
-			continue;
+		} catch (error) {
+			if (error.code === "ENOENT") continue;
+			throw error;
 		}
 		if (!info.isFile()) continue;
 		const cached = injCache.get(absPath);
@@ -5868,8 +5913,9 @@ function readRulesSync(dir, scope) {
 		else {
 			try {
 				parsed = parseRuleMdc(readFileSync(absPath, "utf8"));
-			} catch {
-				continue;
+			} catch (error) {
+				if (error.code === "ENOENT") continue;
+				throw error;
 			}
 			injCache.set(absPath, {
 				mtimeMs: info.mtimeMs,
@@ -5878,12 +5924,16 @@ function readRulesSync(dir, scope) {
 			});
 		}
 		out.push({
-			info: toRuleInfo(scope, file, absPath, parsed, info.size, info.mtimeMs),
+			info: toRuleInfo(scope, file, absPath, parsed, info.size, info.mtimeMs, origin),
 			body: parsed.body
 		});
 	}
 	return out;
 }
+/** 同步装配与列表同名遮蔽策略一致。 */
+function readUserRulesSync(dirs = userRuleDirs()) {
+	return mergeUserRules(readRulesSync(dirs.current, "user", "current"), dirs.legacy ? readRulesSync(dirs.legacy, "user", "legacy") : [], (rule) => rule.info.file);
+}
 /** 从装配上下文解析会话工作区 cwd（agent.id → sessions → header.cwd；缺链返回 null）。 */
 function cwdFromAssemble(ctx, asm) {
 	const id = asm?.agent?.id;
@@ -5897,12 +5947,12 @@ function cwdFromAssemble(ctx, asm) {
 * @param ctx DSH host 上下文
 * @returns 是否成功注册
 */
-function installRulesSection(ctx) {
+function installRulesSection(ctx, dirs = userRuleDirs()) {
 	const sp = ctx.get("systemPrompt");
 	if (!sp || typeof sp.section !== "function") return false;
 	const provider = (asm) => {
 		try {
-			const user = readRulesSync(userRulesDir(), "user");
+			const user = readUserRulesSync(dirs);
 			const cwd = cwdFromAssemble(ctx, asm);
 			return renderRulesSection(user, cwd ? readRulesSync(projectRulesDir(cwd), "project") : [], cwd ?? void 0);
 		} catch {