codex额度查看工具开发完成1.0版本

task_plan.md

@@ -0,0 +1,67 @@
+# 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 后重新封装验证 |