token-tracker 0.4.1__tar.gz → 0.4.3__tar.gz

{token_tracker-0.4.1/src/token_tracker.egg-info → token_tracker-0.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: token-tracker
-Version: 0.4.1
+Version: 0.4.3
 Summary: Track token usage across local AI agents (Claude Code, Codex)
 Author-email: stormzhang <stormzhang.dev@gmail.com>
 License: MIT License
@@ -61,15 +61,32 @@ Dynamic: license-file
 
 [English](README_EN.md)
 
+![Token Tracker Daily](assets/screenshot-daily.png)
+
+## 功能亮点
+
+- **多 Agent 统一追踪** — Claude Code + Codex 统一读取，多 Agent 按来源分组
+- **状态栏集成** — Claude Code 用官方 StatusLine 接口；**Codex 业界首创伪 statusline 方案**（hook 注入两行真彩色状态栏，把官方未开放的能力在 Codex 里做了出来）
+- **限额监控** — 实时 5h / 7d 配额百分比 + 重置倒计时
+- **多维成本分析** — 会话 / 日 / 周 / 月多维报表，等效成本统计
+- **定价识别** — litellm 在线定价 + 内置官方价双层兜底，覆盖 Claude / OpenAI / Gemini / Grok 及国产主流（Kimi / GLM / Qwen / 豆包 / DeepSeek / MiniMax / MiMo）；新模型自动套用同系列定价、不静默归零
+- **会话洞察** — 项目、模型、时长、消息数一览
+- **多主题统一配色** — 6 套主题（Catppuccin 全家 + Nord + Dracula），CLI 报表 / CC 状态栏 / Codex 伪 statusline **三者同源**，`tt theme` 一键切换
+- **零配置** — 自动检测已安装的 Agent，直接读取本地数据
+- **隐私安全** — 数据纯本地存储，不采集、不上传
+
 ## StatusLine 状态栏
 
-自动为 Claude Code 和 Codex 配置状态栏，`tt setup` 一键配置，脚本更新时自动升级。
+`tt setup` 自动为 Claude Code 和 Codex 配置状态栏，脚本更新时自动升级。
+
+### Claude Code（官方接口）
 
-**Claude Code**：基于官方自定义 StatusLine 接口，数据完全来自本地 Claude，准确无任何推测
+基于 Claude Code 官方自定义 StatusLine 接口，**数据完全来自本地 Claude，无任何推测**。
 
 ![Claude Code StatusLine](assets/screenshot-statusline-cc.png)
 
-状态栏共四行，从左到右：
+<details>
+<summary>四行布局字段详解</summary>
 
 | 行 | 字段 | 说明 |
 |----|------|------|
@@ -88,44 +105,38 @@ Dynamic: license-file
 
 > 终端宽度不足时会自动降级：先隐藏重置倒计时，再将进度条简化为百分比数字。**API 模式**无订阅配额，第 2 行只显示 Ctx。
 
-**Codex**：官方暂不支持自定义 StatusLine，`tt setup` 通过 Codex `Stop` hook 装一个**伪 statusline**——每次回答完成后在回答尾部追加**两行**彩色 status，仿 Claude Code 状态栏（不再接管 Codex 官方 `status_line`，伪 statusline 信息比官方字段更全）：
+</details>
+
+### Codex（伪 statusline，业界首创）
+
+Codex 官方暂不支持自定义 StatusLine。Token Tracker 通过 hook 注入了一个**伪 statusline**——每次回答完成后，在回答尾部追加两行真彩色状态栏。**这是目前业界少见的把状态栏能力在 Codex 里做出来的实现方案**。
 
 ![Codex StatusLine](assets/screenshot-statusline-codex.png)
 
-**伪 statusline 两行布局**：
+**两行布局**：
 
 - **L1** `[项目](分支 +A -D) | Total: <会话累计 token> | Model: <模型 推理强度>` —— Total 橙、Model 红
 - **L2** `Limit: 5h <进度条> % (reset <倒计时>) | 7d <进度条> % (reset <倒计时>) | <窗口> Ctx <进度条> %`
 
-通过 `Stop` hook 注入 `systemMessage` 实现，渲染 24-bit 真彩色、**不进模型上下文**（实测），**配色跟随当前主题**（与 CLI 报表 / CC 状态栏同源，`tt theme` 切换三者一起变）。`tt unsetup` 一并移除。
+渲染 24-bit 真彩色、**不进模型上下文**（实测），**配色跟随当前主题**（与 CLI 报表 / CC 状态栏同源，`tt theme` 切换三者一起变）。`tt unsetup` 一并移除。
 
-## Daily 概览和 日/周/月 数据报表分析
+## 报表速览
 
-`tt`（无参）/ `tt daily`：默认入口，GitHub 风格 token 贡献热力图 + 顶部**单一卡片**内拼三段概览（**Last 12 months / This Month / This Week**，粗→细）。
-- Last 12 months：橙色 Tokens / Cost / Sessions / Avg/Cost / 活跃天数 + 蓝色 单日峰值 / 当前·最长连续活跃天数
-- This Month / This Week：橙色 Tokens / Cost / Avg/Cost / 活跃天数，**带环比**（↑/↓ 上月 / 上周）
+`tt status` — 过去 5h 实时面板（合并概览 + 5h/7d 额度 + 近期会话）
 
-`tt status`：聚焦**过去 5 小时**的实时面板——顶部多 Agent **合并**概览（Token / Cost / Sessions / Messages / Top Model），中间 **5h / 7d 订阅额度**进度条（Claude Code / Codex 分开；都没订阅额度时换成 per-agent 的 token/cost/sessions/messages 统计），底部**近期会话**列表（CC + Codex 合并、带 Agent 列、按 Cost 倒序、Cost 前三名高亮）。所有时间按**系统时区**显示，配色跟随当前主题。
+![Status](assets/screenshot.png)
 
-![Token Tracker Daily](assets/screenshot-daily.png)
+`tt weekly` — 周报：本周分析卡片 + 每日趋势柱状图 + 周 / 项目 / 模型趋势
 
-![Token Tracker Status](assets/screenshot.png)
+![Weekly](assets/screenshot-weekly.png)
 
-![Token Tracker Weekly](assets/screenshot-weekly.png)
+`tt monthly` — 月报：本月分析卡片 + 周柱状图 + 月趋势 + 项目 / 模型分布
 
-![Token Tracker Monthly](assets/screenshot-monthly.png)
+![Monthly](assets/screenshot-monthly.png)
 
-## 功能
+`tt sessions` — 最近 20 条会话明细（按 cost 倒序，支持 `--sort` 改字段）
 
-- **多 Agent 追踪** — Claude Code + Codex 统一面板，左右键切换
-- **状态栏集成** — Claude Code statusLine + Codex status_line，首次运行自动配置，脚本更新自动升级
-- **限额监控** — 实时 5h / 7d 配额百分比 + 重置倒计时
-- **成本分析** — 按会话、日、周、月维度的等效成本统计，多 Agent 按来源分组展示
-- **定价识别** — litellm 在线定价 + 内置官方价双层兜底；同系列新模型自动套用本档定价（含 Claude Fable 5 / Opus 4.8），全新系列缺价时明确提示，不静默按 $0 统计
-- **会话洞察** — 项目、模型、时长、消息数一览
-- **多主题统一配色** — 6 套主题（Catppuccin Mocha/Latte/Frappe/Macchiato + Nord + Dracula），CLI 报表、CC 状态栏与 Codex 伪 statusline **三者同源**；`tt theme` 一键切换 / 预览，暗 / 亮终端自动选 Catppuccin，首次运行交互向导引导选择，`TT_THEME` 可覆盖；终端不支持 truecolor 时自动降级到 256 色近似
-- **零配置** — 自动检测已安装的 Agent，直接读取本地数据
-- **隐私安全** — 数据纯本地存储，不采集、不上传任何用户信息，极轻量无后顾之忧
+![Sessions](assets/screenshot-sessions.png)
 
 ## 安装
 
@@ -136,38 +147,31 @@ curl -sSL https://raw.githubusercontent.com/stormzhang/token-tracker/main/instal
 脚本自动选最优安装方式（uv / pipx / 私有 venv），绕开 PEP 668、不污染系统 Python。
 
 > **升级**：重跑上面的命令即可（脚本幂等、自动升到最新）。
-> **卸载**：先 `tt unsetup` 还原状态栏，再按装法移除（`uv tool uninstall token-tracker` / `pipx uninstall token-tracker` / 删 `~/.local/share/token-tracker` 与 `~/.local/bin/tt`）。
+> **卸载**：`tt unsetup`
 
 ## 使用
 
 ```bash
 tt setup          # 交互配置向导（终端：上下键选语言 / 主题 / 各组件）；非 tty 环境自动全装
-tt                # 过去一年 token 热力图 + 顶部三段概览（Last 12 months / This Month / This Week，= tt daily）
+tt                # 过去一年 token 热力图 + 顶部三段概览（= tt daily）
 tt daily          # 同上（tt 无参即进 daily）
-tt status         # 过去 5h 实时面板（合并概览 + 5h/7d 额度 + 近期会话）
-tt weekly         # 周报：本周分析卡片 + 每日趋势柱状图 + 周 / 项目 / 模型趋势
-tt monthly        # 按月汇总（多 Agent 分组展示）
-tt sessions       # 最近 20 条会话明细（按 cost 倒序展示；tt sessions <n> 改条数、--sort 改排序）
+tt status         # 过去 5h 实时面板
+tt weekly         # 周报
+tt monthly        # 月报
+tt sessions       # 最近 20 条会话明细（tt sessions <n> 改条数、--sort 改排序）
 tt theme          # 查看 / 切换配色主题（show / list / set / preview）
 tt unsetup        # 卸载并恢复安装前的配置
+tt --version      # 查看版本（-v / -V 同义）
 ```
 
 > 💡 `tt daily` 是 GitHub 风格的 token 贡献热力图（深浅绿方格）。在 Claude Code 会话里输入 `!tt daily` 即可看到彩色热力图 —— 用户主动用 `!` 执行的命令，Claude Code 会渲染其 24-bit 真彩色输出。
 
-### 首次运行向导
-
-第一次跑 `tt`（或通过 curl 一键安装脚本装完自动启动）会进入**交互式配置向导**，全程上下键选 + 回车确认：
-
-1. **选语言** — 中文 / English（落 `~/.config/token-tracker/config.json`，之后所有命令跟随）
-2. **选配色主题** — 6 套主题上下键选择，每个选项右侧内联色板预览
-3. **启用 Codex 伪 statusline** — Yes/No，默认 Yes（仅检测到 Codex 时）
-
-选完给一份键值对齐的配置总结 + 重启 / 下一步提示。CI / 非 tty 环境（Docker / 脚本）自动按默认全装：**语言跟随系统设置**（读系统语言、不被 CLI 的 `LANG` 误导）、主题 mocha、组件全开。装好后想改任何一项，再跑一次 `tt setup` 即可（终端里每次 `tt setup` 都进向导）。
-
-### 配色主题
+## 配色主题
 
 内置 6 套主题，CLI 报表、CC 状态栏与 Codex 伪 statusline **统一同源**（切主题三者一起变）：
 
+![支持的主题](assets/screenshot-themes.png)
+
 | 主题 | 说明 |
 |------|------|
 | `mocha` / `latte` / `frappe` / `macchiato` | Catppuccin 全家（暗 / 亮终端自动选 mocha / latte） |
@@ -182,9 +186,20 @@ tt theme set nord      # 切换主题（持久化 + 重烘焙状态栏）
 tt monthly --theme nord  # 任意报表临时换主题渲染（不持久化、不动状态栏，适合对比）
 ```
 
-- **首次运行**（终端内、非 AI 会话）会进入交互向导引导选主题；CI / 脚本 / 会话内自动跳过、静默用默认。
-- 切换持久化到 `~/.config/token-tracker/config.json`（主题 + 语言 + 组件意图统一存这一个文件）；优先级 `--theme` 参数 > `TT_THEME` 环境变量 > 配置文件 > 自动（`--theme` 和 `TT_THEME` 都只临时生效、不写配置）。
-- 终端支持 truecolor 用精确配色；不支持的（如 macOS 自带 Terminal.app）自动降级到当前主题的 **256 色近似**，8 色老终端不再适配。
+- 切换持久化到 `~/.config/token-tracker/config.json`；优先级 `--theme` 参数 > `TT_THEME` 环境变量 > 配置文件 > 自动。
+- 终端支持 truecolor 用精确配色；不支持的（如 macOS 自带 Terminal.app）自动降级到 **256 色近似**。
+
+## 高级
+
+### 首次运行向导
+
+第一次跑 `tt`（或在独立终端跑 `tt setup`）会进入**交互式配置向导**，全程上下键选 + 回车确认：
+
+1. **选语言** — 中文 / English（落 `~/.config/token-tracker/config.json`）
+2. **选配色主题** — 6 套主题上下键选择，每个选项右侧内联色板预览
+3. **启用 Codex 伪 statusline** — Yes/No（仅检测到 Codex 时）
+
+CI / 非 tty 环境（Docker / 脚本 / `curl|bash`）自动按默认全装：**语言跟随系统设置**、主题 mocha、组件全开。装好后想改任何一项，再跑一次 `tt setup` 即可。
 
 ### 报告排序
 
@@ -197,17 +212,6 @@ tt sessions --sort tokens --asc # 按 token 升序
 
 可选排序字段：`tokens` / `cost` / `messages` / `time` / `input` / `output`
 
-### Dashboard 快捷键
-
-| 按键 | 功能 |
-|------|------|
-| `←` `→` | 切换 Agent |
-| `↑` `↓` | 滚动内容 |
-| `s` | 切换排序字段（时间 → Token → 等效成本 → 消息数） |
-| `r` | 反转排序方向 |
-| `+` / `-` | 调整会话显示条数（±10，最少 10 条） |
-| `q` | 退出 |
-
 ## 数据来源
 
 | Agent | 路径 | 格式 |
@@ -215,7 +219,7 @@ tt sessions --sort tokens --asc # 按 token 升序
 | Claude Code | `~/.claude/projects/*/` | JSONL（逐消息用量） |
 | Codex | `~/.codex/sessions/` | JSONL + SQLite |
 
-路径跨平台：Windows 下 `~` 解析到 `%USERPROFILE%`（如 `C:\Users\xxx\.claude`）。设了 `CLAUDE_CONFIG_DIR` / `CODEX_HOME` 环境变量（官方支持的自定义目录）时自动跟随。
+路径跨平台：Windows 下 `~` 解析到 `%USERPROFILE%`。设了 `CLAUDE_CONFIG_DIR` / `CODEX_HOME` 环境变量（官方支持的自定义目录）时自动跟随。
 
 Token Tracker 对 Agent 数据**只读**，不做任何修改。
 
@@ -224,20 +228,6 @@ Token Tracker 对 Agent 数据**只读**，不做任何修改。
 - Python 3.11+
 - [Rich](https://github.com/Textualize/rich)（自动安装）
 
-## 开发
-
-```bash
-git clone https://github.com/stormzhang/token-tracker && cd token-tracker
-uv run --extra dev pytest                # 运行测试
-uv run --extra dev ruff check src tests  # Lint
-```
-
-包采用标准 src layout（`src/token_tracker/`）：发行名 `token-tracker`，导入名 `token_tracker`（0.4.0 起）。
-
-## TODO
-
-未来持续增加更多数据报表，多维度分析。
-
 ## License
 
 Copyright (c) 2026 stormzhang. MIT License.

token_tracker-0.4.3/README.md

@@ -0,0 +1,180 @@
+# Token Tracker (tt)
+
+本地 AI Agent Token 消耗追踪/分析工具，支持 **Claude Code** 和 **Codex** 。
+
+自定义 StatusLine 状态栏 + CLI Dashboard，实时查看 token 用量、等效成本、限额状态。
+
+![Python](https://img.shields.io/badge/python-3.11+-blue) ![CI](https://github.com/stormzhang/token-tracker/actions/workflows/ci.yml/badge.svg) ![License](https://img.shields.io/badge/license-MIT-green)
+
+[English](README_EN.md)
+
+![Token Tracker Daily](assets/screenshot-daily.png)
+
+## 功能亮点
+
+- **多 Agent 统一追踪** — Claude Code + Codex 统一读取，多 Agent 按来源分组
+- **状态栏集成** — Claude Code 用官方 StatusLine 接口；**Codex 业界首创伪 statusline 方案**（hook 注入两行真彩色状态栏，把官方未开放的能力在 Codex 里做了出来）
+- **限额监控** — 实时 5h / 7d 配额百分比 + 重置倒计时
+- **多维成本分析** — 会话 / 日 / 周 / 月多维报表，等效成本统计
+- **定价识别** — litellm 在线定价 + 内置官方价双层兜底，覆盖 Claude / OpenAI / Gemini / Grok 及国产主流（Kimi / GLM / Qwen / 豆包 / DeepSeek / MiniMax / MiMo）；新模型自动套用同系列定价、不静默归零
+- **会话洞察** — 项目、模型、时长、消息数一览
+- **多主题统一配色** — 6 套主题（Catppuccin 全家 + Nord + Dracula），CLI 报表 / CC 状态栏 / Codex 伪 statusline **三者同源**，`tt theme` 一键切换
+- **零配置** — 自动检测已安装的 Agent，直接读取本地数据
+- **隐私安全** — 数据纯本地存储，不采集、不上传
+
+## StatusLine 状态栏
+
+`tt setup` 自动为 Claude Code 和 Codex 配置状态栏，脚本更新时自动升级。
+
+### Claude Code（官方接口）
+
+基于 Claude Code 官方自定义 StatusLine 接口，**数据完全来自本地 Claude，无任何推测**。
+
+![Claude Code StatusLine](assets/screenshot-statusline-cc.png)
+
+<details>
+<summary>四行布局字段详解</summary>
+
+| 行 | 字段 | 说明 |
+|----|------|------|
+| 1 | `[项目](分支 +12 -3)` | 项目名（加粗）+ Git 分支（未提交修改标 `*`），括号内附工作区相对 HEAD 的增删行数 |
+| 1 | `Total: 1.2M` | 本次会话累计消耗 token（输入+输出+cache，解析 transcript 得出） |
+| 1 | `Cost: $35.51` | 本次会话等效成本（Claude Code 自带，按官方计费，准确） |
+| 1 | `Code: +208 -8` | 本会话 Claude 写 / 删的代码行数（`+` 绿 `-` 红，与 git 变动同配色） |
+| 2 | `Limit: 5h: ██░ 31% (1h19m)` | 5 小时滑动窗口配额（仅订阅模式；括号内重置倒计时） |
+| 2 | `7d: ██░ 11% (5d8h)` | 7 天滑动窗口配额 |
+| 2 | `1.0M Ctx: ██░ 20%` | 上下文窗口总大小及已用占比 |
+| 3 | `Tokens: in 392k, out 937, cache 388k` | **当前上下文窗口**的 token 构成（注意：非会话累计，会随 compact 变化） |
+| 3 | `Out TPS: 60 tokens/s` | 本轮 output token 生成速度（含 thinking；空闲帧保留上次值） |
+| 4 | `Model: Opus 4.8/xhigh/nofast` | 模型名 / reasoning 级别 / 是否 fast 模式 |
+| 4 | `Duration: 1h33m` | 当前会话已持续时间 |
+| 4 | `Remote: github` | 代码仓库 host（去顶级域） |
+
+> 终端宽度不足时会自动降级：先隐藏重置倒计时，再将进度条简化为百分比数字。**API 模式**无订阅配额，第 2 行只显示 Ctx。
+
+</details>
+
+### Codex（伪 statusline，业界首创）
+
+Codex 官方暂不支持自定义 StatusLine。Token Tracker 通过 hook 注入了一个**伪 statusline**——每次回答完成后，在回答尾部追加两行真彩色状态栏。**这是目前业界少见的把状态栏能力在 Codex 里做出来的实现方案**。
+
+![Codex StatusLine](assets/screenshot-statusline-codex.png)
+
+**两行布局**：
+
+- **L1** `[项目](分支 +A -D) | Total: <会话累计 token> | Model: <模型 推理强度>` —— Total 橙、Model 红
+- **L2** `Limit: 5h <进度条> % (reset <倒计时>) | 7d <进度条> % (reset <倒计时>) | <窗口> Ctx <进度条> %`
+
+渲染 24-bit 真彩色、**不进模型上下文**（实测），**配色跟随当前主题**（与 CLI 报表 / CC 状态栏同源，`tt theme` 切换三者一起变）。`tt unsetup` 一并移除。
+
+## 报表速览
+
+`tt status` — 过去 5h 实时面板（合并概览 + 5h/7d 额度 + 近期会话）
+
+![Status](assets/screenshot.png)
+
+`tt weekly` — 周报：本周分析卡片 + 每日趋势柱状图 + 周 / 项目 / 模型趋势
+
+![Weekly](assets/screenshot-weekly.png)
+
+`tt monthly` — 月报：本月分析卡片 + 周柱状图 + 月趋势 + 项目 / 模型分布
+
+![Monthly](assets/screenshot-monthly.png)
+
+`tt sessions` — 最近 20 条会话明细（按 cost 倒序，支持 `--sort` 改字段）
+
+![Sessions](assets/screenshot-sessions.png)
+
+## 安装
+
+```bash
+curl -sSL https://raw.githubusercontent.com/stormzhang/token-tracker/main/install.sh | bash
+```
+
+脚本自动选最优安装方式（uv / pipx / 私有 venv），绕开 PEP 668、不污染系统 Python。
+
+> **升级**：重跑上面的命令即可（脚本幂等、自动升到最新）。
+> **卸载**：`tt unsetup`
+
+## 使用
+
+```bash
+tt setup          # 交互配置向导（终端：上下键选语言 / 主题 / 各组件）；非 tty 环境自动全装
+tt                # 过去一年 token 热力图 + 顶部三段概览（= tt daily）
+tt daily          # 同上（tt 无参即进 daily）
+tt status         # 过去 5h 实时面板
+tt weekly         # 周报
+tt monthly        # 月报
+tt sessions       # 最近 20 条会话明细（tt sessions <n> 改条数、--sort 改排序）
+tt theme          # 查看 / 切换配色主题（show / list / set / preview）
+tt unsetup        # 卸载并恢复安装前的配置
+tt --version      # 查看版本（-v / -V 同义）
+```
+
+> 💡 `tt daily` 是 GitHub 风格的 token 贡献热力图（深浅绿方格）。在 Claude Code 会话里输入 `!tt daily` 即可看到彩色热力图 —— 用户主动用 `!` 执行的命令，Claude Code 会渲染其 24-bit 真彩色输出。
+
+## 配色主题
+
+内置 6 套主题，CLI 报表、CC 状态栏与 Codex 伪 statusline **统一同源**（切主题三者一起变）：
+
+![支持的主题](assets/screenshot-themes.png)
+
+| 主题 | 说明 |
+|------|------|
+| `mocha` / `latte` / `frappe` / `macchiato` | Catppuccin 全家（暗 / 亮终端自动选 mocha / latte） |
+| `nord` | Nord |
+| `dracula` | Dracula |
+
+```bash
+tt theme               # 显示当前主题及来源
+tt theme list          # 列出全部主题 + 色块预览
+tt theme preview nord  # 预览某主题（CLI 样例 + 状态栏样例行）
+tt theme set nord      # 切换主题（持久化 + 重烘焙状态栏）
+tt monthly --theme nord  # 任意报表临时换主题渲染（不持久化、不动状态栏，适合对比）
+```
+
+- 切换持久化到 `~/.config/token-tracker/config.json`；优先级 `--theme` 参数 > `TT_THEME` 环境变量 > 配置文件 > 自动。
+- 终端支持 truecolor 用精确配色；不支持的（如 macOS 自带 Terminal.app）自动降级到 **256 色近似**。
+
+## 高级
+
+### 首次运行向导
+
+第一次跑 `tt`（或在独立终端跑 `tt setup`）会进入**交互式配置向导**，全程上下键选 + 回车确认：
+
+1. **选语言** — 中文 / English（落 `~/.config/token-tracker/config.json`）
+2. **选配色主题** — 6 套主题上下键选择，每个选项右侧内联色板预览
+3. **启用 Codex 伪 statusline** — Yes/No（仅检测到 Codex 时）
+
+CI / 非 tty 环境（Docker / 脚本 / `curl|bash`）自动按默认全装：**语言跟随系统设置**、主题 mocha、组件全开。装好后想改任何一项，再跑一次 `tt setup` 即可。
+
+### 报告排序
+
+所有报告命令支持 `--sort` 和 `--asc/--desc` 参数：
+
+```bash
+tt weekly --sort cost --desc    # 按成本降序
+tt sessions --sort tokens --asc # 按 token 升序
+```
+
+可选排序字段：`tokens` / `cost` / `messages` / `time` / `input` / `output`
+
+## 数据来源
+
+| Agent | 路径 | 格式 |
+|-------|------|------|
+| Claude Code | `~/.claude/projects/*/` | JSONL（逐消息用量） |
+| Codex | `~/.codex/sessions/` | JSONL + SQLite |
+
+路径跨平台：Windows 下 `~` 解析到 `%USERPROFILE%`。设了 `CLAUDE_CONFIG_DIR` / `CODEX_HOME` 环境变量（官方支持的自定义目录）时自动跟随。
+
+Token Tracker 对 Agent 数据**只读**，不做任何修改。
+
+## 环境要求
+
+- Python 3.11+
+- [Rich](https://github.com/Textualize/rich)（自动安装）
+
+## License
+
+Copyright (c) 2026 stormzhang. MIT License.

{token_tracker-0.4.1 → token_tracker-0.4.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "token-tracker"
-version = "0.4.1"
+version = "0.4.3"
 description = "Track token usage across local AI agents (Claude Code, Codex)"
 readme = "README.md"
 requires-python = ">=3.11"

{token_tracker-0.4.1 → token_tracker-0.4.3}/src/token_tracker/analyzer/cost.py

@@ -28,6 +28,21 @@ _FAMILY_FALLBACK = (
     ("claude-haiku", "claude-haiku-4-5-20251001"),
     ("claude-fable", "claude-fable-5"),
     ("codex-", "gpt-5.5"),
+    # 国产模型系列兜底：出新版本（如 GLM-4.8、Kimi K3）litellm 未收录时退回该系列最新已知价
+    ("kimi", "kimi-k2.6"),
+    ("moonshot-v", "moonshot-v1-128k"),
+    ("glm-4", "glm-4.6"),
+    ("qwen3-coder", "qwen3-coder-plus"),
+    ("qwen3-max", "qwen-max"),
+    ("doubao-seed", "doubao-seed-1-6"),
+    ("doubao-1-5-pro", "doubao-1-5-pro-256k"),
+    ("deepseek", "deepseek-v4-flash"),
+    ("minimax", "MiniMax-M2"),
+    ("mimo", "mimo-v2.5"),
+    # Grok：退役 slug 按官方路由兜底（grok-code-* → build-0.1；grok-4-fast/4.1-fast/grok-3 等 → grok-4.3）
+    ("grok-code", "grok-build-0.1"),
+    ("grok-4", "grok-4.3"),
+    ("grok", "grok-4.3"),
 )
 
 # 解析不到定价的模型只提示一次，避免聚合时每条 entry 刷屏
@@ -195,6 +210,31 @@ _FABLE_PRICING = {
     "cache_read_input_token_cost": 1.0e-6,
 }
 
+# 国产模型多以人民币计价，统一折 USD 入表，与 CC/Codex 同口径（2026-06 近似汇率）
+_CNY_PER_USD = 7.1
+
+
+def _cny(input_m: float, output_m: float, cache_read_m: float | None = None) -> dict:
+    """人民币「元 / 百万 tokens」→ USD per token（÷汇率 ÷1e6）。国产模型按中国站人民币价折算。"""
+    info = {
+        "input_cost_per_token": input_m / _CNY_PER_USD * 1e-6,
+        "output_cost_per_token": output_m / _CNY_PER_USD * 1e-6,
+    }
+    if cache_read_m is not None:
+        info["cache_read_input_token_cost"] = cache_read_m / _CNY_PER_USD * 1e-6
+    return info
+
+
+def _usd(input_m: float, output_m: float, cache_read_m: float | None = None) -> dict:
+    """美元「$ / 百万 tokens」→ USD per token（÷1e6）。用于只有官方国际站 USD 价的模型。"""
+    info = {
+        "input_cost_per_token": input_m * 1e-6,
+        "output_cost_per_token": output_m * 1e-6,
+    }
+    if cache_read_m is not None:
+        info["cache_read_input_token_cost"] = cache_read_m * 1e-6
+    return info
+
 
 def _fallback_pricing() -> dict:
     return {
@@ -249,4 +289,47 @@ def _fallback_pricing() -> dict:
             "output_cost_per_token": 6e-6,
             "cache_read_input_token_cost": 0.375e-6,
         },
+        # ---- 国产模型（2026-06 官方核实）。除 GLM 用 z.ai 国际站 USD 外，其余按各家中国站
+        # 人民币价 ÷7.1 折算；阶梯定价模型（Qwen3-Coder / Doubao）统一取 0-32K 基础档。----
+        # Kimi / Moonshot（platform.kimi.com 官方人民币价；老 kimi-k2-instruct 已 EOL，靠系列兜底）
+        "kimi-k2.7-code": _cny(6.5, 27, 1.3),
+        "kimi-k2.6": _cny(6.5, 27, 1.1),
+        "kimi-k2.5": _cny(4, 21, 0.7),
+        "moonshot-v1-8k": _cny(2, 10),
+        "moonshot-v1-32k": _cny(5, 20),
+        "moonshot-v1-128k": _cny(10, 30),
+        # 智谱 GLM（z.ai 国际站官方 USD；中国站按量完整价含缓存无法从官方 SPA 取得，国内口径可能偏高）
+        "glm-4.6": _usd(0.6, 2.2, 0.11),
+        "glm-4.5": _usd(0.6, 2.2, 0.11),
+        "glm-4.5-air": _usd(0.2, 1.1, 0.03),
+        "glm-4.7": _usd(0.6, 2.2, 0.11),
+        "glm-5": _usd(1.0, 3.2, 0.2),
+        # 阿里 Qwen（中国站百炼人民币价，0-32K 基础档）
+        "qwen3-coder-plus": _cny(4, 16, 0.4),
+        "qwen-max": _cny(2.5, 10),
+        "qwen-plus": _cny(0.8, 2),
+        # 火山方舟 Doubao（中国站人民币价，0-32K 基础档）
+        "doubao-seed-1-6": _cny(0.8, 8),
+        "doubao-seed-code": _cny(1.2, 8),
+        "doubao-1-5-pro-32k": _cny(0.8, 2, 0.16),
+        "doubao-1-5-pro-256k": _cny(5, 9),
+        # DeepSeek（官方中国站人民币价；chat/reasoner 现映射 V4-Flash，2026-07-24 弃用旧名）
+        "deepseek-v4-flash": _cny(1, 2, 0.02),
+        "deepseek-v4-pro": _cny(3, 6, 0.025),
+        "deepseek-chat": _cny(1, 2, 0.02),
+        "deepseek-reasoner": _cny(1, 2, 0.02),
+        # MiniMax（官方 USD，与中国站÷7 自洽；M2/M2.1/M2.5 同价 legacy）
+        "MiniMax-M2": _usd(0.3, 1.2, 0.03),
+        "MiniMax-M2.1": _usd(0.3, 1.2, 0.03),
+        "MiniMax-M2.5": _usd(0.3, 1.2, 0.03),
+        "MiniMax-M2.7": _usd(0.3, 1.2, 0.06),
+        "MiniMax-M3": _usd(0.3, 1.2, 0.06),
+        # 小米 MiMo（mimo.mi.com 官方中国站人民币价；与 DeepSeek 同价，V2.5-Pro 主攻 agentic 编程）
+        "mimo-v2.5-pro": _cny(3, 6, 0.025),
+        "mimo-v2.5": _cny(1, 2, 0.02),
+        # xAI Grok（docs.x.ai 官方 USD）。2026-05-15 退役潮：grok-4-fast/4.1-fast/grok-3 路由到 grok-4.3，
+        # grok-code-fast-1 退役为 grok-build-0.1 别名（退役 slug 靠 _FAMILY_FALLBACK 接住）。grok-4.3 取 ≤200K 默认档。
+        "grok-4.3": _usd(1.25, 2.5, 0.2),
+        "grok-build-0.1": _usd(1.0, 2.0, 0.2),
+        "grok-code-fast-1": _usd(1.0, 2.0, 0.2),
     }

{token_tracker-0.4.1 → token_tracker-0.4.3}/src/token_tracker/cli.py

@@ -386,18 +386,15 @@ def main():
         update_hook()
 
     # 升级感知：新版若新增了值得重配的选项（SETUP_VERSION bump），老用户跑任意命令时
-    # 真终端直接弹一次 wizard；非 tty / 会话内只打印一行提示、不打断。
-    # wizard 内部最终会调 setup() → save_setup_version()，下次启动不再触发。
+    # 自动走一遍 setup——_run_setup_flow 内部分流：真终端弹 wizard、会话内 / 非 tty 静默
+    # _auto_setup 用默认值全装（语言跟随系统 / mocha / 组件全开）。两者最终都 save_setup_version()，
+    # 下次启动 setup_version 已是最新、不再触发。
     if (
         command not in ("setup", "unsetup")
         and is_setup()
         and config.setup_version() < config.SETUP_VERSION
     ):
-        if _should_run_wizard():
-            from .wizard import run_wizard
-            run_wizard()
-        else:
-            get_console().print(f"[dim]{t('setup_outdated_hint')}[/dim]")
+        _run_setup_flow()
 
     if command == "setup":
         _run_setup_flow()

{token_tracker-0.4.1 → token_tracker-0.4.3}/src/token_tracker/config.py

@@ -18,10 +18,11 @@ CONFIG_DIR = os.path.expanduser("~/.config/token-tracker")
 CONFIG_PATH = os.path.join(CONFIG_DIR, "config.json")
 SCHEMA_VERSION = 1
 
-# 引导版本：每次新增"值得让老用户重新走一遍 wizard"的配置项时手动 +1。
-# 老用户 config 里没这字段 → 读出 0 → 触发重新引导（真终端弹 wizard、非 tty 仅提示）。
+# 引导版本：每次新增"值得让老用户重新走一遍 setup"的配置项时手动 +1（只能整数、一次 +1）。
+# 老用户 config 里没这字段 / 旧版本号 < 当前 → 触发重新引导（真终端弹 wizard、非 tty 静默 _auto_setup）。
 # 跟 SCHEMA_VERSION 解耦：那是数据格式版本，这是用户引导版本，bump 节奏完全不同。
-SETUP_VERSION = 1
+# 2（0.4.2）：强制所有现存用户（0.3.8/0.4.0=无字段=0、0.4.1=1，全 < 2）升级后重走一遍 setup。
+SETUP_VERSION = 2
 
 # 旧位置（独立 theme.json / lang.json），老用户首次读 config.json 不存在时自动合并迁移
 _LEGACY_THEME_PATH = os.path.join(CONFIG_DIR, "theme.json")

{token_tracker-0.4.1 → token_tracker-0.4.3}/src/token_tracker/i18n.py

@@ -50,7 +50,6 @@ _STRINGS = {
         "col_cache_read": "Cache读取",
         "model_breakdown": "模型分布",
         "col_ratio": "占比",
-        "col_duration": "活跃/时长",
         "daily_panel_title": "当日数据面板 (P90)",
         "msg_unit": "{n} 条",
         "session_msg": "会话: {sessions}  消息: {msgs}",
@@ -72,8 +71,7 @@ _STRINGS = {
         "active_days": "活跃天数",
         "weekday_grid": "周日,周一,周二,周三,周四,周五,周六",  # 热力图左侧行标签（周日开头）
         "month_short": "1月,2月,3月,4月,5月,6月,7月,8月,9月,10月,11月,12月",  # 热力图月份表头
-        "unit_day": "天",   # 时长 / 连续天数单位
-        "unit_hour": "小时",  # 时长单位
+        "unit_day": "天",   # 连续天数单位（daily streak）
         # --- theme (cli.py) ---
         "theme_current": "当前主题: {name}{src}",
         "theme_src_env": "（来自环境变量 TT_THEME）",
@@ -100,9 +98,8 @@ _STRINGS = {
         "wizard_signoff": "祝你使用愉快",
         # --- hooks.py ---
         "no_agent_install": "未检测到 Claude Code 或 Codex，请先安装其中之一",
-        "auto_setup_hint": "非交互环境，已按默认（语言跟随系统 / 主题 mocha / 组件全开）配置；如需自定义请在终端运行 tt setup",
+        "auto_setup_hint": "非交互环境，已按默认（语言跟随系统 / 主题 mocha / 组件全开）配置\n如需自定义请在终端运行 tt setup",
         "first_setup": "首次使用，正在配置状态栏...",
-        "setup_outdated_hint": "检测到新版本新增了配置项；请在终端运行 tt setup 体验",
         "cc_not_found": "未检测到 Claude Code，跳过",
         "codex_not_found": "未检测到 Codex，跳过",
         "sl_backup_replace": "检测到已有 statusLine，备份后替换",
@@ -168,7 +165,6 @@ _STRINGS = {
         "col_cache_read": "Cache Read",
         "model_breakdown": "Model Distribution",
         "col_ratio": "Ratio",
-        "col_duration": "Active/Duration",
         "daily_panel_title": "Daily Panel (P90)",
         "msg_unit": "{n}",
         "session_msg": "Sessions: {sessions}  Messages: {msgs}",
@@ -190,8 +186,7 @@ _STRINGS = {
         "active_days": "Active Days",
         "weekday_grid": "Sun,Mon,Tue,Wed,Thu,Fri,Sat",  # 热力图左侧行标签（Sun 开头）
         "month_short": "Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec",  # 热力图月份表头
-        "unit_day": "d",   # 时长 / 连续天数单位
-        "unit_hour": "h",  # 时长单位
+        "unit_day": "d",   # 连续天数单位（daily streak）
         # --- theme (cli.py) ---
         "theme_current": "Current theme: {name}{src}",
         "theme_src_env": " (from env TT_THEME)",
@@ -218,9 +213,8 @@ _STRINGS = {
         "wizard_signoff": "Enjoy!",
         # --- hooks.py ---
         "no_agent_install": "Claude Code or Codex not detected, please install one first",
-        "auto_setup_hint": "Non-interactive env — configured with defaults (language follows system / theme mocha / all components on); run tt setup in a terminal to customize",
+        "auto_setup_hint": "Non-interactive env — configured with defaults (language follows system / theme mocha / all components on)\nRun tt setup in a terminal to customize",
         "first_setup": "First run, configuring status bar...",
-        "setup_outdated_hint": "New configuration options added in this release — run tt setup in a terminal to try them",
         "cc_not_found": "Claude Code not detected, skipping",
         "codex_not_found": "Codex not detected, skipping",
         "sl_backup_replace": "Existing statusLine detected, backing up and replacing",