Show HN: Tokdash – 本地AI令牌与配额追踪仪表盘

Tokdash 是一款面向 AI 开发者的开源本地仪表盘工具，旨在帮助用户精确追踪和管理 AI 客户端（如 Claude Code、Codex 等）的令牌使用量和配额。该项目已在 GitHub 上开源，并获得了社区的积极反馈。

Tokdash 的核心功能包括精确的令牌计数（输入/输出/缓存分解）、贡献日历热力图（2D 和 3D 视图）、会话探索器以及配额监控标签页。配额标签页支持显示订阅周期进度条和重置倒计时，适用于 Codex、Claude Code 等平台。此外，Tokdash 还支持状态栏集成，允许用户在 Claude Code 等代理的 statusline 中实时查看令牌和成本数据。

安装非常简便，推荐使用 pipx 进行隔离安装：pipx install tokdash。首次运行通过 tokdash setup 启动向导，配置后台服务并打印仪表盘 URL（默认 http://127.0.0.1:55423）。用户还可以使用 tokdash doctor 进行环境检查，tokdash update 进行升级，tokdash uninstall 进行卸载。

Tokdash 默认仅绑定到本地回环地址，保障数据安全。对于远程访问，建议使用 Tailscale Serve 或 SSH 隧道。Tailscale Serve 配置简单，向导可自动完成设置，但远程访问仅支持只读操作，写入操作需通过 SSH 转发。

Tokdash 还支持持久化使用数据库（默认启用），将解析后的令牌数据存储在 SQLite 索引中，提高重复查询性能。用户可通过环境变量自定义数据目录、缓存时间、并发限制等。整体设计注重隐私和安全性，无遥测功能，所有数据解析均在本地完成。

该项目目前处于活跃开发阶段，已支持 Linux（包括 WSL2）、macOS，Windows 为实验性支持。未来计划包括更多客户端的兼容性改进和功能扩展。Tokdash 的配置选项非常丰富，包括 TOKDASH_HOST、TOKDASH_PORT、TOKDASH_CACHE_TTL 等环境变量，以及持久化数据库的配置。此外，Tokdash 还支持通过 tokdash db 系列命令进行数据库维护，如状态检查、同步、验证和修复。

对于使用配额监控的用户，Tokdash 提供了可选的配额轮询功能，需要通过 tokdash quota consent 启用，并使用本地 CLI 凭证调用提供商自己的配额端点。所有响应数据存储在本地 SQLite 数据库中。

Tokdash 的安装向导还支持从旧版本迁移，例如从 v1.0 之前的版本升级时，需要先升级 tokdash 命令，然后运行 tokdash setup 以接管后台服务。对于使用 conda 或系统 Python 的用户，可以迁移到 Tokdash 管理的虚拟环境。

总之，Tokdash 是一个功能强大且注重隐私的本地仪表盘工具，适合所有希望精确控制 AI 令牌使用和配额的开发者和团队。