Feature guides
Cache & source updates
This article follows the authoritative Chinese source. English translation is not yet available. Read the Chinese version.
更新与复用
每次准备选中歌词时，对比完整原歌词 TTML 的 SHA-256。文字、时间轴等变化会使旧缓存失效。接口、模型或有效思考配置变化也会重新翻译；仅轮换 API Key 不影响复用。
检测依据是本次实际提供的原歌词，不单独轮询远端。在线歌词来源的刷新仍按在线补全策略进行。每首歌保留一份当前缓存，最多保留最近使用的 100 首；切换来源或模型可能替换该歌曲的缓存。
调用记录与统计口径
| 项目 | 含义 |
|---|---|
| API 请求 | 实际提交的歌词翻译及连接测试请求，包含失败和取消的尝试；输入不合法、跳过和缓存命中不计入 |
| 成功 / 失败 / 取消 / 进行中 | 请求结果；播放器解析或文件保存失败独立记录，不伪装成 API 失败 |
| 缓存歌曲 | 当前磁盘上有效的翻译条目，与“已配置”的原歌词列表分开 |
| 缓存命中 | 使用已有翻译，未发起新的 API 请求 |
| Token | 接口返回的输入、输出和总量；没有返回时显示“—”，不推算费用 |
| 请求详情 | 类型、歌曲或 ID、模型、服务主机、时间、耗时、HTTP 状态与固定错误原因 |
| 缓存与播放诊断 | 保存成功/失败、来源或配置变更、跳过原因、播放器未接收等状态 |
统计从此版本启用后或上次清空后累计，不能还原旧版 API 调用。最近 200 条事件保存在本机；累计计数独立于记录条数。清除已完成记录和统计会保留进行中的请求。
日志不记录 API Key、认证头、接口返回正文、提示词和歌词原文；完整歌词只存在功能本身的本地缓存中。记录不会上传到本项目服务器。