cli-anything-musescore 是一个针对乐谱（音乐记谱）处理的命令行工具，它封装了 MuseScore 4 的 mscore 后端，将常见的乐谱操作以子命令的形式暴露出来，适合在脚本、批处理管线或智能体工作流中调用。
一、用途 该工具用于在命令行环境下对乐谱文件执行编辑与转换任务，包括移调、导出、分谱提取、乐器管理与乐谱分析，无需打开图形界面即可完成处理。
二、主要能力
- 项目管理：查询项目信息（project info）与打开项目（project open）。
- 移调：支持三种方式——按目标调号移调（by-key，可选择 closest 方向）、按半音数移调（by-interval，如 --semitones 3）、自然音阶移调（diatonic，如 --steps 2）。
- 声部提取：列出乐谱中的声部（parts list）、提取指定声部（parts extract，按名称匹配，不区分大小写）、批量生成分谱到目录（parts generate）。
- 导出：支持导出为 PDF、MP3（可指定比特率）、PNG（可指定 DPI）、MIDI、MusicXML、盲文（Braille，.brf），以及一次导出多种格式的批量导出（export batch）。
- 乐器管理：列出乐器（instruments list）、添加乐器（instruments add，需指定 id 与名称）、移除乐器（instruments remove）。
- 乐谱分析：media probe（探测乐谱）、media stats（统计信息）、media diff（对比两份乐谱）。
- 会话管理：session status、session undo、session redo、session history。
三、输入格式 支持 .mscz（MuseScore 原生）、.mxl（压缩 MusicXML）、.musicxml / .xml（MusicXML）、.mid / .midi（MIDI）。
四、移调调号名称 大调支持：Cb、Gb、Db、Ab、Eb、Bb、F、C、G、D、A、E、B、F#、C#；小调支持：Ab、Eb、Bb、F、C、G、D、A、E、B、F#、C#、G#、D#、A#。可接受的写法示例："C"、"C major"、"Am"、"A minor"、"Db major"、"F# minor"。
五、使用方式 所有命令均为命令行调用，建议始终加上 --json 参数以获得机器可读输出。移调操作需同时提供 -i（输入）与 -o（输出）。渲染完成后可用 export verify 验证导出结果；对未知乐谱可先用 media probe 探测再执行操作。
六、适用场景 适用于需要对乐谱进行批量移调、批量导出、分谱拆分、格式转换或乐器调整的自动化流程，例如乐谱出版准备、教学素材生成、智能体驱动的音乐处理任务。
七、限制 资料未说明运行所需的具体 MuseScore 版本安装要求、操作系统支持范围、性能上限或错误处理细节；收费与价格信息暂未提供。