configure-pi-metrics git:20260914.d123f51A

Immutable. This exact content is served forever at /api/v1/blob/370b3e80f804adca.

---
name: configure-pi-metrics
description: "启用与排查 pi-metrics 的耗时、TPS、TTFT、token 和成本遥测。Use when configuring or diagnosing Pi session metrics."
---

# 配置 pi-metrics

配置文件为 `<Pi agent 目录>/extensions/pi-metrics/config.json`，字段只有 `enabled`，默认是 `true`。可以使用 `/config:metrics` 打开 TUI 菜单，或使用 `/config:metrics enable|disable` 直接修改并持久化。手动修改配置文件后执行 `/reload`。

## 诊断与修改

1. 确认 `npm:pi-metrics` 已安装且扩展资源已启用。
2. 若同时启用了 `npm:@monotykamary/pi-tps`，先让用户选择保留一个；两者会重复写入 `tps` session entry 和通知。
3. 文案语言由 `pi-extensions-i18n` 控制。

## 验证

在 TUI 中完成一次真实模型回合，观察 working spinner、每轮的 TPS/TTFT/token 指标行（含本轮耗时）和可用的 cost；如果一次运行跑了多轮，停下时还应看到一条 `⏱ 总耗时`。RPC/print 模式不会启动 UI 定时器或通知；provider 未返回 usage 时部分指标不可用。真实模型回合属于 E2E，执行前遵守当前任务授权边界；未运行时明确报告 `NOT_RUN`。