agent-purge

agent-purge v0.2.25

✨ 新支持 (New Support)

1. 🚀 Antigravity（Google 桌面 App + CLI agy）接管支持

• 背景：此前 Antigravity 在矩阵里是 binary-patch / inject: false，agent-purge antigravity 只打印一句「改不了」。逆向确认后结论变了：配置层有可写入口，不需要动二进制。
• 注入落点：~/.gemini/config/AGENTS.md。桌面 App 与 CLI agy 共读同一个 ~/.gemini/config/；该文件没有 frontmatter 就是 always_on 全局规则，宿主自己把它拼进 systemInstruction 的 <user_rules> 段，并在前面写明 These rules take precedence over any other instructions。
• 实测证据（本机 CLI agy 1.5.3 / 桌面语言服务 1.23.x，隔离 HOME + loopback 抓包）：
  • off / strict / replace / append 四模式均捕获主请求，进程退出码 0；
  • marker 全部落在 system 层（systemInstruction），user 层 0 次；
  • system 字符数 15,378（off）→ 15,895 / 15,844 / 15,843（strict / replace / append）；
  • <user_rules> 位于 </identity> 之后，即规则段排在宿主身份句后面。
• 真模型验证：CLI 登录后，在同一落点（~/.gemini/config/AGENTS.md，手写同语义内容）连真实模型问三句（直问身份 / 追问底层模型 / 越狱式要求说出真名），三次都回答新人设、不再自称 Antigravity。agent-purge 自己写入的托管块则由上面的抓包链路验证落在 systemInstruction —— 两者是同一条通道；「agent-purge 写入 + 真模型」的单一跑批因本机代理中断未做（NOT RUN）。
• 残留（不隐瞒）：<identity> 里那句 You are Antigravity, ... 仍在提示词中，靠规则段的优先级声明压住，不是删除。想真正删掉身份段只有两条路：等长替换 resources/bin/language_server.exe（会让签名失效、更新被覆盖），或手动在 GUI 里选自定义 agent（~/.gemini/config/agents/<name>.md 能整段替换 <identity>，但 settings.json 里没有默认 agent 键，34 个键全试过，做不到自动生效）。
• 通道能力：只有 install（常驻配置）可用；shim 不可用（CLI 命令名是 agy 而非 antigravity，裸命令接管的落点名对不上），slash 不可用（无 /purge 等价入口）。
• CLI 探测：agy 装在 %LOCALAPPDATA%\agy\bin\agy.exe，GUI 进程继承的 PATH 常常没有这一项，所以 detect 增加了固定落点回退，并额外把 ~/.gemini/config 当作「跑过这个 App」的判据。

2. 🔍 抓包链路支持 Gemini 原生协议

• bench/capture-provider.mjs 之前只认 system / instructions / messages / input 四种字段，Gemini 的 systemInstruction.parts + contents[] 完全抓不到（会被判成「没有 system 层」）。
• 现在补上 Gemini 原生协议：请求识别（/v1beta/models/<model>:streamGenerateContent）、system 段提取（systemInstruction.parts）、SSE 响应（candidates[].content.parts）。agent-purge verify antigravity 可直接复用这条链路。

🔧 修复 (Fixes)

• shim 能力判定会把「名字对不上」翻成可用：antigravity 的 CLI 叫 agy，resolveReal("antigravity") 永远为 null，但旧逻辑 !shimWhy || (desktop && hasCli) 在有 bin 时会把这条通道标成可用，导致 UI 上出现一个点了没用的开关。现在对「CLI 名字与 harness 名不一致」的家加了显式黑名单，先给出真实原因而不是撒谎。

• 临时启动会撤掉常驻块：最初把「单次启动」实现成 install → uninstall，实测发现用户若先 arm --install 常驻过，agent-purge antigravity 跑完会把常驻块一起删掉（stash.before 为 null → 卸载走删文件分支）。改为按原字节回滚（temporaryAntigravity），常驻块、用户自己的规则都原样留下，并补了三条回归测试（常驻在场 / 干净机器 / 用户自带规则）。

📦 安装与升级 (Installation & Upgrade)

npm install -g agent-purge@latest
agent-purge arm antigravity --install

需要先装好 Antigravity（桌面 App 或 agy CLI）。agent-purge antigravity 也可直接带人设启动 CLI，退出时按原字节还原。

便携版与安装器见本 Release 附件（agent-purge.exe / agent-purge-0.2.25-setup.exe）。

agent-purge v0.2.24

🔧 修复与优化 (Fixes & Improvements)

1. 🛡️ 增加 DSH 存量旧版配置静默就地自愈机制（消除 pnpm v11 prune 导致的启动崩溃）

• 背景：v0.2.19 及更早版本将插件写入 profile 的 node_modules，并在 cordis.patch.yml 中使用裸包名。宿主自带的 pnpm v11 在执行插件安装或依赖重整时，会将未在 package.json 声明的目录当成孤立依赖清理掉，导致 DSH 启动报错 Cannot find package 'agent-purge'；若未重装，用户安装其他插件也会报错。
• 改动：
  • 就地自愈 (Self-Healing)：在只读查询与探针链路（status / probe）中增加 healStaleProfiles()，只要数据目录中存在新版插件包，自动将旧版裸包名重写为绝对规范的 file: URL，消除 YAML 根部残留的空数组 []，并安全收回 node_modules 下的旧版副本。
  • 状态判定收紧：blockAlive 严格核验 patch 块内是否为规范的 file: URL 且数据目录真实存在文件，杜绝旧副本被清理后的假阳性报告。
  • 运行留痕：自愈操作自动在 <数据目录>/dsh.log 记录留痕日志，保障完全可追溯。

