Last updated on

Hermes v0.18 命令全景图：82 条命令怎么用？12 个场景一次说透

如果你第一次接触 Hermes Agent，很可能会被大量的 slash 命令搞晕：/new、/model、/compress、/background、/rollback……到底哪些是日常必备，哪些是特殊场景才用得上？

好消息是，Hermes v0.18 将这些命令组织得层次分明。在源码 hermes_cli/commands.py 的中央注册表（COMMAND_REGISTRY）中，目前注册了 82 条 slash 命令，加上 hermes_cli/subcommands/ 中的 38 个 CLI 子命令，总数超过 120 条。

本文不列流水账，而是把它们分成 12 个实战场景，让你看完就能直接从 “会用 /help” 进阶到 “命令在手，心里不慌”。

一、背景：Hermes 命令体系架构

命令分为两个维度：

  1. Slash 命令（/command）—— 在对话会话中输入，影响 agent 的当前状态。
  2. CLI 子命令（hermes <command>）—— 在终端直接执行，管理配置、安装、部署。

Slash 命令的中央注册表在 hermes_cli/commands.py，每个 CommandDef 包含名称、描述、分类、别名、参数提示等信息。而 CLI 子命令则分散在 hermes_cli/subcommands/ 目录中，由 hermes --help 统一展示。

两者的关系是：

  • Slash 命令管“聊天时怎么用”——改模型、压缩上下文、查看状态。
  • CLI 子命令管“系统怎么搭”——装工具、配网关、调 Cron。

场景 1：日常会话管理 —— 你和 agent 的对话基本功

这是使用频率最高的场景。你需要知道怎么开始、怎么撤回、怎么继续。

/new [name]（别名 /reset）

启动新会话。不传参数时立即清空历史；传 name 会给新会话起标题。

> /new
已清理上下文。你可以开始新一轮对话了。
> /new 邮服集成调研
以标题 "邮服集成调研" 开始新会话。

/retry

重新发送上一条消息给 agent。在 agent 回答不符合预期时直接重试。

> 帮我写一个 Docker Compose
（...回答不通...）
> /retry
（重新发送上一条，agent 开始重新回答）

/undo [N]

撤回 N 轮对话。默认撤回 1 轮，传 3 就撤回 3 轮。

> /undo 3
已撤回最近的 3 条消息

/title [name]

给当前会话命名。如果不传参数，会显示当前标题。如果 AGENT 自动起了名，你可以随时覆盖。

> /title 后端API性能优化
当前会话标题已更新为 "后端API性能优化"

/clear（CLI only）

清屏并创建新会话。相当于终端的 reset 快捷键。

> /clear
（清空终端内容，开始新会话）

/history（CLI only）

查看当前会话的完整对话记录。

/save（CLI only）

把当前会话保存到本地文件。常用于导出日志或分享记录。

场景 2：会话搜索与恢复 —— 换台机器继续聊

Hermes 的所有会话都持久化在 SQLite 数据库中，支持跨会话全文搜索和恢复。

/sessions

浏览所有历史会话，按时间倒序排列。

> /sessions
当前共 47 个会话：
1. 后端API性能优化  (7月19日)
2. 邮服集成调研     (7月18日)
3. Hermes 部署      (7月17日)
...

/resume <id | name>

恢复指定会话的上下文。支持按 ID（/resume 3）或按标题搜索（/resume 后端）。

> /resume 3
已恢复会话 "Hermes 部署"，上下文已被加载

/restart

重新启动当前会话（保持会话 ID，清空上下文）。

> /restart
（当前会话重启，历史仍在 SQLite 中保留）

背后的技术

Hermes 会话系统使用 ~/.hermes/state.db（SQLite + FTS5 全文索引），记录了：会话 ID、平台来源、模型配置、系统提示快照、完整消息历史（角色+内容+工具调用+工具结果）、Token 计数和时间戳。

场景 3：模型切换与控制 —— 一键切换 LLM 提供商

/model [name] [--provider <p>] [--session | --global]

最强大的命令之一。支持：

  • /model —— 交互式选择器（终端中显示列表）
  • /model gpt-4o —— 切换到指定模型
  • /model --provider deepseek —— 切换到指定提供商
  • /model --session —— 仅本次会话生效
  • /model --global —— 永久切换
