用途:将曲目 markdown 文件(.md)按配置移动到用户内容目录中对应专辑的位置。
主要能力:解析参数 <file-path> <album-name> [track-number];通过 MCP 调用 find_album(album_name) 按名称、slug 或部分匹配查找专辑并获取流派等元数据,再调用 resolve_path("tracks", album_slug) 得到完整曲目目录路径;构造目标路径 {content_root}/artists/{artist}/albums/{genre}/{album}/tracks/{XX}-{track-name}.md;用 mv 移动文件并输出确认信息。
使用方式:命令格式为 /import-track <file-path> <album-name> [track-number],例如 /import-track ~/Downloads/t-day-beach.md sample-album 03。曲目编号若参数提供则使用并补零(03);若文件名已带编号前缀则保留;两者都没有时会询问用户。
限制与错误处理:源文件不存在、配置文件缺失(~/.bitwize-music/config.yaml,需先运行 /configure)、专辑不存在(需先用 /new-album {album-name} <genre> 创建)都会报错;目标已存在同名曲目时会提示是否覆盖,原文件不会被移动。曲目必须放在专辑下的 tracks/ 子目录,编号需补零以保证排序。资料未提供其他平台、收费或效果信息。