token-tracker 0.4.6__tar.gz → 0.4.8__tar.gz

{token_tracker-0.4.6/src/token_tracker.egg-info → token_tracker-0.4.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: token-tracker
-Version: 0.4.6
+Version: 0.4.8
 Summary: Track token usage across local AI agents (Claude Code, Codex)
 Author-email: stormzhang <stormzhang.dev@gmail.com>
 License: MIT License
@@ -42,11 +42,14 @@ Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: rich>=13.7
-Requires-Dist: questionary>=2.0
+Requires-Dist: questionary<3,>=2.0
+Requires-Dist: textual>=1.0
 Provides-Extra: test
 Requires-Dist: pytest>=8.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.24; extra == "test"
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.24; extra == "dev"
 Requires-Dist: ruff>=0.6; extra == "dev"
 Requires-Dist: mypy>=1.8; extra == "dev"
 Dynamic: license-file
@@ -67,6 +70,7 @@ Dynamic: license-file
 
 - **多 Agent 统一追踪** — Claude Code + Codex 统一读取，多 Agent 按来源分组
 - **状态栏集成** — Claude Code 用官方 StatusLine 接口；**Codex 业界首创伪 statusline 方案**（hook 注入两行真彩色状态栏，把官方未开放的能力在 Codex 里做了出来）
+- **实时侧边栏** — `tt sidebar` 窄窗格常驻面板：全部活跃会话一屏总览（状态灯 + 最近提示词 + 「下一步」建议），点击会话直达对应 iTerm2 / tmux 窗格
 - **限额监控** — 实时 5h / 7d 配额百分比 + 重置倒计时
 - **多维成本分析** — 会话 / 日 / 周 / 月多维报表，等效成本统计
 - **定价识别** — litellm 在线定价 + 内置官方价双层兜底，覆盖 Claude / OpenAI / Gemini / Grok 及国产主流（Kimi / GLM / Qwen / 豆包 / DeepSeek / MiniMax / MiMo）；新模型自动套用同系列定价、不静默归零
@@ -83,6 +87,8 @@ Dynamic: license-file
 
 基于 Claude Code 官方自定义 StatusLine 接口，**数据完全来自本地 Claude，无任何推测**。
 
+> 状态栏接管是**可选**的：已有自定义 statusLine 时默认保留你的配置（向导里也可随时选 No），报表命令完全不受影响。注意：不接管时 `tt status` 的 CC 订阅额度段将没有数据来源（CC 配额只经状态栏脚本落盘）。
+
 ![Claude Code StatusLine](assets/screenshot-statusline-cc.png)
 
 <details>
@@ -122,7 +128,7 @@ Codex 官方暂不支持自定义 StatusLine。Token Tracker 通过 hook 注入
 
 ## 报表速览
 
-`tt status` — 过去 5h 实时面板（合并概览 + 5h/7d 额度 + 近期会话）
+`tt status` — 今日实时面板（今日合并概览 + 5h/7d 额度 + 今日会话）
 
 ![Status](assets/screenshot.png)
 
@@ -138,6 +144,19 @@ Codex 官方暂不支持自定义 StatusLine。Token Tracker 通过 hook 注入
 
 ![Sessions](assets/screenshot-sessions.png)
 
+## 实时侧边栏（`tt sidebar`）
+
+在终端分屏 / tmux 窄窗格里常驻，一屏总览本机所有 AI 会话：
+
+- **活跃会话列表** — 过去 5h 内有动静的会话（Claude Code + Codex），按最近活动排序取前 10；头行显示状态灯、`项目名(分支)`、agent、模型与距上次活动时间
+- **三地时钟** — 北京、洛杉矶、伦敦合并为一行，只显示城市与 `HH:MM`
+- **提示词历史** — 运行中、待确认、等输入会话保留最近 5 条，历史最多 1 行、最新最多 2 行；空闲会话只显示最新 1 条，不显示「下一步」
+- **状态灯** — 运行中（星形动画）/ 需要关注（工具调用无结果，大概率在等授权）/ 等输入 / 空闲
+- **「下一步」建议** — 从 AI 最后一条回复的收尾段提取征询 / 待办（纯规则，不走模型）；AI 正在用 AskUserQuestion 提问时直接显示问题与选项
+- **点击跳转** — 点会话头行直接切换到它所在的 iTerm2 / tmux 窗格（需启用对应 Agent 的状态栏组件提供映射；Codex 在下一次回答完成后建立映射；iTerm2 首次点击会弹 macOS 自动化授权，属预期）
+
+操作：鼠标拖拽选择文字，松开后自动复制；滚轮 / 方向键 / PgUp/PgDn 滚动，`q` / `Esc` / `Ctrl+C` 退出；`tt sidebar --once` 打印一帧快照即退。数据每 5s 刷新，只读本地会话记录、不写任何产物；加 `--claude` / `--codex` 可只看单个 agent。
+
 ## 安装
 
 ```bash
@@ -159,18 +178,21 @@ curl -sSL https://raw.githubusercontent.com/stormzhang/token-tracker/main/instal
 ## 使用
 
 ```bash
-tt setup          # 交互配置向导（终端：上下键选语言 / 主题 / 各组件）；非 tty 环境自动全装
+tt setup          # 交互配置向导（终端：上下键选语言 / 主题 / 各组件）；非 tty 环境按推荐默认自动配置
 tt                # 过去一年 token 热力图 + 顶部三段概览（= tt daily）
 tt daily          # 同上（tt 无参即进 daily）
-tt status         # 过去 5h 实时面板
+tt status         # 今日消耗、5h/7d 额度与今日会话
 tt weekly         # 周报
 tt monthly        # 月报
-tt sessions       # 最近 20 条会话明细（tt sessions <n> 改条数、--sort 改排序）
+tt sessions       # 最近 20 条会话明细（tt sessions <正整数> 改条数、--sort 改排序）
+tt sidebar        # 常驻侧边栏：活跃会话总览 + 提示词历史 + 状态灯 + 点击跳转（--once 一帧快照）
 tt theme          # 查看 / 切换配色主题（show / list / set / preview）
 tt unsetup        # 卸载并恢复安装前的配置
 tt --version      # 查看版本（-v / -V 同义）
 ```
 
+> 多 agent 环境下想只看某一个 agent 的报表，加 `--claude` 或 `--codex` 即可（互斥），对 `status` / `daily` / `weekly` / `monthly` / `sessions` 均生效。例如 `tt daily --codex` 只显示 Codex 的热力图。会话内的 `daily` / `weekly` 默认已自动跟随当前会话的 agent，显式 flag 会覆盖该行为。
+
 > 💡 `tt daily` 是 GitHub 风格的 token 贡献热力图（深浅绿方格）。在 Claude Code 会话里输入 `!tt daily` 即可看到彩色热力图 —— 用户主动用 `!` 执行的命令，Claude Code 会渲染其 24-bit 真彩色输出。
 
 ## 配色主题
@@ -204,9 +226,10 @@ tt monthly --theme nord  # 任意报表临时换主题渲染（不持久化、
 
 1. **选语言** — 中文 / English（落 `~/.config/token-tracker/config.json`）
 2. **选配色主题** — 6 套主题上下键选择，每个选项右侧内联色板预览
-3. **启用 Codex 伪 statusline** — Yes/No（仅检测到 Codex 时）
+3. **接管 Claude Code 状态栏** — Yes/No（仅检测到 Claude Code 时；已有自定义 statusLine 会先备份、选 No 完全不碰）
+4. **启用 Codex 伪 statusline** — Yes/No（仅检测到 Codex 时）
 
-CI / 非 tty 环境（Docker / 脚本 / `curl|bash`）自动按默认全装：**语言跟随系统设置**、主题 mocha、组件全开。装好后想改任何一项，再跑一次 `tt setup` 即可。
+CI / 非 tty 环境（Docker / 脚本 / `curl|bash`）自动按**推荐默认**配置：语言跟随系统设置、主题 mocha、组件默认开启但**不替换已有自定义 statusLine**。装好后想改任何一项，再跑一次 `tt setup` 即可。
 
 ### 报告排序
 

{token_tracker-0.4.6 → token_tracker-0.4.8}/README.md

@@ -14,6 +14,7 @@
 
 - **多 Agent 统一追踪** — Claude Code + Codex 统一读取，多 Agent 按来源分组
 - **状态栏集成** — Claude Code 用官方 StatusLine 接口；**Codex 业界首创伪 statusline 方案**（hook 注入两行真彩色状态栏，把官方未开放的能力在 Codex 里做了出来）
+- **实时侧边栏** — `tt sidebar` 窄窗格常驻面板：全部活跃会话一屏总览（状态灯 + 最近提示词 + 「下一步」建议），点击会话直达对应 iTerm2 / tmux 窗格
 - **限额监控** — 实时 5h / 7d 配额百分比 + 重置倒计时
 - **多维成本分析** — 会话 / 日 / 周 / 月多维报表，等效成本统计
 - **定价识别** — litellm 在线定价 + 内置官方价双层兜底，覆盖 Claude / OpenAI / Gemini / Grok 及国产主流（Kimi / GLM / Qwen / 豆包 / DeepSeek / MiniMax / MiMo）；新模型自动套用同系列定价、不静默归零
@@ -30,6 +31,8 @@
 
 基于 Claude Code 官方自定义 StatusLine 接口，**数据完全来自本地 Claude，无任何推测**。
 
+> 状态栏接管是**可选**的：已有自定义 statusLine 时默认保留你的配置（向导里也可随时选 No），报表命令完全不受影响。注意：不接管时 `tt status` 的 CC 订阅额度段将没有数据来源（CC 配额只经状态栏脚本落盘）。
+
 ![Claude Code StatusLine](assets/screenshot-statusline-cc.png)
 
 <details>
@@ -69,7 +72,7 @@ Codex 官方暂不支持自定义 StatusLine。Token Tracker 通过 hook 注入
 
 ## 报表速览
 
-`tt status` — 过去 5h 实时面板（合并概览 + 5h/7d 额度 + 近期会话）
+`tt status` — 今日实时面板（今日合并概览 + 5h/7d 额度 + 今日会话）
 
 ![Status](assets/screenshot.png)
 
@@ -85,6 +88,19 @@ Codex 官方暂不支持自定义 StatusLine。Token Tracker 通过 hook 注入
 
 ![Sessions](assets/screenshot-sessions.png)
 
+## 实时侧边栏（`tt sidebar`）
+
+在终端分屏 / tmux 窄窗格里常驻，一屏总览本机所有 AI 会话：
+
+- **活跃会话列表** — 过去 5h 内有动静的会话（Claude Code + Codex），按最近活动排序取前 10；头行显示状态灯、`项目名(分支)`、agent、模型与距上次活动时间
+- **三地时钟** — 北京、洛杉矶、伦敦合并为一行，只显示城市与 `HH:MM`
+- **提示词历史** — 运行中、待确认、等输入会话保留最近 5 条，历史最多 1 行、最新最多 2 行；空闲会话只显示最新 1 条，不显示「下一步」
+- **状态灯** — 运行中（星形动画）/ 需要关注（工具调用无结果，大概率在等授权）/ 等输入 / 空闲
+- **「下一步」建议** — 从 AI 最后一条回复的收尾段提取征询 / 待办（纯规则，不走模型）；AI 正在用 AskUserQuestion 提问时直接显示问题与选项
+- **点击跳转** — 点会话头行直接切换到它所在的 iTerm2 / tmux 窗格（需启用对应 Agent 的状态栏组件提供映射；Codex 在下一次回答完成后建立映射；iTerm2 首次点击会弹 macOS 自动化授权，属预期）
+
+操作：鼠标拖拽选择文字，松开后自动复制；滚轮 / 方向键 / PgUp/PgDn 滚动，`q` / `Esc` / `Ctrl+C` 退出；`tt sidebar --once` 打印一帧快照即退。数据每 5s 刷新，只读本地会话记录、不写任何产物；加 `--claude` / `--codex` 可只看单个 agent。
+
 ## 安装
 
 ```bash
@@ -106,18 +122,21 @@ curl -sSL https://raw.githubusercontent.com/stormzhang/token-tracker/main/instal
 ## 使用
 
 ```bash
-tt setup          # 交互配置向导（终端：上下键选语言 / 主题 / 各组件）；非 tty 环境自动全装
+tt setup          # 交互配置向导（终端：上下键选语言 / 主题 / 各组件）；非 tty 环境按推荐默认自动配置
 tt                # 过去一年 token 热力图 + 顶部三段概览（= tt daily）
 tt daily          # 同上（tt 无参即进 daily）
-tt status         # 过去 5h 实时面板
+tt status         # 今日消耗、5h/7d 额度与今日会话
 tt weekly         # 周报
 tt monthly        # 月报
-tt sessions       # 最近 20 条会话明细（tt sessions <n> 改条数、--sort 改排序）
+tt sessions       # 最近 20 条会话明细（tt sessions <正整数> 改条数、--sort 改排序）
+tt sidebar        # 常驻侧边栏：活跃会话总览 + 提示词历史 + 状态灯 + 点击跳转（--once 一帧快照）
 tt theme          # 查看 / 切换配色主题（show / list / set / preview）
 tt unsetup        # 卸载并恢复安装前的配置
 tt --version      # 查看版本（-v / -V 同义）
 ```
 
+> 多 agent 环境下想只看某一个 agent 的报表，加 `--claude` 或 `--codex` 即可（互斥），对 `status` / `daily` / `weekly` / `monthly` / `sessions` 均生效。例如 `tt daily --codex` 只显示 Codex 的热力图。会话内的 `daily` / `weekly` 默认已自动跟随当前会话的 agent，显式 flag 会覆盖该行为。
+
 > 💡 `tt daily` 是 GitHub 风格的 token 贡献热力图（深浅绿方格）。在 Claude Code 会话里输入 `!tt daily` 即可看到彩色热力图 —— 用户主动用 `!` 执行的命令，Claude Code 会渲染其 24-bit 真彩色输出。
 
 ## 配色主题
@@ -151,9 +170,10 @@ tt monthly --theme nord  # 任意报表临时换主题渲染（不持久化、
 
 1. **选语言** — 中文 / English（落 `~/.config/token-tracker/config.json`）
 2. **选配色主题** — 6 套主题上下键选择，每个选项右侧内联色板预览
-3. **启用 Codex 伪 statusline** — Yes/No（仅检测到 Codex 时）
+3. **接管 Claude Code 状态栏** — Yes/No（仅检测到 Claude Code 时；已有自定义 statusLine 会先备份、选 No 完全不碰）
+4. **启用 Codex 伪 statusline** — Yes/No（仅检测到 Codex 时）
 
-CI / 非 tty 环境（Docker / 脚本 / `curl|bash`）自动按默认全装：**语言跟随系统设置**、主题 mocha、组件全开。装好后想改任何一项，再跑一次 `tt setup` 即可。
+CI / 非 tty 环境（Docker / 脚本 / `curl|bash`）自动按**推荐默认**配置：语言跟随系统设置、主题 mocha、组件默认开启但**不替换已有自定义 statusLine**。装好后想改任何一项，再跑一次 `tt setup` 即可。
 
 ### 报告排序
 

{token_tracker-0.4.6 → token_tracker-0.4.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "token-tracker"
-version = "0.4.6"
+version = "0.4.8"
 description = "Track token usage across local AI agents (Claude Code, Codex)"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -26,15 +26,20 @@ classifiers = [
 ]
 dependencies = [
     "rich>=13.7",
-    "questionary>=2.0",
+    # wizard 补丁挂在 questionary 私有内部（InquirerControl._get_choice_tokens 等），锁大版本防破坏
+    "questionary>=2.0,<3",
+    # 仅 tt sidebar live 模式用（cli 延迟 import，日常 tt 启动不加载）；与 rich 同门，渲染对象直接复用
+    "textual>=1.0",
 ]
 
 [project.optional-dependencies]
 test = [
     "pytest>=8.0",
+    "pytest-asyncio>=0.24",
 ]
 dev = [
     "pytest>=8.0",
+    "pytest-asyncio>=0.24",
     "ruff>=0.6",
     "mypy>=1.8",
 ]
@@ -58,12 +63,25 @@ target-version = "py311"
 # E501(行长)故意不开：状态栏 ANSI 色码串本就长，启用只产生噪音
 select = ["E4", "E7", "E9", "F", "W", "I", "UP", "B"]
 
+[tool.ruff.lint.per-file-ignores]
+# 状态栏脚本模板：__STATUSLINE_*__ 占位符是烘焙时注入的（F821 未定义名是模板本性）；
+# E701/E401/I001/UP015/UP017 是脚本既有风格（紧凑 import、timezone.utc 兼容手改老 python）——
+# 豁免以保持渲染产物与历史版本逐字节一致（模板内容 = 落盘脚本内容）
+"src/token_tracker/templates/*" = ["F821", "E701", "E401", "I001", "UP015", "UP017"]
+
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 addopts = "-q"
+# sidebar 的 Textual app 用 pilot 异步测试；auto 模式让 async def 用例免装饰器直接跑
+asyncio_mode = "auto"
 
 [tool.mypy]
 python_version = "3.11"
 ignore_missing_imports = true
 # 宽松起步，后续逐步收紧
 check_untyped_defs = true
+
+[[tool.mypy.overrides]]
+# 状态栏脚本模板含烘焙占位符（__STATUSLINE_*__），不是可独立类型检查的模块
+module = "token_tracker.templates.*"
+ignore_errors = true

{token_tracker-0.4.6 → token_tracker-0.4.8}/src/token_tracker/adapters/claude.py

@@ -3,7 +3,7 @@ from datetime import UTC, datetime
 from pathlib import Path
 
 from .types import AgentInfo, UsageEntry
-from .util import claude_home, iter_jsonl_dicts, project_from_cwd
+from .util import claude_home, file_may_have_events_since, iter_jsonl_dicts, project_from_cwd
 
 CLAUDE_DIRS = [
     os.path.join(claude_home(), "projects"),
@@ -31,6 +31,8 @@ def load_entries(hours_back: int = 0) -> list[UsageEntry]:
         if not base.is_dir():
             continue
         for jsonl_path in base.rglob("*.jsonl"):
+            if not file_may_have_events_since(jsonl_path, cutoff):
+                continue
             fallback_project = _extract_project_from_dir(jsonl_path, base)
             _parse_jsonl(jsonl_path, fallback_project, entries, seen, cutoff)
 

{token_tracker-0.4.6 → token_tracker-0.4.8}/src/token_tracker/adapters/codex.py

@@ -4,7 +4,7 @@ from datetime import UTC, datetime, timedelta
 from pathlib import Path
 
 from .types import AgentInfo, RateLimits, UsageEntry, normalize_pct
-from .util import codex_home, iter_jsonl_dicts, project_from_cwd
+from .util import codex_home, file_may_have_events_since, iter_jsonl_dicts, project_from_cwd
 
 CODEX_DIR = codex_home()
 SESSIONS_DIR = os.path.join(CODEX_DIR, "sessions")
@@ -45,6 +45,8 @@ def load_entries(hours_back: int = 0) -> list[UsageEntry]:
         return entries
 
     for jsonl_path in sessions_path.rglob("*.jsonl"):
+        if not file_may_have_events_since(jsonl_path, cutoff):
+            continue
         _parse_jsonl(jsonl_path, models, entries, seen, cutoff)
 
     entries.sort(key=lambda e: e.timestamp)

{token_tracker-0.4.6 → token_tracker-0.4.8}/src/token_tracker/adapters/rate_limits.py

@@ -2,11 +2,9 @@ import json
 import os
 from datetime import UTC, datetime
 
+from ..config import STATUS_FILE
 from .types import RateLimits, normalize_pct
 
-# 与 hooks.STATUS_FILE 一致：tt 自己的产物集中放 ~/.config/token-tracker（XDG）
-STATUS_FILE = os.path.join(os.path.expanduser("~/.config/token-tracker"), "tt-status.json")
-
 
 def load_rate_limits() -> RateLimits | None:
     if not os.path.exists(STATUS_FILE):

{token_tracker-0.4.6 → token_tracker-0.4.8}/src/token_tracker/adapters/types.py

@@ -129,29 +129,6 @@ class RateLimits:
     context_window: int | None = None
 
 
-@dataclass
-class P90Limits:
-    token_limit: int = 0
-    cost_limit: float = 0.0
-    message_limit: int = 0
-
-
-@dataclass
-class SessionBlock:
-    start_time: datetime
-    end_time: datetime
-    entries: list[UsageEntry] = field(default_factory=list)
-    input_tokens: int = 0
-    output_tokens: int = 0
-    cache_creation_tokens: int = 0
-    cache_read_tokens: int = 0
-    total_tokens: int = 0
-    cost_usd: float = 0.0
-    is_active: bool = False
-    burn_rate: float = 0.0
-    is_gap: bool = False
-
-
 @dataclass
 class StatusSummary:
     """tt status 头图面板：当天多 agent 合并的消耗汇总（add_token_fields 累加用）。"""

{token_tracker-0.4.6 → token_tracker-0.4.8}/src/token_tracker/adapters/util.py

@@ -3,6 +3,7 @@
 import json
 import os
 from collections.abc import Iterator
+from datetime import datetime
 from pathlib import Path
 
 
@@ -45,6 +46,20 @@ def iter_jsonl_dicts(path: Path | str) -> Iterator[dict]:
         return
 
 
+def file_may_have_events_since(path: Path, cutoff: datetime | None) -> bool:
+    """文件是否可能包含 cutoff 之后的事件；无窗口时放行，文件消失时跳过。
+
+    JSONL 只追加写，事件时间不会晚于文件 mtime，因此 mtime 早于 cutoff 的文件可在逐行解析前
+    安全排除。mtime 新只代表“可能有”，仍由解析器按事件时间做最终过滤。
+    """
+    if cutoff is None:
+        return True
+    try:
+        return path.stat().st_mtime >= cutoff.timestamp()
+    except OSError:
+        return False
+
+
 def project_from_cwd(cwd: str) -> str:
     """项目名：优先取所属 git 仓库根的目录名（逐级向上找 .git，纯文件系统、不依赖 git 二进制）；
     非仓库 / 仓库根也删了 → 回退去 home 前缀后的最后一段。

{token_tracker-0.4.6 → token_tracker-0.4.8}/src/token_tracker/analyzer/aggregator.py

@@ -1,14 +1,15 @@
 from collections import defaultdict
 from collections.abc import Callable
-from datetime import timedelta
+from datetime import date, timedelta
 from typing import Any
 
 from ..adapters.types import DailyStats, MonthlyStats, SessionStats, UsageEntry, WeeklyStats
+from ..tz import system_tz
 from .cost import calculate_cost
 
 
 def add_token_fields(target: Any, e: UsageEntry, cost: float) -> None:
-    """把一条 UsageEntry 的 6 个通用 token/成本字段累加到任意 *Stats / SessionBlock 上。"""
+    """把一条 UsageEntry 的 6 个通用 token/成本字段累加到任意 *Stats / StatusSummary 上。"""
     target.input_tokens += e.input_tokens
     target.output_tokens += e.output_tokens
     target.cache_creation_tokens += e.cache_creation_tokens
@@ -47,31 +48,39 @@ def _aggregate_by_key(
     return sorted(by_key.values(), key=lambda s: getattr(s, sort_key))
 
 
+# daily/weekly/monthly 一律按**系统时区**的日历日分桶（entries 时间戳是 UTC；
+# 不转换会把北京时间 00:00-08:00 的用量记到前一天，且与 tt status 的「今天」口径打架）。
+# tz 在函数入口取一次（system_tz 每次调用要 readlink），闭包复用。
+
 def aggregate_daily(entries: list[UsageEntry]) -> list[DailyStats]:
+    tz = system_tz()
     return _aggregate_by_key(
         entries,
-        lambda e: e.timestamp.strftime("%Y-%m-%d"),
+        lambda e: e.timestamp.astimezone(tz).strftime("%Y-%m-%d"),
         lambda k, e: DailyStats(date=k),
         "date",
     )
 
 
 def aggregate_monthly(entries: list[UsageEntry]) -> list[MonthlyStats]:
+    tz = system_tz()
     return _aggregate_by_key(
         entries,
-        lambda e: e.timestamp.strftime("%Y-%m"),
+        lambda e: e.timestamp.astimezone(tz).strftime("%Y-%m"),
         lambda k, e: MonthlyStats(month=k),
         "month",
     )
 
 
 def aggregate_weekly(entries: list[UsageEntry]) -> list[WeeklyStats]:
+    tz = system_tz()
+
     def _week_key(e: UsageEntry) -> str:
-        monday = e.timestamp.date() - timedelta(days=e.timestamp.weekday())
-        return monday.isoformat()
+        d = e.timestamp.astimezone(tz).date()
+        return (d - timedelta(days=d.weekday())).isoformat()
 
     def _factory(k: str, e: UsageEntry) -> WeeklyStats:
-        monday = e.timestamp.date() - timedelta(days=e.timestamp.weekday())
+        monday = date.fromisoformat(k)
         sunday = monday + timedelta(days=6)
         return WeeklyStats(week=k, week_start=monday.strftime("%m-%d"), week_end=sunday.strftime("%m-%d"))
 
@@ -102,6 +111,10 @@ def aggregate_sessions(entries: list[UsageEntry]) -> list[SessionStats]:
             gap = (b.timestamp - a.timestamp).total_seconds() / 60
             if gap <= ACTIVE_GAP_CAP_MIN:
                 active += gap
+        # codex 会话是单条 entry（段内无相邻间隔可累计），活跃时长退化为整段跨度——
+        # 否则恒为 0，被 status 的 active_minutes>=5 过滤，codex 会话永远进不了当天列表
+        if len(session_entries) == 1 and first.session_end:
+            active = duration
 
         # 代表模型按 output_tokens（真实生成量）选，output 持平时用 total 兜底；
         # 不用 total 直接选，避免后台小模型（如 Haiku）读了大量上下文、cache_read 撑高 total 被误判为主力。

{token_tracker-0.4.6 → token_tracker-0.4.8}/src/token_tracker/analyzer/cost.py

@@ -24,7 +24,7 @@ _warned_insecure = False
 # codex- 兜底覆盖 Codex 内部虚拟 model（如 codex-auto-review，stop-time auto-review gate 用）
 _FAMILY_FALLBACK = (
     ("claude-opus", "claude-opus-4-8"),
-    ("claude-sonnet", "claude-sonnet-4-6"),
+    ("claude-sonnet", "claude-sonnet-5"),
     ("claude-haiku", "claude-haiku-4-5-20251001"),
     ("claude-fable", "claude-fable-5"),
     ("codex-", "gpt-5.5"),
@@ -48,6 +48,10 @@ _FAMILY_FALLBACK = (
 # 解析不到定价的模型只提示一次，避免聚合时每条 entry 刷屏
 _warned_unknown_models: set[str] = set()
 
+# model → 解析出的定价 key。非精确命中要线性扫全表（litellm 数千 key），逐 entry 调用必须记忆化。
+# 命中后还校验 key 仍在当前 pricing 里（测试会整表替换 _pricing），失效则重算。
+_model_key_cache: dict[str, str | None] = {}
+
 
 def get_pricing() -> dict:
     global _pricing
@@ -85,6 +89,16 @@ def calculate_cost(entry: UsageEntry) -> float:
 def _resolve_model_key(model: str, pricing: dict) -> str | None:
     if not model:
         return None
+    if model in _model_key_cache:
+        cached = _model_key_cache[model]
+        if cached is None or cached in pricing:
+            return cached
+    key = _resolve_model_key_uncached(model, pricing)
+    _model_key_cache[model] = key
+    return key
+
+
+def _resolve_model_key_uncached(model: str, pricing: dict) -> str | None:
     if model in pricing:
         return model
 
@@ -138,7 +152,8 @@ def _load_pricing() -> dict:
 def _read_cache() -> dict | None:
     try:
         with open(CACHE_PATH, encoding="utf-8") as f:
-            return json.load(f)
+            data = json.load(f)
+        return data if isinstance(data, dict) else None
     except (OSError, json.JSONDecodeError):
         return None
 
@@ -243,6 +258,14 @@ def _fallback_pricing() -> dict:
         "claude-opus-4-7": _OPUS_PRICING,
         "claude-opus-4-6": _OPUS_PRICING,
         "claude-opus-4-5": _OPUS_PRICING,
+        # Sonnet 5 当前为导入价（$2 / $10 / $2.50 cache-write / $0.20 cache-read），截止 2026-08-31；
+        # 9-1 起标准价 $3 / $15（与 Sonnet 4.6 一致）。到期后需切价（注意：litellm 若已收录、以在线价为准）。
+        "claude-sonnet-5": {
+            "input_cost_per_token": 2e-6,
+            "output_cost_per_token": 10e-6,
+            "cache_creation_input_token_cost": 2.5e-6,
+            "cache_read_input_token_cost": 0.2e-6,
+        },
         "claude-sonnet-4-6": {
             "input_cost_per_token": 3e-6,
             "output_cost_per_token": 15e-6,