Repository navigation
Releases: T7moris/GPT-Niang
Release list
v1.3.5 · Windows / macOS
2026-10-20 Windows 音效修订（仍为 1.3.5）
- 检查系统播放结果，失败时停止旧播放并重试一次；设备忙时只保留最新待播放请求，避免点击积压。试听也在后台处理，保留按下／松开音效、音量、静音和个人导入。
- 已通过播放失败／异常／设备恢复／旧会话退出回归、40 项导入检查、完整 Windows 功能检查和共享后台测试；本机实际声音采样未发现削波或明显突跳。反馈电脑长时间闲置后的失声仍需实机确认。
- 本次仅替换 Windows 安装包和合并校验文件，macOS 安装包保持原文件。已装 1.3.5 的用户需手动下载此修订包覆盖安装；同版本不会触发自动升级。
Windows hotfix (2026-10-20): recover missing update-agent/binding.json and remove the Get-FileHash test dependency. Installer, updater, lifecycle, full WPF entrypoint, audio import and placement settings regressions passed. macOS asset unchanged. See PR #57.
1.3.5
- Windows 增加音乐律动，使用系统播放或可识别播放器的声音驱动下压、回弹、音响与灯球；保留拿起、甩放和落地动作。拖动直接响应鼠标，修复首拍移动等待、卡顿后的拖拍及播放器退出后卡在旧音源的问题。
- Windows 增加本地角色图库，支持导入图片、移除与撤销；人物和气泡可分别缩放，保持透明区域点击、原有配色和位置设置。
- 双平台增加按下／松开 WAV 音效导入、独立无声与试听；支持保存失败回退、静音和音量设置，默认仍使用内置音效。
- 增加可选的回答结束提醒；Windows 增加自动语录及 1／5／15 分钟间隔。保留手动操作优先、前后台切换、个人语录及退出清理。Windows 内置语录扩充到 39 句（新增 6 句），语录布局同步更新。
- 修复 Windows 额度缓存对象长期刷新时的内存增长；保留每秒读取。改进菜单外收起、合法负底边位置保存与窗口遮挡恢复。
- Mac 整合窗口跟随、固定位置与边缘裁切、后台交接和停止协议、更新就绪确认及失败回退；共享后台补齐归档读取容错和应用路径查找。
- 本版同时发布 Windows 与 macOS 安装包。两端差异：音乐律动、本地角色图库、自动语录、人物／气泡分别缩放为 Windows 独有；聊天速度面板与界面语言为 macOS 独有；WAV 音效导入与回答结束提醒双平台同步。macOS 包由 CI 构建，多屏／全屏／音频导入／更新回退仍需实机验证。
- 补齐新运行模块的安装包收录与关联回归。
下载与更新
下载 gpt-niang-usage-widget-v1.3.5-windows.zip，完整解压后运行根目录的 安装GPT娘.cmd。
旧版用户请先备份自定义内容，在原目录覆盖新版文件，再运行安装器；保留原有偏好。
仅支持 Windows 10 / 11，需要 Node.js 20 或更新版本及已登录的 Codex 桌面端。
SHA256：E7AD3F59A6EA7A777628618A7827B7EC345CF58C6E15D27A2A52C676953203AB（同时提供 SHA256SUMS.txt）。
致谢
以下按 GitHub 用户名排列，记录代码、方案、审查、问题复现与功能建议。感谢每一位参与者；已合并代码、待审方案和开放建议分别标明状态。
状态核对日期：2026-10-12。后续进展见对应 PR／Issue。
| 贡献者 | 具体贡献与关联 PR／Issue | 当前状态 |
|---|---|---|
| @Admilkk | PR #1：动态额度展示、账号快照隔离、单实例刷新、进程恢复与安装／生命周期回归；PR #16：Windows 内置更新、校验、失败回滚和中断事务恢复，整合于 PR #17；PR #20：修复 Windows 拖动与定位时原生尺寸回写导致的持续放大，改为只移动窗口、由 WPF 管理尺寸，并补充窗口内／桌面模式及不同 DPI 的连续拖动回归；PR #12 审查：指出个人额度的空分钟数会破坏 macOS 解码，并建议补充混合额度兼容测试。 | PR #1／#16／#20 已合并；PR #12 个人额度兼容审查已在 1.3.4 补齐 |
| @AkihiM | PR #34：Windows 图片图库、导入与撤销、缺失／损坏回退，以及小数音量恢复与相关测试。 | 图片与小数音量部分正在本地整合；其他改动待讨论 |
| @FusaishiHaruaki-afk | PR #8：真实 Go 账号的 30 天窗口复现、后端／Mac 适配及可选 GPT_NIANG_SDK 构建参数；PR #9：按窗口自身时长分类，覆盖槽位互换、月度边界与未知时长，并提供 Go 回归及 Swift 标题验证；相关实现与回归由 PR #10 整合。 |
PR #8／#9 已合并；当前标签沿用整合后的精确时长显示 |
| @gyb13451576 | Issue #11：提供 v1.3.1 混合 DPI 双屏环境中重启 Codex 后窗口塌缩为 2×2 的复现、DPI 反馈循环分析、固定设计尺寸与 DIP／物理像素换算方案，以及自动测试和实际 HWND 采样验证；关联 Issue #2。 | 问题报告保持开放；PR #20 已合入拖动／定位的尺寸回写修复，重启后的 2×2 塌缩仍待验证 |
| @Ifinty | PR #28：角色图片高质量缩放。 | 已纳入 Windows 本地测试 |
| @insightlacyrina | Issue #14：建议增加可持久化的「双击角色打开设置」开关，保留其他设置入口，并提出 macOS 简体中文界面建议；描述了连续点击被设置窗口打断的场景。 | 1.3.4 按维护者最新要求取消双击设置；简／繁体与跟随系统选择已实现 |
| @JCyxMio | PR #12：提出 Windows 多屏／混合 DPI 修复、Business individualLimit 个人额度显示，以及套餐标题、刷新按钮布局和命中修复；提供重复尺寸、额度解析及 WPF 验证。 |
方案整合于 1.3.4；DPI 定位以 PR #20 为准，并补齐 macOS 个人额度解码与显示 |
| @maolilup | PR #13：针对 Issue #2，提出使用固定设计宽高计算跟随／拖动尺寸以避免 DPI 尺寸漂移，并提供不同设计画布、缩放与目标 DPI 下的连续原生尺寸回归。 | 固定设计尺寸与回归已适配到 1.3.4；原生调用保持只移动 |
| @meaqua9420 | PR #3：SwiftUI／AppKit 原生 macOS 挂件、原有气泡／动画／配色／音效移植、窗口跟随与原生点击设置、菜单栏和可选登录启动；新增只读本地聊天速度面板、Mac CLI 与 worker 锁支持、应用构建及双平台 CI。 | 已合并 |
| @ShiroasabaMio | Issue #2：报告 v1.2.3 跨不同 DPI 显示器移动时挂件放大、跳动与错位，提供 120／144 DPI 复现、尺寸反馈循环分析、固定设计尺寸与统一 DPI 上下文建议及本机修复结果。 | 问题报告保持开放；PR #20 已合入拖动修复，跨屏场景继续验证，其他方案见 PR #12／#13 |
| @T7moris | 项目创作、维护、集成与发布。PR #5：Mac 跟随采样、限频与多窗口选择；PR #6：1.3.0 双平台安装包、版本与发布校验；PR #7：下载、安装、退出、迁移和卸载说明；PR #10：套餐自动识别与动态额度整合；PR #17：双平台内置更新、自动清理和 Mac 原生回退；PR #18：MIT 代码许可、素材使用边界及文档名称统一；PR #21：以 PR #20 为准整合 DPI、Business 个人额度、原生 Mac 交互与语言，补齐回归、旧偏好迁移和 1.3.4 双平台发布。 | 前述维护与整合 PR 已合并；PR #21 为 1.3.4 的统一整合 |
| @TheRuabit | PR #4：安装器直接按 UTF-8 解码插件列表 JSON，避免 Windows 默认编码造成中文安装路径乱码。 | 已合并 |
| @wzc20090621-gif | PR #15：Windows 独立桌面模式、跨屏拖动和两种模式的位置保存，解除主窗口归属／裁切并支持桌面置顶；增加本机管道额度通信与文件队列回退，修复安装后的 Node／MCP 绝对路径配置。 | 已合并 |
| @ytzha | PR #29：改用系统 WAV 播放器，保留按下／松开顺序与音量缩放。 | 正在 Windows 本机测试；补充资源清理与连续点击检查 |
本次完整致谢记录由 @T7moris 在 PR #19 中补充。
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。
macOS 下载
下载 gpt-niang-usage-widget-v1.3.5-macos-universal.zip，解压后把 GPTNiangMac.app 移入「应用程序」。macOS 包为 ad-hoc 签名、未公证，首次打开可能需要在「系统设置 → 隐私与安全性」中允许。
v1.3.4 · Windows / macOS
1.3.4
- 以 PR #20 为 DPI 定位基准：原生拖动／跟随只移动，尺寸由 WPF 管理；整合 PR #13 的固定设计画布与 PR #12 的物理像素／DIP 换算，防止连续尺寸漂移。
- 跳过启动、重启和最小化期间的临时小窗口，保留有效尺寸；按角色所在显示器工作区夹取位置，保留桌面模式、置顶偏好和原有更新保护。
- 整合 PR #12 的 Business 个人额度解析、刷新命中与布局；Mac 原生模型支持空分钟数个人额度，与时间窗口并存，过期横条与旧快照提示同步。
- 交互以 Windows 为准：取消 Mac 双击设置，连续点击保持普通反馈；统一 60%–250% 大小范围、大小预设、音效开关、隐藏设置按钮、刷新与气泡行为。
- Mac 原生桌面模式支持跨屏拖动、独立位置保存与默认关闭的置顶开关；切回跟随模式取消桌面置顶，保留 SwiftUI／AppKit，不移植 WPF／PowerShell。
- Mac 提供跟随系统／简体／繁体中文原生资源；用户语录不转换。语录权重可编辑并保留，恢复或覆盖前备份自定义语录。
- 保留 PR #19 的完整作者、问题报告和审查致谢，补充 PR #20 及本次适配状态；保留标准 MIT 与独立素材说明。
- 保留安装、进程恢复、33 句语录、内置更新、事务回退和自动清理的既有测试，新增连续 DPI、临时小窗口、原生点击路由、个人额度和语言兼容验证。
下载与安装
| 系统 | 下载文件 | 安装方法 |
|---|---|---|
| Windows 10 / 11 | gpt-niang-usage-widget-v1.3.4-windows.zip |
完整解压，运行根目录的 安装GPT娘.cmd |
| macOS 13+（Apple Silicon / Intel） | gpt-niang-usage-widget-v1.3.4-macos-universal.zip |
解压，把 GPTNiangMac.app 移入「应用程序」后打开 |
两边都需要 Node.js 20+ 以及已用 ChatGPT 账号登录的 Codex 桌面端。Mac 下载包不需要 Swift/Xcode，不注册 Windows MCP 插件。Windows 旧版用户可在备份自定义内容后覆盖原目录并重新运行安装器；Mac 用户退出旧应用后替换 .app，偏好保存在用户数据目录中。
Mac 应用仅 ad-hoc 签名，未使用 Developer ID、未经过 Apple 公证。首次打开可能被系统阻止；确认来源和校验后，按 Apple 官方说明 在「系统设置 → 隐私与安全性」确认打开。未提供 Apple 开发者签名凭据，不承诺免提示安装。
验证与范围
发布流程在 Windows/macOS 上运行共享运行时测试、Windows 安装与 WPF 测试、Swift 行为测试。Mac 通用应用含 arm64 / x86_64，构建后及解压后均验证签名与架构。两个包版本、完整性及共享后端资源均经核对。两边全部通过后才发布。
仍需真实 Mac 上验证快速拖动、多窗口切换及 Intel / 较旧 macOS 的界面行为。Mac 位置跟随目标 60 Hz，使用轮询，不保证零延迟。聊天速度是本地计数检查点之间的平均值，包含推理、网络与工具等待，不代表模型实时生成速度。
SHA256SUMS.txt 同时包含两个安装包的校验值；GitHub 自动附带的 Source code 是源码，不是安装包。
致谢
以下按 GitHub 用户名排列，记录代码、方案、审查、问题复现与功能建议。感谢每一位参与者；已合并代码、待审方案和开放建议分别标明状态。
状态核对日期：2026-10-12。后续进展见对应 PR／Issue。
| 贡献者 | 具体贡献与关联 PR／Issue | 当前状态 |
|---|---|---|
| @Admilkk | PR #1：动态额度展示、账号快照隔离、单实例刷新、进程恢复与安装／生命周期回归；PR #16：Windows 内置更新、校验、失败回滚和中断事务恢复，整合于 PR #17；PR #20：修复 Windows 拖动与定位时原生尺寸回写导致的持续放大，改为只移动窗口、由 WPF 管理尺寸，并补充窗口内／桌面模式及不同 DPI 的连续拖动回归；PR #12 审查：指出个人额度的空分钟数会破坏 macOS 解码，并建议补充混合额度兼容测试。 | PR #1／#16／#20 已合并；PR #12 个人额度兼容审查已在 1.3.4 补齐 |
| @FusaishiHaruaki-afk | PR #8：真实 Go 账号的 30 天窗口复现、后端／Mac 适配及可选 GPT_NIANG_SDK 构建参数；PR #9：按窗口自身时长分类，覆盖槽位互换、月度边界与未知时长，并提供 Go 回归及 Swift 标题验证；相关实现与回归由 PR #10 整合。 |
PR #8／#9 已合并；当前标签沿用整合后的精确时长显示 |
| @gyb13451576 | Issue #11：提供 v1.3.1 混合 DPI 双屏环境中重启 Codex 后窗口塌缩为 2×2 的复现、DPI 反馈循环分析、固定设计尺寸与 DIP／物理像素换算方案，以及自动测试和实际 HWND 采样验证；关联 Issue #2。 | 问题报告保持开放；PR #20 已合入拖动／定位的尺寸回写修复，重启后的 2×2 塌缩仍待验证 |
| @insightlacyrina | Issue #14：建议增加可持久化的「双击角色打开设置」开关，保留其他设置入口，并提出 macOS 简体中文界面建议；描述了连续点击被设置窗口打断的场景。 | 1.3.4 按维护者最新要求取消双击设置；简／繁体与跟随系统选择已实现 |
| @JCyxMio | PR #12：提出 Windows 多屏／混合 DPI 修复、Business individualLimit 个人额度显示，以及套餐标题、刷新按钮布局和命中修复；提供重复尺寸、额度解析及 WPF 验证。 |
方案整合于 1.3.4；DPI 定位以 PR #20 为准，并补齐 macOS 个人额度解码与显示 |
| @maolilup | PR #13：针对 Issue #2，提出使用固定设计宽高计算跟随／拖动尺寸以避免 DPI 尺寸漂移，并提供不同设计画布、缩放与目标 DPI 下的连续原生尺寸回归。 | 固定设计尺寸与回归已适配到 1.3.4；原生调用保持只移动 |
| @meaqua9420 | PR #3：SwiftUI／AppKit 原生 macOS 挂件、原有气泡／动画／配色／音效移植、窗口跟随与原生点击设置、菜单栏和可选登录启动；新增只读本地聊天速度面板、Mac CLI 与 worker 锁支持、应用构建及双平台 CI。 | 已合并 |
| @ShiroasabaMio | Issue #2：报告 v1.2.3 跨不同 DPI 显示器移动时挂件放大、跳动与错位，提供 120／144 DPI 复现、尺寸反馈循环分析、固定设计尺寸与统一 DPI 上下文建议及本机修复结果。 | 问题报告保持开放；PR #20 已合入拖动修复，跨屏场景继续验证，其他方案见 PR #12／#13 |
| @T7moris | 项目创作、维护、集成与发布。PR #5：Mac 跟随采样、限频与多窗口选择；PR #6：1.3.0 双平台安装包、版本与发布校验；PR #7：下载、安装、退出、迁移和卸载说明；PR #10：套餐自动识别与动态额度整合；PR #17：双平台内置更新、自动清理和 Mac 原生回退；PR #18：MIT 代码许可、素材使用边界及文档名称统一；PR #21：以 PR #20 为准整合 DPI、Business 个人额度、原生 Mac 交互与语言，补齐回归、旧偏好迁移和 1.3.4 双平台发布。 | 前述维护与整合 PR 已合并；PR #21 为 1.3.4 的统一整合 |
| @TheRuabit | PR #4：安装器直接按 UTF-8 解码插件列表 JSON，避免 Windows 默认编码造成中文安装路径乱码。 | 已合并 |
| @wzc20090621-gif | PR #15：Windows 独立桌面模式、跨屏拖动和两种模式的位置保存，解除主窗口归属／裁切并支持桌面置顶；增加本机管道额度通信与文件队列回退，修复安装后的 Node／MCP 绝对路径配置。 | 已合并 |
v1.3.3 · Windows / macOS
1.3.3
- 新增双平台内置更新：显示当前版本、手动检查和自动更新开关；默认开启，启动 30 秒后检查，此后每 24 小时检查官方更高正式版。
- Windows 整合 @Admilkk 的 PR #16，使用 WPF 原生设置菜单及独立更新助手，后台下载、校验 SHA256 与 ZIP 结构，挂件空闲时安装；保留原有菜单、桌面模式、位置与语录设置。
- macOS 使用 SwiftUI／AppKit、URLSession、CryptoKit 和独立 Swift 更新助手，校验正式版、签名、arm64／x86_64 后原子替换
.app；共享 Node 后端仅处理额度与聊天速度，不使用 Windows 更新实现。 - 新版注册／启动确认后自动清理上一版、失败版本和下载缓存；安装或启动失败先恢复旧版，恢复失败保留所需文件。清理失败下次启动重试，关闭自动更新也可清理已完成的事务。
- 修复 Windows 安装目录与截图、手动下载包共用外层文件夹时，更新误删个人文件的问题；保留并校验非程序文件，同名冲突在关闭挂件前取消。
- 补充独占锁、事务中断恢复、启动失败回退、占用后清理重试、归属与目录链接保护的验证，保留原有额度、动画、窗口跟随及安装测试。
- 仓库改名为 GPT-Niang，同步下载、反馈和更新地址；更新 Windows／macOS 使用说明，按已采纳贡献范围整理致谢。
- 1.3.2 及更早版本需手动完成首次升级；macOS 仍为 ad-hoc 签名，尚未配置 Developer ID 或 Apple 公证。
下载与安装
| 系统 | 下载文件 | 安装方法 |
|---|---|---|
| Windows 10 / 11 | gpt-niang-usage-widget-v1.3.3-windows.zip |
完整解压，运行根目录的 安装GPT娘.cmd |
| macOS 13+（Apple Silicon / Intel） | gpt-niang-usage-widget-v1.3.3-macos-universal.zip |
解压，把 GPTNiangMac.app 移入「应用程序」后打开 |
两边都需要 Node.js 20+ 以及已用 ChatGPT 账号登录的 Codex 桌面端。Mac 下载包不需要 Swift/Xcode，不注册 Windows MCP 插件。Windows 旧版用户可在备份自定义内容后覆盖原目录并重新运行安装器；Mac 用户退出旧应用后替换 .app，偏好保存在用户数据目录中。
Mac 应用仅 ad-hoc 签名，未使用 Developer ID、未经过 Apple 公证。首次打开可能被系统阻止；确认来源和校验后，按 Apple 官方说明 在「系统设置 → 隐私与安全性」确认打开。未提供 Apple 开发者签名凭据，不承诺免提示安装。
验证与范围
发布流程在 Windows/macOS 上运行共享运行时测试、Windows 安装与 WPF 测试、Swift 行为测试。Mac 通用应用含 arm64 / x86_64，构建后及解压后均验证签名与架构。两个包版本、完整性及共享后端资源均经核对。两边全部通过后才发布。
仍需真实 Mac 上验证快速拖动、多窗口切换及 Intel / 较旧 macOS 的界面行为。Mac 位置跟随目标 60 Hz，使用轮询，不保证零延迟。聊天速度是本地计数检查点之间的平均值，包含推理、网络与工具等待，不代表模型实时生成速度。
SHA256SUMS.txt 同时包含两个安装包的校验值；GitHub 自动附带的 Source code 是源码，不是安装包。
致谢
按已采纳贡献的覆盖范围、实现规模和对使用体验的影响排序，感谢：
- @Admilkk：额度展示、账号隔离、进程恢复与后台可靠性（PR #1），以及 Windows 内置更新和事务恢复的基础实现（PR #16，整合于 PR #17）。
- @meaqua9420：SwiftUI／AppKit 原生 macOS 版本、窗口跟随与聊天速度面板（PR #3）。
- @wzc20090621-gif：Windows 独立桌面模式、本机额度通信与 MCP 安装路径修复（PR #15）。
- @FusaishiHaruaki-afk：Go 账号实测、30 天额度适配、按窗口自身时长显示及 Mac 构建兼容（PR #8、PR #9）。
- @TheRuabit：Windows 安装器 UTF-8 解码修复（PR #4）。
Contributors
Assets 5
v1.3.2 · Windows / macOS
1.3.2
- Windows 新增独立桌面模式、菜单与启动等待改进；macOS 保留原有界面，共享额度后端与版本同步更新。
- 整合 @wzc20090621-gif 的 PR #15：增加独立桌面模式，聊天窗口最小化或关闭后继续显示，支持跨显示器拖动；两种模式分别记住位置。
- 新增「显示与位置」二级菜单，以互斥选项选择「仅在 Codex 窗口内」或「整个桌面自由拖动」。仅桌面模式显示「始终置顶」；切回窗口内立即取消桌面置顶，保留桌面模式的置顶偏好。默认窗口内模式，桌面置顶默认关闭。
- 移除菜单顶部标题与说明块；统一主菜单、二级菜单和设置项的淡紫色风格，设置勾选后保持菜单展开，预设大小与滑块同步，静音时禁用音量控制。
- 修复桌面模式缩放未实际适配工作区的问题，避免大尺寸挂件超出屏幕。
- Windows 启动时等待 Codex 可操作界面连续两次就绪后才显示挂件，加载画面不提前显示；主窗口替换时重新检测，已启动的独立桌面模式不受之后关闭聊天影响。
- 修复额度保存失败后已接收的管道请求无法结束的问题；为文件队列回退保留超时时间，避免管道无响应耗尽全部等待时间。
- 安装时生成 Node 和 MCP 脚本的实际绝对路径，保留原有偏好与自定义语录。
下载与安装
| 系统 | 下载文件 | 安装方法 |
|---|---|---|
| Windows 10 / 11 | gpt-niang-usage-widget-v1.3.2-windows.zip |
完整解压，运行根目录的 安装GPT娘.cmd |
| macOS 13+（Apple Silicon / Intel） | gpt-niang-usage-widget-v1.3.2-macos-universal.zip |
解压，把 GPTNiangMac.app 移入「应用程序」后打开 |
两边都需要 Node.js 20+ 以及已用 ChatGPT 账号登录的 Codex 桌面端。Mac 下载包不需要 Swift/Xcode，不注册 Windows MCP 插件。Windows 旧版用户可在备份自定义内容后覆盖原目录并重新运行安装器；Mac 用户退出旧应用后替换 .app，偏好保存在用户数据目录中。
Mac 应用仅 ad-hoc 签名，未使用 Developer ID、未经过 Apple 公证。首次打开可能被系统阻止；确认来源和校验后，按 Apple 官方说明 在「系统设置 → 隐私与安全性」确认打开。未提供 Apple 开发者签名凭据，不承诺免提示安装。
验证与范围
发布流程在 Windows/macOS 上运行共享运行时测试、Windows 安装与 WPF 测试、Swift 行为测试。Mac 通用应用含 arm64 / x86_64，构建后及解压后均验证签名与架构。两个包版本、完整性及共享后端资源均经核对。两边全部通过后才发布。
仍需真实 Mac 上验证快速拖动、多窗口切换及 Intel / 较旧 macOS 的界面行为。Mac 位置跟随目标 60 Hz，使用轮询，不保证零延迟。聊天速度是本地计数检查点之间的平均值，包含推理、网络与工具等待，不代表模型实时生成速度。
SHA256SUMS.txt 同时包含两个安装包的校验值；GitHub 自动附带的 Source code 是源码，不是安装包。
感谢 @meaqua9420（PR #3，macOS 原生版本）、@TheRuabit（PR #4，UTF-8 安装修复）、@Admilkk（PR #1，额度与后台可靠性），以及 @FusaishiHaruaki-afk（PR #8 / #9，Go 实测、按窗口时长适配及 Mac 构建兼容）。感谢 @wzc20090621-gif（PR #15，Windows 桌面模式、本机额度通信及 MCP 路径修复）。窗口跟随优化见 PR #5。
Contributors
Assets 5
v1.3.1 · Windows / macOS
1.3.1
-
2026-10-07 语录补发：同版本安装包内置作者确认的33句，补入token／储存三句、「高性能↓」「我不是吃白饭的大肥鱼」「我是啥龙？」等，移除此前要求删掉的句子；同步逐句排版和上游文字许可。
-
本次语录更新直接替换1.3.1的Windows与macOS下载包并更新校验值；已有自定义语录继续保留，可在语录设置中恢复内置语录以使用新版台词池。随机变色仍为全挂件0.5%、仅文字3%、原色96.5%。
-
Windows 与 macOS 按接口实际返回的任意有效额度窗口显示，包括 Go 的 30 天窗口；移除 5 小时／每周时长白名单。
-
自动识别 Free、Go、Plus、Pro、Team、Business、Enterprise、Edu 和未知套餐标识；不按套餐名称猜测窗口或访问权限。
-
Windows 复用原有两行气泡，单个窗口自动居中；保留重置时间切换、刷新、动画和额度警示配色。
-
增加双平台只读套餐检测脚本及 Windows「检测套餐.cmd」；区分未提供额度窗口、接口错误和 API Key 登录。
-
套餐标识改变时更新快照身份，避免继续显示旧套餐额度。
-
整合 @FusaishiHaruaki-afk 在 PR #8 中的 Go 适配和
GPT_NIANG_SDK可选构建参数；保留贡献者原始提交记录。 -
说明补充：整合 PR #9 的按窗口自身时长显示方案，沿用 1.3.1 的动态窗口实现与「30 天」标签；补充槽位互换、43800 分钟及 28–31 天窗口的回归验证，并补全贡献者致谢。
下载与安装
| 系统 | 下载文件 | 安装方法 |
|---|---|---|
| Windows 10 / 11 | gpt-niang-usage-widget-v1.3.1-windows.zip |
完整解压，运行根目录的 安装GPT娘.cmd |
| macOS 13+（Apple Silicon / Intel） | gpt-niang-usage-widget-v1.3.1-macos-universal.zip |
解压，把 GPTNiangMac.app 移入「应用程序」后打开 |
两边都需要 Node.js 20+ 以及已用 ChatGPT 账号登录的 Codex 桌面端。Mac 下载包不需要 Swift/Xcode，不注册 Windows MCP 插件。Windows 旧版用户可在备份自定义内容后覆盖原目录并重新运行安装器；Mac 用户退出旧应用后替换 .app，偏好保存在用户数据目录中。
Mac 应用仅 ad-hoc 签名，未使用 Developer ID、未经过 Apple 公证。首次打开可能被系统阻止；确认来源和校验后，按 Apple 官方说明 在「系统设置 → 隐私与安全性」确认打开。未提供 Apple 开发者签名凭据，不承诺免提示安装。
验证与范围
发布流程在 Windows/macOS 上运行共享运行时测试、Windows 安装与 WPF 测试、Swift 行为测试。Mac 通用应用含 arm64 / x86_64，构建后及解压后均验证签名与架构。两个包版本、完整性及共享后端资源均经核对。两边全部通过后才发布。
仍需真实 Mac 上验证快速拖动、多窗口切换及 Intel / 较旧 macOS 的界面行为。Mac 位置跟随目标 60 Hz，使用轮询，不保证零延迟。聊天速度是本地计数检查点之间的平均值，包含推理、网络与工具等待，不代表模型实时生成速度。
SHA256SUMS.txt 同时包含两个安装包的校验值；GitHub 自动附带的 Source code 是源码，不是安装包。
感谢 @meaqua9420（PR #3，macOS 原生版本）、@TheRuabit（PR #4，UTF-8 安装修复）、@Admilkk（PR #1，额度与后台可靠性），以及 @FusaishiHaruaki-afk（PR #8 / #9，Go 实测、按窗口时长适配及 Mac 构建兼容）。窗口跟随优化见 PR #5。
Contributors
Assets 5
v1.3.0 · Windows / macOS
1.3.0
- 新增 macOS 13+ 原生挂件，保留角色、按压动画、气泡、语录、配色和音效，支持菜单栏设置及可选登录启动。
- macOS 提供独立聊天速度面板，显示本地统计区间内的输出平均速度，不代表模型实时生成速度。
- macOS 跟随位置采样提高到目标 60 Hz，完整窗口发现保持 4 Hz；优化多窗口选择并降低状态文件写入频率。
- 修复 Windows 安装器读取插件列表时的 UTF-8 解码，避免系统默认编码造成中文路径乱码。
- Windows 与 macOS 分别提供安装包；macOS 包包含 arm64 / x86_64 通用应用，版本与校验文件统一发布。
下载与安装
| 系统 | 下载文件 | 安装方法 |
|---|---|---|
| Windows 10 / 11 | gpt-niang-usage-widget-v1.3.0-windows.zip |
完整解压，运行根目录的 安装GPT娘.cmd |
| macOS 13+（Apple Silicon / Intel） | gpt-niang-usage-widget-v1.3.0-macos-universal.zip |
解压，把 GPTNiangMac.app 移入「应用程序」后打开 |
两边都需要 Node.js 20+ 以及已用 ChatGPT 账号登录的 Codex 桌面端。Mac 下载包不需要 Swift/Xcode，不注册 Windows MCP 插件。Windows 旧版用户可在备份自定义内容后覆盖原目录并重新运行安装器；Mac 用户退出旧应用后替换 .app，偏好保存在用户数据目录中。
Mac 应用仅 ad-hoc 签名，未使用 Developer ID、未经过 Apple 公证。首次打开可能被系统阻止；确认来源和校验后，按 Apple 官方说明 在「系统设置 → 隐私与安全性」确认打开。未提供 Apple 开发者签名凭据，不承诺免提示安装。
验证与范围
发布流程在 Windows/macOS 上运行共享运行时测试、Windows 安装与 WPF 测试、Swift 行为测试。Mac 通用应用含 arm64 / x86_64，构建后及解压后均验证签名与架构。两个包版本、完整性及共享后端资源均经核对。两边全部通过后才发布。
仍需真实 Mac 上验证快速拖动、多窗口切换及 Intel / 较旧 macOS 的界面行为。Mac 位置跟随目标 60 Hz，使用轮询，不保证零延迟。聊天速度是本地计数检查点之间的平均值，包含推理、网络与工具等待，不代表模型实时生成速度。
SHA256SUMS.txt 同时包含两个安装包的校验值；GitHub 自动附带的 Source code 是源码，不是安装包。
感谢 @meaqua9420（PR #3，macOS 原生版本）、@TheRuabit（PR #4，UTF-8 安装修复），以及 @Admilkk（PR #1，额度与后台可靠性）。窗口跟随优化见 PR #5。
Contributors
Assets 5
v1.2.5
1.2.5
- 拖动主窗口时立即更新挂件位置，并同步窗口边界裁切；保留最小化、恢复与拖动角色时的行为。
- 为按压与回弹动画增加透明留白，避免点击时被矩形边界切断，保持角色大小。
- 额度气泡按当前机器的本地时间切换倒计时与固定重置时刻，支持缺失、过期重置时间。
- 优化语录的居中与换行，并改进客户端更新后的程序路径查找。
- 发布包使用可移动路径，不包含本机安装记录、运行状态、预览截图或未使用的旧全身图。
下载与更新
下载 gpt-niang-usage-widget-v1.2.5-windows.zip，完整解压后运行根目录的 安装GPT娘.cmd。
旧版用户请先备份自定义内容，在原目录覆盖新版文件，再运行安装器；保留原有偏好。
仅支持 Windows 10 / 11，需要 Node.js 20 或更新版本及已登录的 Codex 桌面端。
SHA256：4210EF8E1030E84A5E6DE305E858F8723FA29338221BEE151FB4B70C44069550（同时提供 SHA256SUMS.txt）。
Contributors
Assets 4
v1.2.4
1.2.4
- 根据接口实际返回的窗口折叠整条额度行，缺少重置时间时仍显示百分比；统一进度条边界并避免角色遮挡周额度条。
- 快照绑定账号身份哈希，切换账号或无法确认身份时清空旧额度，同账号刷新失败明确标记旧数据。
- 后台、MCP 与控制命令共用单实例 worker，合并同批请求，查询期间的新请求进入下一次刷新，避免旧数据覆盖和跨账号返回。
- 增加 worker 心跳、父进程绑定、退出恢复与进程状态清理；修复守护慢启动重复、Mutex 状态误判及进程句柄累积。
- 修复停用后目录迁移、缺失偏好目录的停用、守护退出等待及含特殊字符路径的启动项校验。
- 窗口更新采用事件触发和每秒兜底，后台网络查询仍为每 60 秒一次；增加 Windows 故障注入、WPF 布局与运行时并发测试。
下载与更新
下载 gpt-niang-usage-widget-v1.2.4-windows.zip，完整解压后运行根目录的 安装GPT娘.cmd。
旧版用户请先备份自定义内容，在原目录覆盖新版文件，再运行安装器；保留原有偏好。
仅支持 Windows 10 / 11，需要 Node.js 20 或更新版本及已登录的 Codex 桌面端。
SHA256：DA5F7E77984D292397C008A2E817B69C5EF917751C811A6186A1A7B333431328（同时提供 SHA256SUMS.txt）。
Contributors
Assets 4
v1.2.3
更新记录
1.2.3
- 修复独立守护启动后，角色被活动主窗口压住而看不见的问题。
- 挂件绑定真实主窗口，并保留其他应用对主窗口的遮挡。
- 主窗口销毁后清理挂件，由独立守护在新主窗口出现时恢复。
- 修复缩放与左右翻转组合导致气泡右侧裁切的问题。
- 优化分组设置菜单；额度数字加大，语录保持清晰字号。
- 支持当前用户登录任务、重开自动恢复、本次退出及永久停用。
- 首次公开打包：统一中文项目名称，安装配置按本机生成，默认状态目录改为当前用户的本地应用数据目录。
已知范围
仅支持 Windows；角色为静态半身配合按压动画。不包含 DSH 的动图导入、音频切片、触屏长按及复杂模块序列。