v2.4.10

v2.4.10 — 补充 Antigravity Gemini 价值估算

• 补充 gemini-3.7-flash、gemini-3.8-flash 的 API 参考单价，使现有反重力用量在模型、智能体和总览汇总中显示参考金额；无需重新扫描历史记录。
• 单价核验于 2026-09-15，采用 Google 官方 Standard 档截至 2026-12-31 的优惠参考价：输入 $0.75/M、缓存读取 $0.075/M、输出 $3.75/M。采用当前静态参考价，不重放历史调价，也不代表 Antigravity 订阅账单；不含缓存存储与工具费用。
• gemini-3.7-flash-exp-b 等未核验实验型号及缺少型号的文本估算记录仍标注未定价，混合汇总显示“部分估算”，不将未知价格当作免费。
• 其他模型价格、人民币换算假设、Token 解析、统计口径、设置和历史数据保持不变。
• Windows 仍提供单个 TokenLedger.exe，首次自动准备内部组件，后续启动复用缓存，无需配置环境。新版本首次启动需要准备新的版本缓存。

价格来源：Google Gemini API 官方定价。

2026-09-26 排查说明补充

• 补充任务栏图标空白的排查步骤：关闭程序、刷新 Windows 图标显示，再从桌面快捷方式重新打开。
• 核对历史累计时请选择智能体“全部”和时间范围“全部”；其他时间范围的首卡展示对应时段用量。
• 从 Codex 应用启动时，Windows 可能将账本路径重定向到 Codex 私有缓存，造成与正常桌面启动不同的总量。请关闭该实例，从平时的桌面快捷方式独立启动并核对；不要依据缓存副本覆盖正式账本。
• 此次仅更新文档和发布说明，沿用已发布的 v2.4.10 EXE；没有修改统计逻辑、迁移账本或在程序层面消除启动上下文的路径差异。

v2.4.9

v2.4.9 — Windows 单 EXE 启动缓存

• Windows 发布继续提供单个 TokenLedger.exe；启动器内置 PyInstaller onedir 组件，无需用户携带 _internal 文件夹。
• 首次运行会自动将内置组件准备到 %LOCALAPPDATA%\TokenLedger\runtime，后续启动复用该缓存；用户无需手动安装、解压或配置环境。
• 启动目标是在缓存已准备时 3 秒内启动；实际耗时取决于机器和系统状态，不保证所有机器都达标。
• 用户数据路径保持不变，默认保存在 %LOCALAPPDATA%\TokenLedger\token-ledger.db；更新 EXE 不会清空原目录中的用户数据。
• CI 在隔离的临时 home、data 和 runtime 目录中连续执行两次 --scan-only smoke，并验证数据库没有用量事件。

本次不调整 Token 解析、历史记录、统计口径或其他功能。

v2.4.8

v2.4.8 — Windows 单文件 EXE

• Windows 发布产物改为标准 PyInstaller onefile TokenLedger.exe，CI artifact 和 GitHub Release 都直接提供这一个 EXE，不再要求携带或管理 _internal 目录。
• 下载 TokenLedger.exe 后双击即可使用，无需解压、安装 Python 或配置环境。程序自动准备内置组件，启动可能比文件夹版稍慢。
• 用户数据路径保持不变，默认保存在 %LOCALAPPDATA%\TokenLedger\token-ledger.db；打包方式变化不会迁移或清空原目录中的用户数据。
• CI 在临时 home/data 中执行隔离的 --scan-only smoke，并预置最小空数据库以避免误读取项目 .data；smoke 通过后才上传和发布 EXE。

本次不调整 Token 解析、历史记录、统计口径或其他功能。

v2.4.7

v2.4.7 — 桌面启动与版本一致性

• 桌面窗口优先显示，统计后端的导入和数据库初始化移到后台，缩短启动时没有窗口反馈的等待。
• 首次扫描在页面加载完成后启动，减少与首次打开页面的资源竞争；保留原有手动刷新方式。
• 关闭初始化中的窗口也会取消后续服务启动并释放单实例锁。
• 左上版本和静态资源版本使用程序的统一版本来源，避免安装包升级后仍显示旧版本。

本次不调整 Token 解析、历史记录、统计口径或其他界面样式。数据加载完成时间仍受本地数据量、磁盘与 WebEngine 初始化影响。

v2.4.6

