11.15 斜杠命令

斜杠命令是独立的 /... 消息,在模型处理之前会被剥离的指令。

概述

斜杠命令系统允许用户通过简短的命令快速控制代理行为和设置,而无需这些指令被发送到模型。

核心概念

• 斜杠命令以 / 开头
• 在发送给模型前被剥离
• 用于控制会话级别的设置
• 某些命令需要特定配置才能启用

常用命令

思考级别

# 设置思考级别
/think off|minimal|low|medium|high|xhigh
/t medium  # 简写形式
/thinking high

# 查看当前思考级别
/think
/think:

提权模式

# 启用提权模式
/elevated on|ask|full|off
/elev on  # 简写形式

# 查看当前提权状态
/elevated

执行配置

# 配置exec行为
/exec host=gateway security=full
/exec host=sandbox security=allowlist

# 需要工具启用:tools.elevated
/bash
/config

详细输出

# 控制输出详细程度
/v on|off|full
/verbose on

推理模式

# 控制推理输出
/reasoning on|off|stream

命令类别

会话控制

• /stop: 停止当前任务
• /reset: 重置会话上下文
• /clear: 清除会话历史

工具控制

• /bash: 启用bash工具(需要 tools.elevated 白名单)
• /config: 访问配置(仅所有者,持久化到磁盘)

调试命令

• /debug on|off: 启用调试模式
• /trace on|off: 启用跟踪日志
• /status: 显示会话状态

配置启用

{
  "tools": {
    "elevated": {
      "enabled": true,
      "allowFrom": {
        "discord": ["user-id-1"],
        "whatsapp": ["+15555551234"]
      }
    }
  }
}

命令解析规则

• 命令必须以 / 开头
• 命令与参数之间用空格分隔
• 无效命令返回提示信息
• 命令区分大小写
• 仅接受指定的参数值

内联指令 vs 会话设置

内联指令

在消息中使用,仅影响当前消息:

/think high 请详细分析这个问题

会话设置

单独发送命令,影响整个会话:

/think high

确认消息:

Thinking level set to high for this session

组合命令

某些命令可以组合使用:

/elevated full /verbose on

命令权限

某些命令需要特定权限:

• /bash: 需要在 tools.elevated.allowFrom 白名单中
• /config: 仅代理所有者
• /elevated: 需要白名单授权

错误处理

无效的命令会返回有用的错误提示:

# 无效参数
/think invalid
→ Invalid thinking level. Use: off|minimal|low|medium|high|xhigh

# 未授权
/elevated full
→ Elevated mode is not available for this user

使用场景

• 快速调整: 临时改变代理行为
• 调试: 启用详细输出和跟踪
• 权限控制: 临时提升或降低权限
• 会话管理: 控制会话状态和历史

最佳实践

• 在调试时使用 /verbose on
• 复杂任务使用更高的思考级别
• 完成特权操作后使用 /elevated off
• 使用 /status 检查当前设置
• 记录常用命令组合供团队使用