命令速查
下面这张表由中台实时下发，跟已发布的 CLI 版本对得上 —— 不是手抄的。
| 命令 | 做什么 | 可选参数 / 前置条件 |
|---|---|---|
museav gen --skill <技能名> --input "一句业务描述" | 用技能出图（推荐）：提示词在服务端展开，不下发。技能查找顺序=自己的私有技能 → 团队专属技能 → 公共库 | 需 1.1.0+。标「需垫图」的技能必须加 --ref ./图.jpg |
museav gen --template <模板id> --fields '{"key":"值"}' | 用图片模板出图：提示词模板在服务端展开，确定性占位符替换，不经模型、无 chat 成本。模板清单=自己建的 + 平台共享的 | 需 1.2.0+。--fields 是可选的，模板没有占位符就不用传 |
museav gen --prompt "英文提示词" | 用自己的完整提示词出图。与 --skill / --template 三选一 | --ratio 3:4|9:16|1:1|4:3|16:9（默认 3:4） --model gpt-image-2 --quality low|medium|high（仅 gpt-image 系列） --ref ./垫图.jpg（图生图，自动上传） --transparent（透明背景 PNG；仅部分上游支持，不支持时报错不降级；自动强制 PNG 输出） |
museav skills | 查可用技能：私有 + 团队专属 + 公共库，服务端按权限过滤 | --genre 电商（按分类过滤）；需 1.1.0+ |
museav templates | 查可用图片模板：自己建的 + 平台共享的，服务端按权限过滤 | --category 电商白底图（按分类过滤）；需 1.2.0+ |
museav templates create --name "海报" --prompt "{artist} 在 {city} 的海报" | 命令行新建图片模板，不用再去网页后台；新建的模板只有你自己能用，不用手动指定归属 | --category --ratio --description --model --quality --fields（占位符字段说明，不传则自动从 --prompt 提取）；需 1.3.0+ |
museav products | 查自己的产品目录（数据存在你自己的业务系统里） | 仅 API Key 身份可用（个人登录用不了）；对应业务系统未开通这个查询会报错，非 bug；需 1.3.0+ |
museav assets | 查自己的素材/资产库（数据存在你自己的业务系统里） | 仅 API Key 身份可用（个人登录用不了）；对应业务系统未开通这个查询会报错，非 bug；需 1.3.0+ |
museav projects | 工作区（项目）列表：一个账户多个项目，每个项目有自己的素材库 | 需部署 workspace-assets 后可用；create --name 新建（最多 5 个） |
museav projects assets --project <id|名> | 项目素材库：列出/上传/删除该项目的垫图母版（人像库/产品库各管各的业务） | add <file> --name --tag 可重复；rm <id>；stdout 出 id<TAB>url 可直接喂 --ref |
museav gen --project <id|名> | 出图/出视频归档进该项目（jobs --project 按项目查） | — |
museav reverse ./图.jpg | 识图：反推 SCULPT 六要素与英文 prompt，也收图片 URL | — |
museav upload ./垫图.jpg | 只上传垫图，stdout 输出图片 URL | — |
museav models | 可用模型列表 | — |
museav balance | 上游余额 | — |
museav jobs | 出图记录。服务端固定返回最近 50 条 | --limit / --status 是本地过滤，不是服务端查询 |
museav whoami | 当前登录账户信息 | 仅个人 login 可用，apiKey 调用会报错 |
museav config | 不带参数=查看当前配置；带参数=写入 | --apiKey sk-studio-xxx --baseUrl <中台地址> |
museav login | 个人账号登录（设备授权：终端出验证码，浏览器批准） | — |
museav logout | 清除本地 token | — |
本表由中台 /api/cli-guide 在文档构建时下发，真源 shared/cli-meta.js—— 不是手抄的，中台改了下次构建自动跟上。
三条主线
出图有三种写法，三选一：
| 写法 | 什么时候用 |
|---|---|
--skill <技能名> --input "描述" | 推荐。 提示词在服务端展开，你只写业务描述 |
--template <模板id> --fields '{"key":"值"}' | 要可控、要省钱。确定性替换，不经模型 |
--prompt "英文提示词" | 你自己会写提示词 |
技能的查找顺序
同名时按这个顺序取：
你自己的私有技能 → 你所属租户的专属技能 → 公共技能库
也就是说你可以用同名模板覆盖公共技能，且不影响别的租户。
museav skills 列出来时，带 [专属] 标记的就是给你这个租户建的。