mcpField
C
cli-anything-obs-studio

cli-anything-obs-studio

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

关于 cli-anything-obs-studio

面向用户和 Agent 的 OBS Studio 场景集合命令行工具，以 JSON 格式编辑项目。它支持会话历史和结构化输出，编辑场景集合时无需安装 OBS。

主要功能

  1. 01创建和管理项目及场景
  2. 02编辑来源、滤镜和音频
  3. 03配置转场与输出
  4. 04撤销和重做会话更改
  5. 05人类可读与 JSON 输出

适用场景

  1. 01以 JSON 创建或修改场景集合
  2. 02调整来源变换和滤镜参数
  3. 03配置直播或录制输出

安装

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

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

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

详细介绍

cli-anything-obs_studio

一个用于 OBS Studio 场景集合编辑的有状态命令行界面，遵循与 Blender CLI harness 相同的模式。使用 JSON 场景集合格式。编辑无需安装 OBS。

安装

此 CLI 作为 cli-anything-obs_studio 包的一部分安装：

pip install cli-anything-obs_studio

前提条件：

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

用法

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

# Start interactive REPL mode
cli-anything-obs_studio

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

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

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

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

命令组

Project

项目管理命令。

命令描述
new创建新的 OBS 场景集合
open打开现有项目
save保存当前项目
info显示项目信息
json打印原始项目 JSON
Scene 组

场景管理命令。

命令描述
add添加新场景
remove按索引移除场景
duplicate复制场景
set-active设置活动场景
list列出所有场景
Source 组

源管理命令。

命令描述
add向场景添加源
remove按索引移除源
duplicate复制源
set设置源属性（名称、可见性、锁定、不透明度、旋转）
transform变换源（位置、大小、裁剪、旋转）
list列出场景中的所有源
Filter 组

滤镜管理命令。

命令描述
add向源添加滤镜
remove从源移除滤镜
set设置滤镜参数
list列出源上的所有滤镜
list-available列出所有可用滤镜类型
Audio 组

音频管理命令。

命令描述
add添加全局音频源
remove移除全局音频源
volume设置音频源的音量（0.0-3.0）
mute将音频源静音
unmute取消音频源静音
monitor设置音频监听类型
list列出所有音频源
Transition 组

转场管理命令。

命令描述
add添加转场
remove移除转场
set-active设置活动转场
duration以毫秒为单位设置转场时长
list列出所有转场
Output 组

输出/直播/录制配置。

命令描述
streaming配置直播设置
recording配置录制设置
settings配置输出设置
info显示当前输出配置
presets列出可用编码预设
Session

会话管理命令。

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

示例

创建新项目

创建新的 obs_studio 项目文件。

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

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

cli-anything-obs_studio
# Enter commands interactively
# Use 'help' to see available commands
# Use 'undo' and 'redo' for history navigation

状态管理

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

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

输出格式

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

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

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

面向 AI Agent

以编程方式使用此命令行程序时：

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

更多信息

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

版本

1.0.0

评论

支持 Markdown