v2.4.6 — 扫描性能优化、动态范围统计与原生窗口体验加固

• 扫描性能大幅优化：在 usage_events(file_id) 上建立专用检索索引 idx_usage_file_id，消除清理遗留文件状态时的数千万次全表关联扫描，彻底解决扫描在 66% 处卡顿 30~40 秒的性能瓶颈，整体扫描时间缩短至毫秒级。
• 扫描调度策略改进（启动单次扫描 + 纯手动触发）：将桌面后台调度策略由高频自动轮询调整为“应用启动 2 秒后自动执行单次增量扫描，后续转为纯手动触发”，移除后台反复自动重复扫描，显著降低本地系统资源与磁盘 I/O 占用。
• 动态时间范围 Token 统计：概览首页顶部首卡完整联动时间范围切换（今天 / 7天 / 30天 / 全部），动态呈现所选观察窗口内的 Token 总量与会话统计，同时保留全周期历史底栏参考；针对单日（今天）走势图增强 SVG 脉冲基准线与高亮锚点渲染。
• 智能体切换与多维筛选联动：强化智能体（Codex、Claude Code、Antigravity）与时间范围胶囊之间的状态统一、过渡动效及观察窗口文字同步，切换时即时响应无停滞。
• 原生桌面窗口与黑夜/白天沉浸标题栏恢复：完整修复 PyQt5 运行时依赖，杜绝降级回退至 Edge 浏览器外壳；原生桌面窗口深度集成 Windows DWM API，窗口标题栏、边框与文本在暗黑（#090C10）与亮白（#F8FAFC）模式下实时动态精准变色。
• Windows 二进制打包依赖加固：完善 PyInstaller spec 配置，自动检测并收集 Anaconda/Python 环境下运行所需的 Qt5 核心库与 C 运行时依赖（sqlite3.dll 等），确保便携版在干净 Windows 环境下即开即用。
• 测试与质量保证：76 项单元及集成测试、Qt 桌面无头端到端验证全数通过。

升级说明

下载并完整解压 TokenLedger-Windows.zip，运行 TokenLedger 文件夹内的 TokenLedger.exe；必须保留 _internal 目录。关闭旧版后再运行新版。应用数据位于独立用户数据目录，无需手动迁移。

v2.4.5

v2.4.5 — Codex 历史用量恢复与全周期统计加固

• Codex 历史用量恢复：完整恢复因长会话折叠压缩（Compaction）与过于激进的分叉去重而误删的约 28 亿历史 Token，全周期累计用量重回真实基准（约 58 亿 Codex Token / 66.7 亿全账本 Token）。
• 历史数据防裁切保护：对经过确认的历史用量赋予永久保留标识（codex-v2:h:），防止后续常规扫描或强制全量重扫时因源日志压缩截短而丢失历史观测。
• 全周期 KPI 视角稳定：首页左上首卡恢复为“全周期累计 Token”（全部历史），与今日新增、预估成本及官方额度保持全局核心指标体系统一；图表与明细数据继续跟随时间筛选（7天/30天/全部）动态刷新。
• 异步请求竞态防护：增加前端异步请求序号验证（dashboardRequestSerial），防止快速连续切换过滤条件时因网络或渲染乱序导致数据串台。
• 回归与完整性测试：71 项自动化测试与 Qt WebEngine 真实桌面端到端冒烟测试全数通过。

升级说明

下载并完整解压 TokenLedger-Windows.zip，运行 TokenLedger 文件夹内的 TokenLedger.exe；必须保留 _internal 目录。关闭旧版后再运行新版。应用数据位于独立用户数据目录，无需手动迁移。

v2.4.4

v2.4.4 — 桌面交互与排版修复

• 后台刷新不再短暂降低页面亮度；扫描进度更新不再反复重建卡片。
• 修复快速进出、反向移动鼠标时卡片背景异常拉伸：固定透视距离，逐帧更新受限角度，不再对透视矩阵做 CSS 过渡。
• KPI 与智能体卡片保留最高 ±4° 的背景俯仰，文字保持平面渲染；去除重复背景和双边框。
• 大图表与流程面板保持平整，镜面改为柔和的局部高光。
• “全部”等智能体筛选项改成胶囊形；恢复鼠标与键盘焦点区分，修复品牌文字间距。
• 修复旧桌面内核不支持 Flex gap 导致的拥挤排版：增加概览、智能体详情和诊断页间距，费用说明与金额分行。
• 窄窗口减少模型和数据源卡片列数，明细表在卡片内横向滚动。

