Token 用量与云端同步
Kaya 聊天与模型网关共用 Token 记账，只记录供应商、模型、Agent 标识、请求次数与实际计数，不记录请求正文。上游没有返回 usage 时不估算、不编造。
本地用量统计#
打开 ⚙ 设置 → 模型 → 用量统计，查看最近 90 天的默认窗口，按模型、Agent 与日期筛选，并按天、周、月聚合。本机用量事件保留 180 天。
快速决策、任务提炼、记忆巩固等独立辅助调用与入口路由判定不计入；路由判定触发的主聊天回合照常计入。这些数字用于自我观察，不能作为供应商账单或余额。
云端 Token 用量（可选，默认关闭）#
- 打开 ⚙ 设置 → 账户 → 云端 Token 用量。
- 阅读「会上传 / 不会上传」清单，确认
kaya-usage-upload-v2后开启。版本变化、旧状态无法核验身份或检测到账号切换时，旧同意会失效，需要重新确认。 - 产生新的聊天或网关请求，或按设置页显示的范围确认历史回填。当前时间桶中的新用量无需等到整点才可同步。
- 登录官网并打开 模型用量 页面。
上传内容包括：
- 按 UTC 小时或天聚合的来源、Agent、归一化供应商键、模型 ID、Token 计数与请求次数。
- 设备注册所需的随机设备 ID、OS 家族、Kaya 版本与同意版本。不采集主机名或硬件指纹。
**不上传对话正文、工具或文件内容、文件路径、仓库信息、当前目录、API Key 或 OAuth token。**自定义供应商显示名、设备级 provider ID、接口地址和自定义请求头也不上传；登录凭据只用于请求鉴权。
新同意与历史回填#
- 旧状态不能证明历史身份时，重新同意默认只上传新授权后的用量。若符合条件，要另点「回填最近 30 天历史」，预览实际范围后再明确确认。
- 从未保存过上传状态的首次同意可回填最近 30 天，但受本机记录、云端保留期与授权范围限制。历史事件没有账号归属，预览会披露可能包含以前账号期间用量的情况。
- 当前可信同账号普通关闭后重开，仍可回填关闭期间的用量。
- 检测到账号切换后会作废旧同意、隔离旧身份历史并换用新设备标识；历史回填需单独确认。
- 撤销后只有明确重新同意才恢复上传并生成新设备标识；撤销前和撤销后未授权期间的用量不补传。可回填的新授权窗口可能短于 30 天。
- 国内版、国际版分别保存同意、上传游标与设备身份。独立 CLI 的新用量只留本机，暂不上云。
关闭、撤销与保留#
关闭上传只停止本机后续同步，不删除已上传的云端数据。撤销也不等于物理删除：现有云端撤销是软撤销，用量清除不会连带删除设备行；网站目前没有设备撤销按钮。多次换账号后，同一台机器可能留下多个历史设备条目。
本机用量事件保留 180 天；云端统计窗口以服务端配置为准，上限为 180 天。云端备份残留最长 30 天由云端服务保证，不能把本机清理或关闭上传当作云端数据已清零。
官网控制台能做什么#
- 按来源（全部 / 聊天 / 网关）、日期、Agent、供应商、模型与设备筛选。
- 查看汇总、趋势、设备覆盖及最近同步状态。设备上传状态和远程在线状态不是同一个指标。
- 导出当前范围的 CSV 或 JSON；超出上限时缩小范围，或明确选择带截断标记的部分结果。
- 页面在可见时每 5 秒刷新，分享链接保留筛选条件。
没有数据时，先检查设置页的同意是否仍有效、是否已开启上传，以及最近同步结果。只有在成功同步后，官网才会显示相应范围的数据。
隐私边界#
使用情况心跳默认开启：登录后每 5 分钟向 yunhou 发送活跃时长、平台、应用版本、日期及事件标识，不含对话或文件内容；可在 设置 → 账户 关闭。
心跳、本机 Token 记账和云端 Token 上传是三个独立通道。关闭心跳不会等同于撤销云端 Token 同意，选择 Ollama 也不会自动关闭已启用的统计通道。完整说明见 Kaya 产品隐私 与 隐私与安全。