token-tracker 0.4.2__tar.gz → 0.4.4__tar.gz

{token_tracker-0.4.2/src/token_tracker.egg-info → token_tracker-0.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: token-tracker
-Version: 0.4.2
+Version: 0.4.4
 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.4/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.2 → token_tracker-0.4.4}/pyproject.toml

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

{token_tracker-0.4.2 → token_tracker-0.4.4}/src/token_tracker/hooks.py

@@ -690,7 +690,8 @@ _CODEX_STATUSLINE_REGEX = re.compile(
     r'\n*\[\[hooks\.Stop\]\]\s*'
     r'\[\[hooks\.Stop\.hooks\]\]\s*'
     r'type = "command"\s*'
-    r'command = "[^"]*(?:codex-statusline|tt-statusline)[^"]*"\s*'
+    # command 兼容双引号 basic string（老用户已装）和单引号 literal string（修了 Windows 路径转义后的新装）
+    r'command = ["\'][^"\']*(?:codex-statusline|tt-statusline)[^"\']*["\']\s*'
     r'timeout = \d+\s*'
 )
 
@@ -712,7 +713,9 @@ def _install_codex_statusline(content: str, python: str) -> str:
         "\n\n[[hooks.Stop]]\n\n"
         "[[hooks.Stop.hooks]]\n"
         'type = "command"\n'
-        f'command = "{cmd}"\n'
+        # 用 TOML literal string（单引号）包裹 command，避免 Windows 反斜杠路径被当转义符
+        # 解析失败（如 `C:\Users\...` 里的 `\U` 被识别为 unicode 转义起始）
+        f"command = '{cmd}'\n"
         "timeout = 10\n"
     )
 

{token_tracker-0.4.2 → token_tracker-0.4.4}/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,7 +98,7 @@ _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": "首次使用，正在配置状态栏...",
         "cc_not_found": "未检测到 Claude Code，跳过",
         "codex_not_found": "未检测到 Codex，跳过",
@@ -167,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}",
@@ -189,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)",
@@ -217,7 +213,7 @@ _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...",
         "cc_not_found": "Claude Code not detected, skipping",
         "codex_not_found": "Codex not detected, skipping",

{token_tracker-0.4.2 → token_tracker-0.4.4}/src/token_tracker/ui/format.py

@@ -5,7 +5,6 @@ from zoneinfo import ZoneInfo
 
 from rich.text import Text
 
-from ..i18n import t
 from .console import get_console
 from .theme import _S
 
@@ -124,19 +123,6 @@ def _fmt_cost(usd: float) -> str:
     return "$0"
 
 
-def _fmt_session_duration(active_minutes: float, span_minutes: float) -> str:
-    """组合显示「活跃 / 跨度」：活跃恒用小数小时（9.4h）；跨度 ≥1 天用 天d时h（22d14h，整天省为 22d），<1 天用小数小时（6.0h）。单位 d/h 跟随语言。"""
-    hour, day = t("unit_hour"), t("unit_day")
-    active = f"{active_minutes / 60:.1f}{hour}"
-    if span_minutes >= 1440:
-        d, rem = divmod(int(span_minutes), 1440)
-        h = rem // 60
-        span = f"{d}{day}{h}{hour}" if h else f"{d}{day}"
-    else:
-        span = f"{span_minutes / 60:.1f}{hour}"
-    return f"{active} / {span}"
-
-
 def _display_width(s: str) -> int:
     w = 0
     for ch in s:

{token_tracker-0.4.2 → token_tracker-0.4.4}/src/token_tracker/ui/status.py

