斜杠命令与文件面板
输入框有两种快捷触发方式(/ 和 @),帮助你快速插入命令、引用文件。本页逐一介绍它们的用法与细节。
输入框触发提示
当光标停在任务草稿输入框时,占位提示会显示这些用法:
「向 Claude 提问,输入 @ 添加文件,/ 使用命令和技能」
- 输入
/—— 打开命令面板,浏览并调用斜杠命令或技能 - 输入
@—— 打开文件面板,将工作区文件附加到消息
占位提示随 CLI 变化
占位提示会跟随当前任务使用的 CLI:Claude 任务显示「向 Claude 提问…」;Codex 任务显示「向 Codex 提问,输入 @ 添加文件,/ 使用技能」——因为 Codex 没有斜杠命令,/ 仅用于触发技能。
/ 命令面板
这是什么
命令面板(Command Palette)是所有斜杠命令的统一入口。你可以在这里搜索并选用来自不同来源的命令,包括内置功能命令、你自己定义的用户命令、项目级命令、插件提供的命令,以及各种技能(Skill)。
技能是一类特殊的可调用单元,与普通命令共享同一个面板,通过徽标区分。
在哪里打开
在输入框中,光标所在文本段以 / 开头、且不含空格或换行时,命令面板自动弹出在输入框上方。
怎么用
- 在输入框中输入
/,命令面板立即弹出,显示全部可用命令。 - 继续输入关键词过滤(例如
/compact),列表实时缩小。- 对于
plugin:cmd-name格式的插件命令,输入冒号后的部分也能匹配(例如在命令面板已打开的情况下,输入bra可匹配/superpowers:brainstorming)。
- 对于
- 用方向键 ↑↓ 上下导航,或直接用鼠标悬停高亮。
- 按 Enter 或 Tab 确认选中,也可点击某条命令。
- 选中后,
/query文本自动替换为该命令的标签片段,插入到光标位置。 - 按 Esc 关闭面板(再次输入
/可重新打开)。
无匹配时面板提示「没有匹配的命令」。
示例:输入 /compact → 选中 compact 命令 → 按 Enter,输入框出现该命令标签,发送后 AI 将压缩当前对话历史。
命令来源徽标
每条命令右侧显示两枚彩色徽标,分别标注该命令的来源和类型。
来源徽标(第一枚):
| 徽标显示 | 颜色 | 含义 |
|---|---|---|
| user | 蓝色 | 用户个人自定义命令 |
| project | 绿色 | 当前项目级命令(存放于项目内) |
| plugin | 紫色 | 插件提供的命令 |
| 内置 | 灰色 | 应用内置命令 |
类型徽标(第二枚):
| 徽标显示 | 颜色 | 含义 |
|---|---|---|
| command | 无背景(浅灰文字) | 普通命令 |
| skill | 琥珀色 | 技能(Skill),可调用专项能力 |
| workflow | 玫红色 | 工作流(见动态工作流) |
0.5.2 起支持双徽标
v0.5.2 起,命令面板每条目同时展示来源与类型两枚徽标,方便你在命令较多时快速定位来源。技能命令的来源徽标会根据是否属于插件自动推导:插件技能显示 plugin(紫色),用户技能显示 user(蓝色)。
@ 文件面板
这是什么
文件面板(File Palette)让你快速在消息里引用工作区文件,AI 会将被引用文件的内容作为上下文处理。
在哪里打开
在输入框任意位置输入 @,只要 @ 前面是行首或空格(即不在某个词的中间),文件面板就会自动弹出。注意:@ 之后输入的查询词中间不能含空格,一旦出现空格面板即关闭。
怎么用
- 在输入框中输入
@,文件面板弹出,显示工作区所有可索引文件。 - 继续输入文件名关键词(例如
@README),列表按相关度排序过滤:完全匹配 > 文件名前缀 > 路径前缀 > 文件名包含 > 路径包含。 - 用方向键 ↑↓ 或鼠标选中目标文件,按 Enter 或点击确认。
- 选中后
@query被替换为文件标签片段(显示文件名);图片文件会直接转为图片片段嵌入消息。 - 最多显示 50 条匹配结果,超出时提示「还有 {n} 条…」。
示例:输入 @src/main → 面板过滤出以 src/main 开头的文件 → 选中 src/main.ts → Enter,消息里出现该文件标签。
找不到文件?
使用文件面板前需先打开工作区。面板仅显示工作区已索引文件,若文件未出现,请确认已打开对应工作区(左侧栏「查看文件」),或检查文件是否在 .gitignore 等忽略范围内。
技能调用
技能(Skill)是通过命令面板调用的专项能力单元,在面板中以琥珀色 skill 徽标标注。
调用方式与普通斜杠命令相同:
- 在输入框中输入
/,打开命令面板。 - 输入技能名称关键词筛选(技能条目带琥珀色 skill 类型徽标)。
- 按 Enter 或点击选中,发送后 AI 会调用对应技能执行专项任务。
下一步
了解输入触发方式之后,可以进一步探索把工作流的运行过程可视化呈现,前往动态工作流继续学习。