@liuchen64/pi-footer-status

Pi 扩展 - Footer 状态栏，显示 token 用量、速率、缓存命中率、上下文比例

Packages

Package details

extension

Install @liuchen64/pi-footer-status from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:@liuchen64/pi-footer-status
Package
@liuchen64/pi-footer-status
Version
0.12.0
Published
Nov 4, 2026
Downloads
751/mo · 650/wk
Author
liuchen64
License
MIT
Types
extension
Size
61.4 KB
Dependencies
1 dependency · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@liuchen64/pi-footer-status

Pi Footer 状态栏扩展，两行展示当前会话的运行状态：工作目录、消耗金额、任务用时、token 用量、速率、缓存、上下文、余额与模型。

显示内容

第一行

D:\Code\me\project · 本次 ¥0.0231 · 总计 ¥1.23 · 高峰                进行中 12.3s
  • 左侧：工作目录 · 本次任务消耗 · 会话累计消耗 · 当前计价时段（金额仅对已收录单价的 provider 显示）
  • 右侧：任务状态与用时（进行中 12.3s / 已完成 12.3s），空闲时不显示

第二行

轮次 3 · 输入 12.5k · 输出 3.2k · 缓存 8.1k (64.80% 命中) · 45.2 t/s (首token 1.2s) · 上下文 32.4% (41.5k/128.0k) · 余额 42.50 CNY   deepseek-flash high
指标 说明
轮次 当前会话的轮次序号
输入 / 输出 会话累计 token；输出在流式期间取「已结算 + 实时估算」的较大值，随 token 到达增长
缓存 会话累计缓存读取 token 与命中率（两位小数）
速率 滚动窗口实时估算的 tok/s，括号内为本轮首 token 延迟；轮次结束后按实际输出 token 结算最终速率
上下文 已用 token / 窗口大小与占比；超过 30% 变黄，超过 70% 变红
余额 仅对内置余额策略的 provider（当前 DeepSeek）查询，未查询到余额时显示红色
模型 当前模型名与思考强度（右侧）

token 数字按 k / M 缩写；金额按量级自动保留 3–5 位小数，避免小额显示成 ¥0.00。

安装

pi install npm:@liuchen64/pi-footer-status

颜色

状态栏以 dim 色为主，仅以下几处带语义色：

元素 颜色
上下文 ≤ 30% dim
上下文 > 30% warning（黄）
上下文 > 70% error（红）
余额查询失败 error（红）
计价高峰时段 warning（黄）

阈值定义在 src/config/color.ts。

计数口径

  • token 是会话累计值：会话启动时从 pi 会话历史重建，/resume 或重启后恢复会话不会丢失计数
  • 「本次 / 总计」金额分别对应当前任务与会话累计
  • 金额只对价格表已收录单价的 provider 生效（当前为 DeepSeek），其他 provider 下不显示金额
  • 金额旁的「高峰 / 低峰」标记当前计价时段（高峰段价格为空闲时段的两倍）：高峰用警告色、低峰用暗色；模型无峰谷价时不显示，每分钟自动刷新以跟上时段切换
  • 余额仅内置 DeepSeek 策略，其他 provider 不显示

对外广播

通过 pi.events 把状态变化广播给其他扩展，契约定义在 @liuchen64/pi-plugin-events：

事件 时机 载荷
usageSnapshot 对话完全停止（agent_settled） 轮次、会话累计输入/输出/缓存与命中率、上下文、本次与总计消耗
balanceChanged 余额刷新且数值变化 provider、余额、币种、获取时刻

消费方（如 im-bridge）自行订阅并决定展示形式；本扩展不做任何格式化。

消耗金额只对价格表已收录单价的 provider（当前仅 DeepSeek）生效：其他 provider 下快照的 taskCost / sessionCost 为 null。