2. 🧪 补齐 DSH 跨版本真机测试矩阵与请求体抓包验证

• 实测验证 DSH 0.2.1-rc.2（loader 1.0.6）、0.2.1-rc.5（桌面版 Electron）与 0.2.2-rc.1（loader 1.1.0）全版本兼容性。
• 通过本地 loopback 抓包验证四种模式发往大模型的实际提示词请求：strict 模式从宿主默认 2729 字符彻底纯化为 112 字符纯净人设，宿主身份声明完全剥离。

📦 安装与升级 (Installation & Upgrade)

npm install -g agent-purge@latest
agent-purge status

存量 DSH 用户无需手动重新安装，升级后执行一次 agent-purge status 或打开 Web 界面即可自动完成就地自愈。

便携版与安装器见本 Release 附件（agent-purge.exe / agent-purge-0.2.24-setup.exe）。

agent-purge v0.2.23

🔧 修复 (Fixes)

1. 🐛 修复 DSH 激活会话热切插件报错 ReferenceError: hostProfile is not defined（Issue #12）

• 现象：在 DSH 0.2.2（及 0.2.1）下启用热切插件 agent-purge-slash 启动时，抛出 ReferenceError: hostProfile is not defined at Object.apply [as callback]，导致插件激活失败。
• 根因：v0.2.20 将插件包迁移至数据目录时，apply(ctx) 引入了从宿主 profileContext 读取 profile 名字的动态推导机制。但在 slashSource 插件模板中遗漏了 hostProfile(ctx) 函数定义，且模块内顶层变量写为 const PROFILE，导致即使补齐函数也会报 TypeError: Assignment to constant variable。
• 修复：
  • 在 slashSource 中补齐 hostProfile(ctx) 并在顶层定义 let PROFILE = PROFILE_FROM_PATH;，与 residentSource 保持完全一致。
  • 增加单元测试，对生成的 slashSource 模块进行真实动态加载与 apply(ctx) 回调执行测试，覆盖 profile 动态提取与 /purge on|mode|status|off 命令注册与状态写入。

📦 安装与升级 (Installation & Upgrade)

npm install -g agent-purge@latest
agent-purge install dsh

便携版与安装器见本 Release 附件（agent-purge.exe / agent-purge-0.2.23-setup.exe）。

agent-purge v0.2.22

🌟 核心更新亮点 (Highlights)

1. 🌍 新增 WorkBuddy AI 国际版支持（5.9.4 实测通过）

• 新增宿主：workbuddy-ai（国际版 WorkBuddy AI，workbuddy.ai），与国内版 workbuddy 独立并列，可单独安装/卸载，也可同时装。
• 实测证据（本机 CDP 直连 renderer，真发消息）：写入人设后提问「你叫什么名字」，回答就是人设里的名字；卸载后配置文件与 IDENTITY.md/SOUL.md/USER.md 字节还原。
• 身份通道：personalization.customPrompt（进 identity_context 的 <user_custom_instructions>），配合 ~/.workbuddy-ai/user-*/{IDENTITY,SOUL,USER}.md 同步。

2. 🔧 修复写错文件：app-config.json 才是主路径

• 现象：只写 ~/.workbuddy-ai/settings.json 时，WorkBuddy 设置面板仍显示旧值，新任务也不按新人设作答。
• 根因：WorkBuddy 的 PersonalizationCollector 先读 AppConfigService.get("personalization")，只有拿不到才 readLegacySettings() 回落 settings.json。而 AppConfigService 的主存是 <home>/app/app-config.json。国内 5.9.3 与国际 5.9.4 行为一致（两者都写时以 app-config.json 为准）。
• 修复：app-config.json 存在就写它，不存在（更老的版本）才写 settings.json；安装/卸载都会把另一份里 agent-purge 自己写过的 marker 块清掉，别人的文本原样保留。写入位置不再随「用户点没点过设置面板」漂移。

3. 🈶 修复中文安装目录定位失败

• 现象：WorkBuddy 装在 D:\WorkBuddy国际版\WorkBuddyAI 时，agent-purge 认不出（findTemplatesDir 返回 null、detect 报未安装）。
• 根因：.lnk 的 LocalBasePath 是系统 ANSI 码页（中文机 936/GBK），lib/locate.mjs 却按 latin1 解码，得到 D:\WorkBuddy¹ú¼Ê°æ\...，这个路径根本不存在。
• 修复：按注册表 ACP 选码页解码（gbk / big5 / shift_jis / euc-kr / windows-1252），取不到或非法字节退回 latin1。修好后 locate 直接命中 D:\WorkBuddy国际版\WorkBuddyAI\WorkBuddyAI.exe。

4. 🧩 国际版识别与能力表

• detect 新增 workbuddy-ai 规格（WorkBuddyAI.exe、~/.workbuddy-ai 配置根、WORKBUDDY_AI_CONFIG_DIR / WORKBUDDY_AI_TEMPLATES_DIR 环境变量）。
• Web 控制台图标、sys 层映射、caps 桌面优先与项目级规则说明补齐。

⬆️ 升级注意

• 国内版与国际版的写入位置都改成了 app/app-config.json（若该文件存在）。之前写进 settings.json 的块会在下次 install 时自动撤走。
• 名字/人设设定仍是 WorkBuddy 自己的云端个人配置，agent-purge 不写入、也不清除。

📦 安装与升级 (Installation & Upgrade)

npm install -g agent-purge@latest
agent-purge install workbuddy-ai   # 或 workbuddy / 两者都装

便携版与安装器见本 Release 附件（agent-purge.exe / agent-purge-0.2.22-setup.exe）。