@aswless_854771076/ai_short_studio_cli 0.1.63 → 0.1.65

package/dist/domain/vvicat-api.d.ts

@@ -19,6 +19,11 @@ interface CanvasDto extends JsonObject {
     edges: JsonObject[];
     nodeTypesByVersionId?: Record<string, NodeType>;
 }
+interface CanvasNodeRunResponse extends JsonObject {
+    task: JsonObject & {
+        id?: string;
+    };
+}
 interface NodeType extends JsonObject {
     kind: string;
     title: string;
@@ -126,7 +131,7 @@ export declare class VvicatApi {
         targetHandle: string;
     }): Promise<JsonObject>;
     disconnect(projectId: string, edgeId: string): Promise<JsonObject>;
-    runNode(projectId: string, nodeId: string): Promise<JsonObject>;
+    runNode(projectId: string, nodeId: string): Promise<CanvasNodeRunResponse>;
     listAssets(projectId: string, query?: string): Promise<JsonObject>;
     asset(projectId: string, assetId: string): Promise<JsonObject>;
     selectAssetVersion(projectId: string, assetId: string, versionId: string): Promise<JsonObject>;
@@ -137,11 +142,46 @@ export declare class VvicatApi {
         };
     }>;
     cancelTask(taskId: string): Promise<JsonObject>;
-    waitTask(taskId: string, interval?: number): Promise<JsonObject & {
+    waitTask(taskId: string, interval?: number, options?: {
+        maxWaitMs?: number;
+        signal?: AbortSignal;
+    }): Promise<JsonObject & {
         status: string;
     }>;
     config(): Promise<JsonObject>;
     updateConfig(input: JsonObject): Promise<JsonObject>;
+    listAiProviders(): Promise<{
+        items: JsonObject[];
+        total: number;
+    }>;
+    getAiProvider(providerId: string): Promise<{
+        item: JsonObject;
+    }>;
+    createAiProvider(input: JsonObject): Promise<{
+        item: JsonObject;
+    }>;
+    updateAiProvider(providerId: string, input: JsonObject): Promise<{
+        item: JsonObject;
+    }>;
+    testAiProvider(providerId: string): Promise<JsonObject>;
+    fetchAiProviderModels(providerId: string): Promise<{
+        item: {
+            providerId: string;
+            upstreamModelsSyncedAt: string | null;
+            models: JsonObject[];
+        };
+    }>;
+    clearAiProviderSecret(providerId: string): Promise<{
+        success: boolean;
+    }>;
+    seedAiProviderFromPreset(presetType: string, options?: {
+        baseUrl?: string;
+        apiKey?: string;
+        sortOrder?: number;
+    }): Promise<{
+        item: JsonObject;
+        preset: JsonObject;
+    }>;
     raw(path: string, options?: ApiRequestOptions): Promise<unknown>;
 }
 export {};

package/dist/domain/vvicat-api.js

