@narumitw/pi-usage

在 Pi 内部查看各模型服务商订阅配额、重置倒计时、API 余额与 Codex Fast 模式开关的用量面板。

安装命令
pi install npm:@narumitw/pi-usage
临时试用 / 替代安装命令
pi -e npm:@narumitw/pi-usage
挂接事件钩子与注册入口
session_start / session_shutdown / session_treemodel_selectturn_startbefore_provider_requestmessage_end
pi.registerCommand("usage")(TUI 与 RPC 模式均支持)pi.registerCommand("fast")(切换 Codex Fast 路由模式)ctx.ui.setStatus() / select() / notify()

1. 是什么

@narumitw/pi-usage 是 narumiruna 开发的厂商配额与计费状态查询扩展,要求 Pi 0.81.0 或更高版本。

它支持 OpenAI Codex、GitHub Copilot、OpenRouter、DeepSeek、Moonshot/Kimi、MiniMax、xAI、Vercel AI Gateway、Z.ai 等众多生态厂商,并严格区分“订阅限额”和“API 预付余额”两类口径。

2. 解决什么问题

同时在多个模型服务商间切换开发时,很难记住当前账号到底是用订阅配额还是按量余额、还剩多少额度、什么时候重置窗口。每次都要切去各个厂商后台页面查不仅繁琐,还容易踩进高耗 Fast 模式而不自知。

3. 作用原理(事件钩子与工具注册层)

结合会话/模型事件提取当前生效的 Provider 认证与 Base URL,在用户触发或轮次结束时向官方用量端点发起安全查询并渲染状态栏。

  • 扩展在 session_start 与 model_select 阶段同步 Pi 解析后的有效账号凭据与 Base URL(依赖 Pi 0.81.0+ 的端点验证保证,避免把认证头误发往非官方端点),缓存数据按活跃服务商与运行时账号严格隔离。
  • 运行 /usage 时在终端内展示当前账号的配额百分比、重置时间、API 余额与消费语义,支持有并发上限地刷新单个或全部已配置 Provider,并允许显式交互选择跨 Provider 查询对象。
  • 提供 /fast 命令管理支持的 Codex 模型 Fast 模式路由,以及在满足 OAuth 校验与显式二次确认后兑换 Codex 用量重置。

4. 怎么装与基本配置

  • 要求宿主 Pi >= 0.81.0;执行 pi install npm:@narumitw/pi-usage 安装后,直接在终端运行 /usage 即可查看当前激活模型的额度。
  • 个人偏好持久化于 ~/.pi/agent/pi-usage.json(不设项目级覆盖),通过 /usage 里的 Settings 菜单即可图形化调整并在保存后即时生效。
  • 注意 /usage 与 /fast 在 print 和 JSON 非交互模式下会被拒绝运行,跨账号/跨厂商查询需显式交互确认。

5. 和同类怎么选

它补全了可观测方向里最贴近开发者钱包的一块:实时账号配额与余额计量。

与同类方案的选型对照

聚焦机制差异与适用边界,结合自身运行环境判断是否引入或保留同类替代包。

对比对象 机制差异 怎么选
@langchain/langsmith-pi-extension LangSmith 统计的是每次调用的 token 账本和链路耗时;pi-usage 直接查厂商账号真实的剩余配额、重置倒计时与账户余额。 日常防超额、查各家 API 余额与配额窗口选 @narumitw/pi-usage;需要保存每次详细 Prompt/Tool 链路排查问题选 LangSmith。两者可同时安装。

同方向对比包与顺序阅读

@datadog/pi-plugin

Datadog 官方 Pi 插件,通过预配置 Datadog MCP Server 让 Agent 在终端里直接查线上日志、指标与 Trace。

阅读该包机制详评

@langchain/langsmith-pi-extension

LangChain 官方出品的 Pi 链路追踪扩展,把会话轮次、模型请求、工具调用与 token 用量自动上报至 LangSmith。

阅读该包机制详评

07 可观测与用量

回到该演进方向总论,查看完整痛点拆解、通用安装注意事项与全部收录清单。

返回方向总论页

看完「@narumitw/pi-usage」后的下一步

可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)

从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频

已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)

出口 1(配置单与实机演示制作中)

Coding Agent 实战交付课:如何可控地把想法做成线上产品

由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。

出口 2(实战交付课筹备中)