pi-usage

Pi Coding Agent 用量与配额可视化插件

产品简介

pi-usage 是一款专为 Pi Coding Agent（极简 Agent Harness）开发的环境扩展，在 Pi 编辑器内部实时显示已配置的 AI 服务商用量与配额信息。当开发者同时使用多个 AI 服务商时，往往难以准确掌握各服务商的 API 配额消耗进度，容易在不知情的情况下触发限额导致任务中断。pi-usage 将用量数据直接嵌入 Pi 工作界面，提供 /usage 命令行查询、固定 Widget 置顶显示、状态栏实时刷新三种交互方式，让开发者对每一分配额消耗都心知肚明，合理规划任务分配，避免因额度耗尽造成的开发中断。

核心能力

多服务商并行支持：支持 Z.ai / GLM Coding Plan、Kimi Coding Plan、DeepSeek 和 OpenRouter 四家主流 AI 服务商，配置哪个就显示哪个，未配置的绝不会出现，避免界面干扰。OpenAI / Anthropic / Google Gemini 不在支持范围内——因其使用未公开的私有逆向接口，存在随时失效风险，这是主动拒绝的设计选择。

三种用量展示方式：/usage 命令在终端输出详细配额表格；/usage pin 将 Widget 固定在编辑器顶部，自动每 2 分钟刷新；状态栏实时显示当前模型名称与用量百分比，三种方式互补。

模型级别细粒度追踪：除总配额外，单独追踪 MCP 工具调用配额和 Web Search 配额，显示当前使用的模型名称与历史切换记录（如 glm-5.3、glm-5.2），方便识别哪个模型消耗最快。

进度条可视化：表格输出中包含 ASCII 进度条，直观显示配额消耗进度，一眼判断是否需要续费或切换服务商。

优雅降级机制：某一服务商用量接口查询失败时标记为 error/stale，用量显示为 unavailable，但不影响正常模型请求，故障不扩散。

安装配置

前提条件：Node.js 20 及以上，Pi Coding Agent 已配置至少一个支持的服务商。安装命令：pi install npm:@imdlan/pi-usage，更新执行 pi update --extensions，移除执行 pi remove npm:@imdlan/pi-usage。

各服务商均需在 Pi 中配置对应的 API Key：Z.ai / GLM 提供 base URL 与 API Key；Kimi Coding Plan 支持 OAuth 或 Console API Key；DeepSeek 与 OpenRouter 直接提供 API Key 即可。

使用步骤

第一步，确保 Pi Coding Agent 已安装 Node.js 20+ 且至少配置了一个支持的 AI 服务商。

第二步，执行 pi install npm:@imdlan/pi-usage 完成插件安装，系统自动识别已配置的服务商。

第三步，在 Pi 终端输入 /usage 查看所有已配置服务商的详细用量表格，包括总配额、已用、剩余与重置时间。

第四步，输入 /usage pin 将 Widget 固定在编辑器顶部，系统自动持续刷新，状态栏同步更新当前模型与用量百分比。

第五步，切换任务前先查看 /usage，确认当前服务商配额充足，必要时提前切换到其他服务商，避免任务中途因额度耗尽中断。

适用场景

多服务商并发管理、预算管控与配额预警、团队共享账户用量核查、API 依赖故障排查、CLI 编程效率提升。

适用人群

使用 Pi Coding Agent 进行开发的程序员和 AI 开发者；通过多个 AI 服务商 API 并行开发、需要集中管理配额的独立开发者和小型团队；对 API 成本敏感、希望主动管控用量避免账单超预期的用户。

工作原理

pi-usage 只使用官方文档化的 API：DeepSeek 的 GET /user/balance 和 OpenRouter 的 GET /api/v1/key、GET /api/v1/credits 均有官方文档；Z.ai 和 Kimi 的端点虽属未公开接口，但均派生自官方内置插件。所有接口失败均做静默降级，用量不可用时不影响模型请求，且每次失败都有明确状态标记。

官方链接

Pi 扩展主页：https://pi.dev/packages/@imdlan/pi-usage?name=pi-usage npm 包：https://www.npmjs.com/package/@imdlan/pi-usage 版本 0.5.0 · Apache-2.0 许可证 · 115.5 KB · 月下载 1930