用途:为 Audacity 提供有状态的命令行音频编辑界面,便于脚本化或由 AI 智能体调用,模式与同仓库的 GIMP、Blender CLI 一致。
安装与前提:pip install cli-anything-audacity;需要 Python 3.10+,且系统必须已安装 audacity。
主要能力:命令按组划分。Project 组支持 new、open、save、info、settings、json;Track 组支持 add、remove、list、set(name、mute、solo、volume、pan);Clip 组支持 import、add、remove、trim、split、move、list;Effect 组支持 list-available、info、add、remove、set、list;Selection 组支持 set、all、none、info;Label 组支持 add、remove、list;Media 组支持 probe、check;Export 组支持 presets、preset-info、render;Session 组支持 status、undo、redo、history。
使用方式:cli-anything-audacity --help 查看帮助;不带子命令时进入交互式 REPL,支持 Tab 补全与历史。示例:cli-anything-audacity project new -o project.json 新建项目;cli-anything-audacity --json project info -p project.json 以 JSON 输出项目信息;cli-anything-audacity --project myproject.json export render output.pdf --overwrite 导出。所有命令支持人类可读(默认,表格与颜色)和机器可读(--json)两种输出。
状态管理:维护会话状态,支持最多 50 级撤销/重做,项目状态以 JSON 保存与加载,并跟踪修改。
面向智能体的建议:始终使用 --json 获取可解析输出;检查返回码(0 成功,非 0 错误);失败时解析 stderr;文件操作使用绝对路径;导出后验证输出文件存在。
限制:资料未提供具体效果列表、导出格式支持范围、收费与价格信息,也未提供平台兼容性细节;实际可用效果与导出预设取决于本机 Audacity 安装。版本为 1.0.0。