agent-purge 0.2.4 → 0.2.5

package/lib/dsh.mjs

@@ -30,7 +30,7 @@ export function residentSource(root, activePath) {
 	// active.md 是派生物，实际位置是 <root>/personas/active.md（由 createStore().materialize 给出）
 	const active = String(activePath).replace(/\\/g, "/");
 	return `// 由 agent-purge 生成；删掉本目录 + patch 段即取消。
-import { readFileSync, appendFileSync } from "node:fs";
+import { readFileSync, appendFileSync, writeFileSync } from "node:fs";
 const STATE = ${JSON.stringify(state)};
 const ACTIVE = ${JSON.stringify(active)};
 const NAME = ${JSON.stringify(RESIDENT)};
@@ -73,11 +73,87 @@ function put(asm, c) {
   if (c.mode === "append") return { ...asm, sections: [...sections, { name: NAME, text: c.body }] };
   return { ...asm, sections: [{ name: NAME, text: c.body }] };
 }
+// ---- /ap 斜杠命令：直接改 state.json，不产生模型消息 ----
+function readState() {
+  try { return JSON.parse(readFileSync(STATE, "utf8")) || {}; } catch { return {}; }
+}
+function saveState(st) {
+  writeFileSync(STATE, JSON.stringify(st, null, 2) + "\\n");
+}
+function apPatch(fn) {
+  const st = readState();
+  if (!st.armed || typeof st.armed !== "object") st.armed = {};
+  if (!Array.isArray(st.armed.dsh)) st.armed.dsh = [];
+  fn(st, st.armed.dsh);
+  saveState(st);
+}
+function handleAp(raw) {
+  const parts = String(raw || "").trim().split(/\s+/).filter(Boolean);
+  const cmd = (parts[0] || "status").toLowerCase();
+  const arg = parts.slice(1).join(" ").trim();
+  if (cmd === "off") {
+    apPatch((st, a) => {
+      if (a.includes("install")) {
+        st.dshPrevArmed = a.slice();
+        st.armed.dsh = a.filter((x) => x !== "install");
+      }
+    });
+    return { kind: "success", text: "agent-purge 已关闭（dsh），下一句起不注入" };
+  }
+  if (cmd === "on") {
+    apPatch((st, a) => {
+      if (!a.includes("install")) a.push("install");
+      delete st.dshPrevArmed;
+    });
+    return { kind: "success", text: "agent-purge 已开启（dsh），下一句起生效" };
+  }
+  if (cmd === "mode") {
+    const m = arg.toLowerCase();
+    if (m !== "strict" && m !== "replace" && m !== "append") {
+      return { kind: "error", text: "用法：/purge mode strict|replace|append" };
+    }
+    apPatch((st) => { if (!st.default || typeof st.default !== "object") st.default = {}; st.default.mode = m; });
+    return { kind: "success", text: "模式已切到 " + m };
+  }
+  if (cmd === "status" || cmd === "help") {
+    const st = readState();
+    const a = st.armed && Array.isArray(st.armed.dsh) ? st.armed.dsh : [];
+    const mode = (st.default && st.default.mode) || "replace";
+    return { kind: "success", text: "agent-purge / dsh：" + (a.includes("install") ? "开" : "关") + " · 模式 " + mode + " · 人设 " + (st.persona || "-") + "（可用：on | off | status | mode <strict|replace|append>）" };
+  }
+  return { kind: "error", text: "用法：/purge on | off | status | mode <strict|replace|append>" };
+}
 export default {
   name: NAME,
   inject: ["systemPrompt"],
   apply(ctx) {
     log("apply", "inject=" + JSON.stringify(["systemPrompt"]));
+    // /ap 斜杠命令：等 commands 服务就绪再注册；headless 没有该服务就不会触发，注入不受影响
+    try {
+      if (typeof ctx.inject === "function") {
+        ctx.inject(["commands"], (c) => {
+          const spec = {
+            description: "agent-purge 人设注入：开关 / 模式",
+            input: { hint: "on | off | status | mode <strict|replace|append>" },
+            handler: ({ rawInput }) => handleAp(rawInput),
+          };
+          // 主名 /purge（和 pi 等其他 harness 统一），/ap 留作别名；
+          // 与已有同名命令（如 dsh-purge）撞车时只跳过那一个，不影响注入
+          for (const n of ["purge", "ap"]) {
+            try {
+              c.commands.register({ name: n, ...spec });
+              log("command", "registered /" + n);
+            } catch (e) {
+              log("command", "skip /" + n + " " + (e && e.message));
+            }
+          }
+        });
+      } else {
+        log("command", "no inject api");
+      }
+    } catch (e) {
+      log("command", "err " + (e && e.message));
+    }
     // 宿主每轮 assemble 走 system-prompt/assemble 瀑布。必须 global：agent 作用域的
     // systemPrompt 是另一个实例，且切预设时宿主会整只换代理，实例上的 monkey-patch 会丢。
     const handler = async (assembly, _context, next) => {

package/lib/persist.mjs

@@ -111,11 +111,11 @@ export const AgentPurge = async () => ({
 		file: () => join(pluginDir("desktop"), "index.js"),
 		kind: "file",
 		layer: "sys",
-		note: "cordis 插件包；运行时读 state.json，off 即时生效；desktop 需重启一次",
+		note: "cordis 插件包；运行时每轮读 state.json，开关 / 切模式 / 换人设都即时生效；只有首次安装要重启一次",
 		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 生效` };
+			return { file: join(pluginDir("desktop"), "index.js"), note: `三个 profile：${r.profiles.join("/")}；重启一次 DeepSeek Harness 后插件开始工作（之后热切换）` };
 		},
 		uninstall: () => {
 			removePlugin(DSH_RESIDENT);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-purge",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "One persona, many coding agents: replace or inject system prompts across codex, claude, opencode (v1/v2), grok, omp, hermes, pi, zcode, dsh.",
   "type": "module",
   "bin": {