不死鸟 Phoenix
装在 Hermes Agent 上的插件。路由分档、风险防线、自愈系统，全程官方插件钩子接入，不改 Hermes 一行核心代码。
支持：Hermes Agent。 全程通过官方插件系统加载，卸载即恢复原状。
解决什么问题 · 快速开始 · 能力一览 · 视觉总览 · 安装 · 项目结构
不死鸟解决什么问题
Hermes Agent 本身是一个通用 Agent 框架，很多"用起来更安心"的能力要么官方还没做，要么需要自己配置。不死鸟把这些补上：
| 真实处境 | 你会得到 |
|---|---|
| 不知道一句话该配给哪个模型，贵模型处理"在吗"很浪费 | 四档加权计分自动判定，问题难度和模型成本自动对齐 |
| AI 代理连续报错，越错越乱还在硬着头皮往下跑 | 三态熔断器，连续失败自动跳闸，冷却后自动试探恢复 |
| 同样的错误反复踩，AI 每次都从头试错 | 抗体库查表，错误模式记下来，同一个坑不踩两次 |
| 长任务没人盯着，AI 跳过规划直接动手，或者悄悄做了高危操作 | /goal 激活期间清单强制 + 高危操作换模型复核 |
| 高危档位的回复到底有没有编造内容，肉眼看不出来 | 免费预检 + 付费交叉核验，仅在深度/真神档触发 |
| 主力模型欠费了，AI 直接罢工 | 本地 26B 模型优先兜底（仅 macOS），云端免费档二级兜底 |
| 聊到手机号/身份证/密码这类敏感信息，不确定要不要发去云端 | 命中敏感词后事后提醒，引导手动切到本地模型处理（仅 macOS） |
| 装的这版插件到底跟你电脑上的 Hermes 版本合不合 | 运行时自动比对，明确告诉你"合不合" |
快速开始
安装完成后，直接正常使用 Hermes：所有路由、防线都是自动生效的，不需要学新命令。
看当前状态：
hermes phoenix-status
一条命令看路由模式、熔断器状态、长任务状态、Hermes 版本兼容性、今日花费、抗体库统计。
长任务场景直接用 Hermes 原生命令，不死鸟自动接管清单强制和高危复核：
/goal 帮我重构一下这个模块的架构，确保测试全过
能力一览
| 模块 | 职责 | 一句话说明 |
|---|---|---|
| Router 路由分档 | 判断用哪个档位、哪个模型 | 闪答/日常/深度/真神四档加权计分自动判定 |
| Guardrails 风险防线 | 防止失控烧钱或闯祸 | 三态熔断器 + 高危操作审批闸 + 候选链健康追踪 |
| Selfheal 自愈系统 | 错误处理经验积累 | 抗体库查表，3次未解决自动升级，坏建议自动停用 |
| Loop Guard 长任务守护 | /goal 激活期间的安全网 |
清单强制 + 高危操作换模型复核 |
| Verify 幻觉核验 | 高危回复真实性核查 | 免费预检 + 付费交叉核验，通道故障自动降级放行 |
| Fallback 欠费降级 | 主力模型不可用时兜底 | 配合 Hermes 原生 fallback_model，本地 26B 模型优先、云端兜底 |
| Privacy 隐私路由 | 敏感内容处理提醒 | 命中敏感词后事后提醒，引导手动切到本地模型，同会话不重复提醒 |
| Version Check 版本核实 | 插件与 Hermes 版本兼容性 | 运行时自动比对，四种结果明确提示 |
| Checkpoint Reminder 存档点提醒 | 高危操作前提醒开启回滚保护 | 检测到高危操作且 Hermes 自带 checkpoint 功能未开启时事后提醒，引导手动开启 |
| Adaptive Approval 审批策略自适应 | 按历史批准记录动态调整确认频率 | 同类操作连续批准 3 次后不再重复确认，拒绝一次立即清零，永久高危类别不受信任影响 |
257 个自动化测试全程跟着功能走。完整技术拆解见 不死鸟 Phoenix 完整技术文档。
视觉总览
安装
下载
⚠️ 请从 Releases 页面下载安装包（几百 KB，纯代码）。不要点仓库首页的绿色 "Code → Download ZIP" 按钮——那下载的是整个仓库源码（含展示图片等资源，十几 MB），不是安装包，装不了。
解压到任意位置后继续下面的步骤。
macOS / Linux
cd 解压后的文件夹
bash install.sh
Windows（PowerShell）
cd 解压后的文件夹
.\install.ps1
安装脚本会自动检测本机是否已装 Hermes Agent、启用插件、并自动跑一遍 hermes phoenix-status 让你看到安装结果。已安装旧版本会自动备份，不会覆盖丢失。插件复制到的位置是 Hermes 的 Home 目录（macOS/Linux 默认 ~/.hermes/plugins/phoenix_v7/，Windows 默认 %LOCALAPPDATA%\hermes\plugins\phoenix_v7\，设了 HERMES_HOME 环境变量的话以那个为准，可以用 hermes config path 查看当前实际路径）。
卸载
删除插件目录即可（路径同上），不影响 Hermes 本体，也不会残留任何对 Hermes 核心文件的修改。如果想连同不死鸟的历史数据（抗体库、成本记录等）一起删，同一个 Home 目录下还有一个 phoenix_v7_state/ 目录也要删掉；只想清插件代码、保留这些数据的话，别删这个目录。
项目结构
phoenix/
├── phoenix_v7/ # 插件本体，会被复制到 Hermes Home 下的 plugins/ 目录
│ ├── router/ # 路由分档引擎
│ ├── guardrails/ # 熔断器/审批闸/成本记账
│ ├── selfheal/ # 抗体库
│ ├── loop/ # 长任务守护信号
│ ├── verify/ # 幻觉核验
│ ├── privacy/ # 隐私敏感词检测与本地模型切换提醒
│ ├── tests/ # 257 个自动化测试
│ ├── docs/ # 使用指南
│ └── plugin.yaml # 插件声明 + Hermes 版本兼容性字段
├── install.sh # macOS / Linux 安装脚本
├── install.ps1 # Windows 安装脚本
└── LICENSE
为什么值得信任
- 257 条自动化测试全程跟着功能走，每次改动都要求全绿才能合并
- 至少三次真实生产事故驱动了关键安全设计（详见完整技术文档）
- 两次重大重构都是先发现"自己重复造了 Hermes 已有的轮子"，再主动改用官方原生机制，不硬撑自建版本
- 发布前主动加了版本兼容性自检机制，不指望用户自己去猜"这个版本能不能用"
作者与支持
作者：小爷 · 懂商业的 AI 野生 UP 主 / Hermes Agent·不死鸟 AI 架构原创作者
扫码添加微信，交流 Hermes 与不死鸟的使用问题或合作交流。
许可证
本项目采用 CC BY-NC 4.0 许可证。
- 个人使用、学习、研究与非商业项目可以直接使用。
- 公开发布衍生作品时，请注明来源。
- 商业用途需要单独授权，请联系作者。