bilibili-huasheng-video

hs は Huasheng の動画制作パイプラインをコマンドラインで利用できるようにします。 ひとこと、またはスクリプトを入力するだけで、ストーリーボードの作成、ナレーション、映像素材の選定、構成を行い、エクスポートや直接公開ができる動画を生成します。途中のどの段階でも、作業に介入して調整できます。

単体で動作するバイナリです。 Node も Python も、インストールが必要なランタイムもありません。 すべてのコマンドが --json に対応しており、スクリプトや AI クライアントでの利用を想定しています。

ステップ 1：インストールしてサインインする

後でどのクライアントを使う場合でも、最初に一度だけ実行してください。

インストール

お好みの方法を選んでください。どの方法でも同じバイナリがインストールされます。

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/superlcr/huasheng-cli/main/install.sh | sh

Windows の場合は、PowerShell で次を実行します。

irm https://raw.githubusercontent.com/superlcr/huasheng-cli/main/install.ps1 | iex

どちらのインストーラーも、お使いのプラットフォーム用のパッケージをダウンロードして SHA256 を検証し、~/.local/bin（Windows の場合は %LOCALAPPDATA%\Programs\hs）に展開します。

npm を使う場合：すでに Node のエコシステムを利用している場合や、まず試してみたい場合に便利です。

npx @superlcr/hs --help
npm install -g @superlcr/hs    # the command is still `hs`

npm パッケージは小型のランチャーです。お使いのプラットフォーム用バイナリはオプションの依存関係としてインストールされるため、インストール時にダウンロードやコンパイルは行われません。

shasum -a 256 -c SHA256SUMS

サインイン

新しいターミナルを開いてサインインし、hs でクレジット残高を確認できることを確認します。

hs auth login
hs account

CLI とすべての AI クライアントは ~/.hs/credentials.json を共有するため、個別にサインインする必要はありません。

そのマシンにブラウザーがない場合（SSH、クラウドサーバー、コンテナなど）は、hs auth login --no-browser を実行してください。表示されたアドレスを任意のデバイスで開いて認証し、ブラウザーが遷移した先のアドレスをコピーして貼り付けます（http://127.0.0.1 で始まり、ページは読み込まれませんが、これで正常です）。

ステップ 2：使い方を選ぶ

どちらの方法でも同じ hs バイナリとサインイン情報を使います。いずれか一方でも、両方でも利用できます。

オプション 1：hs CLI を直接使う

正確なコマンドを使いたい場合、スクリプトやバッチジョブを実行する場合は、この方法を使います。hs make は、ひとことまたは完成したスクリプトから作成ワークフローを実行し、動画が完成するまで待機して、ダウンロードできます。

ひとことから動画を作成します：

hs make --script "Three little-known facts about West Lake" --out ./out.mp4

MG スタイルの動画を作成します：

hs make --script "Explain Song dynasty tea whisking in 30 seconds" --mode mg --out ./tea.mp4

長いスクリプトをファイルから読み込みます：

hs make --script @script.txt --out ./video.mp4

または、自分で録音したナレーションから始めます。パソコン上のファイル、または公開 URL を指定できます：

hs make --audio ./narration.m4a --out ./video.mp4
hs make --audio ./narration.m4a --transcript @words.txt --out ./video.mp4   # if you have the words

Huasheng は音声をそのまま使い、音声に合わせて映像素材を編集します。文字起こしテキストは任意です。指定しない場合、Huasheng が録音を文字起こしします。対応形式は mp3、wav、flac、mp4、m4a です。hs がファイル自体をアップロードするため、内部ストレージのアドレスを用意する必要はありません。

hs make はストーリーボードを自動で承認します。クレジットが消費され、使用数も表示されます。先にストーリーボードと料金を確認するには、ステップごとのコマンドを使ってください。パラメーター、ステップごとの編集、再開、エクスポートについては、hs CLI ガイドをご覧ください。JSON、終了コード、バッチ処理については、スクリプトと自動化をご覧ください。

オプション 2：AI クライアントで hs を MCP 経由で使う

hs には MCP サーバーが含まれています。ローカル STDIO MCP に対応している AI クライアントであれば、次の設定で起動できます。

{
  "mcpServers": {
    "huasheng": {
      "command": "hs",
      "args": ["mcp", "serve"]
    }
  }
}

この設定では、Huasheng が必要になったときにクライアントが hs mcp serve を実行するよう指示するだけです。別途インストールする hs MCP パッケージはなく、コマンドを自分で起動したままにする必要もありません。クライアントが hs を見つけられない場合は、command を which hs で確認できるフルパス（Windows では where hs）に置き換えてください。

以下に、一般的な 4 つのクライアントの設定例を示します。他の MCP クライアントでは、MCP サーバーの設定に同じ command と args を入力してください。

ChatGPT Desktop App

