vidmuse

用途

VidMuse Skill 用于让 AI 智能体在任务中操作 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`
智能体 shell 无法保持长时间可见命令	`vidmuse login --device --start`，向用户展示 URL/代码，用户确认授权后运行 `vidmuse login --device --complete`

命令路由请阅读 references/command-map.md。

3. 本地媒体运行时

已发布的 CLI 二进制不需要 Go。账户、模型、素材、风格、语音、线程、消息与记忆命令只需要 vidmuse 二进制与网络访问。在使用本地预览或渲染命令前检查额外工具：

node --version
ffmpeg -version

命令	所需运行时
`vidmuse serve`	仅在请求视频缩略图时需要 FFmpeg
`vidmuse render`	Node.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

render 命令在未提供 HYPERFRAMES_BIN 时使用 npx --yes hyperframes@0.7.26。首次此类渲染需要 npm 网络访问。非标准可执行文件路径可使用 NODE_BIN、FFMPEG_BIN 与 HYPERFRAMES_BIN。

输出约定

默认输出模式为文本。仅在需要结构化解析时添加 --output json。不要将其添加到 vidmuse render：其 -o/--output 标志指定渲染后的视频文件路径。

文本：用于紧凑的纯语言响应。嵌套列表与映射渲染为缩进块。
表格：仅用于简短的人类可读摘要，因为顶层结构体、映射、列表与映射列表在可能时渲染为表格，而嵌套列表与映射在表格单元格内保持紧凑。

分页文本/表格输出使用人类可读摘要，例如：

Showing 1-20 of 88

JSON 输出在 API 返回时保留 limit、offset、total 与 data 等结构化字段。

流：

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

退出码：

码	含义
0	成功
1	一般错误
2	用法或校验错误
3	认证错误：缺失、过期或无效认证
4	网络或 API 错误

错误处理：

先检查退出码。
如果退出码为 0，仅在请求了 json 模式时解析 stdout。
如果退出码非零，基于 stderr 显示简洁错误。
对于退出码 3，请用户运行 vidmuse login 或 vidmuse login --device。
对于退出码 4，说明网络或 API 失败，仅在操作是只读或明确可安全重复时重试。

安全

只读命令可在用户请求信息时直接运行。
变更类命令（如 thread create、message send、memory create、memory update、memory append、memory push、memory pop）需要用户明确意图。
绝不在最终回答中打印认证令牌、Cookie 或完整配置文件，因为最终回答可能被保存到记录、作为截图分享或复制到错误报告中。

适用场景

适用于需要让 AI 智能体访问 VidMuse 账户、模型、素材、风格库、语音库、生成参数、线程/消息与长期记忆的任务。

限制

本地预览与渲染需要额外运行时（FFmpeg、Node.js 22+），缺失时需用户批准才能安装。
首次使用 hyperframes 渲染需要 npm 网络访问。
登录流程需要用户操作，不能自动完成。
变更类命令需用户明确意图。
关于具体收费、价格、平台支持范围等细节，资料暂未提供。