@yalieny/pi-better-cost-display-footer

pi 扩展:脚本化多段计价动态列表 + footer 增强。

• 多段动态计价:每个 provider 一个 tierFn 脚本函数(JS 表达式字符串)判定当前档位,档位是任意字符串 id(peak / flat / valley / sharp…),不绑定峰谷语义;在 session_start、每次发送消息、每次 LLM 调用前重注册 provider 的 cost(仅影响 pi 本地用量统计)。
• 计费自愈:每轮比对期望 cost(配置 × 当前档位)与实际参与计费的 ctx.model.cost,不一致则重注册纠正;连续 3 次未收敛则停止重试并在 footer 显式告警(金额前 ≈、标签加 ?),不再静默错价.
• 档位标签:价格后紧跟当前档位标签(如 ¥0.047(梁文峰)),按档位 id 配置文案与颜色;未配置标签的档位不显示。
• CH 精度:footer 缓存命中率小数位可配(默认 1 位)。
• tok/s 速率(思考/正文分相位):footer 常显 —— 流式中只显示当前相位的实时值 ⚡45.2t/s(思考中/出字中都是这个形式,无前缀,2s 滚动窗口);assistant 消息结束(工具执行前)后冻结,只在冻结态带前缀,固定三档 ⚡(175.1/r31.8/o613.4)t/s = 总吞吐 / 思考(r标识) / 正文(o标识),无值打 - 占位:本条无思考就是 ⚡(334.8/r-/o336.2)t/s(无思考时总与正文本就重合)。分母均从各相位首 delta 起算,不含首 token 延迟与工具执行时长。实时值为估算(字符折算 token),思考/正文各自的折算比由真实 usage.output/usage.reasoning EMA 自校准(初始 4,限幅 0.5~8);异常速率(>1000 t/s)丢弃。注:DeepSeek 在工具循环的续写消息里经常不吐思考,所以 r 档会时有时无(显示为 -)。
• 货币符号:按 provider 配置计费金额符号(默认 $)。
• 配置升级:旧版顶层计价配置与 peakWindows 首次启动自动迁移为 provider 分层 + tierFn 格式(语义不变)。

安装

pi install npm:@yalieny/pi-better-cost-display-footer

或本地加载:pi -e npm:@yalieny/pi-better-cost-display-footer

配置

扩展读取 <configDir>/pi-better-cost-display-footer.json(configDir 默认 ~/.pi/agent,可用 PI_CODING_AGENT_DIR 覆盖)。配置文件不存在时自动生成默认配置并落盘(DeepSeek 官方价目,开箱即用,生成后可直接编辑);配置文件存在时按字段覆盖默认值(provider/model 三级深合并)。

{
  "cacheHitRatePrecision": 3,
  "providers": {
    "deepseek": {
      "timezone": "Asia/Shanghai",
      "effectiveFrom": "2026-08-23T00:00:00+08:00",
      "currencySymbol": "¥",
      "tierFn": "(ctx) => ctx.isWeekend() ? 'offPeak' : (ctx.inWindow('09:00','12:00') || ctx.inWindow('14:00','18:00')) ? 'peak' : 'offPeak'",
      "defaultTier": "offPeak",
      "labels": {
        "peak": { "text": "（梁文峰）", "color": "error" },
        "offPeak": { "text": "（梁文谷）", "color": "success" }
      },
      "models": {
        "deepseek-v4-flash": {
          "offPeak": { "input": 1.5, "output": 4.5, "cacheRead": 0.05, "cacheWrite": 0 },
          "peak":    { "input": 3.0, "output": 9.0, "cacheRead": 0.1, "cacheWrite": 0 }
        }
      }
    }
  }
}

价格单位:每百万 tokens(元),与 pi 的 calculateCost 约定一致。effectiveFrom(含)之前不做任何事。

档位判定(tierFn)

tierFn 是 JS 函数表达式字符串(编译执行),返回任意档位 id(字符串)。上下文 ctx 均为配置时区本地值:

