museav-cli 2.0.0

package/src/commands/balance.ts

@@ -0,0 +1,12 @@
+/** museav balance —— 查租户余额（¥，实时计算：充值总额 − 历史消耗） */
+import type { StudioClient } from '../client.js'
+
+export async function balance(client: StudioClient): Promise<void> {
+  const r = await client.balance()
+  // 单位 ¥ 人民币（后台 2026-08-09 起只返回租户自己的余额，不再下发上游供应商聚合数据）
+  process.stderr.write(`余额: ¥${r.balance_usd?.toFixed(2) ?? '?'}`)
+  if (r.markup_pct) process.stderr.write(`  加价率: ${(r.markup_pct * 100).toFixed(0)}%`)
+  if (r.checked_at) process.stderr.write(`  校验时间: ${r.checked_at.slice(0, 19).replace('T', ' ')}`)
+  process.stderr.write('\n')
+  console.log(JSON.stringify(r))
+}

package/src/commands/bind-feishu.ts

@@ -0,0 +1,77 @@
+/**
+ * museav bind-feishu —— CLI 绑定飞书（设备码模式，2026-08-15）
+ *
+ * 流程：CLI 调 /feishu-bind/cli-start（需个人 login token）→ 终端显示验证码 + 授权链接
+ *      → 用户在浏览器打开链接（已登录后台）授权飞书 → CLI 轮询 /feishu-bind/cli-poll
+ *      → 绑定完成，提示已关联的平台账户数。
+ *
+ * 一个飞书 open_id 可绑定多个平台账户（owner 的 gmail/163 双 superadmin）：
+ * 绑定后 agent 在飞书里能认出你（resolveSpeaker superadmin 优先）。
+ * 只支持个人 login 账户；租户 apiKey 身份无法绑定个人飞书。
+ */
+import { loadConfig, DEFAULT_BASE_URL } from '../config.js'
+
+interface BindStart {
+  device_code: string
+  user_code: string
+  authorize_url: string
+  expires_in: number
+  interval: number
+}
+
+const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms))
+
+export async function bindFeishu(opts: { baseUrl?: string }): Promise<void> {
+  const baseUrl = (opts.baseUrl || DEFAULT_BASE_URL).replace(/\/+$/, '')
+  const cfg = loadConfig()
+  if (!cfg.token) {
+    throw new Error('绑定飞书需要个人账户登录：先执行 museav login（租户 apiKey 无法绑定个人飞书）')
+  }
+
+  process.stderr.write('正在发起飞书绑定...\n')
+  const startResp = await fetch(`${baseUrl}/api/feishu-bind/cli-start`, {
+    method: 'POST',
+    headers: { Authorization: `Bearer ${cfg.token}` },
+  })
+  if (!startResp.ok) {
+    const d = await startResp.json().catch(() => ({})) as { error?: string }
+    throw new Error(`发起绑定失败: HTTP ${startResp.status} ${d?.error || ''}`)
+  }
+  const start = await startResp.json() as BindStart
+
+  process.stderr.write('\n')
+  process.stderr.write('┌──────────────────────────────────────────────────┐\n')
+  process.stderr.write('│                                                  │\n')
+  process.stderr.write(`│   验证码:  ${start.user_code.padEnd(34)}        │\n`)
+  process.stderr.write('│                                                  │\n')
+  process.stderr.write('│   请在浏览器打开以下地址，授权绑定你的飞书：      │\n')
+  process.stderr.write('│                                                  │\n')
+  process.stderr.write('│   ' + start.authorize_url + '\n')
+  process.stderr.write('│                                                  │\n')
+  process.stderr.write('└──────────────────────────────────────────────────┘\n')
+  process.stderr.write('\n等待授权完成...（可随时 Ctrl+C 取消）\n')
+
+  const interval = (start.interval || 3) * 1000
+  const maxAttempts = Math.floor(((start.expires_in || 600) * 1000) / interval)
+
+  for (let i = 0; i < maxAttempts; i++) {
+    await sleep(interval)
+    const pollResp = await fetch(`${baseUrl}/api/feishu-bind/cli-poll`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ device_code: start.device_code }),
+    })
+    if (!pollResp.ok) continue
+    const poll = await pollResp.json() as { status: string; linked_count?: number; error?: string }
+
+    if (poll.status === 'approved') {
+      const n = poll.linked_count || 1
+      process.stderr.write(`\n✅ 飞书绑定成功！已关联 ${n} 个平台账户。agent 在飞书里能认出你了。\n`)
+      return
+    }
+    if (poll.status === 'expired') {
+      throw new Error('绑定请求已过期，请重新执行 museav bind-feishu')
+    }
+  }
+  throw new Error('绑定超时，请重新执行 museav bind-feishu')
+}

