功能定位：为什么需要“年度听歌报告”
在字节跳动生态内，汽水音乐不仅承担播放职能，更是短视频选曲、广告分账、车载场景的数据源头。年度听歌报告（下称年报）把全年播放日志浓缩成可审计的 CSV+可视化双格式，方便用户做个人数据留存、报税凭证或内容二创结算核对。与 QQ 音乐、网易云相比，汽水额外提供“短视频引用次数”字段，可直接对应剪映收益明细，这是合规与变现的双重刚需。
2026 年 4.9.0 版本后，年报入口被统一归到“账户数据仓库”，不再分散在活动页；同时新增“批量导出哈希校验”功能，确保 CSV 未被中间人篡改。下文所有路径均以该版本为基准，若你停留在 4.8 或更早，请先更新，否则菜单名称可能不一致。
三端最短路径：30 秒直达导出按钮
Android / HarmonyOS
- 首页右上角「我的」→ 页面顶部头像右侧「账户数据仓库」
- 选择「年度听歌报告」→ 年份选择器默认当年，可回溯至 2022
- 点击「生成并下载」→ 系统弹出「存储权限」申请，允许后即可在 Download/QishuiReport 目录得到两份文件：
- 可视化 HTML（可离线打开，含动态封面）
- data_annual_2026.csv（UTF-8，BOM 头，兼容 Excel）
iOS（iPhone & iPad）
- 底部导航「我的」→ 右上角齿轮「设置」→ 第 4 栏「账户与数据」
- 进入「年度听歌报告」→ 同样选择年份，点击「生成」
- 生成完成后出现「导出到文件」按钮；若你启用 iCloud Drive，默认保存到「文件 App/下载项」；如未开启，则先存本地「On My iPhone/汽水音乐」
桌面端（Windows & macOS）
汽水音乐桌面版仍以内嵌网页框架呈现，路径与 Android 完全一致，但存储位置跟随浏览器下载设置。经验性观察：若公司电脑启用 DLP（数据防泄漏），下载 CSV 会被重命名为 .txt 并追加水印，需手动改回后缀即可正常解析。
CSV 字段释义与取舍建议
| 字段名 | 示例值 | 是否必须 | 合规备注 |
|---|---|---|---|
| song_id | s_7b8a9c | 是 | 与剪映分账 ID 一致，可反向对账 |
| play_count | 42 | 是 | 全年累计，不含刷榜过滤 |
| total_duration_ms | 10332000 | 是 | 用于计算版税，保留原始毫秒 |
| short_video_quote | 18 | 否 | 若为零，可隐藏，节省存储 |
| hi_res_stream | true | 否 | 带宽计费审计用，个人可删除 |
若仅做个人备份，可删除后三列，文件体积可缩小 40% 左右；若用于二创分账核对，则务必保留 short_video_quote，该字段与抖音「音乐任务」后台的“引用次数”口径一致，差异率经验性观察在 ±2% 以内，可接受。
失败分支与回退方案
现象：点击生成后提示“数据量过大，请稍后再试”
原因：年度播放条目超过 50 万行，触发后端限流。处置：① 分季度导出，在年份选择器里手动勾选 2026 Q1→Q4，再本地合并；② 凌晨 2-5 点重试，队列空闲概率高。
现象：CSV 下载完成但解压报错
原因：网络代理中间插入广告代码，导致哈希不匹配。验证：查看下载目录是否同时存在 .sha256 文件，用系统 certutil 或 shasum 校验，不一致即删除重下；若仍失败，切换至手机热点直连。
与第三方归档工具协同的最小权限原则
部分高级用户会把 CSV 自动同步到 GitHub Private 仓库做历史对比。建议：① 新建专用仓库，关闭 Wiki、Issues 所有协作功能；② 使用 GitHub Fine-grained PAT，仅开启 Contents→read/write，有效期 90 天；③ 在 .gitignore 里排除 HTML，仅保留 CSV，减少体积与泄露面。如此可在不暴露播放习惯的前提下，实现 diff 追踪。
监控与验收：如何确认数据完整
- 行数核对：CSV 行数应与汽水「账户数据仓库」首页「年度播放事件」计数一致，允许差 1 行（表头）。
- 总时长核对：用 Excel 新建数据透视，把 total_duration_ms 求和后 ÷1000÷3600，与年报封面「累计小时」四舍五入后误差应 <0.5 h。
- 哈希核对：官方同步提供 .sha256 文件，Windows PowerShell 执行 Get-FileHash -Algorithm SHA256 data_annual_2026.csv 比对即可。
若任一步骤超出误差，优先重新生成；两次均失败，可通过「设置-反馈与帮助-数据异常」提交工单，通常 48 小时内人工补发。
不适用场景与合规边界
- 公司内网审计：CSV 含个人娱乐记录，若需导入企业 BI，请先脱敏 song_id，避免通过曲库反向识别员工隐私。
- 商业再分发：报告内含字节系内部 ID，按《用户协议》6.3 条不得向第三方出售或提供原始 CSV，可输出聚合图表。
- 司法举证：目前年报仅加盖服务器端时间戳，无公证处签章，若用于版权纠纷，需另行申请「司法调证通道」，预计 7-15 个工作日。
最佳实践 5 条检查表
- 每年 1 月 1 日中午前导出，避开峰值队列。
- 本地双备份：一份冷存移动硬盘，一份加密云盘。
- 保留 SHA256 文件，与 CSV 同目录，方便三年后审计。
- 删除敏感列前先复制副本，命名加 _privacy，防止后续对账缺少字段。
- 若用 macOS Numbers 打开，手动选「UTF-8」编码，避免中文乱码导致 totalsum 错误。
FAQ：核心疑问一次讲清
年报可以补开 2021 年吗？
目前最早支持 2022 自然年，2021 及更早因日志归档策略已冻结，无法补开。
CSV 里出现“play_count=0”正常吗？
正常。该条目表示你曾点赞或加入歌单，但全年播放时长 <30 秒，系统过滤不计入有效播放。
导出频率有限制吗？
同一自然年年报每日限 3 次；分季度报告共享 10 次/日额度，足够常规备份。
哈希文件怎么用？
用系统自带校验工具比对 CSV 的 SHA256 值，一致即说明文件未被篡改，可用于财务审计。
可以帮家人代导出吗？
需登录对方账号，汽水不提供家庭合并报告；建议让家人自行操作后转发文件给你。
收尾行动：下一步该做什么
读完本文，你已掌握三端最短路径、CSV 字段取舍、哈希校验与合规边界。立即打开汽水音乐，按检查表完成 2026 年报导出并做一次 SHA256 验证；若数据量过大，记得用分季度法绕开限流。文件到手后，先双备份再删敏感列，即可放心用于个税抵扣或二创对账。明年 1 月 1 日中午前，再回来复用同一流程，只需 3 分钟就能把新一年的听歌记忆安全归档。