# Codex Orbit Vue 开发计划

## 目标
使用 Vue 3、JavaScript 与 Electron 开发一个原创视觉的 Windows Codex 额度悬浮工具，不复用 C# 版本的图片资源。

## 当前阶段
阶段 6：视觉重构完成

## 阶段

### 阶段 1：需求与发现
- [x] 确认技术栈与用户约束
- [x] 检查原 C# 项目的日志读取方式
- [x] 记录组件边界与技术方案
- **状态：** complete

### 阶段 2：项目与界面实现
- [x] 创建 Vue 3 + Vite + Electron 工程
- [x] 实现原创悬浮仪表界面
- [x] 实现演示模式与响应式状态
- **状态：** complete

### 阶段 3：桌面能力实现
- [x] 解析 Codex 本地 JSONL 日志
- [x] 监听日志并通过 IPC 更新 Vue
- [x] 实现托盘、置顶、拖动、保存位置
- **状态：** in_progress

### 阶段 4：构建与验证
- [ ] 安装依赖并运行静态检查
- [ ] 构建前端与 Windows EXE
- [ ] 启动应用并进行视觉验证
- **状态：** pending

### 阶段 5：交付
- [ ] 检查输出文件和使用说明
- [ ] 更新进度与最终结果
- **状态：** pending

### 阶段 6：视觉重构
- [x] 确定新的编辑式工业仪表方向
- [x] 将圆环组件替换为分段额度组件
- [x] 重构面板排版、颜色、字体和动效
- [x] 根据用户参考进一步精简为纯额度表盘
- [x] 修复过期5小时额度仍然显示的问题
- [x] 构建并进行真实窗口视觉验证
- **状态：** complete

## 已做决策

| 决策 | 理由 |
|------|------|
| Vue 3 Composition API + JavaScript | 用户已确认希望使用 JavaScript |
| Electron + electron-builder | 提供透明窗口、托盘、本地文件和 EXE 打包能力 |
| SVG + CSS 原创建图 | 不复用原项目图片，保持界面轻量清晰 |
| 无服务器、无数据库 | 数据来自本机 Codex 会话日志 |

## 遇到的错误

| 错误 | 尝试次数 | 解决方案 |
|------|---------|---------|
| 首次 `npm install` 在 120 秒工具时限内未完成 | 1 | 保留已下载内容并使用更长时限继续安装 |
| 系统与内置 Python 均缺少 Playwright 模块 | 2 | 改用工作区已提供的 Node Playwright 包 |
| 内置 Playwright 缺少默认浏览器二进制 | 1 | 指定系统已安装的 Chrome 作为测试浏览器 |
| 系统 Chrome 无头视觉会话未正常退出 | 1 | 改用 Electron 自身的 `capturePage` 验证真实窗口 |
| electron-builder 重命名临时发布目录时遇到 Windows `EPERM` | 1 | 检查残留进程和发布目录锁后清理临时产物重试 |
| 从临时目录生成的首个 portable 仅含 Electron 空运行时 | 1 | 不交付该文件；补齐应用 `app.asar` 和产品 EXE 后重新封装验证 |