SuperAPI AI 工具集

import-art

通用与其它

查看项目

更新于 10-15 20:06

技能介绍

用途:把已生成或下载的专辑封面导入到两个必需位置——音频目录(供平台/母带使用)和专辑内容目录(供文档使用)。

主要能力:解析参数 <file-path> <album-name>;通过 MCP 调用 find_album(album_name) 模糊匹配专辑并获取元数据(含 genre),调用 resolve_path("audio", album_slug) 与 resolve_path("content", album_slug) 解析路径;自动创建目录并复制文件。音频位置命名为 album.png,内容位置保留扩展名命名为 album-art.{ext}。

使用方式:命令格式为 /import-art <file-path> <album-name>,例如 /import-art ~/Downloads/sample-album-cover.jpg sample-album。缺少参数时提示用法。复制命令示例:mkdir -p {audio_root}/artists/{artist}/albums/{genre}/{album};cp "{source_file}" "{audio_root}/artists/{artist}/albums/{genre}/{album}/album.png";cp "{source_file}" "{content_root}/artists/{artist}/albums/{genre}/{album}/album-art.{ext}"。完成后报告两个目标路径。

限制与错误处理:源文件不存在报 File not found;配置文件缺失提示 ~/.bitwize-music/config.yaml 不存在,需运行 /configure;专辑未找到提示先用 /new-album {album-name} <genre> 创建;非图片文件(期望 .jpg、.jpeg、.png、.webp)给出警告并询问是否继续。应使用 MCP 解析路径而非手动读取配置,且必须同时复制到两个位置,注意两处文件名不同。

适用场景:为已有专辑补充或替换封面,需同时满足发行与文档目录结构时使用。