# Snow CLI 使用文档——指令面板说明

指令面板是 Snow CLI 提供的快捷命令系统，让您可以通过简单的斜杠命令快速执行各种操作。本节为目录索引——具体指令说明按类目拆分到对应的子文档中。

## 指令面板概述

所有指令都以 `/` 开头，在聊天输入框中输入即可执行。指令分为以下几类：

| 类目           | 子文档                                                  | 包含的指令                                                                                                                                                                                                                           |
| -------------- | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 会话管理       | [09.1 会话管理指令](./09.1.会话管理指令.md)             | `/clear`、`/del-session`、`/resume`、`/export`、`/copy-last`、`/compact`、`/branch`、`/cut`、`/pause`、`/continue`                                                                                                                   |
| 模式切换       | [09.2 模式切换指令](./09.2.模式切换指令.md)             | `/yolo`、`/plan`、`/vulnerability-hunting`、`/tool-search`、`/tool-display`、`/tool-icons`、`/tool-names`、`/think-display`、`/image-compress`                                                                                       |
| 代码审查与分析 | [09.3 代码审查与分析指令](./09.3.代码审查与分析指令.md) | `/review`、`/diff`、`/init`、`/new-prompt`、`/role`、`/reindex`、`/codebase`                                                                                                                                                         |
| 配置与管理     | [09.4 配置与管理指令](./09.4.配置与管理指令.md)         | `/home`、`/ide`、`/connect`、`/disconnect`、`/connection-status`、`/mcp`、`/usage`、`/telemetry`、`/permissions`、`/auto-format`、`/config`、`/help`、`/quit`、`/worktree`、`/add-dir`、`/cleanup`、`/backend`、`/loop`、`/profiles` |
| 自定义扩展     | [09.5 自定义扩展指令](./09.5.自定义扩展指令.md)         | `/custom`、`/skills`、`/role-subagent`、`/btw`、自定义命令删除规则                                                                                                                                                                   |
| 特殊指令       | [09.6 特殊指令](./09.6.特殊指令.md)                     | `/agent-`、`/todo-`、`/skills-`                                                                                                                                                                                                      |
| 目标管理       | [09.7 目标管理指令](./09.7.目标管理指令.md)             | `/goal`（持久化目标驱动循环）                                                                                                                                                                                                        |

## 快捷键

除了斜杠指令，还有一些便捷的快捷键：

- `Ctrl+P`/`Alt+P`: 切换配置文件（Profile）
- `Ctrl+L`: 向前清除输入框
- `ESC`: 中断 AI 响应
- `↑/↓`: 浏览历史输入
- `#`: 打开子代理选择面板（在输入框中输入 `#` 触发）
- `>>`: 向运行中的子代理发送消息（在输入框开头输入 `>>` 触发）

## 使用技巧

1. **自动补全**: 输入 `/` 后会显示所有可用指令，可以使用方向键选择

2. **指令组合**: 某些指令可以与模式组合使用，例如：

   - 开启 `/yolo` 模式后执行 `/review` 可以快速审查代码
   - 开启 `/plan` 模式后执行 `/init` 会生成更详细的项目文档

3. **自定义工作流**: 使用 `/custom` 创建常用操作的快捷指令

   - 例如创建 `/deploy` 执行部署脚本
   - 创建 `/test` 运行测试命令

4. **技能复用**: 使用 `/skills` 创建可复用的任务模板

   - 代码生成模板
   - 文档模板
   - 测试用例模板
   - 使用 `/skills -l` 打开技能列表面板，可启用/禁用技能，按 `U` 更新选中技能，按 `A` 更新全部 GitHub 技能
   - 详细说明请参考 [Skills 指令详细说明](./18.Skills指令详细说明.md)

5. **会话管理**: 定期使用 `/export` 备份重要对话，使用 `/compact` 压缩长对话

6. **定时循环**: 需要周期性执行同一个 Prompt 时使用 `/loop`，例如 `/loop 5m 检查日志`；如果需要每天固定本地时刻运行，可使用 `/loop daily 09:30 检查日报` 或 `/loop 检查日报 every day at 09:30`；如果希望退出当前 Snow CLI 后仍继续运行，使用 `/loop daemon 5m 检查日志`，再通过 `/loop list` 查看 Loop ID、`/loop cancel <id>` 停止

7. **目标驱动**: 复杂多轮任务可使用 `/goal <objective>` 创建持久化目标，AI 会自动迭代直到模型显式标记完成

## 常见问题

### Q: 指令不生效怎么办？

A: 检查以下几点：

- 确认指令拼写正确（区分大小写）
- 某些指令有前置条件（如 `/reindex` 需要启用代码库）
- 查看错误提示信息

### Q: 如何查看所有可用指令？

A: 输入 `/` 然后等待，会显示自动补全列表，或使用 `/help` 查看帮助

### Q: 自定义指令保存在哪里？

A:

- 全局指令: `~/.snow/commands/`
- 项目指令: `<项目根目录>/.snow/commands/`

### Q: 如何在不同项目间共享自定义指令？

A: 创建指令时选择"全局"位置，或手动复制 `.snow/commands/` 目录到其他项目

## 相关配置

- [敏感命令配置](./06.敏感命令配置.md) - 配置需要确认的危险操作
- [Hooks 配置](./07.Hooks配置.md) - 配置指令执行前后的自动化操作
- [代码库设置](./04.代码库设置.md) - 配置代码库索引功能（`/reindex` 所需）
- [命令注入模式](./10.命令注入模式.md) - 在消息中直接执行命令的高级功能
- [漏洞猎人模式](./11.漏洞猎人模式.md) - 专业的安全分析和漏洞检测功能