一只陪你使用 Codex 的 Windows 白龙桌宠：在桌面查看任务状态、接收完成提醒、追踪账户额度和 Token 用量。基于 jingh12312-rgb/bailong-desktop-pet 持续改造，当前版本 v0.9.9 / UI87。
下载安装包 · 快速部署 · 全部新增功能 · 开发说明 · 迭代历史
- 修复任务结束后迟到的同回合日志把状态重新改为“进行中”，或把中断、失败误改为完成的问题（#3）。
- 旧 Token 数据库暂时不可读时保留迁移待重试状态，下一次刷新继续尝试，避免历史统计静默缺失（#4）。
- 编辑消息形成的日志分支归回原对话，清理无法跳转的重复条目与没有回合编号的旧提醒。
- 极简模式可临时展开正常卡片并返回；胶囊与极简额度圆保持原有配色、背景和字体，只加入进场填充。自主走动围绕手动放置点，默认仅水平移动。
- 状态水球改为穿插与快转交替，待机缓慢旋转；减少静置图标卡顿，修复持续工作动作里笔记本反复开合。
完整变化、安装方式及已知反馈见 v0.9.9 更新说明。目前仅提供 Windows x64 包；macOS 移植提议与 Linux 支持请求尚未合入。
进行中图标由三颗水球绕中心旋转、交错换位并轮流短暂黏连；完成、等待、中断与待命等状态各有清晰图形。浅色卡片和深色胶囊使用各自适配的颜色，图标在状态切换时平滑变形。动图来自实装控件连续帧：
本次累积发布还修复持续工作循环中的笔记本反复开合，统一数字、英文和中文字体，并改善闲聊服务配置与错误提示。完整说明见 v0.9.3 发布说明。提供完整 Windows 安装 ZIP 和程序更新 ZIP/JSON。
| 功能 | 实际表现 |
|---|---|
| Codex 实时状态 | 思考、编辑文件、运行命令、等待输入或审批、压缩上下文及完成；最多同时显示两个会话，更多会话轮换展示 |
| 不容易错过的完成提醒 | 完成后感叹号轻晃，再静止保留；点击确认或在 Codex 实际查看回复后消除；子会话不会重复冒充主会话提醒 |
| 会话跳转 | 点击气泡里的会话名，直接进入对应 Codex 对话 |
| 胶囊与卡片 | 闲置自动缩小，也可保持小胶囊；点击展开正常卡片，详情、聊天和设置集成在面板内 |
| 额度与重置 | 真实账户提供的 5 小时和周剩余额度、重置倒计时；胶囊显示一个开口弧额度圆 |
| Token 统计 | 全部、30 天、7 天柱状图；点击今日 Token 查看 24 小时曲线 |
| 独立日报 | 累计与昨日指标分组、昨日小时曲线、按模型筛选；27 本书的等量比较使用累计 Token 与真实文本计数估算 |
| 额外重置公告 | 接入 Codex Resets 公告；网站公告与账户实际重置分别显示 |
| 龙娘互动 | 25 段动作，含新增五段工作和五段互动；工作动作持续跟随稳定的 Codex 状态并自然收尾，自动动作静音 |
| 视频全屏让位 | 视频全屏时临时取消置顶；未读完成提醒优先，确认后继续让位；Firefox + B 站已通过实际播放采样 |
| 应用内更新 | 设置 → 维护 → 软件更新；自动只检查，手动下载安装，支持暂停续传与SHA-256校验 |
| 日常使用 | 登录自启、托盘找回、连接诊断、自定义角色、集成闲聊、一键安装升级与回退 |
| 胶囊展开正常面板 | 日报展开与收回 |
|---|---|
 |
 |
