v0.1.2

v0.1.2 发布说明

修复 OpenCode Go 官方月剩余用量偶发无法显示的问题，重绘应用与托盘图标。

✨ 新功能

• 重绘应用 logo 与托盘图标
  • 新图案：深色玻璃圆角块 + 环形配额进度（青→绿主弧代表剩余、紫余弧代表已用，呼应精简视图的 conic 环形）+ 中央 token 火花 + 底部三色用量柱
  • 配色对齐主题（teal #2dd4bf / violet #8b5cf6 / amber #fb923c），4×4 超采样抗锯齿，边缘平滑
  • 生成脚本（npm run icon）一键输出主图标源（1024）/ 托盘图（32 / 16）/ 预览图，exe 内嵌图标与托盘图标同步更新

🛡️ 修复

• 修复 OpenCode Go 官方月剩余用量无法显示

⚠️ 已知限制

• OpenAI 用量接口需组织管理员 Key（普通 Key 返回 403）
• 「本地记录」与「OpenAI 官方」同时统计同一提供商时会重复计数，建议二选一
• OpenCode Go 官方额度依赖登录 Cookie，会话过期后需重新获取
• dsh 的 token 总量含缓存重放（与 ZCode 口径不同），对比跨源数据时请注意

v0.1.1

v0.1.1 发布说明

新增 DeepSeek Harness（DSH） 数据源、模型列表品牌 Logo，并修复一批数据准确性与安全问题。

✨ 新功能

• 新增第 6 类数据源：DeepSeek Harness（DSH）
  • 自动探测 ~/.dsh/sessions，解析 zstd 压缩会话日志（session.jsonl.zstd）中的 assistant/message 用量事件
  • 实时监听：会话过程中新增请求毫秒级推送到小组件
  • 重启不重复统计（每文件事件计数去重，截断/重写自动整源重建）
  • 统计口径：total = input + output + cacheReadTokens。dsh 每次请求都会重放整段会话缓存上下文（缓存 token 约为新 token 的 100 倍），按"实际处理/计费 token"统计才反映真实用量；该口径与 ZCode（不含缓存）不同，为 dsh 专属
• 模型列表展示品牌 Logo：真实 SVG 图标（离线内联），支持 OpenAI / Claude / DeepSeek / Gemini / GLM / Qwen / MiniMax / 混元 / MiMo / OpenCode，Kimi / Grok / Codex / ZCode 用手绘近似，未识别回退彩色字形

🛡️ 数据准确性与安全修复

• 修复 token 双倍计数
  • 自愈/文件截断重建时清空该源全部数据再重扫，修复 34 天前历史被重复累加
  • 新增文件截断/重写检测（偏移 > 文件大小 → 整源重建），防整文件重加
  • 超大文件标记已消费，避免反复触发自愈
• 修复凭据跨域转发风险：HTTP 重定向仅跟随同主机且不降级 https，防止 Authorization / Cookie 被转发到第三方域名
• 修复代理 SSE 流式用量漏记：跨 chunk 行缓冲重组半截 data: 行；按响应 content-type 判断流式
• 修复 sqlite 回填抹掉实时增量：按模型取最大值合并，权威数据与实时日志双向不丢
• 未计费配额显示 ~ 估算标记：未知模型/未配置价目时明确提示为估算值
• 精简视图优先展示官方额度，官方失效时自动回退估算（不再展示过期数据）
• 配置/历史文件损坏时先备份再回退默认，避免静默覆盖丢失 API Key 等凭据
• 窗口移动持久化 500ms 防抖，减少高频写盘
• 文件扫描迁移到阻塞线程池，界面不再被大目录扫描卡顿

v0.1.0

v0.1.0 发布说明

首版正式发布：从 Electron 版完全重写为 Rust + Tauri 2，启动更快、占用更低、数据管道更稳定。

✨ 核心功能

• 实时用量监控：TOTAL TOKENS 大数字带滚动动画，每次 AI 请求完成立即跳动更新
• 费用统计：总费用（USD），支持按模型价目表折算
• 额度剩余：各数据源剩余百分比进度条 + 重置倒计时
• 模型明细：按模型分组的 token 消耗与占比进度条
• 趋势图表：面积折线图，自动标注峰值
• 活动热力图：GitHub 风格热力图 + 活跃天数
• 时间筛选：DAY / MONTH / TOTAL 三档切换

🔌 数据源（5 类）

数据源	说明
本地记录（自动探测，零配置）	实时监听 ZCode 与 Codex 会话日志，毫秒级推送；历史用量自动从 ZCode SQLite 回填，开箱即有 30 天数据
OpenAI 官方	用量 API 直连，支持回填 90 天历史（需组织管理员 Key）
兼容中转站	自动探测常见余额接口（billing / balance / auth-key / one-api 四种风格），支持自定义 URL 与字段映射
OpenCode Go 本地代理	本地 SSE 流式代理，转发请求并记录本机每次用量，对照官方限额估算剩余
OpenCode Go 官方额度	Cookie 抓取官方控制台数据（权威，含所有设备）：5 小时 $12 / 每周 $30 / 每月 $60

🖥️ 桌面体验

• 玻璃拟态深色风格，无边框半透明（Win11 亚克力毛玻璃），置顶悬浮
• 跨显示器拖拽支持，混合 DPI 下尺寸稳定，窗口位置自动记忆
• 精简模式：托盘切换只显示剩余用量的迷你视图
• 系统托盘：左键单击显示/隐藏，右键菜单（显示/隐藏、精简模式、设置、退出）
• 全局热键 Ctrl+Alt+U，设置中可自定义
• 开机自启（可选）
• 单实例运行，重复启动自动唤起已有窗口

🛠️ 数据与设置

• 数据源「测试连接」、本机工具自动探测（ZCode / Codex / OpenCode CLI）
• 数据导出为 JSON、一键清空数据
• 冒烟测试模式：--smoke 无界面验证数据管道
• 所有数据仅存本机（%APPDATA%/token-usage-widget/），与旧 Electron 版数据兼容、无缝迁移

🔧 修复（开发期）

• 修复首次启动黑屏闪烁与高度跳变
• 修复跨显示器拖拽后趋势图压缩、窗口宽度漂移（混合 DPI）、高度回弹
• 修复精简模式切回主视图时窗口位置偏移
• 修复 Codex 数据源文件增长导致 token 重复计数
• 修复托盘图标闪回、设置窗口死锁
• 本地代理防滥用加固（仅绑定本机回环地址）
• 文件监听自愈与事件防抖，异常后自动恢复

🗑️ 移除

• 移除 Dock 贴边吸附模式
• 移除精简模式按钮，禁用 WebView 右键菜单