@aswless_854771076/ai_short_studio_cli 0.1.64 → 0.1.65

package/README.md

@@ -45,11 +45,29 @@ CLI 只把 refresh token 保存到系统钥匙串。短期 access token 会写
 - `ai-short-studio canvas folder`：画布资产目录管理（5 预设 + 用户子目录 + 软删 + 跨项目复制）。
 - `ai-short-studio canvas episode`：列出或创建无限画布分集。其他画布命令用 `--episode <ID|集数>` 选择分集。
 - `ai-short-studio task`：异步任务读取、批量等待和取消。
-- `ai-short-studio config`：读取管理员发布的全局模型，管理个人默认模型、能力默认值和并发配置；CLI 会拒绝写入 Provider 或模型目录。
+- `ai-short-studio config`：读取管理员发布的全局模型，管理个人默认模型和能力默认值；CLI 会拒绝写入 Provider、模型目录或工作流并发。
+- `ai-short-studio config ai-provider`（管理员）：列出、查看、部分更新、连通性测试、拉取模型目录与上报能力诊断。仅供管理员账号使用。
 
 CLI 不提供分集删除或任务人工复核提交；这两类需要确认生产资产或保留范围的操作继续在网页端完成。
 
-`config get` 返回管理员发布的全局模型与个人默认值，不返回供应商密钥。已保存的默认模型失效时，服务端会改用同类型的首个已启用模型，并用实时选项的第一项补齐该模型缺失的能力默认值。Comfly 和 RunningHub 的凭据、服务地址与工作流均由服务端维护；CLI 预检只检查默认模型及能力选项。`config set` 会拒绝写入任何供应商或模型目录。
+`config get` 返回管理员发布的全局模型与个人默认值，不返回供应商密钥。已保存的默认模型失效时，服务端会改用同类型的首个已启用模型，并用实时选项的第一项补齐该模型缺失的能力默认值。Comfly 和 RunningHub 的凭据、服务地址与工作流均由服务端维护；CLI 预检只检查默认模型及能力选项。`config set` 会拒绝写入任何供应商、模型目录或工作流并发；工作流并发由管理员在用户管理中配置。
+
+`config ai-provider` 把管理员侧的 AI Provider 管理从网页端下沉到 CLI，方便部署/CI 与 Agent 复核：
+
+```bash
+ai-short-studio config ai-provider list --json
+ai-short-studio config ai-provider get --id <providerId> --json
+ai-short-studio config ai-provider set --id <providerId> [--base-url <url>] [--api-key-stdin] [--enabled true|false] [--preset <name>] [--json]
+ai-short-studio config ai-provider test --id <providerId> --json
+ai-short-studio config ai-provider models --id <providerId> --json
+ai-short-studio config ai-provider capabilities --json
+```
+
+- `--api-key-stdin` 从隐藏 stdin 读取密钥，禁止写入 shell 历史或日志；非交互环境使用 `VVICAT_AI_PROVIDER_<ID>_API_KEY` 显式注入。
+- `--preset <name>` 调用服务端内置 Preset（如 `openai-compatible`、`runninghub`、`comfly`）一键种子。
+- `test` 输出延迟与 HTTP 状态，不消耗配额外的 token。`models` 只在 `enabled` 且最近一次 `test` 成功时返回目录。
+- `capabilities` 报告当前生效的私有/LAN baseUrl 白名单（来自环境变量 `VVICAT_ALLOW_PRIVATE_PROVIDER_BASE_URLS`，CSV `host:port`）、已注册 Provider 数量、未配置 Provider 类型与缺失项，方便 Agent 明确自己能做什么、缺什么。
+- 设置 Provider `baseUrl` 时若目标是私有/LAN 主机（如 `http://127.0.0.1:8188`、`http://192.168.3.30:8188` 本地 ComfyUI），必须在运行 Next.js 的环境里把 `VVICAT_ALLOW_PRIVATE_PROVIDER_BASE_URLS=127.0.0.1:8188,192.168.3.30:8188` 显式打开；公网 URL 仍强制 HTTPS 与公网 IP 校验。
 
 ```bash
 ai-short-studio canvas edge add --project <projectId> --from <sourceNodeId>:<sourceHandle> --to <targetNodeId>:<targetHandle> --json
@@ -108,12 +126,16 @@ ai-short-studio task wait --task <task1> --task <task2> --concurrency 4 --json
 
 `canvas node update` 的 `--set key=<JSON>`、`--unset key`、`--title`、`--x` 和 `--y` 只修改指定字段；旧 `--config` 仍兼容。`update-many` 在一次画布版本校验中原子更新多个节点。结构化生成资源仍必须使用 `edit-resource` 或 `edit-shot`，不能通过字段更新改写 artifact。批量执行与等待默认并发为 4、上限为 16；Agent 应优先单进程批处理，避免为每个节点启动一个 CLI 进程。
 
+节点执行若返回 `MODEL_PRICING_NOT_CONFIGURED`，表示所选模型能力参数没有匹配的已发布价格档位；应修正模型参数或由管理员发布价格，不能直接重复提交。
+
 使用 `canvas node edit-shot <nodeId> --project <projectId> --file shot.json` 编辑镜头。命令会追加并选中不可变的人工 DOCUMENT 版本，不允许修改 `shotKey`、`shotIndex` 或来源身份，旧版本继续可选。
 
 使用 `canvas node edit-resource <nodeId> --project <projectId> --file resource.json` 编辑剧本、人物、人物视觉、场景、子场景或道具结构化资源。命令只替换完整父文档中的目标实体，追加并选中人工版本；名称、资源键、ID 和所属关系不可修改，兄弟资源节点保持原选版。资源版本写入不属于 `canvas apply` 图补丁，409 后需重新读取画布与当前选版。
 
 CLI 通过 `/api/v1/bootstrap` 完成版本、连通性与 Supabase 公共配置预检，并直接使用现有 `/api/projects`、`/api/canvas/node-types`、项目画布与资产路由。
 
+> 2026-09-05：资产管理 SSOT Phase 1.1 — 删除 5 个已迁移的 `/api/asset-hub/*` 路由（`generate-image` / `modify-image` / `select-image` / `undo-image` / `update-asset-label`），并移除 5 个多方法路由的 GET handler。CLI 不直接调用这些端点，因此不影响 CLI 行为。详见 `docs/asset-management-api-matrix.md`（Phase 1.1 段）。
+
 `canvas node types [kind] --json` 同时兼容节点目录 schema v1/v2，并原样返回动态节点的 `source`、`definitionId` 和 `definitionVersionId`。后台发布后重新执行该命令即可读取新目录；归档节点不能新建，但已有实例仍按画布中的固定版本 schema 更新和执行。CLI 创建节点只提交 `kind` 与配置，版本由服务端固定，不能由客户端伪造。
 
 新建视频生成节点按实时模型能力执行：首尾帧模型使用 `start-frame` + `end-frame`，普通图生视频使用 `start-frame`，图片参考使用 `references`。Ark 两个 Seedance 2.0 和 StarRouter 两个内置 Dreamina Seedance 2.0 可使用 `reference-videos` 和 `reference-audios`，上限为 9 张参考图、3 个参考视频和 3 个参考音频；部署方启用的内部 RunningHub MiniMax H3 模型支持纯文本零媒体输入，参考图、参考视频和独立参考音频范围分别为 0–9、0–2 和 0–2。RunningHub 参考视频只传画面，需要声音时须单独连接参考音频。它的实时 `durationOptions` 为 5–15 秒的每个整数，服务端把 1–4 秒兼容输入归一为 5 秒。其他 StarRouter 和自定义模型不会按名称猜能力。参考音频不能作为唯一媒体输入；纯文本指不连接任何媒体，不是只连参考音频。多模态参考不能与首尾帧混用。历史节点未声明新版输入语义时继续按原多图参考逻辑执行，不会被读取或保存自动迁移。
@@ -208,3 +230,14 @@ npm run release:ci:test -- --version 0.1.1-beta.0
 ```
 
 `release:ci` 会依次运行测试和类型检查、发布 npm、等待 registry 可见，再从 npm 安装该精确版本并验证 CLI 与配套 Skill。无需配置自有 Runner；只有访问内网或需要固定出口 IP 时才使用自有构建集群。
+
+
+
+## 包身份与升级协议
+
+CLI 与服务端 `/api/v1/bootstrap` 必须就包身份（`name` + `latestVersion`）达成一致，否则 `preflight` 会抛"服务端返回的 CLI 包名与当前安装包不一致"并阻塞所有 CLI 命令。
+
+- 仓库内 `package.json` 的 `name` 字段硬绑定为 `@aswless_854771076/ai_short_studio_cli`，pre-commit guard `npm run check:cli-package-identity` 强制。
+- 升级发布流程见 `.github/workflows/cli-publish.yml`（push main 自动 `npm run release -- --verify`）。
+- 手动 release SOP 见本仓库 `.agents/skills/vvicat-cli-adapter/references/cli-release-sop.md`。
+- 服务端 `/api/v1/bootstrap` 现暴露 `data.cliDrift` 字段，drift 时返回 `reason` + `manifest` + `npm` 三组对照信息；Agent 进入新环境跑 `config ai-provider capabilities --json` 即可看到。

package/dist/client/api-client.js

@@ -18,8 +18,21 @@ export class ApiClient {
         if (response.status === 401 && options.auth !== false) {
             response = await this.send(path, options, await this.session.refreshAccessToken());
         }
-        if (!response.ok)
+        if (!response.ok) {
+            // root cause: undici fetch close + @napi-rs/keyring handle race;
+            // setImmediate alone not enough, need real delay.
+            //
+            // 抛出前必须给 undici 真实时间完成内部 cleanup：在 Node 21+ / Windows 上，
+            // setImmediate 只 flush 微任务队列，但 undici 内部的 socket close 是异步且
+            // 至少需要几十毫秒完成。若 await response.json() / apiError(response) 解析
+            // body 时 undici 已经发出 close 信号，但底层 libuv handle（被
+            // @napi-rs/keyring 持有）尚未 close，就会触发
+            // `UV_HANDLE_CLOSING assertion failed`（src\win\async.c:76），进程异常
+            // 退出 3221226505。先 sleep 50ms 让 undici 内部 cleanup 完成，再读 body
+            // / throw 才是安全的。详见 preflight.ts 的同源注释。
+            await new Promise((resolve) => setTimeout(resolve, 50));
             throw await apiError(response);
+        }
         if (response.status === 204)
             return undefined;
         return await response.json();
@@ -30,8 +43,12 @@ export class ApiClient {
         if (response.status === 401 && options.auth !== false) {
             response = await this.send(path, options, await this.session.refreshAccessToken());
         }
-        if (!response.ok)
+        if (!response.ok) {
+            // 同 request：throw 前需要真实 delay 让 undici 收尾，否则同样触发
+            // UV_HANDLE_CLOSING。response() 路径同样需要 sleep 50ms。
+            await new Promise((resolve) => setTimeout(resolve, 50));
             throw await apiError(response);
+        }
         return response;
     }
     async send(path, options, accessToken) {

package/dist/commands/canvas/asset/select.d.ts

@@ -1,11 +1,12 @@
 import { BaseCommand } from '../../../base-command.js';
 export default class CanvasAssetSelect extends BaseCommand {
     static args: {
-        assetId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        assetId: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static flags: {
         project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         version: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        asset: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/canvas/asset/select.js

@@ -1,8 +1,27 @@
 import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../../base-command.js';
 import { commandApi, projectFlag } from '../../../command-helpers.js';
+// 同时支持 positional ASSETID 与 --asset <id>：
+// - 历史 CLI 调用方习惯写 `... select-version <assetId> --version <v>`。
+// - bundled skill 文档 (skills/using-vvicat-ai-short-studio-cli/references/commands/assets-and-tasks.md:9)
+//   写的是 `--asset <assetId>`，agent 容易按文档写错。
+// 两种调用方式都接受，重复给出时报错。
 export default class CanvasAssetSelect extends BaseCommand {
-    static args = { assetId: Args.string({ required: true }) };
-    static flags = { ...BaseCommand.baseFlags, project: projectFlag, version: Flags.string({ required: true }) };
-    async run() { const { args, flags } = await this.parse(CanvasAssetSelect); const { api } = await commandApi(flags); this.print(await api.selectAssetVersion(flags.project, args.assetId, flags.version)); }
+    static args = { assetId: Args.string({ required: false, description: '资产 ID（位置参数，与 --asset 二选一）' }) };
+    static flags = {
+        ...BaseCommand.baseFlags,
+        project: projectFlag,
+        version: Flags.string({ required: true }),
+        asset: Flags.string({ description: '资产 ID（与位置参数 ASSETID 二选一）' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(CanvasAssetSelect);
+        const assetId = args.assetId ?? flags.asset;
+        if (!assetId)
+            throw new Error('请提供 assetId 作为位置参数或 --asset');
+        if (args.assetId && flags.asset)
+            throw new Error('请提供 assetId 作为位置参数或 --asset（不能同时给两个）');
+        const { api } = await commandApi(flags);
+        this.print(await api.selectAssetVersion(flags.project, assetId, flags.version));
+    }
 }

package/dist/commands/canvas/edge/list.js

@@ -1,10 +1,13 @@
 import { BaseCommand } from '../../../base-command.js';
 import { commandApi, projectFlag } from '../../../command-helpers.js';
+// 输出保持 `{edges: [...]}` 与 `canvas node list --json` 对称，方便 agent 统一处理。
+// 历史版本直接 print 数组，agent 拿到的就是裸数组，结构与 nodes 不对称。
 export default class CanvasEdgeList extends BaseCommand {
     static flags = { ...BaseCommand.baseFlags, project: projectFlag };
     async run() {
         const { flags } = await this.parse(CanvasEdgeList);
         const { api } = await commandApi(flags);
-        this.print(await api.listEdges(flags.project));
+        const edges = await api.listEdges(flags.project);
+        this.print({ edges });
     }
 }

package/dist/commands/canvas/node/list.d.ts

@@ -2,6 +2,10 @@ import { BaseCommand } from '../../../base-command.js';
 export default class CanvasNodeList extends BaseCommand {
     static flags: {
         project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        kind: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        status: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        search: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'producer-node': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/canvas/node/list.js

@@ -1,10 +1,51 @@
+import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../../base-command.js';
 import { commandApi, projectFlag } from '../../../command-helpers.js';
+// list 命令的客户端过滤与 inspect 的 matchesInspectNode(vvicat-api.ts:494) 行为类似，
+// 但不复用服务端过滤，因为 list 返回的 CanvasNode 结构和 inspect 不完全一致。
+// 输出保持 `{nodes: [...]}` 与原版本兼容。
+function matchesListNode(node, filters) {
+    if (filters.kinds?.length && !filters.kinds.includes(node.kind))
+        return false;
+    if (filters.statuses?.length && !filters.statuses.includes(String(node.status ?? 'idle')))
+        return false;
+    if (filters.producerNodeId) {
+        const artifact = node.data?.artifact && typeof node.data.artifact === 'object' && !Array.isArray(node.data.artifact)
+            ? node.data.artifact
+            : {};
+        if (artifact.producerNodeId !== filters.producerNodeId)
+            return false;
+    }
+    if (filters.search) {
+        const query = filters.search.toLocaleLowerCase();
+        const artifact = node.data?.artifact && typeof node.data.artifact === 'object' && !Array.isArray(node.data.artifact)
+            ? node.data.artifact
+            : {};
+        const candidates = [node.id, node.title, artifact.name, artifact.resourceKey];
+        if (!candidates.some((value) => typeof value === 'string' && value.toLocaleLowerCase().includes(query)))
+            return false;
+    }
+    return true;
+}
 export default class CanvasNodeList extends BaseCommand {
-    static flags = { ...BaseCommand.baseFlags, project: projectFlag };
+    static flags = {
+        ...BaseCommand.baseFlags,
+        project: projectFlag,
+        kind: Flags.string({ description: '按节点 kind 过滤，可重复指定', multiple: true }),
+        status: Flags.string({ description: '按节点状态过滤，可重复指定', multiple: true }),
+        search: Flags.string({ description: '按节点 ID / 标题 / artifact 名称 / resourceKey 模糊搜索' }),
+        'producer-node': Flags.string({ description: '按 artifact.producerNodeId 过滤' }),
+    };
     async run() {
         const { flags } = await this.parse(CanvasNodeList);
         const { api } = await commandApi(flags);
-        this.print(await api.listNodes(flags.project));
+        const nodes = await api.listNodes(flags.project);
+        const filtered = nodes.filter((node) => matchesListNode(node, {
+            kinds: flags.kind,
+            statuses: flags.status,
+            search: flags.search,
+            producerNodeId: flags['producer-node'],
+        }));
+        this.print({ nodes: filtered });
     }
 }

package/dist/commands/canvas/node/run.d.ts

@@ -9,6 +9,9 @@ export default class CanvasNodeRun extends BaseCommand {
         concurrency: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         wait: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         interval: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'max-wait-ms': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'max-attempts': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'auto-select-version': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/canvas/node/run.js

@@ -10,6 +10,18 @@ export default class CanvasNodeRun extends BaseCommand {
         concurrency: Flags.integer({ description: '批量提交并发数', default: 4, min: 1, max: 16 }),
         wait: Flags.boolean({ default: false }),
         interval: Flags.integer({ default: 1000 }),
+        'max-wait-ms': Flags.integer({
+            description: '单次 waitTask 最大等待毫秒数；0 表示不超时（保留旧行为）。例如 --wait --max-wait-ms 180000 表示 3 分钟超时。',
+            default: 0,
+        }),
+        'max-attempts': Flags.integer({
+            description: 'retryable 失败时，最大重新执行节点次数。0=不重试；>0 时配合 --max-wait-ms 使用。',
+            default: 0,
+        }),
+        'auto-select-version': Flags.boolean({
+            description: '节点跑完且 task.result 含 assetId/versionId 时，自动调 canvas asset select-version 让下游 cvd 拿到 profile。默认 false，避免误选。',
+            default: false,
+        }),
     };
     async run() {
         const { args, flags } = await this.parse(CanvasNodeRun);
@@ -17,6 +29,11 @@ export default class CanvasNodeRun extends BaseCommand {
         if (!nodeIds.length)
             throw new Error('请提供 nodeId 或至少一个 --node');
         const { api } = await commandApi(flags);
+        // 简化：批量 + retry 的组合会让 race 复杂化。带 --node 多值 + --max-attempts > 0
+        // 时只对第一个节点生效并打印警告，保持职责简单。
+        if (flags.wait && flags['max-attempts'] > 0 && nodeIds.length > 1) {
+            this.log('warn: --max-attempts 仅对单节点生效；批量模式下自动忽略');
+        }
         const submissions = await mapConcurrent(nodeIds, flags.concurrency, async (nodeId) => ({
             nodeId,
             result: await api.runNode(flags.project, nodeId),
@@ -25,13 +42,94 @@ export default class CanvasNodeRun extends BaseCommand {
             this.print(nodeIds.length === 1 ? submissions[0].result : { submissions });
             return;
         }
+        const maxWaitMs = flags['max-wait-ms'] > 0 ? flags['max-wait-ms'] : Number.POSITIVE_INFINITY;
         const tasks = submissions.filter((item) => item.result.task?.id);
-        const completed = await mapConcurrent(tasks, flags.concurrency, async (item) => ({
-            nodeId: item.nodeId,
-            task: await api.waitTask(item.result.task.id, flags.interval),
-        }));
-        this.print(nodeIds.length === 1 ? completed[0]?.task ?? submissions[0].result : { submissions, tasks: completed });
+        const completed = await mapConcurrent(tasks, flags.concurrency, async (item) => {
+            let currentSubmission = item.result;
+            let attempt = 0;
+            const maxAttempts = flags['max-attempts'] > 0 ? flags['max-attempts'] : 1;
+            // 职责分离：
+            // - waitTask 只负责按 interval 轮询并在 maxWaitMs 到达时抛 'wait timeout'。
+            // - 本循环负责 retry 决策（task.error?.retryable && attempt < maxAttempts 时
+            //   cancel + 重新 runNode 并继续 wait）。
+            // 关键点：'wait timeout' 不应该被外层 catch 当作任务失败，也不应该触发整批
+            // mapConcurrent 的 reject（否则 agent 看到 exit 0 + 空输出）。这里把 timeout
+            // 视为"还在跑"，让 while 继续下一轮 wait；只在 task.status === 'failed' 时
+            // 才根据 retryable 决定是否退。
+            // eslint-disable-next-line no-constant-condition
+            while (true) {
+                attempt += 1;
+                const taskId = currentSubmission.task?.id;
+                if (!taskId)
+                    throw new Error(`节点 ${item.nodeId} 未返回 task id`);
+                let task;
+                try {
+                    task = (await api.waitTask(taskId, flags.interval, { maxWaitMs }));
+                }
+                catch (error) {
+                    if (error instanceof Error && error.message.startsWith('wait timeout')) {
+                        // wait 还没拿到终态：视为任务仍在跑，消耗一次 attempt 后重新 wait。
+                        // 即使 maxAttempts 已耗尽，只要不是真的 failed + retryable，就继续 wait，
+                        // 直到任务真的结束（completed / failed / canceled）。这样长任务在
+                        // 较小 maxWaitMs 下不会突然退出整批 mapConcurrent。
+                        if (attempt > maxAttempts * 8) {
+                            // 防御性兜底：避免无限循环（例如 waitTask 永远拿不到终态）。
+                            // 仅在 attempt 数远超 maxAttempts 时才退，并把 timeout 信息透出。
+                            const err = new Error(`节点 ${item.nodeId} 等待超时（attempt=${attempt}）`);
+                            Object.assign(err, { taskId, attempts: attempt });
+                            throw err;
+                        }
+                        continue;
+                    }
+                    throw error;
+                }
+                if (task.status === 'completed') {
+                    return { nodeId: item.nodeId, task, attempts: attempt };
+                }
+                if (task.status === 'failed' && task.error?.retryable === true && attempt < maxAttempts) {
+                    // 取消旧任务后重新执行节点，再重新跑一次 wait。waitTask 不做 cancel/retry 决策。
+                    try {
+                        await api.cancelTask(taskId);
+                    }
+                    catch { /* 旧任务可能已终态，忽略 */ }
+                    const newSubmission = await api.runNode(flags.project, item.nodeId);
+                    currentSubmission = newSubmission;
+                    continue;
+                }
+                return { nodeId: item.nodeId, task, attempts: attempt };
+            }
+        });
+        this.print(nodeIds.length === 1 ? completed[0] : { submissions, tasks: completed });
         if (completed.some((item) => item.task.status !== 'completed'))
             this.error('部分任务未成功完成', { exit: 8 });
