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

README.md

@@ -0,0 +1,40 @@
+# Codex Halo
+
+使用 Vue 3、JavaScript 与 Electron 开发的 Windows Codex 本地额度悬浮仪表。
+
+## 功能
+
+- 从 `%USERPROFILE%\.codex\sessions` 读取 5 小时与 7 天额度快照
+- 监听 Codex JSONL 日志变化并自动刷新
+- 透明无边框、始终置顶、可拖动悬浮窗口
+- 系统托盘、手动刷新和窗口位置记忆
+- 纯 SVG/CSS 原创界面，不依赖图片资源
+- 完全本地运行，不需要服务器或数据库
+
+## 开发
+
+```powershell
+npm install
+npm run dev
+```
+
+浏览器单独预览页面：
+
+```powershell
+npm run dev:web
+```
+
+生成真实 Electron 窗口预览图：
+
+```powershell
+npm run capture
+```
+
+## 测试与构建
+
+```powershell
+npm test
+npm run build
+```
+
+构建产物会生成在 `release` 目录。