Phoenix

不死鸟 Phoenix

[](phoenix_v7/plugin.yaml) [](phoenix_v7/tests) [](LICENSE)

装在 [Hermes Agent](https://github.com/NousResearch/hermes-agent) 上的插件。路由分档、风险防线、自愈系统，全程官方插件钩子接入，不改 Hermes 一行核心代码。

**支持：Hermes Agent。** 全程通过官方插件系统加载，卸载即恢复原状。

[解决什么问题](#不死鸟解决什么问题) · [快速开始](#快速开始) · [能力一览](#能力一览) · [视觉总览](#视觉总览) · [安装](#安装) · [项目结构](#项目结构)

不死鸟解决什么问题

Hermes Agent 本身是一个通用 Agent 框架，很多"用起来更安心"的能力要么官方还没做，要么需要自己配置。不死鸟把这些补上：

真实处境	你会得到
不知道一句话该配给哪个模型，贵模型处理"在吗"很浪费	四档加权计分自动判定，问题难度和模型成本自动对齐
AI 代理连续报错，越错越乱还在硬着头皮往下跑	三态熔断器，连续失败自动跳闸，冷却后自动试探恢复
同样的错误反复踩，AI 每次都从头试错	抗体库查表，错误模式记下来，同一个坑不踩两次
长任务没人盯着，AI 跳过规划直接动手，或者悄悄做了高危操作	/goal 激活期间清单强制 + 高危操作换模型复核
高危档位的回复到底有没有编造内容，肉眼看不出来	免费预检 + 付费交叉核验，仅在深度/真神档触发
主力模型欠费了，AI 直接罢工	配置 Hermes 原生兜底链自动切换，本地模型（仅 macOS，可选）或纯云端便宜/免费模型都能当兜底
聊到手机号/身份证/密码这类敏感信息，不确定要不要发去云端	命中敏感词后事后提醒，引导手动切到本地模型处理（仅 macOS）
装的这版插件到底跟你电脑上的 Hermes 版本合不合	运行时自动比对，明确告诉你"合不合"

快速开始

安装完成后，直接正常使用 Hermes：所有路由、防线都是自动生效的，不需要学新命令。

看当前状态：

hermes phoenix-status

一条命令看路由模式、熔断器状态、长任务状态、Hermes 版本兼容性、今日花费、抗体库统计。

**自动路由换模型默认关闭**（只判断问题难度档位，不切换模型），只用单一模型的用户完全不用管这一项。如果你给不同档位配置了不同模型，可以自己开关：

hermes phoenix-router on   # 开启：按档位自动切换模型
hermes phoenix-router off  # 关闭：只判断档位，不切换模型（默认状态）

桌面端没有终端，用对话里的斜杠命令一样能切：`/phoenix-router on|off|status`。

怎么给档位配模型（单模型/多模型分Key/中转站三种情况分别怎么填）见 [三场景配置指南](phoenix_v7/docs/三场景配置指南.md)。

想专心用固定模型干活、不想被深度/真神档的确认提示打断，用专注模式（CLI/桌面端通用）：

/phoenix-focus on   # 暂停确认提示（hardline永久高危命令不受影响）
/phoenix-focus off  # 恢复

同一次会话里连续弹了 3 次确认提示，第 3 次会自动带一句"要不要开专注模式"的建议，不会每次都提醒。

Hermes 升级后如果出问题，用 `/phoenix-upgrade-log` 看版本变化历史和自动归档的异常记录（升级瞬间会自动备份 `config.yaml`，路径也在这条命令的输出里）。