claude-usage v0.1.2

claude-usage v0.1.2

修复会话信息缺失时的漏计，以及后补迭代分类未被保存的问题。

• 有效 Claude 请求不再因为缺少 sessionId 被静默跳过。缺少会话归属时保留 Token 并显示诊断；子代理目录仍可提供明确的任务关系。
• 后补会话信息会更新已有请求，同一请求及其 Windows / WSL 副本只计一次。
• 后补的 compaction / Advisor 分类可以补全默认 message 分类。旧副本不会将已明确的分类降级；互相矛盾的明确分类会给出诊断。
• 后补分类或缓存期限时，保留请求原有的结束状态，避免随后出现的冲突用量覆盖已确认的计数。

新增回归用例覆盖漏计复现、来源并集、子代理、后补会话、分类补全、旧副本、分类冲突和已结束请求的保护。使用隔离状态目录对 Windows / WSL 真实日志进行了逐请求核对，比较独立计量、数据库、API 与 JSON / CSV 导出；未改写原始日志。

更新保留端口、配置和历史数据库，不自动重建历史。若旧版本曾跳过缺少会话信息的记录，已经保存的扫描游标不会自动回退；需要在备份后明确执行历史重建。当前日志未触发该情况时，无需重建。

English

This release fixes usage records silently skipped when sessionId is absent, and late iteration classifications incorrectly left as message.

• Retain identifiable Claude usage without a session ID, report missing attribution, and retain explicit subagent directory relationships.
• Enrich missing session metadata without counting the request or its mirrored copies twice.
• Accept late compaction / Advisor classifications, preserve them against stale generic copies, and diagnose contradictory specific classifications.
• Preserve finalization when enriching classification or cache-lifetime metadata, so conflicting partial snapshots cannot overwrite confirmed usage.

Regression tests cover these cases. An isolated Windows / WSL audit compared independent request accounting with SQLite, APIs and JSON / CSV exports. Source transcripts were unchanged.

Updates preserve configuration and history. Previously skipped historical records require an explicitly approved rebuild after backup; existing scan cursors are not reset automatically. No rebuild is needed for unaffected logs.

claude-usage v0.1.1

claude-usage v0.1.1

默认端口改为 127.0.0.1:43190，首次访问 Dashboard 与未指定语言的命令行现在默认使用中文。

• URL 的 ?lang=、浏览器中手动保存的语言、CLI 的 --lang 和 CLAUDE_USAGE_LANG 继续生效。
• 中英文 README 新增实速功能演示 GIF、高清 MP4、六平台下载表、安装说明与界面截图。
• 演示覆盖分钟查询、小时/月历下钻、项目、任务树、搜索、Fast 与模型组合筛选、CSV 导出、Windows/WSL 来源、缓存价格和显示设置。
• 录制包含平滑光标、逐字输入与阅读停顿，不加速播放，全部使用合成数据；可运行 npm run capture:media 重现。

已有 config.json 中保存的端口不会被覆盖。如需将已有安装从 43191 改到 43190，先停止已有服务，再修改状态目录 config.json 的 port 并重新启动。本次升级不修改计量数据、Claude 配置或数据库 schema。

The default address is now 127.0.0.1:43190, and new dashboard visits and CLI sessions default to Chinese. Explicit language preferences remain effective.

Both READMEs now include real-time synthetic GIF walkthroughs, full-resolution videos, a six-platform download table and clearer onboarding. Existing configured ports are preserved; stop an existing service before changing port and restarting. No accounting data, Claude configuration or database schema changes are required.

中文说明 · English · 在线体验

claude-usage v0.1.0

claude-usage v0.1.0

首个独立版本：本地 Claude Token 统计、Windows/WSL 自动来源发现、全局请求去重、压缩与 Advisor 迭代计量、缓存期限计价，以及暖色中英双语 Dashboard。

• 概览、每日月历、小时下钻、分钟范围、任务树、搜索、组合筛选与 JSON/CSV 导出。
• 独立状态目录与端口 127.0.0.1:43191，不修改 Claude 配置。
• 来源失败或日志删除保留已收集历史；改写/截断需要明确同意重建。
• 当前公开 API 单价的 Token 等价估算，不代表订阅扣额或真实账单。
• 用户级安装、自启、诊断和卸载；更新采用 SHA-256 校验、备份及失败恢复。

下载对应系统/架构，校验 SHA256SUMS，使用 serve 前台运行。需要开机启动时再主动运行 install。macOS 安装包为未签名命令行程序，系统是否允许执行取决于本机安全设置。

First independent release: local Claude token accounting, Windows/WSL discovery, global request deduplication, compaction/Advisor iterations, cache-lifetime pricing, and a warm bilingual dashboard. Cost is a token-equivalent estimate at current public API prices, not a subscription charge or actual bill.

Six standalone binaries cover Windows, Linux and macOS, each for amd64 and arm64. Verify SHA256SUMS; use serve without installing a service, or explicitly run install for user startup. macOS binaries are unsigned command-line programs.

See README, English documentation and validation scope.