gaoding-cli 1.0.0-alpha.7 → 1.0.0-alpha.9

package/dist/src/registry/registry-client.d.ts

@@ -4,25 +4,4 @@ export declare class RegistryClient {
     private client;
     constructor(client: HubClient);
     fetchRegistry(): Promise<RegistryResponse>;
-    getDetail(id: string): Promise<import("./types.js").ToolSpec | import("./types.js").AppSpec>;
-    search(query: string, options?: {
-        type?: string;
-        limit?: number;
-    }): Promise<{
-        results: ({
-            id: string;
-            type: string;
-            display_name: string;
-            description: string;
-            category: "asset" | "text" | "image" | "video" | "agent" | "template" | "infrastructure";
-            spec: import("./types.js").ToolSpec;
-        } | {
-            id: string;
-            type: string;
-            display_name: string;
-            description: string;
-            category: string;
-            spec: import("./types.js").AppSpec;
-        })[];
-    }>;
 }

package/dist/src/registry/registry-client.js

@@ -1,4 +1,4 @@
-import { DIRECT_APPS, DIRECT_REGISTRY, PUBLIC_DIRECT_TOOLS, resolveAppSpec, resolveToolSpec, } from "./direct-registry.js";
+import { DIRECT_REGISTRY } from "./direct-registry.js";
 export class RegistryClient {
     client;
     constructor(client) {
@@ -8,43 +8,4 @@ export class RegistryClient {
         void this.client;
         return DIRECT_REGISTRY;
     }
-    async getDetail(id) {
-        const tool = resolveToolSpec(id);
-        if (tool)
-            return tool;
-        const app = resolveAppSpec(id);
-        if (app)
-            return app;
-        throw new Error(`未找到能力: ${id}`);
-    }
-    async search(query, options) {
-        const q = query.trim().toLowerCase();
-        const toolResults = PUBLIC_DIRECT_TOOLS.map((spec) => ({
-            id: spec.name,
-            type: "tool",
-            display_name: spec.display_name,
-            description: spec.description,
-            category: spec.category,
-            spec,
-        }));
-        const appResults = DIRECT_APPS.map((spec) => ({
-            id: spec.id,
-            type: "app",
-            display_name: spec.name,
-            description: spec.description,
-            category: spec.category,
-            spec,
-        }));
-        const all = [
-            ...(!options?.type || options.type === "tool" ? toolResults : []),
-            ...(!options?.type || options.type === "app" ? appResults : []),
-        ].filter((item) => {
-            if (!q)
-                return true;
-            return (item.id.toLowerCase().includes(q) ||
-                item.display_name.toLowerCase().includes(q) ||
-                item.description.toLowerCase().includes(q));
-        });
-        return { results: all.slice(0, options?.limit ?? all.length) };
-    }
 }

package/dist/src/utils/capability-presenter.js

@@ -1,13 +1,11 @@
 import chalk from "chalk";
 export function printCapabilitySchema(payload) {
     const id = stringValue(payload.id);
-    const type = stringValue(payload.type);
-    const namespace = namespaceForType(type);
     const title = stringValue(payload.title) || id;
     const category = stringValue(payload.category);
     const description = stringValue(payload.description);
     console.log(chalk.bold(`${title} (${id})`));
-    console.log(`类型: ${labelForType(type)}`);
+    console.log("类型: Workflow 场景");
     if (category)
         console.log(`分类: ${category}`);
     if (description)
@@ -27,23 +25,18 @@ export function printCapabilitySchema(payload) {
     const stdin = recordValue(payload.stdin);
     const stdinCommand = stringValue(stdin?.command);
     const canonicalCommand = stringValue(payload.canonical_command);
-    const fallbackCommand = type === "workflow"
-        ? `gd-cli workflows run ${id} --input input.json --format json`
-        : `gd-cli ${namespace} call ${id} --input input.json --format json`;
+    const fallbackCommand = `gd-cli workflows run ${id} --input input.json --json`;
     console.log("");
     console.log(chalk.bold("调用方式:"));
     console.log(`  ${canonicalCommand ?? fallbackCommand}`);
     if (stdinCommand)
         console.log(`  ${stdinCommand}`);
     console.log("");
-    console.log(chalk.bold("Agent:"));
-    console.log(`  gd-cli ${namespace} schema ${id} --format json`);
-    console.log(`  gd-cli ${namespace} examples ${id} --format json`);
+    console.log(`  完整 JSON Schema: gd-cli workflows schema ${id} --json`);
+    console.log(`  调用示例: gd-cli workflows examples ${id}`);
 }
 export function printCapabilityExamples(payload) {
     const id = stringValue(payload.id);
-    const type = stringValue(payload.type);
-    const namespace = namespaceForType(type);
     const title = stringValue(payload.title) || id;
     const category = stringValue(payload.category);
     const description = stringValue(payload.description);
@@ -51,7 +44,7 @@ export function printCapabilityExamples(payload) {
         ? payload.examples.filter(isRecord)
         : [];
     console.log(chalk.bold(`${title} (${id})`));
-    console.log(`类型: ${labelForType(type)}`);
+    console.log("类型: Workflow 场景");
     if (category)
         console.log(`分类: ${category}`);
     if (description)
@@ -74,23 +67,7 @@ export function printCapabilityExamples(payload) {
         }
     });
     console.log("");
-    console.log(chalk.bold("Agent:"));
-    console.log(`  gd-cli ${namespace} examples ${id} --format json`);
-    console.log(`  gd-cli ${namespace} schema ${id} --format json`);
-}
-function namespaceForType(type) {
-    if (type === "workflow")
-        return "workflows";
-    if (type === "skill")
-        return "skills";
-    return "tools";
-}
-function labelForType(type) {
-    if (type === "workflow")
-        return "Workflow 场景";
-    if (type === "skill")
-        return "Skill 说明";
-    return "Tool 能力";
+    console.log(`完整 JSON Schema: gd-cli workflows schema ${id} --json`);
 }
 function printSchemaFields(title, schema, kind) {
     console.log(chalk.bold(`${title}:`));

package/dist/src/utils/config.d.ts

@@ -5,9 +5,9 @@ export declare const PROD_API_BASE = "https://gdcli.gaoding.com/api";
 export declare const GDHUB_DIR: string;
 /** Migrate credentials from the early internal storage directory when present. */
 export declare function migrateCredentialsIfNeeded(): void;
-export declare const CLI_VERSION = "1.0.0-alpha.7";
+export declare const CLI_VERSION = "1.0.0-alpha.9";
 export declare const CLI_PACKAGE_NAME = "gaoding-cli";
-export declare const CLI_USER_AGENT = "gd-cli/1.0.0-alpha.7";
+export declare const CLI_USER_AGENT = "gd-cli/1.0.0-alpha.9";
 export declare const GDHUB_CLI_CLIENT_ID = "gdhub-cli";
 export declare const DEFAULT_SCOPE: readonly ["scene-executor", "run:scene-app", "use:tools", "export", "read:public"];
 export declare const CACHE_TTL_MS: number;

package/dist/src/utils/config.js

@@ -32,7 +32,7 @@ export function migrateCredentialsIfNeeded() {
 function readEnv(key, legacyKey) {
     return process.env[key] ?? process.env[legacyKey];
 }
-export const CLI_VERSION = "1.0.0-alpha.7";
+export const CLI_VERSION = "1.0.0-alpha.9";
 export const CLI_PACKAGE_NAME = "gaoding-cli";
 export const CLI_USER_AGENT = `gd-cli/${CLI_VERSION}`;
 export const GDHUB_CLI_CLIENT_ID = "gdhub-cli";

package/dist/src/utils/help-verify.d.ts

@@ -1,9 +1,7 @@
 import type { Command } from "commander";
 /**
- * 在命令 `-h` 底部追加一段「快速验证」单行示例（用于具体 Tool / Workflow 子命令）。
+ * 在命令 `-h` 底部追加一段「快速验证」单行示例（用于 Workflow 子命令）。
  */
 export declare function appendVerifySnippet(cmd: Command, line: string): void;
-/** 按工具 id 附加对应示例；无映射则不加（避免误导） */
-export declare function appendToolQuickExample(cmd: Command, toolName: string): void;
 /** `gd-cli workflows run -h` 专用 */
 export declare function appendAppRunQuickExample(cmd: Command, _legacyPrefix?: string): void;

package/dist/src/utils/help-verify.js

@@ -1,23 +1,6 @@
-/** 各工具一条可复制命令（与 registry 中 tool id 一致） */
-const TOOL_QUICK_LINES = {
-    "asset.upload": "gd-cli tools call upload --file ./demo.jpg -f json",
-    upload: "gd-cli tools call upload --file ./demo.jpg -f json",
-    chat: 'gd-cli tools call chat --prompt "运动品牌主图要点" -f json',
-    cutout: "gd-cli tools call cutout --image https://www.gaoding.art/favicon.ico -f json",
-    title: 'gd-cli tools call title --prompt "北欧实木餐桌" -f json',
-    prompt: 'gd-cli tools call prompt --prompt "一只猫" -f json',
-    generate: 'gd-cli tools call generate --prompt "产品白底图，极简" --ratio 1:1 -f json',
-    edit: "gd-cli tools call edit --image https://www.gaoding.art/favicon.ico --style <风格> -f json",
-    expand: "gd-cli tools call expand --image https://www.gaoding.art/favicon.ico --width 1920 --height 1080 -f json",
-    erase: "gd-cli tools call erase --image https://www.gaoding.art/favicon.ico --mask https://example.com/mask.png -f json",
-    upscale: "gd-cli tools call upscale --image https://www.gaoding.art/favicon.ico -f json",
-    vectorize: "gd-cli tools call vectorize --image https://www.gaoding.art/favicon.ico -f json",
-    video: 'gd-cli tools call video --prompt "运动品牌短片" -f json',
-    "video-hd": "gd-cli tools call video-hd --file https://example.com/video.mp4 -f json",
-};
 const APP_RUN_QUICK_LINE = 'gd-cli workflows run listing-gallery --image ./product.jpg --brief "运动鞋" -f json';
 /**
- * 在命令 `-h` 底部追加一段「快速验证」单行示例（用于具体 Tool / Workflow 子命令）。
+ * 在命令 `-h` 底部追加一段「快速验证」单行示例（用于 Workflow 子命令）。
  */
 export function appendVerifySnippet(cmd, line) {
     const text = `
@@ -27,13 +10,6 @@ ${line.trim()}
 `;
     cmd.addHelpText("after", text);
 }
-/** 按工具 id 附加对应示例；无映射则不加（避免误导） */
-export function appendToolQuickExample(cmd, toolName) {
-    const line = TOOL_QUICK_LINES[toolName];
-    if (!line)
-        return;
-    appendVerifySnippet(cmd, line);
-}
 /** `gd-cli workflows run -h` 专用 */
 export function appendAppRunQuickExample(cmd, _legacyPrefix) {
     void _legacyPrefix;

package/dist/src/utils/sensitive-path.js

@@ -29,7 +29,7 @@ const SENSITIVE_FILENAMES = new Set([
 ]);
 export function assertSafeUploadPath(file, options = {}) {
     const absolutePath = path.resolve(process.cwd(), file);
-    if (allowSensitive(options))
+    if (options.allowSensitivePath === true)
         return absolutePath;
     const reason = sensitivePathReason(absolutePath);
     if (reason) {
@@ -64,6 +64,3 @@ export function sensitivePathReason(file) {
     }
     return null;
 }
-function allowSensitive(options) {
-    return options.allowSensitivePath === true || process.env.GD_CLI_ALLOW_SENSITIVE_PATHS === "1";
-}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "gaoding-cli",
-  "version": "1.0.0-alpha.7",
-  "description": "稿定 GD CLI - Tools / Workflows / DAM 命令行工具",
+  "version": "1.0.0-alpha.9",
+  "description": "稿定 GD CLI - Creative / Workflows / DAM 命令行工具",
   "license": "MIT",
   "author": "Gaoding",
   "type": "module",
@@ -59,6 +59,7 @@
     "@types/node": "^22.14.1",
     "@types/qrcode": "^1.5.6",
     "@types/uuid": "^10.0.0",
+    "ajv": "^8.20.0",
     "eslint": "^9.24.0",
     "tsx": "^4.19.4",
     "typescript": "^5.8.3",
@@ -78,7 +79,7 @@
     "gd-cli",
     "cli",
     "visual-creation",
-    "ai-tools",
+    "creative",
     "dam"
   ]
 }

package/skills/gd-cli/SKILL.md

@@ -7,7 +7,7 @@ description: 当用户需要使用稿定生成图片、视频、电商素材或
 
 ## 执行原则
 
-当用户提出图片、视频、电商物料或 DAM 素材需求时，优先使用本地 `gd-cli` 调用稿定能力。不要因为当前 Agent 的工具列表中没有稿定工具，就改用本地 Canvas、ffmpeg、SVG 或未文档化接口。
+当用户提出图片、视频、电商物料或 DAM 素材需求时，优先使用本地 `gd-cli`。不要因当前 Agent 的能力列表中没有稿定入口，就改用本地 Canvas、ffmpeg、SVG 或未文档化接口。
 
 开始执行前：
 
@@ -18,31 +18,32 @@ description: 当用户需要使用稿定生成图片、视频、电商素材或
 - 错误处理和停止规则读 `references/errors.md`。
 - 图片、视频和交付包处理读 `references/deliverables.md`。
 - CLI 与 Skill 升级读 `references/update.md`。
-- 单点能力读 `references/tools.md`，多步骤场景读 `references/workflows.md`。
+- 统一创作读 `references/creative.md`，多步骤场景读 `references/workflows.md`。
 
-Agent 只根据公开的 `tools`、`workflows` 和 `dam` 命令完成用户需求。普通生成任务中不要切换组织、环境或模型，不要调用内部运行时类、`raw.dify` 或未文档化接口。
+Agent 只根据公开的 `creative`、`workflows` 和 `dam` 命令完成用户需求。普通生成任务中不要切换组织、环境或模型，也不要调用内部运行时类或未文档化接口。
 
 ## 能力选择
 
-先读取能力列表，再按用户意图匹配：
+先读取 Creative 契约和 Workflow 列表，再按用户意图组织输入：
 
 ```bash
-gd-cli tools list --format json
-gd-cli workflows list --format json
+gd-cli creative schema --json
+gd-cli creative examples
+gd-cli workflows list --json
 ```
 
 | 用户意图 | 命令 |
 | --- | --- |
-| 生图、商品主图、海报、场景图 | `gd-cli tools call image.generate` |
-| 抠图、去背景、透明底 | `gd-cli tools call image.cutout` |
-| 高清、放大、变清晰 | `gd-cli tools call image.super-res` |
-| 文生视频、图生视频、动画短片 | `gd-cli tools call video.generate` |
+| 生图、商品主图、海报、场景图 | `gd-cli creative run --prompt "..."` |
+| 抠图、去背景、透明底 | `gd-cli creative run --input request.json` |
+| 高清、放大、变清晰 | `gd-cli creative run --input request.json` |
+| 文生视频、图生视频、动画短片 | `gd-cli creative run --input request.json` |
 | Listing、商品图库、上架素材 | `gd-cli workflows run listing-gallery` |
 | 详情页、A+、PDP | `gd-cli workflows run pdp-a-plus` |
 | 小红书种草图文 | `gd-cli workflows run social-seeding-pack` |
 | Campaign KV、多渠道素材 | `gd-cli workflows run campaign-kv-pack` |
 
-复杂输入优先通过 `--input <json-file>` 或 stdin 传入。Agent 解析结果时使用 `--format json`，最终回复按 `references/deliverables.md` 展示预览、链接或文件，不要直接转发整段原始 JSON。
+复杂输入优先通过 `--input <json-file>` 或 stdin 传入。只在该命令支持时传入 `--json`；最终回复按 `references/deliverables.md` 展示预览、链接或文件，不要直接转发整段原始 JSON。
 
 ## 参考资料
 
@@ -53,5 +54,5 @@ gd-cli workflows list --format json
 - `references/errors.md`
 - `references/deliverables.md`
 - `references/update.md`
-- `references/tools.md`
+- `references/creative.md`
 - `references/workflows.md`

package/skills/gd-cli/references/auth.md

@@ -5,22 +5,21 @@
 在 Agent 或非 TTY Shell 中执行：
 
 ```bash
-gd-cli auth login --no-browser --format json
+gd-cli auth login --no-browser
 ```
 
-命令会输出包含以下字段的授权信息：
-
-- `type=device_authorization`
-- `verification_uri_complete`
-- `expires_in`
-- `interval`
-
-Agent 必须立即把 `verification_uri_complete` 原样发送给用户，并保持授权进程运行。用户完成授权后，再执行：
+登录命令只输出面向人的授权信息。Agent 必须从输出中提取授权 URL，原样发送给用户，并保持授权进程运行。用户完成授权后，再执行：
 
 ```bash
-gd-cli auth status --format json
+gd-cli auth status --json
 ```
 
+状态输出只区分登录凭证与当前组织：
+
+- `logged_in=false`：执行 `gd-cli auth login`。
+- `logged_in=true` 且 `organization=null`：凭证仍有效，按 `org.md` 让用户选择当前组织。
+- `organization` 存在时只读取公开的 `id` 和 `name`，不要依赖其他未公开字段。
+
 ## 禁止动作
 
 - 不向用户索要 Token、Cookie 或 AK/SK。

package/skills/gd-cli/references/creative.md

@@ -0,0 +1,47 @@
+# GD CLI Creative
+
+Creative 是统一的创作入口。使用者只描述期望的最终结果并提供必要素材与约束，不需要选择具体实现能力。
+
+## 发现契约
+
+```bash
+gd-cli creative schema --json
+gd-cli creative examples
+```
+
+`creative schema` 是本地静态输出；`creative examples` 输出完整可运行的 shell 命令，两者都不请求生成接口。
+
+## 发起创作
+
+纯文本请求：
+
+```bash
+gd-cli creative run --prompt "为轻量跑鞋写三条简洁的电商标题" --json
+```
+
+需要媒体、比例、分辨率、时长或连续会话时，把完整 JSON 写入文件或 stdin：
+
+```bash
+gd-cli creative run --input request.json --json
+cat request.json | gd-cli creative run --input - --json
+```
+
+输入中使用：
+
+- `prompt` 描述主体、用途、内容、风格、场景、构图或镜头，以及必须保留和避免的事项。
+- `media[]` 传入本地路径或 HTTP(S) URL，并用 `role` 标明 `reference`、`first_frame` 或 `last_frame`。
+- `parameters` 传入可结构化表达的 `ratio`、`resolution` 和 `duration_seconds`。
+- `conversation_id` 仅在继续已有创作或回答追问时传入；首次请求不传。
+- 回答追问时传入上一次结果中的 `question_message_id` 和 `answers[]`。`answers[].values` 可以是推荐选项之外的自定义值。
+
+`media` 不能单独提交；`first_frame` 和 `last_frame` 各最多一份且必须是图片。视频、音频只能作为 `reference`。
+
+## 解析结果
+
+机器调用只读取一次最终 JSON：
+
+- `status=completed` 且 `data.finish_reason=completed`：本轮完成。
+- `status=completed` 且 `data.finish_reason=requires_input`：按 `data.questions` 组织回答，并将 `conversation_id`、`question_message_id` 原样带回下一次请求。
+- `status=failed`：读取 `error.code`、`error.message`、`error.hint` 和 `error.retryable`，按 `references/errors.md` 处理。
+
+CLI 只输出一次最终结果，不输出中间过程。最终媒体位于 `data.outputs[]`，文本位于 `data.message` 或 `data.outputs[]` 的 `type=text` 项。

package/skills/gd-cli/references/entitlement.md

@@ -12,10 +12,10 @@
 
 ## 查询稿豆余额
 
-用户询问剩余稿豆、权益余额、还能生成几次或 usage 时，执行：
+用户询问剩余稿豆、权益余额或还能生成几次时，执行：
 
 ```bash
-gd-cli usage --format json
+gd-cli org credits --json
 ```
 
-只根据 `organization`、`credits.total`、`credits.used`、`credits.wait` 和 `credits.surplus` 回复。若用户要求查看其他组织，先执行 `gd-cli org list --format json`，等待用户明确选择后再切换。
+只根据 `organization`、`credits.total`、`credits.used`、`credits.wait` 和 `credits.surplus` 回复。若用户要求查看其他组织，先执行 `gd-cli org list --json`，等待用户明确选择后再切换。

package/skills/gd-cli/references/errors.md

@@ -2,15 +2,22 @@
 
 ## 停止规则
 
-1. 命令非零退出时，先解析 stdout 中的 JSON envelope。
+1. 机器可读调用非零退出时，解析 stdout 中的 JSON envelope。
 2. 优先读取 `error.code`、`error.message`、`error.hint`、`error.next_steps`、`pricing_url` 和 `retryable`。
 3. `retryable=false` 或未提供 `retryable` 时，不重复执行同一失败命令。
 4. 只有 `NETWORK_TRANSIENT` 可以短暂重试一次；第二次失败必须停止。
-5. `TOOL_ROUTE_UNAVAILABLE`、`ENTITLEMENT_INSUFFICIENT`、参数错误、授权错误和组织错误都不能盲目重试。
+5. 内部路由不可用、权益不足、参数错误、授权错误和组织错误都不能盲目重试。
 
 ## 禁止扩展诊断
 
-除非用户明确要求诊断，否则失败后不要切换组织、模型或环境，不查询 `raw.dify`，也不探测未文档化接口。
+除非用户明确要求诊断，否则失败后不要切换组织、模型或环境，也不探测未文档化接口。
+
+## 授权与当前组织
+
+- `AUTH_MISSING`、`AUTH_EXPIRED`：停止当前操作，按 `auth.md` 让用户登录。
+- `ORG_REQUIRED`：执行 `gd-cli org list --json`，等待用户明确选择后再执行 `org switch`。
+- `ORG_INVALID`：当前组织已被 CLI 清除；重新列出组织并等待用户选择，不自动重放刚才的生成或 DAM 操作。
+- CLI 会在需要时内部维护当前组织访问；不要读取或解释内部刷新时间，也不要要求用户为此反复切换组织。
 
 ## 回复结构
 

package/skills/gd-cli/references/org.md

@@ -5,14 +5,14 @@
 Agent 可以读取组织，但不能替用户选择组织：
 
 ```bash
-gd-cli org list --format json
-gd-cli org current --format json
+gd-cli org list --json
+gd-cli org current --json
 ```
 
 只有用户明确选择具体组织后，才执行：
 
 ```bash
-gd-cli org switch --org <org-id> --format json
+gd-cli org switch --org <org-id>
 ```
 
 如果 `org list` 返回多个组织，向用户列出组织名称、组织 ID 和当前状态，然后等待选择。不要根据名称、权益、历史记录或猜测自动切换。

package/skills/gd-cli/references/sop.md

@@ -3,23 +3,23 @@
 ## 总规则
 
 1. 用户要图片、视频、电商物料或 DAM 素材时，优先使用 `gd-cli`。
-2. 需要解析结果、错误、URL、`task_id` 或 schema 时，使用 `--format json`。
+2. 仅在目标叶命令支持时使用 `--json` 解析结果、错误、URL、`task_id` 或 Schema；非 TTY 不会自动启用 JSON。
 3. stdout JSON 用于解析结果，stderr 仅用于进度和排错。
-4. 普通生成任务只使用公开的 `tools`、`workflows` 和 `dam` 命令。
+4. 普通生成任务只使用公开的 `creative`、`workflows` 和 `dam` 命令。
 5. 不替用户切换组织、环境或模型；涉及账号、组织、充值或授权时，把选择交给用户。
 
 ## 推荐流程
 
-1. 必要时执行 `gd-cli auth status --format json` 检查授权状态。
-2. 未登录时按 `auth.md` 发起授权，并立即把授权链接交给用户。
-3. 使用 `gd-cli manifest --format json`、`gd-cli tools list --format json` 和 `gd-cli workflows list --format json` 发现能力。
-4. 单项处理选择 Tool，多步骤交付选择 Workflow。
+1. 必要时执行 `gd-cli auth status --json` 检查授权状态。
+2. 未登录时按 `auth.md` 执行 `gd-cli auth login --no-browser`，从人类输出提取授权 URL 并原样发送给用户。
+3. 使用 `gd-cli creative schema --json`、`gd-cli creative examples` 和 `gd-cli workflows list --json` 发现能力。
+4. 图片、视频和文本创作统一使用 Creative，多步骤交付使用 Workflow。
 5. 执行命令后等待终态，解析 `status`、`outputs`、`assets`、`task_id` 和交付路径。
 6. 按 `deliverables.md` 交付预览、链接、本地文件或完整交付包。
 
 ## 调用边界
 
 - 用户未指定模型时，直接调用目标能力，不主动查询或切换模型。
-- 用户未要求诊断时，不探测内部 endpoint、工具路由或组织权限。
+- 用户未要求诊断时，不探测内部 endpoint、能力路由或组织权限。
 - 一次调用失败后按 `errors.md` 处理，不扩展为无关诊断。
-- Workflow 可能连续调用多个 Tool；不要在 Workflow 运行中并行发起重复任务。
+- Workflow 可能连续调用多个内部能力；不要在 Workflow 运行中并行发起重复任务。

package/skills/gd-cli/references/update.md

@@ -3,14 +3,15 @@
 ## 检查和升级 CLI
 
 ```bash
-gd-cli update check --format json
 gd-cli update
 ```
 
-CLI 升级完成后，显式刷新已安装的 Agent Skill：
+`update` 没有子命令或选项，会检查最新版本并在全局安装场景执行升级。CLI 升级完成后，仅在已安装 canonical Skill 时刷新该 Skill。
+
+也可单独刷新已安装的 Agent Skill：
 
 ```bash
 gd-cli skills update
 ```
 
-如果结果中 `restart_required=true`，提示用户重启 Agent 或开启新会话。没有写入变化时，不要求用户重启。
+只有安装内容确实变化时，才提示用户重启 Agent 或开启新会话。

package/skills/gd-cli/references/workflows.md

@@ -1,17 +1,18 @@
 # GD CLI Workflows
 
-Workflow 编排多个 Tool，适合需要一组完整交付物的业务场景。
+Workflow 编排预定义步骤和内部能力，适合需要一组完整交付物的业务场景。
 
 发现和执行：
 
 ```bash
-gd-cli workflows list --format json
-gd-cli workflows info <workflow-id> --format json
-gd-cli workflows schema <workflow-id> --format json
-gd-cli workflows examples <workflow-id> --format json
-gd-cli workflows run <workflow-id> --input brief.json --format json
+gd-cli workflows list --json
+gd-cli workflows schema <workflow-id> --json
+gd-cli workflows examples <workflow-id>
+gd-cli workflows run <workflow-id> --input brief.json --json
 ```
 
+`examples` 输出完整可运行命令，不支持 JSON 输出。`list`、`schema` 和 `run` 仅在显式传入 `--json` 时输出机器可读结果。
+
 | Workflow ID | 场景 | 交付内容 |
 | --- | --- | --- |
 | `listing-gallery` | Listing、商品图库、上架素材 | 白底主图、卖点图、细节图、场景图和文案 |

package/dist/src/commands/models.d.ts

@@ -1,2 +0,0 @@
-import { Command } from "commander";
-export declare function registerModelsCommand(program: Command): void;

package/dist/src/commands/models.js

@@ -1,78 +0,0 @@
-import { formatOutput } from "../middleware/output.js";
-import { withErrorHandler } from "../middleware/error-handler.js";
-import { Prompt } from "../core/prompt/index.js";
-import { resolveInvokeOutputFormat, resolveListOutputFormat } from "../utils/list-output-format.js";
-import { getConfiguredModel, getDefaultModelOrder, listModels, modelEntriesForType, parseModelType, publicModelByCode, resolveModelOrder, setConfiguredModel, } from "../models/model-catalog.js";
-export function registerModelsCommand(program) {
-    const models = program
-        .command("models", { hidden: true })
-        .description("模型选择（Agent 入口）")
-        .configureHelp({ showGlobalOptions: true });
-    models
-        .command("list")
-        .description("列出可选图像/视频模型")
-        .requiredOption("--type <type>", "image / video")
-        .action(withErrorHandler(async (options, command) => {
-        const cmd = command;
-        const type = parseModelType(options.type);
-        const selected = getConfiguredModel(type);
-        const payload = {
-            type,
-            current: {
-                mode: selected === "auto" ? "auto" : "manual",
-                model: selected === "auto" ? undefined : publicModelByCode(type, selected),
-                effective_order: resolveModelOrder(type),
-            },
-            default_order: getDefaultModelOrder(type),
-            models: listModels(type),
-        };
-        const format = resolveListOutputFormat(cmd);
-        if (format === "json") {
-            formatOutput(payload, "json");
-        }
-        else {
-            formatOutput(payload.models, format);
-        }
-    }));
-    models
-        .command("switch")
-        .description("切换默认图像/视频模型")
-        .requiredOption("--type <type>", "image / video")
-        .option("--model <model>", "模型 code / 名称 / auto")
-        .action(withErrorHandler(async (options, command) => {
-        const cmd = command;
-        const opts = options;
-        const type = parseModelType(opts.type);
-        const model = typeof opts.model === "string" && opts.model.trim()
-            ? opts.model.trim()
-            : await promptModel(type);
-        const selected = setConfiguredModel(type, model);
-        const payload = {
-            type,
-            selected: selected === "auto"
-                ? { mode: "auto" }
-                : { mode: "manual", model: publicModelByCode(type, selected) },
-            effective_order: resolveModelOrder(type),
-        };
-        formatOutput(payload, resolveInvokeOutputFormat(cmd));
-    }));
-}
-async function promptModel(type) {
-    const current = getConfiguredModel(type);
-    const choices = [
-        {
-            name: current === "auto" ? "auto 当前" : "auto",
-            value: "auto",
-            description: "使用 Web 默认返回顺序和失败兜底",
-        },
-        ...modelEntriesForType(type).map((model) => ({
-            name: current === model.code ? `${model.name} 当前` : model.name,
-            value: model.code,
-            description: `${model.description} / ${model.code} / 消耗${model.cost_level}`,
-        })),
-    ];
-    return Prompt.select({
-        message: `选择默认${type === "image" ? "图像" : "视频"}模型`,
-        choices,
-    });
-}

package/dist/src/commands/tools.d.ts

@@ -1,4 +0,0 @@
-import { Command } from "commander";
-export declare function registerToolsCommand(program: Command): void;
-export declare function runToolCall(toolName: string, input: string | undefined, opts: Record<string, unknown>, cmd: Command): Promise<void>;
-export declare function mergeToolCallOptions(base: Record<string, unknown>, opts: Record<string, unknown>): Record<string, unknown>;