T7moris / GPT-Niang

# GPT-Niang（GPT 娘）
让一只白发紫瞳的小龙娘，陪你看 Codex 的剩余额度。
**Windows / macOS 桌面挂件 · 自动识别套餐与额度窗口 · 中文语录 · 当前正式版 1.3.5**
1.3.5 同时发布 Windows 与 macOS 安装包：Windows 新增音乐律动、本地角色图库、自动语录，人物与气泡可分别缩放；双平台新增 WAV 音效导入与回答结束提醒；macOS 同步窗口跟随／边缘裁切、后台交接与更新就绪回退。两端功能差异见下文。
**下载最新版** · Windows 安装 · macOS 安装 · 更新记录 · 反馈问题
## 能做什么
- **点角色看额度**：按接口实际返回的窗口显示剩余百分比，例如 5 小时、每周、30 天；单个窗口在原气泡内居中，横条越满，剩余额度越多。成功查询时折叠未返回的整条窗口；查询失败会显示异常，重置时间为空时仍保留百分比。
- **点气泡看语录**：再点收起，显示完成约 5 秒后也会自动收起；支持编辑自己的语录。
- **按压与回弹**：半身角色、分段气泡动画和轻提示音，可调整音量或静音。
- **拖动与缩放**：靠近左右边缘吸附，角色面向窗口内侧，文字保持正向。
- **跟随主窗口**：失去焦点时保留；其他窗口覆盖主窗口时，也会覆盖挂件。最小化或隐藏主窗口后挂件隐藏。Windows 和 Mac 均可在设置中关闭跟随，让挂件留在桌面。
- **登录启动**：Windows 安装器默认配置自动启动和主窗口重开后的恢复；Mac 需要自行开启设置中的「登入 Mac 時自動開啟」。
- **Mac 聊天速度面板**：从菜单栏打开，显示本地统计区间内的输出平均速度，包含推理、网络和工具等待，**不代表模型实时生成速度**。
这是独立的桌面挂件；Windows 同时提供额度查询插件，Mac 为原生应用，不注册 MCP 插件。它读取当前 Codex 登录账户的额度，**不会为读取额度创建聊天或调用模型**。它不是 OpenAI 或 DeepSeek 的官方项目。
### 两端一致的操作
| 操作 | Windows / macOS 行为 |
| --- | --- |
| 单击、双击、连续点击角色 | 普通点击：看额度／续时；开启点击切换选项后切换语录与收起；均有按压和回弹 |
| 点击气泡 | 额度 → 语录 → 收起；刷新按钮单独执行刷新 |
| 右键角色 | 原生菜单；不会把连续点击转换为设置操作 |
| 调整大小 | 60%–250%；80%、100%、140% 预设；拖动和定位只移动窗口 |
| 桌面模式 | 跨屏自由拖动；置顶默认关闭，仅此模式可切换；与窗口模式分别保存位置 |
| 刷新与语录 | 刷新不强制打开气泡；支持 `3 | 语录` 权重，恢复前备份自定义文件 |
| Business | 个人额度优先，另显示最短时间窗口；其余窗口在详情中保留；个人额度不是公司总余额 |
Mac 设置使用 SwiftUI，菜单、窗口与拖动使用 AppKit；没有运行 PowerShell、WPF 或 Windows 更新器。界面可选择跟随系统、简体中文或繁体中文，切换语言不会改写自定义语录。安装／登录启动入口、Windows MCP 插件和 Mac 聊天速度面板保持各平台现有支持范围。
### Windows 与 macOS 功能差异（1.3.5）
两个平台共享额度解析和自定义语录，但本版新增功能并非全部同时提供：
| 功能 | Windows 1.3.5 | macOS 1.3.5 |
| --- | --- | --- |
| 音乐律动 | ✅ 新增 | ❌ 本版未包含 |
| 本地角色图库（导入／移除／撤销） | ✅ 新增 | ❌ 本版未包含 |
| 人物与气泡分别缩放 | ✅ 新增 | ❌ 仅支持整体大小 |
| 自动语录（1/5/15 分钟） | ✅ 新增 | ❌ 本版未包含 |
| WAV 音效导入（按下／松开） | ✅ | ✅ 同步新增 |
| 回答结束提醒 | ✅ | ✅ 同步新增 |
| 窗口跟随／边缘裁切／后台交接 | ✅ 原生 follower + 遮挡恢复 | ✅ 轮询 follower，实现不同、无 DWM cloak |
| 聊天速度面板 | ❌ | ✅ macOS 独有 |
| 界面语言（跟随系统／简中／繁中） | ❌ | ✅ macOS 独有 |
| DPI、遮挡恢复、长刷新内存修复 | ✅ Windows 专项 | — 无对应实现 |
**未同步与待验证：** macOS 包由 CI 构建，尚未在实机验证多屏、Stage Manager、全屏 Space、音频导入和更新回退；macOS 更新就绪会额外要求配额 worker 心跳，Node 在非默认路径时可能触发回退，建议先在非关键环境验证。Windows 的音乐律动、图库、自动语录、独立缩放本版没有移植到 macOS；macOS 的聊天速度面板和界面语言也没有加入 Windows。
## 套餐适配与自动检测
Windows 与 macOS 共用按实际返回值解析的后端。自动识别 Free、Go、Plus、Pro、Team、Business、Enterprise、Edu；遇到未来套餐保留其标识。**套餐名称不决定显示哪些窗口，也不代表额外授予接口权限**。Go 的 30 天窗口是 `43200` 分钟；其他合法时长也会显示为小时、天或分钟，不再被白名单过滤。`primary` / `secondary` 只是接口槽位，窗口按自身时长识别并排序；`43800` 等非 30 天时长同样可显示。整合 PR #9 时沿用当前代码和准确时长标签，因此 Go 保持「30 天」，单个窗口仍居中。两个平台保留原来的气泡外观、单行居中、刷新、重置时间和动画行为。
Windows 双击根目录 `检测套餐.cmd`，或执行 `powershell.exe -NoProfile -File .\gpt-niang-usage\Detect-Plan.ps1 -Json`。从源码检查 Windows / macOS 均可执行：
 [code] 
Mac 已安装应用也可执行（将应用路径替换为自己的安装位置）：
 [code] 
脚本通过同一套只读 `account/read` 与 `account/rateLimits/read` 自动读取套餐标识，优先使用额度桶中的 `planType`，未提供时使用账号返回的套餐；不读取或输出令牌、邮箱和聊天。切换套餐后下一次刷新会重新识别，套餐变化会使旧快照失效。API Key 登录、未登录、接口查询失败和成功但没有额度窗口会分别提示，成功但没有窗口不被当成网络错误。
PR #8 的 Go 实测表明原接口已经成功返回 30 天窗口，原后端的 `[300,10080]` 白名单和 Windows 固定按分钟数查找两行才是显示失败的原因。切换套餐可能改变 `planType`、窗口时长、窗口数量和重置时刻；额度读取方法仍是同一个。实际 HTTP／登录错误应根据返回错误单独检查，不能仅凭套餐名称判断。协议字段见 OpenAI Ap