vidmuse

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
   エージェントのシェルで長時間実行されるコマンドを表示し続けられない場合	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 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

HYPERFRAMES_BIN が指定されていない場合、render コマンドは npx --yes [email protected] を使用します。この方法で初めてレンダリングする際は、npm のネットワークアクセスが必要です。標準以外の実行ファイルパスには、NODE_BIN、FFMPEG_BIN、HYPERFRAMES_BIN を使用してください。

出力仕様

デフォルトの出力モードは text です。構造化された解析が必要な場合に限り、--output json を追加してください。vidmuse render には追加しないでください。このコマンドの -o／--output フラグは、レンダリングした動画ファイルのパスを指定します。

簡潔な自然言語の回答には text を使用してください。ネストしたリストとマップは、インデントされたブロックとして出力されます。

人間向けの短い要約に限り table を使用してください。トップレベルの構造体、マップ、リスト、およびマップのリストは可能な場合にテーブルとして出力され、ネストしたリストとマップはテーブルセル内で簡潔に表示されます。

ページ分割された 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. 終了コードが 0 以外の場合、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、設定ファイル全体を決して出力しないでください。最終回答はトランスクリプトに保存されたり、スクリーンショットで共有されたり、バグ報告にコピーされたりする可能性があります。