企业官网建设流程全解析

Token Monitor 数据导出完全指南：自动导出 CSV/JSON，接入 Obsidian 与 Grafana 搭建用量看板

【免费下载链接】token-monitorLocal-first desktop widget for tracking token usage, costs, and limits across 43+ AI coding tools—including Claude Code, Codex, Cursor, OpenCode, OpenClaw, and more—with multi-device sync.项目地址: https://gitcode.com/gh_mirrors/tok/token-monitor

Token Monitor 是一款本地优先的桌面级 Token 用量追踪工具，可以统计 Claude Code、Codex、Cursor、OpenCode 等 43+ 款 AI 编程工具的 Token 消耗与费用。它的数据导出功能能一键或定时把用量数据导出为标准CSV / JSON文件，让你轻松接入 Excel、Obsidian、Grafana 等工具，搭建属于自己的用量看板。本指南带你 10 分钟从零完成配置。

导出的到底是什么数据？

Token Monitor 的导出完全采用通用标准格式（CSV + JSON），不绑定任何特定工具，官方文档见 docs/export.md。每次导出会生成同一组文件（文件名定义在 src/shared/exporter.js）：

几个值得注意的细节：

• CSV 使用UTF-8 带 BOM编码，Excel 打开中文不乱码，并遵循 RFC 4180 引号规范；
• 日期为 ISO 8601 格式，费用列统一命名为cost_usd，始终以美元计价；
• token-monitor-daily.csv是完整历史而非"今天"，最多覆盖最近约 370 天。

token-monitor-snapshot.csv长这样：

period,dimension,name,tokens,cost_usd today,tool,codex,20,2 today,model,gpt-5,20,2 month,tool,codex,0,0 allTime,tool,codex,100,9

两种导出方式：一键导出与自动导出

打开Settings → Collection → Data export（设置项说明见 docs/configuration.md），你只会看到两个选项：

1. Export data…（导出数据）— 选一个文件夹，立即把上述文件集写入一次。适合临时取数、做周报。
2. Auto-export to a folder（自动导出）— 打开开关并选择目标文件夹后，Token Monitor 会在每次用量更新时自动重写整套文件。刷新频率可在 30 秒到 60 分钟之间选择（默认每分钟一次）；如果数据没有任何变化，就直接跳过，避免在空闲时反复向 iCloud / Obsidian Sync 推送相同的文件。

💡 把自动导出指向 Obsidian 仓库（或任意同步文件夹）内的目录，你的看板就会无人值守地保持最新。

接入 Obsidian：用 Dataview 搭建笔记看板

这是最流行的玩法：把自动导出指向仓库内一个文件夹（例如TokenMonitor/），然后在任意笔记中插入一段 Dataview 代码，即可渲染最近 14 天的用量表格：

const raw = await app.vault.adapter.read("TokenMonitor/token-monitor-export.json"); const data = JSON.parse(raw); dv.table(["Date", "Tokens", "Cost (USD)"], data.daily.slice(-14).map(d => [d.date, d.tokens, "$" + d.cost.toFixed(2)]));

不想写代码？直接用 CSV / 表格类插件导入token-monitor-daily.csv也能得到同样的表格。完整配方见 docs/export.md。

接入 Grafana：搭建实时用量看板

Grafana 有两条路线可选：

• 文件数据源（最简单）：把token-monitor-export.json或两个 CSV 文件作为 JSON / CSV file data source 接入，自动导出会保证数据持续更新，图表自动刷新。
• Hub API 实时看板（更高级）：如果你已部署多设备同步 Hub，可以直接使用它的 JSON HTTP API，例如GET /api/stats（聚合的今日 / 本月 / 历史总量与设备明细）和GET /api/history（固定区间历史），端点详细说明见 docs/API.md。配合 HTTP data source + 定时查询，即可做出真正的实时 Token 成本仪表盘。

隐私说明：导出里只有用量数字

很多人担心导出数据会泄露隐私，官方对此有明确保证：导出文件只包含你的用量数字，绝不包含设备标识符、主机名、账号邮箱、套餐标签，也不会带上 AI 工具的限额 / 额度账号数据——即使你正在使用多设备同步。因此可以放心地把它放进任何同步文件夹。

常见问题

为什么导出不含token-monitor-daily.csv？该文件只在开启"趋势历史"（Trend history，默认开启）且已有历史数据时生成；关闭历史时导出只包含快照。

token-monitor-daily.csv只覆盖了部分天数？该文件最多保留最近约 370 天，更旧的数据会自动滚动掉；多设备 Hub 下每行是所有设备当天的合并总量。

费用不是美元怎么办？cost_usd永远以美元计。如需其他货币，在 Excel 或脚本中按汇率换算即可（汇率模块参见 src/shared/exchangeRates.js）。

到这里，你已掌握 Token Monitor 数据导出的全部核心玩法：一键取数、自动导出、Obsidian 笔记看板、Grafana 实时仪表盘。剩下的，就看你的想象力了 🚀

【免费下载链接】token-monitorLocal-first desktop widget for tracking token usage, costs, and limits across 43+ AI coding tools—including Claude Code, Codex, Cursor, OpenCode, OpenClaw, and more—with multi-device sync.项目地址: https://gitcode.com/gh_mirrors/tok/token-monitor