关于 cli-anything-audacity
cli-anything-audacity 是用于 Audacity 音频项目的有状态命令行工具，面向音频编辑者和 AI Agent。它支持项目、轨道、剪辑与效果管理，并提供交互模式和 JSON 输出。
主要功能
- 01项目与会话管理
- 02轨道、剪辑和效果编辑
- 03选择与标签管理
- 04渲染音频项目
- 05撤销与重做
- 06交互式 REPL 和 JSON 输出
适用场景
- 01通过命令行创建和修改 Audacity 项目
- 02批量调整轨道、剪辑或效果
- 03以 JSON 输出供 Agent 处理
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/cli-anything-audacity确认已加载。
详细介绍
cli-anything-audacity
一个用于音频编辑的有状态命令行界面，遵循本仓库中 GIMP 和 Blender CLI 的相同模式。
安装
此 CLI 作为 cli-anything-audacity 包的一部分安装：
pip install cli-anything-audacity
先决条件：
- Python 3.10+
- 你的系统上必须安装 audacity
用法
基本命令
# Show help
cli-anything-audacity --help
# Start interactive REPL mode
cli-anything-audacity
# Create a new project
cli-anything-audacity project new -o project.json
# Run with JSON output (for agent consumption)
cli-anything-audacity --json project info -p project.json
REPL 模式
当不带子命令调用时，CLI 会进入交互式 REPL 会话：
cli-anything-audacity
# Enter commands interactively with tab-completion and history
命令组
Project
项目管理命令。
| 命令 | 描述 |
|---|---|
new | 创建新项目 |
open | 打开现有项目 |
save | 保存当前项目 |
info | 显示项目信息 |
settings | 查看或更新项目设置 |
json | 打印原始项目 JSON |
Track
轨道管理命令。
| 命令 | 描述 |
|---|---|
add | 添加新轨道 |
remove | 按索引移除轨道 |
list | 列出所有轨道 |
set | 设置轨道属性（名称、静音、独奏、音量、声像） |
Clip
片段管理命令。
| 命令 | 描述 |
|---|---|
import | 探测/导入音频文件（显示元数据） |
add | 向轨道添加音频片段 |
remove | 从轨道移除片段 |
trim | 修剪片段的开头和/或结尾 |
split | 在指定时间位置拆分片段 |
move | 将片段移动到新的开始时间 |
list | 列出轨道上的片段 |
Effect Group
效果管理命令。
| 命令 | 描述 |
|---|---|
list-available | 列出所有可用效果 |
info | 显示效果的详细信息 |
add | 向轨道添加效果 |
remove | 按索引移除效果 |
set | 设置效果参数 |
list | 列出轨道上的效果 |
Selection
选区管理命令。
| 命令 | 描述 |
|---|---|
set | 设置选区范围 |
all | 全选（整个项目时长） |
none | 清除选区 |
info | 显示当前选区 |
Label
标签/标记管理命令。
| 命令 | 描述 |
|---|---|
add | 在指定时间位置添加标签 |
remove | 按索引移除标签 |
list | 列出所有标签 |
Media
媒体文件操作。
| 命令 | 描述 |
|---|---|
probe | 分析音频文件 |
check | 检查所有引用的音频文件是否存在 |
Export Group
导出/渲染命令。
| 命令 | 描述 |
|---|---|
presets | 列出导出预设 |
preset-info | 显示预设详情 |
render | 将项目渲染为音频文件 |
Session Group
会话管理命令。
| 命令 | 描述 |
|---|---|
status | 显示会话状态 |
undo | 撤销上一步操作 |
redo | 重做上次撤销的操作 |
history | 显示撤销历史 |
示例
创建新项目
创建一个新的 audacity 项目文件。
cli-anything-audacity project new -o myproject.json
# Or with JSON output for programmatic use
cli-anything-audacity --json project new -o myproject.json
交互式 REPL 会话
启动一个支持撤销/重做的交互式会话。
cli-anything-audacity
# Enter commands interactively
# Use 'help' to see available commands
# Use 'undo' and 'redo' for history navigation
导出项目
将项目导出为最终输出格式。
cli-anything-audacity --project myproject.json export render output.pdf --overwrite
状态管理
CLI 通过以下方式维护会话状态：
- 撤销/重做：最多 50 级历史记录
- 项目持久化：将项目状态保存/加载为 JSON
- 会话跟踪：跟踪修改和变更
输出格式
所有命令都支持两种输出模式：
- 人类可读（默认）：表格、颜色、格式化文本
- 机器可读（
--json标志）：供 Agent 使用的结构化 JSON
# Human output
cli-anything-audacity project info -p project.json
# JSON output for agents
cli-anything-audacity --json project info -p project.json
供 AI Agent 使用
以编程方式使用此 CLI 时：
- 始终使用
--json标志以获得可解析的输出 - 检查返回码 - 0 表示成功，非零表示错误
- 解析 stderr 以获取失败时的错误消息
- 对所有文件操作使用绝对路径
- 在导出操作后验证输出是否存在
更多信息
- 完整文档：见包内的 README.md
- 测试覆盖率：见包内的 TEST.md
- 方法论：见 cli-anything-plugin 内的 HARNESS.md
版本
1.0.0
评论
支持 Markdown