# Token Bill

> 当前项目 Token 账单：累计总量、每日柱图、模型分布、四项成本与报价。支持 --since/--until 时间窗

- Skill: `kaythone/token-bill` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds@latest add kaythone/token-bill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kaythone/token-bill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kaythone (https://skillmd.com/u/kaythone)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/kaythone/token-bill

---


# token-bill — 当前项目 Token 账单

输出当前项目（当前工作目录）的 token 消耗账单：累计总量、每日消耗柱图、模型分布、四项成本明细与报价。

## 执行方式

运行以下命令（把 `<USER_ARGS>` 替换为用户传入的参数，如 `--since 2026-09-06 --until 2026-09-07`；用户未传参则省略）：

```bash
python ~/.agents/skills/token-bill/scripts/bill.py --project <当前工作目录绝对路径> <USER_ARGS>
```

参数细节：
- `--project`：必填，用当前会话的工作目录绝对路径
- `--source`：数据源，**缺省自动检测宿主客户端**（按宿主注入的环境变量/工作目录/进程树祖先判定）；仅可指定本机已安装的源，未安装的客户端源名不会出现在任何提示中。若宿主源的行级记录无项目归属字段，按项目查询时自动降级为该源全量账并标注 ⚠
- `--since/--until`：日期过滤，仅当用户传入时添加

## 输出处理

- **将脚本的全部 stdout 原样展示给用户**，不要重排格式、不要增删内容、不要翻译
- **展示时把 stdout 整体包进 ```text 围栏代码块**——聊天界面（Reasonix/Kimi Work 等）对代码块按等宽渲染，账单框线才不会错位；严禁改写成 Markdown 表格
- 脚本若报错（如数据库不存在），把错误信息原样转达，并建议用户检查数据源是否已运行