命令

本文档详细介绍了 Qwen Code 支持的所有命令，帮助你高效管理会话、自定义界面并控制其行为。

Qwen Code 命令通过特定前缀触发，分为以下三类：

1. 斜杠命令 (/)

斜杠命令用于管理 Qwen Code 的会话、界面和基本行为。

1.1 会话与项目管理

这些命令可帮助你保存、恢复和总结工作进度。

1.2 界面与工作区控制

用于调整界面外观和工作环境的命令。

1.3 语言设置

专门用于控制界面和输出语言的命令。

• 可用的内置 UI 语言：zh-CN（简体中文）、en-US（英语）、ru-RU（俄语）、de-DE（德语）、ja-JP（日语）、pt-BR（葡萄牙语 - 巴西）、fr-FR（法语）、ca-ES（加泰罗尼亚语）
• 输出语言示例：Chinese、English、Japanese 等。

1.4 工具与模型管理

用于管理 AI 工具和模型的命令。

1.5 内置 Skills

这些命令调用内置的 skill，提供专门的工作流。

有关 /review 的完整文档，请参阅 Code Review。

1.6 侧边提问 (/btw)

/btw 命令允许你快速提出侧边问题，而不会中断或影响主对话流。

工作原理：

• 侧边问题会作为单独的 API 调用发送，并带有最近的对话上下文（最多 20 条消息）
• 响应显示在 Composer 上方——你可以在等待时继续输入
• 主对话不会被阻塞——它会独立继续
• 侧边问题的响应不会成为主对话历史的一部分
• 答案支持完整的 Markdown 渲染（代码块、列表、表格等）

键盘快捷键（交互模式）：

示例：

（当主对话正在重构代码时）

> /btw JavaScript 中 let 和 var 有什么区别？

  ╭──────────────────────────────────────────╮
  │ /btw JavaScript 中 let 和 var 有什么     │
  │     区别？                               │
  │                                          │
  │ + 正在回答...                            │
  │ 按 Escape、Ctrl+C 或 Ctrl+D 取消         │
  ╰──────────────────────────────────────────╯
  > (Composer 保持活跃——继续输入)

（答案到达后）

  ╭──────────────────────────────────────────╮
  │ /btw JavaScript 中 let 和 var 有什么     │
  │     区别？                               │
  │                                          │
  │ `let` 是块级作用域，而 `var` 是          │
  │ 函数作用域。`let` 在 ES6 中引入，        │
  │ 且不会以相同的方式提升。                 │
  │                                          │
  │ 按 Space、Enter 或 Escape 关闭           │
  ╰──────────────────────────────────────────╯
  > (Composer 仍然活跃)

支持的执行模式：

1.7 会话回顾 (/recap)

/recap 命令会生成当前会话的简短“上次离开时”摘要，以便你可以恢复旧对话，而无需向上翻阅数页历史记录。

工作原理：

• 可用时使用配置的快速模型（fastModel 设置），否则回退到主会话模型。对于回顾来说，一个小巧、低成本的模型就足够了。
• 最近的对话（最多 30 条消息，仅限文本——工具调用和工具响应会被过滤掉）会连同严格的 system prompt 一起发送给模型。
• 回顾内容以暗色渲染，并带有 ❯ 前缀，以便与真实的助手回复区分开来。
• 如果模型回合正在进行或另一个命令正在处理，则会以内联错误拒绝。如果没有可用的对话，或者底层生成失败，/recap 会显示一条简短的信息消息而不是回顾——手动命令始终会返回某些内容。

离开后返回时自动触发：

如果终端失去焦点 5 分钟以上并重新获得焦点，会自动生成并显示回顾（仅在没有模型响应正在进行时；否则会等待当前回合完成后再触发）。与手动命令不同，自动触发在失败时完全静默：如果生成出错或没有可总结的内容，则不会向历史记录中添加任何消息。由 general.showSessionRecap 设置控制（默认值：false）；手动 /recap 命令始终有效，不受此设置影响。

示例：

> /recap

❯ 重构 loopDetectionService.ts 以解决由无界的 streamContentHistory 和
  contentStats 引起的长会话 OOM 问题。下一步是实施选项 B（使用 FNV-1a
  的 LRU 滑动窗口），等待确认。

1.8 Diff 查看器 (/diff)

/diff 命令打开一个交互式 diff 查看器，显示未提交的更改和每个回合的 diff。使用 ←/→ 在当前 git diff 和各个对话回合之间切换，使用 ↑/↓ 浏览文件，按 Enter 查看内联 diff。

工作原理：

在交互模式下，/diff 会打开一个对话框，顶部带有来源选择器：

