洛天依 Codex 额度气泡

Windows 版 Codex 桌宠旁的本地额度气泡，显示 5 小时和每周额度的剩余比例及重置倒计时。

启动与依赖

需要 Windows、Python 3.10+、Tkinter 和 Pillow。插件安装并信任 SessionStart hook 后，新建或恢复 Codex 会话时会启动气泡；右键退出后，在下一次新建或恢复会话时再次出现。正在进行的聊天不会重新触发启动。

安装目录可放在 ~/.codex/plugins/luotianyi-quota。启动器优先使用本机 ~/.codex/luotianyi-quota/runner.json 指定的 Python，随后尝试 PATH 和当前 Conda 环境。该文件只用于本机配置，不包含在仓库中。

本机设置

设置文件：~/.codex/luotianyi-quota/overlay_settings.json。没有设置文件时使用代码内默认值。以下是可选配置示例；请按自己的屏幕和桌宠调整：

{
  "bubble_scale": 0.58,
  "cloud_opacity": 0.3,
  "offset_x": 0,
  "offset_y": -7,
  "low_quota_threshold": 30,
  "force_side": "auto",
  "background_mode": "transparent",
  "progress_style": "candy",
  "refresh_seconds": 60,
  "poll_ms": 200
}

bubble_scale 可设为 0.5–1.5，cloud_opacity 可设为 0–1。offset_x、offset_y 是桌面逻辑像素，会按屏幕缩放换算。low_quota_threshold 是红色提醒阈值，任一有效额度剩余比例小于或等于它时提醒；允许 1–80，代码默认 20。

气泡比例、透明度、位置和左右侧设置保存后约 1 秒生效。更改提醒阈值等其他设置后，重新启动气泡。poll_ms 控制跟随桌宠的检查间隔（100–5000 毫秒）；refresh_seconds 控制查询额度的间隔（60–3600 秒）。

诊断

启动错误见本机 hook-error.log，运行错误见 runtime.log 和 runtime_status.json；这些文件位于 ~/.codex/luotianyi-quota/，不会提交到仓库。日志不记录聊天提示词或令牌。

在插件 runtime/ 中运行 python test_logic.py、python test_rgba_render.py 和 python diagnose.py。diagnose.py 只读取桌宠位置等诊断信息。