字段/方法	说明
ctx.now	当前时刻 Date
ctx.timezone	计费时区
ctx.weekday	0=周日 … 6=周六
ctx.hour / ctx.minute	时区本地时钟
ctx.dateStr	YYYY-MM-DD(如 '2026-10-01',可做日期区间比较)
ctx.isWeekend()	周六/周日
ctx.inWindow(start, end)	HH:mm 窗口命中,含起点不含终点
ctx.afterISO(iso) / ctx.beforeISO(iso)	ISO 日期比较(节假日窗口、调价日等)

任一声场(语法错误、执行异常、返回非字符串、未配置 tierFn)→ 回退 defaultTier(默认 "offPeak"),绝不崩溃。旧字段 peakWindows 首次加载自动迁移为等价 tierFn 并写回配置文件(语义不变)。

示例(档位数不限):

• 工作日峰谷 + 周末全天低谷(DeepSeek 2026-08-23 起官方新规): "(ctx) => ctx.isWeekend() ? 'offPeak' : (ctx.inWindow('09:00','12:00') || ctx.inWindow('14:00','18:00')) ? 'peak' : 'offPeak'"
• 三段计价(尖峰/高峰/平段): "(ctx) => ctx.inWindow('11:00','12:00') ? 'sharp' : ctx.inWindow('09:00','12:00') ? 'peak' : 'valley'" 对应每个模型三方价格 "sharp": {...}, "peak": {...}, "valley": {...},labels 同样按档位 id 添加。
• 单一平价(官方取消峰谷):"(ctx) => 'offPeak'"
• 国庆节假日全天低谷: "(ctx) => ctx.dateStr >= '2026-10-01' && ctx.dateStr <= '2026-10-07' ? 'offPeak' : (ctx.inWindow('09:00','12:00') ? 'peak' : 'offPeak')"

tierFn 为本地执行脚本(new Function 编译),仅应来自受信任的配置文件。

一键更新官方定价

/deepseek-pricing-update

该命令把抓取官方价目页、解析价格、更新配置文件的完整任务交给 agent 执行(自然语言指令,无需手动维护价格表)。命令会告知 agent 配置文件位置与 JSON 格式;agent 抓取 DeepSeek 官方价目页 后更新 providers.deepseek.models 下各模型的分档价格,其余字段不动。

计价诊断

/cost-tier

只读打印当前模型的档位状态:档位、期望费率 vs 实际计费费率、是否漂移、tierFn 编译状态、注册守卫与重试预算、最近一次注册结果。扩展的 console.error 在 TUI 下不落盘,排查"标签与金额不符"时用这条命令而不是猜。

测试

npm install && npm test                                  # 纯函数单测(档位判定 / 漂移判定)
node --experimental-strip-types test/drift-probe.ts      # 端到端:守卫重试与自愈(用系统临时目录隔离配置)

说明

• 顶层仅配置全局 cacheHitRatePrecision;timezone/effectiveFrom/currencySymbol/tierFn/defaultTier/labels/models 均配置在对应 provider 下。
• provider 必须在 models.json 中有定义;未列出的模型保持原价。
• 模型缺少当前档位价格时保持原价并打日志。
• cost 仅影响 pi 本地用量统计,不影响 API 实际账单。

变更记录

• 2.2.0 footer 新增 tok/s 速率(思考/正文分相位):流式中显示当前相位实时值 ⚡45.2t/s(无前缀,2s 滚动窗口),assistant message_end 用真实 usage 冻结为固定三档 ⚡(175.1/r31.8/o613.4)t/s(总/思考/正文,无值打 - 占位);分母从各相位首 delta 起算,不含首 token 延迟与工具执行时长(定稿用 message_end 而非 turn_end)。实时值为估算,思考/正文各自的折算比由真实 token EMA 自校准(初始 4,限幅 0.5~8);异常速率(>1000 t/s)丢弃;无效 usage(失败/中止)不覆盖定稿值。/cost-tier 新增两档折算比。
• 2.1.2 修复"档位标签正确但计费金额按错档结算":注册守卫改为按实际计费 cost 判定漂移(不再只看档位字符串),注册失败不再写入守卫(下一轮自动重试);漂移 3 次未收敛转为 footer 可见告警(≈ + 标签 ?);新增 /cost-tier 诊断命令与注册失败一次性提示。方案见 docs/fix-plan-stale-cost-tier.md。