agent-purge 是一个本地提示词配置工具，为 Codex、Claude Code、OpenCode、pi 等执行器提供统一的人设管理入口。你可以在 Web 控制台中配置，也可以直接通过命令行启动；不同执行器仍保留自己的工具、模型和工作流程。

• 一份配置，多种入口：CLI 与 Web 共用人设和状态，支持单次启动、常驻配置、会话扩展与项目规则。
• 按执行器独立设置：默认跟随全局，也能为某个执行器单独选择人设或模式。
• 支持热切，也说明边界：具备每轮回调的动态通道可在下一轮读取变更；静态入口需要新会话。
• 变更可追溯、可撤销：记录托管写入和恢复依据；外部修改会保留，恢复冲突明确报错。
• 本地优先、零生产依赖：不需要额外云端配置服务，人设与程序分开保存，升级不覆盖用户数据。

需要 Node.js 20+，并先安装你要使用的 coding agent。

npm install -g agent-purge
agent-purge web

也可以直接使用 npx agent-purge web，不进行全局安装。

1. 在「人设库」编辑起步模板，或新建自己的人设。
2. 回到「控制台」选择人设和模式，保存设置，再开启需要管理的执行器。
3. 按执行器详情中的提示，新建会话或重新加载插件。

控制台默认地址为 http://127.0.0.1:7788。首次打开不会自动接管所有执行器；默认启动项与应用范围分别配置。

查看窄屏布局

人设正文决定要提供给执行器的提示词；名称和说明只用于管理。首次运行会生成 neutral 起步模板，你可以在 Web 中直接编辑，也可以创建自己的 Markdown 文件。

agent-purge ls                       # 查看人设
agent-purge use <id>                 # 切换并同步已选范围
agent-purge mode append              # 修改全局模式
agent-purge use <id> --for codex     # 只给 Codex 指定人设
agent-purge use follow --for codex   # 恢复跟随全局

strict 不等于“模型只收到人设”。 实际角色可能是 system、developer 或项目上下文，取决于宿主和通道。希望保留宿主说明时，可先试 append。

---
id: concise
name: 简洁协作
description: 中文、先结论、修改前先读代码
---

用简体中文协作。先给结论，再给依据。
修改代码前先阅读现有实现；不确定时明确说明。

只想临时使用，可以通过 agent-purge 启动一次，不必登记常驻通道：

agent-purge codex --mode append
agent-purge pi --ask "解释这段代码"
agent-purge codex -- --help          # -- 后的参数交给宿主

要让其他启动入口也读取配置，再按需选择以下通道：

agent-purge install codex
agent-purge arm pi --slash
agent-purge project on pi --dir /path/to/project
agent-purge status

arm <h> 会尝试开启该执行器可用的常驻、命令和 slash 通道，结果逐项报告；项目通道需单独选择。同一人设经多个入口提供时可能重复，建议只开启需要的范围。

使用 magpie 网关？ 可选插件位于 magpie-plugin/，不是仓库根目录。安装方法和网关改写边界见 magpie 插件说明。

以下为支持范围与当前验证程度；请求级验证只覆盖表中明确说明的宿主，不是对所有版本的兼容承诺。

首次安装或更新插件代码后，仍需重新加载宿主。配置写入、历史测试通过、当前会话实际生效，是不同状态。

Windows 与 WSL/Linux 已执行回归，macOS 尚待实机验证。Hermes、zcode 未计为本轮通过。请求角色、宿主残留、浏览器覆盖与已知安装问题统一记录在兼容性与限制，不以模型自称身份作为验收依据。

卸载 npm 程序时，先撤销接管，再移除程序：

agent-purge clean
npm uninstall -g agent-purge

Windows 安装器卸载也会先撤销接管并保留人设。发生恢复冲突时，保留报错指出的文件和凭据，先比较修改再处理；不要直接删除备份。历史会话中已经发送的内容无法撤回。

需要永久删除数据时，先备份，再按完整卸载说明操作；self-uninstall --yes 与普通卸载不同。

• 本机管理：默认数据目录为 ~/.agent-purge/；Windows 对应 C:\Users\<用户>\.agent-purge\。可通过 AGENT_PURGE_HOME 调整，程序升级不会覆盖这份目录。
• 模型请求仍会联网：启用后，人设会随宿主请求发送给其配置的模型服务；本地管理不等于离线运行。更新检查也会访问 GitHub。
• 不直接修改宿主权限：项目管理提示词和配置入口，不破解宿主、不绕过授权；不保证改写后的模型行为。
• 只在有权管理的环境使用：Web 仅监听 127.0.0.1，不要直接暴露到公网。完整要求见下方声明。

npm ci --ignore-scripts
npm run check:repo
npm test

回归测试保留在 test/，临时日志与构建产物不进入源码仓库。

• 合法、授权使用：请遵守适用法律、宿主及模型服务条款，不用于未经授权的访问、攻击、数据窃取或其他违法活动。
• 使用前评估风险：提示词改写可能影响模型行为。请先备份配置、在隔离环境测试，并审核重要操作与输出。
• 按现状提供：软件的许可、保证排除与责任限制以 MIT LICENSE 为准；本说明不附加与其冲突的授权限制。

完整声明也可在 docs/LEGAL.md 单独阅读。

许可文件：MIT LICENSE。使用声明见上节及 docs/LEGAL.md。

感谢 LINUX DO 社区，以及所有报告问题、补充适配和参与改进的使用者。