+        // --auto-select-version：节点成功跑完后，若 task.result 含 assetId + versionId，
+        // 自动调 canvas asset select-version，让下游 cvd 节点能读到 character profile。
+        // 服务端可能已经物化 resource，但 selectedOutputVersionId 不一定自动 set，所以
+        // 这里走显式 PATCH；只对 completed 的任务生效，避免在 failed 任务上误选。
+        if (flags['auto-select-version']) {
+            const selectedVersions = [];
+            for (const item of completed) {
+                if (item.task.status !== 'completed')
+                    continue;
+                const assetId = item.task.result?.assetId;
+                const versionId = item.task.result?.versionId;
+                if (!assetId || !versionId)
+                    continue;
+                try {
+                    await api.selectAssetVersion(flags.project, assetId, versionId);
+                    selectedVersions.push({ nodeId: item.nodeId, assetId, versionId });
+                }
+                catch (error) {
+                    // 选版失败不阻塞主流程；仅 warn。
+                    this.log(`warn: 节点 ${item.nodeId} 自动 select-version 失败：${error instanceof Error ? error.message : String(error)}`);
+                }
+            }
+            if (selectedVersions.length) {
+                // 在已经 print 过的 completed 输出之外，额外把 selectedVersion 列表输出，
+                // 让 agent 能立即知道哪个 nodeId 对应哪个 assetId/versionId。
+                // 不影响默认行为，仅 --auto-select-version=true 时出现。
+                this.log(`auto-selected versions: ${JSON.stringify(selectedVersions)}`);
+            }
+        }
     }
 }

