Skip to content

功能规格说明:右下角通知组件 ​

创建日期:2026-08-05 更新日期:2026-08-05

用户场景与测试 (必填) ​

用户故事:右下角的 token 用量指示(优先级:P1) ​

作为开发者,我希望 token 用量(上下文百分比)由独立的右下角通知组件显示,以便与 Claude Code 的布局对齐:左下状态栏只显示模式/shell 状态,右下通知区显示 token 用量与登录提示。

验收场景:

  1. 假设 CLI 正在运行且尚未收到 AI 响应,则 右下角通知区不显示百分比(已消耗 0 个 token)。
  2. 假设已收到 AI 响应,当上下文使用率低于 80% 时,则 右下角显示灰色的 "X% context"。
  3. 假设上下文使用超过 80%,当显示通知区时,则 百分比文本变为黄色。
  4. 假设上下文使用超过 95%,当显示通知区时,则 百分比文本变为红色。
  5. 假设用户处于 BTW 模式,则 输入区域显示独立的 BtwDisplay 组件,状态栏与通知区均不显示。
  6. 假设 AI 正在思考,当显示加载指示器时,则 加载指示器保持显示 "1,234 tokens" 计数,通知区百分比与其互不影响。

用户故事:右下角的登录提示(优先级:P1) ​

作为新用户,我希望在未认证时于右下角看到登录提示,以便与 Claude Code 的提示位置一致("Not logged in · Run /login" 位于右下通知区)。

验收场景:

  1. 假设 CLI 正在运行且用户没有任何可用的认证或直连 API 配置,则 右下角通知区显示 "Type /login to authenticate" 提示。
  2. 假设用户完成登录,则 右下角登录提示实时消失。
  3. 假设消息区仍在渲染欢迎消息或静态内容,则 登录提示不显示在消息流中。

边界情况 ​

  • BTW 模式激活时通知区显示吗? 不显示。BTW 模式下输入区域整体替换为 BtwDisplay,状态栏与通知区一并隐藏。
  • 登录提示与百分比同时出现时如何排列? 两者均位于右下角通知区,按顺序排列显示。
  • 上下文百分比为 0(未收到响应)时显示吗? 不显示,与拆分前行为一致。