@mindscraft/branch-video-agent-cli 0.1.1 → 0.2.0

package/README.md

@@ -4,16 +4,22 @@
 
 ## 安装与执行
 
-推荐直接使用 `npx`：
+推荐显式指定包和可执行名：
 
 ```powershell
-npx -y @mindscraft/branch-video-agent-cli --help
+npm exec --yes --package=@mindscraft/branch-video-agent-cli branch-video-agent -- --help
 ```
 
 中国大陆用户如果希望更稳定、更快地安装，可以走 npm 的公开镜像：
 
 ```powershell
-npx -y --registry=https://registry.npmmirror.com @mindscraft/branch-video-agent-cli --help
+npm exec --yes --registry=https://registry.npmmirror.com --package=@mindscraft/branch-video-agent-cli branch-video-agent -- --help
+```
+
+如果你更喜欢简写，从 `0.1.2` 开始也支持：
+
+```powershell
+npx -y @mindscraft/branch-video-agent-cli --help
 ```
 
 也可以全局安装：
@@ -37,7 +43,25 @@ branch-video-agent --help
   "page": 1,
   "limit": 20
 }
-'@ | npx -y @mindscraft/branch-video-agent-cli project list
+'@ | npm exec --yes --package=@mindscraft/branch-video-agent-cli branch-video-agent -- project list
+```
+
+托管互动方案提交示例：
+
+```powershell
+@'
+{
+  "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
 ```
 
 ## 在仓库内构建发布包

package/dist/commands/preset.d.ts

@@ -0,0 +1,2 @@
+import type { CommandHandler } from '../lib/types.js';
+export declare const presetCommands: Record<string, CommandHandler>;

package/dist/commands/preset.js

@@ -0,0 +1,22 @@
+import { CliCommandError } from '../lib/errors.js';
+import { getOptionalString } from '../lib/payload.js';
+export const presetCommands = {
+    list: async ({ client, payload }) => {
+        const presetId = getOptionalString(payload, 'presetId');
+        const result = await client.request('/api/branch-video/web-node-presets', {
+            method: 'GET',
+            query: presetId ? { presetId } : undefined,
+        });
+        return { data: result.data, requestId: result.requestId };
+    },
+    upsert: async ({ client, payload }) => {
+        if (Object.keys(payload).length === 0) {
+            throw new CliCommandError('Missing preset payload', 'VALIDATION_ERROR');
+        }
+        const result = await client.request('/api/branch-video/web-node-presets', {
+            method: 'POST',
+            body: payload,
+        });
+        return { data: result.data, requestId: result.requestId };
+    },
+};

package/dist/index.js

@@ -1,3 +1,4 @@
+import { presetCommands } from './commands/preset.js';
 import { productionCommands } from './commands/production.js';
 import { projectCommands } from './commands/project.js';
 import { versionCommands } from './commands/version.js';
@@ -8,6 +9,7 @@ import { CliHttpClient } from './lib/http.js';
 import { ensureObject } from './lib/payload.js';
 import { createProcessRuntime } from './lib/runtime.js';
 const commandRegistry = {
+    preset: presetCommands,
     workflow: workflowCommands,
     project: projectCommands,
     version: versionCommands,

package/dist/lib/flags.js

@@ -88,9 +88,10 @@ export function parseCliArgs(argv) {
 }
 export function getCliHelpText() {
     return [
-        'Usage: branch-video-agent <group> <action> [--wait] [--raw] [--timeout <ms>] [--base-url <url>] [--token <token>] [--token-file <path>]',
+        'Usage: branch-video-agent <group> <action> [--wait] [--raw] [--timeout <ms>] [--poll-interval <ms>] [--base-url <url>] [--token <token>] [--token-file <path>]',
         '',
         'Groups:',
+        '  preset     list | upsert',
         '  workflow   run | status | outputs',
         '  project    list | get | create | update | delete',
         '  version    list | get | publish',

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@mindscraft/branch-video-agent-cli",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Published CLI for branch-video and AIHub agent APIs.",
   "type": "module",
   "bin": {
-    "branch-video-agent": "./dist/bin.js"
+    "branch-video-agent": "dist/bin.js",
+    "branch-video-agent-cli": "dist/bin.js"
   },
   "exports": {
     ".": "./dist/index.js"