不死鸟 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 许可证。

个人使用、学习、研究与非商业项目可以直接使用。
公开发布衍生作品时，请注明来源。
商业用途需要单独授权，请联系作者。