package/src/commands/gen.ts

@@ -0,0 +1,111 @@
+/** museav gen —— 出图 / 出视频（核心命令） */
+import type { StudioClient } from '../client.js'
+
+export async function gen(client: StudioClient, opts: {
+  prompt?: string
+  skill?: string
+  input?: string
+  template?: string
+  fields?: string
+  ratio?: string
+  model?: string
+  quality?: string
+  ref?: string
+  // 视频
+  video?: boolean
+  duration?: number
+  image?: string
+}): Promise<void> {
+  // prompt / skill / template 三选一。commander 不好表达互斥，在这里校验，报错要说清怎么改
+  const picked = [opts.prompt, opts.skill, opts.template].filter(Boolean).length
+  if (picked === 0) {
+    throw new Error('需要 --prompt "完整提示词" 或 --skill <技能名>（museav skills 查）或 --template <模板id>（museav templates 查）')
+  }
+  if (picked > 1) {
+    throw new Error('--prompt / --skill / --template 只能给一个：分别对应自己写提示词、用中台技能展开、用图片模板展开')
+  }
+  if (opts.input && !opts.skill) {
+    throw new Error('--input 是配合 --skill 的业务描述；只写提示词请用 --prompt')
+  }
+  if (opts.fields && !opts.template) {
+    throw new Error('--fields 是配合 --template 的占位符取值；用技能请用 --input')
+  }
+  if (opts.video && opts.skill) {
+    throw new Error('--video 暂不支持配合 --skill（视频模板走 --template 或直接 --prompt）')
+  }
+  let templateFields: Record<string, string> | undefined
+  if (opts.fields) {
+    try {
+      templateFields = JSON.parse(opts.fields)
+    } catch {
+      throw new Error(`--fields 必须是合法 JSON 对象，如 '{"artist":"王嘉尔","city":"南京"}'，收到: ${opts.fields}`)
+    }
+  }
+
+  // 可选：先上传垫图（图片出图 --ref / 视频图生视频 --image 都走这里）
+  let referenceImage: string | undefined
+  const refPath = opts.ref || opts.image
+  if (refPath) {
+    process.stderr.write(`上传垫图 ${refPath} ...\n`)
+    const up = await client.uploadRef(refPath)
+    referenceImage = up.url
+    process.stderr.write(`垫图就绪: ${referenceImage}\n`)
+  }
+
+  // ── 视频模式：走 /api/videos 独立链路 ──
+  if (opts.video) {
+    if (opts.quality) throw new Error('--quality 仅图片出图支持')
+    if (opts.skill) throw new Error('--video 暂不支持配合 --skill（视频模板走 --template，清单用 museav video-templates 查）')
+    process.stderr.write(
+      `提交视频: ${opts.template ? `模板 ${opts.template}` : opts.prompt?.slice(0, 40) || ''}${opts.image ? ' · 图生视频' : ''}\n`,
+    )
+    const { jobId } = await client.generateVideo({
+      prompt: opts.prompt,
+      model: opts.model,
+      ratio: opts.ratio,
+      duration: opts.duration,
+      image_url: referenceImage,
+      template_id: opts.template,
+      input: templateFields,
+    })
+    process.stderr.write(`视频任务已提交: ${jobId}\n生成中（视频通常 1-5 分钟）...\n`)
+    const result = await client.waitVideo(jobId, (status) => {
+      if (status === 'processing') process.stderr.write('生成中...\r')
+    })
+    if (result.status !== 'completed' || !result.cdn_url) {
+      throw new Error(`视频生成失败: ${result.error || '未知原因'}`)
+    }
+    process.stderr.write(`✅ 视频完成\n`)
+    console.log(result.cdn_url)
+    return
+  }
+
+  // ── 图片模式（原逻辑）──
+  process.stderr.write(
+    opts.skill
+      ? `提交出图: 技能 ${opts.skill}${opts.input ? ` · ${opts.input.slice(0, 30)}` : '（未给描述，按技能规范自由发挥）'}\n`
+      : opts.template
+        ? `提交出图: 模板 ${opts.template}${templateFields ? ` · ${JSON.stringify(templateFields).slice(0, 40)}` : ''}\n`
+        : `提交出图: ${opts.prompt!.slice(0, 40)}...\n`,
+  )
+  const job = await client.generateAndWait(
+    {
+      prompt: opts.prompt,
+      skill_slug: opts.skill,
+      input: opts.input,
+      template_id: opts.template,
+      template_fields: templateFields,
+      ratio: opts.ratio,
+      model: opts.model,
+      quality: opts.quality as 'low' | 'medium' | 'high' | undefined,
+      reference_image: referenceImage,
+    },
+    (status) => {
+      if (status === 'processing') process.stderr.write('生成中...\r')
+    },
+  )
+
+  // 成功：图片 URL 输出到 stdout（便于管道），元信息到 stderr
+  process.stderr.write(`✅ 完成 (${job.elapsed_ms ? (job.elapsed_ms / 1000).toFixed(1) + 's' : '?'})\n`)
+  console.log(job.cdn_url)
+}

