52 lines
2.6 KiB
Markdown
52 lines
2.6 KiB
Markdown
|
# 进度日志
|
|||
|
|
|
|||
|
|
## 2026-07-16
|
|||
|
|
|
|||
|
|
### 阶段 1：需求与发现
|
|||
|
|
- **状态：** complete
|
|||
|
|
- 已确认 Vue 3 + JavaScript + Electron 技术栈。
|
|||
|
|
- 已分析 C# 版本的项目配置、界面方式、日志路径和数据窗口。
|
|||
|
|
- 已确定组件边界与原创视觉方向。
|
|||
|
|
- 创建文件：`task_plan.md`、`findings.md`、`progress.md`。
|
|||
|
|
|
|||
|
|
### 阶段 2：项目与界面实现
|
|||
|
|
- **状态：** complete
|
|||
|
|
- 创建 Vue 3 + Vite + Electron 基础工程。
|
|||
|
|
- 实现 `OrbitGauge.vue`、`UsagePanel.vue` 和 `useUsage.js`。
|
|||
|
|
- 完成深空导航仪器风格的纯 SVG/CSS 原创界面。
|
|||
|
|
|
|||
|
|
### 阶段 3：桌面能力实现
|
|||
|
|
- **状态：** in_progress
|
|||
|
|
- 实现 JSONL 尾部读取、额度解析、目录监听和 15 秒安全刷新。
|
|||
|
|
- 实现透明置顶窗口、托盘、右键菜单、IPC 与窗口位置保存。
|
|||
|
|
|
|||
|
|
### 阶段 6：视觉重构
|
|||
|
|
- **状态：** complete
|
|||
|
|
- 根据用户反馈弃用第一版深色发光圆环视觉。
|
|||
|
|
- 使用 frontend-design 技能确定“瑞士编辑排版 × 工业仪表”方向。
|
|||
|
|
- 新增 `QuotaMeter.vue`，重构 `UsagePanel.vue`，未改变数据与桌面功能。
|
|||
|
|
- 根据用户参考将展示进一步精简为 `QuotaDial.vue`，移除全部外层卡片信息。
|
|||
|
|
- 日志读取层现在会过滤已过期的5小时和周额度快照。
|
|||
|
|
- 单元测试 3 项全部通过，包含“过期5小时额度不展示”回归测试。
|
|||
|
|
- Vue生产构建通过；Electron真实日志截图显示单枚 `7d` 周额度圆盘，无外层阴影和边框。
|
|||
|
|
|
|||
|
|
## 测试结果
|
|||
|
|
|
|||
|
|
| 测试 | 预期结果 | 实际结果 | 状态 |
|
|||
|
|
|------|----------|----------|------|
|
|||
|
|
| Node 环境 | Node/npm 可用 | Node 24.10.0，npm 11.6.1 | 通过 |
|
|||
|
|
| 过期5小时额度 | `shortWindow` 返回 `null` | 回归测试通过 | 通过 |
|
|||
|
|
| 精简版生产构建 | Vue构建成功 | 16个模块构建成功 | 通过 |
|
|||
|
|
| 真实Electron预览 | 仅显示有效周额度圆盘 | 显示 `19% / 7d` | 通过 |
|
|||
|
|
|
|||
|
|
## 错误日志
|
|||
|
|
|
|||
|
|
| 错误 | 尝试次数 | 解决方案 |
|
|||
|
|
|------|---------|---------|
|
|||
|
|
| `npm install` 超过 120 秒被终止，未输出包错误 | 1 | 检查安装状态后延长时限继续 |
|
|||
|
|
| `ModuleNotFoundError: playwright` | 2 | Python 运行时均未提供该包，改用内置 Node Playwright |
|
|||
|
|
| Playwright 默认 Chromium 未安装 | 1 | 视觉脚本指定本机 Chrome 可执行文件 |
|
|||
|
|
| 系统 Chrome 无头测试超时 | 1 | 停止进程，加入 Electron 原生截图验证模式 |
|
|||
|
|
| 打包阶段 `win-unpacked.tmp` 重命名被拒绝 | 1 | 排查 Electron 残留进程及目录占用后重试 |
|
|||
|
|
| 首个 portable 验证时未生成应用截图 | 1 | 检查发现预打包目录尚未注入应用代码，重新制作完整预打包目录 |
|