# 额度悬浮球 — design.md

内容版本：sha256:25f1646f2372cf54c6f4706d61602d90e86009d82e06dc6d155fce72dd6eb817

本文件由当前元数据、实现摘要和实际文件列表确定性生成。元数据记录是资料声明；未提供的数值不作推断。实现建议须在后续开发中选择和验收。

## 元数据记录

- 资产：components/quota-orb；语义类型：interaction。
- 分类：其他。
- 标签：悬浮球、状态指示、桌面挂件、拖拽。
- 场景：AI 额度监控、桌面效率挂件、后台任务状态指示。
- 平台：未提供。
- 风格：未提供。

### 亮点声明

- 四色状态阈值：剩余额度 >70% 显示绿色 #00FF00，30-70% 黄色 #FFFF00，<30% 红色 #FF0000，读取失败灰色 #808080，状态变化时轻微抖动提示
- 磨砂悬浮球：56px 半透明磨砂圆形（backdrop-filter 模糊 + 边缘微阴影），默认透明度 70%，悬停展开圆角信息卡片（重置时间 / 剩余额度 / 刷新状态）
- 完整桌面级交互：支持拖拽移动、双击最小化为小圆点、右键菜单（立即刷新 / 设置 / 退出），每 15 秒自动刷新一次额度

### 实际文件与参考资源

- `cover.png`（sha256:2ab447f2e19e6a69e01b1dbdf95759af5da8817617518691851206d11c668984）
- `demo.html`（sha256:d3d3a9efe30af5cb3adcb843d3040c79c124b8aee12f8c9c9a4e28c66a07a019）
- `meta.yml`
- 实现摘要：sha256:d3d3a9efe30af5cb3adcb843d3040c79c124b8aee12f8c9c9a4e28c66a07a019。

## 未提供

- 未结构化记录的精确色值、字号、间距、断点、动效时长与状态转换参数不作推断；亮点中的数值属于元数据声明，demo 的存在与摘要不代表浏览器行为已验收。

## 实现建议

- 按正常、悬停、聚焦、激活、禁用、加载、成功和错误状态定义适用的状态表。
- 使用语义化元素，验证键盘操作、焦点可见性、触控目标和减少动效偏好。
- 以 demo.html 为实现参考，逐项验证交互、窄屏布局、文本溢出和错误恢复；具体参数由实现与验收确认。