1. 快速开始
打开播放器后，如果没有本地 playlist.js 或上次保存的歌单 ID，页面会直接进入空列表状态。你可以从三个入口开始：
- 设置里粘贴网易歌单链接或歌单 ID，点击“加载”。
- 右侧面板切到“搜索添加”，搜索歌曲并加到当前播放。
- 拖拽或选择
playlist.js/.json导入本地歌单。
2. 界面结构
桌面端
右侧浮动面板包含三个并列标签：当前播放、搜索添加、云歌单。云歌单不再是单独侧边栏。
手机端
底部抽屉同样有当前播放、搜索添加、云歌单三个标签。点底部列表按钮打开，向下拖动关闭。
3. 播放列表来源
CPlayer 会区分“当前播放”来自哪里，这会影响保存时如何绑定 ID。
| 来源 | 怎么来的 | 保存当前时 |
|---|---|---|
| 网易歌单 | 设置里输入歌单 ID 或链接加载 | “另存为”会保留 source=netease 和原始歌单 ID |
| 缓存歌单 | IndexedDB 先读缓存，后台更新 | 修改只影响当前队列，另存后形成 CPlayer 歌单 |
| 导入文件 | playlist.js 或 JSON | 另存为自定义歌单 |
| 搜索临时列表 | 搜索添加歌曲堆出来的列表 | 另存为自定义歌单 |
| 设备/云歌单 | 从云歌单标签里加载 | 提示条可写回原歌单，也可保留原歌单并另存 |
4. 云歌单核心概念
同步层按设备和账号隔离：未登录时创建的是设备歌单；登录后显示账号云歌单。登录成功时会弹出选择框，只把你勾选的设备歌单同步到账号。
设备歌单
存在浏览器 IndexedDB 里，有 6 位稳定 ID。没登录也能保存；未在登录弹窗中选中的歌单继续留在本机。
云端歌单
存在同步后端账号下，登录后可以跨设备刷新和加载。新建云歌单默认是私密。
现在列表里显示的是稳定 ID，不再显示 v1、v2 这种版本号。版本号只是冲突处理用的内部字段，不应该干扰日常使用。
5. 保存与同步动作
| 按钮 | 作用 | 什么时候用 |
|---|---|---|
| 新建 | 创建一个空歌单。未登录时保存在设备，登录时创建私密云歌单。 | 你想从零维护一个收藏歌单。 |
| 保存当前为歌单 / 另存 | 始终创建新歌单，不覆盖当前来源。登录时保存为私密云歌单，未登录时保存到设备。 | 你想保留原歌单，同时保存当前队列的变化。 |
| 保存到原歌单 | 只在“未保存更改”提示条出现，明确把当前队列写回加载它的设备或云歌单。 | 你确认打乱、添加或移除结果应该替换原歌单。 |
| 刷新 | 从同步后端重新拉取云歌单列表，并尝试发送离线待同步操作。 | 你在别的设备改过歌单，或者刚登录后想同步列表。 |
6. ID 和状态怎么看
每个歌单行都会显示 6 位 ID，例如 abc123。ID 用于识别歌单，但新分享链接还必须带 10 位区分大小写的 token，例如 ?cloud=abc123.K7pQ2mN8xR。
- 保存当前后，本地会出现一个固定 ID。
- 6 位 ID 可能恰好全部是数字；分享时请使用完整链接，播放器会通过
cloud参数区分 CPlayer 歌单和网易歌单。 - 私密歌单无法通过公开接口访问。
- 切换为“链接可见”后才会生成分享 token。
- 设回私密后，已有分享链接立即失效。
状态含义：
LOCAL 只在本地。 DIRTY 本地有改动待上传。 CLOUD 已在云端。 CONFLICT 云端和本地版本冲突，需要选择使用哪边。
7. 搜索添加和当前播放
搜索添加会把歌曲插到当前播放队列里，并显示未保存提示条。打乱、移动、移除和清空同样只影响当前播放；是否写回原歌单由你决定。
搜索框也支持直接输入歌曲 ID，用于快速解析单曲。
8. 手机端怎么操作
- 底部列表按钮打开抽屉。
- 顶部三个标签切换：当前播放、搜索添加、云歌单。
- 云歌单里的新建、另存、刷新和未保存提示条与桌面端语义一致。
- 主界面左右滑动可以切换封面和歌词。
9. 常见问题
为什么修改云歌单后没有立刻同步？
当前播放是临时队列。请在黄色提示条选择写回原歌单或另存，这能避免误操作直接破坏收藏。
登录时没有选择某个设备歌单，会丢失吗？
不会。它继续留在设备空间，下次登录仍可选择；退出登录后也会重新显示。
只有 6 位 ID 为什么不能打开别人新分享的歌单？
新链接还需要 10 位 token。旧版已存在的 ID 分享链接会在迁移期继续工作，歌单所有者修改可见性或重置 token 后旧链接失效。
发生同步冲突怎么办？
“保留两份”最安全，会把本地内容保存为私密副本；也可以使用云端或智能合并。接口错误会显示 HTTP 状态，音频地址无法获取状态时会显示浏览器媒体错误码。