@@ -19,7 +19,6 @@ from .format import (
     AGENT_LABEL,
     AGENT_SHORT,
     _fmt_cost,
-    _fmt_session_duration,
     _fmt_tokens,
     _model_short,
     _project_short,
@@ -142,7 +141,7 @@ def _render_agent_stats(per_agent: dict) -> None:
 
 def _render_sessions(sessions) -> None:
     """合并 session 列表：按 cost 倒序；Time 蓝 / Project 绿 / Tokens 橙 / Cost 黄；
-    Tokens·Cost 各自前三（第一红、二三粉）；列序 Time·Project·Tokens·Cost·Msgs·Duration·Model·Agent。"""
+    Tokens·Cost 各自前三（第一红、二三粉）；列序 Time·Project·Tokens·Cost·Msgs·Model·Agent。"""
     mode = _width_mode()
     table = Table(title=f"{t('recent_sessions')} ({len(sessions)})", box=box.SIMPLE_HEAVY,
                   header_style="bold", padding=(0, 1), expand=False)
@@ -151,7 +150,6 @@ def _render_sessions(sessions) -> None:
     table.add_column(t("col_total_tokens"), justify="right", style=_S.peach)
     table.add_column(t("col_cost"), justify="right", style=_S.warn)
     table.add_column(t("col_messages"), justify="right")
-    table.add_column(t("col_duration"), justify="right")
     if mode != "compact":
         table.add_column(t("col_model"), no_wrap=True)
     table.add_column(t("col_agent"), no_wrap=True)
@@ -173,11 +171,10 @@ def _render_sessions(sessions) -> None:
             tok_cell,
             cost_cell,
             str(s.message_count),
-            _fmt_session_duration(s.active_minutes, s.duration_minutes),
         ]
         if mode != "compact":
             names = list(s.models) or [s.model]
-            row.append(", ".join(_model_short(n) for n in names[:2]))
+            row.append(_model_short(names[0]))
         row.append(AGENT_SHORT.get(s.agent_id, s.agent_id))
         table.add_row(*row)
     get_console().print(Padding(table, (0, 0, 0, 2), expand=False))

{token_tracker-0.4.2 → token_tracker-0.4.4/src/token_tracker.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: token-tracker
-Version: 0.4.2
+Version: 0.4.4
 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.2 → token_tracker-0.4.4}/tests/test_aggregator.py

@@ -119,17 +119,6 @@ def test_aggregate_sessions_active_minutes_drops_large_gaps():
     assert s.duration_minutes == round((3 * 24 * 60) + 10, 1)
 
 
-def test_fmt_session_duration_combines_active_and_span():
-    from token_tracker.i18n import t
-    from token_tracker.ui.format import _fmt_session_duration
-    h, d = t("unit_hour"), t("unit_day")  # 单位跟随语言，断言保持语言无关
-    # 活跃恒小数小时；跨度 ≥1 天用 天d时h（整天省略小时），<1 天用小数小时
-    assert _fmt_session_duration(564, 32520) == f"9.4{h} / 22{d}14{h}"        # 主例：活跃 9h24m / 跨度 22d14h
-    assert _fmt_session_duration(9 * 60, 22 * 24 * 60) == f"9.0{h} / 22{d}"   # 整天跨度省略小时
-    assert _fmt_session_duration(5 * 60, 6 * 60) == f"5.0{h} / 6.0{h}"        # 跨度 <1 天用小数小时
-    assert _fmt_session_duration(45, 90) == f"0.8{h} / 1.5{h}"               # 活跃/跨度均不足 1h/1 天
-
-
 def test_aggregate_fills_projects_by_token():
     # projects 维度（weekly 项目分布用）：按 project 累加 token，与 models 同机制
     d = datetime(2026, 1, 1, 10, tzinfo=UTC)

{token_tracker-0.4.2 → token_tracker-0.4.4}/tests/test_hooks.py

@@ -80,6 +80,19 @@ def test_codex_statusline_install_uninstall_roundtrip(tmp_path, monkeypatch):
     assert "tt-statusline" not in removed and 'command = "mine"' in removed
 
 
+def test_codex_statusline_windows_path_toml_parses(tmp_path, monkeypatch):
+    # 回归：Windows 路径含 \U \A \P 等被 TOML basic string 当 unicode 转义起始符（issue 用户反馈）
+    # —— 写入的 command 必须用 literal string（单引号）包裹，写出来后能被 tomllib 原样解析回来。
+    import tomllib
+    monkeypatch.setattr(hooks, "CODEX_STATUSLINE_HOOK_PATH",
+                        r"C:\Users\test\.config\token-tracker\codex-statusline.py")
+    py = r"C:\Users\test\AppData\Local\Programs\Python\Python313\python.exe"
+    content = hooks._install_codex_statusline("", py)
+    parsed = tomllib.loads(content)  # 旧 bug：basic string 下 \U 等触发 TOML 解析错误
+    assert parsed["hooks"]["Stop"][0]["hooks"][0]["command"] == \
+        rf"{py} C:\Users\test\.config\token-tracker\codex-statusline.py"
+
+
 def test_codex_statusline_version_roundtrip(tmp_path, monkeypatch):
     # _installed_codex_statusline_version 读回的版本应与写入的 STATUSLINE_HOOK_VERSION 一致，
     # 保证 needs_update 不会因解析偏差而误判。

{token_tracker-0.4.2 → token_tracker-0.4.4}/tests/test_status.py

@@ -26,13 +26,14 @@ def test_build_status_data_merges_and_per_agent(monkeypatch):
     # 头图合并汇总 + per-agent 拆分 + session 合并带 agent_id 且按 cost 倒序（entries 给跨度，避免被 0min 过滤）。
     now = datetime.now(UTC)
     data_map = {
+        # 用「现在前 1 小时内」避免 UTC 凌晨跑 CI 时跨日被 _build_status_data 今天过滤掉
         "claude-code": [  # s1 跨度 10min
-            _entry("claude-code", "s1", "claude-opus-4-8", now - timedelta(hours=1), out=500),
-            _entry("claude-code", "s1", "claude-opus-4-8", now - timedelta(minutes=50), out=100),
+            _entry("claude-code", "s1", "claude-opus-4-8", now - timedelta(minutes=30), out=500),
+            _entry("claude-code", "s1", "claude-opus-4-8", now - timedelta(minutes=20), out=100),
         ],
         "codex": [  # s2 跨度 6min
-            _entry("codex", "s2", "gpt-5", now - timedelta(hours=2), out=20),
-            _entry("codex", "s2", "gpt-5", now - timedelta(hours=1, minutes=54), out=10),
+            _entry("codex", "s2", "gpt-5", now - timedelta(minutes=40), out=20),
+            _entry("codex", "s2", "gpt-5", now - timedelta(minutes=34), out=10),
         ],
     }
     monkeypatch.setattr(cli, "_load_entries", lambda aid, hours_back=0: data_map.get(aid, []))
@@ -74,7 +75,7 @@ def test_build_status_data_empty(monkeypatch):
 
 
 def test_render_status_with_limits(monkeypatch):
-    # 有订阅额度 → 额度段（weekly 样式）；session 强制 source 列 + Duration。
+    # 有订阅额度 → 额度段（weekly 样式）；session 强制 source 列。
     monkeypatch.setattr("token_tracker.ui.status.forced_color_console", contextlib.nullcontext)
     now = datetime.now(UTC)
     summary = StatusSummary(total_tokens=1000, cost_usd=1.5, message_count=5, session_count=2,
@@ -98,9 +99,6 @@ def test_render_status_with_limits(monkeypatch):
     assert "Cost:" in out and "$12" in out     # 当天 cost
     assert "Model:" in out and "Opus 4.8" in out  # model（去掉 (1M context) 后缀）
     assert "Claude" in out and "Codex" in out  # session Agent 列（短名 Claude / Codex）
-    from token_tracker.i18n import t
-    h = t("unit_hour")  # 单位跟随语言
-    assert f"1.1{h} / 1.1{h}" in out           # Duration 组合：活跃 / 跨度（65min 连续会话，小数小时）
 
 
 def test_render_status_no_limits_shows_agent_stats(monkeypatch):

token_tracker-0.4.2/README.md

@@ -1,190 +0,0 @@
-# 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)
-
-## StatusLine 状态栏
-
-自动为 Claude Code 和 Codex 配置状态栏，`tt setup` 一键配置，脚本更新时自动升级。
-
-**Claude Code**：基于官方自定义 StatusLine 接口，数据完全来自本地 Claude，准确无任何推测
-
-![Claude Code StatusLine](assets/screenshot-statusline-cc.png)
-
-状态栏共四行，从左到右：
-
-| 行 | 字段 | 说明 |
-|----|------|------|
-| 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。
-
-**Codex**：官方暂不支持自定义 StatusLine，`tt setup` 通过 Codex `Stop` hook 装一个**伪 statusline**——每次回答完成后在回答尾部追加**两行**彩色 status，仿 Claude Code 状态栏（不再接管 Codex 官方 `status_line`，伪 statusline 信息比官方字段更全）：
-
-![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` 一并移除。
-
-## 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`：聚焦**过去 5 小时**的实时面板——顶部多 Agent **合并**概览（Token / Cost / Sessions / Messages / Top Model），中间 **5h / 7d 订阅额度**进度条（Claude Code / Codex 分开；都没订阅额度时换成 per-agent 的 token/cost/sessions/messages 统计），底部**近期会话**列表（CC + Codex 合并、带 Agent 列、按 Cost 倒序、Cost 前三名高亮）。所有时间按**系统时区**显示，配色跟随当前主题。
-
-![Token Tracker Daily](assets/screenshot-daily.png)
-
-![Token Tracker Status](assets/screenshot.png)
-
-![Token Tracker Weekly](assets/screenshot-weekly.png)
-
-![Token Tracker Monthly](assets/screenshot-monthly.png)
-
-## 功能
-
-- **多 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，直接读取本地数据
-- **隐私安全** — 数据纯本地存储，不采集、不上传任何用户信息，极轻量无后顾之忧
-
-## 安装
-
-```bash
-curl -sSL https://raw.githubusercontent.com/stormzhang/token-tracker/main/install.sh | bash
-```
-
-脚本自动选最优安装方式（uv / pipx / 私有 venv），绕开 PEP 668、不污染系统 Python。
-
-> **升级**：重跑上面的命令即可（脚本幂等、自动升到最新）。
-> **卸载**：先 `tt unsetup` 还原状态栏，再按装法移除（`uv tool uninstall token-tracker` / `pipx uninstall token-tracker` / 删 `~/.local/share/token-tracker` 与 `~/.local/bin/tt`）。
-
-## 使用
-
-```bash
-tt setup          # 交互配置向导（终端：上下键选语言 / 主题 / 各组件）；非 tty 环境自动全装
-tt                # 过去一年 token 热力图 + 顶部三段概览（Last 12 months / This Month / This Week，= 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 theme          # 查看 / 切换配色主题（show / list / set / preview）
-tt unsetup        # 卸载并恢复安装前的配置
-```
-
-> 💡 `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 **统一同源**（切主题三者一起变）：
-
-| 主题 | 说明 |
-|------|------|
-| `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  # 任意报表临时换主题渲染（不持久化、不动状态栏，适合对比）
-```
-
-- **首次运行**（终端内、非 AI 会话）会进入交互向导引导选主题；CI / 脚本 / 会话内自动跳过、静默用默认。
-- 切换持久化到 `~/.config/token-tracker/config.json`（主题 + 语言 + 组件意图统一存这一个文件）；优先级 `--theme` 参数 > `TT_THEME` 环境变量 > 配置文件 > 自动（`--theme` 和 `TT_THEME` 都只临时生效、不写配置）。
-- 终端支持 truecolor 用精确配色；不支持的（如 macOS 自带 Terminal.app）自动降级到当前主题的 **256 色近似**，8 色老终端不再适配。
-
-### 报告排序
-
-所有报告命令支持 `--sort` 和 `--asc/--desc` 参数：
-
-```bash
-tt weekly --sort cost --desc    # 按成本降序
-tt sessions --sort tokens --asc # 按 token 升序
-```
-
-可选排序字段：`tokens` / `cost` / `messages` / `time` / `input` / `output`
-
-### Dashboard 快捷键
-
-| 按键 | 功能 |
-|------|------|
-| `←` `→` | 切换 Agent |
-| `↑` `↓` | 滚动内容 |
-| `s` | 切换排序字段（时间 → Token → 等效成本 → 消息数） |
-| `r` | 反转排序方向 |
-| `+` / `-` | 调整会话显示条数（±10，最少 10 条） |
-| `q` | 退出 |
-
-## 数据来源
-
-| Agent | 路径 | 格式 |
-|-------|------|------|
-| Claude Code | `~/.claude/projects/*/` | JSONL（逐消息用量） |
-| Codex | `~/.codex/sessions/` | JSONL + SQLite |
-
-路径跨平台：Windows 下 `~` 解析到 `%USERPROFILE%`（如 `C:\Users\xxx\.claude`）。设了 `CLAUDE_CONFIG_DIR` / `CODEX_HOME` 环境变量（官方支持的自定义目录）时自动跟随。
-
-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.