@@ -318,6 +318,13 @@ export class VvicatApi {
     }
     uploadAsset(projectId, formData) {
         formData.set('sourceProjectId', projectId);
+        // 🛡️ Phase 1.1 (asset-ssot SSOT): the upstream `/api/asset-hub/creative-assets/upload`
+        // route is intentionally preserved here — it is route #25 (complex; Project +
+        // CanvasFolder + CanvasEpisode cascade-delete semantics) and is scheduled for
+        // Phase C migration, not Phase 1.1. The Phase 1.1 deletions only target
+        // already-migrated trivial routes (generate-image / modify-image /
+        // select-image / undo-image / update-asset-label) and read-side GETs.
+        // See docs/asset-management-api-matrix.md (Phase 1.1 section).
         return this.client.request('/api/asset-hub/creative-assets/upload', { method: 'POST', body: formData });
     }
     task(taskId) {
@@ -327,11 +334,26 @@ export class VvicatApi {
     cancelTask(taskId) {
         return this.client.request(`/api/tasks/${taskId}`, { method: 'DELETE' });
     }
-    async waitTask(taskId, interval = 1_000) {
+    // waitTask 只负责轮询，不做任何重试 / cancel 决策。retry 与 cancel 由调用方
+    // （canvas node run）根据 task.error?.retryable / task.attempt 自行决定。
+    async waitTask(taskId, interval = 1_000, options = {}) {
+        const maxWaitMs = options.maxWaitMs ?? Number.POSITIVE_INFINITY;
+        const startedAt = Date.now();
         while (true) {
+            if (options.signal?.aborted) {
+                throw new Error('wait aborted');
+            }
             const { task } = await this.task(taskId);
             if (['completed', 'failed', 'canceled', 'dismissed'].includes(task.status))
                 return task;
+            const elapsed = Date.now() - startedAt;
+            if (elapsed >= maxWaitMs) {
+                // 抛出时附带最新 task 状态，让调用方（canvas node run）可以决定是
+                // cancel 后重试还是直接退出。
+                const err = new Error(`wait timeout after ${maxWaitMs}ms`);
+                Object.assign(err, { taskId, status: task.status, attempt: task.attempt });
+                throw err;
+            }
             await this.sleep(interval);
         }
     }
@@ -340,10 +362,41 @@ export class VvicatApi {
         return this.client.request('/api/user/api-config?redactSecrets=1');
     }
     updateConfig(input) {
-        if (Object.hasOwn(input, 'providers') || Object.hasOwn(input, 'models'))
-            throw new Error('供应商和模型目录只能由管理员维护');
+        if (Object.hasOwn(input, 'providers') || Object.hasOwn(input, 'models') || Object.hasOwn(input, 'workflowConcurrency')) {
+            throw new Error('供应商、模型目录和工作流并发只能由管理员维护');
+        }
         return this.client.request('/api/user/api-config', { method: 'PUT', body: input });
     }
+    // ===== admin AI provider commands（服务端 requireAdminAuth）=====
+    // 仓库级供应商目录（不是用户私有配置）。
+    // agent 用这些方法查询当前可用的 provider / model，再决定任务里用哪个 modelKey。
+    listAiProviders() {
+        return this.client.request('/api/admin/ai-providers');
+    }
+    getAiProvider(providerId) {
+        return this.client.request(`/api/admin/ai-providers/${providerId}`);
+    }
+    createAiProvider(input) {
+        return this.client.request('/api/admin/ai-providers', { method: 'POST', body: input });
+    }
+    updateAiProvider(providerId, input) {
+        return this.client.request(`/api/admin/ai-providers/${providerId}`, { method: 'PATCH', body: input });
+    }
+    testAiProvider(providerId) {
+        return this.client.request(`/api/admin/ai-providers/${providerId}/test`, { method: 'POST' });
+    }
+    fetchAiProviderModels(providerId) {
+        return this.client.request(`/api/admin/ai-providers/${providerId}/fetch-models`, { method: 'POST' });
+    }
+    clearAiProviderSecret(providerId) {
+        return this.client.request(`/api/admin/ai-providers/${providerId}/secret`, { method: 'DELETE' });
+    }
+    seedAiProviderFromPreset(presetType, options = {}) {
+        return this.client.request('/api/admin/ai-providers/seed-from-preset', {
+            method: 'POST',
+            body: { presetType, options },
+        });
+    }
     raw(path, options) {
         return this.client.request(path, options);
     }

package/dist/preflight.js

@@ -18,9 +18,18 @@ export async function fetchBootstrap(baseUrl, fetcher = fetch) {
         });
     }
     catch {
+        // root cause: undici fetch close + @napi-rs/keyring handle race;
+        // setImmediate alone not enough, need real delay.
+        //
+        // 让 fetch 内部句柄先收尾再 throw，避免在 @napi-rs/keyring 仍持有句柄时立刻
+        // 关闭 libuv handle 导致 Windows 上 `UV_HANDLE_CLOSING assertion failed`。
+        // Node 21+ 配合 undici 的 fetch 实现，未 sleep 真实时间就 throw 会让
+        // 尚未 close 的 handle 留给 GC，最终触发崩溃（退出码 3221226505）。
+        await new Promise((resolve) => setTimeout(resolve, 50));
         throw new Error(`无法连接 VVICAT 服务，请检查 API base URL：${normalizedBaseUrl}`);
     }
     if (!response.ok) {
+        await new Promise((resolve) => setTimeout(resolve, 50));
         throw new Error(`VVICAT 服务预检失败：HTTP ${response.status}；请检查 API base URL：${normalizedBaseUrl}`);
     }
     const payload = await response.json().catch(() => null);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aswless_854771076/ai_short_studio_cli",
-  "version": "0.1.63",
+  "version": "0.1.65",
   "description": "VVICAT 无限画布项目命令行工具",
   "license": "MIT",
   "private": false,

package/skills/using-vvicat-ai-short-studio-cli/SKILL.md

@@ -3,6 +3,20 @@ name: using-vvicat-ai-short-studio-cli
 description: Use when an agent needs to inspect or operate VVICAT infinite-canvas projects through the ai-short-studio CLI, including assets, storyboard-to-video rolling generation, task recovery, editing, captions, audio balancing, and final delivery.
 ---
 
+<!-- 🛡️ 2026-09-05 asset-ssot Phase 1.1 sync note: 5 trivial `/api/asset-hub/*` routes deleted
+(generate-image / modify-image / select-image / undo-image / update-asset-label) and 5 GET
+handlers removed from multi-method routes. CLI does not call these endpoints directly.
+`/api/asset-hub/creative-assets/upload` (route #25, complex) is preserved and still used by
+`uploadAsset` in `src/domain/vvicat-api.ts`. See `docs/asset-management-api-matrix.md` Phase 1.1. -->
+
+
+<!-- 🛡️ 2026-09-06 cli-backend-sync Layer 1+2: 服务器 bootstrap 现暴露
+data.cliDrift 字段；packages/ai_short_studio_cli/package.json 的 name 字段被
+pre-commit guard 锁定为 @aswless_854771076/ai_short_studio_cli。Agent 升级 CLI
+前请跑 `config ai-provider capabilities` 看是否有 cliDrift；如有，按
+data.cliDrift.reason (PACKAGE_NAME_DRIFT / VERSION_DRIFT) 走对应修复路径。
+详见本仓库 .agents/skills/vvicat-cli-adapter/SKILL.md §3.1。 -->
+
 # 使用 VVICAT AI Short Studio CLI
 
 ## 按需读取
@@ -22,7 +36,7 @@ description: Use when an agent needs to inspect or operate VVICAT infinite-canva
 
 把 `ai-short-studio` 当作机器可读的远程控制接口。目标、素材含义、平台、语言、画幅、时长、风格、人物、场景、道具、模型、实时 schema、候选版本、付费范围或覆盖影响存在未知、缺失或矛盾时，合并询问最少必要问题；得到答复前只做只读检查。不得用示例值替用户作创作决定。
 
-优先使用一次 `canvas inspect` 聚合查询。同阶段可合并的 settings、节点和连线分别使用 `canvas settings set --file`、`canvas apply`、`canvas node update-many`。生成链使用单个调度循环滚动提交，不用 `--wait` 把整批阶段串行化：节点一完成就刷新画布并立即提交它已就绪的下游节点。默认每类并发 4、总并发上限 16；同一节点同一输入指纹只允许一个在途任务，不并发启动多个相互竞争的调度器。409 重读并确认，401/403、schema、业务门禁和付费错误必须停下修正。
+优先使用一次 `canvas inspect` 聚合查询。同阶段可合并的 settings、节点和连线分别使用 `canvas settings set --file`、`canvas apply`、`canvas node update-many`。生成链使用单个调度循环滚动提交，不用 `--wait` 把整批阶段串行化：节点一完成就刷新画布并立即提交它已就绪的下游节点。默认每类并发 4、总并发上限 16；同一节点同一输入指纹只允许一个在途任务，不并发启动多个相互竞争的调度器。409 重读并确认，401/403、schema、业务门禁和付费错误必须停下修正；`MODEL_PRICING_NOT_CONFIGURED` 表示当前能力参数没有已发布价格档位，不能盲目重试。
 
 ## 主流程
 

package/skills/using-vvicat-ai-short-studio-cli/references/commands/project.md

@@ -62,4 +62,23 @@ ai-short-studio config get --json
 ai-short-studio config set --file config.json --json
 ```
 
-`config set` 只接受个人默认模型、能力默认值和并发；供应商、密钥与全局模型目录只能由管理员维护。
+`config set` 只接受个人默认模型和能力默认值；供应商、密钥、全局模型目录与工作流并发只能由管理员维护。
+
+## 管理员 AI Provider
+
+仅管理员账号可用。Agent 在排查"我能不能用这个 provider / 还缺什么配置"时，先跑 `config ai-provider capabilities`，再决定后续命令。
+
+```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 读取；CI 用 `VVICAT_AI_PROVIDER_<ID>_API_KEY` 注入。
+- `--preset <name>` 触发服务端 Preset（如 `openai-compatible`、`runninghub`、`comfly`）一键种子。
+- `test` 不消耗 token，只报告 HTTP/延迟；`models` 仅在 `enabled` 且最近 `test` 成功时返回。
+- `capabilities` 报告当前生效的私有/LAN baseUrl 白名单（环境变量 `VVICAT_ALLOW_PRIVATE_PROVIDER_BASE_URLS`，CSV `host:port`）、已注册 Provider、缺失项与诊断。
+- 私有/LAN baseUrl（如本地 ComfyUI `http://127.0.0.1:8188`、`http://192.168.3.30:8188`）需要在 Next.js 运行环境里设置 `VVICAT_ALLOW_PRIVATE_PROVIDER_BASE_URLS` 显式打开；公网 URL 仍强制 HTTPS 与公网 IP。

package/skills/using-vvicat-ai-short-studio-cli/references/project-and-canvas.md

@@ -5,7 +5,7 @@
 ## 初始化和配置
 
 1. `preflight --json` 检查地址、CLI 版本、认证和标准能力；`restartRequired` 为真时重跑。仅缺可确定的账户 `capabilityDefaults` 时，从实时 options、目标项目有效值或模型默认值补齐并回读；模型不可用或候选缺失时停下询问。
-2. `config get` 只管理个人默认模型、能力默认值和工作流并发。供应商、密钥和全局模型目录由管理员维护。
+2. `config get` 展示个人默认模型、能力默认值和管理员下发的工作流并发；`config set` 只能修改前两项。供应商、密钥、全局模型目录和工作流并发由管理员维护。
 3. 新项目按“确认名称/用途 → `project create` → `project get` + 一次 `canvas inspect`”执行；既有项目先聚合读取。项目配置回读通过前不得创建创作节点。
 4. `canvas settings get` 必须确认项目覆盖值、继承后的有效值、来源和实时候选。默认推荐 `storyboardImageType: grid`；`visualBible` 按实时 schema 构造。`outputLanguage` 必须与用户确认的交付语言一致；“自动”只适合用户明确要求跟随输入且源剧本语言单一的普通拆镜。CLI `--locale` 只影响命令界面和输出消息，不代表内容语言。
 5. `imageResolution`、`imageQuality`、`videoResolution` 优先由项目统一设置；节点只有确需不同且实时能力允许时才覆盖。H3 模型必须与 `videoPromptType: "h3"` 同次写入。