斜线命令参考

Hermes 拥有两个斜线命令入口，均由 hermes_cli/commands.py 中的中央 COMMAND_REGISTRY 驱动：

• 交互式 CLI 斜线命令 — 由 cli.py 分发，并从注册表提供自动补全
• 消息平台斜线命令 — 由 gateway/run.py 分发，并从注册表生成帮助文本和平台菜单

已安装的技能（Skill）也会在两个入口上作为动态斜线命令暴露出来。这包括内置技能，如 /plan，它会打开计划模式并将 Markdown 计划保存到相对于活动工作区/后端工作目录的 .hermes/plans/ 下。

交互式 CLI 斜线命令

在 CLI 中输入 / 可打开自动补全菜单。内置命令不区分大小写。

会话

命令	描述
/new（别名：/reset）	开始新会话（新会话 ID + 历史记录）
/clear	清除屏幕并开始新会话
/history	显示对话历史
/save	保存当前对话
/retry	重试上一条消息（重新发送给 Agent）
/undo	移除最近一次用户/助手对话交换
/title	为当前会话设置标题（用法：/title 我的会话名称）
/compress [focus topic]	手动压缩对话上下文（刷新记忆 + 摘要）。可选的焦点主题可缩小摘要保留范围。
/rollback	列出或恢复文件系统检查点（用法：/rollback [number]）
/snapshot [create|restore <id>|prune]（别名：/snap）	创建或恢复 Hermes 配置/状态的快照。create [label] 保存快照，restore <id> 回滚到该快照，prune [N] 删除旧快照，不带参数则列出所有快照。
/stop	终止所有正在运行的后台进程
/queue <prompt>（别名：/q）	将提示词排队到下一轮（不打断当前 Agent 响应）。
/steer <prompt>	注入一条在下一次工具调用后到达 Agent 的中途提示——不打断，不产生新用户轮次。文本会在当前工具完成后追加到最后一次工具结果的内容中，在不打断当前工具调用循环的情况下为 Agent 提供新上下文。用于在任务执行中途调整方向（例如，在 Agent 运行测试时说"聚焦在认证模块"）。
/goal <text>	设置一个 Hermes 跨轮次持续追求的持久目标——这是我们对 Ralph 循环的实现。每轮结束后，辅助评判模型会判断目标是否完成；若未完成，Hermes 自动继续。子命令：/goal status、/goal pause、/goal resume、/goal clear。预算默认为 20 轮（goals.max_turns）；任何真实用户消息会抢占继续循环，状态在 /resume 后保留。详见持久目标。
/resume [name]	恢复之前命名的会话
/redraw	强制完整 UI 重绘（在 tmux 调整大小、鼠标选择残留等导致终端漂移后恢复）。
/status	显示会话信息
/agents（别名：/tasks）	显示当前会话中的活动 Agent 和正在运行的任务。
/background <prompt>（别名：/bg、/btw）	在独立的后台会话中运行提示词。Agent 独立处理你的提示词——当前会话保持可用。任务完成时，结果以面板形式呈现。参见 CLI 后台会话。
/branch [name]（别名：/fork）	分叉当前会话（探索不同路径）

配置

命令	描述
/config	显示当前配置
/model [model-name]	显示或更改当前模型。支持：/model claude-sonnet-4、/model provider:model（切换提供商）、/model custom:model（自定义端点）、/model custom:name:model（命名自定义提供商）、/model custom（自动检测端点），以及用户自定义别名（/model fav、/model grok——参见自定义模型别名）。使用 --global 将更改持久化到 config.yaml。注意： /model 只能在已配置的提供商之间切换。要添加新提供商，请退出会话并在终端运行 hermes model。
/personality	设置预定义人格
/verbose	循环切换工具进度显示：关闭 → 新 → 全部 → 详细。可通过配置为消息平台启用。
/fast [normal|fast|status]	切换快速模式——OpenAI 优先处理 / Anthropic 快速模式。选项：normal、fast、status。
/reasoning	管理推理努力程度和显示（用法：/reasoning [level|show|hide]）
/skin	显示或更改显示皮肤/主题
/statusbar（别名：/sb）	切换上下文/模型状态栏的显示和隐藏
/voice [on|off|tts|status]	切换 CLI 语音模式和语音播放。录音使用 voice.record_key（默认：Ctrl+B）。
/yolo	切换 YOLO 模式——跳过所有危险命令确认提示。
/codex-runtime [auto|codex_app_server|on|off]	切换可选的 Codex app-server 运行时。auto（默认）使用 Hermes 标准聊天补全；codex_app_server 将轮次交给 codex app-server 子进程，以使用原生 shell、apply_patch、ChatGPT 订阅认证和迁移的 Codex 插件。在下一次会话生效。
/footer [on|off|status]	切换最终回复上的网关运行时元数据页脚（显示模型、工具计数、耗时）。
/busy [queue|steer|interrupt|status]	仅 CLI：控制在 Hermes 工作时按 Enter 键的行为——排队新消息、中途引导或立即打断。
/indicator [kaomoji|emoji|unicode|ascii]	仅 CLI：选择 TUI 忙碌指示器风格。

