不用打开网页，Pucoding API Key 的美元消耗就在桌面一角。
立即安装 · Pucoding 入口 · 30 秒上手 · 更新日志 · 隐私说明 · 支持项目
PucodingUsageWidget 是一个为 Windows 设计的紧凑桌面用量小组件。它通过 Pucoding 的只读 Key Portal 接口查询指定 API Key 的用量，把今日消费、累计消费、剩余额度和调用次数集中显示在一个接近歌词小窗口大小的界面中。
无需注册额外账号，也没有分析服务：API Key 由 Windows DPAPI 加密后，仅保存在当前 Windows 用户的本机配置目录中。
| 💵 今日消费 桌面直接查看美元消耗 |
📊 额度概览 累计消费与剩余额度同屏 |
📌 灵活置顶 像歌词窗口一样随时可见 |
🔐 本地保护 API Key 使用 DPAPI 加密 |
Pucoding 是面向 AI 编程工作流的 API 服务入口，官网将其定位为“AI 编码网关”。它以兼容 OpenAI 的调用方式连接不同模型与上游服务，并在同一套网页控制台中集中提供 API Key 管理、请求用量、额度与计费、接入文档和服务状态等能力。
| 官方入口 | 地址 | 适合什么时候使用 |
|---|---|---|
| Pucoding 官网 | pucoding.com | 了解服务、登录账号并进入控制台 |
| Key 用量查询页 | pucoding.com/keys | 临时在浏览器中查询单个 API Key 的用量 |
| 接入文档 | pucoding.com/docs | 配置客户端、查看接口和模型接入方式 |
| 服务状态 | pucoding.com/status | 查看当前服务与模型可用状态 |
Important
模型范围、价格、倍率、套餐与服务规则可能随平台调整，请始终以 Pucoding 官网 的实时信息为准。不要把带有完整 API Key 的网址分享给他人，也不要在 Issue、截图或聊天记录中公开 Key。
PucodingUsageWidget 不是 API 中转服务，也不销售 Key 或套餐。它只是把 Pucoding Key 用量网页中的核心数据整理成一个常驻桌面的小窗口：使用你自己的 API Key，直接向 https://pucoding.com 查询今日消费、累计消费、剩余额度和请求次数，不经过作者服务器。
如果你还没有使用过 Pucoding，可以先访问官网了解服务和接入方式；如果已经有可用 Key，可以先在 Key 用量查询页 核对数据，再把同一个 Key 填入本小组件。网页适合查看完整信息，小组件则适合工作时持续留意消耗。
- 紧凑但信息完整：默认窗口仅
280 × 190，保留今日消费、累计消费、剩余额度和调用次数。 - 自动刷新：每 60 秒查询一次，也可以点击右上角按钮立即刷新。
- 置顶可切换：默认保持在其他窗口上方，需要安静工作时可一键取消置顶。
- 无需额外账号：直接使用已有的
sk-...API Key，不创建新的中间账号。 - Key 不进入 URL：请求使用
x-api-key请求头，避免 Key 出现在地址栏或普通访问记录中。 - 无第三方依赖：源码版本仅使用 Python 标准库；稳定版提供无需安装 Python 的独立 EXE。
- 启动小组件，在设置窗口粘贴
sk-开头的完整 API Key。 - 点击“保存并查询”，等待今日消费与额度信息出现。
- 点击“取消置顶 / 置顶”切换窗口层级，点击
↻手动刷新。
Tip
API Key 会绑定当前 Windows 用户加密保存。换电脑或换 Windows 用户后，需要重新输入一次。
- 前往 Releases，下载最新的
PucodingUsageWidget-v*.zip。 - 完整解压 ZIP，不要直接在压缩包预览窗口中运行。
- 双击
PucodingUsageWidget.exe。
稳定版已经包含运行环境，接收方不需要单独安装 Python。
Note
当前 Release 尚未购买商业代码签名证书，Windows SmartScreen 可能显示“未知发布者”。请只从本仓库 Releases 下载，并核对发布页提供的 SHA-256 校验值。
git clone https://github.com/LHHugh/PucodingUsageWidget.git
cd PucodingUsageWidget
python .\pucoding_widget.py源码运行需要 Windows 10/11 与 Python 3.10 或更高版本，且安装时包含 Tkinter。项目本身不需要 pip install。
| 能力 | 状态 | 说明 |
|---|---|---|
| 今日消费与今日请求数 | ✅ | 从 Pucoding Key Portal 用量接口读取 |
| 累计消费与累计请求数 | ✅ | 使用 API Key 的累计统计字段 |
| 剩余额度 | ✅ | 未设置 Key 额度时显示“无限制” |
| 60 秒自动刷新 | ✅ | 手动刷新不会叠加多个计时器 |
| 窗口置顶切换 | ✅ | 默认置顶，可随时取消 |
| API Key 本机加密 | ✅ | Windows DPAPI，限定当前用户解密 |
| Windows 10 / 11 64 位 | ✅ | Release 稳定包的目标平台 |
| macOS / Linux | — | 当前版本不支持 DPAPI 与 Windows 窗口行为 |
PucodingUsageWidget 不包含分析服务、广告或额外的数据中转服务。完整说明见 PRIVACY.md。
| 数据或请求 | 用途 |
|---|---|
%APPDATA%\PucodingWidget\config.json |
保存经 Windows DPAPI 加密后的 API Key |
GET /api/v1/key-portal/summary |
查询 Key 状态、累计用量与额度摘要 |
GET /api/v1/key-portal/usage/summary |
查询今日消费、请求数与用量汇总 |
API Key 只会作为 x-api-key 请求头发送到 https://pucoding.com。请不要在 Issue、截图、日志或聊天记录中公开自己的完整 Key。
当前稳定版：v1.0.0 · 查看发布说明 · 完整更新日志
项目使用语义化版本：
- 主版本
X：存在不兼容的配置、接口或运行方式调整。 - 次版本
Y：向后兼容的新功能与明显体验升级。 - 修订版本
Z：向后兼容的问题修复、兼容性和文档改进。
维护者可运行 tools/package-release.ps1 生成与 app.json 版本号一致的发布包。
- 今日消费、累计消费与剩余额度。
- 自动刷新、手动刷新与置顶切换。
- Windows DPAPI 本地加密。
- 无需 Python 的单文件 EXE。
- 开机自启动开关。
- 多 Key 切换与合计视图。
- 自定义刷新间隔与透明度。
路线图用于表达探索方向，不代表确定的交付日期。欢迎在 Feature Request 中分享真实使用场景。
- 遇到问题：提交 Bug Report。
- 想要新功能：提交 Feature Request。
- 准备贡献代码：请先阅读 CONTRIBUTING.md。
- 发现安全或隐私问题：请按照 SECURITY.md 私下报告。
提交问题时，请附上 Windows 版本、应用版本、复现步骤和必要截图；务必遮盖完整 API Key、消费明细与其他私人信息。
如果这个小组件帮你少开了几次网页、及时发现了异常消耗，或者只是让桌面更顺手，欢迎给仓库点一个 Star；也可以通过支付宝自愿打赏，支持后续维护与体验改进。
打开支付宝 · 扫一扫
金额随意，感谢你的支持；点击图片可查看原图。
Note
打赏完全自愿，不会解锁额外功能，也不影响问题反馈和正常使用。上面的二维码用于支持 PucodingUsageWidget 作者，不是 Pucoding 官方收款、账号充值、套餐购买或账单支付入口；Pucoding 相关付款请只在其 官方网站 内完成。请勿在付款备注中填写 API Key 或其他敏感信息。
本项目是社区制作的非官方工具，与 Pucoding 无隶属或授权关系。Pucoding 名称与相关服务归其权利人所有；接口路径、响应字段和服务规则由服务提供方控制，服务端更新可能影响查询功能。
PucodingUsageWidget · 用量一眼可见
Made with care by LHHugh