@frostime/pi-provider-usage0.3.0

A query-only Pi extension for provider usage, quotas, and balances.

frostime Published 7 days ago MIT ~506 downloads/mo

Untested on omp

This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.

Reports 0

No reports yet.

Readme

@frostime/pi-provider-usage

一个只负责查询 Provider 用量的 Pi 扩展，Fork 自 pi-usage 修改。

使用

/provider-usage:print                   打印当前模型的 Provider
/provider-usage:print codex             打印 OpenAI Codex
/provider-usage:print all               打印所有已配置且受支持的 Provider

/provider-usage:overlay                 用浮层显示当前模型的 Provider
/provider-usage:overlay opencode-go     在浮层中显示 OpenCode Go
/provider-usage:overlay all             在浮层中显示所有已配置且受支持的 Provider
/provider-usage:overlay close           关闭浮层

输入 /provider-usage:print 或 /provider-usage:overlay 后补全参数。补全只列出已配置的、内置支持的 Provider 和 all；overlay 命令另外提供 close。codex 是 openai-codex 的简写，完整 ID 也可使用。查询其他 Provider 不会切换当前模型。

print 只查询一次，以纯文本报告结果，适用于 TUI 和 RPC 模式，不打开面板。

overlay 在右侧显示一个浮层，内部显示查询进度和快照时间，只在 TUI 模式可用。

Overlay

快捷键	操作
`Ctrl+Alt+R`	重新查询当前范围；`all` 会重新检查已配置的 Provider
`Ctrl+Alt+Q`	关闭浮层，并取消尚未完成的查询
`Ctrl+Alt+↑/↓`	滚动长结果

再次执行 overlay 命令会把已有浮层切到新范围，不叠加窗口。close、模型或会话切换、退出后都会清理浮层和输入监听。

从 npm 安装

pi install npm:@frostime/pi-provider-usage

从 GitHub 安装

pi install git:github.com/frostime/pi-provider-usage

本地加载

需要支持非抢焦点浮层、终端输入监听和有效认证地址校验的 Pi；开发与测试使用 Pi 1.0.2。

# 在本仓库目录执行，仅本次启动加载
pi -e .

# 或注册为个人本地扩展
pi install .

直接加载 TypeScript 源码，无需构建。没有第三方运行时依赖；Pi 提供宿主包。

开发检查：

npm ci --ignore-scripts
npm run check

支持范围与限制

保留上游的 17 个 Provider ID，完整列表见 Provider 说明。不同 Provider 分别返回订阅额度、余额或支出，不将不同币种和计费语义混合。

原生 openai ChatGPT OAuth 只能显示认证状态和用量网页链接，不能查询数值额度；openai-codex 可以查询数值额度。OpenAI API-key 用量查询不受支持。
Fireworks 只有一个可见计费账号时自动查询；多个账号时提示需要指定账号。当前版本没有账号选择功能，不默认选第一个，也不汇总。
一个 Provider 查询使用 Pi 当前解析出的认证，不遍历其他已保存账号。
自定义或代理地址的凭证不会被转发到官方用量接口。官方接口可能变化，返回的数据也可能有延迟。

查询、超时与取消行为见操作说明。

安全与来源

扩展与 Pi 使用相同的进程权限，只加载你信任的代码。认证仅用于请求匹配的官方接口；保留地址校验、请求边界认证复核、错误脱敏和响应大小限制，拒绝 HTTP 重定向。结果不保存密钥或令牌。