Pi New API Balance

在 Pi 的终端底部持续显示 New API 账户余额，并在检测到结算扣款时播放余额滚动动画。

以下截图来自隔离的本地 mock 服务，余额、账号状态和时间均为合成演示数据，不对应任何真实账户。

检测到扣款时，余额会滚动下降，并显示红色差额：

功能

• 支持用户配置任意 New API 站点的 Base URL
• 在 Pi 页脚显示当前余额，不占用额外面板
• Pi 启动时及每隔 5 分钟自动刷新
• 每轮 Agent 完全结束后立即刷新，并在 1 秒、3 秒和 6 秒时补查异步结算
• 检测到余额下降后立即取消剩余补查
• 余额在约 800 毫秒内滚动至新值，并以红色显示扣款差额 3 秒
• Session 切换、/reload、新对话、手动刷新和退出时安全清理后台任务
• 自动重新登录失效的 Session
• 兼容旧版猫佬余额扩展配置迁移

安装

要求已安装支持 Pi Package 的新版 Pi。推荐从 npm 安装：

pi install npm:pi-newapi-balance

也可以直接从 GitHub 安装开发仓库版本：

pi install git:github.com/zxbdzh/pi-newapi-balance

重启 Pi，或者在已打开的 Pi 中运行：

/reload

更新 npm 安装的插件：

pi update npm:pi-newapi-balance

卸载 npm 安装的插件：

pi remove npm:pi-newapi-balance

使用 GitHub 安装时，将上述来源替换为 git:github.com/zxbdzh/pi-newapi-balance。

使用

首次运行：

/newapi-login

按持续显示的三步提示依次输入网站地址、账号和密码（密码只显示掩码）。Base URL 可以是站点根地址，也可以是常见的 OpenAI API 地址：

https://newapi.example.com
https://newapi.example.com/v1

插件会去除末尾的 /v1 和斜杠，再调用 New API 用户接口。

命令	作用
/newapi-login	登录或切换 New API 站点
/newapi-refresh	立即刷新余额
/newapi-status	查看站点、余额、更新时间及错误状态
/newapi-logout	退出并清除本地凭据

刷新与扣款动画

插件监听 Pi 的 agent_settled 事件。每轮 Agent 不会再自动重试、压缩或继续运行后，按以下时间点查询余额：

agent_settled  ── 立即 ── 1s ── 3s ── 6s
                              └─ 检测到扣款后停止剩余补查

当余额从 ¥155.86 降至 ¥153.86 时，页脚余额会在约 800 毫秒内滚动下降，并显示红色 -¥2.00。首次加载、余额增加或刷新失败不会触发动画。

兼容性

插件使用标准 New API 管理端接口：

• POST /api/user/login?turnstile=
• GET /api/user/self

站点需要允许账号密码登录，并在登录响应中返回 session Cookie。强制 Turnstile、SSO、二次验证或修改过用户接口的站点可能无法直接使用。OpenAI /v1 接口兼容本身不代表管理端接口一定兼容。

余额按 New API 默认规则 quota / 500000 显示为 ¥。这里只改变显示单位，不进行汇率换算。

配置与安全

配置默认保存在：

~/.pi/agent/newapi-balance.json

设置 PI_CODING_AGENT_DIR 时，配置写入该目录。插件会尝试将文件权限限制为仅当前用户可读写，并在保存失败或退出时清理已知的临时凭据文件；但账号、密码和 Session 仍以明文保存，请只在可信设备上使用，不要提交配置文件。

http:// 与 https:// 均受支持。远程 HTTP 连接不会提供传输加密，账号密码和 Session 可能被网络中的第三方截获；除本机开发或可信隔离网络外，建议使用 HTTPS。

旧版 ~/.pi/agent/maolao-balance.json 会在首次加载时迁移到新配置文件，并在新文件保存成功后删除。原站点地址仅用于迁移旧配置。/newapi-logout 会尝试删除新旧配置及其已知临时文件。

本地开发

npm test
npm run check
pi -e ./index.ts

扩展使用 Pi 内置依赖，不需要运行 npm install 即可执行测试和语法检查。

License

MIT