dsh-vscode-mode 0.1.16 → 0.1.19

package/lib/index.js

@@ -2,7 +2,8 @@ import { createRequire } from "node:module";
 import { readFile } from "node:fs/promises";
 import { dirname, extname, join, normalize, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync, readFileSync, readdirSync, rmSync, symlinkSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
 import { createHash } from "node:crypto";
 //#region src/mcp.ts
 /**
@@ -198,6 +199,146 @@ function normalizeFileOpenTool(value) {
 	return normalizeValue(value);
 }
 //#endregion
+//#region src/devForm.ts
+/**
+* dsh-vscode-mode host — 开发形态管理（安装形态切换）。
+* 开发形态 = profile 中以 link: 依赖 + junction 指向工作区的安装（用于插件开发）；
+* 关闭 = 改回版本依赖 + 删 junction + pnpm install 装配正式版。
+* 切换后需重启 DSH 生效（运行中的代码仍是旧形态）。
+* 与 compat.ts 存在模块环（devForm 用 pluginVersionOf、compat 用 readDevForm），
+* 双方仅在函数体内交叉使用，模块求值期无依赖，ESM 安全。
+* 作者 ddj 2026-08-24
+*/
+/** 扫描 $DSH_HOME/profiles 找到依赖本插件的 profile 目录（无 env 依赖，多 profile 安全）。 */
+function findProfileDir() {
+	const home = process.env.DSH_HOME ?? join(homedir(), ".dsh");
+	try {
+		for (const name of readdirSync(join(home, "profiles"))) {
+			const pkgFile = join(home, "profiles", name, "package.json");
+			if (!existsSync(pkgFile)) continue;
+			try {
+				if (JSON.parse(readFileSync(pkgFile, "utf8"))?.dependencies?.["dsh-vscode-mode"]) return dirname(pkgFile);
+			} catch {}
+		}
+	} catch {}
+}
+/**
+* 读取当前开发形态（manifest link: 判定）。
+* @author ddj 2026年08月24号
+* @returns 开发形态状态
+*/
+function readDevForm() {
+	const profileDir = findProfileDir();
+	if (!profileDir) return { enabled: false };
+	try {
+		const text = readFileSync(join(profileDir, "package.json"), "utf8").replace(/^\uFEFF/, "");
+		const spec = JSON.parse(text)?.dependencies?.[PLUGIN_NAME];
+		if (typeof spec === "string" && spec.startsWith("link:")) return {
+			enabled: true,
+			path: spec.slice(5)
+		};
+	} catch {}
+	return { enabled: false };
+}
+/**
+* 规划切换后的 manifest 文本（纯函数，可单测；非法 JSON 抛错）。
+* @author ddj 2026年08月24号
+* @param text 原 manifest 文本
+* @param enabled 目标形态（true=link:，false=版本）
+* @param path 工作区路径（开启时必填）
+* @param version 版本号（关闭时使用，写入 ^<version>）
+* @returns 新 manifest 文本（无 BOM，2 空格缩进）
+*/
+function planManifest(text, enabled, path, version) {
+	const data = JSON.parse(text.replace(/^\uFEFF/, ""));
+	if (!data.dependencies || typeof data.dependencies !== "object") throw new Error("profile package.json 缺少 dependencies 字段");
+	data.dependencies[PLUGIN_NAME] = enabled ? "link:" + path.replace(/\\/g, "/") : "^" + version;
+	return JSON.stringify(data, null, 2) + "\n";
+}
+/** 建立或移除 node_modules 下的开发 junction（目标不存在时开启失败）。 */
+function applyJunction(profileDir, enabled, target) {
+	const linkDir = join(profileDir, "node_modules", PLUGIN_NAME);
+	if (existsSync(linkDir)) rmSync(linkDir, {
+		recursive: true,
+		force: true
+	});
+	if (!enabled) return;
+	if (!existsSync(target)) throw new Error("工作区路径不存在：" + target);
+	symlinkSync(target, linkDir, "junction");
+}
+/**
+* 切换开发形态：改 manifest → 建/删 junction → pnpm install（subprocess）。
+* @author ddj 2026年08月24号
+* @param ctx DSH host 上下文（subprocess 服务）
+* @param enabled 目标形态
+* @param path 工作区绝对路径（开启时必填）
+* @returns 切换结果（restart=true 表示需重启 DSH 生效）
+*/
+async function setDevForm(ctx, enabled, path) {
+	const profileDir = findProfileDir();
+	if (!profileDir) return {
+		ok: false,
+		error: "未找到依赖本插件的 profile（检查 DSH_HOME/profiles）",
+		restart: false
+	};
+	const current = readDevForm();
+	const target = (path ?? current.path ?? "").replace(/\\/g, "/");
+	if (enabled && !target) return {
+		ok: false,
+		error: "开启开发形态需要提供工作区路径（path 参数）",
+		restart: false
+	};
+	if (enabled === current.enabled && (!enabled || target === current.path)) return {
+		ok: true,
+		restart: false
+	};
+	try {
+		const pkgFile = join(profileDir, "package.json");
+		const version = pluginVersionOf();
+		if (!version) return {
+			ok: false,
+			error: "读取插件版本失败，无法写入版本依赖",
+			restart: false
+		};
+		const next = planManifest(readFileSync(pkgFile, "utf8").replace(/^\uFEFF/, ""), enabled, target, version);
+		writeFileSync(pkgFile, next, "utf8");
+		applyJunction(profileDir, enabled, target);
+		const installError = await runPnpmInstall(ctx, profileDir);
+		return {
+			ok: !installError,
+			error: installError,
+			restart: true
+		};
+	} catch (error) {
+		return {
+			ok: false,
+			error: String(error),
+			restart: false
+		};
+	}
+}
+/** 在 profile 目录执行 pnpm install（subprocess 契约：spawn({argv,cwd,stdio,graceMs})）。 */
+async function runPnpmInstall(ctx, profileDir) {
+	const sub = ctx.get("subprocess");
+	if (!sub || typeof sub.spawn !== "function") return "manifest/junction 已更新，但缺少 subprocess：请手动在 profile 目录运行 pnpm install";
+	const handle = sub.spawn({
+		argv: ["pnpm", "install"],
+		cwd: profileDir,
+		stdio: {
+			stdout: { maxBytes: 65536 },
+			stderr: { maxBytes: 65536 },
+			stdin: "ignore"
+		},
+		graceMs: 12e4
+	});
+	const outcome = await handle.done;
+	const code = outcome?.exitCode ?? outcome?.code;
+	if (code !== 0) {
+		const stderr = handle.collected?.stderr?.readFrom(0).text ?? "";
+		return "pnpm install 失败（exit " + code + "）：" + stderr.slice(0, 500);
+	}
+}
+//#endregion
 //#region src/compat.ts
 /**
 * dsh-vscode-mode host — 兼容层：与其他插件 / DSH 版本的统一探测、适配、护栏与自诊断。
@@ -327,7 +468,8 @@ async function buildReport(ctx, options) {
 		pluginVersion: options?.version ?? pluginVersionOf(),
 		external,
 		guards,
-		warnings
+		warnings,
+		devForm: readDevForm()
 	};
 }
 //#endregion
@@ -1101,15 +1243,18 @@ async function appendArchiveEntries(ctx, cwd, entries, session) {
 		console.error("edrv appendArchiveEntries failed", error);
 	}
 }
-/** 归档记录：标记 archived、按批次写入归档、落盘工作区桶。 */
-async function archiveRecords(ctx, session, cwd, bucket, recs, reason) {
+/**
+* 归档记录：标记 archived、按批次写入归档、落盘工作区桶。
+* @param opts.deferSave 为 true 时只写归档、不落盘桶（由批量调用方统一 saveBucket 一次）
+*/
+async function archiveRecords(ctx, session, cwd, bucket, recs, reason, opts) {
 	if (!recs.length) return;
 	const fresh = recs.filter((r) => !r.archived);
 	for (const r of recs) r.archived = true;
 	const entries = [];
 	for (const list of groupByBatch(recs).values()) entries.push(archiveEntryFor(list, cwd, reason));
 	await appendArchiveEntries(ctx, cwd, entries, session);
-	if (fresh.length) await saveBucket(ctx, cwd, bucket, session);
+	if (fresh.length && !opts?.deferSave) await saveBucket(ctx, cwd, bucket, session);
 }
 //#endregion
 //#region src/registry.ts
@@ -2295,6 +2440,53 @@ async function requireSession(ctx, sessionId) {
 		cwd
 	};
 }
+/**
+* 批量决策核心：一次会话/桶解析 + 逐项处理 + 统一落盘（accept/reject 单条与 decideBatch 共用）。
+* rejected 项先做回滚，失败记入该项 error 且不改决策；本批次新增"已解决"记录一次性归档，
+* 有任何成功项则整桶只写盘一次，避免逐条读写整个 sidecar。
+* @author ddj 2026年08月25号
+* @param items 决策项（按数组顺序处理，rejected 的先后即回滚顺序）
+* @returns 逐项结果（ok 项含更新后的记录视图）
+*/
+async function applyDecisions(ctx, session, cwd, bucket, items) {
+	const results = [];
+	const resolved = [];
+	let changed = false;
+	for (const item of items) {
+		const record = bucket.get(item.callId);
+		if (!record) {
+			results.push({
+				callId: item.callId,
+				ok: false,
+				error: "记录不存在"
+			});
+			continue;
+		}
+		if (item.decision === "rejected") {
+			const outcome = (item.scope ?? "call") === "hunk" ? await revertHunk(ctx, session, record, item.hunkIndex ?? -1) : await revertCall(ctx, session, record);
+			if (!outcome.ok) {
+				results.push({
+					callId: item.callId,
+					ok: false,
+					error: outcome.error
+				});
+				continue;
+			}
+		}
+		const wasResolved = recordResolved(record);
+		markDecision(record, item.scope ?? "call", item.hunkIndex, item.decision);
+		changed = true;
+		if (!wasResolved && recordResolved(record)) resolved.push(record);
+		results.push({
+			callId: item.callId,
+			ok: true,
+			record: recView(record)
+		});
+	}
+	if (resolved.length) await archiveRecords(ctx, session, cwd, bucket, resolved, items.some((item) => item.decision === "rejected") ? "已处理（回滚）" : "已处理", { deferSave: true });
+	if (changed) await saveBucket(ctx, cwd, bucket, session);
+	return results;
+}
 /** 各方法 handler 表（类型由 shared/rpc 的 RpcHandlerMap 约束）。 */
 function buildHandlers(ctx, registry, searcher = newSearcher(ctx)) {
 	return {
@@ -2306,7 +2498,7 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx)) {
 			};
 			const bucket = await bucketOf(registry, ctx, sc.cwd);
 			const want = Array.isArray(args.callIds) ? new Set(args.callIds) : null;
-			if (!want) await autoArchiveStale(ctx, sc.session, sc.cwd, bucket);
+			if (!want && args.skipStale !== true) await autoArchiveStale(ctx, sc.session, sc.cwd, bucket);
 			const out = [];
 			for (const rec of bucket.values()) {
 				if (!want && rec.archived) continue;
@@ -2326,17 +2518,19 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx)) {
 				error: sc.err
 			};
 			const bucket = await bucketOf(registry, ctx, sc.cwd);
