pi-newapi-balance
v1.0.1
Published
Display a configurable New API account balance in the Pi terminal footer.
Maintainers
zzxbReadme
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 即可执行测试和语法检查。