> /model anthropic/claude-sonnet-4
模型已切换至 anthropic/claude-sonnet-4（已持久化）
> /model --session qwen-max
本次会话使用 qwen-max，下次启动恢复默认模型

/fast

切换快速模式。在 OpenAI 上开启 Priority Processing，在 Anthropic 上开启 Normal/Fast 模式。

> /fast
已开启快速模式（Fast Mode）

/yolo

切换 YOLO 模式。开启后 Hermes 会自动跳过所有危险命令审批。

> /yolo
YOLO 模式已开启！（慎用）

/reasoning

控制模型推理深度（对支持 reasoning 的模型如 o1、o3 有效）。

/codex-runtime

切换 Codex 运行环境。在本地终端和远程 Codex 环境之间切换。

场景 4：上下文压缩与优化 —— 不滚窗口也能继续聊

长对话耗 Token 又耗注意力，Hermes 提供了多级压缩方案。

/compress [here [N] | focus <topic> | --preview]（别名 /compact）

核心的上下文压缩命令。三种模式：

# 1. 默认压缩：保持最近 10 轮对话，其余压缩成摘要
> /compress

# 2. 保留最近 N 轮
> /compress here 15

# 3. 聚焦某个主题
> /compress focus 后端性能

# 4. 预览压缩效果（不执行）
> /compress --preview

/status

一站式查看当前会话的核心状态：使用的模型、已消耗 Token、上下文大小。

> /status
模型: anthropic/claude-sonnet-4
Token: 12,847 input / 3,291 output
上下文: 76% (13K / 17K)
会话: 后端API性能优化 (ID: abc-123)
状态: 非 YOLO

/usage（需配置 Nous Portal）

查看账户使用量和配额。

/insights

分析对话模式的统计信息（Token 趋势、回合数等）。

场景 5：安全检查与回滚 —— 再也不用怕 agent 乱改文件

这个是 Hermes 在 AI agent 领域的一大差异化优势：自动的快照回滚系统。

/rollback [number]

恢复文件系统到某个检查点。Hermes 在每次执行 write_file、patch、rm、mv 等破坏性操作前自动创建检查点（通过 ~/.hermes/checkpoints/store/ 的 shadow git 仓库）。

> /rollback
最近检查点：
1. 5 分钟前 — write_file: Dockerfile
2. 12 分钟前 — patch: app/main.py
3. 30 分钟前 — rm: temp.sqlite
> /rollback 1
已恢复到检查点 #1（Dockerfile 已还原）

/snapshot [create | restore <id> | prune]（别名 /snap）

管理 Hermes 配置和状态的全局快照。不同于 /rollback（文件级），/snapshot 快照的是 Hermes 自己的配置和状态。

> /snapshot create
已创建配置快照 #4
> /snapshot restore 2
已恢复配置到快照 #2

/stop

立即中断正在运行的 agent（后台进程、代码执行、LLM 调用）。

> /stop
（正在运行的 agent 被中断）

场景 6：后台任务与多 agent 协作 —— 一边聊天一边干活

Hermes 支持在后台运行推理，你可以继续聊天而不被打断。

/background <prompt>（别名 /bg）

在后台执行一个提示。输出不会打断当前对话。

