🆕 11-v0.19.0 "Quicksilver" 更新指南LCP

一句话先说清楚：v0.19.0 是 Hermes Agent 迄今最大的一次版本升级——首 token 响应提速 80%、智能审批成为默认、密码管理器集成、Profile 多路复用、后台子代理持久化交付。如果你正在从 v0.18.x 升级，这一页帮你快速了解所有重要变化。

发布日期：2026-07-20
版本代号：Quicksilver
规模：~2,245 commits / ~1,065 PRs / ~3,300 issues

📋 升级前提

# 检查当前版本
hermes version

# 升级到 v0.19.0
hermes update

# 升级后检查配置迁移
hermes config check
hermes config migrate

⚠️ v0.19.0 包含行为变更（智能审批默认开启），升级后请先在低风险环境验证。

🚀 1. 性能：首 token 响应提速 80%

v0.19.0 重新实现了 Agent Loop 的初始化路径，首 token 时间从 4.3 秒降到 0.9 秒（中位数，基于官方 benchmark）。

对你意味着什么：

• 对话体感从"等一下"变成"秒回"
• Cron 任务和 Gateway 消息的响应延迟显著缩短
• 多 Agent 编排（Kanban / MoA）的并行启动更快

不需要你做什么：这是内部优化，升级后自动生效。

🤖 2. 智能审批成为默认（行为变更）

v0.18.x 及之前：标记为需要审批的命令（如 execute_command、file_write）每次执行都需要用户手动确认。

v0.19.0：引入 LLM 审查器（Approval LLM），自动评估命令安全性。安全的命令自动放行，仅高风险操作才弹审批。

配置方式：

# ~/.hermes/profiles/default/config.yaml
agent:
  approval:
    mode: smart          # smart（默认）| manual | off
    llm_provider: openai  # 用哪个 provider 做审查
    llm_model: gpt-4o-mini  # 审查模型（建议用快模型省钱）

回退到旧行为：如果你不信任自动审批，升级后把 mode 改成 manual 即可恢复 v0.18.x 的体验。

🔐 3. Bitwarden / 1Password 密码管理器集成

v0.19.0 新增 SecretSource 接口，API 密钥不再必须明文写在 .env 或 config.yaml 里。

支持的密码管理器：

配置示例：

# ~/.hermes/profiles/default/config.yaml
providers:
  openai:
    api_key:
      secret_source: bitwarden
      item: "Hermes OpenAI Key"
      field: "password"

对你意味着什么：

• API 密钥轮换不再需要改 Hermes 配置
• 团队共享 profile 时不会泄露密钥
• 符合企业安全合规要求

🧬 4. Profile 多路复用路由

v0.19.0 支持一个 Gateway（如 Telegram Bot token）或一个 Bot 入口路由到多个隔离的 profile。

配置示例：

# ~/.hermes/gateways/telegram.yaml
gateway: telegram
bot_token: "your-bot-token"
profile_routing:
  - match: "/analyst"
    profile: analyst
  - match: "/coder"
    profile: coder
  - default: true
    profile: default

对你意味着什么：

• 不用为每个角色部署单独的 Hermes 实例
• 一个 Telegram Bot 可以按命令前缀切换到不同 Agent 人格
• 不同 profile 的 memory、skills、tools 完全隔离

📤 5. 后台子代理 + 持久化交付账本

v0.19.0 的 delegate_task 工具新增 background: true 参数，子代理可以在后台异步执行任务。

核心机制：

• 后台子代理的执行状态写入持久化交付账本（Persistent Delivery Ledger）
• 如果 Hermes 崩溃或重启，未完成的子代理任务会在重启后自动恢复
• 子代理完成后，结果通过通知机制推送给主代理

使用示例：

# 在对话中委派后台任务
delegate_task(
    description="分析这个仓库的代码质量并生成报告",
    background=True,  # v0.19.0 新增
    notify_on_complete=True
)

对你意味着什么：

• 长时间运行的分析任务不再阻塞主对话
• 崩溃恢复后不会丢失子代理进度
• 适合 Kanban 多 Agent 编排场景

🧠 6. 新模型支持

v0.19.0 新增以下模型提供商：

配置方式：

# 添加新模型
hermes model add --provider openai --model gpt-5.6
hermes model add --provider xai --model grok-4.5
hermes model add --provider moonshot --model kimi-k3

# 或通过 setup 向导
hermes setup model

🎛 7. 推理强度 max / ultra

v0.19.0 将推理深度从"开关"升级为"旋钮"——支持 low / medium / high / max / ultra 五档。

配置方式：

# ~/.hermes/profiles/default/config.yaml
agent:
  reasoning_effort: high  # low | medium | high | max | ultra

在对话中临时切换：

/model gpt-5.6 --reasoning max

💾 8. 会话导出