- 设置更好找：按面板、人物、Codex、素材、闲聊和维护分组，补齐当前功能说明与部署指南。
- 额外重置提示更准确：确认本机额度周期已重置后，公告自动让位给 Token 卡片；公告仍可手动查看，网站确认状态不被伪造。
- 桌面入口统一：应用和快捷方式使用正式白龙图标，升级时仅清理指向本项目受管安装目录的旧入口。
- 更新检查备用通道：遇到 GitHub API 限流时尝试受校验的备用下载路径；下载仍由用户主动发起。
- 程序更新与首次安装：发布包含完整安装 ZIP，以及供已支持客户端使用的程序更新包。
本次通过 74 个模块、759 项隔离回归及四档 DPI 原生交互验收。公网备用通道的实际网络表现仍取决于网络环境。
- 额外重置倒计时更清楚：主卡片用小时与分钟显示，整小时保留
00分，不足一分钟显示<1分钟；每分钟原位更新。点击时间打开本地详情，右上角可跳转公告网站。 - 修复待查看提醒残留：按具体已结束轮次识别 Codex 的稳定已读证据；看过旧回复后提醒消失，其他未读会话和正在运行的任务不会被误清除。
- 胶囊快捷按钮可自定义：支持 GPT 网页、Codex、闲聊、日报、刷新、设置或自定义网址；可选在 Codex 桌面端启动时同步启动桌宠，并防止手动退出后重复拉起。
- 本地验证：739 项回归、81 个模块编译核验及四档系统缩放下的原生交互、倒计时布局和按钮验收通过。
完整说明见本次更新说明。完整 Windows ZIP用于首次安装和从 v0.7.9 及更早版本升级；程序 ZIP/JSON仅供支持程序小包的现有安装使用。素材仍独立校验和维护。
- 更低开销：减少重复解码、异步取消旧动作、采用高精度帧时钟与按帧期限唤醒。固定高清场景CPU耗时降低约19%—22%，采样峰值RSS减少约60MiB；实际收益随场景变化。
- 持续状态动作：思考/阅读和执行采用原片进入、正向随机中段与原片收尾，完成提醒即时显示。
- 人物与卡片可分离：可隐藏人物仅留卡片，新增只显示额度百分比的极简模式；修复高DPI点击拖拽、鼠标捕获中断及卡片/日报联动闪烁。
- 默认轻量，高清可选：默认512px素材，设置 → 角色与动作可下载切换720px高清，画质偏好随升级保留；素材按内容ID独立缓存。
- 程序更新小包：支持小包的客户端可复用经过完整校验的素材；不匹配则走完整包。旧版首次升级本版仍需完整包。自动只检查，下载安装需主动点击。
708项本地回归、77模块编译核对、四档DPI原生交互、两档高清持续动作/画质切换及卡片合成像素验收通过；CI另外运行不依赖外部动画的检查。不是所有显卡/刷新率保证。
下载完整Windows ZIP用于首次安装/旧版升级；program.zip与program.json仅供内置更新器使用。高清资源在独立的materials预发布中维护，不改变软件稳定版Latest。
详见本次更新说明、快速部署与性能对照摘要。下方为历史版本记录，图文开发报告仍对应v0.6.50。
- 新增应用内更新：设置 → 维护 → 软件更新，可查看说明、主动下载安装和暂停续传。默认启动15秒后检查，之后每6小时检查；不自动下载或安装，可关闭自动检查并应用。校验完整包后交给原安装器，保留设置、聊天和回退版本，升级后清理完成缓存。
- 修复并接入上游 v0.4.1 的十段新动作，清理杂边、校准人物尺度并补齐待机衔接；五段工作动作对应新任务、执行、整理、阅读和检查。
- 专用工作动作默认每12秒检查续播，完整播完后至少停顿2秒；实时回合确认让长时间思考保持响应，确认信号不会重刷气泡文字。
- 小时 Token 曲线统一柔化，经过真实数据点、保留峰值和零值，入场沿同一路径推进。
- 会话名悬停和按下增强底色、描边与下划线；会话链接后台唤起、合并重复点击，避免阻塞界面。Codex自身加载耗时仍由Codex决定。
- 版本第三段用0—9，0.7.9之后为0.8.0。v0.7.2通过191项相关检查、63模块编译核对、四档缩放及真实安装包的本地升级验证；公开源码CI另运行无需动画素材的检查。
更新检查不需要GitHub登录；网络或匿名接口限流时可稍后重试。只接收本仓库公开稳定版的完整Windows包，旧公开版不会触发降级。首次从旧版升级到v0.7.2仍需手动下载本次安装包；以后可通过桌宠内入口更新。
具体说明见应用内更新记录和动画及交互更新记录。图文开发报告对应v0.6.50，后续新增内容以本节和迭代历史为准。
上图展示三圆进行中图标与完成、确认、等待和中断状态的连续变化。截图与界面 GIF 使用隔离演示数据，不包含真实聊天或密钥。
- 从 Releases 下载一键部署包，完整解压后运行其中的
.exe。 - 安装器为当前 Windows 用户安装、校验并启动，无需 Python 或管理员权限。
- 在本机安装并登录 Codex，发送一次消息。桌宠会自动发现本机数据，通常不需要重启 Codex。
- 若没有数据，在“设置 → 连接 → 检测连接与额度”检查各项能力；支持手动指定连接路径。
适用 Windows x64。新电脑必须使用自己的 Codex 登录；闲聊需要自行配置模型服务和密钥。新安装默认开启登录自启，可在设置关闭；升级保留原偏好。
安装目录：%LOCALAPPDATA%\Programs\BailongEnhanced。设置、聊天和统计目录：%LOCALAPPDATA%\BailongEnhanced。升级保留用户数据，安装管理提供回退及卸载入口。
- 额度来自本机登录的 Codex 账户，不代表 ChatGPT 网页全部模型的额度；未知数据不会当作 0%。
- Token 图表只覆盖本机可读取的 Codex 日志，不能汇总其他电脑或未记录的消耗。缓存输入可能包含在总量中，不等于计费金额。
- Codex Resets 是第三方公告来源，公告不代表你的账户已落实重置。
- 会话状态、已读及压缩识别依赖 Codex 本机文件和实时通道；Codex 更新可能影响兼容性。
- Firefox + B 站有真实全屏播放验证；其他浏览器和播放器依赖系统可访问性与窗口识别，尚未逐一实测。普通网页 F11 不应触发让位。
- 未读完成提醒高于视频让位。手动关闭置顶后，提醒不会自动把置顶重新打开。
- 已有桌面移动和原动作播放；新的自然交替行走、飞行动画尚未作为完成品装入。
- 本地统计读取本机数据；额度、公告、闲聊分别访问相应服务。安装包不携带开发者的登录、API 密钥、会话记录或 Token 数据库。
- 从源码运行与构建：Python 3.12、PySide6、角色素材准备、验证和打包。
- 通俗开发报告：下载仓库后用浏览器打开，可离线查看配图和 GIF；GitHub 页面展示 HTML 源码。
- 新增功能说明 和 完整迭代历史：当前能力与已被替换方案分别记录。
- 遇到问题请 提交 Issue，附版本、系统缩放、操作步骤；请先去掉截图和日志里的私密信息。
原项目：jingh12312-rgb/bailong-desktop-pet，本地改造基线为 v0.3.3，已合入上游 v0.4.1 的十段新动作。角色形象、原有动作及基础程序来自原项目；本仓库记录其上的界面、Codex 联动、数据统计、交互和部署增强。
发布者已确认取得本次源码、角色素材和安装包公开再分发授权。这不自动授予访问者商业使用、再分发或其他许可。原项目未随基线提供统一代码 LICENSE；本仓库不擅自将整项目标为 MIT。详见 来源与授权说明、保留的 原素材说明 及各依赖许可证。
本项目是独立第三方桌面程序，与 OpenAI、Codex 官方无隶属关系。