> 原文链接:Slash Commands Reference
斜杠命令参考
> 📖 本文档翻译自 Hermes Agent 官方文档 > 最后更新:2026-04-16
Hermes 有两个斜杠命令(Slash Command)界面,均由 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 | 重试上一条消息(重新发送给代理) |
/undo | 移除最后一轮用户/助手的交互 |
/title | 为当前会话设置标题(用法:/title My Session Name) |
/compress [focus topic] | 手动压缩对话上下文(刷新记忆 + 摘要)。可选的焦点主题用于缩小摘要保留的范围。 |
/rollback | 列出或恢复文件系统检查点(用法:/rollback [number]) |
/snapshot [create|restore <id>|prune](别名:/snap) | 创建或恢复 Hermes 配置/状态的状态快照。create [label] 保存快照,restore <id> 恢复到指定快照,prune [N] 删除旧快照,不带参数则列出所有快照。 |
/stop | 终止所有正在运行的后台进程 |
/queue <prompt>(别名:/q) | 将提示词排队到下一轮(不会中断当前代理响应)。注意: /q 同时被 /queue 和 /quit 注册;最后注册的优先,因此实际上 /q 会解析为 /quit。请显式使用 /queue。 |
/resume [name] | 恢复之前命名的会话 |
/status | 显示会话信息 |
/snapshot(别名:/snap) | 创建或恢复 Hermes 配置/状态的状态快照(用法:/snapshot [create|restore <id>|prune]) |
/background <prompt>(别名:/bg) | 在单独的后台会话中运行提示词。代理会独立处理你的提示词——当前会话保持空闲,可以继续其他工作。任务完成后结果会以面板形式显示。参见 CLI 后台会话。 |
/btw <question> | 使用会话上下文的临时旁问(不使用工具,不持久化)。适合快速澄清问题而不影响对话历史。 |
/plan [request] | 加载内置的 plan 技能,编写 Markdown 计划而非执行工作。计划保存在当前工作区/后端工作目录下的 .hermes/plans/ 中。 |
/branch [name](别名:/fork) | 分支当前会话(探索不同路径) |
配置
| 命令 | 说明 |
|---|---|
/config | 显示当前配置 |
/model [model-name] | 显示或切换当前模型。支持:/model claude-sonnet-4、/model provider:model(切换提供商)、/model custom:model(自定义端点)、/model custom:name:model(命名的自定义提供商)、/model custom(从端点自动检测)。使用 --global 可将更改持久化到 config.yaml。注意: /model 只能在已配置的提供商之间切换。要添加新的提供商,请退出会话并在终端中运行 hermes model。 |
/provider | 显示可用的提供商和当前提供商 |
/personality | 设置预定义的个性 |
/verbose | 循环切换工具进度显示模式:off → new → all → verbose。可通过配置为消息平台启用。 |
/fast | 切换快速模式 — OpenAI 优先处理 / Anthropic 快速模式(用法:/fast [normal|fast|status]) |
/reasoning | 管理推理努力程度和显示(用法:/reasoning [level|show|hide]) |
/fast [normal|fast|status] | 切换快速模式 — OpenAI 优先处理 / Anthropic 快速模式。选项:normal、fast、status、on、off。 |
/skin | 显示或切换显示皮肤/主题 |
/statusbar(别名:/sb) | 开启或关闭上下文/模型状态栏 |
/voice [on|off|tts|status] | 切换 CLI 语音模式和语音播放。录制使用 voice.record_key(默认:Ctrl+B)。 |
/yolo | 切换 YOLO 模式 — 跳过所有危险命令的审批提示。 |
工具与技能
| 命令 | 说明 |
|---|---|
/tools [list|disable|enable] [name...] | 管理工具:列出可用工具,或禁用/启用当前会话中的特定工具。禁用工具会将其从代理的工具集中移除并触发会话重置。 |
/toolsets | 列出可用的工具集 |
/browser [connect|disconnect|status] | 管理本地 Chrome CDP 连接。connect 连接到正在运行的 Chrome 实例(默认:ws://localhost:9222)。disconnect 断开连接。status 显示当前连接状态。如果未检测到调试器,会自动启动 Chrome。 |
/skills | 从在线注册表搜索、安装、检查或管理技能 |
/cron | 管理定时任务(列出、添加/创建、编辑、暂停、恢复、运行、删除) |
/reload-mcp(别名:/reload_mcp) | 从 config.yaml 重新加载 MCP 服务器 |
/reload | 将 .env 变量重新加载到当前会话中(无需重启即可识别新的 API 密钥) |
/plugins | 列出已安装的插件及其状态 |
信息
| 命令 | 说明 |
|---|---|
/help | 显示帮助信息 |
/usage | 显示令牌使用量、费用明细和会话时长 |
/insights | 显示使用洞察和分析数据(最近 30 天) |
/platforms(别名:/gateway) | 显示网关/消息平台状态 |
/paste | 检查剪贴板中的图片并附加 |
/image <path> | 附加本地图片文件用于下一次提示。 |
/debug | 上传调试报告(系统信息 + 日志)并获取可分享链接。在消息平台中也可用。 |
/profile | 显示当前活跃的配置文件名称和主目录 |
退出
| 命令 | 说明 |
|---|---|
/quit | 退出 CLI(也可用 /exit)。参见上方 /queue 中关于 /q 的说明。 |
动态 CLI 斜杠命令
| 命令 | 说明 |
|---|---|
/<skill-name> | 将任何已安装的技能作为按需命令加载。例如:/gif-search、/github-pr-workflow、/excalidraw。 |
/skills ... | 从注册表和官方可选技能目录中搜索、浏览、检查、安装、审计、发布和配置技能。 |
快捷命令
用户自定义的快捷命令(Quick Command)将短别名映射到较长的提示词。在 ~/.hermes/config.yaml 中配置:
quick_commands:
review: "Review my latest git diff and suggest improvements" # 审查最新的 git diff 并建议改进
deploy: "Run the deployment script at scripts/deploy.sh and verify the output" # 运行 scripts/deploy.sh 部署脚本并验证输出
morning: "Check my calendar, unread emails, and summarize today's priorities" # 检查日历、未读邮件,总结今日优先事项
然后在 CLI 中输入 /review、/deploy 或 /morning。快捷命令在分发时解析,不会显示在内置的自动补全/帮助表中。
别名解析
命令支持前缀匹配:输入 /h 会解析为 /help,输入 /mod 会解析为 /model。当前缀有歧义(匹配到多个命令)时,注册表中排序靠前的优先。完整命令名和已注册的别名始终优先于前缀匹配。
消息平台斜杠命令
消息网关(Messaging Gateway)支持在 Telegram、Discord、Slack、WhatsApp、Signal、Email 和 Home Assistant 聊天中使用以下内置命令:
| 命令 | 说明 |
|---|---|
/new | 开始新对话。 |
/reset | 重置对话历史。 |
/status | 显示会话信息。 |
/stop | 终止所有正在运行的后台进程并中断当前代理。 |
/model [provider:model] | 显示或切换模型。支持切换提供商(/model zai:glm-5)、自定义端点(/model custom:model)、命名的自定义提供商(/model custom:local:qwen)以及自动检测(/model custom)。使用 --global 可将更改持久化到 config.yaml。注意: /model 只能在已配置的提供商之间切换。要添加新提供商或设置 API 密钥,请在终端中运行 hermes model(在聊天会话之外)。 |
/provider | 显示提供商可用性和认证状态。 |
/personality [name] | 为当前会话设置个性叠加层。 |
/fast [normal|fast|status] | 切换快速模式 — OpenAI 优先处理 / Anthropic 快速模式。 |
/retry | 重试上一条消息。 |
/undo | 移除最后一轮交互。 |
/sethome(别名:/set-home) | 将当前聊天标记为平台主频道,用于消息投递。 |
/compress [focus topic] | 手动压缩对话上下文。可选的焦点主题用于缩小摘要保留的范围。 |
/title [name] | 设置或显示会话标题。 |
/resume [name] | 恢复之前命名的会话。 |
/usage | 显示令牌使用量、预估费用明细(输入/输出)、上下文窗口状态和会话时长。 |
/insights [days] | 显示使用分析数据。 |
/reasoning [level|show|hide] | 更改推理努力程度或切换推理显示。 |
/voice [on|off|tts|join|channel|leave|status] | 控制聊天中的语音回复。join/channel/leave 管理 Discord 语音频道模式。 |
/rollback [number] | 列出或恢复文件系统检查点。 |
/snapshot [create|restore <id>|prune](别名:/snap) | 创建或恢复 Hermes 配置/状态的状态快照。 |
/background <prompt> | 在单独的后台会话中运行提示词。任务完成后结果会发送回同一聊天。参见消息平台后台会话。 |
/plan [request] | 加载内置的 plan 技能,编写 Markdown 计划而非执行工作。计划保存在当前工作区/后端工作目录下的 .hermes/plans/ 中。 |
/reload-mcp(别名:/reload_mcp) | 从配置中重新加载 MCP 服务器。 |
/reload | 将 .env 变量重新加载到当前会话中。 |
/yolo | 切换 YOLO 模式 — 跳过所有危险命令的审批提示。 |
/commands [page] | 浏览所有命令和技能(分页显示)。 |
/approve [session|always] | 批准并执行待处理的危险命令。session 仅在本次会话中批准;always 添加到永久允许列表。 |
/deny | 拒绝待处理的危险命令。 |
/update | 将 Hermes Agent 更新到最新版本。 |
/restart | 优雅地重启网关,等待活跃任务完成。网关重新上线后,会向请求者的聊天/线程发送确认消息。 |
/fast [normal|fast|status] | 切换快速模式 — OpenAI 优先处理 / Anthropic 快速模式。 |
/debug | 上传调试报告(系统信息 + 日志)并获取可分享链接。 |
/debug | 上传调试报告(系统信息 + 日志)并获取可分享链接。 |
/help | 显示消息平台帮助。 |
/<skill-name> | 按名称调用任何已安装的技能。 |
备注
/skin、/tools、/toolsets、/browser、/config、/cron、/skills、/platforms、/paste、/image、/statusbar和/plugins是 仅限 CLI 的命令。/verbose默认仅限 CLI,但可以通过在config.yaml中设置display.tool_progress_command: true为消息平台启用。启用后,它会循环切换display.tool_progress模式并保存到配置。/sethome、/update、/restart、/approve、/deny和/commands是 仅限消息平台 的命令。/status、/background、/voice、/reload-mcp、/rollback、/snapshot、/debug、/fast和/yolo在 CLI 和消息网关中均可使用。/voice join、/voice channel和/voice leave仅在 Discord 上有意义。