TABBYPULSE · SUPPORT
帮助与支持
首次打开应用即可查看 Mac 系统状态。需要统计 AI Token 用量时，按下方说明连接本地数据目录。主应用需要 macOS 13 或更新版本；桌面小组件需要 macOS 14 或更新版本。
下载安装，只要两步
点击下载 Mac 版，打开下载的 DMG，把 TabbyPulse 拖进“应用程序”。然后从“应用程序”打开它，就能查看电脑状态。安装包支持 Apple Silicon 和 Intel，已通过 Apple 公证，不需要安装 TestFlight。
以后怎么更新？
目前需要回到官网下载新版本，退出正在运行的 TabbyPulse，再用新版本替换“应用程序”里的旧版本。支持“检查更新”的官网版本可从应用菜单、菜单栏的“更多”或“设置 → 通用 → 应用更新”检查新版，确认后在浏览器下载；安装替换仍需手动完成。2.0.1（19）及更早的版本需要先从官网手动下载一次。Mac App Store 版本通过商店更新。如果你原先通过 TestFlight 安装，也请先退出旧版本再替换。
连接 AI 工具
打开“Agent 用量”，开启需要统计的工具。点击“单独连接”，在系统窗口中确认对应工具的数据目录；连接多个工具时，可点击“一键连接”，按提示依次确认。目录只需授权一次，应用会记住授权。仅使用系统监控时可跳过此步，无需注册账号或开启“完全磁盘访问权限”。
| 来源 | 在系统窗口里选这里 | 你会看到什么 |
|---|---|---|
| Codex | ~/.codex | Token 用量；本地记录提供时也显示额度与重置时间 |
| Claude Code | ~/.claude | 会话中的 Token 用量 |
| 千问办公 | ~/.qwenworkcn | 工具写入的 Token 用量；未提供数字时会提示 |
| WorkBuddy | ~/.workbuddy | 会话中的 Token 用量 |
| OpenCode | ~/.local/share/opencode | 会话用量，兼容新旧版本的数据 |
| Hermes | ~/.hermes | 每个会话的累计用量，计入会话开始的那一天 |
| OpenClaw | ~/.openclaw | 当前与归档会话的用量，重复消息只算一次 |
| Pi | ~/.pi/agent | 会话中的 Token 用量 |
用过 AI，为什么统计仍为 0？
确认对应工具已开启并完成目录授权，再检查日期范围是否包含实际使用时间，点击刷新。应用通常每 30 秒统计一次。如果工具没有在本地记录中写入 Token 数值，TabbyPulse 无法估算这部分用量。使用 OpenCode 2.x 时，请安装 2.0.1（18）或更新构建，并选择包含 opencode.db 的数据文件夹。
看到“统计可能不完整”，该怎么办？
这表示有些记录暂时没能读完，例如工具正在写数据库、文件访问被拒绝，或者归档无法解析。先稍后刷新，再检查文件夹授权和工具版本。保留原始日志，联系开发者时说明工具名称与版本，我们才能一起排查。Hermes 的跨日会话会计入开始日期，因此每天的数字未必对应当天逐次发出的请求。
屏幕时间怎么用？
支持此功能的版本可以在侧栏打开“屏幕时间”，点“开启屏幕时间”开始记录。按日选择最近 30 天内的日期，或查看“最近 7 天”；点击趋势柱形、应用排行或时间线的时段菜单可筛选活动。使用时长只统计前台应用，无操作的前 60 秒仍计入，之后视为空闲；锁屏、睡眠、切换用户及采样中断期间不补记。请保持 TabbyPulse 运行；它不会读取系统屏幕时间历史，数字也不保证与系统统计相同。
点“暂停记录”停止读取活动状态，点“继续记录”恢复。点“清除记录”并确认，会删除本地活动历史并关闭计时。仅保留最近 30 个自然日，暂停期间仍清理过期记录；每 30 秒保存一次，异常退出可能丢失未保存的记录。出现读取或保存错误时会停止计时并显示提示，支持重试保存或清除后重新开始。
不想继续统计了，怎么关？
到“设置 → Agent 用量”关闭对应工具，就会停止扫描。想让应用忘记文件夹，再点该工具的移除目录按钮。关闭统计不会删除 AI 工具自己的记录。需要彻底清除 TabbyPulse 的本地数据，请看隐私政策。
联系开发者
直接写信到 yueyong1030@outlook.com。告诉我你用的 TabbyPulse 和 macOS 版本、哪个工具出了问题，以及操作到哪一步。附一张遮好个人信息的截图通常就够了，不需要发送 API 密钥或完整对话日志。