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

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.8";
+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.8";
+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.8";
+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/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,6 +1,6 @@
 {
   "name": "gaoding-cli",
-  "version": "1.0.0-alpha.8",
+  "version": "1.0.0-alpha.9",
   "description": "稿定 GD CLI - Creative / Workflows / DAM 命令行工具",
   "license": "MIT",
   "author": "Gaoding",
@@ -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",

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 或未文档化接口。
 
 开始执行前：
 
@@ -20,16 +20,16 @@ description: 当用户需要使用稿定生成图片、视频、电商素材或
 - CLI 与 Skill 升级读 `references/update.md`。
 - 统一创作读 `references/creative.md`，多步骤场景读 `references/workflows.md`。
 
-Agent 只根据公开的 `creative`、`workflows` 和 `dam` 命令完成用户需求。普通生成任务中不要切换组织、环境或模型，不要调用内部运行时类、`raw.dify` 或未文档化接口。
+Agent 只根据公开的 `creative`、`workflows` 和 `dam` 命令完成用户需求。普通生成任务中不要切换组织、环境或模型，也不要调用内部运行时类或未文档化接口。
 
 ## 能力选择
 
 先读取 Creative 契约和 Workflow 列表，再按用户意图组织输入：
 
 ```bash
-gd-cli creative schema --format json
-gd-cli creative examples --format json
-gd-cli workflows list --format json
+gd-cli creative schema --json
+gd-cli creative examples
+gd-cli workflows list --json
 ```
 
 | 用户意图 | 命令 |
@@ -43,7 +43,7 @@ gd-cli workflows list --format json
 | 小红书种草图文 | `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。
 
 ## 参考资料
 

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

@@ -5,20 +5,13 @@
 在 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
 ```
 
 状态输出只区分登录凭证与当前组织：

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

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

@@ -15,7 +15,7 @@
 用户询问剩余稿豆、权益余额或还能生成几次时，执行：
 
 ```bash
-gd-cli org credits --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,20 +2,20 @@
 
 ## 停止规则
 
-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 --format json`，等待用户明确选择后再执行 `org switch`。
+- `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,16 +3,16 @@
 ## 总规则
 
 1. 用户要图片、视频、电商物料或 DAM 素材时，优先使用 `gd-cli`。
-2. 需要解析结果、错误、URL、`task_id` 或 schema 时，使用 `--format json`。
+2. 仅在目标叶命令支持时使用 `--json` 解析结果、错误、URL、`task_id` 或 Schema；非 TTY 不会自动启用 JSON。
 3. stdout JSON 用于解析结果，stderr 仅用于进度和排错。
 4. 普通生成任务只使用公开的 `creative`、`workflows` 和 `dam` 命令。
 5. 不替用户切换组织、环境或模型；涉及账号、组织、充值或授权时，把选择交给用户。
 
 ## 推荐流程
 
-1. 必要时执行 `gd-cli auth status --format json` 检查授权状态。
-2. 未登录时按 `auth.md` 发起授权，并立即把授权链接交给用户。
-3. 使用 `gd-cli creative schema --format json`、`gd-cli creative examples --format json` 和 `gd-cli workflows list --format json` 发现能力。
+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` 交付预览、链接、本地文件或完整交付包。
@@ -20,6 +20,6 @@
 ## 调用边界
 
 - 用户未指定模型时，直接调用目标能力，不主动查询或切换模型。
-- 用户未要求诊断时，不探测内部 endpoint、工具路由或组织权限。
+- 用户未要求诊断时，不探测内部 endpoint、能力路由或组织权限。
 - 一次调用失败后按 `errors.md` 处理，不扩展为无关诊断。
 - 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

@@ -5,13 +5,14 @@ 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/utils/list-output-format.d.ts

@@ -1,10 +0,0 @@
-import type { Command } from "commander";
-/**
- * 列表类命令：未显式指定 -f/--format 时，TTY 用 table，管道/非 TTY 用 json。
- * 显式传入 -f json|text|table 时始终尊重用户选择。
- */
-export declare function resolveListOutputFormat(subcommand: Command): string;
-/**
- * 工具调用 / 应用运行 / 任务状态：未显式 -f 时，TTY 用 human（交付物可读），非 TTY 用 json。
- */
-export declare function resolveInvokeOutputFormat(subcommand: Command): string;

package/dist/src/utils/list-output-format.js

@@ -1,34 +0,0 @@
-function getRoot(subcommand) {
-    return subcommand.parent?.parent ?? subcommand.parent;
-}
-function isImplicitFormat(root) {
-    const source = root?.getOptionValueSource("format");
-    return (source === undefined || source === "default" || source === "implied");
-}
-/**
- * 列表类命令：未显式指定 -f/--format 时，TTY 用 table，管道/非 TTY 用 json。
- * 显式传入 -f json|text|table 时始终尊重用户选择。
- */
-export function resolveListOutputFormat(subcommand) {
-    const root = getRoot(subcommand);
-    const opts = (root?.opts() ?? {});
-    if (opts.json)
-        return "json";
-    const format = opts.format ?? "json";
-    if (!isImplicitFormat(root))
-        return format;
-    return process.stdout.isTTY ? "table" : "json";
-}
-/**
- * 工具调用 / 应用运行 / 任务状态：未显式 -f 时，TTY 用 human（交付物可读），非 TTY 用 json。
- */
-export function resolveInvokeOutputFormat(subcommand) {
-    const root = getRoot(subcommand);
-    const opts = (root?.opts() ?? {});
-    if (opts.json)
-        return "json";
-    const format = opts.format ?? "json";
-    if (!isImplicitFormat(root))
-        return format;
-    return process.stdout.isTTY ? "human" : "json";
-}