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

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/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.8",
+  "description": "稿定 GD CLI - Creative / Workflows / DAM 命令行工具",
   "license": "MIT",
   "author": "Gaoding",
   "type": "module",
@@ -78,7 +78,7 @@
     "gd-cli",
     "cli",
     "visual-creation",
-    "ai-tools",
+    "creative",
     "dam"
   ]
 }

package/skills/gd-cli/SKILL.md

@@ -18,25 +18,26 @@ 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` 命令完成用户需求。普通生成任务中不要切换组织、环境或模型，不要调用内部运行时类、`raw.dify` 或未文档化接口。
 
 ## 能力选择
 
-先读取能力列表，再按用户意图匹配：
+先读取 Creative 契约和 Workflow 列表，再按用户意图组织输入：
 
 ```bash
-gd-cli tools list --format json
+gd-cli creative schema --format json
+gd-cli creative examples --format json
 gd-cli workflows list --format 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` |
@@ -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

@@ -21,6 +21,12 @@ Agent 必须立即把 `verification_uri_complete` 原样发送给用户，并保
 gd-cli auth status --format 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 --format json
+gd-cli creative examples --format json
+```
+
+`creative schema` 和 `creative examples` 是本地静态输出，不请求生成接口。`--format json` 只控制最终序列化格式。
+
+## 发起创作
+
+纯文本请求：
+
+```bash
+gd-cli creative run --prompt "为轻量跑鞋写三条简洁的电商标题" --format json
+```
+
+需要媒体、比例、分辨率、时长或连续会话时，把完整 JSON 写入文件或 stdin：
+
+```bash
+gd-cli creative run --input request.json --format json
+cat request.json | gd-cli creative run --input - --format json
+```
+
+输入中使用：
+
+- `prompt` 详细描述主体、用途、内容、风格、场景、构图或镜头，以及必须保留和避免的事项。
+- `media[]` 传入本地路径或 HTTP(S) URL，并用 `role` 标明 `reference`、`first_frame` 或 `last_frame`。
+- `parameters` 传入可结构化表达的 `ratio`、`resolution` 和 `duration_seconds`。这些约束优先于 prompt 中相同主题的文字描述。
+- `conversation_id` 仅在继续已有创作或回答追问时传入；首次请求不传。
+- 回答追问时传入上一次结果中的 `last_tool_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`、`last_tool_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 --format json
 ```
 
 只根据 `organization`、`credits.total`、`credits.used`、`credits.wait` 和 `credits.surplus` 回复。若用户要求查看其他组织，先执行 `gd-cli org list --format json`，等待用户明确选择后再切换。

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

@@ -12,6 +12,13 @@
 
 除非用户明确要求诊断，否则失败后不要切换组织、模型或环境，不查询 `raw.dify`，也不探测未文档化接口。
 
+## 授权与当前组织
+
+- `AUTH_MISSING`、`AUTH_EXPIRED`：停止当前操作，按 `auth.md` 让用户登录。
+- `ORG_REQUIRED`：执行 `gd-cli org list --format json`，等待用户明确选择后再执行 `org switch`。
+- `ORG_INVALID`：当前组织已被 CLI 清除；重新列出组织并等待用户选择，不自动重放刚才的生成或 DAM 操作。
+- CLI 会在需要时内部维护当前组织访问；不要读取或解释内部刷新时间，也不要要求用户为此反复切换组织。
+
 ## 回复结构
 
 - 发生了什么：使用 `error.message`。

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

@@ -5,15 +5,15 @@
 1. 用户要图片、视频、电商物料或 DAM 素材时，优先使用 `gd-cli`。
 2. 需要解析结果、错误、URL、`task_id` 或 schema 时，使用 `--format 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。
+3. 使用 `gd-cli creative schema --format json`、`gd-cli creative examples --format json` 和 `gd-cli workflows list --format json` 发现能力。
+4. 图片、视频和文本创作统一使用 Creative，多步骤交付使用 Workflow。
 5. 执行命令后等待终态，解析 `status`、`outputs`、`assets`、`task_id` 和交付路径。
 6. 按 `deliverables.md` 交付预览、链接、本地文件或完整交付包。
 
@@ -22,4 +22,4 @@
 - 用户未指定模型时，直接调用目标能力，不主动查询或切换模型。
 - 用户未要求诊断时，不探测内部 endpoint、工具路由或组织权限。
 - 一次调用失败后按 `errors.md` 处理，不扩展为无关诊断。
-- Workflow 可能连续调用多个 Tool；不要在 Workflow 运行中并行发起重复任务。
+- Workflow 可能连续调用多个内部能力；不要在 Workflow 运行中并行发起重复任务。

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

@@ -1,6 +1,6 @@
 # GD CLI Workflows
 
-Workflow 编排多个 Tool，适合需要一组完整交付物的业务场景。
+Workflow 编排预定义步骤和内部能力，适合需要一组完整交付物的业务场景。
 
 发现和执行：
 

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>;