多个设备如何汇总

[MedAIerHHL]

当有几个设备的时候 如何汇总呢，现在项目是否支持

[mm7894215]

你好 @MedAIerHHL —— 现状如下：

✅ 已支持的部分

登录账号后，同一账号在多台设备上的本地数据会自动同步到云端，dashboard（网页或 macOS app）和菜单栏小组件都能跨设备看到统计 —— 这部分开箱即用，不用额外配置。

⚠️ 当前的限制

云端聚合目前用的是 MAX 去重（按 user_id + source + model + hour_start 取最大值），不是直接 SUM。原因是同一账号在不同设备上的 cumulative queue 重放会让同一个 hour 的 token 计数在多个 device_id 行下出现，直接 SUM 会双计。

实际影响：如果你两台 Mac 真的在同一小时分别用了 5k / 3k tokens，云端会显示 5k 而不是 8k。同设备多次同步不会受影响。

🚧 正在做

wip/cloud-aggregation 分支正在做正确的 per-device 隔离 + 真 SUM 汇总（per-browser client_id 让两台设备产出独立 device_id，然后 leaderboard/account 视图改回 SUM）。还没合到 main，合并后会发个 release notes。

如果你的场景对精确多设备加总特别敏感，可以在这条 discussion 下面 +1 一下，我会优先把这分支推完。

[MedAIerHHL]

请问下云端是存在哪里呢，我的场景是我有win mac 还有两台服务器 上面都有ai agent，我现在用的是这个（https://github.com/juliantanx/aiusage），但感觉ui功能没你们这个全面

[mm7894215]

更新：跨设备聚合已在 v0.42.0 正式上线（PR #155）。开启云同步后，Dashboard 会把你所有已登录机器（笔记本 + 台式机 + 服务器）的用量合并成一个视图——总量、趋势、热力图、模型明细全部跨设备聚合，采用跨设备 SUM + 机器级稳定设备身份（一台机器 = 一个设备，真多机正确相加、同机多浏览器不再重复计数）。未登录/纯本地用量依然即时、离线。

[MedAIerHHL]

我有一个问题想请问一下，就是如果现在同云同步服务的话，那这个云指的是哪里呢？它会把它汇总到哪个地方呢？是你提供的一个云服务器上，还是什么地方？

[mm7894215]

数据流向说明：

「云」是什么
登录后，各设备的用量会上传到 TokenTracker 托管的后端（基于 InsForge，底层 PostgreSQL），按你的账号统一聚合。这是我们运营的托管实例，不需要你自己搭服务器。

汇总到哪
汇总在这个云端数据库，以账号为单位。Dashboard、菜单栏小组件和网页打开时，会把你所有已登录设备（Win + Mac + 两台服务器）的数据实时合并成一个跨设备视图。

只上传 token 计数
上传的仅是用量计数：token 数量、模型名、来源、时间桶。prompt、代码、对话内容以及任何文件都不会上传，只保留在本机。

纯本地选项
不登录即为纯本地模式，完全不联网上传，数据只存在本机 ~/.tokentracker/。如有自托管需求，也可通过环境变量 TOKENTRACKER_INSFORGE_BASE_URL 指向自建后端。