验证

55 项自动化测试通过；本地 Qt WebEngine 实际页面验证覆盖深浅主题、480/900/1440 像素布局、胶囊圆角、文字位置稳定及 1200 次快速指针采样。

升级

下载并完整解压 TokenLedger-Windows.zip，运行 TokenLedger 文件夹内的 TokenLedger.exe；必须保留 _internal 目录。关闭旧版后再运行新版。应用数据位于独立用户数据目录，无需删除或重新导入。

本版不新增数据库迁移，不修改 Codex 配置。参考价格并非实际账单；旧 Git 历史、旧发布及本地备份不会因本次发布被清除。

v2.4.3

v2.4.3 — 数据可信度与桌面安全修复

• 移除端口占用时终止其他 Python 进程的行为；使用独立绑定的本地端口。
• 修复桌面周期扫描、可用屏幕区域适配、主题切换和依赖声明。
• 恢复键盘焦点可见性及品牌按钮键盘操作；尊重减少动画偏好，避免较新数组 API 的兼容性问题。
• 移除写死的余额、额度和满额健康条；失败时仅保留真实旧值并标记过期，或显示未提供。
• DeepSeek 凭据使用依据已验证的官方地址，不依据 provider 名称；缓存身份不再仅使用密钥前缀。
• 对账限定在匹配平台、模型及路由覆盖内，避免独立用量被较大日汇总吞掉。
• Antigravity 关联数据库或 WAL 变化时重新解析；停止保存会话标题和提示词摘要。
• Antigravity 缺失模型字段不再默认指定型号；未变化来源复用统计缓存，减少重复读取。
• 升级时清理旧版 Claude / Antigravity 元数据和额度缓存，保留 Token 使用事件。
• 金额改为带来源与核验日期的 API 参考估算；未知模型显示未提供，混合汇总标记部分估算；删除静态省钱对标。
• 修复额度过期语义与仪表盘缓存失效；增加回归测试。
• 更新隐私、网络访问、计费边界及交接文档，移除公开文档中的个人样例。

升级

完整解压便携包后运行 TokenLedger.exe；保留 _internal 目录。应用数据位于独立用户数据目录，不需要删除或重新导入。升级清理的是可重建衍生缓存，不是 Token 使用事件。

限制

参考价格不是实际账单；身份未知数据仍可能重叠；Antigravity 可见文本估算不代表完整上下文。旧 Git 提交、旧发布副本和本地备份中的内容未被历史重写或安全擦除。本次不修改 Codex 配置。

Token Ledger v2.4.2

Token Ledger v2.4.2 发行说明

Token Ledger v2.4.2 带来了更极致的 UI 原生统一性、更精准的公有云模型商用估值体系，以及印刷级的抗锯齿视觉体验：

---

🎨 核心界面与原生窗口统一

1. Windows DWM 标题栏沉浸色动态双向联动

   • 彻底告别写死黑框：原生 Windows 窗口框架（标题栏底色、文字颜色与边框）毫秒级动态跟随页面主题；
   • 浅色模式（Light）：标题栏自动切为纯净亮白（#F8FAFC），字体为钛黑（#0F172A），与数字后花园浅色背景 100% 融合；
   • 深色模式（Dark）：标题栏无缝切为深空灰黑（#090C10），字体为浅灰亮白（#EDEDED）；
   • PyQt5 原生监听 Qt 内部信号，零延迟响应，切换瞬间窗口底色与 DWM 一并平滑转换。

2. 卡片悬停字体变糊问题彻底修复

   • 移除文字容器上的 3D 矩阵旋转（perspective rotateX/Y），消除 Chromium 渲染管线对 DirectWrite ClearType 亚像素抗锯齿的抑制；
   • 保留跟手光标动态投射的镜面高光反射（specular-glare），辅以印刷级抗锯齿样式注入；卡片浮雕光泽流转，而文字与数字始终 100% 锐利清晰。

---

💰 全模型定价与商用价值核算增强

1. 规避前缀匹配冲突（Prefix Collision）

   • 定价目录严格按键名长度降序优先匹配，杜绝 gpt-4o-mini 误被 gpt-4o 抢先匹配、o1-mini 误被 o1 抢先匹配等情况。
   • 覆盖 OpenAI/Codex Frontier、Anthropic Claude、DeepSeek、Google Gemini、智谱 GLM、阿里通义千问等 30+ 种主流大模型。

