2.6 KiB
2.6 KiB
Codex Orbit Vue 开发计划
目标
使用 Vue 3、JavaScript 与 Electron 开发一个原创视觉的 Windows Codex 额度悬浮工具，不复用 C# 版本的图片资源。
当前阶段
阶段 6：视觉重构完成
阶段
阶段 1：需求与发现
- 确认技术栈与用户约束
- 检查原 C# 项目的日志读取方式
- 记录组件边界与技术方案
- 状态： complete
阶段 2：项目与界面实现
- 创建 Vue 3 + Vite + Electron 工程
- 实现原创悬浮仪表界面
- 实现演示模式与响应式状态
- 状态： complete
阶段 3：桌面能力实现
- 解析 Codex 本地 JSONL 日志
- 监听日志并通过 IPC 更新 Vue
- 实现托盘、置顶、拖动、保存位置
- 状态： in_progress
阶段 4：构建与验证
- 安装依赖并运行静态检查
- 构建前端与 Windows EXE
- 启动应用并进行视觉验证
- 状态： pending
阶段 5：交付
- 检查输出文件和使用说明
- 更新进度与最终结果
- 状态： pending
阶段 6：视觉重构
- 确定新的编辑式工业仪表方向
- 将圆环组件替换为分段额度组件
- 重构面板排版、颜色、字体和动效
- 根据用户参考进一步精简为纯额度表盘
- 修复过期5小时额度仍然显示的问题
- 构建并进行真实窗口视觉验证
- 状态： 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 后重新封装验证 |