@alexanderfortin/pi-usage-lib
Pi编码代理用量监控扩展开发库
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@alexanderfortin/pi-usage-lib。 它的用途是：Pi编码代理用量监控扩展开发库 完整的 Skill 内容见：https://321skill.com/skills/alexanderfortin-pi-usage-lib/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'我想为我的DeepSeek API添加一个用量监控扩展，显示余额和剩余Token数。' 它会使用该库创建配置对象，调用 createUsageExtension 并传入 providerPrefix: 'deepseek'、statusKey: 'deepseek-usage'、label: 'DeepSeek'，以及 fetchUsage 和 renderStatus 回调，生成一个可直接导出的 Pi 扩展模块，所有事件注册、缓存和错误处理自动完成。
介绍
这个 Skill 解决了为 Pi 编码代理开发 API 用量监控扩展时重复编写样板代码的问题。在实际开发中，开发者需要手动处理 Pi 事件注册、API 提供商匹配、带沙箱感知的认证头构建、请求缓存、错误处理以及主题化页脚渲染等繁琐工作，导致每个扩展都要重复造轮子。
使用方式很简单，你只需要通过 bun 安装该库，然后调用 createUsageExtension 工厂函数，传入一个配置对象即可。配置对象包含 providerPrefix、statusKey、label、fetchUsage 回调（负责获取用量数据）和 renderStatus 回调（负责渲染展示）。之后就可以直接将其作为 Pi 扩展的默认导出，所有底层逻辑如事件注册、缓存管理、错误展示等均由库自动完成。
它非常适合需要为 Pi 编码代理集成第三方 API 用量监控的团队或个人，尤其是那些已经使用了 ZAI、DeepSeek 等 AI 服务提供商，并希望快速在 Pi 界面中展示余额、Token 消耗等信息的开发者。对于维护多个 API 监控扩展的场景，该库能显著减少重复代码，统一错误处理和缓存策略。
建议在开发新监控扩展时优先使用此库来统一架构。需要注意的是，它主要面向 Pi 扩展的开发者，使用前需要熟悉 Pi 扩展的基本注册机制，并且当前仅支持 usage-monitoring 类型的扩展，不适用于其他类型的 Pi 功能开发。
常见问题
如何安装这个库？
在终端中运行 `bun add @alexanderfortin/pi-usage-lib` 即可安装。
需要预先安装 Pi 编码代理吗？
是的，该库是 Pi 扩展的共享库，必须在 Pi 编码代理环境中使用。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/alexanderfortin-pi-usage-lib/raw/index.md 读取 @alexanderfortin/pi-usage-lib 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/alexanderfortin-pi-usage-lib/raw/index.md（查看排版版本）