cli-anything-kdenlive

cli-anything-kdenlive 是一个面向 Kdenlive 的有状态命令行界面，用于视频编辑，其设计遵循与 Blender CLI harness 相同的模式。它使用 JSON 项目格式，并生成供 Kdenlive/melt 使用的 MLT XML。

用途该工具旨在通过命令行完成视频编辑项目的创建、管理与导出，适合需要以脚本或程序化方式操作 Kdenlive 项目的场景，也便于 AI 智能体调用。

安装与前置条件该 CLI 作为 cli-anything-kdenlive 包的一部分安装：

pip install cli-anything-kdenlive

前置条件：

Python 3.10+
系统必须已安装 kdenlive

使用方式基本命令：

显示帮助

cli-anything-kdenlive --help

启动交互式 REPL 模式

cli-anything-kdenlive

创建新项目

cli-anything-kdenlive project new -o project.json

以 JSON 输出运行（供智能体使用）

cli-anything-kdenlive --json project info -p project.json

REPL 模式：不带子命令调用时，CLI 进入交互式 REPL 会话，支持 Tab 补全和历史记录。

命令组 Project（项目）：new 创建新项目；open 打开已有项目；save 保存当前项目；info 显示项目信息；profiles 列出可用视频配置文件；json 打印原始项目 JSON。

Bin Group（媒体素材箱）：import 导入剪辑到媒体素材箱；remove 从素材箱移除剪辑；list 列出素材箱中所有剪辑；get 获取剪辑详细信息。

Timeline（时间线）：add-track 添加轨道；remove-track 移除轨道；add-clip 向轨道添加剪辑；remove-clip 从轨道移除剪辑；trim 修剪剪辑的入点/出点；split 在时间偏移处分割剪辑；move 将剪辑移动到新位置；list 列出所有轨道。

Filter Group（滤镜/效果）：add 为剪辑添加滤镜；remove 从剪辑移除滤镜；set 设置滤镜参数；list 列出剪辑上的滤镜；available 列出所有可用滤镜。

Transition（转场）：add 在轨道之间添加转场；remove 移除转场；set 设置转场参数；list 列出所有转场。

Guide（参考线/标记）：add 在指定位置（秒）添加参考线；remove 移除参考线；list 列出所有参考线。

Export（导出与渲染）：xml 生成 Kdenlive/MLT XML；presets 列出可用渲染预设。

Session（会话）：status 显示会话状态；undo 撤销上一步操作；redo 重做已撤销的操作；history 显示撤销历史。

示例创建新项目： cli-anything-kdenlive project new -o myproject.json

或以 JSON 输出供程序化使用

cli-anything-kdenlive --json project new -o myproject.json

交互式 REPL 会话（支持撤销/重做）： cli-anything-kdenlive

交互式输入命令

使用 'help' 查看可用命令

使用 'undo' 和 'redo' 进行历史导航

导出项目： cli-anything-kdenlive --project myproject.json export render output.pdf --overwrite

状态管理 CLI 维护会话状态，包括：撤销/重做（最多 50 级历史）；项目持久化（以 JSON 保存/加载项目状态）；会话跟踪（跟踪修改与变更）。

输出格式所有命令支持双输出模式：人类可读（默认，表格、颜色、格式化文本）和机器可读（--json 标志，结构化 JSON 供智能体使用）。

人类可读输出

cli-anything-kdenlive project info -p project.json

供智能体使用的 JSON 输出