## 功能特性 - 从 Spotify `Extended Streaming History` 或 `Account Data` 导出的 `.zip` / `.json` 文件生成本地分析。 - 展示 Arousal / Valence / Depth 音乐画像、Top Artists、Top Tracks、Top Genres 和随时间变化的阶段图。 - 支持播客数据纳入 AI Wrapped 与报告，也可以在上传前关闭播客参与 AI 分析。 - 支持好友口味对比：上传另一个人的 Spotify 导出文件后计算相似度、共同艺术家和共同曲风。 - 支持可选 LLM 报告：可在应用内设置 OpenAI 兼容接口、Anthropic 或 Ollama。 - 支持导出一个自包含 `spotilyze-profile.html`，离线打开也能查看交互式报告。 ### 日常使用方式 1. 上传新的 Spotify 导出文件后，最新分析会覆盖当前应用中的共享分析会话。 2. 点击 `Compare taste（比较口味）` 可上传好友的导出文件，好友文件只用于当次对比，不会写入持久化会话。 3. 点击 `Share（分享）` 可导出 `spotilyze-profile.html`，用于离线查看或发送给他人。 4. 点击左下角设置按钮可重新打开 LLM 配置向导，填写模型、API Key 或 Base URL。 5. 点击 `New upload（新上传）` 只重置当前浏览器界面；后端最近一次分析会话仍会保存在持久化目录中，直到下一次上传覆盖。 ### Spotify 导出文件获取方式 Spotilyze 不能直接读取 Spotify 在线账号，需要先从 Spotify 官方账号页面申请数据导出。 1. 用浏览器登录 Spotify，打开 [Spotify Account Privacy](https://www.spotify.com/account/privacy/)。 2. 找到 `Download your data（下载你的数据）` 区域。 3. 推荐选择 `Extended streaming history（扩展播放历史）`。这是完整账号生命周期的播放历史，最适合 Spotilyze 做长期阶段分析。 4. 如果只想快速试用，也可以选择 `Account data（账号数据）`。Spotify 官方说明中，最近一年的播放历史会在账号数据包的 `StreamingHistory.json` 中；完整播放历史在 Extended streaming history 下载包中。 5. 提交申请后，等待 Spotify 发送下载邮件。收到邮件后下载 ZIP 文件。 6. 上传时优先把 Spotify 下载的整个 ZIP 直接交给 Spotilyze；如果已经解压，选择其中的这些 JSON 文件： - `Streaming_History_Audio_*.json` - `StreamingHistory_music_*.json` - `StreamingHistory_podcast_*.json` - `StreamingHistory.json` 7. 不要上传 `Playlist.json`、`YourLibrary.json`、`SearchQueries.json`、`Inferences.json` 或 `Read Me First*.pdf`，这些不是 Spotilyze 的播放记录输入。 Spotify 官方数据说明可参考 [Understanding your data](https://support.spotify.com/us/article/understanding-your-data/) 和 [GDPR Article 15 Information](https://www.spotify.com/us/legal/gdpr-article-15-information/)。