自定义点唱机音乐

[quote][b]描述[/b][/quote][line]
自定义点唱机音乐让你可以在星露谷物语的点唱机中播放自己的音乐——无需编程、无需编辑 XNB、无需搭建工具链。
这是一个 Content Patcher 内容包，专注于做好一件事。你把音频文件放入模组自带的 assets 文件夹，运行附带的刷新脚本，每条音轨就会被转换、注册，并以真实名称列在点唱机中。删除文件，再次运行脚本，歌曲就会从播放列表中消失。
添加音乐的工具内置了便携式 Python 运行时和 FFmpeg，因此你无需安装任何东西——不用装 Python，不用装 FFmpeg——也不需要联网。解压、放进 Mods 文件夹，它就能在任何 Windows PC 上运行。
该内容包附带一个空的播放列表：assets 文件夹留给你来填充。
[quote][b]安装说明[/b][/quote][line]
1. 先安装 SMAPI 4.0+ 和 Content Patcher 2.4.0+（见“前置要求”）。
2. 解压下载文件，将整个 Customize jukebox music 文件夹移入你的 Stardew Valley\Mods 文件夹。保持文件夹完整——工具会相对于该文件夹定位自身，因此文件夹名称本身无关紧要，但不要将文件移出该文件夹。
3. （可选）添加你的音乐：将音频文件复制到 Customize jukebox music\assets\ 中。你可以创建子文件夹来整理它们（例如 assets\Albums\）——任意深度的子文件夹都会被扫描。
4. 双击模组文件夹中的 refresh_songlist.bat，等待出现 Done. 横幅。控制台会告诉你哪些歌曲被添加、移除或重命名，并打印完整播放列表。
5. 启动游戏并打开点唱机。
要移除歌曲：从 assets 中删除其 .ogg 文件，然后再次运行刷新脚本。
- 刷新工具的控制台消息目前为中文，但流程很简单：第 1 步转换音频，第 2 步重建播放列表，最后一屏是结果摘要。
- 养成在每次更改 assets 后运行脚本的习惯。游戏只读取 content.json，因此更改会在下次启动时生效。
[quote][b]主要功能[/b][/quote][line]
- 只需放入文件。任何常见格式都可以：MP3、WAV、FLAC、M4A/AAC、WMA、AIFF、APE、WV、MKA、MP4、Opus 和 OGG。文件通过其实际文件头而非扩展名来识别，然后转换为 Ogg Vorbis——星露谷物语音频引擎可以流式播放的格式。
- 自动重建播放列表。每次运行都会重新扫描 assets 并从头重新生成 content.json，因此添加、删除、重命名或移动歌曲都会始终得到反映。不会留下指向已不存在文件的陈旧条目。
- 支持子文件夹。你可以按自己的喜好组织音乐库——任意文件夹深度都会被扫描。
- 点唱机中显示真实歌曲名称。每条音轨都以其文件名列出（多余空白会被合并），而不是通用的内部 ID。
- 清晰的变更报告。每次运行都会打印变更内容——添加、移除和重命名——随后是完整播放列表，另有针对转换失败文件、重复显示名称或 ID 冲突的警告。
- 非破坏性转换。已经是 Vorbis 的文件会被跳过。转换会先写入临时文件并在替换原文件前进行验证，源文件只有在转换成功并通过验证后才会被删除。
- 零安装，可离线运行。模组内置便携式 CPython 3.13 运行时和 FFmpeg 7.1，因此该工具可在未安装 Python、未安装 FFmpeg 且无网络连接的干净 Windows 机器上运行。
- 紧凑且安全。这些工具只会读写自己的模组文件夹。它们绝不会触碰其他模组或游戏自身文件。
- 对 Better Jukebox 更友好。自定义音轨会被注册为始终可用，因此它们会与本体原声一起出现在 Better Jukebox 的可滚动列表中。
- 对 Unicode 友好。中文、日文及其他非拉丁文件名的处理都正确；内部 ID 会安全生成。
[quote][b]前置要求[/b][/quote][line]
- 星露谷物语 1.6 或更高版本。
- SMAPI 4.0 或更高版本
- Content Patcher 2.4.0 或更高版本
模组的 manifest 会强制检查，因此过时的 Content Patcher 会给出明确的 SMAPI 错误，而不是静默地什么都不做。
- 添加音乐工具需要 Windows，因为内置的 Python 和 FFmpeg 二进制文件是 Windows 版本。音乐包本身与平台无关：在 Windows 上生成 content.json，将文件夹复制过去，它就能在 macOS 或 Linux 上的 Content Patcher 下正常播放。
- 无需互联网连接。
- 可选：Gaphodil 的 Better Jukebox——将点唱机菜单替换为可滚动、可搜索的列表。并非必需，但当你拥有大型收藏时推荐使用。
[quote][b]致谢[/b][/quote][line]
- Gaphodil——感谢 Better Jukebox，它将该模组围绕设计的原版点唱机转变为可滚动列表。
- FFmpeg 开发者，以及 gyan.dev 提供的 Windows 构建——本包中的每次转换都通过 FFmpeg 运行。
- Python 软件基金会——工具附带的便携式 CPython 运行时是他们的成果。
本模组捆绑的第三方组件按其各自许可证再分发：CPython 依据 PSF License Agreement，捆绑的 FFmpeg 构建依据 GPLv3（它启用了仅 GPL 的组件）。相应的许可证文本随模组附带于 tools\python\LICENSE.txt 和 tools\bin\LICENSE-ffmpeg-GPLv3.txt。