---
url: /wave-agent/specs/commands/status-command.md
description: '`/status` 只读状态覆盖层：版本、会话 ID、cwd、Wave base URL 与当前模型'
---

# 功能规格说明：Status 命令

**创建日期**：2026-02-27

## 用户场景与测试 *（必填）*

### 用户故事：查看 Agent 状态（优先级：P1）

作为用户，我希望快速查看 agent 的当前配置和会话详情，以便验证我正在工作的环境。

**为什么是这个优先级**：这是请求的核心功能。它提供对 agent 状态的透明性，并有助于故障排除或验证设置。

**独立测试**：可以通过在 CLI 中输入 `/status` 并验证显示的信息（Version、Session ID、cwd、Wave base URL、Model）准确且格式正确来进行完整测试。

**验收场景**：

1. **假设** agent 处于交互状态，**当**用户输入 `/status` 时，**则** agent 显示包含版本、会话 ID、当前工作目录、Wave base URL 和当前模型的状态覆盖层，输入框被隐藏。
2. **假设**状态信息已显示，**当**用户按 `Esc` 时，**则**状态显示被关闭，输入框恢复，用户返回之前的交互状态。

***

### 边界情况

* **缺失信息**：如果某些元数据（如模型名称）尚未初始化或不可用，系统应显示占位符（例如"Unknown"或"Not set"），而不是崩溃或显示空白。
* **长路径**：如果当前工作目录路径非常长，显示应优雅地处理（例如通过换行或用省略号截断），以避免破坏 UI 布局。
* **快速调用**：如果用户快速多次输入 `/status`，系统应处理而不创建多个重叠的状态视图。