# pi-token-stats

[pi coding agent](https://pi.dev) 的 Token 与费用统计扩展。

- GitHub：<https://github.com/reaishijie/pi-token-stats>
- npm：<https://www.npmjs.com/package/pi-token-stats>
- English: [README.md](./README.md)

## 效果图

![pi-token-stats 效果图](./docs/screenshot.png)

## 功能

- 添加 `/tokens` 和 `/token-stats` 命令。
- 扫描 pi session 的 `.jsonl` 文件。
- 汇总 input、output、cache read、cache write、total tokens 和 cost。
- 按 provider/model 分组统计。
- 支持按最近 N 天统计，也支持统计全部历史。

## 安装

### 从 npm 安装

```bash
pi install npm:pi-token-stats
```

### 从 GitHub 安装

```bash
pi install git:github.com/reaishijie/pi-token-stats
```

安装指定 tag / 版本：

```bash
pi install git:github.com/reaishijie/pi-token-stats@v0.1.1
```

### 本地开发

```bash
pi install /path/to/pi-token-stats
# 或者只测试一次，不写入配置
pi -e /path/to/pi-token-stats
```

## 使用

```text
/tokens
/tokens 7
/tokens 30
/tokens 0
/token-stats --days 7
```

参数说明：

- 不传参数：统计最近 30 天
- `7`：统计最近 7 天
- `30`：统计最近 30 天
- `0`：统计全部历史
- `--days N` 或 `-d N`：统计最近 N 天

## Session 目录

默认读取：

```text
~/.pi/agent/sessions
```

同时支持 pi 的环境变量覆盖：

- `PI_CODING_AGENT_SESSION_DIR`
- `PI_CODING_AGENT_DIR`

## 开发

安装依赖：

```bash
npm install
```

类型检查：

```bash
npm run typecheck
```

打包预览：

```bash
npm pack --dry-run
```

## Pi Package

这个包通过 `package.json` 里的 `pi.extensions` 字段声明扩展入口，并通过 `pi-package` keyword 标记为 pi package。

## 许可证

MIT