工具与技能

命令	描述
/tools [list|disable|enable] [name...]	管理工具：列出可用工具，或禁用/启用当前会话的特定工具。禁用工具会将其从 Agent 工具集中移除并触发会话重置。
/toolsets	列出可用工具集
/browser [connect|disconnect|status]	管理本地 Chrome CDP 连接。connect 将浏览器工具附接到正在运行的 Chrome 实例（默认：ws://localhost:9222）。disconnect 解除附接。status 显示当前连接状态。如未检测到调试器，自动启动 Chrome。
/skills	从在线注册表搜索、安装、检查或管理技能
/cron	管理定时任务（列出、添加/创建、编辑、暂停、恢复、运行、删除）
/curator	后台技能维护——status、run、pin、archive。参见策展器。
/kanban <action>	无需离开聊天即可驱动多配置文件、多项目协作看板。完整的 hermes kanban 入口可用：/kanban list、/kanban show t_abc、/kanban create "title" --assignee X、/kanban comment t_abc "text"、/kanban unblock t_abc、/kanban dispatch 等。支持多看板：/kanban boards list、/kanban boards create <slug>、/kanban boards switch <slug>、/kanban --board <slug> <action>。参见看板斜线命令。
/reload-mcp（别名：/reload_mcp）	从 config.yaml 重新加载 MCP 服务器
/reload	将 .env 变量重新加载到正在运行的会话中（无需重启即可获取新 API Key）
/plugins	列出已安装的插件及其状态

信息

命令	描述
/help	显示帮助信息
/usage	显示 Token 用量、费用明细、会话时长，以及——在活动提供商支持时——从提供商 API 实时拉取剩余配额/积分/计划用量的账户限制部分。
/insights	显示用量洞察和分析（最近 30 天）
/platforms（别名：/gateway）	显示网关/消息平台状态
/paste	附加剪贴板图片
/copy [number]	将最后一条助手回复复制到剪贴板（或用数字指定倒数第 N 条）。仅 CLI。
/image <path>	附加本地图片文件用于下一个提示词。
/debug	上传调试报告（系统信息 + 日志）并获取可分享的链接。在消息平台中也可用。
/profile	显示活动配置文件名称和主目录
/gquota	显示 Google Gemini Code Assist 配额用量（带进度条，仅在 google-gemini-cli 提供商激活时可用）。

退出

命令	描述
/quit	退出 CLI（也可用：/exit）。

动态 CLI 斜线命令

命令	描述
/<skill-name>	将任何已安装的技能作为按需命令加载。示例：/gif-search、/github-pr-workflow、/excalidraw。
/skills ...	从注册表和官方可选技能目录中搜索、浏览、检查、安装、审计、发布和配置技能。

快捷命令

用户自定义快捷命令将短斜线命令映射到 Shell 命令或另一个斜线命令。在 ~/.hermes/config.yaml 中配置：

quick_commands:
  status:
    type: exec
    command: systemctl status hermes-agent
  deploy:
    type: exec
    command: scripts/deploy.sh
  inbox:
    type: alias
    target: /gmail unread

然后在 CLI 或消息平台中输入 /status、/deploy 或 /inbox。快捷命令在分发时解析，可能不会出现在所有内置自动补全/帮助表中。

不支持纯字符串提示词快捷方式作为快捷命令。将较长的可复用提示词放入技能中，或使用 type: alias 指向现有斜线命令。

自定义模型别名

为常用模型定义简短名称，然后在 CLI 或任何消息平台中使用 /model <alias> 调用。别名在两者中的工作方式相同，支持仅会话（默认）和 --global 切换。

支持两种配置格式：

完整格式 — 固定确切的模型、提供商，以及可选的基础 URL。在 ~/.hermes/config.yaml 中设置：

model_aliases:
  fav:
    model: claude-sonnet-4.6
    provider: anthropic
  grok:
    model: grok-4
    provider: x-ai
  ollama-qwen:
    model: qwen3-coder:30b
    provider: custom
    base_url: http://localhost:11434/v1

简短格式 — 一个字符串中包含 provider/model。可从 Shell 设置，无需编辑 YAML：

hermes config set model.aliases.fav anthropic/claude-opus-4.6
hermes config set model.aliases.grok x-ai/grok-4

然后在聊天中：

/model fav            # 仅限当前会话
/model grok --global  # 同时将当前模型更改持久化到 config.yaml

用户别名优先于内置短名称，因此将别名命名为 sonnet、kimi、opus 等会覆盖内置名称。别名名称不区分大小写。

别名解析

命令支持前缀匹配：输入 /h 解析为 /help，/mod 解析为 /model。当前缀有歧义（匹配多个命令）时，按注册表顺序选取第一个匹配项。完整命令名和注册别名始终优先于前缀匹配。

消息平台斜线命令

消息网关在 Telegram、Discord、Slack、WhatsApp、Signal、Email、Home Assistant 和 Teams 聊天中支持以下内置命令：

