@aswless_854771076/ai_short_studio_cli 0.1.95 → 0.1.97

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

@@ -1,6 +1,25 @@
 import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../../base-command.js';
 import { commandApi, mapConcurrent, projectFlag } from '../../../command-helpers.js';
+/**
+ * P1-2 契约：调用方必须能从 stdout JSON 直接区分
+ * 「已等待到终态」与「仅提交、仍在服务端排队」。
+ * 因此每次输出都带 waited / pending / pendingNodeIds / reason，
+ * 不再允许出现「空 tasks + exit 0」这种伪装成同步完成的输出。
+ */
+export function withWaitState(payload, state) {
+    const base = payload && typeof payload === 'object' && !Array.isArray(payload)
+        ? payload
+        : { result: payload };
+    const pending = state.pendingNodeIds.length > 0;
+    return {
+        ...base,
+        waited: state.waited,
+        pending,
+        ...(pending ? { pendingNodeIds: state.pendingNodeIds } : {}),
+        ...(state.reason ? { reason: state.reason } : {}),
+    };
+}
 export default class CanvasNodeRun extends BaseCommand {
     static args = { nodeId: Args.string({ required: false }) };
     static flags = {
@@ -39,11 +58,16 @@ export default class CanvasNodeRun extends BaseCommand {
             result: await api.runNode(flags.project, nodeId),
         }));
         if (!flags.wait) {
-            this.print(nodeIds.length === 1 ? submissions[0].result : { submissions });
+            const payload = nodeIds.length === 1 ? submissions[0].result : { submissions };
+            this.print(withWaitState(payload, { waited: false, pendingNodeIds: nodeIds, reason: '未传 --wait，任务仅已提交，仍在服务端排队' }));
             return;
         }
         const maxWaitMs = flags['max-wait-ms'] > 0 ? flags['max-wait-ms'] : Number.POSITIVE_INFINITY;
+        // 病灶（P1-2）：旧实现用 filter 静默丢掉没有 task.id 的提交项，
+        // tasks 变成空数组后命令打印 {"tasks": []} 并 exit 0，agent 误以为已同步完成。
+        // 现在缺 task.id 的节点必须进 pendingNodeIds 并让命令以非零码退出。
         const tasks = submissions.filter((item) => item.result.task?.id);