> /background 继续分析昨天的 Nginx 日志，输出异常 IP 列表
后台任务已启动 (#42)
（你继续聊天...）
（几分钟后系统消息：任务 #42 完成：发现 3 个异常 IP）

/queue <prompt>

排队一个提示，下次轮到时自动执行。

> /queue 帮我总结这个网页：https://example.com
已排队。将在下一轮执行。

/agents

管理所有运行中的 agent 进程。查看状态、停止特定 agent。

> /agents
后台 Agent：
  #42 bg-log-analysis — 运行中（3 分钟）
  #48 queue-web-summary — 排队中

/moa <prompt>

MoA（Mixture of Agents）模式：通过默认模型路由一次提示到多个 agent 进行协作处理。

/subgoal <prompt>

提交子目标——让 agent 聚焦于完成一个特定小任务。

/steer <instruction> / /goal <instruction> / /journey

  • /steer：给 agent 一个阶段性指引，不改变整体任务。
  • /goal：设置或重设当前会话的顶层目标。
  • /journey：查看当前目标的进展轨迹。

场景 7：技能学习与管理 —— 让 agent 记住你的习惯

/learn [what]

从任何资源中创建可复用技能——支持目录、URL、聊天内容、笔记。

> /learn 我之前写的 Python 项目结构规范
正在为你创建技能 "python-project-layout"...
技能已创建。你可以通过 /python-project-layout 随时调用。

/skills [search | install | list | info <name>]（CLI + slash）

管理和发现技能。

> /skills search web search
找到 5 个相关技能：
  web-search-free    — 免费网页搜索（无 API key）
  blogwatcher       — 监控技术博客内容变化
  research-workbench — 端到端研究辅助

/bundles

查看技能包（bundle）。技能包是一组技能的集合，通过一个斜杠命令就能同时加载多个技能。

> /bundles
可用技能包：
  coding-default — Python + Git + 代码审查（3 个技能）
  research-all   — 论文搜索 + 博客监控 + 资料整理（4 个技能）

/curator [status | run | pin | archive]

管理后台 curator 的自动技能维护。

> /curator status
Curator 状态：运行中
上次维护：2 小时前
新发现：2 个可用的社区技能

/suggestions

浏览和接受/拒绝 curator 推荐的自动化建议。

/blueprint

管理技能蓝图（预定义的技能模板）。

场景 8：配置与个性化 —— 打造你自己的 Hermes

/config <key> [value]（CLI only）

查看和修改配置。支持 yaml 点路径。

> /config web.backend
当前值: ddgs
> /config web.backend searxng
已更新 web.backend = searxng

/profile / /sethome

  • /profile：查看当前生效的 profile 名称和路径
  • /sethome <path>（Gateway only）：重新设置 Hermes home 目录

/personality [name]

切换人格包。Hermes 支持多种预置人格（如：专业、幽默、简洁）。

/skin [name]（CLI only）

切换 CLI 主题皮肤。

/indicator [on|off]（CLI only）

控制输入提示符的动画指示器。

/statusbar [on|off] / /timestamps [on|off] / /verbose [on|off] / /footer [on|off]（CLI only）

控制 CLI 界面的显示元素。

/voice [on|off]

开关语音交互模式。

/pet [list | <slug>]

养一只宠物助手——Hermes 的 petdex 功能。

> /pet list
可领养的宠物：cat, fox, dragon, owl, robot
> /pet cat
🐱 猫已激活！它会偶尔在对话中陪伴你

场景 9：工具与插件管理 —— 给 agent 装装备

/tools（CLI only）

交互式工具配置向导。勾选需要启用的工具集。

> /tools
┌─ 工具配置 ──────────────────────┐
│ [✓] Web Search & Scraping       │
│ [ ] File System Operations      │
│ [✓] Code Execution              │
│ [ ] Image Generation            │
│ [ ] Computer Use                │
└─────────────────────────────────┘

/toolsets（CLI only）

细粒度控制每个 session 加载哪些工具集。

/plugins [list | enable <name> | disable <name>]

管理 Hermes 插件系统。

> /plugins list
已安装插件：
  web/ddgs       — 启用
  web/searxng    — 禁用
  voice/edge     — 启用

/memory [search <query> | show <id>]

搜索和查看 Hermes 持久化记忆。

/browser [list | close | inspect]

管理浏览器会话：查看打开的页面、关闭标签页、检查页面元素。

/kanban

多 profile 协作看板——管理任务、链接、评论。

> /kanban
当前看板：开发冲刺 S12
☐ 完成 API 文档   (紧急)
☐ Code Review PR #42
☑ 部署 v0.18 RC1

场景 10：平台与多通道 —— 一个 Hermes 接管所有聊天

/handoff <platform>（CLI only）

将会话转接到另一个平台。比如你在 CLI 中聊天，想转到 Telegram 继续。

> /handoff telegram
会话已转接到 Telegram！（你的 Telegram 上会收到一条消息）

/platform [<platform>] / /platforms

查看或切换到正在使用的网关平台。

/topic [off | help | <session-id>]（Gateway only）

控制 Telegram DM 主题会话模式。

/whoami

查看你在当前平台上的命令访问权限（admin / user）。

场景 11：系统维护与调试 —— 日常运维

/update

更新 Hermes Agent 到最新版本。

/version（别名 /v）

查看当前版本号。

/debug

生成和上传调试报告（包含系统信息和日志）。

/reload / /reload-mcp / /reload-skills

重新加载配置、MCP 服务器或技能，无需重启 Hermes。

/cron（CLI only）

管理定时任务。

> /cron list
活跃定时任务：
  daily-briefing — 每天 08:00
  hourly-check   — 每小时

/quit [--delete]

退出 CLI。用 --delete 同时删除当前会话历史。

场景 12：CLI 子命令 —— 从安装到部署的完整工具箱

除了 slash 命令，Hermes 还有 38 个 CLI 子命令（hermes <command>），覆盖安装、配置、网关、调试等场景：

命令 用途 命令 用途
hermes setup 首次安装初始化 hermes tools 交互式工具配置
hermes install 安装/更新 hermes uninstall 卸载
hermes config 配置管理 hermes doctor 环境诊断
hermes gateway 网关管理 hermes skills 技能管理
hermes plugins 插件管理 hermes cron 定时任务
hermes memory 记忆管理 hermes model 模型切换
hermes update 版本更新 hermes version 版本查看
hermes status 运行状态 hermes logs 查看日志
hermes debug 调试报告 hermes dump 配置导出
hermes dashboard 网页仪表板 hermes gui 桌面 GUI
hermes login 登录 Nous Portal hermes logout 退出登录
hermes auth 认证管理 hermes pairing 配对设备
hermes backup 备份 hermes hooks Git 钩子
hermes security 安全检查 hermes webhook Webhook 管理
hermes profile Profile 管理 hermes prompt_size 提示大小估算

快速参考表：按场景速查

场景 核心命令 推荐指数
会话管理 /new, /retry, /undo, /title, /clear ⭐⭐⭐⭐⭐
搜索恢复 /sessions, /resume, /restart ⭐⭐⭐⭐⭐
模型切换 /model, /fast, /yolo, /reasoning ⭐⭐⭐⭐⭐
上下文压缩 /compress, /status, /usage ⭐⭐⭐⭐
安全回滚 /rollback, /snapshot, /stop ⭐⭐⭐⭐
后台任务 /background, /queue, /agents, /moa ⭐⭐⭐⭐
技能管理 /learn, /skills, /bundles, /curator ⭐⭐⭐⭐
配置个性化 /config, /profile, /voice, /pet ⭐⭐⭐
工具插件 /tools, /plugins, /memory ⭐⭐⭐
平台切换 /handoff, /platform, /topic ⭐⭐⭐
系统维护 /update, /version, /debug, /reload ⭐⭐⭐
CLI 子命令 hermes setup, hermes config, … ⭐⭐⭐⭐⭐

进阶技巧

1. 组合命令

你可以用 /config + /model 快速切换工作模式：

> /config web.backend ddgs
> /model gpt-4o
> /yolo
（进入快速搜索模式）

2. 使用别名

很多命令都有短别名：

  • /new = /reset
  • /compress = /compact
  • /snapshot = /snap
  • /background = /bg
  • /version = /v
  • /branch = /fork

3. 安全第一

如果不确定 agent 要执行的操作，先把 /yolo 关掉。/rollback 只在开启 checkpoints 时才有效。

4. 善用 /compress focus

当对话偏离主题时，不用开新会话，用 /compress focus <topic> 把注意力拉回来。

5. 定期归档技能

用 /curator 定期清理不再使用的技能，保持技能仓库整洁。

结语

82 条 slash 命令 + 38 个 CLI 子命令看起来很多，但核心模式只有 12 个场景。大部分场景你只需记住 2-3 个核心命令就能覆盖 80% 的需求。

实际上，日常最常用的只有 7 条：/new、/retry、/undo、/model、/status、/compress、/sessions。记住这 7 条，你已经能从新手变成老手了。

记住：不是所有命令你都需要。你需要的那几条，现在你已经知道了。