--- name: lxmusic-playlist-sort description: 在本地完成 LX Music 歌单经 Spotify 和 Sort by Tune 排序后回填的流程,包括完整 TXT、导入失败修复、歌曲映射缓存和原始 LX 存档重排。适用于 lxmc、mylist 或 Spotify 排序回填请求。 --- # LX Music 歌单排序 使用 `scripts/playlist.py`(Python 3 标准库),本地保存数据,无需服务端。命令、输入结构及恢复方法见 [references/workflow.md](references/workflow.md)。执行前读该参考。 ## 用户约定 - Spotify/Sort by Tune 只提供顺序。回填使用原始 LX 歌曲对象,保留名称、歌手、版本、来源、ID 和全部元数据;其他歌单不变,原文件不覆盖。 - 默认交付**完整 TXT**,包括已选备选版本。不要仅给失败歌曲补丁;同一原曲的备选是替换导入行,不是额外追加歌曲。 - 已确认的重复歌曲不补回。同名不能证明重复;不同歌手、现场、混音、翻唱等不能擅自合并。跨来源重复须记录明确 duplicate group。 - 缺失歌曲按原顺序插在最近的原前驱后;没有前驱时放在最近原后继前。连续缺失保持相对顺序。 - 备选的音乐特征可能不同,属于排序代理,不得标注为同一录音。已选备选可复用;新候选需记录证据及差异,歧义不能盲选。 ## 入口 1. **收到 LX 存档**:prepare,默认 mylist;有重名则用 ID。生成 source 快照、映射快照、manifest 和 complete.txt。映射库已有 Spotify ID 时优先 URL,没有时使用原歌手/曲名。 2. **收到导入报告**:reconcile,结合 manifest 阅读失败记录,联网搜索候选并核对歌手、版本、时长及可用性;map 更新映射并自动重写完整 TXT。报告可能去重或改名,禁止按 CSV 行号直接对应 LX 位置。没有新证据就保留未匹配项并报告,不反复重试相同名字。 3. **收到排序完成的 Spotify 链接/URI 或导出**:snapshot 获取顺序。用网站显示、完整导出或用户提供的总数独立验证读取完整性;不要拿本次读取长度充当总数证据。无法读取或数量不符时用完整有序导出,不能把截断部分当成缺失歌曲回填。restore 遇到未映射/歧义歌曲会停止并生成 unmatched.json;核对后 map,再恢复。 用户默认自行登录、导入、在 Sort by Tune 调整权重并保存顺序。无需自动操作账户。本 Skill 不固定网站按钮名称或臆造权重;涉及当前网站操作时查看实际界面/文档。 ## 持续状态与交付 默认缓存 `~/.local/share/lxmusic-playlist-sort/mappings.json`;可用 `LX_SORT_DATA` 或 `--data` 覆盖。每次使用独立 `runs/<时间-歌单>/`,不要覆盖历史运行。先检查缓存及已有 run,支持新对话续接。修改全局缓存后执行 refresh 才更新运行快照;注意这也会更新该运行 TXT。 生成文件后报告原始数量、Spotify 数量、最终数量、缺失插入和去重数量。交付完整 TXT 或新的 .lxmc 与校验报告。验证其他歌单不变、歌曲对象原样保留、源文件未改。将交付文件复制到当前项目 outputs 供用户下载,内部运行和缓存路径不必逐一展示。 仓库分发包不包含个人歌单、映射或历史运行。新机器若需延续已有匹配,单独迁移本地数据目录;首次使用无缓存时从原始曲名开始。已有映射也不代表录音版本全部经过验证,需查看 kind/note。公开播放器可播放不等于用户所在地区可导入。