Appearance
功能规格说明:帮助命令
创建日期:2026-03-25
用户场景与测试 (必填)
用户故事:访问帮助(优先级:P1)
作为用户,我希望能够通过输入 /help 查看可用命令和快捷键的列表,以便我可以有效地学习如何使用 agent。
为什么是这个优先级:这是核心功能。它为所有其他功能提供可发现性。
独立测试:在聊天输入中输入 /help 并验证帮助视图出现。
验收场景:
- 假设 agent 正在运行,当用户输入
/help并按下 Enter 时,则帮助视图被显示。 - 假设帮助视图已打开,当用户按下
Esc时,则帮助视图关闭,用户返回聊天输入。
用户故事:导航帮助标签页(优先级:P2)
作为用户,我希望使用 Tab 键在帮助的不同类别(通用、命令、自定义命令)之间切换,以便我可以快速找到所需的信息。
为什么是这个优先级:改善帮助信息的组织性和可用性。
独立测试:打开帮助,按下 Tab,验证活动标签页变化。
验收场景:
- 假设帮助视图在"通用"标签页打开,当用户按下
Tab时,则"命令"标签页变为活动。 - 假设"命令"标签页活动,当用户按下
Tab时,则"自定义命令"标签页变为活动(如果有自定义命令存在),否则循环回到"通用"。
用户故事:浏览命令(优先级:P2)
作为用户,我希望滚动查看命令列表并看到它们的描述,以便我可以理解每个命令的作用。
为什么是这个优先级:提供每个命令的详细信息。
独立测试:打开帮助,切换到"命令"标签页,使用方向键导航,验证描述被显示。
验收场景:
- 假设"命令"标签页活动,当用户使用
Up和Down方向键时,则选中的命令改变。 - 假设一个命令被选中,则其描述显示在命令名称下方。
- 假设命令数量超过视图可显示的范围,当用户向下滚动时,则命令列表滚动以显示更多项。