package/src/commands/image-to-template.ts

@@ -0,0 +1,150 @@
+/**
+ * museav image-to-template —— 一张图 → 一个可复用的图片模板。
+ *
+ * 跟 reverse 的分工（中台 2026-08-16 拆成两个接口，别再混）：
+ *   reverse            只读图：SCULPT 六要素 + 出图 prompt，一次模型调用，同步返回。
+ *   image-to-template  读图 + 文字层逆向 + 变量化 + 建模板，原图还会被焊成模板的参考图。
+ * 想要哪个就调哪个，没有开关可拨——调用这个命令本身就是「我要模板」的意图。
+ *
+ * 同步/异步不由 --async 一个人说了算（中台契约 §7.6）：
+ *   建模板（默认）或显式 --async → 异步，先拿 jobId 再轮询
+ *   --no-create 且没给 --async  → 同步，直接返回草稿
+ */
+import type { StudioClient, ImageToTemplateResult, JobStep, TemplateField } from '../client.js'
+import { isAsyncJob } from '../client.js'
+
+export interface ImageToTemplateOpts {
+  /** commander 的 --no-create 会把 create 置 false，默认 true */
+  create?: boolean
+  name?: string
+  slug?: string
+  category?: string
+  variables?: string
+  labels?: string
+  async?: boolean
+}
+
+const STEP_MARK: Record<JobStep['status'], string> = { running: '🔄', ok: '✅', fail: '❌' }
+
+export async function imageToTemplate(
+  client: StudioClient,
+  input: string,
+  opts: ImageToTemplateOpts = {},
+): Promise<void> {
+  const isUrl = /^https?:\/\//.test(input)
+  const createTemplate = opts.create !== false
+
+  // --variables 收窄白名单：逗号分隔。中台只认它那套通用语义 key（title/subject/location…），
+  // 传了白名单外的会被忽略并在 template_warnings 里说明，全都不合法才 400。
+  const variables = opts.variables
+    ? opts.variables.split(',').map((s) => s.trim()).filter(Boolean)
+    : undefined
+  if (opts.variables && !variables?.length) {
+    throw new Error('--variables 给了但解析不出任何变量名，格式是逗号分隔，如 --variables title,subject,location')
+  }
+
+  let variableLabels: Record<string, string> | undefined
+  if (opts.labels) {
+    try {
+      variableLabels = JSON.parse(opts.labels)
+    } catch {
+      throw new Error(`--labels 必须是合法 JSON 对象，如 '{"subject":"艺人","location":"城市"}'，收到: ${opts.labels}`)
+    }
+  }
+
+  // 模板元信息全是可选的，一个都没给就整个不传，让中台自己生成 slug / 中文名
+  const template = opts.name || opts.slug || opts.category
+    ? { zh_name: opts.name, slug: opts.slug, category: opts.category }
+    : undefined
+  if (template && !createTemplate) {
+    process.stderr.write('⚠ --no-create 只看草稿，--name / --slug / --category 不会生效\n')
+  }
+
+  process.stderr.write(
+    `${createTemplate ? '图生模板' : '图生模板草稿（--no-create，不建模板）'}: ${input}\n`,
+  )
+
+  const submitted = await client.imageToTemplate({
+    file: isUrl ? undefined : input,
+    imageUrl: isUrl ? input : undefined,
+    variables,
+    variableLabels,
+    createTemplate,
+    template,
+    async: opts.async,
+  })
+
+  let result: ImageToTemplateResult
+  if (isAsyncJob(submitted)) {
+    process.stderr.write(`任务已提交: ${submitted.jobId}\n`)
+    // 阶段名去重打印：中台每轮返回的是完整 steps 数组，不过滤的话每 3 秒把同样的阶段重刷一遍
+    const printed = new Set<string>()
+    result = await client.waitImageToTemplate(submitted.jobId, (steps) => {
+      for (const s of steps) {
+        const key = `${s.name}:${s.status}`
+        if (printed.has(key)) continue
+        printed.add(key)
+        const cost = s.ms != null ? ` (${(s.ms / 1000).toFixed(1)}s)` : ''
+        process.stderr.write(`  ${STEP_MARK[s.status] || '·'} ${s.name}${cost}\n`)
+      }
+    })
+  } else {
+    result = submitted
+  }
+
+  printResult(result, createTemplate)
+}
+
+function printResult(r: ImageToTemplateResult, createTemplate: boolean): void {
+  process.stderr.write(`\n✅ 读图完成\n`)
+  process.stderr.write(`风格: ${r.zh_name || '-'}  分类: ${r.image_category || '-'}  比例: ${r.aspect_ratio}\n`)
+  if (r.style_tags?.length) process.stderr.write(`标签: ${r.style_tags.join(', ')}\n`)
+
+  const layers = r.text_layers || []
+  if (layers.length) {
+    process.stderr.write(`\n文字层（${layers.length} 处）:\n`)
+    for (const l of layers) {
+      const varTag = l.is_variable ? `{${l.variable}}` : '固定'
+      process.stderr.write(
+        `  ${(l.role || '-').padEnd(12)} ${varTag.padEnd(14)} ${(l.position || '').padEnd(12)} ${String(l.content || '').slice(0, 30)}\n`,
+      )
+    }
+  }
+
+  if (r.prompt_template) {
+    process.stderr.write(`\n提示词模具:\n  ${r.prompt_template}\n`)
+    process.stderr.write(`变量: ${fieldSummary(r.fields)}\n`)
+  } else {
+    // 中台的降级口径：文字层/变量化/建模板任一步失败都只降级，读图结果照常返回。
+    // 所以这里不抛错——上面那段读图结果是真的，用户可以照常拿去出图。
+    process.stderr.write(`\n⚠ 没能做出提示词模具${r.template_error ? `：${r.template_error}` : ''}\n`)
+    process.stderr.write(`  读图结果仍然有效，可直接用下面的 prompt 出图\n`)
+  }
+
+  for (const w of r.template_warnings || []) process.stderr.write(`⚠ ${w}\n`)
+
+  if (r.template) {
+    process.stderr.write(`\n✅ 模板已建：${r.template.id}\n`)
+    process.stderr.write(`  slug: ${r.template.slug}  名称: ${r.template.zh_name}\n`)
+    process.stderr.write(`  归属：${r.template.tenant_id ? '当前租户（其他租户看不到）' : '平台共享（所有租户可见）'}\n`)
+    if (r.template.reference_image) process.stderr.write(`  参考图（已焊进模板）: ${r.template.reference_image}\n`)
+    const example = r.fields?.length ? ` --fields '{"${r.fields[0].key}":"..."}'` : ''
+    process.stderr.write(`\n出图: museav gen --template ${r.template.id}${example}\n`)
+    // stdout 只出模板 id，跟 templates create 一致，便于脚本链式使用
+    console.log(r.template.id)
+    return
+  }
+
+  if (createTemplate && r.template_error) {
+    process.stderr.write(`\n❌ 模板没建成：${r.template_error}\n`)
+  } else if (!createTemplate) {
+    process.stderr.write(`\n这是草稿（--no-create）。满意的话去掉 --no-create 重跑一次即可建成模板。\n`)
+  }
+  // 没建成模板时 stdout 给完整草稿 JSON——脚本还能拿它自己调 POST /api/templates
+  console.log(JSON.stringify(r))
+}
+
+function fieldSummary(fields?: TemplateField[]): string {
+  if (!fields?.length) return '(无)'
+  return fields.map((f) => (f.label && f.label !== f.key ? `${f.key}(${f.label})` : f.key)).join(', ')
+}