package/dist/commands/config/ai-provider/capabilities.d.ts

@@ -0,0 +1,26 @@
+import { BaseCommand } from '../../../base-command.js';
+/**
+ * vvicat config ai-provider capabilities
+ *
+ * 聚合视图：agent 视角的「当前能跑什么 / 缺什么」。
+ *
+ * 数据来源：
+ *   - GET /api/admin/ai-providers        → 仓库 provider 目录
+ *   - GET /api/user/api-config           → catalog + defaultModels + capabilityDefaults
+ *   - POST /api/admin/ai-providers/{id}/test (每个 enabled provider) → reachability
+ *
+ * 输出 CapabilitiesReport JSON（schema 见 src/domain/ai-provider-capabilities.ts）。
+ */
+export default class ConfigAiProviderCapabilities extends BaseCommand {
+    static description: string;
+    static flags: {
+        'no-reachability': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'reachability-concurrency': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/config/ai-provider/capabilities.js

@@ -0,0 +1,90 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../../base-command.js';
+import { commandApi } from '../../../command-helpers.js';
+import { buildCapabilitiesReport } from '../../../domain/ai-provider-capabilities.js';
+import { extractCapabilityDefaults, extractCatalogModels, extractDefaultModels } from '../../../domain/ai-provider-command-helpers.js';
+/**
+ * vvicat config ai-provider capabilities
+ *
+ * 聚合视图：agent 视角的「当前能跑什么 / 缺什么」。
+ *
+ * 数据来源：
+ *   - GET /api/admin/ai-providers        → 仓库 provider 目录
+ *   - GET /api/user/api-config           → catalog + defaultModels + capabilityDefaults
+ *   - POST /api/admin/ai-providers/{id}/test (每个 enabled provider) → reachability
+ *
+ * 输出 CapabilitiesReport JSON（schema 见 src/domain/ai-provider-capabilities.ts）。
+ */
+export default class ConfigAiProviderCapabilities extends BaseCommand {
+    static description = '聚合视图：当前能跑哪些模型，缺什么配置';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        'no-reachability': Flags.boolean({
+            description: '跳过连通性探测（更快，但 reachability 全部为 unknown）',
+            default: false,
+        }),
+        'reachability-concurrency': Flags.integer({
+            description: '并发探测 provider 数（默认 4）',
+            default: 4,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(ConfigAiProviderCapabilities);
+        const { api } = await commandApi(flags);
+        const [providersPayload, config] = await Promise.all([
+            api.listAiProviders(),
+            api.config(),
+        ]);
+        const providerRows = (providersPayload.items ?? []);
+        const reachability = {};
+        if (!flags['no-reachability']) {
+            const enabled = providerRows.filter((p) => p.enabled);
+            const concurrency = Math.max(1, Math.min(flags['reachability-concurrency'], enabled.length || 1));
+            const results = await probeConcurrently(enabled, concurrency, api.testAiProvider.bind(api));
+            for (const [id, result] of results)
+                reachability[id] = result;
+        }
+        const report = buildCapabilitiesReport({
+            baseUrl: flags['base-url'] ?? '',
+            providers: providerRows.map((p) => ({
+                id: p.id,
+                name: p.name,
+                type: p.type,
+                enabled: p.enabled,
+                baseUrl: p.baseUrl,
+                apiKeyMask: p.apiKeyMask,
+                hasApiKey: p.hasApiKey,
+                protocolMode: p.protocolMode,
+                lastTestResult: p.lastTestResult,
+                lastResponseMs: p.lastResponseMs,
+                upstreamModels: p.upstreamModels,
+                upstreamModelsSyncedAt: p.upstreamModelsSyncedAt,
+            })),
+            catalogModels: extractCatalogModels(config),
+            defaultModels: extractDefaultModels(config),
+            capabilityDefaults: extractCapabilityDefaults(config),
+            reachability,
+        });
+        this.print(report);
+    }
+}
+async function probeConcurrently(providers, concurrency, probe) {
+    const out = [];
+    let cursor = 0;
+    const workers = Array.from({ length: Math.min(concurrency, Math.max(providers.length, 1)) }, async () => {
+        while (cursor < providers.length) {
+            const index = cursor++;
+            const provider = providers[index];
+            try {
+                const result = await probe(provider.id);
+                const detail = result.steps?.map((step) => `${step.status ?? 'unknown'}/${step.httpStatus ?? '?'}`).join(', ') ?? '';
+                out.push([provider.id, { ok: result.success === true, detail, durationMs: result.durationMs }]);
+            }
+            catch (error) {
+                out.push([provider.id, { ok: false, detail: error instanceof Error ? error.message : String(error) }]);
+            }
+        }
+    });
+    await Promise.all(workers);
+    return out;
+}

package/dist/commands/config/ai-provider/get.d.ts

@@ -0,0 +1,21 @@
+import { BaseCommand } from '../../../base-command.js';
+/**
+ * vvicat config ai-provider get <providerId>
+ *
+ * 查看单个 provider 的 baseUrl / enabled / protocol / apiKey 状态。
+ * 服务端 serializeExtendedProvider 已脱敏（apiKeyMask='••••••••'），CLI 不再多处理。
+ */
+export default class ConfigAiProviderGet extends BaseCommand {
+    static description: string;
+    static args: {
+        providerId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/config/ai-provider/get.js

@@ -0,0 +1,21 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../../base-command.js';
+import { commandApi } from '../../../command-helpers.js';
+/**
+ * vvicat config ai-provider get <providerId>
+ *
+ * 查看单个 provider 的 baseUrl / enabled / protocol / apiKey 状态。
+ * 服务端 serializeExtendedProvider 已脱敏（apiKeyMask='••••••••'），CLI 不再多处理。
+ */
+export default class ConfigAiProviderGet extends BaseCommand {
+    static description = '查看单个 AI provider 详情';
+    static args = {
+        providerId: Args.string({ required: true, description: 'provider ID（如 comfyui / runninghub）' }),
+    };
+    static flags = BaseCommand.baseFlags;
+    async run() {
+        const { args, flags } = await this.parse(ConfigAiProviderGet);
+        const { api } = await commandApi(flags);
+        this.print(await api.getAiProvider(args.providerId));
+    }
+}

package/dist/commands/config/ai-provider/list.d.ts

@@ -0,0 +1,20 @@
+import { BaseCommand } from '../../../base-command.js';
+/**
+ * vvicat config ai-provider list
+ *
+ * 列出仓库中所有 AI provider（comfly / comfyui / runninghub / openai / ...），
+ * 含 enabled/protocol/baseUrl/apiKey 状态（apiKey 脱敏）。
+ *
+ * 服务端要求 admin 鉴权。
+ */
+export default class ConfigAiProviderList extends BaseCommand {
+    static description: string;
+    static flags: {
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/config/ai-provider/list.js

@@ -0,0 +1,19 @@
+import { BaseCommand } from '../../../base-command.js';
+import { commandApi } from '../../../command-helpers.js';
+/**
+ * vvicat config ai-provider list
+ *
+ * 列出仓库中所有 AI provider（comfly / comfyui / runninghub / openai / ...），
+ * 含 enabled/protocol/baseUrl/apiKey 状态（apiKey 脱敏）。
+ *
+ * 服务端要求 admin 鉴权。
+ */
+export default class ConfigAiProviderList extends BaseCommand {
+    static description = '列出仓库中所有 AI provider（apiKey 脱敏）';
+    static flags = BaseCommand.baseFlags;
+    async run() {
+        const { flags } = await this.parse(ConfigAiProviderList);
+        const { api } = await commandApi(flags);
+        this.print(await api.listAiProviders());
+    }
+}

package/dist/commands/config/ai-provider/models.d.ts

@@ -0,0 +1,21 @@
+import { BaseCommand } from '../../../base-command.js';
+/**
+ * vvicat config ai-provider models <providerId>
+ *
+ * 拉取 provider 远端真实模型清单（GET baseUrl/models）。
+ * 服务端会把结果缓存到 ai_providers.upstreamModels，可重复调用观察同步状态。
+ */
+export default class ConfigAiProviderModels extends BaseCommand {
+    static description: string;
+    static args: {
+        providerId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        locale: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        episode: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/config/ai-provider/models.js

@@ -0,0 +1,21 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../../base-command.js';
+import { commandApi } from '../../../command-helpers.js';
+/**
+ * vvicat config ai-provider models <providerId>
+ *
+ * 拉取 provider 远端真实模型清单（GET baseUrl/models）。
+ * 服务端会把结果缓存到 ai_providers.upstreamModels，可重复调用观察同步状态。
+ */
+export default class ConfigAiProviderModels extends BaseCommand {
+    static description = '拉取 provider 远端真实模型清单（GET /models）';
+    static args = {
+        providerId: Args.string({ required: true, description: 'provider ID' }),
+    };
+    static flags = BaseCommand.baseFlags;
+    async run() {
+        const { args, flags } = await this.parse(ConfigAiProviderModels);
+        const { api } = await commandApi(flags);
+        this.print(await api.fetchAiProviderModels(args.providerId));
+    }
+}