ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

如何用 Token Monitor 部署跨网络同步服务:Cloudflare Worker 一键上线,iPhone 也能看用量

如何用 Token Monitor 部署跨网络同步服务:Cloudflare Worker 一键上线,iPhone 也能看用量 如何用 Token Monitor 部署跨网络同步服务Cloudflare Worker 一键上线iPhone 也能看用量【免费下载链接】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-monitorToken Monitor是一款本地优先local-first的桌面用量监控小组件能统一追踪 Claude Code、Codex、Cursor 等 43 款 AI 编码工具的 Token 用量、花费与额度限制。默认情况下它只在单台设备上工作但通过内置的Cloudflare Worker 同步服务你可以把多台电脑的数据汇总到云端甚至让iPhone 小组件也能实时查看用量。本文将带你快速完成这套跨网络同步服务的部署。为什么需要跨网络同步Token Monitor 提供多种多设备同步模式详见 docs/configuration.md模式适用场景局限本机托管 Hub局域网 / Tailscale / ZeroTier 内多设备依赖一台常开电脑自建 Node Hub有闲置服务器的用户需要公网可达、常开机Cloudflare Worker Hub跨网络、跨设备、iPhone无本文主角iCloud Drive仅 macOS 小组件不支持无头 Agent如果你经常在公司、家里、咖啡馆之间切换又想出门时用 iPhone 瞄一眼今天烧了多少 TokenCloudflare Worker 方案是最省心的选择无需自备常开机器Cloudflare 帮你跑默认公网 HTTPS任何网络、任何设备都能访问免费额度对小型团队完全够用每天 10 万次请求实际用量不到 2 万。一键部署 Cloudflare Worker 同步服务Worker 版 Hub 是官方自托管 Node Hub 的平替使用同一套 HTTP 协议/api/ingest、/api/stats、/api/stats/stream桌面端和 Agent 无需任何改动只需把 Hub 地址换成新地址即可。设备状态由 Cloudflare 的 Durable Object 存储源码见 worker/src/index.js。准备工作一个免费的 Cloudflare 账号 本地 Node.js 22 以上。手动部署只需 5 条命令详见 worker/README.mdgit clone https://gitcode.com/gh_mirrors/tok/token-monitor cd token-monitor/worker npm install npx wrangler login # 首次浏览器授权 npx wrangler secret put TOKEN_MONITOR_SECRET # 输入一段长随机字符串 npx wrangler deploy部署成功后Wrangler 会打印你的专属地址形如https://token-monitor-hub.your-subdomain.workers.dev 项目也支持Deploy to Cloudflare按钮一键部署但该入口偶尔会出现解析配置失败、部署出Hello world空壳的云端问题。遇到时换个无痕窗口重试或直接使用上面的手动命令——效果完全一致。⚠️ 注意TOKEN_MONITOR_SECRET是全部数据接口的钥匙。未设置时除健康检查外所有接口都会返回503 secret_required。请妥善保管不要泄露。在桌面端连接同步服务部署完成后在每台电脑的 Token Monitor 中操作打开设置 → 多设备同步选择连接 Hub粘贴 Worker 地址和刚才的 Secret保存后状态徽标会从Local变为Live表示 SSE 实时流已接通。此后各设备自动上报用量Worker 在云端按今天 / 本月 / 全部时间三个周期聚合所有设备的 Token 与花费并通过 SSE 流实时推送给每个连接者——断线重连时会先下发完整快照不会丢状态。完整的接口定义见 docs/API.md。在 iPhone 上查看用量Widgy 小组件方案Worker 的GET /api/stats接口返回纯 JSON 且开放 CORS正好能被 iOS 的小组件运行时Widgy、Scriptable直接调用。Widgy 配置要点官方推荐配方在 worker/README.md选择async / no main()模板由于 Widgy 的 WKWebView 对Authorization请求头支持不佳需使用?secret查询参数方式鉴权。官方提醒这属于有限的兼容路径密钥可能出现在代理日志中请知悉风险最小可用脚本只需几行请求/api/stats?secretxxx从periods.today.totalTokens取当日 Token 数显示即可。Scriptable则可以走标准Authorization: Bearer请求头直接loadJSON()拿到统计数据。由于 iOS 小组件没有推送通道运行时每隔几分钟自动拉取一次因此无需额外配置。最终效果如下——出门在外抬眼即可看到全设备汇总的 Token、花费与各工具额度如果你希望不鉴权地对外展示例如公开看板还可以设置PUBLIC_STATS_ENABLED1启用/api/public/stats接口——该接口会自动剥离设备清单与账号标识只保留聚合数字。常见问题快速排查现象原因与解法所有接口返回503 secret_required未设置TOKEN_MONITOR_SECRET部署时补上即可状态一直是Local不变Live核对 Hub 地址与 Secret 是否一致检查网络能否访问 workers.dev某台设备显示离线设备的最后上报超过 10 分钟会被标记stale默认值恢复联网后自动消失一键部署按钮失败Cloudflare 侧偶发问题改用npx wrangler deploy手动部署想实时看 Worker 日志在worker/目录执行npm run tail小结从一条git clone到 iPhone 小组件显示真实用量整个过程不到 10 分钟且全程使用 Cloudflare 免费额度。Token Monitor 的 Worker Hub 用 Durable Object 替代了自托管 Node 服务让跨网络同步 AI 工具用量这件事第一次变得如此轻量。部署完成后建议配合内置的仪表盘查看趋势与模型分布把每一分 Token 花费都看得明明白白。更多端点、鉴权方式与响应字段说明可继续参阅 docs/API.md 与 worker/README.md。【免费下载链接】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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表