命令速查
下面这张表由中台实时下发，跟已发布的 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 gen --video --prompt "一句画面描述" | 文生视频：提交后自动轮询到完成，stdout 出 mp4 URL。加 --image ./首帧.jpg 就是图生视频 | 不传 --model 走 auto 路由；锁档次用 artsdance-2-0-pro-260801 这类代号。--duration 秒（4-30，2.0 系上限 15、2.5 到 30） --ratio 9:16|16:9|1:1|3:4 |
museav gen --batch prompts.txt --skill <模板名> | 批量出图：一行一条，中台排队消化，撞限流自动等冷却补交，已提交的不重复扣费。完成后按行序逐行输出 URL | 需 3.0.2+。# 注释行与空行跳过，--batch - 读 stdin；--ratio/--ref/--project 等作为公共参数作用于每一行 |
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 video-templates | 查可用视频模板，配合 gen --video --template 使用（视频模板与图片模板是两套表） | --category 换装视频（按分类过滤） |
museav video-templates create --name "换装" --prompt "{product} 在 {scene} 展示" | 新建视频模板；归属同样由调用身份决定，个人账号不能建 | --slug --category --description --model --duration --ratio --sample-video --sample-cover |
museav image-to-template ./海报.jpg --name "主视觉" | 图生模板：读图 + 文字层逆向 + 变量化，做成可复用的图片模板（原图自动焊成参考图），stdout 出模板 id，阶段进度打 stderr | --variables title,subject,location 指定要变量化的字段；--no-create 只出草稿 JSON 不真建；--async 提交后不等结果 |
museav reverse ./图.jpg | 识图：反推 SCULPT 六要素与英文 prompt，也收图片 URL | 默认走中台（需登录）；--local 切本地 Ollama（需自备 qwen3-vl）。只读图，不建模板 |
museav upload ./垫图.jpg | 上传素材（图片/音频/视频，类型按字节内容判定），stdout 输出公网直链 | 图片 8MB / 音频 20MB / 视频 50MB；--to-works 收进「我的作品」 |
museav products | 查自己的产品目录（数据存在你自己的业务系统里） | 仅 API Key 身份可用（个人登录用不了）；对应业务系统未开通这个查询会报错，非 bug；需 1.3.0+ |
museav assets | 查自己的素材/资产库（数据存在你自己的业务系统里） | 仅 API Key 身份可用（个人登录用不了）；对应业务系统未开通这个查询会报错，非 bug；需 1.3.0+ |
museav stickers | 查贴图素材库（团队级资产：PNG 透明装饰图，叠在海报/封面上） | add <file> --name 上传（不压缩，保留透明通道） |
museav poster-templates | 查版式模板库（团队级资产：封面底图 + 固定描述，选版式把城市/明星名填进底图） | add <file> --name --prompt 上传；update <id> --name/--prompt/--file 改；rm <id> 删（账户 Key 只能改删自己传的，租户 Key 管全租户；需 3.10.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 compress ./photo.jpg | 本地压缩图片（sharp）。免登录、不耗积分，输出 <名>-min.<格式>，不覆写原文件 | --max-edge 800（最长边等比缩） --format jpg|png|webp --quality 70 |
museav remove-bg ./shoe.png | 本地抠图去背景（ISNet/U2Net + onnxruntime），输出带 alpha 的 PNG。免登录、不耗积分 | 首次运行自动下载模型（~170MB，缓存 ~/.museav-models）；--model isnet|u2net |
museav upscale ./photo.jpg --scale 4 | 本地超分放大（Real-ESRGAN + Vulkan GPU），2M 图能出 10M+。免登录、不耗积分 | 首次运行自动下载引擎与模型（~65MB）；--scale 2|3|4 |
museav remove-watermark ./poster.jpg | 本地去水印：像素启发式自动定位 + LaMa 修复。免登录、不耗积分 | 首次运行自动下载修复模型（~200MB）；复杂画面用 --mask ./掩码.png 手工指定（白=去除区） |
museav skillhub tags | 查小红书 SkillHub 的内容标签（发布必须带 --tag，实时拉取，不要硬编码） | 需 3.1.0+。stdout 出中文标签名，一行一个 |
museav skillhub publish ./my-skill --tag 效率工具 | 把本地 Agent Skill（SKILL.md 那种）发到小红书 SkillHub。默认只预演（dry-run，不登录不上传不提交），加 --yes 才真提交 | 需 3.1.0+。--tag 必填（平台要求，无默认值）；--source original|repost（默认 original，转载要配 --repost-source）；--identifier 指定 Skill ID。平台只收文本类扩展名（.md/.js/.py/.json/.sh 等，.mjs/.ts/.yaml 会被拒），单文件 10MB、整包 30MB。Skill ID 是平台主键，提交后跨版本不可改名 |
museav models | 可用模型列表 | — |
museav balance | 剩余积分 | — |
museav jobs | 出图记录。服务端固定返回最近 50 条 | --limit / --status 是本地过滤，不是服务端查询 |
museav whoami | 当前登录账户信息 | 仅个人 login 可用，apiKey 调用会报错 |
museav feedback "这里有个问题" | 提 bug / 需求，不带内容则交互式输入 | --list 看自己的反馈记录；个人账户可提，租户 apiKey 会被服务端拒 |
museav config | 不带参数=查看当前配置；带参数=写入 | --apiKey sk-studio-xxx --baseUrl <中台地址> |
museav login | 个人账号登录（设备授权：终端出验证码，浏览器批准） | — |
museav bind-feishu | 绑定飞书（设备授权：终端出验证码，浏览器授权后完成绑定） | 一个飞书可绑多个平台账户 |
museav logout | 清除本地 token | — |
本表由中台 /api/cli-guide 在文档构建时下发，真源 shared/cli-meta.js—— 不是手抄的，中台改了下次构建自动跟上。
三条主线
出图有三种写法，三选一：
| 写法 | 什么时候用 |
|---|---|
--skill <技能名> --input "描述" | 推荐。 提示词在服务端展开，你只写业务描述 |
--template <模板id> --fields '{"key":"值"}' | 要可控、要省钱。确定性替换，不经模型 |
--prompt "英文提示词" | 你自己会写提示词 |
批量出图（3.0.2 起）
一次出多张（电商套图、海报批量）不用写循环——把每条写进一个文件，一行一条：
bash
museav gen --batch prompts.txt --skill xhs-cover- 每行一条；
#开头的注释行和空行会跳过；--batch -读 stdin。 - 配合
--skill/--template时每行是业务描述；都不带时每行是完整提示词。 - 其余选项（
--ratio/--ref/--transparent/--project…）作为公共参数作用于每一行。 - 走中台批量接口排队消化，撞限流自动等冷却补交，已提交的不会重复扣费。
- 完成后按行序把图片 URL 逐行打到 stdout，方便接管道。
底层接口见 批量出图 /api/generate-batch。
技能的查找顺序
同名时按这个顺序取：
你自己的私有技能 → 你所属租户的专属技能 → 公共技能库
也就是说你可以用同名模板覆盖公共技能，且不影响别的租户。
museav skills 列出来时，带 [专属] 标记的就是给你这个租户建的。
发布 Skill 到小红书 SkillHub
跟 museav skills 不是一回事：那个查中台的出图技能，这个把你本地写好的 Agent Skill（SKILL.md 那种）发到小红书 SkillHub。
版本
3.1.0 首发 → 3.6.0 移除 → 3.9.0 恢复（owner 2026-09-28）。需 CLI >= 3.9.0。 MCP 侧 skillhub_* 三个工具在 museav-mcp 2.1.0 一并接回。
bash
museav skillhub tags # 先看可选内容标签
museav skillhub publish ./my-skill --tag 效率工具,编程开发 # 预演，不外发
museav skillhub publish ./my-skill --tag 效率工具 --yes # 真提交（扫码授权）不带 --yes 一定不会外发——只跑 dry-run 把名称 / Skill ID / 版本 / 简介 / 来源 / 标签 摊出来给你核对。--tag 必填（平台要求且没有合理默认），--source 默认 original； 转载要带 --repost-source <来源>，原创带了会被拒。
平台资产护栏：公共模板不会被顺手续上去
skillhub 把东西发到小红书上，而 MUSE AV 自己有一批平台公共模板 （museav templates --platform 那些）。每次发布 CLI 都会先扫一遍：
| 情况 | 处理 |
|---|---|
| Skill 正文含平台公共模板的提示词正文 | ❌ 拒绝发布，并指出是哪张模板 |
Skill 只引用模板 slug（如 museav gen --template xxx） | ✅ 放行 |
发布路径落在 ~/.museav-models / ~/.museav-bin | ❌ 拒绝 |
线是搬运正文 = 重新分发资产，拦；引用 slug = 正常集成，放行。拦引用会挡死 museav 自己的集成类 Skill。
拉不到模板清单时（没 museav login 或接口不通）不会假装有护栏：照发，但明确提示 「本次未做校验」。登录后重跑即得完整护栏。
平台的几个限制，打包前先知道：
- 只收文本类扩展名（
.md/.js/.py/.json/.sh/.html/.css等），.mjs、.ts、.yaml、图片都会被拒 - 单文件 10MB、整包 30MB，目录里必须有
SKILL.md - Skill ID 是平台主键，提交后跨版本不可改名，第一次提交前想清楚
打包、扫码授权、上传、提交都委托小红书官方 redskillhub-upload（已内置为依赖）。 Agent 里用同一条能力走 MCP 的 skillhub_publish（需 museav-mcp >= 2.1.0）。
相关
命令行 · 在档 L2「已经出图，要提效」的链路上 —— 第 2 / 5 步