命令	描述
/new	开始新对话。
/reset	重置对话历史。
/status	显示会话信息。
/stop	终止所有正在运行的后台进程并中断 Agent。
/model [provider:model]	显示或更改模型。支持提供商切换（/model zai:glm-5）、自定义端点（/model custom:model）、命名自定义提供商（/model custom:local:qwen）、自动检测（/model custom）以及用户自定义别名（/model fav、/model grok——参见自定义模型别名）。使用 --global 将更改持久化到 config.yaml。注意： /model 只能在已配置的提供商之间切换。要添加新提供商或设置 API Key，请在终端（聊天会话外）运行 hermes model。
/codex-runtime [auto|codex_app_server|on|off]	切换可选的 Codex app-server 运行时。持久化到 config.yaml 中的 model.openai_runtime，并驱逐缓存的 agent，以便下一条消息使用新的运行时。在下一次会话生效。
/personality [name]	为会话设置人格叠加。
/fast [normal|fast|status]	切换快速模式——OpenAI 优先处理 / Anthropic 快速模式。
/retry	重试上一条消息。
/undo	移除最近一次对话交换。
/sethome（别名：/set-home）	将当前聊天标记为消息投递的平台主频道。
/compress [focus topic]	手动压缩对话上下文。可选的焦点主题可缩小摘要保留范围。
/topic [off|help|session-id]	仅限 Telegram 私信。 管理用户控制的多会话话题模式。/topic 启用或显示状态；/topic off 禁用并清除绑定；/topic help 显示用法；话题内的 /topic <session-id> 恢复之前的会话。参见多会话私信模式。
/title [name]	设置或显示会话标题。
/resume [name]	恢复之前命名的会话。
/usage	显示 Token 用量、估算费用明细（输入/输出）、上下文窗口状态、会话时长，以及——在活动提供商支持时——从提供商 API 实时拉取剩余配额/积分的账户限制部分。
/insights [days]	显示用量分析。
/reasoning [level|show|hide]	更改推理努力程度或切换推理显示。
/voice [on|off|tts|join|channel|leave|status]	控制聊天中的语音回复。join/channel/leave 管理 Discord 语音频道模式。
/rollback [number]	列出或恢复文件系统检查点。
/background <prompt>	在独立的后台会话中运行提示词。任务完成时，结果投递回同一聊天。参见消息平台后台会话。
/queue <prompt>（别名：/q）	将提示词排队到下一轮，不打断当前轮次。
/steer <prompt>	在下一次工具调用后注入消息，不打断——模型在下一次迭代时读取，而非作为新轮次。
/goal <text>	设置一个 Hermes 跨轮次持续追求的持久目标——这是我们对 Ralph 循环的实现。评判模型在每轮后检查；若未完成，Hermes 自动继续，直到目标达成、你暂停/清除，或达到轮次预算（默认 20）。子命令：/goal status、/goal pause、/goal resume、/goal clear。Agent 运行期间可安全执行状态/暂停/清除；设置新目标需要先 /stop。参见持久目标。
/footer [on|off|status]	切换最终回复上的运行时元数据页脚（显示模型、工具计数、耗时）。
/curator [status|run|pin|archive]	后台技能维护控制。
/kanban <action>	从聊天中驱动多配置文件、多项目协作看板——与 CLI 相同的参数入口。绕过运行 Agent 保护，因此 /kanban unblock t_abc、/kanban comment t_abc "…"、/kanban list --mine、/kanban boards switch <slug> 等可在 Agent 运行中使用。/kanban create … 会自动将发起聊天订阅到新任务的终端事件。参见看板斜线命令。
/reload-mcp（别名：/reload_mcp）	从配置重新加载 MCP 服务器。
/yolo	切换 YOLO 模式——跳过所有危险命令确认提示。
/commands [page]	浏览所有命令和技能（分页）。
/approve [session|always]	批准并执行待处理的危险命令。session 仅在本次会话批准；always 添加到永久白名单。
/deny	拒绝待处理的危险命令。
/update	将 Hermes Agent 更新到最新版本。
/restart	在清空活跃运行后优雅重启网关。网关重新上线时，会向请求者的聊天/线程发送确认。
/debug	上传调试报告（系统信息 + 日志）并获取可分享的链接。
/help	显示消息平台帮助。
/<skill-name>	通过名称调用任何已安装的技能。

注意事项

• /skin、/snapshot、/gquota、/reload、/tools、/toolsets、/browser、/config、/cron、/skills、/platforms、/paste、/image、/statusbar、/plugins、/busy、/indicator、/redraw、/clear、/history、/save、/copy 和 /quit 是仅 CLI 命令。
• /verbose 默认仅限 CLI，但可通过在 config.yaml 中设置 display.tool_progress_command: true 为消息平台启用。启用后，它会循环切换 display.tool_progress 模式并保存到配置。
• /sethome、/update、/restart、/approve、/deny、/topic 和 /commands 是仅消息平台命令。
• /status、/background、/queue、/steer、/voice、/reload-mcp、/rollback、/debug、/fast、/footer、/curator、/kanban 和 /yolo 在 CLI 和消息网关中均可使用。
• /voice join、/voice channel 和 /voice leave 仅在 Discord 上有意义。