Skip to content

斜杠命令参考

Hermes 有两个斜杠命令界面,都由 hermes_cli/commands.py 中的中央 COMMAND_REGISTRY 驱动:

  • 交互式 CLI 斜杠命令 —— 由 cli.py 调度,带有来自注册表的自动完成
  • 消息斜杠命令 —— 由 gateway/run.py 调度,带有从注册表生成的帮助文本和平台菜单

已安装的技能也在两个界面上作为动态斜杠命令公开。这包括捆绑技能如 /plan,它打开计划模式并将 markdown 计划保存到活动工作区/后端工作目录下的 .hermes/plans/

交互式 CLI 斜杠命令

在 CLI 中键入 / 打开自动完成菜单。内置命令不区分大小写。

会话

命令描述
/new (别名: /reset)开始新会话(新会话 ID + 历史记录)
/clear清屏并开始新会话
/history显示对话历史
/save保存当前对话
/retry重试上一条消息(重新发送给智能体)
/undo删除最后用户/助手交换
/title为当前会话设置标题(用法:/title My Session Name)
/compress手动压缩对话上下文(刷新记忆 + 摘要)
/rollback列出或恢复文件系统检查点(用法:/rollback [number])
/stop终止所有正在运行的后台进程
/queue <prompt> (别名: /q)将提示排队到下一轮(不会中断当前智能体响应)。注意: /q/queue/quit 同时声明;最后注册者获胜,因此 /q 实际上解析为 /quit。显式使用 /queue
/resume [name]恢复之前命名的会话
/statusbar (别名: /sb)切换上下文/模型状态栏开或关
/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(从端点自动检测)
/provider显示可用提供商和当前提供商
/personality设置预定义个性
/verbose循环工具进度显示:off → new → all → verbose。可以通过配置为消息启用
/reasoning管理推理力度和显示(用法:/reasoning [level|show|hide])
/skin显示或更改显示皮肤/主题
/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检查剪贴板中的图像并附加它
/profile显示活动配置文件名称和主目录

退出

命令描述
/quit退出 CLI(也:/exit)。请参阅上面关于 /queue 下的 /q 的注释。

动态 CLI 斜杠命令

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

快速命令

用户定义的快速命令将短别名映射到更长的提示。在 ~/.hermes/config.yaml 中配置它们:

yaml
quick_commands:
  review: "Review my latest git diff and suggest improvements"
  deploy: "Run the deployment script at scripts/deploy.sh and verify the output"
  morning: "Check my calendar, unread emails, and summarize today's priorities"

然后在 CLI 中键入 /review, /deploy, 或 /morning。快速命令在调度时解析,不会显示在内置自动完成/帮助表中。

别名解析

命令支持前缀匹配:键入 /h 解析为 /help/mod 解析为 /model。当前缀有歧义(匹配多个命令)时,注册表顺序中的第一个匹配获胜。完整命令名称和注册的别名始终优先于前缀匹配。

消息斜杠命令

消息网关支持 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)。
/provider显示提供商可用性和认证状态。
/personality [name]为会话设置个性覆盖。
/retry重试上一条消息。
/undo删除最后一次交换。
/sethome (别名: /set-home)将当前聊天标记为投递的平台主频道。
/compress手动压缩对话上下文。
/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]列出或恢复文件系统检查点。
/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 更新到最新版本。
/help显示消息帮助。
/<skill-name>按名称调用任何已安装的技能。

注释

  • /skin, /tools, /toolsets, /browser, /config, /cron, /skills, /platforms, /paste, /statusbar, 和 /plugins仅限 CLI 的命令。
  • /verbose 默认仅限 CLI,但可以通过在 config.yaml 中设置 display.tool_progress_command: true 为消息平台启用。启用后,它循环 display.tool_progress 模式并保存到配置。
  • /status, /sethome, /update, /approve, /deny, 和 /commands仅限消息的命令。
  • /background, /voice, /reload-mcp, /rollback, 和 /yolo 在 CLI 和消息网关中有效。
  • /voice join, /voice channel, 和 /voice leave 仅在 Discord 上有意义。