Appearance
功能规格说明:右下角通知组件
创建日期:2026-08-05 更新日期:2026-08-05
用户场景与测试 (必填)
用户故事:右下角的 token 用量指示(优先级:P1)
作为开发者,我希望 token 用量(上下文百分比)由独立的右下角通知组件显示,以便与 Claude Code 的布局对齐:左下状态栏只显示模式/shell 状态,右下通知区显示 token 用量与登录提示。
验收场景:
- 假设 CLI 正在运行且尚未收到 AI 响应,则 右下角通知区不显示百分比(已消耗 0 个 token)。
- 假设已收到 AI 响应,当上下文使用率低于 80% 时,则 右下角显示灰色的 "X% context"。
- 假设上下文使用超过 80%,当显示通知区时,则 百分比文本变为黄色。
- 假设上下文使用超过 95%,当显示通知区时,则 百分比文本变为红色。
- 假设用户处于 BTW 模式,则 输入区域显示独立的
BtwDisplay组件,状态栏与通知区均不显示。 - 假设 AI 正在思考,当显示加载指示器时,则 加载指示器保持显示 "1,234 tokens" 计数,通知区百分比与其互不影响。
用户故事:右下角的登录提示(优先级:P1)
作为新用户,我希望在未认证时于右下角看到登录提示,以便与 Claude Code 的提示位置一致("Not logged in · Run /login" 位于右下通知区)。
验收场景:
- 假设 CLI 正在运行且用户没有任何可用的认证或直连 API 配置,则 右下角通知区显示 "Type /login to authenticate" 提示。
- 假设用户完成登录,则 右下角登录提示实时消失。
- 假设消息区仍在渲染欢迎消息或静态内容,则 登录提示不显示在消息流中。
边界情况
- BTW 模式激活时通知区显示吗? 不显示。BTW 模式下输入区域整体替换为
BtwDisplay,状态栏与通知区一并隐藏。 - 登录提示与百分比同时出现时如何排列? 两者均位于右下角通知区,按顺序排列显示。
- 上下文百分比为 0(未收到响应)时显示吗? 不显示,与拆分前行为一致。