2. Claude Code 中转实付 vs 官方原生对标双轨核算

   • 针对使用 CC Switch 转发至国产极速大模型（如智谱 GLM-Flash、DeepSeek-Flash，单价仅 0.10元/M 且享 95%+ 上下文缓存减免）的场景，不仅如实呈现其实付支出（个位数人民币），更贴心展示若运行于 Anthropic 官方 Claude 3.5 Sonnet 原生 API 的等额价值与降本率；
   • 鼠标悬停每个模型的绿色价格胶囊，均可浮动查看该模型的官方计费标准单价。

3. 走势图每日账单与 Tooltip 实时展示等额价值

   • 悬停趋势图任意时间点，浮动 Tooltip 与下方的单日账单栏均实时展示该日期的精确等额价值。

---

🧪 稳定性与兼容性

• 26 项自动化测试全部通过；
• 本地优先（Local-First），100% 离线可用，零隐私数据上传。

Token Ledger v2.4.0

Token Ledger v2.4.0 发行说明

🌟 核心更新亮点

1. ⚡ 120 FPS 极速丝滑物理惯性滚动

• 物理惯性滑行算法：采用时间微分（dt）指数衰减算法 factor = 1 - exp(-11.5 * dt)，单次齿格滑动约 140px 并平滑减速约 380ms，彻底消除 Windows 鼠标滚轮“一格一格跳动”顿挫感。
• Canvas 渲染极速优化：粒子晶格绘制执行单批次合并（Batch Draw），单帧开销由 7ms 降至 0.12ms，主线程帧率稳定锁定在 120 FPS（平均帧耗时 8.34ms）。
• Edge 独立窗口高刷解锁：在浏览器桌面启动参数中增加 --disable-frame-rate-limit 与 --max-gum-fps=120，全面释放高刷显示器性能。

2. 📌 真·全屏贴顶毛玻璃置顶导航栏（Pinned Topbar）

• 重构为边缘到边缘贴顶毛玻璃横条（top: 0、position: fixed），彻底解决滑动时卡片在顶部缝隙穿出的视觉瑕疵。
• 智能体筛选胶囊（全部 / Codex / Claude / Antigravity）与观察时间范围常驻屏幕最顶端，无论滑到页面任何深处均可一键随时切换。
• 自适应紧凑布局设计，在 1280px、1366px 等笔记本屏幕下 100% 完整展示，无横向滚动条，无任何内容遮挡。

3. 🌿 数字后花园旗舰美学与 3D 浮雕交互

• 深度对齐 pjy.net.cn（数字后花园）设计语言，引入 3D 透视浮雕卡片（perspective(1000px) rotateX/Y）与光标跟随的镜面高光反射（specular-glare）。
• 搭载流光粒子微节点力场画布与深空灰黑 / 纯净科技白双模式极简配色。

4. 💰 模型公有云对标费用与商业价值折算引擎

• 内置主流大模型定价矩阵字典（GPT-4o/5, Claude 3.5 Sonnet, DeepSeek V3, Gemini 1.5/2.0 等）。
• 自动计算并呈现每个模型的输入、输出、缓存节约折算人民币（¥）与美元（$）商业价值。
• 关键 KPI 卡片直接呈现“等额商用价值”，一目了然看清为开发者节省的实际算力成本。

5. 🔍 三大智能体深度全景视图与本地安全诊断

• 全智能体图景：除 Antigravity 外，新增 Codex 官方额度窗口与 Prompt Cache 智能减负分析，新增 Claude Code & CC Switch 多路由全景看板。
• 本地优先安全诊断：明晰展示各数据源发现文件数、有效事件数与存储路径，重申零云端上传、不持久化 Prompt、密钥免触与本地独享数据库承诺。
• 白屏彻底清零：强化前端防护，为各大模块增加独立的错误捕获与防御性降级渲染。

---

🛠️ 质量与验证

• 全量 25 项自动化单元测试 100% 通过（耗时 1.30s）。
• 通过 Edge 无头自动化浏览器（CDP）实测验证：平均帧耗时 8.34ms（120 FPS），top: 0 滚动吸顶置顶验证通过。