package/src/commands/jobs.ts

@@ -0,0 +1,37 @@
+/**
+ * museav jobs —— 查自己名下的出图工作流
+ *
+ * 范围自动跟着鉴权凭证走：个人 login 只看自己的记录；租户 apiKey 看自己业务下的全部记录。
+ * 不需要额外传租户/用户 id——你拿的是谁的凭证，就是谁的数据。
+ */
+import type { StudioClient, Job } from '../client.js'
+
+const STATUS_MARK: Record<Job['status'], string> = {
+  pending: '⏳',
+  processing: '🔄',
+  done: '✅',
+  failed: '❌',
+}
+
+export async function jobs(client: StudioClient, opts: { limit?: string; status?: Job['status'] }): Promise<void> {
+  const limit = opts.limit ? Number(opts.limit) : 20
+  const list = await client.listJobs({ limit, status: opts.status })
+
+  if (!list.length) {
+    process.stderr.write('没有找到工作流记录\n')
+    console.log('[]')
+    return
+  }
+
+  process.stderr.write(`最近 ${list.length} 条工作流:\n\n`)
+  for (const j of list) {
+    const mark = STATUS_MARK[j.status] || '?'
+    const time = j.created_at ? new Date(j.created_at).toLocaleString() : '?'
+    process.stderr.write(`${mark} ${j.id}  ${j.status.padEnd(10)} ${(j.model || '?').padEnd(16)} ${time}\n`)
+    if (j.cdn_url) process.stderr.write(`   → ${j.cdn_url}\n`)
+    if (j.status === 'failed' && j.error) process.stderr.write(`   error: ${j.error}\n`)
+  }
+
+  // stdout 输出完整 JSON，供脚本消费
+  console.log(JSON.stringify(list))
+}

