用途:启动 claude-music 的本地网页仪表盘,在浏览器中生成歌曲并管理曲库。
启动方式:运行 bash ~/.claude/skills/claude-music/scripts/music_web.sh;可指定端口,如 bash ~/.claude/skills/claude-music/scripts/music_web.sh 9000。启动器会运行仅用标准库的 Python 服务,绑定 127.0.0.1,默认端口 8765,被占用时自动递增,随后打印 URL 并打开浏览器;Ctrl-C 可停止。
主要能力:单一生成框,包含提示词、多选风格标签(来自 references/genre-recipes.md)与预设;引擎运行时显示实时进度百分比(--progress NDJSON 事件);带波形条的播放器随音频动画;曲库基于配置的 output_dir,1-5 星评分保存在 <output_dir>/.claude-music/meta/ 附属文件中;支持下载、打开输出文件夹、以相同提示词与设置但新种子生成相似曲目。
拖放音频:把自有音频拖到页面即可加入曲库,然后可执行 Audit(ffprobe + loudnorm 报告并给出修复建议)、Optimize(两遍响度归一化,面向 Spotify/Apple/YouTube/TikTok/播客)或 Similar(以该音频做翻唱式生成,强度可选 Loose/Balanced/Faithful)。播放器波形是曲目真实轮廓,点击可跳转,已播放部分填充品牌橙色。
限制:同一时间只运行一个生成任务(受显存限制),并发请求返回 409;若 config.json 仍为 CHANGE_ME,页面会显示安装说明,需先运行 install.sh;服务不会绑定非回环地址,请勿手动对外暴露。