dsh-vscode-mode 0.3.1 → 0.3.3

package/lib/index.js

@@ -1,7 +1,7 @@
 import { createRequire } from "node:module";
 import { chmod, copyFile, cp, mkdir, readFile, readdir, rename, rm, stat, writeFile } from "node:fs/promises";
 import { basename, dirname, extname, join, normalize, resolve, sep } from "node:path";
-import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, symlinkSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, symlinkSync, watch, writeFileSync } from "node:fs";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { homedir, tmpdir } from "node:os";
 import { createHash, randomUUID } from "node:crypto";
@@ -132,7 +132,8 @@ const KEYBINDING_DEFAULTS = {
 	"edrv.showCommands": "Ctrl+Shift+P|F1",
 	"edrv.nextEditorRow": "Ctrl+Alt+ArrowDown",
 	"edrv.prevEditorRow": "Ctrl+Alt+ArrowUp",
-	"edrv.addSelectionRef": "Ctrl+U"
+	"edrv.addSelectionRef": "Ctrl+U",
+	"edrv.closeTab": "Ctrl+F4"
 };
 //#endregion
 //#region src/shared/integration.ts
@@ -948,6 +949,16 @@ function assetsDirOf(moduleUrl) {
 function vendorDirOf(moduleUrl) {
 	return join(assetsDirOf(moduleUrl), "vendor");
 }
+/**
+* 插件自带技能组根目录（包根 skills/，与 assets/ 同级；随包发布）。
+* 布局：<根>/<技能名>/SKILL.md（目录式）或 <根>/<技能名>.md（扁平式）。
+* @author ddj 2026年09月11号
+* @param moduleUrl 模块 URL（缺省 import.meta.url；测试注入）
+* @returns 技能组根目录绝对路径
+*/
+function skillsDirOf(moduleUrl) {
+	return join(dirname(fileURLToPath(moduleUrl)), "..", "skills");
+}
 /** 图标目录：config.imageDir 覆盖优先，否则插件包 assets/。 */
 function imageDirOf(config, moduleUrl) {
 	const cfg = config;
@@ -1065,6 +1076,450 @@ async function sweepTreeCache(home = dshHome(), cap = CACHE_TOTAL_CAP) {
 	return removed;
 }
 //#endregion
+//#region src/skills.ts
+/**
+* dsh-vscode-mode host — 插件自带技能组（随包 skills/ 分发的 SKILL.md）。
+* - 存储：<包根>/skills/<技能名>/SKILL.md（目录式）或 <包根>/skills/<技能名>.md（扁平式），随包发布。
+* - 命名：技能名必须 kebab-case（DSH 硬约束，下划线会被 registry 拒绝）且以 dsh-vscodemode- 开头。
+* - 生效：注册自研 skill provider 到 ctx.skills（ctx.inject 惰性获取，服务缺失时插件仍完整可用）；
+*   文件变更经 fs.watch → control.invalidate() 即时可见。
+* 为什么自研 provider 而不用 @deepseek-ai/dsh-skill-filesystem：见 README「插件技能组」小节。
+* --region 划分：常量 / 类型 / frontmatter 解析（纯）/ 目录扫描（只读）/ provider / 挂载与状态
+* 作者 ddj 2026年09月11号
+*/
+/** provider 名（注册进 ctx.skills；不得与 'filesystem' / 'openviking' 及保留名 'runtime' 冲突）。 */
+const SKILL_PROVIDER_NAME = "dsh-vscodemode";
+/** 技能组前缀白名单：名字不在其中的技能文件被跳过并告警。 */
+const SKILL_PREFIXES = ["dsh-vscodemode-"];
+/** 技能发现来源标签（skill-explorer 归入 "System bundled" 组）。 */
+const SKILL_SOURCE = "bundled";
+/** 目录式技能的文件名。 */
+const SKILL_FILE = "SKILL.md";
+/** DSH 技能名语法（与 @deepseek-ai/dsh-skill 的 SKILL_NAME 一致：下划线非法）。 */
+const SKILL_NAME_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/** 不受支持的遗留字段 → 规范字段（官方同样拒绝，避免写错键位却静默无效果）。 */
+const LEGACY_SKILL_KEYS = [
+	["disableModelInvocation", "disable-model-invocation"],
+	["modelInvocable", "disable-model-invocation"],
+	["userInvocable", "user-invocable"]
+];
+/**
+* 去除标量值两侧成对引号。
+* 与 rules.ts 的同名私有工具语义一致；两处解析器面向不同格式（.mdc 规则 / SKILL.md），
+* 各自保持模块自治，避免为一处 4 行字符串处理引入跨模块耦合。
+* @author ddj 2026年09月11号
+* @param raw 原始标量文本
+* @returns 去引号后的文本
+*/
+function stripQuotes$1(raw) {
+	const value = raw.trim();
+	return value.length >= 2 && (value.startsWith("\"") && value.endsWith("\"") || value.startsWith("'") && value.endsWith("'")) ? value.slice(1, -1) : value;
+}
+/**
+* 解析 YAML 布尔标量（true/false/yes/no/on/off/1/0，大小写不敏感）。
+* @author ddj 2026年09月11号
+* @param raw 原始标量文本
+* @returns 布尔值；非布尔字面量返回 undefined
+*/
+function parseBool(raw) {
+	const value = raw.trim().toLowerCase();
+	if (value === "true" || value === "yes" || value === "on" || value === "1") return true;
+	if (value === "false" || value === "no" || value === "off" || value === "0") return false;
+}
+/**
+* 切出 frontmatter 与正文：首行必须是独立的 `---`，其后需有独立的闭合 `---`。
+* 容忍 BOM 与 CRLF；不满足即视为无 frontmatter（调用方按"忽略该文件"处理）。
+* @author ddj 2026年09月11号
+* @param text SKILL.md 全文
+* @returns frontmatter 行与正文；无合法 frontmatter 返回 null
+*/
+function splitFrontmatter(text) {
+	const lines = text.replace(/^\uFEFF/, "").split(/\r?\n/);
+	if (lines[0] !== "---") return null;
+	let close = -1;
+	for (let i = 1; i < lines.length; i++) if (lines[i] === "---") {
+		close = i;
+		break;
+	}
+	if (close < 0) return null;
+	return {
+		fields: lines.slice(1, close),
+		body: lines.slice(close + 1).join("\n").trim()
+	};
+}
+/**
+* 读取块标量（`|` / `>` 及其 chomping/缩进指示符后接的缩进行），返回文本与下一个待扫描位置。
+* 折叠式（`>`）行间以空格连接，字面式（`|`）以换行连接；两者末尾均 trim。
+* @author ddj 2026年09月11号
+* @param fields frontmatter 行
+* @param start 起始下标
+* @param folded 是否为折叠式（`>`）
+* @returns 块文本与下一扫描位置
+*/
+function readBlock(fields, start, folded) {
+	const parts = [];
+	let i = start;
+	while (i < fields.length && (fields[i].trim() === "" || /^[ \t]/.test(fields[i]))) {
+		const line = fields[i].trim();
+		if (line !== "") parts.push(line);
+		i += 1;
+	}
+	return {
+		value: parts.join(folded ? " " : "\n").trim(),
+		next: i
+	};
+}
+/**
+* 把 frontmatter 行解析为键值映射（仅支持本插件用到的标量形式：内联标量与 `|`/`>` 块标量）。
+* @author ddj 2026年09月11号
+* @param fields frontmatter 行
+* @returns 键值映射（无法识别的行跳过）
+*/
+function collectFields(fields) {
+	const out = {};
+	for (let i = 0; i < fields.length; i++) {
+		const match = /^([A-Za-z0-9_-]+)[ \t]*:[ \t]?(.*)$/.exec(fields[i]);
+		if (!match) continue;
+		const key = match[1];
+		const inline = match[2];
+		const block = /^([|>])[+-]?\d*$/.exec(inline.trim());
+		if (block === null) {
+			out[key] = stripQuotes$1(inline);
+			continue;
+		}
+		const read = readBlock(fields, i + 1, block[1] === ">");
+		out[key] = read.value;
+		i = read.next - 1;
+	}
+	return out;
+}
+/**
+* 由 frontmatter 推导可见性策略（缺省两者皆 true；值为非布尔字面量时报错）。
+* @author ddj 2026年09月11号
+* @param data frontmatter 键值映射
+* @returns 策略与可选错误文案
+*/
+function toInvocation(data) {
+	const defaults = {
+		modelInvocable: true,
+		userInvocable: true
+	};
+	const disabled = parseBool(data["disable-model-invocation"] ?? "");
+	if (disabled === void 0 && data["disable-model-invocation"] !== void 0) return {
+		policy: defaults,
+		error: "frontmatter 字段 \"disable-model-invocation\" 必须是布尔值"
+	};
+	const user = parseBool(data["user-invocable"] ?? "");
+	if (user === void 0 && data["user-invocable"] !== void 0) return {
+		policy: defaults,
+		error: "frontmatter 字段 \"user-invocable\" 必须是布尔值"
+	};
+	return { policy: {
+		modelInvocable: disabled !== true,
+		userInvocable: user !== false
+	} };
+}
+/**
+* 判断解析结果是否为成功形态。
+* @author ddj 2026年09月11号
+* @param value 解析结果
+* @returns 是否为 ParsedSkill
+*/
+function isParsedSkill(value) {
+	return !("error" in value);
+}
+/**
+* 解析一条 SKILL.md（纯函数，永不抛错）。
+* @author ddj 2026年09月11号
+* @param text SKILL.md 全文
+* @returns 解析结果（成功含正文与元数据；失败含拒绝原因）
+*/
+function parseSkillMd(text) {
+	const parts = splitFrontmatter(text);
+	if (parts === null) return { error: "缺少合法 frontmatter（首行须为 --- 且存在闭合 ---）" };
+	const data = collectFields(parts.fields);
+	const legacy = LEGACY_SKILL_KEYS.find(([key]) => data[key] !== void 0);
+	if (legacy !== void 0) return { error: "frontmatter 字段 \"" + legacy[0] + "\" 不受支持，请改用 \"" + legacy[1] + "\"" };
+	const name = (data.name ?? "").trim();
+	if (!SKILL_NAME_RE.test(name)) return { error: "非法技能名 \"" + name + "\"（须 kebab-case：小写字母/数字，段间连字符；下划线非法）" };
+	const description = (data.description ?? "").trim();
+	if (!description) return { error: "技能 \"" + name + "\" 缺少 description" };
+	const invocation = toInvocation(data);
+	if (invocation.error !== void 0) return { error: invocation.error };
+	const whenToUse = (data.whenToUse ?? "").trim();
+	return {
+		name,
+		description,
+		...whenToUse ? { whenToUse } : {},
+		invocation: invocation.policy,
+		body: parts.body
+	};
+}
+/**
+* 判断技能名是否落在技能组前缀白名单内。
+* @author ddj 2026年09月11号
+* @param name 技能名
+* @returns 是否命中前缀
+*/
+function hasGroupPrefix(name) {
+	return SKILL_PREFIXES.some((prefix) => name.startsWith(prefix));
+}
+/**
+* 目录条目 → 候选文件路径（目录式取 <名>/SKILL.md；扁平式取 <名>.md；其余跳过）。
+* @author ddj 2026年09月11号
+* @param dir 技能组根目录
+* @param entry 目录条目
+* @returns 候选文件绝对路径；不构成技能时返回 undefined
+*/
+function skillFileOf(dir, entry) {
+	if (entry.isDirectory()) return join(dir, entry.name, SKILL_FILE);
+	if (entry.isFile() && entry.name.endsWith(".md")) return join(dir, entry.name);
+}
+/**
+* 由已解析的技能构造候选（provider 名/rank/source/resourceBase 按 registry 契约填充）。
+* @author ddj 2026年09月11号
+* @param parsed 解析成功的技能
+* @param file SKILL.md 绝对路径
+* @returns registry 候选
+*/
+function candidateFrom(parsed, file) {
+	return {
+		name: parsed.name,
+		description: parsed.description,
+		...parsed.whenToUse !== void 0 ? { whenToUse: parsed.whenToUse } : {},
+		invocation: parsed.invocation,
+		source: SKILL_SOURCE,
+		provider: SKILL_PROVIDER_NAME,
+		rank: 300,
+		locator: { path: file },
+		path: file,
+		resourceBase: {
+			kind: "directory",
+			path: dirname(file)
+		}
+	};
+}
+/**
+* 读盘并校验单个技能文件（缺失/读失败/解析失败/非本组前缀 → undefined + 告警）。
+* @author ddj 2026年09月11号
+* @param file SKILL.md 绝对路径
+* @returns registry 候选；不可用时 undefined
+*/
+async function candidateOf$1(file) {
+	const info = await stat(file).catch(() => void 0);
+	if (info === void 0 || !info.isFile()) return void 0;
+	const text = await readFile(file, "utf8").catch(() => void 0);
+	if (text === void 0) return void 0;
+	const parsed = parseSkillMd(text);
+	if (!isParsedSkill(parsed)) {
+		log.warn("技能已忽略（" + file + "）：" + parsed.error);
+		return;
+	}
+	if (!hasGroupPrefix(parsed.name)) {
+		log.warn("技能已忽略（" + file + "）：名字 \"" + parsed.name + "\" 不在技能组前缀 " + SKILL_PREFIXES.join("/") + " 内");
+		return;
+	}
+	return candidateFrom(parsed, file);
+}
+/**
+* 扫描技能组目录（目录缺失/读取失败 → 空数组，不抛）。
+* @author ddj 2026年09月11号
+* @param dir 技能组根目录
+* @returns 通过校验的候选（按名字排序，受 SKILL_DIR_CAP 约束）
+*/
+async function listSkills(dir) {
+	const ordered = [...await readdir(dir, { withFileTypes: true }).catch(() => [])].sort((a, b) => a.name.localeCompare(b.name)).slice(0, 200);
+	const found = [];
+	for (const entry of ordered) {
+		const file = skillFileOf(dir, entry);
+		if (file === void 0) continue;
+		const candidate = await candidateOf$1(file);
+		if (candidate !== void 0) found.push(candidate);
+	}
+	return found;
+}
+/**
+* 解析候选的落盘路径（locator 优先，回退 candidate.path）。
+* @author ddj 2026年09月11号
+* @param candidate registry 候选
+* @returns 绝对路径；不可解析时 undefined
+*/
+function locatorPath(candidate) {
+	const locator = candidate.locator;
+	if (locator !== void 0 && typeof locator.path === "string") return locator.path;
+	return typeof candidate.path === "string" ? candidate.path : void 0;
+}
+/**
+* 加载候选的完整技能定义（重读盘；文件消失或名字变化 → undefined，让 registry 自行失效缓存）。
+* @author ddj 2026年09月11号
+* @param candidate registry 候选
+* @returns 完整定义；不可用时 undefined
+*/
+async function loadSkill(candidate) {
+	const file = locatorPath(candidate);
+	if (file === void 0) return void 0;
+	const text = await readFile(file, "utf8").catch(() => void 0);
+	if (text === void 0) return void 0;
+	const parsed = parseSkillMd(text);
+	if (!isParsedSkill(parsed) || parsed.name !== candidate.name) return void 0;
+	return {
+		...candidateFrom(parsed, file),
+		content: parsed.body
+	};
+}
+/**
+* 关闭 watcher（注册被释放时的收尾；失败不影响装配）。
+* @author ddj 2026年09月11号
+* @param watcher 文件监听器
+*/
+function closeWatcher(watcher) {
+	try {
+		watcher.close();
+	} catch (error) {}
+}
+/**
+* 监听技能目录：变更 → control.invalidate()（registry 有收集缓存，必须失效才即时可见）。
+* 注册被释放时经 control.signal 关闭；监听不可用仅降级为"改动需重载插件"，不影响正确性。
+* @author ddj 2026年09月11号
+* @param dir 技能组根目录
+* @param control registry 借出的控制面
+*/
+function watchSkillDir(dir, control) {
+	if (!existsSync(dir)) return;
+	try {
+		const watcher = watch(dir, {
+			recursive: true,
+			persistent: false
+		}, () => control.invalidate());
+		watcher.on("error", (error) => log.warn("技能目录监听中断（改动需重载插件生效）：" + String(error)));
+		control.signal.addEventListener("abort", () => closeWatcher(watcher), { once: true });
+	} catch (error) {
+		log.warn("技能目录监听不可用（改动需重载插件生效）：" + String(error));
+	}
+}
+/**
+* 创建技能组 provider（注册进 ctx.skills）。
+* @author ddj 2026年09月11号
+* @param dir 技能组根目录
+* @param control registry 借出的控制面
+* @returns provider 实例
+*/
+function newSkillProvider(dir, control) {
+	watchSkillDir(dir, control);
+	return {
+		name: SKILL_PROVIDER_NAME,
+		list: () => listSkills(dir),
+		get: (candidate) => loadSkill(candidate)
+	};
+}
+/** 最近一次装配状态（兼容性页与启动日志读取；模块级单例，热重载后由新装配覆写）。 */
+let group = {
+	dispatched: false,
+	mounted: false,
+	count: 0,
+	dir: "",
+	note: "未装配"
+};
+/**
+* 读取技能组装配状态（副本，调用方不可改写内部状态）。
+* @author ddj 2026年09月11号
+* @returns 状态快照
+*/
+function skillGroupState() {
+	return { ...group };
+}
+/**
+* 记录状态片段。
+* @author ddj 2026年09月11号
+* @param patch 待覆写字段
+*/
+function recordGroup(patch) {
+	group = {
+		...group,
+		...patch
+	};
+}
+/**
+* 在 skills 就绪回调里注册 provider，并异步回填技能数。
+* @author ddj 2026年09月11号
+* @param sctx inject 回调给出的服务上下文
+* @param dir 技能组根目录
+*/
+function mountGroup(sctx, dir) {
+	const sc = sctx;
+	const skills = (typeof sc?.get === "function" ? sc.get("skills") : void 0) ?? sc?.skills;
+	const register = skills?.registerProvider;
+	if (typeof register !== "function") {
+		recordGroup({
+			mounted: false,
+			note: "skills 服务不可用或版本不含 registerProvider"
+		});
+		log.warn("技能组未挂载：skills 服务不可用，插件其余功能不受影响");
+		return;
+	}
+	try {
+		register.call(skills, (control) => newSkillProvider(dir, control));
+		recordGroup({
+			mounted: true,
+			dir,
+			note: "已挂载（等待技能扫描）"
+		});
+	} catch (error) {
+		recordGroup({
+			mounted: false,
+			note: "provider 注册失败：" + String(error)
+		});
+		log.warn("技能组未挂载：provider 注册失败（" + String(error) + "）");
+		return;
+	}
+	listSkills(dir).then((found) => {
+		recordGroup({
+			count: found.length,
+			note: "已挂载 " + found.length + " 个技能"
+		});
+		log.info("插件技能组已挂载：" + SKILL_PREFIXES[0] + "* 共 " + found.length + " 个技能（" + dir + "）");
+	}).catch((error) => log.warn("技能组扫描失败：" + String(error)));
+}
+/**
+* 装配插件技能组（惰性获取 skills 服务；服务缺失/版本过旧时降级记录，不抛错）。
+* 返回值只表示"是否已调度"——inject 回调异步执行，实际结果见 skillGroupState()。
+* @author ddj 2026年09月11号
+* @param ctx DSH host 上下文
+* @param dir 技能组根目录（缺省 import.meta.url 派生；测试注入）
+* @returns 是否已调度挂载
+*/
+function installSkillGroup(ctx, dir = skillsDirOf(import.meta.url)) {
+	const inject = ctx?.inject;
+	if (typeof inject !== "function") {
+		recordGroup({
+			dispatched: false,
+			mounted: false,
+			dir,
+			note: "ctx.inject 不可用（DSH 版本过旧），技能组未挂载"
+		});
+		log.warn("技能组未挂载：DSH 未提供 ctx.inject");
+		return false;
+	}
+	recordGroup({
+		dispatched: true,
+		mounted: false,
+		dir,
+		note: "已调度 skills 服务装配（等待 skills 就绪）"
+	});
+	try {
+		inject.call(ctx, ["skills"], (sctx) => mountGroup(sctx, dir));
+	} catch (error) {
+		recordGroup({
+			dispatched: false,
+			mounted: false,
+			note: "挂载调度失败：" + String(error)
+		});
+		log.warn("技能组挂载调度失败：" + String(error));
+		return false;
+	}
+	return true;
+}
+//#endregion
 //#region src/compat.ts
 /**
 * dsh-vscode-mode host — 兼容层：与其他插件 / DSH 版本的统一探测、适配、护栏与自诊断。
@@ -1103,6 +1558,7 @@ function detectExternal(ctx, depsAvailable) {
 	const settings = ctx.get("settings");
 	const hasSettings = Boolean(settings?.describe || settings?.update);
 	const sub = ctx.get("subprocess");
+	const skills = skillGroupState();
 	return [
 		{
 			name: MCP_PACKAGE,
@@ -1123,6 +1579,11 @@ function detectExternal(ctx, depsAvailable) {
 			name: "文件浏览器打开（subprocess 服务）",
 			active: typeof sub?.spawn === "function",
 			note: typeof sub?.spawn === "function" ? "可定位/打开 OS 文件浏览器" : "不可用（右键「在文件浏览器中打开」将提示失败）"
+		},
+		{
+			name: "插件技能组（" + SKILL_PREFIXES[0] + "*）",
+			active: skills.mounted,
+			note: skills.note + (skills.mounted && skills.dir ? "（" + skills.dir + "）" : "")
 		}
 	];
 }
@@ -11064,6 +11525,9 @@ function apply(ctx, config) {
 	/** 规则注入 section（~/.dsh/rules 与 <工作区>/.dsh/rules；旧版 DSH 无 systemPrompt 时静默降级）。 */
 	const rulesInstalled = installRulesSection(ctx);
 	if (!rulesInstalled) log.warn("未检测到 systemPrompt 服务，规则仅可管理不注入");
+	/** 插件自带技能组（<包根>/skills，惰性获取 skills 服务；返回值仅表示"已调度"，实际结果见 skillGroupState）。 */
+	const skillsDispatched = installSkillGroup(ctx);
+	if (!skillsDispatched) log.warn("技能组未调度，插件技能组不可用");
 	/** LSP RPC 与会话清理（一次性创建，tracker 状态跨请求保留）。 */
 	const lspRpc = createLspRpc({
 		ctx,
@@ -11099,7 +11563,7 @@ function apply(ctx, config) {
 		lspManager.disposeAll().catch(() => {});
 		disposeAllServers();
 	});
-	log.info("编辑差异审查已装配（/edrv/rpc 路由就绪，项目 MCP 隔离已启用，语言服务器 LSP 已接入，规则注入" + (rulesInstalled ? "已接入" : "未接入") + "）");
+	log.info("编辑差异审查已装配（/edrv/rpc 路由就绪，项目 MCP 隔离已启用，语言服务器 LSP 已接入，规则注入" + (rulesInstalled ? "已接入" : "未接入") + "，技能组" + (skillsDispatched ? "装配中" : "未装配") + "）");
 }
 /**
 * 异步输出兼容性报告摘要（含重复装配/路由冲突自诊断）。