package/src/commands/login.ts

@@ -0,0 +1,80 @@
+/**
+ * museav login —— 设备授权登录（RFC 8628）
+ *
+ * 流程：CLI 调 /cli-auth/start 拿验证码 → 用户浏览器打开审批页授权
+ *      → CLI 轮询 /cli-auth/poll 拿 JWT → 存到 ~/.museav.json
+ *
+ * 之后所有命令用 Bearer JWT 调 API，权限/额度与网页端一致。
+ */
+import { saveConfig, DEFAULT_BASE_URL } from '../config.js'
+import { StudioClient } from '../client.js'
+import { printWelcome } from './welcome.js'
+
+export async function login(opts: { baseUrl?: string }): Promise<void> {
+  const baseUrl = (opts.baseUrl || DEFAULT_BASE_URL).replace(/\/+$/, '')
+
+  // 1. 发起设备授权
+  process.stderr.write('正在发起授权...\n')
+  const startResp = await fetch(`${baseUrl}/api/cli-auth/start`, { method: 'POST' })
+  if (!startResp.ok) {
+    throw new Error(`发起授权失败: HTTP ${startResp.status}`)
+  }
+  const start = await startResp.json() as {
+    device_code: string
+    user_code: string
+    verification_uri: string
+    expires_in: number
+    interval: number
+  }
+
+  // 2. 展示验证码和链接，等用户去浏览器授权
+  process.stderr.write('\n')
+  process.stderr.write('┌──────────────────────────────────────────────────┐\n')
+  process.stderr.write('│                                                  │\n')
+  process.stderr.write(`│   验证码:  ${start.user_code.padEnd(34)}        │\n`)
+  process.stderr.write('│                                                  │\n')
+  process.stderr.write('│   请在浏览器打开以下地址，登录并批准授权：        │\n')
+  process.stderr.write('│                                                  │\n')
+  process.stderr.write('│   ' + start.verification_uri + '\n')
+  process.stderr.write('│                                                  │\n')
+  process.stderr.write('└──────────────────────────────────────────────────┘\n')
+  process.stderr.write('\n等待授权完成...（可随时 Ctrl+C 取消）\n')
+
+  // 3. 轮询直到拿到 token
+  const interval = (start.interval || 3) * 1000
+  const maxAttempts = Math.floor((start.expires_in || 600) * 1000 / interval)
+
+  for (let i = 0; i < maxAttempts; i++) {
+    await sleep(interval)
+    const pollResp = await fetch(`${baseUrl}/api/cli-auth/poll`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ device_code: start.device_code }),
+    })
+    if (!pollResp.ok) continue
+    const poll = await pollResp.json() as { status: string; token?: string; error?: string }
+
+    if (poll.status === 'approved' && poll.token) {
+      saveConfig({ baseUrl, token: poll.token })
+      process.stderr.write('\n✅ 登录成功！token 已保存到 ~/.museav.json\n')
+      await printWelcome(baseUrl, { token: poll.token })
+      return
+    }
+    if (poll.status === 'expired') {
+      throw new Error('授权已过期，请重新运行 museav login')
+    }
+    // 服务端目前只有 pending → approved 或过期两条路，没有"拒绝"这个动作
+    // （浏览器审批页没有拒绝按钮，不批准就是不动，最终走 expired）。
+    // 这里仍保留未知状态的兜底，万一以后服务端加了新状态，报错文案不会文不对题。
+    if (poll.status !== 'pending') {
+      throw new Error(`授权失败: ${poll.error || poll.status || '未知错误'}`)
+    }
+    // pending：继续等
+    process.stderr.write('.')
+  }
+  throw new Error('等待授权超时，请重新运行 museav login')
+}
+
+function sleep(ms: number): Promise<void> {
+  return new Promise((r) => setTimeout(r, ms))
+}

