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

命令行工具和所有 AI 客户端共用 ~/.hs/credentials.json；无需分别登录。

如果这台机器上没有浏览器（例如通过 SSH、云服务或容器使用），请运行 hs auth login --no-browser，在任意设备上打开它显示的地址并完成授权，然后粘贴浏览器跳转到的地址（它以 http://127.0.0.1 开头且无法加载，这是正常现象）。

第 2 步：选择使用方式

两种方式使用相同的 hs 二进制文件和登录信息——任选一种，也可以两种都用。

选项 1：直接使用 hs 命令行工具

如果需要精确执行命令、运行脚本或批处理作业，请选择此方式。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 命令行工具指南。JSON、退出代码和批处理方法，请参阅脚本与自动化。

选项 2：在 AI 客户端中通过 MCP 使用 hs

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）。

以下是四种常见客户端的设置示例。对于其他 MCP 客户端，请在其 MCP 服务设置中输入相同的 command 和 args。

ChatGPT 桌面应用

1. 打开 设置 → MCP 服务 → 添加服务
2. 输入 huasheng 并选择 STDIO
3. 将 Command 设置为 hs 的完整路径；将 mcp 和 serve 添加为两个参数
4. 保存并重启，然后输入 /mcp，检查 huasheng 是否已连接

ChatGPT 桌面版会显示交互式时间线、预览、素材和导出卡片。它与 Codex CLI 共用 ~/.codex/config.toml，因此此设置也会在其中启用 hs。

Claude 桌面应用

1. 下载 huasheng.mcpb
2. 双击，然后在 Claude Desktop 中选择安装
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 桌面版中配置 huasheng，请勿重复添加；二者都会读取 ~/.codex/config.toml。请参阅 OpenAI MCP 文档。

Claude Code CLI

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

这两条命令都在你刚刚登录的同一个终端中运行，因此可以直接使用 hs；如果你的 Shell 找不到它，请替换为 which hs 输出的完整路径（Windows 上使用 where hs）。Codex CLI 和 Claude Code 会显示完整的文本结果，而非桌面端的交互式卡片。

通过对话使用

设置完成后，在 AI 客户端中输入：

给我制作一段 30 秒的视频，讲讲天空为什么是蓝色的

你也可以检查和修改现有项目：

列出我最近的 Huasheng 项目

缩短片段 2 的旁白

将片段 3 替换为更具未来感的素材

将我自己的文件 ./b-roll.mp4 用于片段 2

将旁白声音改得更温暖，并先告诉我价格

确认分镜会消耗点数，发布则会让视频公开。hs 会将这些操作以及其他不可逆工具（删除项目、素材或偏好设置、加入优先队列）标记为破坏性操作，因此会确认破坏性工具的客户端会先询问你；hs 本身不会提示。制作完成后更改声音以及向素材库添加素材也会消耗点数；询问价格时，MCP 工具会报出价格。

更多文档

• hs CLI 指南：逐步介绍创作流程、状态和命令组
• 脚本编写与自动化：JSON、退出代码、批量控制和 ID
• 登录、隐私与要求：凭据、网络边界和平台

安全边界

• CLI 和每个 AI 客户端共用一个本地凭据；hs 永远不会获取你的 Bilibili 密码。
• 确认分镜会消耗点数，发布会让视频公开。制作完成后更改声音和向素材库添加素材也会消耗点数，且这些点数不会退还。hs 会按命令执行操作并报告费用；是否先询问你，由你、脚本或 AI 客户端决定。
• 脚本、旁白录音和素材会上传到 Huasheng 用于制作视频；没有单独的遥测通道或后台更新程序。唯一的其他连接是每天检查一次 GitHub 上的最新版本号；该检查只会发送 hs 版本信息，并且可以关闭。

升级

hs upgrade

对于安装程序构建版本，此命令会下载最新版本、校验其 SHA256，并将其替换为新版本；对于 npm 安装，则会运行 npm i -g @superlcr/hs@latest。hs 不会自行下载或替换自身。它每天会查询一次最新版本号，如果你的版本较旧，就会提醒你；设置 HS_NO_UPDATE_CHECK=1 可关闭此功能。

运行 hs mcp serve 的 AI 客户端会继续使用旧进程，直到重启。升级后，请在 Claude Code 或 Codex 中开启新会话，或退出并重新打开 Claude Desktop；在此之前，客户端仍在使用旧版本。所有平台上，在客户端运行期间升级都是安全的。

反馈

发现问题？请提交一个 issue，并附上 hs --version 的输出——其中包含提交版本和构建时间，这是诊断任何问题的关键信息。