# 发现与决策

## 需求

- 参考桌面 `codexorbit-1.2.3` 的功能开发 Vue 版本。
- 使用前端技术和 JavaScript。
- 样式重新设计，不使用原项目图片。
- 最终可构建为 Windows EXE。

## 原项目发现

- 原项目为 C#、WPF、.NET Framework 4.8、x64 WinExe。
- 读取 `%USERPROFILE%\.codex\sessions` 下的 `rollout-*.jsonl`。
- 从 `event_msg` / `token_count` / `rate_limits` 记录提取 primary 与 secondary 时间窗口。
- 5 小时窗口为 300 分钟，周窗口为 10080 分钟。
- 使用文件监听器更新额度；窗口位置写入本地配置文件。
- 不需要服务器或数据库。

## 组件地图

| 模块 | 单一职责 | 数据契约 |
|------|----------|----------|
| `App.vue` | 组合应用外壳与额度面板 | 使用 `useUsage`，向面板传入快照 |
| `QuotaTile.vue` | 以悬浮标签展示单个周期百分比和垂直刻度 | props: `value`, `label`, `tone` |
| `UsagePanel.vue` | 展示双窗口额度、状态与重置时间 | props: `snapshot`; emit: `refresh` |
| `useUsage.js` | 管理 IPC 订阅、刷新和演示数据 | 返回只读快照、连接状态和刷新动作 |
| Electron main | 窗口、托盘、日志解析和文件监听 | 通过 `usage:snapshot` IPC 推送快照 |
| Electron preload | 仅暴露受限桌面 API | `getUsage`, `refreshUsage`, `onUsage` |

## 视觉方向（第二版）

- “瑞士编辑排版 × 工业仪表”：奶油纸张色、炭黑信息块、朱红和酸绿色功能色。
- 去掉发光圆环，改为大数字、分段刻度和两种材质并置，提升扫读效率。
- 使用纯 CSS 几何元素，不使用图片；保留非对称圆角作为识别特征。

## 视觉方向（最终精简版）

- 去掉外层卡片、阴影、边框、标题、状态、重置时间与刷新按钮。
- 只保留圆形额度表盘、百分比和 `5h/7d` 标签。
- 5 小时快照已经过期时视为不存在，界面只显示周额度。
- Electron 窗口根据一枚或两枚表盘自动调整宽度，避免透明区域拦截桌面操作。

## 视觉方向（独立原创版）

- 放弃圆环参考，改为无边框、无阴影的悬浮额度标签。
- 以大号百分比、单色信号点和右侧垂直刻度表达额度，不增加业务文案。
- 周额度使用酸绿色，5小时额度使用珊瑚红；两者存在时并列，不存在时自动收缩。