package/src/commands/models.ts

@@ -0,0 +1,12 @@
+/** museav models —— 查可用模型列表 */
+import type { StudioClient } from '../client.js'
+
+export async function models(client: StudioClient): Promise<void> {
+  const list = await client.models()
+  process.stderr.write(`可用模型（${list.length} 个）:\n`)
+  for (const m of list) {
+    process.stderr.write(`  ${m.value.padEnd(28)} ${m.label}\n`)
+  }
+  // stdout 输出 value 列表（便于脚本解析）
+  console.log(list.map((m) => m.value).join('\n'))
+}

package/src/commands/products.ts

@@ -0,0 +1,38 @@
+/**
+ * museav products —— 查所属租户自己的产品目录。
+ *
+ * 数据不在 Studio 中台，在租户自己的后台（见 ../tenant-client.ts 顶部注释）。
+ * 不是每个租户都有"产品"这个概念——比如好易美是演唱会海报/票务业务，没有实体商品，
+ * 它的后台没有开通这个端点，调用会报错，这是预期行为，不是 bug。
+ */
+import type { TenantClient } from '../tenant-client.js'
+
+interface TenantProduct {
+  id: string
+  name: string
+  series?: string | null
+  status?: string | null
+  active?: boolean
+  cover_image_url?: string | null
+  images?: string[]
+  [key: string]: unknown
+}
+
+export async function products(client: TenantClient): Promise<void> {
+  const list = await client.get<TenantProduct[]>('tenant-products')
+  if (!Array.isArray(list) || !list.length) {
+    process.stderr.write('该租户暂无产品数据\n')
+    console.log('[]')
+    return
+  }
+  process.stderr.write(`产品（${list.length} 个）:\n`)
+  for (const p of list) {
+    const imgCount = (p.images?.length || 0) + (p.cover_image_url ? 1 : 0)
+    process.stderr.write(
+      `  ${String(p.id).padEnd(38)} ${(p.name || '').padEnd(20)} ${(p.series || '').padEnd(12)} ${(p.status || '').padEnd(10)} 图${imgCount}张\n`,
+    )
+  }
+  process.stderr.write(`\n配合出图: museav gen --template <模板id> --fields '{"...":"..."}'（参考图 URL 从上面产品的 cover_image_url / images 里挑）\n`)
+  // stdout 输出完整 JSON，方便 agent/脚本挑参考图字段
+  console.log(JSON.stringify(list))
+}