1. Settings → MCP servers → Add server を開きます
2. huasheng と入力し、STDIO を選択します
3. Command に hs のフルパスを設定し、2 つの引数として mcp と serve を追加します
4. 保存して再起動し、/mcp と入力して huasheng が接続されていることを確認します

ChatGPT Desktop は、インタラクティブなタイムライン、プレビュー、映像素材、書き出しカードを表示します。Codex CLI と ~/.codex/config.toml を共有するため、この設定によりそちらでも hs が使えるようになります。

Claude Desktop App

1. huasheng.mcpb をダウンロードします
2. ダブルクリックし、Claude Desktop で Install を選択します
3. hs のパスを確認します。デフォルトは ~/.local/bin/hs です

インストール先を変更した場合は、which hs で確認できるフルパス（Windows では where hs）を貼り付けてください。初回インストール時に拡張機能が未署名であるという警告が表示された場合は、そのまま続行します。Claude Desktop でもインタラクティブカードが表示されます。

Codex CLI

codex mcp add huasheng -- hs mcp serve
codex mcp list

ChatGPT Desktop ですでに huasheng を設定している場合は、再度追加する必要はありません。どちらも ~/.codex/config.toml を読み込みます。OpenAI MCP のドキュメントを参照してください。

Claude Code CLI

claude mcp add --scope user huasheng -- hs mcp serve
claude mcp list

どちらのコマンドも、サインインしたときと同じターミナルで実行するため、通常は hs で見つかります。シェルが見つけられない場合は、which hs で確認できるフルパス（Windows では where hs）に置き換えてください。Codex CLI と Claude Code では、デスクトップのインタラクティブカードではなく、完全なテキスト結果が表示されます。

会話で使う

設定後、AI クライアントで次のように指示します。

空が青い理由について、30 秒の動画を作ってください

既存のプロジェクトを確認したり、調整したりすることもできます。

最近の Huasheng プロジェクトを一覧表示してください

クリップ 2 のナレーションを短くしてください

クリップ 3 を、もっと未来的な映像素材に置き換えてください

クリップ 2 に自分のファイル ./b-roll.mp4 を使ってください

ナレーターをもっと温かみのある声に変更し、まず料金を教えてください

ストーリーボードを承認するとクレジットが消費され、公開すると動画が公開状態になります。hs はこれらの操作や、その他の取り消せないツール（プロジェクト、映像素材、設定の削除、優先レーンへの参加）を破壊的操作としてマークするため、破壊的操作の確認を行うクライアントでは、実行前に確認を求められます。hs 自体は確認を求めません。制作後の音声変更やライブラリへの映像素材の追加にもクレジットが消費されます。MCP ツールに料金を尋ねると、料金が提示されます。

ドキュメントをさらに見る

• hs CLI ガイド：動画作成の手順、状態、コマンドグループ
• スクリプトと自動化：JSON、終了コード、一括制御、ID
• サインイン、プライバシー、要件：認証情報、ネットワーク境界、プラットフォーム

安全性に関する境界

• CLI とすべての AI クライアントは、1 つのローカル認証情報を共有します。hs が Bilibili のパスワードを受け取ることはありません。
• ストーリーボードを承認するとクレジットが消費され、公開すると一般公開されます。制作後の音声変更やライブラリへの映像素材の追加も同様で、消費したクレジットは返金されません。hs はコマンドの指示どおりに動作し、料金を報告します。事前に確認を求めるかどうかは、ユーザー、スクリプト、または AI クライアントによって決まります。
• スクリプト、ナレーションの録音、映像素材は動画作成のために Huasheng にアップロードされます。別個のテレメトリーチャネルやバックグラウンドアップデーターはありません。これ以外の接続は、GitHub で最新リリース番号を 1 日 1 回確認することだけです。この確認で送信されるのは hs のバージョンのみで、無効にすることもできます。

アップグレード

hs upgrade

インストーラー版の場合は、最新リリースをダウンロードして SHA256 を確認し、差し替えます。npm からインストールした場合は、npm i -g @superlcr/hs@latest を実行します。hs が自動でダウンロードや置き換えを行うことはありません。1 日に 1 回、最新リリース番号を確認し、お使いのバージョンが古い場合に通知します。確認を無効にするには、HS_NO_UPDATE_CHECK=1 を設定してください。

hs mcp serve を実行している AI クライアントは、再起動するまで古いプロセスを使い続けます。アップグレード後、Claude Code または Codex で新しいセッションを開始するか、Claude Desktop を終了して再度開いてください。それまでは、クライアントは古いバージョンのままです。クライアントの実行中にアップグレードしても、どのプラットフォームでも安全です。

フィードバック

問題を見つけた場合は、 issue を作成し、hs --version の出力を含めてください。出力にはコミットとビルド時刻が含まれており、問題の診断に不可欠です。