• Current — 工作树与 HEAD 对比（git diff HEAD）。显示所有未提交的更改，包括已暂存、未暂存和未跟踪的文件。
• T1, T2, T3, … — 每个回合的 diff，每个修改了文件的模型回合对应一个标签页。最近的回合显示在最前面。每个标签页会显示原始 prompt 的预览以提供上下文。

文件列表显示每个文件的统计信息（增加/删除的行数），并带有特殊状态的标签（new、deleted、untracked、binary、truncated、oversized）。在文件上按 Enter 可查看其内联 diff，并带有语法高亮的代码块。

每个回合的 diff 需要启用文件检查点（在交互模式下默认开启）。当文件检查点关闭时，仅“Current”来源可用。

键盘快捷键：

示例：

┌ /diff · 回合 3 "重构 auth 中间件" ──── 3 个文件 +45 -12 ──────────┐
│                                                                     │
│ ◀ Current · T3 · T2 · T1 ▶                                         │
│                                                                     │
│ › src/utils/parser.ts                              +30 -8           │
│   src/utils/parser.test.ts                         +12 -2           │
│   README.md                                        +3 -2            │
│                                                                     │
│ ←/→ 来源 · ↑/↓ 文件 · Enter 查看 · Esc 关闭                        │
└─────────────────────────────────────────────────────────────────────┘

非交互模式：

在无头（--prompt）或非交互上下文中，/diff 会打印工作树与 HEAD 对比的纯文本摘要。不提供每个回合的导航。

3 个文件已更改，+45 / -12
  +30  -8  src/utils/parser.ts
  +12  -2  src/utils/parser.test.ts
   +3  -2  README.md

1.9 信息、设置和帮助

用于获取信息和执行系统设置的命令。

1.10 常用快捷键

1.11 身份验证命令

在 Qwen Code 会话中使用 /auth 来配置身份验证。使用 /doctor 检查当前的身份验证和环境状态。

2. @ 命令（引入文件）

@ 命令用于快速将本地文件或目录内容添加到对话中。

注意：路径中的空格需要使用反斜杠进行转义（例如：@My\ Documents/file.txt）

3. 感叹号命令（!）- Shell 命令执行

感叹号命令允许你直接在 Qwen Code 中执行系统命令。

环境变量：通过 ! 执行的命令会设置 QWEN_CODE=1 环境变量。

4. 自定义命令

将常用的提示词保存为快捷命令，以提高工作效率并确保一致性。

快速概览

优先级规则：项目命令 > 用户命令（同名时使用项目命令）

命令命名规则

文件路径到命令名的映射表

命名规则：路径分隔符（/ 或 \）转换为冒号（:）

Markdown 文件格式规范（推荐）

自定义命令使用带有可选 YAML frontmatter 的 Markdown 文件：

---
description: 可选的描述（在 /help 中显示）
---
 
你的提示词内容。
使用 {{args}} 进行参数注入。

TOML 文件格式（已弃用）

参数处理机制

1. 上下文感知注入（{{args}}）

2. 默认参数处理

🚀 动态内容注入

3. Shell 命令执行（!{...}）

示例：生成 Git Commit 信息

---
description: 基于暂存区的更改生成 Commit 信息
---
 
请根据以下 diff 生成 Commit 信息：
 
```diff
!{git diff --staged}
```

4. 文件内容注入（@{...}）

示例：代码审查命令

---
description: 基于最佳实践的代码审查
---
 
审查 {{args}}，参考标准：
 
@{docs/code-standards.md}

实际创建示例

“纯函数重构”命令创建步骤表

---
description: 将代码重构为纯函数
---
 
请分析当前上下文中的代码，将其重构为纯函数。
要求：
 
1. 提供重构后的代码
2. 解释关键更改以及纯函数特性的实现
3. 保持函数功能不变

自定义命令最佳实践总结

命令设计建议表

安全特性提醒表

5. CLI 子命令

在启动交互式会话之前，可以在 shell 中通过 qwen <subcommand> 的形式运行这些命令。

会话管理

qwen sessions list

列出你最近的 Qwen Code 会话及其元数据。

选项：

人类可读输出（默认）：

包含以下列的表格：SESSION ID、STARTED（UTC 时间戳）、TITLE、BRANCH、PROMPT。

JSON 输出（--json）：

在 stdout 输出 JSON Lines。每行是一个包含以下字段的 JSON 对象：

sessionId, startTime, mtime, prompt, gitBranch, customTitle, titleSource, filePath, cwd

“还有更多会话”的提示信息会通过 stderr 输出，因此通过管道传递给 jq 依然是安全的。

示例：

# 显示最近 20 个会话（默认）
qwen sessions list
 
# 显示最近 50 个会话
qwen sessions list --limit 50
 
# 以 JSON 格式输出，便于脚本处理
qwen sessions list --json | jq .