gaoding-cli

GD CLI 是稿定设计能力的命令行入口，提供登录、组织切换、单项工具、场景应用和 DAM 素材管理能力。它面向两类调用者：需要批量生产创意素材的人，以及需要稳定调用稿定能力的脚本、CI 和 Agent。

Requirements

• Node.js >=20
• 有效的稿定账号与可用组织权限

Installation

npm install -g gaoding-cli

安装后使用 gd-cli 命令：

gd-cli --help
gd-cli --version

Quick Start

gd-cli auth login
gd-cli auth status

gd-cli org list
gd-cli org switch --org <org-id>

gd-cli tools ls
gd-cli tools call image.cutout --image ./product.jpg --mode product
gd-cli tools call text.title --brief "夏季运动鞋，轻量缓震，适合通勤"

gd-cli apps ls
gd-cli apps call listing-gallery --image ./product.jpg --brief "夏季运动鞋，轻量缓震，适合通勤"

gd-cli dam upload ./product.jpg

Commands

| Command | Purpose | | --- | --- | | auth | 登录、退出和查看本地认证状态 | | org | 查看和切换当前组织 | | tools | 调用单项 AI 创意能力 | | apps | 运行多步骤创意场景应用 | | dam | 上传、查询和删除 DAM 素材 | | update | 检查和升级 CLI |

Agent And Script Usage

所有核心命令都支持 -f json，便于脚本和 Agent 解析。Agent 自身有大语言模型时，标题、正文、标签和提示词草稿优先由 Agent 自己生成；gd-cli 主要负责上传、抠图、生图、生视频、高清化和完整 App 交付。

gd-cli tools info image.generate -f json
gd-cli tools call image.generate \
  --prompt "电商主图，白底，突出轻量缓震" \
  --image ./product.jpg \
  --ratio 1:1 \
  -f json

对于需要多步骤交付的任务，优先使用 apps call，它会返回结果清单并在本地输出交付物：

gd-cli apps call listing-gallery \
  --image ./product.jpg \
  --brief "运动鞋上架素材包" \
  --output-dir ./output \
  -f json

Development

npm install
npm run build
npm test
npm run start -- --help

本地开发建议用 gd-cli-dev 验证构建后的 dist，保留 gd-cli 给线上发布版本：

npm run dev:setup
# 按提示把 ~/.gd-cli-dev/bin 加入 PATH 后
npm run dev
gd-cli-dev --help
gd-cli --version

npm run dev 会持续编译到 dist，gd-cli-dev 会执行当前仓库的 dist/bin/gd-cli.js。 gd-cli-dev 会默认开启内部开发命令，例如 gd-cli-dev config env show；线上 gd-cli 仍保持隐藏。 gd-cli-dev 使用独立状态目录 ~/.gd-cli-dev/state，不会改写线上 gd-cli 使用的 ~/.gd。

默认 smoke test 只验证能力发现和 dry-run，不需要登录凭证：

npm run smoke:cli

真实接口测试会使用本机登录凭证，并可能消耗额度：

gd-cli auth login
npm run smoke:cli:live

Documentation

• GD CLI 安装与 Agent 接入指南
• 优化后的安装脚本稿
• 安全说明
• 首版发版检查
• 发版准备与架构总结
• 电商 App workflow