-			const record = bucket.get(args.callId);
-			if (!record) return {
+			const item = (await applyDecisions(ctx, sc.session, sc.cwd, bucket, [{
+				callId: args.callId,
+				scope: args.scope,
+				hunkIndex: args.hunkIndex,
+				decision: "accepted"
+			}]))[0];
+			if (!item?.ok) return {
 				ok: false,
-				error: "记录不存在"
+				error: item?.error ?? "操作失败"
 			};
-			markDecision(record, args.scope ?? "call", args.hunkIndex, "accepted");
-			if (recordResolved(record)) await archiveRecords(ctx, sc.session, sc.cwd, bucket, [record], "已处理");
-			else await saveBucket(ctx, sc.cwd, bucket, sc.session);
 			return {
 				ok: true,
-				record: recView(record)
+				record: item.record
 			};
 		},
 		"edrv.reject": async (args) => {
@@ -2346,24 +2540,31 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx)) {
 				error: sc.err
 			};
 			const bucket = await bucketOf(registry, ctx, sc.cwd);
-			const record = bucket.get(args.callId);
-			if (!record) return {
+			const item = (await applyDecisions(ctx, sc.session, sc.cwd, bucket, [{
+				callId: args.callId,
+				scope: args.scope,
+				hunkIndex: args.hunkIndex,
+				decision: "rejected"
+			}]))[0];
+			if (!item?.ok) return {
 				ok: false,
-				error: "记录不存在"
+				error: item?.error ?? "操作失败"
 			};
-			const scope = args.scope ?? "call";
-			const outcome = scope === "hunk" ? await revertHunk(ctx, sc.session, record, args.hunkIndex ?? -1) : await revertCall(ctx, sc.session, record);
-			if (!outcome.ok) return {
+			return {
+				ok: true,
+				record: item.record
+			};
+		},
+		"edrv.decideBatch": async (args) => {
+			const sc = await requireSession(ctx, args.sessionId);
+			if ("err" in sc) return {
 				ok: false,
-				error: outcome.error
+				error: sc.err
 			};
-			markDecision(record, scope, args.hunkIndex, "rejected");
-			record.at = (/* @__PURE__ */ new Date()).toISOString();
-			if (recordResolved(record)) await archiveRecords(ctx, sc.session, sc.cwd, bucket, [record], "已处理（回滚）");
-			else await saveBucket(ctx, sc.cwd, bucket, sc.session);
+			const bucket = await bucketOf(registry, ctx, sc.cwd);
 			return {
 				ok: true,
-				record: recView(record)
+				results: await applyDecisions(ctx, sc.session, sc.cwd, bucket, Array.isArray(args.items) ? args.items : [])
 			};
 		},
 		"edrv.read": async (args) => {
@@ -2790,7 +2991,30 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx)) {
 		"compat": async () => ({
 			ok: true,
 			report: await buildReport(ctx)
-		})
+		}),
+		"vscode.devFormGet": async () => ({
+			ok: true,
+			devForm: readDevForm()
+		}),
+		"vscode.devFormSet": async (args) => {
+			try {
+				const result = await setDevForm(ctx, args.enabled === true, args.path);
+				if (!result.ok) return {
+					ok: false,
+					error: result.error ?? "切换开发形态失败"
+				};
+				return {
+					ok: true,
+					devForm: readDevForm(),
+					restart: result.restart
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					error: String(error)
+				};
+			}
+		}
 	};
 }
 /**