v0.19.0 新增 hermes sessions export 命令，支持将历史会话导出为多种格式。

# 导出为 Markdown
hermes sessions export --format markdown --output ./session.md

# 导出为 HTML（带样式）
hermes sessions export --format html --output ./session.html

# 导出为 HuggingFace trace（用于训练数据）
hermes sessions export --format hf-trace --output ./trace.jsonl

# 导出最近 7 天所有会话
hermes sessions export --format markdown --since 7d --output ./recent/

对你意味着什么：

• 会话归档和审计更方便
• 可以把成功的工作流导出为训练数据
• HTML 导出适合分享给非技术用户查看

💳 9. 终端内订阅管理

v0.19.0 新增 /subscription 和 /topup 两个 slash 命令，在对话中直接管理 Nous Portal 订阅。

/subscription          # 查看当前订阅状态和用量
/topup 50             # 充值 50 credits

💡 这两个命令需要先通过 hermes setup --portal 完成 Nous Portal OAuth 授权。

🔑 10. hermes setup --portal：一键 OAuth 配置

v0.19.0 新增 --portal 参数，通过 Nous Portal 一次 OAuth 授权，自动完成：

1. 模型提供商授权（OpenAI / Anthropic / xAI 等）
2. GitHub 工具网关授权
3. Brave Search 工具网关授权
4. Firecrawl 工具网关授权
5. Computer Use 工具网关授权

# 一键配置
hermes setup --portal

# 浏览器会自动打开 Nous Portal 授权页面
# 授权完成后，所有 API key 和工具凭据自动写入配置

对你意味着什么：

• 第一次安装后不再需要逐个手动填 API key
• 团队部署时可以统一通过 Portal 管理凭据
• 凭据轮换在 Portal 侧完成，Hermes 自动同步

📦 11. 安装命令迁移

v0.19.0 将官方安装脚本从 GitHub raw URL 迁移到专用域名：

# 旧命令（已废弃，但仍可用）
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 新命令（推荐）
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows PowerShell：

# 新命令
iex (irm https://hermes-agent.nousresearch.com/install.ps1)

旧 URL 仍会工作（通过重定向），但建议尽快更新你的部署脚本和文档引用。

🔄 v0.17.0 补充功能

v0.19.0 同时包含了 v0.17.0 的全部功能（v0.18.x 部分回退的）：

🌐 12. 平台覆盖扩展

v0.19.0 将官方支持的消息平台扩展到 20+ 个。中文站当前已覆盖 ~15 个平台的详细接入文档，以下平台为官方新增支持，详细接入指南将逐步补充：

标记 🆕 的平台已获官方 v0.19.0 支持，可通过 hermes setup gateway 尝试配置。我们会在后续内容更新中补充详细的中文接入指南。

⚡ 升级检查清单

升级到 v0.19.0 后，建议按此清单检查：

• hermes version 确认版本号 ≥ 0.19.0
• hermes doctor 确认环境健康
• hermes config check 确认配置迁移完成
• 检查 agent.approval.mode——如果是新安装，默认是 smart
• 如果使用 API key 明文存储，考虑迁移到 Bitwarden / 1Password
• 如果有多个 profile 部署在同一台机器上，评估是否可以用多路复用合并
• 测试 hermes sessions export 是否正常工作
• 如果有 Cron 任务依赖子代理，测试 background: true 行为
• 更新部署脚本中的安装命令 URL

❓ 常见问题

v0.19.0 的智能审批安全吗？

智能审批使用独立的 LLM 审查器评估每个命令的安全性。审查器会分析命令内容、文件路径、网络请求等因素。对于不确定的命令，仍然会弹出人工审批。如果你在安全敏感环境使用，可以把 mode 设为 manual 恢复旧行为。

升级到 v0.19.0 后旧的配置还兼容吗？

兼容。v0.19.0 的配置迁移工具会自动处理大部分变更。升级后跑 hermes config migrate 即可。新增字段（如 approval.mode）有默认值，不需要手动添加。

Bitwarden / 1Password 集成需要额外安装什么吗？

需要安装对应密码管理器的 CLI 工具：

• Bitwarden: npm install -g @bitwarden/cli
• 1Password: 下载 1Password CLI

安装后先登录一次，Hermes 会通过 CLI 读取密钥。

Profile 多路复用和原来多实例部署有什么区别？

多路复用是一个 Hermes 进程内运行多个隔离 profile，共享 Agent Loop 但 memory / skills / tools 独立。多实例部署是多个独立进程，完全隔离但资源消耗更大。多路复用适合轻量场景（一个 Bot 多人格），多实例适合安全隔离要求高的场景。

➡️ 相关页面

• CLI 命令参考
• Slash Commands 参考
• Built-in Tools 参考
• 安装 / 更新 / 环境问题