agent-purge 0.2.1 → 0.2.3

package/lib/caps.mjs

@@ -46,6 +46,8 @@ const DESKTOP_FIRST = new Set(["zcode", "antigravity", "qoder", "workbuddy"]);
 	},
 	qoder: { shim: "提示词在服务端，本地拦不到" },
 	workbuddy: { shim: "提示词在服务端，本地拦不到" },
+	// dsh 的 CLI 只能起 headless：接管裸命令会把桌面/网页入口静默改道
+	dsh: { shim: "dsh 命令行只能起 headless：接管裸命令会让双击/网页入口变成终端会话；要三形态就装常驻插件（install）" },
 	codebuddy: {
 		install: "只有 settings.json（插件开关/模型），没有能把文本塞进提示的词条；实测只能走启动参数或壳",
 	},
@@ -62,6 +64,8 @@ const BLOCKED = { antigravity: "二进制补丁才能改它的系统提示，配
 const HOT = {
 	pi: { kind: "command", needs: "slash", how: "扩展钩子 before_agent_start：/purge 或改设置，下一轮生效" },
 	opencode: { kind: "state", needs: "install", how: "插件钩子 chat.system.transform 每轮读 state.json + active.md：改设置下一轮生效" },
+	dsh: { kind: "state", needs: "install", how: "cordis 插件每轮 assemble 读 state.json + active.md：改设置下一轮生效（desktop 装完要重启一次）" },
+	opencode2: { kind: "state", needs: "install", how: "v2 插件 ctx.session.hook('context') 每轮读 state.json + active.md：改设置下一轮生效" },
 };
 
 /** 没有每轮拼装点的：说明为什么只能重启 */
@@ -105,7 +109,7 @@ export function capsFor(id, ctx = {}) {
 				: `本机 PATH 里找不到 ${id}（先把它装到 PATH 上）`
 			: desktop
 				? `只对终端里敲 \`${id}\` 生效；桌面图标启动绕开 PATH`
-				: null;
+				: reason(id, "shim");
 
 	const t = persistTargets[id];
 	// user 层不算能力：写下去也压不住 harness 自己的身份，装了等于白装

package/lib/detect.mjs

@@ -14,6 +14,8 @@ export const specs = {
 	codebuddy: { bins: ["codebuddy"], homes: [["CODEBUDDY_HOME", ".codebuddy"]], version: ["--version"], marker: "history.jsonl" },
 	claude: { bins: ["claude"], homes: [["CLAUDE_CONFIG_DIR", ".claude"]], version: ["--version"], marker: "settings.json" },
 	opencode: { bins: ["opencode"], homes: [["XDG_CONFIG_HOME", ".config/opencode"]], version: ["--version"], marker: "opencode.json" },
+	opencode2: { bins: ["opencode2"], homes: [["XDG_CONFIG_HOME", ".config/opencode"]], version: ["--version"], marker: "opencode.json" },
+	dsh: { bins: ["dsh"], homes: [["DSH_HOME", ".dsh"]], version: ["--version"], marker: "profiles" },
 	grok: { bins: ["grok"], homes: [["GROK_HOME", ".grok"]], version: ["--version"], marker: "config.toml" },
 	omp: { bins: ["omp"], homes: [["OMP_HOME", ".omp"]], version: ["--version"], marker: "agent/config.yml" },
 	hermes: { bins: ["hermes"], homes: [["HERMES_HOME", "AppData/Local/hermes"]], version: ["--version"], marker: "hermes-agent" },

package/lib/dsh.mjs

@@ -0,0 +1,177 @@
+// dsh（DeepSeek Harness）的插件通道，三形态（desktop / web / headless）共用一套写法。
+//
+// 两个插件名，互不覆盖：
+//   agent-purge          常驻：每次 assemble 读 state.json + active.md，off 即时生效
+//   agent-purge-session  一次性：persona 快照编译进源码，进程退出即删
+//
+// 三个 profile 都要装：paths 推导自 profile 的 dirname（src/index.js → package root），
+// 所以包必须放在 <profile>/node_modules/<name> 下。
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+export const DSH_PROFILES = ["desktop", "web", "headless"];
+export const RESIDENT = "agent-purge";
+export const SESSION = "agent-purge-session";
+
+export const dshHome = () => process.env.DSH_HOME || join(homedir(), ".dsh");
+export const profileDir = (p) => join(dshHome(), "profiles", p);
+export const pluginDir = (p, name = RESIDENT) => join(profileDir(p), "node_modules", name);
+const patchFile = (p) => join(profileDir(p), "cordis.patch.yml");
+
+const mark = (name) => [`# >>> agent-purge:${name}`, `# <<< agent-purge:${name}`];
+
+/** 这个 package.json 是 agent-purge 写的吗（别碰同名外来目录）。 */
+const isOurs = (meta) => existsSync(meta) && /"?agentPurge"?\s*:\s*true/.test(readFileSync(meta, "utf8"));
+
+/** 常驻插件：不编译人设，每次请求现读 state；off 就原样放过宿主的结果。 */
+export function residentSource(root, activePath) {
+	const state = join(root, "state.json").replace(/\\/g, "/");
+	// active.md 是派生物，实际位置是 <root>/personas/active.md（由 createStore().materialize 给出）
+	const active = String(activePath).replace(/\\/g, "/");
+	return `// 由 agent-purge 生成；删掉本目录 + patch 段即取消。
+import { readFileSync } from "node:fs";
+const STATE = ${JSON.stringify(state)};
+const ACTIVE = ${JSON.stringify(active)};
+function cfg() {
+  try {
+    const st = JSON.parse(readFileSync(STATE, "utf8"));
+    // 磁盘卸载后内存里的回调还在：armed 里没有 install 就当成已关闭
+    const armed = st && st.armed && st.armed.dsh;
+    if (!Array.isArray(armed) || !armed.includes("install")) return null;
+    const mode = (st && st.default && st.default.mode) || "replace";
+    if (mode === "off") return null;
+    const body = readFileSync(ACTIVE, "utf8").trim();
+    return body ? { mode, body } : null;
+  } catch {
+    return null;
+  }
+}
+export default {
+  name: ${JSON.stringify(RESIDENT)},
+  inject: ["systemPrompt"],
+  apply(ctx) {
+    const prompt = ctx.systemPrompt;
+    const orig = prompt.assemble.bind(prompt);
+    prompt.assemble = async (...rest) => {
+      const asm = await orig(...rest);
+      const c = cfg();
+      if (!c) return asm;
+      if (c.mode === "append") return { ...asm, sections: [...(asm.sections || []), { name: ${JSON.stringify(RESIDENT)}, text: c.body }] };
+      return { ...asm, sections: [{ name: ${JSON.stringify(RESIDENT)}, text: c.body }] };
+    };
+  },
+};
+`;
+}
+
+/** 一次性插件：人设快照内嵌，进程结束就没。 */
+export function sessionSource(personaText, mode) {
+	const body =
+		mode === "append"
+			? `\t\tctx.systemPrompt.section({ name: ${JSON.stringify(SESSION)}, order: 5100, interpolate: false, text: PERSONA });`
+			: `\t\tconst prompt = ctx.systemPrompt;\n\t\tconst orig = prompt.assemble.bind(prompt);\n\t\tprompt.assemble = async (...rest) => {\n\t\t\tconst asm = await orig(...rest);\n\t\t\treturn { ...asm, sections: [{ name: ${JSON.stringify(SESSION)}, text: PERSONA }] };\n\t\t};`;
+	return `// 由 agent-purge 生成（一次性，进程退出即删）。
+const PERSONA = ${JSON.stringify(personaText.trim())};
+
+export default {
+  name: ${JSON.stringify(SESSION)},
+  inject: ["systemPrompt"],
+  apply(ctx) {
+${body}
+  },
+};
+`;
+}
+
+/** 装一个插件名到三个 profile，并在 patch 里挂上（同一段 marker 幂等）。 */
+export function addPlugin(name, source) {
+	const pkg = JSON.stringify({ name, version: "0.0.0", type: "module", main: "index.js", agentPurge: true }, null, 1);
+	const [begin, end] = mark(name);
+	const block = `\n${begin}\n- insert:\n    - id: ${name}\n      name: ${name}\n${end}\n`;
+	const files = [];
+	const touched = []; // { dir, patch, before }：中途抛错时按相反顺序回滚
+	// 预检：同名目录要么不存在，要么是我们的（package.json 带 agentPurge 标记），否则不碰
+	for (const p of DSH_PROFILES) {
+		const dir = pluginDir(p, name);
+		const meta = join(dir, "package.json");
+		if (existsSync(dir) && !isOurs(meta)) throw new Error(`${dir} 已存在且不是 agent-purge 装的，拒绝覆盖`);
+	}
+	try {
+		for (const p of DSH_PROFILES) {
+			const dir = pluginDir(p, name);
+			const patch = patchFile(p);
+			const before = existsSync(patch) ? readFileSync(patch, "utf8") : null;
+			// 先登记再动手：下面任何一步抛错，这一轮的产物都能被回滚
+			touched.push({ dir, patch, before });
+			mkdirSync(dir, { recursive: true });
+			writeFileSync(join(dir, "package.json"), pkg);
+			writeFileSync(join(dir, "index.js"), source);
+			files.push(dir);
+			const old = before ?? "# agent-purge 新建的 patch 层\n";
+			if (old.includes(begin)) continue;
+			// `[]` 是合法空数组，后面接 `- insert:` 就是非法 YAML：整份换成我们的段
+			// 不存在也算“空”：走 stash 分支才能把“原本没有这个文件”记下来，卸载后才不会留个空壳
+			const empty = before === null || /^\s*(\[\s*\]\s*)?$/.test(old);
+			const next = empty ? block.slice(1) : old + block;
+			if (empty) {
+				// 整份替换会把原文端掉：原文 + 我们写出的成品都存下，卸载时对得上才整份还原
+				// （对不上 = 期间被人改过，那就只剔自己那段）
+				writeFileSync(join(dir, ".patch.before"), JSON.stringify({ before, after: next }));
+			}
+			writeFileSync(patch, next);
+		}
+	} catch (e) {
+		// 回滚：撤销本次已写的文件，宁可完全没装也不留半套
+		for (const { dir, patch, before } of touched.reverse()) {
+			rmSync(dir, { recursive: true, force: true });
+			if (before === null) rmSync(patch, { force: true });
+			else writeFileSync(patch, before);
+		}
+		throw e;
+	}
+	return { dirs: files, profiles: DSH_PROFILES };
+}
+
+/** 只撤自己那一段：目录 + patch marker，别的配置原样。 */
+export function removePlugin(name) {
+	const [begin, end] = mark(name);
+	// 删 install 写入的那一段：前导 \n 可有可无（整份替换的形态没有），尾随 \n 一并吃掉
+	const re = new RegExp(`(?:^|\\n)${begin}[\\s\\S]*?${end}\\n?`, "g");
+	for (const p of DSH_PROFILES) {
+		const dir = pluginDir(p, name);
+		const meta = join(dir, "package.json");
+		// 只删自己装的；同名但不是我们的目录留着（可能被用户或其他包占了）
+		const ours = isOurs(meta);
+		const stashFile = join(dir, ".patch.before");
+		// 当初整份替换过的：记录躲在插件目录里，先读出来，不然删目录就丢了
+		let stash = null;
+		if (ours && existsSync(stashFile)) {
+			try {
+				stash = JSON.parse(readFileSync(stashFile, "utf8"));
+			} catch {
+				stash = null;
+			}
+		}
+		if (ours) rmSync(dir, { recursive: true, force: true });
+		const patch = patchFile(p);
+		if (!existsSync(patch)) continue;
+		const text = readFileSync(patch, "utf8");
+		// 我们整份写的、且此后没人动过 → 整份还原（原本没这个文件就删掉它）
+		if (stash && text === stash.after) {
+			if (stash.before === null) rmSync(patch, { force: true });
+			else writeFileSync(patch, stash.before);
+			continue;
+		}
+		if (text.includes(begin)) writeFileSync(patch, text.replace(re, ""));
+	}
+}
+
+/** patch 里还挂着这个名字吗（status 用；不许在有其他 insert 时谎报干净）。 */
+export function hasPlugin(name) {
+	const [begin] = mark(name);
+	return DSH_PROFILES.every((p) => {
+		const patch = patchFile(p);
+		return existsSync(join(pluginDir(p, name), "index.js")) && existsSync(patch) && readFileSync(patch, "utf8").includes(begin);
+	});
+}

package/lib/persist.mjs

@@ -3,10 +3,13 @@
 // 不动二进制——这里只做可逆的配置改动。
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
+import { RESIDENT as DSH_RESIDENT, SESSION as DSH_SESSION, addPlugin, hasPlugin, pluginDir, residentSource, removePlugin } from "./dsh.mjs";
 
 const BEGIN = "# >>> agent-purge";
 const END = "# <<< agent-purge";
 const home = process.env.USERPROFILE || process.env.HOME;
+// opencode 认 XDG_CONFIG_HOME（lib/detect.mjs 也是这么探测的）：两处必须同一个落点，否则装了白装
+export const opencodePlugins = () => join(process.env.XDG_CONFIG_HOME || join(home, ".config"), "opencode", "plugins");
 
 export const targets = {
 	pi: {
@@ -67,8 +70,10 @@ export const targets = {
 	},
 	opencode: {
 		// 写入用全局单一位置；读取/删除要扫全部历史位置，否则老版本留下的项目级插件会继续注入
-		file: () => join(home, ".config", "opencode", "plugins", "agent-purge.ts"),
+		file: () => join(opencodePlugins(), "agent-purge.ts"),
 		files: () => [
+			join(opencodePlugins(), "agent-purge.ts"),
+			// 旧落点：设了 XDG 的机器上，老版本写在 home/.config 的那份也得能被扫到并清掉
 			join(home, ".config", "opencode", "plugins", "agent-purge.ts"),
 			join(home, ".config", "opencode", "plugin", "agent-purge.ts"),
 			join(process.cwd(), ".opencode", "plugin", "agent-purge.ts"),
@@ -99,6 +104,62 @@ export const AgentPurge = async () => ({
     else output.system.splice(0, output.system.length, c.body);
   },
 });
+`,
+	},
+	dsh: {
+		// cordis 插件挂 systemPrompt 层；三个 profile 各一份（desktop 由 Electron 独占，装完要重启一次）
+		file: () => join(pluginDir("desktop"), "index.js"),
+		kind: "file",
+		layer: "sys",
+		note: "cordis 插件包；运行时读 state.json，off 即时生效；desktop 需重启一次",
+		probe: () => hasPlugin(DSH_RESIDENT),
+		install: ({ root, active }) => {
+			const r = addPlugin(DSH_RESIDENT, residentSource(root, active));
+			return { file: join(pluginDir("desktop"), "index.js"), note: `三个 profile：${r.profiles.join("/")}；desktop 重启 DeepSeek Harness 生效` };
+		},
+		uninstall: () => {
+			removePlugin(DSH_RESIDENT);
+			// 一次性插件被 SIGKILL 时不会自己清，一并扫掉
+			removePlugin(DSH_SESSION);
+			return { file: join(pluginDir("desktop"), "index.js") };
+		},
+	},
+	opencode2: {
+		// v2 新版插件 API（V1 的 experimental.chat.system.transform 在 2.x 已废），与 V1 插件文件物理分开
+		file: () => join(opencodePlugins(), "agent-purge-v2.ts"),
+		files: () => [join(opencodePlugins(), "agent-purge-v2.ts"), join(opencodePlugins(), "agent-purge-v2-session.ts")],
+		kind: "file",
+		layer: "sys",
+		note: "v2 插件 ctx.session.hook(\"context\")；运行时读 state.json，热切",
+		body: (active, root) => `import { readFileSync } from "node:fs";
+// agent-purge 托管文件：删除即可取消
+const STATE = ${JSON.stringify(join(root, "state.json").replace(/\\/g, "/"))};
+const ACTIVE = ${JSON.stringify(String(active).replace(/\\/g, "/"))};
+function cfg() {
+  try {
+    const st = JSON.parse(readFileSync(STATE, "utf8"));
+    // 磁盘卸载后服务里已加载的回调还在：armed 没了就当成已关闭
+    const armed = st && st.armed && st.armed.opencode2;
+    if (!Array.isArray(armed) || !armed.includes("install")) return null;
+    const mode = (st && st.default && st.default.mode) || "replace";
+    if (mode === "off") return null;
+    const body = readFileSync(ACTIVE, "utf8").trim();
+    return body ? { mode, body } : null;
+  } catch {
+    return null;
+  }
+}
+export default {
+  id: "agent-purge",
+  async setup(ctx) {
+    await ctx.session.hook("context", (event) => {
+      const c = cfg();
+      if (!c) return;
+      if (c.mode === "append") event.system.push({ type: "text", text: c.body });
+      else event.system.splice(0, event.system.length, { type: "text", text: c.body });
+    });
+  },
+};
 `,
 	},
 };
@@ -106,6 +167,8 @@ export const AgentPurge = async () => ({
 export function status(_root) {
 	return Object.entries(targets).map(([name, t]) => {
 		const file = t.file();
+		// 自定义探针（多文件目标用），优先于默认的存在性判断
+		if (t.probe) return { name, installed: t.probe(), file };
 		const candidates = t.files ? t.files() : [file];
 		const present = candidates.filter((f) => existsSync(f));
 		if (!present.length) return { name, installed: false, file };
@@ -121,6 +184,15 @@ export function status(_root) {
 export function install(name, { root, active }) {
 	const t = targets[name];
 	if (!t) return { error: `${name} 没有持久化后端（见 notes：grok/omp 只有 CLI 开关，claude/zcode/antigravity 要打补丁）` };
+	// 多文件/自定义布局的 harness 自带安装函数（dsh 三个 profile、opencode2 v2 插件）
+	// 它们的失败信号是异常（同名外来目录拒绝覆盖等），这里转成调用方约好的 {error}
+	if (t.install) {
+		try {
+			return { ...t.install({ root, active }), action: "custom" };
+		} catch (e) {
+			return { error: e.message };
+		}
+	}
 	const file = t.file();
 	mkdirSync(dirname(file), { recursive: true });
 	if (t.kind === "file") {
@@ -136,6 +208,13 @@ export function install(name, { root, active }) {
 export function uninstall(name) {
 	const t = targets[name];
 	if (!t) return { error: `${name} 没有持久化后端` };
+	if (t.uninstall) {
+		try {
+			return { ...t.uninstall(), action: "custom" };
+		} catch (e) {
+			return { error: e.message };
+		}
+	}
 	if (t.kind === "file") {
 		// 清掉所有历史位置，保证“关掉”之后没有任何残留插件还在注入
 		const candidates = t.files ? t.files() : [t.file()];