change-42-yhmm/quota-float

# Quota Float 轻量级桌面悬浮挂件，用于从本地 Codex Desktop 登录状态检查 Codex 额度。  ## 亮点 - 在一个紧凑的常驻顶层挂件中显示您的 Codex 计划、5小时额度、每周额度以及下次重置时间。 - 使用清晰的额度状态来表示健康、警告和紧急的剩余使用量。 - 空闲时折叠为一个小型悬浮球，鼠标悬停时展开。 - 指示当前是否正在消耗额度。 - 包含用于语言切换和常驻顶层行为的快捷控制。 - 当额度服务提供时，显示重置额度数量和可用重置额度的过期时间。 - 处理过期数据、登出会话、不可用的额度响应和加载状态，而不会捏造数值。 ## 截图 | 额度状态 | 悬浮球 | 重置额度过期 | | --- | --- | --- | |  |  |  | ## 工作原理 Quota Float 会读取您机器上现有的 Codex Desktop 登录状态，并使用该会话查询 Codex/ChatGPT 额度 endpoint。它不会根据本地 token 计数来估算使用量，也不会兑换重置额度或修改账户设置。 浏览器预览使用模拟数据。读取真实额度需要 Tauri 桌面应用以及在同一台机器上已登录 Codex Desktop。 ## 下载 普通用户请从 GitHub Releases 下载最新的未签名版本： - 最新版本：https://github.com/change-42-yhmm/quota-float/releases/latest - Windows：`quota-float-windows-unsigned.zip` - macOS 通用版：`quota-float-macos-universal-unsigned.zip` 解压并运行该应用。未签名版本可能会触发 Windows SmartScreen 或 macOS Gatekeeper 警告。面向非技术用户的公开发布应使用已签名的 Windows 版本和已公证的 macOS 版本。 ## 隐私边界 Quota Float 是本地优先且特意范围狭窄的： - 仅读取本地 Codex Desktop 登录状态以查询 Codex 额度。 - 仅将现有的 Codex access token 发送到 ChatGPT 额度 endpoint。 - 仅在其自身的应用配置目录中存储挂件偏好设置。 - 不存储 Codex token、账户 ID、prompt、聊天历史、原始额度响应或本地认证路径。 - 不包含遥测、分析、崩溃报告或第三方跟踪。 - 不兑换重置额度或修改账户设置。 有关完整的边界说明，请参阅 [PRIVACY.md](PRIVACY.md) 和 [SECURITY.md](SECURITY.md)。 ## 准确性边界 Codex 额度是从 Codex/ChatGPT 额度服务响应中读取的。如果响应格式发生变化，应用将显示不可用或过期状态，而不是编造额度数值。 ## 开发 要求： - Node.js 20+ - Rust stable - 适用于您平台的 Tauri 2 系统依赖项 ``` npm install npm run dev npm run test npm run build npm run tauri dev ``` ## 构建 ``` npm run tauri build ``` 在 Windows 上，Tauri 可能会下载 WiX 以创建 MSI 安装程序。如果 WiX 下载失败，发布版可执行文件可能仍会生成于： ``` src-tauri/target/release/quota-float.exe ``` ## 发布 已配置 GitHub Actions 用于： - push/PR 时的 CI：前端测试、Rust 测试、web build、Tauri build。 - `v*` 标签：未签名的 Windows 和 macOS 通用版 bundle artifact 以及公开的 GitHub Release。 在为他人发布版本之前，请参阅 [docs/GITHUB-RELEASE-CHECKLIST.md](docs/GITHUB-RELEASE-CHECKLIST.md)。 请勿将本地凭证、`.codex`、`.env*`、包含个人数据的截图、`node_modules`、`dist`、`src-tauri/target` 或本地安装程序上传到源代码控制。 ## 许可证 MIT

标签：Codex, MITM代理, Tauri, 可视化界面, 客户端工具, 桌面组件, 状态监控, 自动化攻击, 额度查询