HashMeterAi 完全指南：跨工具 AI 用量追踪的本地化解决方案
问题：你的 AI 用量，各家工具自己说了算
Claude Code、Codex、Qwen CLI、Kimi……你的工作站上跑着多少个 AI 编码工具？每个工具都有自己的使用统计——Claude Code 告诉你用了多少 token，Codex 给你一个成本估算，但它们各自为政，没有一个统一的全局视图。
更关键的是：内置的用量统计经常漏记。 跳过 session 不计数、只统计自家不统计别家、缓存 token 被重复计费——你的”真实 AI 用量”和工具面板上的数字之间，存在一条你从未意识到的鸿沟。
今天要介绍的 HashMeterAi 就是来解决这个问题的。它是一个本地优先的桌面应用（Tauri + Rust），直接读取 AI 编码工具在本地磁盘上的会话记录，汇总成统一的可视化仪表盘——含费用估算、使用模式分析、焦点时间追踪，甚至还有一套成就奖杯系统。全部离线运行，零网络调用。
安装：三大平台，三步搞定
HashMeterAi 通过 GitHub Releases 分发，支持 macOS、Windows 和 Linux。由于是免费开源项目（未购买代码签名证书），首次启动时操作系统会提示”未验证的开发者”，按以下指引操作即可。
macOS
下载 .dmg 安装包，拖入 Applications 文件夹。首次启动时右键点击 → 打开 → 确认运行。如果遇到「已损坏」提示（Apple Silicon 常见），终端执行：
xattr -dr com.apple.quarantine /Applications/HashMeterAi.app
Windows
运行 .msi 或 .exe 安装器。SmartScreen 弹出「Windows 已保护你的电脑」时，点击 更多信息 → 仍要运行，仅一次。
Linux
下载 .AppImage：
chmod +x HashMeterAi_*.AppImage ./HashMeterAi_*.AppImage
或使用 .deb 包（Debian/Ubuntu）：
sudo dpkg -i HashMeterAi_*.deb sudo apt-get install -f
安装完成后，首次启动即自动扫描本机各 AI 工具的本地记录文件，无需任何配置。
核心功能详解
1. 统一仪表盘：一个窗口看透所有 AI 工具
HashMeterAi 的首页展示四个核心指标：
| 指标 | 说明 |
|---|---|
| 费用估算 | 按公开 API 列表价估算的美元价值（订阅制用户实际不按 token 付费，此处为参考值） |
| 已处理 Token | 模型实际完成的工作量，排除缓存重复读取（附「约等于 N 次指环王全书」的直观对比） |
| 平均专注时间 | 每日实际与 AI 协作的活跃时间，不含闲置 |
| AI 人格画像 | 根据你的使用模式生成的标签，如「深度钻研者」「夜猫子型」 |
每个指标背后都展示了具体的计算依据，不是凭空生成的虚荣数字。
2. 支持的 AI 工具
HashMeterAi 通过「源适配器」（Source Adapter）架构读取各工具的本地记录：
| 工具 | 支持状态 | 说明 |
|---|---|---|
| Claude Code | ✅ 完整支持 | 含通过 Claude Code 调用的 GLM、MiniMax、Gemini（自动识别模型名） |
| Codex (OpenAI) | ✅ 完整支持 | 读取本地 session 记录 |
| Kimi | ✅ 完整支持 | 按模型分类统计 |
| Qwen CLI | ✅ 完整支持 | 读取 ~/.qwen 目录 |
| HashCortX | ✅ 完整支持 | 记录每次响应的真实 token 数 |
| HashCerebrum | ✅ 完整支持 | 医学研究环境下的用量 |
| Gemini CLI、Antigravity | ❌ 不支持 | 本地无 token 计数记录 |
| Cursor、Copilot、Windsurf | ❌ 不支持 | 用量在服务端，无本地数据 |
关于不支持的工具，有一个好消息：添加新工具的适配器只是一个 Rust 源文件——架构设计为可插拔适配器模式，欢迎 PR。
3. 日历视图：回看每天的 AI 活动
HashMeterAi 内置了一个活动日历，按日展示你的 AI 编码工具使用情况。哪天在用哪个工具、用得多频繁、消耗了多少 token——一眼可辨。这对月度回顾、效率复盘非常有帮助。
4. 成就系统：60 枚奖杯 + 人格画像
HashMeterAi 的成就系统不是花瓶——每枚奖杯都有真实的触发条件，基于你的实际用量数据计算。60 枚奖杯分布在三大维度，外加独立的人格画像标签：
- 数量维度（20 枚）：从「第一步」到「十亿 token 俱乐部」，按累计处理 token 数解锁
- 强度维度（20 枚）：按单日/单会话峰值用量触发，如「日耗百万」级
- 精通维度（20 枚）：按覆盖工具数、使用天数等复合条件解锁
- 人格画像：如「夜猫子」「早起鸟」「深度模式」等，根据时段分布和会话时长生成，独立于奖杯体系
成就系统让你的 AI 使用数据不再只是冷冰冰的数字，而是一段可视化的成长历程。
5. 一键分享卡
生成一张品牌化的使用数据卡片，包含你的统计数据和最稀有的三枚成就奖杯。可以分享到社交媒体——当然，隐私在你手中，只有你主动导出的这张图片会离开你的机器。
隐私与安全设计
HashMeterAi 的隐私设计是它的核心卖点之一：
| 保证 | 说明 |
|---|---|
| 零网络 | 无遥测、无分析、无自动更新检查——无法外联 |
| 仅元数据 | 只读取 token 数、时间戳和模型名——从不读取提示词、代码或回复内容 |
| 不碰密钥 | 跳过认证文件、凭据和密钥文件 |
| 只读 | 永不修改任何工具的本地数据 |
| 100% 本地 | 一切在本机计算，你的用量数据不出门 |
唯一会离开你机器的数据是你主动导出的分享卡图片。
谁适合使用 HashMeterAi？
- 同时使用多个 AI 编码工具的开发者——想在一个地方看到全部用量
- 对 AI 费用敏感的自由开发者/小团队——想知道每月真实的 API 消耗
- 喜欢数据可视化和成就系统的用户——AI 使用记录也可以很有趣
- 隐私意识强的用户——不信任云端统计，希望全离线方案
与同类工具的对比
市场上已经有 AI 用量追踪工具（如 AgentMeter），它们大多是 CLI 工具，提供运行前的成本预估。HashMeterAi 的定位完全不同：
| 特性 | HashMeterAi | CLI 用量工具 |
|---|---|---|
| 形态 | 桌面 GUI 应用（Tauri） | 终端命令行 |
| 数据来源 | 读取本地实际记录 | 运行前估算 |
| 多工具统一 | ✅ Claude Code + Codex + Kimi + Qwen | 通常只支持单个 |
| 成就系统 | ✅ 60 枚奖杯 + 人格画像 | ❌ |
| 隐私模型 | 零网络、只读元数据 | 通常离线 |
| 跨平台 | macOS + Windows + Linux | 通常是 macOS / 单平台 |
上手总结
HashMeterAi 是一个定位清晰、执行完整的本地 AI 用量追踪工具。它不解决「怎么省钱」的问题——不提供提示词优化建议或模型路由策略。它解决的是一个更基础的问题：你真正用了多少 AI？ 在你还不知道这个数字的时候，任何优化都无从谈起。
如果你是重度 AI 编码用户、习惯同时使用多个工具、关心自己的真实消耗，HashMeterAi 是一个值得一试的补充工具。从 Releases 页面下载安装包，启动即用，零配置零网络。三分钟装好，看到自己的 AI 使用全貌的那一刻，可能会让你做出一些过去从没想过要做的优化决策。