首次启动与初始化全流程
启动时间预期
第一次启动需要加载本地服务（netease-cloud-music-api）和初始化数据库，比后续启动慢一些：
- 桌面端：3-10 秒（首次），之后 2-5 秒
- 安卓：2-5 秒
- 网页版：浏览器缓存加载速度
首次启动清单
第一步：用户协议确认
启动后首先显示用户协议，核心声明三点：
- 本软件仅用于学习交流
- 禁止用于商业用途
- 支持正版音乐会员
点击同意继续。
第二步：本地服务初始化
应用会在本机启动 netease-cloud-music-api 服务。正常情况下几秒完成，右下角托盘或状态栏会有服务状态提示。
第三步：端口配置（可选）
默认使用某个本地端口，如果端口被占用会启动失败白屏。解决方法见 排错：白屏修复。
第四步：登录网易云账号（推荐）
虽然不登录也能听，但登录后才能：
- 同步你的歌单与收藏
- 查看播放历史
- 获取每日推荐
- 使用高品质音质（需 VIP）
登录方式见 账号同步：网易云登录。
首次使用建议配置
完成启动后，建议按顺序调整以下设置：
- 主题：设置 → 外观 → 明暗主题 / 跟随系统
- 音频设备：设置 → 音频 → 选择输出设备（如果有耳机和扬声器切换需求）
- 歌词窗口：设置 → 歌词 → 开启桌面歌词、选择显示模式
- 快捷键：设置 → 快捷键 → 配置全局快捷键（播放/暂停、上一首/下一首）
- 自动更新：设置 → 通用 → 检查自动更新开关
常见首次启动异常
| 现象 | 可能原因 | 参考 |
|---|---|---|
| 白屏无内容 | 本地端口被占用 | 排错页 |
| 极慢（>30秒） | 首次加载本地 API | 正常现象，耐心等待 |
| 启动崩溃 | 缺少 NeteaseCloudMusicApi anonymous_token | 排错页 |
| 托盘图标乱序 | 多任务栏环境 | 重启应用 |
关于安全声明
v5.1.0 安全更新：本地音乐 API 仅监听回环地址（127.0.0.1），不会暴露到局域网或公网。LX Music 脚本执行隔离到 Worker 沙箱。这些安全加固意味着你可以放心在常驻开机启动的环境下运行应用。