mcpField
C
cli-anything-kdenlive

cli-anything-kdenlive

github.com/hkuds创意与媒体57.6k546 次安装5 周前更新
代码仓库

关于 cli-anything-kdenlive

cli-anything-kdenlive 是用于视频编辑的有状态命令行工具，以 JSON 保存项目并生成 Kdenlive/MLT XML。它提供媒体箱、时间线、滤镜、转场及撤销重做等管理功能。

主要功能

  1. 01创建并管理 JSON 项目
  2. 02导入和管理媒体素材
  3. 03编辑时间线轨道与片段
  4. 04配置滤镜、转场和标记
  5. 05生成 Kdenlive/MLT XML
  6. 06支持会话撤销与重做

适用场景

  1. 01通过命令行建立视频项目
  2. 02排列、移动或裁剪时间线片段
  3. 03为片段添加滤镜或轨道转场
  4. 04生成项目 XML 并管理编辑历史

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/hkuds/cli-anything --skill cli-anything-kdenlive

安装后在 Claude Code 中输入/cli-anything-kdenlive确认已加载。

详细介绍

cli-anything-kdenlive

一个用于视频编辑的有状态命令行界面，遵循与 Blender CLI 框架相同的模式。使用 JSON 项目格式，并生成 MLT XML 以适配 Kdenlive/melt。

安装

此 CLI 作为 cli-anything-kdenlive 包的一部分进行安装：

pip install cli-anything-kdenlive

前提条件：

  • Python 3.10+
  • 系统上必须安装 kdenlive

用法

基本命令
# Show help
cli-anything-kdenlive --help

# Start interactive REPL mode
cli-anything-kdenlive

# Create a new project
cli-anything-kdenlive project new -o project.json

# Run with JSON output (for agent consumption)
cli-anything-kdenlive --json project info -p project.json
REPL 模式

在不带子命令调用时，CLI 会进入交互式 REPL 会话：

cli-anything-kdenlive
# Enter commands interactively with tab-completion and history

命令组

项目

项目管理命令。

命令描述
new创建新项目
open打开现有项目
save保存当前项目
info显示项目信息
profiles列出可用的视频配置文件
json打印原始项目 JSON
素材箱组

媒体素材箱管理命令。

命令描述
import将片段导入媒体素材箱
remove从素材箱中移除片段
list列出素材箱中的所有片段
get获取片段的详细信息
时间线

时间线管理命令。

命令描述
add-track向时间线添加轨道
remove-track移除轨道
add-clip向轨道添加片段
remove-clip从轨道中移除片段
trim修剪片段的入点/出点
split在时间偏移处拆分片段
move将片段移动到新位置
list列出所有轨道
滤镜组

滤镜/效果管理命令。

命令描述
add向片段添加滤镜
remove从片段中移除滤镜
set设置滤镜参数
list列出片段上的滤镜
available列出所有可用滤镜
转场

转场管理命令。

命令描述
add在轨道之间添加转场
remove移除转场
set设置转场参数
list列出所有转场
参考线

参考线/标记管理命令。

命令描述
add在某个位置（秒）添加参考线
remove移除参考线
list列出所有参考线
导出

导出和渲染命令。

命令描述
xml生成 Kdenlive/MLT XML
presets列出可用的渲染预设
会话

会话管理命令。

命令描述
status显示会话状态
undo撤销上一次操作
redo重做上一次撤销的操作
history显示撤销历史

示例

创建新项目

创建一个新的 kdenlive 项目文件。

cli-anything-kdenlive project new -o myproject.json
# Or with JSON output for programmatic use
cli-anything-kdenlive --json project new -o myproject.json
交互式 REPL 会话

启动一个支持撤销/重做的交互式会话。

cli-anything-kdenlive
# Enter commands interactively
# Use 'help' to see available commands
# Use 'undo' and 'redo' for history navigation
导出项目

将项目导出为最终输出格式。

cli-anything-kdenlive --project myproject.json export render output.pdf --overwrite

状态管理

CLI 通过以下方式维护会话状态：

  • 撤销/重做：最多 50 级历史记录
  • 项目持久化：将项目状态保存/加载为 JSON
  • 会话跟踪：跟踪修改和变更

输出格式

所有命令都支持两种输出模式：

  • 人类可读（默认）：表格、颜色、格式化文本
  • 机器可读（--json 标志）：供 Agent 使用的结构化 JSON
# Human output
cli-anything-kdenlive project info -p project.json

# JSON output for agents
cli-anything-kdenlive --json project info -p project.json

适用于 AI Agent

以编程方式使用此 CLI 时：

  1. 始终使用 --json 标志以获得可解析的输出
  2. 检查返回码 - 0 表示成功，非零表示错误
  3. 解析 stderr 以获取失败时的错误消息
  4. 对所有文件操作使用绝对路径
  5. 在导出操作后验证输出是否存在

更多信息

  • 完整文档：请参阅包中的 README.md
  • 测试覆盖率：请参阅包中的 TEST.md
  • 方法论：请参阅 cli-anything-plugin 中的 HARNESS.md

版本

1.0.0

评论

支持 Markdown