package/src/commands/reverse.ts

@@ -0,0 +1,21 @@
+/** museav reverse —— 图片逆向（SCULPT 六要素反推 prompt） */
+import type { StudioClient } from '../client.js'
+
+export async function reverse(client: StudioClient, input: string): Promise<void> {
+  // 输入是文件路径还是 URL
+  const isUrl = /^https?:\/\//.test(input)
+  const result = await client.reverse(isUrl ? { imageUrl: input } : { file: input })
+
+  process.stderr.write(`✅ 逆向完成\n\n`)
+  process.stderr.write(`风格: ${result.zh_name || '-'}  比例: ${result.aspect_ratio}\n`)
+  process.stderr.write(`标签: ${result.style_tags.join(', ')}\n\n`)
+  process.stderr.write(`SCULPT 六要素:\n`)
+  for (const [k, v] of Object.entries(result.sculpt)) {
+    process.stderr.write(`  ${k}: ${v}\n`)
+  }
+  process.stderr.write(`\n英文 prompt:\n  ${result.prompt}\n`)
+  process.stderr.write(`中文 prompt:\n  ${result.prompt_cn}\n`)
+
+  // stdout 输出英文 prompt（便于管道直接喂给 gen）
+  console.log(result.prompt)
+}

package/src/commands/skills.ts

@@ -0,0 +1,29 @@
+/** museav skills —— 查可用技能（私有 + 所属租户专属模板 + 公共库） */
+import type { StudioClient } from '../client.js'
+
+export async function skills(client: StudioClient, opts: { genre?: string } = {}): Promise<void> {
+  let list = await client.skills()
+  if (opts.genre) {
+    const kw = opts.genre.toLowerCase()
+    list = list.filter((s) => (s.genre || '').toLowerCase().includes(kw))
+  }
+  if (!list.length) {
+    process.stderr.write(opts.genre ? `没有匹配「${opts.genre}」的技能\n` : '没有可用技能\n')
+    return
+  }
+
+  // 归属标记：自己建的 / 所属租户的专属模板 / 公共库——同名时服务端按这个顺序取
+  const tag = (s: (typeof list)[number]) => (s.private ? '[私有]' : s.agency ? '[专属]' : '')
+
+  process.stderr.write(`可用技能（${list.length} 个）:\n`)
+  for (const s of list) {
+    const flag = s.ref_required ? '需垫图' : ''
+    process.stderr.write(
+      `  ${s.slug.padEnd(30)} ${(s.zh_name || '').padEnd(16)} ${(s.genre || '').padEnd(10)} ${(s.ratio || '').padEnd(6)} ${flag.padEnd(6)} ${tag(s)}\n`,
+    )
+  }
+  process.stderr.write(`\n出图: museav gen --skill <技能名> --input "一句业务描述"\n`)
+  process.stderr.write(`标「需垫图」的必须加 --ref ./图.jpg，否则服务端会拒绝\n`)
+  // stdout 只出 slug，便于脚本与 agent 解析
+  console.log(list.map((s) => s.slug).join('\n'))
+}