Skip to content

Slash 命令

Slash 命令提供了在交互式会话期间快速访问 SII CLI 功能的方式。命令可以是内置的(由 SII CLI 提供)或自定义的(用户定义)。

内置 Slash 命令

会话管理

命令用途
/help/?显示帮助信息和可用命令
/new开始新的对话会话(结束当前会话并保留历史记录)
/clear清除屏幕并开始新会话(/new 的别名)
/quit/exit退出交互式会话
/compress/summarize通过用摘要替换来压缩上下文

聊天历史

命令用途
/chat list列出已保存的对话检查点
/chat save <tag>将当前对话保存为检查点
/chat resume <tag>/chat load <tag>从检查点恢复对话

配置管理

命令用途
/config init [--global|-g] [--overwrite|--merge]初始化配置文件
/config wizard [--global|-g]交互式配置向导
/config quick-start <scenario>常见场景的快速配置(development、production、minimal)
/config template显示包含所有可用选项的完整配置模板
/config list [scope] [category]显示当前配置设置
/config get <key> [scope]获取特定配置值
/config set <key> <value> [scope]设置配置值
/config reset [scope]将配置重置为默认值
/config path显示配置文件路径
/config help <key>显示特定配置键的详细帮助
/config validate验证当前配置并提供优化建议
/config status检查配置状态并获取建议
/config env-status检查 SII 环境变量状态
/config env-guide显示环境变量设置指南
/config migrate [--auto]显示从旧环境变量迁移到 SII_ 前缀变量的指南
/config persist将当前 SII 环境变量持久化到 shell 配置文件
/config auth-status检查认证状态和连接健康状况
/config migrate-to-env将环境变量从 shell 配置迁移到 .env 文件
/config env-file-status检查 .env 文件状态和环境变量配置
/config reload-env重新加载 .env 文件并同步到当前进程环境变量
/config sync-env强制同步所有 SII 环境变量到当前进程
/config migrate-to-global将现有配置迁移到全局配置目录 (~/.sii/.env)
/config config-status显示详细的配置状态和层级信息
/config ide-port [status|set <port>|migrate]管理 IDE 端口配置

模型管理

