Branch Video Agent CLI

@mindscraft/branch-video-agent-cli 是一个可脱离当前代码仓库使用的发布版 CLI，用于通过 Bearer agent token 调用 branch-video 与 AIHub agent API。

安装与执行

推荐显式指定包和可执行名：

npm exec --yes --package=@mindscraft/branch-video-agent-cli branch-video-agent -- --help

中国大陆用户如果希望更稳定、更快地安装，可以走 npm 的公开镜像：

npm exec --yes --registry=https://registry.npmmirror.com --package=@mindscraft/branch-video-agent-cli branch-video-agent -- --help

如果你更喜欢简写，从 0.1.2 开始也支持：

npx -y @mindscraft/branch-video-agent-cli --help

也可以全局安装：

npm install -g @mindscraft/branch-video-agent-cli
branch-video-agent --help

环境变量：

• AIHUB_AGENT_TOKEN
• BRANCH_VIDEO_AGENT_BASE_URL

最小调用示例：

@'
{
  "filter": "mine",
  "page": 1,
  "limit": 20
}
'@ | npm exec --yes --package=@mindscraft/branch-video-agent-cli branch-video-agent -- project list

AIHub 导入公共库示例：

@'
{
  "global_context_str": "{\"project_title\":\"AIHub 导入项目\"}",
  "script_body_str": "{\"project_title\":\"AIHub 导入项目\"}",
  "result_script_str": "[]",
  "workflow_run_id": "00000000-0000-4000-8000-000000000000"
}
'@ | npm exec --yes --package=@mindscraft/branch-video-agent-cli branch-video-agent -- project import-aihub

该命令与其他 project / version / production 命令一样，统一使用 AIHUB_AGENT_TOKEN Bearer 鉴权；服务端会兼容旧的 X-AIHub-Import-Token 头，但 CLI 不再单独管理第二套 token。

托管互动方案提交示例：

@'
{
  "id": "judge-base",
  "name": "判断题-增强版",
  "defaultThemeId": "cat",
  "urlsByTheme": {
    "cat": "https://aic-view.sdp.101.com/view/judge-base-v2"
  },
  "configTemplate": {
    "waitForPageReady": true
  }
}
'@ | npm exec --yes --package=@mindscraft/branch-video-agent-cli branch-video-agent -- preset upsert

在仓库内构建发布包

从仓库根目录执行：

npm run agent:cli:package:build
npm run agent:cli:package:smoke

产物输出到：

packages/branch-video-agent-cli/dist/

发布步骤

从仓库根目录先完成构建与 smoke check，然后进入子包目录执行发布：

npm run agent:cli:package:build
npm run agent:cli:package:smoke
Set-Location packages/branch-video-agent-cli
npm login --registry=https://registry.npmjs.org/
npm pack
npm publish

当前子包已经固定为发布到 https://registry.npmjs.org/，不会沿用仓库根目录的内网 .npmrc。

发布前请先确认两件事：

1. 你在 npmjs 上拥有当前包名对应的 scope 权限；如果没有 @nd scope，需要先改包名，例如改成你实际拥有的 scope，或改成非 scope 包名。
2. 如果要让中国大陆用户安装体验更稳定，建议仍以 npmjs 作为唯一发布源，再让用户通过 npmmirror 安装；不要把 GitHub Packages 当作主发布仓库，因为安装门槛和网络可达性都更差。