Codex Reset Tracker UI | Codex 重置额度 UI 追踪器

English | 简体中文

---

简体中文

Codex Reset Tracker UI 是一个轻量级、无边框、支持多国语言的本地桌面与移动端双重额度查询工具。它专门用于读取本地 Codex Desktop 的登录状态，查询 OpenAI Codex 的备用重置卡额度（Banked Reset Credits）并提供实时的过期倒计时。

本工具为纯本地只读查询工具，不保存、不存储您的任何账号凭证。

🚀 特色功能

1. 隐藏控制台窗口：原生打包为 GUI 模式，双击 .exe 直接启动，完全隐藏 CMD 命令行黑框。
2. 进程自动销毁 (心跳检测)：客户端与服务端每 2 秒进行一次心跳握手。当您关闭桌面窗口时，后台服务会在 7 秒内自动检测并彻底退出，绝不残留后台进程，自动释放端口。
3. 多语言支持 (i18n)：支持 简体中文 (默认)、English、日本語、한국어 实时切换，并自动记忆您的语言选择。日期格式与剩余时间单位均会自适应本地化。
4. 轻量无边框体验：利用系统内置的 Edge/Chrome 独立应用模式（App Mode）运行，无需打包臃肿的 Electron 即可获得无地址栏的原生桌面应用体验。
5. 多设备局域网查询：只要在同一 Wi-Fi 下，您就可以用手机或平板访问电脑 IP 地址，手动贴入 Token 轻松实现跨设备查询，界面完美适配移动端。
6. 浏览器自动降级：若检测到未安装 Edge 浏览器，程序会自动平滑降级，改用系统默认浏览器为您打开网页。

💻 如何使用 (Windows)

1. 下载并解压项目。
2. 双击运行 codex-reset-dates-ui.exe。
3. 软件会以独立的精美暗黑桌面窗口弹出，点击 “查询重置额度” 即可。
4. 关闭软件：直接点击窗口右上角的 X。后台服务会在数秒内自动检测并关闭。

📱 跨设备或手机查询

1. 确保您的手机和运行程序的电脑连接在同一个 Wi-Fi 下。
2. 在电脑的程序启动日志中（或在 CMD 中输入 ipconfig）获取电脑的局域网 IP（例如 192.168.1.100）。
3. 用手机浏览器打开 http://<您的电脑IP>:3000。
4. 切换到 “自定义 Token” 模式，粘入您的 access_token 或 auth.json 文本内容，点击查询。

🛠️ 从源码构建

如果您想修改代码或在非 Windows 平台（Mac / Linux）上运行：

1. 安装 Node.js (16.0.0+)。
2. 克隆本仓库：

   git clone https://github.com/<your-username>/codex-reset-dates-ui.git
   cd codex-reset-dates-ui

3. 运行本地开发服务器：

   node server.js

4. 构建并生成 EXE 文件（包含控制台自动隐藏补丁）：

   npm run build

---

English

Codex Reset Tracker UI is a lightweight, borderless, multi-language desktop and mobile utility designed to monitor your OpenAI Codex banked reset credits and expiry dates. It automatically reads your local Codex Desktop credentials, queries the OpenAI backend, and calculates real-time countdowns.

It is a read-only local utility that does not store or exfiltrate any credentials.

🚀 Key Features

1. Hidden Console Window: Packaged as a native Windows GUI subsystem executable. Double-clicking the .exe launches it silently in the background with no command prompt popup.
2. Auto-Shutdown (Heartbeat Connection): Uses a 2-second heartbeat mechanism. When you close the app window, the backend server detects it and automatically terminates within 7 seconds, freeing up network ports.
3. Multi-language i18n Support: Supports Simplified Chinese (Default), English, Japanese, and Korean with dynamic date localization and custom countdown units.
4. Borderless Desktop Window: Launches utilizing Microsoft Edge/Google Chrome's standalone --app mode, giving you a chromeless desktop app experience without the bloat of Electron.
5. Cross-Device Querying: Connect other devices (like phones or tablets) to the same Wi-Fi and open http://<PC-IP>:3000. Switch to Custom Token and paste your credentials to check status on the go.
6. Graceful Browser Fallback: If Edge is not found, the app gracefully falls back to opening the interface in your system's default browser.

💻 How to Use (Windows)

1. Download and extract the package.
2. Double-click codex-reset-dates-ui.exe.
3. The standalone desktop window will appear. Click "Query Reset Credits".
4. To Exit: Simply click the X button on the top right. The background server will shut down automatically.

🛠️ Building from Source

To run or build on non-Windows platforms (macOS / Linux):

1. Install Node.js (16.0.0+).
2. Clone the repository:

   git clone https://github.com/<your-username>/codex-reset-dates-ui.git
   cd codex-reset-dates-ui

3. Run the development server:

   node server.js

4. Build the executable (includes binary PE subsystem patching to hide console):

   npm run build

---

License / 许可证

MIT License.