mcpField
V
vidmuse

vidmuse

github.com/sandai-org创意与媒体13687 次安装12 周前更新
代码仓库

关于 vidmuse

vidmuse Skill 指导 Agent 通过 vidmuse 命令行访问 VidMuse 的账户、模型、媒体资源及会话记忆功能，并说明认证、输出和本地渲染要求。

主要功能

  1. 01查询账户、订阅与模型
  2. 02管理素材、风格和语音库
  3. 03操作线程、消息与长期记忆
  4. 04执行预览与视频渲染
  5. 05处理认证、输出及错误

适用场景

  1. 01查看 VidMuse 账户和订阅状态
  2. 02发现模型并管理素材或音色
  3. 03处理线程消息及记忆操作
  4. 04在满足依赖时预览或渲染媒体

安装

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

$npx skills add https://github.com/sandai-org/vidmuse-skills --skill vidmuse

安装后在 Claude Code 中输入/vidmuse确认已加载。

附带文件references/command-map.md

详细介绍

VidMuse 技能

当任务涉及 VidMuse 账户状态、订阅计划、模型发现、资产、风格库条目、语音库条目、生成参数、线程/消息操作或长期记忆操作时，使用此技能。将 vidmuse 命令视为访问 VidMuse 功能的运行时；除非用户询问命令本身，否则面向用户的回答应聚焦于 VidMuse 任务。

工作流

  1. 确保 vidmuse 命令运行时已存在。

    macOS、Linux、WSL 或 Git Bash：

    if vidmuse_path="$(command -v vidmuse)"; then
  :
else
  tmp="$(mktemp)"
  curl -fsSL "https://vidmuse.sandcdn.com/cli/install.sh" -o "$tmp"
  installed_path="$(VIDMUSE_CLI_VERSION="${VIDMUSE_CLI_VERSION:-latest}" bash "$tmp" | tail -n 1)"
  installed_dir="$(dirname "$installed_path")"
  case ":${PATH:-}:" in *":${installed_dir}:"*) ;; *) export PATH="${installed_dir}:${PATH:-}" ;; esac
fi
vidmuse --version

    Windows PowerShell：

    if (-not (Get-Command vidmuse -ErrorAction SilentlyContinue)) {
    $tmp = Join-Path $env:TEMP "install-vidmuse.ps1"
    Invoke-WebRequest "https://vidmuse.sandcdn.com/cli/install.ps1" -OutFile $tmp -UseBasicParsing
    $installedPath = (& powershell -ExecutionPolicy Bypass -File $tmp | Select-Object -Last 1)
    $installedDir = Split-Path -Parent $installedPath
    if (($env:PATH -split [System.IO.Path]::PathSeparator) -notcontains $installedDir) {
        $env:PATH = "$installedDir$([System.IO.Path]::PathSeparator)$env:PATH"
    }
}
vidmuse --version

  2. 在需要时进行身份验证。

    首先检查当前会话是否已通过身份验证：

    vidmuse profile get --output json

    如果命令返回身份验证错误，请先征求用户同意，再启动任何登录流程，因为浏览器登录和设备登录都需要用户操作。

    使用以下决策树：

    环境命令
    可访问浏览器的本地桌面环境vidmuse login
    无头环境或支持流式输出的远程终端vidmuse login --device
    Agent shell 无法让长时间运行的命令保持可见vidmuse login --device --start，向用户显示 URL/代码，然后在用户确认授权后运行 vidmuse login --device --complete

  3. 关于命令路由，请阅读 references/command-map.md。

本地媒体运行时

已发布的 CLI 二进制文件不需要 Go。账户、模型、资产、风格、语音、线程、消息和记忆命令只需要 vidmuse 二进制文件和网络连接。使用本地预览或渲染命令前，请检查所需的额外工具：

node --version
ffmpeg -version
命令所需运行时
vidmuse serve仅在请求视频缩略图时需要 FFmpeg
vidmuse renderNode.js 22+ 和 FFmpeg

如果缺少 Node.js 或 FFmpeg，未经用户批准，不要安装系统软件包。告知用户缺少哪项前置条件，并提供相应命令：

# macOS (Homebrew)
brew install node ffmpeg

# Debian or Ubuntu
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs ffmpeg

如果未提供 HYPERFRAMES_BIN，渲染命令会使用 npx --yes [email protected]。首次执行此类渲染需要 npm 网络访问。对于非标准可执行文件路径，请使用 NODE_BIN、FFMPEG_BIN 和 HYPERFRAMES_BIN。

输出约定

默认输出模式为 text。只有在需要结构化解析时才添加 --output json。不要将其用于 vidmuse render：该命令的 -o/--output 标志用于指定渲染后的视频文件路径。

使用 text 输出简洁易懂的纯文本回复。嵌套列表和映射会以缩进块的形式呈现。

仅在需要面向用户的简短摘要时使用 table，因为顶层结构体、映射、列表和映射列表会尽可能以表格形式呈现，而嵌套列表和映射会以紧凑形式保留在表格单元格中。

分页的文本/表格输出会使用类似以下的人类可读摘要：

Showing 1-20 of 88

如果 API 返回 limit、offset、total 和 data 等字段，JSON 输出会保留这些结构化字段。

数据流：

数据流含义
stdout所选输出模式下的命令结果
stderr错误、详细 HTTP 日志、安装日志

退出代码：

代码含义
0成功
1一般错误
2用法或验证错误
3身份验证错误：缺少、已过期或无效的身份验证信息
4网络或 API 错误

错误处理：

  1. 首先检查退出代码。
  2. 如果退出代码为 0，仅在请求了 json 模式时解析 stdout。
  3. 如果退出代码非零，请根据 stderr 提供简洁的错误说明。
  4. 对于退出代码 3，请用户运行 vidmuse login 或 vidmuse login --device。
  5. 对于退出代码 4，说明发生了网络或 API 故障；仅当操作为只读或明确可以安全重复时才重试。

安全

用户询问信息时，可以直接运行只读命令。thread create、message send、memory create、memory update、memory append、memory push 和 memory pop 等修改命令，需要用户明确表达意图。

切勿在最终答复中打印身份验证令牌、Cookie 或完整配置文件，因为最终答复可能会保存到对话记录中、作为屏幕截图分享，或复制到错误报告中。

评论

支持 Markdown