企业官网建设流程全解析

你是否想知道自己上个月听了多久音乐、哪首歌被循环最多？本地音乐播放器Music内置的Insights（洞察）模块，用听歌回顾（Recap）、最近播放（Recently Played）和隐藏曲目（Hidden Tracks）三大功能，把你在 mobile/src/modules/insights/ 里积累的每一秒播放记录都变成了可阅读的数据故事。这篇指南带你快速上手这些功能，轻松回顾你的听歌足迹 🎧

如何进入 Insights 回顾入口

所有洞察功能都集中在一个页面里，路径非常固定：

设置 → Insights（源码入口见 View.tsx）

打开 Insights 主页（View.tsx）后，你会看到四个区域：

Recap 听歌回顾：支持"全时段 / 最近7天 / 按月 / 按年"切换

进入 Recap 页面（RecapView.tsx）后，顶部有一个时间范围选择按钮，这是整个回顾功能的灵魂：

• All-Time（全时段）：统计从开始使用 App 至今的全部数据
• Last 7 Days（最近 7 天）：天数由 constants.ts 中的RECENT_DAY_RANGE常量定义
• 按月 / 按年：自动生成 App 使用期内的每一个月份和年份选项，方便翻查"2025 年 3 月"这样的历史片段

选好范围后，页面会展示三层内容：

1. 快速概览：总收听时长、总播放次数、听过的唯一曲目数与歌手数
2. Most Played 三冠王：播放最多的单曲、歌手、专辑各一位
3. Top 排行榜：曲目 / 歌手 / 专辑三个榜单，默认显示前 5 名，点击"Show All"可展开全部

💡小技巧：Recap 页右上角的"交换"图标还支持导出数据备份与导入。换手机重装 App 后，历史回顾数据不会丢失，导入即可完整恢复。

背后的统计逻辑在 useRecap.ts 中：播放次数并不是简单计数，而是按"累计收听时长 ÷ 曲目时长"四舍五入得出，避免反复从头播放同一首歌被算成几十次。

最近播放列表：首页速览 + 独立页面双入口

"最近播放"有两处入口，体验各不一样：

• 首页顶部卡片：HomeView.tsx 中的 Weekly Recap 卡片会用一句人话告诉你——"过去 7 天，你听了X 小时来自Y 个歌手的Z 首音乐"，点击直接跳转回顾页
• Recently Played 页面：横向滚动的最近专辑/歌单卡片 + 完整曲目列表（RecentlyPlayedView.tsx），方便快速续播

如果最近 7 天没听过任何歌，页面会显示"Nothing was played in the last 7 days"提示，空状态处理得很贴心。

隐藏曲目：误隐藏的歌怎么找回来

在多选中执行 "Hide Selected" 后，曲目会从应用界面消失。想找回它们？进入Insights → Hidden Tracks：

• 列表按年月 → 日期两级分组，每首歌都标注了隐藏时间
• 点击歌曲右侧的"眼睛"图标即可立即恢复显示，曲目会自动回到音乐库
• 实现位于 HiddenTracksView.tsx

同一页面下的Save Errors则负责另一件事：列出扫描时未能保存的曲目及其具体报错原因，帮你排查损坏文件。

实用建议：用数据管理你的曲库

• 📊 每月固定看一次"按月"Recap，观察听歌口味变化
• 🗑 存储占满时，先到 Insights 主页的存储概览定位大头，再用"优化数据库"清理冗余
• 🔄 换机前记得导出 Recap 备份，你的数据故事值得完整保留

更多功能细节可参考官方文档 docs/features.md，祝你听歌愉快！