+        const pendingNodeIds = submissions.filter((item) => !item.result.task?.id).map((item) => item.nodeId);
         const completed = await mapConcurrent(tasks, flags.concurrency, async (item) => {
             let currentSubmission = item.result;
             let attempt = 0;
@@ -99,8 +123,22 @@ export default class CanvasNodeRun extends BaseCommand {
                 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'))
+        // 有节点缺 task.id：这些任务确实已提交但 CLI 无从轮询，不能装作等到了。
+        const incomplete = completed.filter((item) => item.task.status !== 'completed');
+        const payload = nodeIds.length === 1 && !pendingNodeIds.length
+            ? completed[0]
+            : { submissions, tasks: completed };
+        const pendingReason = pendingNodeIds.length
+            ? `服务端提交响应缺少 task id，无法轮询：${pendingNodeIds.join(', ')}`
+            : '';
+        this.print(withWaitState(payload, {
+            waited: !pendingNodeIds.length,
+            pendingNodeIds,
+            reason: pendingReason,
+        }));
+        if (pendingNodeIds.length)
+            this.error(`部分节点未返回 task id，任务仍可能在服务端排队：${pendingReason}`, { exit: 8 });
+        if (incomplete.length)
             this.error('部分任务未成功完成', { exit: 8 });
         // --auto-select-version：节点成功跑完后，若 task.result 含 assetId + versionId，
         // 自动调 canvas asset select-version，让下游 cvd 节点能读到 character profile。

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

@@ -10,6 +10,7 @@ export default class CanvasNodeTypes extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/canvas/node/update-many.d.ts

@@ -9,6 +9,7 @@ export default class CanvasNodeUpdateMany extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

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

@@ -16,6 +16,7 @@ export default class CanvasNodeUpdate extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/canvas/settings/get.d.ts

@@ -7,6 +7,7 @@ export default class CanvasSettingsGet extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/canvas/settings/set.d.ts

@@ -7,17 +7,41 @@ type CanvasSettingsFlags = {
 type ReadInput = (file?: string) => Promise<Record<string, unknown>>;
 export declare function parseSettingFlagValue(value: string): unknown;
 export declare function buildCanvasSettingsInput(flags: CanvasSettingsFlags, readInput?: ReadInput): Promise<Record<string, unknown>>;
+/**
+ * 服务端把 productionCanvas.version 同时当作画布版本与 settings 乐观锁
+ * （src/lib/freeform-canvas/settings.ts），而任何画布节点写入都会 +1 这个 version。
+ * 因此 CLI 不能把「上一步读到的版本号」当成稳定基线：
+ * - 未显式给 expectedVersion：写前重读一次当前版本，冲突后最多自动重试 1 次；
+ * - 显式给 expectedVersion（含 --file/stdin 里自带该字段）：保持严格乐观锁，
+ *   绝不静默重试，否则用户主动声明的并发保护会被悄悄绕过。
+ */
+export declare function isVersionConflict(error: unknown): boolean;
+export interface CanvasSettingsWriteApi {
+    canvasSettings(projectId: string): Promise<Record<string, unknown>>;
+    updateCanvasSettings(projectId: string, input: Record<string, unknown>): Promise<Record<string, unknown>>;
+}
+export declare function writeCanvasSettingsWithVersionGuard(input: {
+    api: CanvasSettingsWriteApi;
+    projectId: string;
+    input: Record<string, unknown>;
+    explicitVersion?: number;
+}): Promise<{
+    response: Record<string, unknown>;
+    retriedAfterConflict: boolean;
+}>;
 export default class CanvasSettingsSet extends BaseCommand {
     static flags: {
         project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         field: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         value: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'expected-version': import("@oclif/core/interfaces").OptionFlag<number | 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>;
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/canvas/settings/set.js

@@ -1,5 +1,6 @@
 import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../../base-command.js';
+import { CliApiError } from '../../../client/errors.js';
 import { commandApi, projectFlag, readJsonInput } from '../../../command-helpers.js';
 export function parseSettingFlagValue(value) {
     const input = value.trim();
@@ -39,6 +40,49 @@ export async function buildCanvasSettingsInput(flags, readInput = readJsonInput)
         return { values: { [flags.field]: parseSettingFlagValue(flags.value) } };
     return readInput(flags.file);
 }
+/**
+ * 服务端把 productionCanvas.version 同时当作画布版本与 settings 乐观锁
+ * （src/lib/freeform-canvas/settings.ts），而任何画布节点写入都会 +1 这个 version。
+ * 因此 CLI 不能把「上一步读到的版本号」当成稳定基线：
+ * - 未显式给 expectedVersion：写前重读一次当前版本，冲突后最多自动重试 1 次；
+ * - 显式给 expectedVersion（含 --file/stdin 里自带该字段）：保持严格乐观锁，
+ *   绝不静默重试，否则用户主动声明的并发保护会被悄悄绕过。
+ */
+export function isVersionConflict(error) {
+    return error instanceof CliApiError && error.status === 409;
+}
+function readSettingsVersion(response) {
+    const data = response?.data;
+    const version = data && typeof data === 'object' && !Array.isArray(data)
+        ? data.version
+        : undefined;
+    return typeof version === 'number' ? version : undefined;
+}
+export async function writeCanvasSettingsWithVersionGuard(input) {
+    const { api, projectId } = input;
+    // 显式版本：严格模式，不预读也不重试。
+    if (input.explicitVersion !== undefined) {
+        return {
+            response: await api.updateCanvasSettings(projectId, { ...input.input, expectedVersion: input.explicitVersion }),
+            retriedAfterConflict: false,
+        };
+    }
+    let expectedVersion = readSettingsVersion(await api.canvasSettings(projectId));
+    try {
+        return {
+            response: await api.updateCanvasSettings(projectId, { ...input.input, expectedVersion }),
+            retriedAfterConflict: false,
+        };
+    }
+    catch (error) {
+        if (!isVersionConflict(error))
+            throw error;
+        // 写入与预读之间又有别的画布写入推进了版本：重读一次再重试，仅此一次。
+        expectedVersion = readSettingsVersion(await api.canvasSettings(projectId));
+        const response = await api.updateCanvasSettings(projectId, { ...input.input, expectedVersion });
+        return { response, retriedAfterConflict: true };
+    }
+}
 export default class CanvasSettingsSet extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
@@ -46,10 +90,25 @@ export default class CanvasSettingsSet extends BaseCommand {
         field: Flags.string({ description: '要更新的设置字段；outputLanguage 支持 pt-BR 等 BCP 47 标签', dependsOn: ['value'], exclusive: ['file'] }),
         value: Flags.string({ description: '字段值', dependsOn: ['field'], exclusive: ['file'] }),
         file: Flags.string({ description: '设置 JSON 文件；省略时读取 stdin', exclusive: ['field', 'value'] }),
+        'expected-version': Flags.integer({
+            description: 'settings 乐观锁版本号。省略时 CLI 先读取当前版本再写，遇版本冲突自动重读重试一次（输出中标注 retriedAfterConflict）。显式传入则保持严格乐观锁，不预读、不重试。',
+            min: 0,
+        }),
     };
     async run() {
         const { flags } = await this.parse(CanvasSettingsSet);
         const { api } = await commandApi(flags);
-        this.print(await api.updateCanvasSettings(flags.project, await buildCanvasSettingsInput(flags)));
+        const settingsInput = await buildCanvasSettingsInput(flags);
+        const inputVersion = typeof settingsInput.expectedVersion === 'number'
+            ? settingsInput.expectedVersion
+            : undefined;
+        const explicitVersion = flags['expected-version'] ?? inputVersion;
+        const { response, retriedAfterConflict } = await writeCanvasSettingsWithVersionGuard({
+            api,
+            projectId: flags.project,
+            input: settingsInput,
+            explicitVersion,
+        });
+        this.print(retriedAfterConflict ? { ...response, retriedAfterConflict: true } : response);
     }
 }

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

@@ -21,6 +21,40 @@ export default class ConfigAiProviderCapabilities extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }
+type ProbeOutcome = 'ok' | 'unknown' | 'failed';
+/**
+ * 探测结果判定（2026-10-09 · ERR-20261009-004 · 报告 P0-6）。
+ *
+ * 服务端对 **RunningHub 协议**的 provider 返回 `{ success: false, reason:
+ * 'comfyui-runninghub-protocol', hint: 'RunningHub 协议无法做连通性测试…',
+ * steps: [{ status: 'skip', httpStatus: 200 }] }` —— 这是「**不可探测**」，不是
+ * 「探测失败」。旧实现只看 `success === true`，把它一律压成 `ok: false`，于是
+ * reachability 报 `failed` 而 detail 是 `skip/200`，读起来自相矛盾
+ * （端到端测试报告记录的就是这个现象）。
+ *
+ * 代价不是「不好看」而是**误导决策**：agent/运维看到 failed 就判定 provider 不可用，
+ * 于是去补环境变量配置、跳过该模型 —— 而真实故障在别处（凭据通道走错，见同 ERR 的
+ * video.ts / adapter.ts 修复）。
+ *
+ * 修法：`skip` 与该 reason **不算失败**，映射为 unknown（与 `--no-reachability` 时同义），
+ * 并把服务端给的 hint 带进 detail，让「为什么不可探测」在报告里直接可读。
+ */
+declare function classifyProbe(result: {
+    success?: boolean;
+    reason?: string;
+    hint?: string;
+    steps?: Array<{
+        status?: string;
+        httpStatus?: number;
+    }>;
+}): {
+    outcome: ProbeOutcome;
+    detail: string;
+};
+/** 测试出口：与 classifyProbe 同函数，仅供单测直接断言三态映射。 */
+export declare const classifyProbeForTest: typeof classifyProbe;
+export {};

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

@@ -68,6 +68,34 @@ export default class ConfigAiProviderCapabilities extends BaseCommand {
         this.print(report);
     }
 }
+/**
+ * 探测结果判定（2026-10-09 · ERR-20261009-004 · 报告 P0-6）。
+ *
+ * 服务端对 **RunningHub 协议**的 provider 返回 `{ success: false, reason:
+ * 'comfyui-runninghub-protocol', hint: 'RunningHub 协议无法做连通性测试…',
+ * steps: [{ status: 'skip', httpStatus: 200 }] }` —— 这是「**不可探测**」，不是
+ * 「探测失败」。旧实现只看 `success === true`，把它一律压成 `ok: false`，于是
+ * reachability 报 `failed` 而 detail 是 `skip/200`，读起来自相矛盾
+ * （端到端测试报告记录的就是这个现象）。
+ *
+ * 代价不是「不好看」而是**误导决策**：agent/运维看到 failed 就判定 provider 不可用，
+ * 于是去补环境变量配置、跳过该模型 —— 而真实故障在别处（凭据通道走错，见同 ERR 的
+ * video.ts / adapter.ts 修复）。
+ *
+ * 修法：`skip` 与该 reason **不算失败**，映射为 unknown（与 `--no-reachability` 时同义），
+ * 并把服务端给的 hint 带进 detail，让「为什么不可探测」在报告里直接可读。
+ */
+function classifyProbe(result) {
+    const steps = result.steps ?? [];
+    const skipped = steps.length > 0 && steps.every((step) => step.status === 'skip');
+    const stepDetail = steps.map((step) => `${step.status ?? 'unknown'}/${step.httpStatus ?? '?'}`).join(', ');
+    if (skipped || result.reason === 'comfyui-runninghub-protocol') {
+        return { outcome: 'unknown', detail: [stepDetail, result.hint].filter(Boolean).join(' · ') };
+    }
+    return { outcome: result.success === true ? 'ok' : 'failed', detail: stepDetail };
+}
+/** 测试出口：与 classifyProbe 同函数，仅供单测直接断言三态映射。 */
+export const classifyProbeForTest = classifyProbe;
 async function probeConcurrently(providers, concurrency, probe) {
     const out = [];
     let cursor = 0;
@@ -77,8 +105,14 @@ async function probeConcurrently(providers, concurrency, probe) {
             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 }]);
+                const { outcome, detail } = classifyProbe(result);
+                // resolveReachability 只读 sample.ok，故 unknown 也用 ok:true 承载，
+                // 并在 detail 加 unknown 前缀让下游（CLI 输出/人读报告）能直接分辨三态。
+                out.push([provider.id, {
+                        ok: outcome !== 'failed',
+                        detail: outcome === 'unknown' ? `unknown · ${detail}` : detail,
+                        durationMs: result.durationMs,
+                    }]);
             }
             catch (error) {
                 out.push([provider.id, { ok: false, detail: error instanceof Error ? error.message : String(error) }]);

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

@@ -16,6 +16,7 @@ export default class ConfigAiProviderGet extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

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

@@ -15,6 +15,7 @@ export default class ConfigAiProviderList extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

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

@@ -16,6 +16,7 @@ export default class ConfigAiProviderModels extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

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

@@ -35,6 +35,7 @@ export default class ConfigAiProviderSet extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

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

@@ -19,6 +19,7 @@ export default class ConfigAiProviderTest extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/config/get.d.ts

@@ -6,6 +6,7 @@ export default class ConfigGet extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/config/set.d.ts

@@ -8,6 +8,7 @@ export default class ConfigSet extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/preflight.d.ts

@@ -8,6 +8,7 @@ export default class Preflight extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/project/create.d.ts

@@ -8,6 +8,7 @@ export default class ProjectCreate extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/project/delete.d.ts

@@ -10,6 +10,7 @@ export default class ProjectDelete extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/project/get.d.ts

@@ -9,6 +9,7 @@ export default class ProjectGet extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/project/list.d.ts

@@ -10,6 +10,7 @@ export default class ProjectList extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/project/provider/get.d.ts

@@ -9,6 +9,7 @@ export default class ProjectProviderGet extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/project/provider/set.d.ts

@@ -10,6 +10,7 @@ export default class ProjectProviderSet extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/project/provider/test.d.ts

@@ -9,6 +9,7 @@ export default class ProjectProviderTest extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/project/update.d.ts

@@ -11,6 +11,7 @@ export default class ProjectUpdate extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/skill/install.d.ts

@@ -11,6 +11,7 @@ export default class SkillInstall extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/skill/install.js

@@ -7,6 +7,7 @@ export default class SkillInstall extends BaseCommand {
     async run() {
         const { flags } = await this.parse(SkillInstall);
         if (flags.directory) {
+            selectedSkillNames(flags.skill);
             this.print(await installSkill({ target: flags.directory, force: flags.force }));
             return;
         }

package/dist/commands/skill/path.d.ts

@@ -10,6 +10,7 @@ export default class SkillPath extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/skill/path.js

@@ -7,6 +7,7 @@ export default class SkillPath extends BaseCommand {
     async run() {
         const { flags } = await this.parse(SkillPath);
         if (flags.directory) {
+            selectedSkillNames(flags.skill);
             this.print({ path: bundledSkillPath(), target: flags.directory });
             return;
         }

package/dist/commands/skill/status.d.ts

@@ -10,6 +10,7 @@ export default class SkillStatus extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/skill/status.js

@@ -6,6 +6,7 @@ export default class SkillStatus extends BaseCommand {
     async run() {
         const { flags } = await this.parse(SkillStatus);
         if (flags.directory) {
+            selectedSkillNames(flags.skill);
             this.print(await skillStatus(flags.directory));
             return;
         }

package/dist/commands/task/cancel.d.ts

@@ -10,6 +10,7 @@ export default class TaskCancel extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/task/get.d.ts

@@ -9,6 +9,7 @@ export default class TaskGet extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/task/wait.d.ts

@@ -13,6 +13,7 @@ export default class TaskWait extends BaseCommand {
         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>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

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

@@ -132,6 +132,9 @@ export declare class VvicatApi {
     }): Promise<JsonObject>;
     disconnect(projectId: string, edgeId: string): Promise<JsonObject>;
     runNode(projectId: string, nodeId: string): Promise<CanvasNodeRunResponse>;
+    quoteNode(projectId: string, nodeId: string): Promise<{
+        quote: JsonObject;
+    }>;
     listAssets(projectId: string, query?: string): Promise<JsonObject>;
     asset(projectId: string, assetId: string): Promise<JsonObject>;
     selectAssetVersion(projectId: string, assetId: string, versionId: string): Promise<JsonObject>;

package/dist/domain/vvicat-api.js

@@ -305,6 +305,9 @@ export class VvicatApi {
     runNode(projectId, nodeId) {
         return this.client.request(`/api/projects/${projectId}/canvas/nodes/${nodeId}/execute`, { method: 'POST' });
     }
+    quoteNode(projectId, nodeId) {
+        return this.client.request(`/api/projects/${projectId}/canvas/nodes/${nodeId}/quote`);
+    }
     listAssets(projectId, query = '') {
         return this.client.request(`/api/projects/${projectId}/canvas/assets${query ? `?${query}` : ''}`);
     }

package/dist/output/formatter.d.ts

@@ -1 +1,12 @@
 export declare function formatJson(value: unknown): string;
+/**
+ * P0-4（应用层旁路）：Windows 控制台 chcp=437 时，进程启动那一刻 stdout 句柄
+ * 已按旧代码页打开，进程内改 Console.OutputEncoding 无效——UTF-8 字节被按
+ * CP437 解码，中文变希腊字母。环境层只能靠 chcp 65001（须在启动 Node 前设置），
+ * 应用层可靠的做法是绕开终端句柄：由 Node 直接以 utf-8 写文件。
+ *
+ * 优先级：--output flag > CLI_OUTPUT_FILE 环境变量 > 不启用（保持原有 stdout 行为）。
+ */
+export declare function resolveOutputFile(flagValue: string | undefined, env?: NodeJS.ProcessEnv): string | undefined;
+/** 以 utf-8 无 BOM 落盘，保证字节级可核对（中文不被转义、不受终端代码页影响）。 */
+export declare function writeCliOutput(file: string, value: unknown): Promise<void>;