命令用途
/model显示当前模型
/model <model_name>切换到指定模型(例如:openai/gpt-4oanthropic/claude-3.5-sonnetgemini-2.0-flash

记忆管理

命令用途
/memory show显示当前记忆内容
/memory add <text>向记忆添加内容
/memory refresh从源文件刷新记忆

提示词管理

命令用途
/prompt show显示当前会话使用的提示词
/prompt enable为此会话启用用户提示词文件
/prompt disable禁用用户提示词文件并恢复到默认提示词
/prompt edit在默认编辑器中打开提示词文件
/prompt set --file <path>为此会话设置自定义提示词文件
/prompt reset重置为默认提示词

MCP(模型上下文协议)

命令用途
/mcp list列出所有已配置的 MCP 服务器
/mcp status [server_name]显示 MCP 服务器状态
/mcp install <preset> [options]从预设安装 MCP 服务器
/mcp remove <server_name>删除 MCP 服务器配置
/mcp presets列出可用的 MCP 服务器预设
/mcp preset <name>显示特定预设的详细信息
/mcp tools [server_name]列出 MCP 服务器提供的工具
/mcp prompts [server_name]列出 MCP 服务器提供的提示词

远程会话

命令用途
/connect创建 SII 会话并通过 WebSocket 连接
/remote status显示远程句柄状态
/remote start [handle]启动远程句柄
/remote stop停止远程句柄
/remote qr显示远程连接的二维码

统计与信息

命令用途
/stats检查会话统计信息
/stats model显示模型特定的使用统计
/stats tools显示工具特定的使用统计
/about显示版本和系统信息
/tools列出可用工具及其状态

工作区初始化

命令用途
/init [--json|--scan-only|--file <path>]AI 引导的工作区探索和快照

选项:

  • --json:以 JSON 格式输出快照
  • --scan-only--summary:显示摘要而不进行 AI 分析
  • --file <path>:指定笔记的目标文件(默认:SII.md)

UI 与显示

命令用途
/theme更改 UI 主题
/editor配置默认编辑器
/privacy查看和更新隐私设置
/auth更改认证方法
/vim进入 vim 模式以交替插入和命令模式
/corgi切换 corgi 模式(彩蛋)

实用工具

命令用途
/copy将最后一个响应复制到剪贴板
/bug报告错误(将对话发送给开发人员)
/docs在浏览器中打开文档
/extensions管理 SII CLI 扩展
/ide管理 IDE 集成设置
/restore恢复之前的会话
/resume恢复最近的会话(/restore 的快捷方式)
/upload配置轨迹上传设置
/gh-issue创建 GitHub Issue(需要配置 GitHub MCP 服务器)

自定义 Slash 命令

自定义 slash 命令允许您将常用提示词定义为 TOML 文件,SII CLI 可以执行这些文件。命令按范围组织(项目特定或个人)。

语法

/<command-name> [arguments]

参数

参数描述
<command-name>从 TOML 文件名派生的名称(不带 .toml 扩展名)
[arguments]传递给命令的可选参数

命令类型

项目命令

存储在您的仓库中并与团队共享的命令。

位置: .sii/commands/

示例 - 创建 /optimize 命令:

bash
# 创建项目命令目录
mkdir -p .sii/commands

# 创建命令文件
cat > .sii/commands/optimize.toml << 'EOF'
name = "optimize"
description = "分析代码性能问题"
prompt = """
分析此代码的性能问题并提出优化建议:
- 识别瓶颈
- 建议算法改进
- 推荐缓存策略
"""
EOF

个人命令

在所有项目中可用的命令。

位置: ~/.sii/commands/

示例 - 创建 /security-review 命令:

bash
# 创建个人命令目录
mkdir -p ~/.sii/commands

# 创建命令文件
cat > ~/.sii/commands/security-review.toml << 'EOF'
name = "security-review"
description = "审查代码安全漏洞"
prompt = """
审查此代码的安全漏洞:
- 检查注入攻击
- 验证输入清理
- 审查认证/授权
- 检查敏感数据暴露
"""
EOF

命令文件格式

自定义命令在 TOML 文件中定义,具有以下结构:

toml
name = "command-name"
description = "命令功能的简要描述"
prompt = """
将发送给 AI 模型的提示词文本。
可以是多行并包含占位符。
"""

# 可选:指定允许的参数
[args]
arg1 = "第一个参数的描述"
arg2 = "第二个参数的描述"

# 可选:命令元数据
[metadata]
author = "您的名字"
version = "1.0.0"
tags = ["code-review", "security"]

功能特性

命名空间

在子目录中组织命令以获得更好的组织:

bash
.sii/commands/
├── frontend/
   ├── component.toml
   └── style.toml
└── backend/
    ├── api.toml
    └── database.toml

命令通过其文件名调用,而不是目录路径:

  • /component - 调用 frontend/component.toml
  • /api - 调用 backend/api.toml

参数

向命令传递动态值:

toml
name = "fix-issue"
description = "修复特定问题"
prompt = """
按照我们的编码标准修复问题 #{{ISSUE_NUMBER}}。
优先级:{{PRIORITY}}
"""

[args]
ISSUE_NUMBER = "要修复的问题编号"
PRIORITY = "优先级(high、medium、low)"

使用方法:

bash
/fix-issue ISSUE_NUMBER=123 PRIORITY=high

发现

自定义命令在 SII CLI 启动时自动发现和加载。它们与内置命令一起出现在 /help 输出中。

要在不重启的情况下刷新自定义命令:

bash
/memory refresh

命令补全

许多命令支持参数的 Tab 补全:

  • /model <TAB> - 显示可用模型
  • /chat resume <TAB> - 显示已保存的对话标签
  • /mcp install <TAB> - 显示可用的 MCP 预设

提示

  1. 快速帮助:输入 /help/? 查看所有可用命令
  2. 命令历史:使用箭头键浏览命令历史
  3. 多行输入:按 Shift+Enter 进行多行输入(如果终端支持)
  4. 别名:某些命令有较短的别名(例如:/clear = /new/? = /help/resume = /restore
  5. Tab 补全:使用 Tab 键进行命令和参数补全
  6. 会话持久化:使用 /chat save 保存重要对话
  7. 自定义命令:在 .sii/commands/ 中创建项目特定命令以用于团队工作流
  8. 快速恢复:使用 /resume 快速恢复最近的会话,无需选择
  9. GitHub 集成:使用 /gh-issue 直接从 CLI 创建 GitHub Issue(需要配置 GitHub MCP 服务器)

示例

基本会话管理

bash
# 开始新会话
/new

# 保存当前对话
/chat save important-discussion

# 恢复已保存的对话
/chat resume important-discussion

# 快速恢复最近的会话
/resume

# 恢复之前的会话(交互式选择)
/restore

# 压缩上下文以节省 token
/compress

配置管理

bash
# 初始化项目配置
/config init

# 设置 API 密钥
/config set api.openaiApiKey "your-api-key"

# 切换模型
/model openai/gpt-4o

# 检查配置状态
/config status

记忆管理

bash
# 显示当前记忆
/memory show

# 添加重要信息
/memory add "项目使用 React 18 和 TypeScript"

# 从文件刷新记忆
/memory refresh

MCP 集成

bash
# 列出可用预设
/mcp presets

# 安装 GitHub MCP 服务器
/mcp install github token=ghp_xxx

# 列出 GitHub 服务器的工具
/mcp tools github

# 检查服务器状态
/mcp status

# 使用 GitHub MCP 创建 Issue
/gh-issue
# 注意:需要先配置 GitHub MCP 服务器

工作区初始化

bash
# 使用 AI 指导初始化工作区
/init

# 仅获取 JSON 快照
/init --json

# 扫描而不进行 AI 分析
/init --scan-only

# 使用自定义目标文件
/init --file NOTES.md

另请参阅

Released under the MIT License.