museav-cli 2.0.0

package/src/commands/templates.ts

@@ -0,0 +1,98 @@
+/** museav templates —— 查可用图片/文字模板（自己租户建的 + 平台共享的）
+ *  --type image|article 可过滤（中台 templates 表同时装两种，不传则都列并标注类型） */
+import type { StudioClient } from '../client.js'
+
+export async function templates(client: StudioClient, opts: { category?: string; type?: string } = {}): Promise<void> {
+  let list = await client.templates((opts.type === 'image' || opts.type === 'article') ? opts.type : undefined)
+  if (opts.category) {
+    const kw = opts.category.toLowerCase()
+    list = list.filter((t) => (t.category || '').toLowerCase().includes(kw))
+  }
+  if (!list.length) {
+    process.stderr.write(opts.category ? `没有匹配「${opts.category}」的模板\n` : '没有可用模板\n')
+    return
+  }
+
+  const tag = (t: (typeof list)[number]) => (t.tenant_id ? '' : '[平台]')
+  const typeTag = (t: (typeof list)[number]) => (t.template_type === 'article' ? '[文字]' : t.template_type === 'image' ? '[图片]' : '')
+
+  process.stderr.write(`可用模板（${list.length} 个）:\n`)
+  for (const t of list) {
+    const cfg = t.generation_configs?.find((c) => c.is_default) || t.generation_configs?.[0]
+    const fields = cfg?.params_json?.fields || []
+    const fieldHint = fields.length ? `字段:${fields.map((f) => f.key).join(',')}` : ''
+    process.stderr.write(
+      `  ${t.id.padEnd(38)} ${(t.zh_name || '').padEnd(16)} ${(t.category || '').padEnd(10)} ${(t.ratio || '').padEnd(6)} ${typeTag(t).padEnd(8)} ${fieldHint.padEnd(20)} ${tag(t)}\n`,
+    )
+  }
+  process.stderr.write(`\n出图: museav gen --template <模板id> [--fields '{"key":"值"}']\n`)
+  process.stderr.write(`按类型过滤: museav templates --type image|article\n`)
+  // stdout 只出 id，便于脚本与 agent 解析
+  console.log(list.map((t) => t.id).join('\n'))
+}
+
+interface CreateTemplateOpts {
+  name: string
+  prompt: string
+  category?: string
+  ratio?: string
+  description?: string
+  model?: string
+  quality?: string
+  fields?: string
+  type?: string
+}
+
+/**
+ * museav templates create —— 新建图片模板。
+ *
+ * 归属不用自己传：服务端根据鉴权身份自动决定——租户 apiKey 建的自动归该租户
+ * （其他租户看不到），平台管理员 JWT 建的是 tenant_id=null 的平台共享模板，
+ * 个人账号（无租户、非管理员）会被服务端拒绝。CLI 这里不做额外判断，直接把
+ * 服务端返回的结果（含真实归属）打印出来。
+ */
+export async function createTemplate(client: StudioClient, opts: CreateTemplateOpts): Promise<void> {
+  if (!opts.name?.trim()) throw new Error('--name 必填')
+  if (!opts.prompt?.trim()) throw new Error('--prompt 必填，占位符用 {key} 形式，如 "{artist} 在 {city} 的演唱会海报"')
+
+  let fields: Array<{ key: string; label: string }>
+  if (opts.fields) {
+    try {
+      fields = JSON.parse(opts.fields)
+    } catch {
+      throw new Error('--fields 必须是合法 JSON 数组，如 \'[{"key":"artist","label":"艺人名"}]\'')
+    }
+  } else {
+    // 不传 --fields 就自动从 --prompt 里的 {key} 占位符提取，label 先等于 key，
+    // 想要更友好的中文标签可以自己传 --fields 覆盖
+    const keys = Array.from(new Set(Array.from(opts.prompt.matchAll(/\{(\w+)\}/g), (m) => m[1])))
+    fields = keys.map((key) => ({ key, label: key }))
+  }
+
+  const type = opts.type === 'article' ? 'article' : 'image'
+  const row = await client.createTemplate({
+    zh_name: opts.name,
+    category: opts.category,
+    ratio: opts.ratio,
+    description: opts.description,
+    template_type: type,
+    generation_configs: [
+      {
+        model: opts.model || 'gpt-image-2',
+        prompt_template: opts.prompt,
+        quality: opts.quality,
+        // 契约要求 fields 在 config 顶层（服务端 validateConfig 读 cfg.fields）
+        fields: fields.length ? fields : undefined,
+        is_default: true,
+      },
+    ],
+  })
+
+  process.stderr.write(`✅ ${type === 'article' ? '文字' : '图片'}模板已建：${row.id}\n`)
+  process.stderr.write(`归属：${row.tenant_id ? '当前租户（其他租户看不到）' : '平台共享（所有租户可见）'}\n`)
+  if (fields.length) process.stderr.write(`占位符字段: ${fields.map((f) => f.key).join(', ')}\n`)
+  const fieldExample = fields.length ? ` --fields '{"${fields[0].key}":"..."}'` : ''
+  process.stderr.write(`\n出图: museav gen --template ${row.id}${fieldExample}\n`)
+  // stdout 只出新建的模板 id，便于脚本链式使用
+  console.log(row.id)
+}

package/src/commands/upload.ts

@@ -0,0 +1,18 @@
+/**
+ * museav upload —— 上传素材到中台图库，stdout 输出公网直链。
+ *
+ * 走 POST /api/upload-ref：图片 / 音频 / 视频都收，类型按**字节魔数**判定（中台不信
+ * 客户端声明的 MIME），分类型限大小——图片 8MB / 音频 20MB / 视频 50MB。
+ * 拿到的 URL 可以直接喂给 gen --ref / gen --video --image，也能给 reverse 当图片 URL。
+ */
+import type { StudioClient } from '../client.js'
+
+const KIND_LABEL: Record<string, string> = { image: '图片', audio: '音频', video: '视频' }
+
+export async function upload(client: StudioClient, filePath: string): Promise<void> {
+  process.stderr.write(`上传 ${filePath} ...\n`)
+  const { url, media_type, mime } = await client.uploadRef(filePath)
+  const kind = media_type ? `${KIND_LABEL[media_type] || media_type}${mime ? ` · ${mime}` : ''}` : ''
+  process.stderr.write(`✅ 上传成功${kind ? `（${kind}）` : ''}\n`)
+  console.log(url)
+}

package/src/commands/video-templates.ts

@@ -0,0 +1,89 @@
+/** museav video-templates —— 查可用视频模板（配合 gen --video --template） */
+import type { StudioClient, CreateVideoTemplateInput } from '../client.js'
+
+export async function videoTemplates(client: StudioClient, opts: { category?: string } = {}): Promise<void> {
+  let list = await client.videoTemplates()
+  if (opts.category) {
+    const kw = opts.category.toLowerCase()
+    list = list.filter((t) => (t.category || '').toLowerCase().includes(kw))
+  }
+  if (!list.length) {
+    process.stderr.write(opts.category ? `没有匹配「${opts.category}」的视频模板\n` : '没有可用视频模板\n')
+    return
+  }
+
+  const tag = (t: (typeof list)[number]) => (t.tenant_id ? '' : '[平台]')
+
+  process.stderr.write(`可用视频模板（${list.length} 个）:\n`)
+  for (const t of list) {
+    const cfg = t.generation_configs?.find((c) => c.is_default) || t.generation_configs?.[0]
+    const modelHint = cfg?.model ? `模型:${cfg.model}` : ''
+    const ratioHint = t.ratio || ''
+    const fieldCount = cfg?.params_json?.fields?.length || 0
+    const fieldHint = fieldCount ? `字段:${cfg!.params_json!.fields!.map((f) => f.key).join(',')}` : ''
+    const sampleHint = t.sample_video_url ? '有参考视频' : ''
+    process.stderr.write(
+      `  ${t.id.padEnd(38)} ${(t.zh_name || '').padEnd(20)} ${(t.category || '').padEnd(10)} ${ratioHint.padEnd(6)} ${modelHint.padEnd(30)} ${fieldHint.padEnd(24)} ${sampleHint.padEnd(10)} ${tag(t)}\n`,
+    )
+    if (t.sample_video_url) {
+      process.stderr.write(`      参考视频: ${t.sample_video_url}\n`)
+    }
+  }
+  process.stderr.write(`\n出视频: museav gen --video --template <模板id> [--fields '{"key":"值"}']\n`)
+  // stdout 只出 id 和参考视频 URL（tab 分隔），便于脚本与 agent 解析
+  console.log(list.map((t) => t.sample_video_url ? `${t.id}\t${t.sample_video_url}` : t.id).join('\n'))
+}
+
+interface CreateVideoTemplateOpts {
+  name: string
+  prompt: string
+  category?: string
+  description?: string
+  model?: string
+  duration?: string
+  ratio?: string
+  sampleVideo?: string
+  sampleCover?: string
+}
+
+/** museav video-templates create —— 新建视频模板。
+ *  视频模板字段跟图片不同：模型/时长/比例在 generation_configs 每项里（服务端契约）。
+ *  归属跟图片模板一样由服务端根据鉴权身份自动决定。 */
+export async function createVideoTemplate(client: StudioClient, opts: CreateVideoTemplateOpts): Promise<void> {
+  if (!opts.name?.trim()) throw new Error('--name 必填')
+  if (!opts.prompt?.trim()) throw new Error('--prompt 必填，占位符用 {key} 形式，如 "{product} 在 {scene} 中展示"')
+
+  // 占位符必须声明 fields（中台 validateConfig 硬校验：prompt 里有 {key} 但没 fields 会被拒）
+  const keys = Array.from(new Set(Array.from(opts.prompt.matchAll(/\{(\w+)\}/g), (m) => m[1])))
+  const fields = keys.map((key) => ({ key, label: key }))
+
+  const cfg: Record<string, unknown> = {
+    model: opts.model || 'seedance-2',
+    prompt_template: opts.prompt,
+    is_default: true,
+  }
+  if (fields.length) cfg.fields = fields
+  if (opts.duration) {
+    const d = Number(opts.duration)
+    if (!Number.isFinite(d) || d < 4 || d > 15) throw new Error('--duration 必须是 4-15 之间的数字（秒）')
+    cfg.duration = d
+  }
+  if (opts.ratio) cfg.aspect_ratio = opts.ratio
+
+  const row = await client.createVideoTemplate({
+    zh_name: opts.name,
+    category: opts.category,
+    description: opts.description,
+    sample_video_url: opts.sampleVideo || null,
+    sample_cover_image: opts.sampleCover || null,
+    generation_configs: [cfg as CreateVideoTemplateInput['generation_configs'][number]],
+  })
+
+  process.stderr.write(`✅ 视频模板已建：${row.id}\n`)
+  process.stderr.write(`归属：${row.tenant_id ? '当前租户（其他租户看不到）' : '平台共享（所有租户可见）'}\n`)
+  process.stderr.write(`模型: ${cfg.model} 时长: ${cfg.duration || '模板默认'} 比例: ${cfg.aspect_ratio || '模板默认'}\n`)
+  if (fields.length) process.stderr.write(`占位符字段: ${fields.map((f) => f.key).join(', ')}\n`)
+  process.stderr.write(`\n出视频: museav gen --video --template ${row.id}\n`)
+  // stdout 只出新建的模板 id，便于脚本链式使用
+  console.log(row.id)
+}

package/src/commands/welcome.ts

@@ -0,0 +1,108 @@
+/**
+ * CLI 身份欢迎（2026-08-15）——login（个人 token）和 config（租户 apiKey）共用。
+ *
+ * 原则：不管哪种凭证，配置完成后都识别「我是谁」并打招呼：
+ *   - 个人 token → 账户身份（superadmin 山鬼映画 / 租户成员 / 平台用户）
+ *   - 租户 apiKey → 租户身份（XX 租户）
+ * 然后给使用引导 + 联系我 + 绑定说明。
+ */
+import type { MeInfo } from '../client.js'
+import { StudioClient } from '../client.js'
+
+export interface WelcomeCred {
+  token?: string
+  apiKey?: string
+}
+
+/** 终端显示宽度：ASCII=1，中文等宽字符=2（终端等宽字体下中文占 2 格） */
+function displayWidth(s: string): number {
+  return [...s].reduce((w, ch) => w + (ch.charCodeAt(0) > 255 ? 2 : 1), 0)
+}
+
+function box(lines: string[]): string {
+  const width = Math.max(...lines.map(displayWidth)) + 4
+  const border = '┌' + '─'.repeat(width) + '┐'
+  const bottom = '└' + '─'.repeat(width) + '┘'
+  return [
+    border,
+    ...lines.map((l) => `│ ${l}${' '.repeat(width - displayWidth(l))} │`),
+    bottom,
+  ].join('\n')
+}
+
+/** 打印身份欢迎。识别失败时给兜底问候，不影响 CLI 继续使用。 */
+export async function printWelcome(baseUrl: string, cred: WelcomeCred): Promise<void> {
+  let me: MeInfo | null = null
+  try {
+    me = await new StudioClient({ baseUrl, ...cred }).me()
+  } catch {
+    me = null
+  }
+
+  if (me?.identity === 'tenant') {
+    // ── 系统接入方（apiKey 模式）──
+    // 「租户」是内部技术称谓，对客户不暴露：客户视角是「我们的系统接入了
+    // MUSE AV AI 创作平台」，我们是服务提供方，不是把对方当租客。
+    const t = me.tenant
+    const tname = t?.nickname || t?.name || '贵方系统'
+    process.stderr.write(`👋 欢迎，${tname}！MUSE AV AI 创作平台已为你的系统接入创作能力\n`)
+    process.stderr.write(`   接入方：${tname}（系统级 API Key，为你的业务后台提供图片/视频创作）\n`)
+  } else if (me) {
+    // ── 个人身份 ──
+    const name = me.nickname || me.email
+    let identity = '平台用户'
+    let greeting = '欢迎使用 MUSE AV 创作中台'
+    if (me.role === 'superadmin') {
+      identity = '平台超级管理员'
+      greeting = '欢迎回来，山鬼映画！平台归你管，出了事找你本人 😄'
+    } else if (me.role === 'admin') {
+      identity = '平台管理员'
+      greeting = `欢迎回来，${name}！`
+    } else if (me.brand) {
+      // 接入方业务系统的成员（如好易美员工账户）：
+      // 身份表达 = 我是「XX」的人，MUSE AV 为「XX」提供创作能力。
+      // 不用「租户/租户成员」这类内部词，客户不该有被出租的感觉。
+      const biz = me.brand.name
+      identity = `${biz}成员`
+      greeting = `欢迎，${name}！MUSE AV 为「${biz}」提供 AI 创作能力，你的创作工作台已就绪`
+    } else {
+      greeting = `欢迎，${name}！`
+    }
+    const quota = me.generation_remaining != null ? `${me.generation_remaining} 次` : '不限'
+    process.stderr.write(`👋 ${greeting}\n`)
+    process.stderr.write(`   账户：${me.email}（${identity}）\n`)
+    if (me.gen_done != null) process.stderr.write(`   已出图 ${me.gen_done} 张 · 剩余额度 ${quota}\n`)
+    // 已绑定飞书：让客户知道缪斯 agent 在飞书里能认出他（未绑定不提示，绑定说明区有引导）
+    if (me.feishu_open_id) process.stderr.write('   飞书：已绑定 ✓（缪斯 agent 在飞书群里能认出你）\n')
+  } else {
+    process.stderr.write('👋 欢迎使用 MUSE AV 创作中台\n')
+  }
+
+  process.stderr.write('\n' + box([
+    '📖 怎么用（常用命令）',
+    '  museav gen --prompt "英文提示词"    自由出图',
+    '  museav gen --skill <技能> --input "描述"   技能出图',
+    '  museav gen --template <id> --fields \'{..}\'  模板出图',
+    '  museav image-to-template <图>       一张图做成可复用模板',
+    '  museav skills / templates / reverse    查技能/模板/读图',
+    '  museav jobs / whoami              记录 / 身份',
+    '  museav bind-feishu                绑定飞书',
+  ]) + '\n')
+
+  process.stderr.write('\n🔗 找我 / 支持我：\n')
+  process.stderr.write('   · GitHub 给项目点个 ⭐ → https://github.com/webkubor/museav-cli\n')
+  process.stderr.write('   · 小红书「山鬼映画」（东方电影美学）→ https://www.xiaohongshu.com/user/profile/5c3c1581000000000501835d\n')
+
+  process.stderr.write('\n🎁 我的其他作品（GitHub 上给它们点个 ⭐ 就是最大的支持）：\n')
+  process.stderr.write('   · typora-Bloom-theme（Typora 写作主题，★89）→ github.com/webkubor/typora-Bloom-theme\n')
+  process.stderr.write('   · voice-editor（本地中文 TTS 工作台）→ github.com/webkubor/voice-editor\n')
+  process.stderr.write('   · kyvault（本地加密密钥管理 CLI）→ github.com/webkubor/kyvault\n')
+  process.stderr.write('   · wechat-chat-gen（高仿真微信聊天截图生成器）→ github.com/webkubor/wechat-chat-gen\n')
+  process.stderr.write('   · knowledge-pdf-kit（Markdown → PDF/长图）→ github.com/webkubor/knowledge-pdf-kit\n')
+
+  process.stderr.write('\nℹ️ 绑定说明：\n')
+  process.stderr.write('   · 出图 / 技能 / 模板 / 逆向等全部创作功能【不需要】绑定飞书\n')
+  process.stderr.write('   · 绑定飞书（bind-feishu）只影响：让 agent 在飞书里认出你的身份\n')
+
+  process.stderr.write('\n现在就可以开始：museav gen --prompt "一只猫"\n')
+}

package/src/commands/whoami.ts

@@ -0,0 +1,19 @@
+/** museav whoami —— 查当前登录账户 + 租户归属 */
+import type { StudioClient } from '../client.js'
+import { loadConfig } from '../config.js'
+
+export async function whoami(client: StudioClient): Promise<void> {
+  // apiKey 是系统接入方/服务身份，不是个人账户，/api/me 不适用——直接提示，别等服务端 401
+  const cfg = loadConfig()
+  if (cfg.apiKey && !cfg.token) {
+    throw new Error(
+      'whoami 只支持个人 login 身份：museav login\n' +
+      '（apiKey 代表接入的业务系统，不是个人账户，可用 museav jobs / balance 查看业务数据）',
+    )
+  }
+  const me = await client.me()
+  process.stderr.write(`账户: ${me.nickname || me.email}（${me.email}）\n`)
+  process.stderr.write(me.brand ? `业务系统: ${me.brand.name}\n` : '业务系统: 未接入（个人用户）\n')
+  process.stderr.write(`出图: 累计 ${me.gen_total} 次，成功 ${me.gen_done} 次\n`)
+  console.log(JSON.stringify(me))
+}

package/src/config.ts

@@ -0,0 +1,114 @@
+/**
+ * 配置管理 —— 环境变量 > 配置文件
+ *
+ * 两类凭证：
+ *   - token：个人用户通过 `museav login` 设备授权拿到的 JWT（Bearer 鉴权）
+ *   - apiKey：租户/B 端的 sk-studio-xxx（X-API-Key 鉴权）
+ * token 优先于 apiKey（个人用户场景为主）。
+ *
+ * 配置文件：~/.museav.json，存 { baseUrl, token, apiKey }
+ * 环境变量：MUSEAV_BASE_URL / MUSEAV_API_KEY（旧名 STUDIO_BASE_URL / STUDIO_API_KEY 仍有效，
+ *          中台文档与既有 CI 都在用，不能说停就停）
+ */
+import { readFileSync, writeFileSync, existsSync, chmodSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+
+const CONFIG_PATH = join(homedir(), '.museav.json')
+/**
+ * 更名前遗留在用户机器上的配置文件，按新到旧排列，**只读**兼容。
+ *
+ * 这两个文件名是历史事实（用户硬盘上真实存在的路径），不是本项目还在用的叫法——
+ * 想读到它们就只能原样写出来。留着它们的理由不是念旧：apiKey 明文在中台只在创建那一次
+ * 返回，很多租户唯一的一份就躺在这些文件里，直接不读 = 逼人去找管理员重置密钥。
+ * 读到之后下一次 saveConfig 自然落到 ~/.museav.json，旧文件不动也不删。
+ */
+const LEGACY_CONFIG_PATHS = [
+  join(homedir(), '.studio-cli.json'),
+  join(homedir(), '.studio-image.json'),
+]
+/** 旧域名 webkubor.online 已弃用，API 统一走 manager.museav.top。 */
+export const DEFAULT_BASE_URL = 'https://manager.museav.top'
+
+export interface StudioConfig {
+  baseUrl: string
+  /** 个人用户 JWT（login 获得），优先用 */
+  token?: string
+  /** 租户 apikey（sk-studio-xxx），B 端场景 */
+  apiKey?: string
+  /**
+   * 租户自己后台的域名（如 https://manager.hympro.cn）。
+   * 只给 `products` / `assets` 两个命令用——那两个命令查的是租户自己的产品/素材数据，
+   * 数据物理上不在 Studio 中台，而在租户自己的数据库，所以要单独一个 base url。
+   * 已知租户（hym / mzmeso）不配也能跑（TenantClient 内置了默认值），
+   * 其他租户或本地联调时才需要显式配置。
+   */
+  tenantBaseUrl?: string
+}
+
+/**
+ * 读配置文件（不存在返回空对象）。
+ * 新路径缺失时按 LEGACY_CONFIG_PATHS 从新到旧回落，读到什么用什么——
+ * 下一次 saveConfig 会自然写到新路径，不主动搬文件、不删旧文件。
+ */
+function readFileConfig(): Partial<StudioConfig> {
+  for (const path of [CONFIG_PATH, ...LEGACY_CONFIG_PATHS]) {
+    try {
+      if (!existsSync(path)) continue
+      return JSON.parse(readFileSync(path, 'utf-8'))
+    } catch {
+      // 坏掉的那份跳过，继续试下一个
+    }
+  }
+  return {}
+}
+
+/** 写配置文件 */
+export function saveConfig(patch: Partial<StudioConfig>): StudioConfig {
+  const current = readFileConfig()
+  const next: StudioConfig = {
+    baseUrl: patch.baseUrl || current.baseUrl || DEFAULT_BASE_URL,
+    token: 'token' in patch ? patch.token : current.token,
+    apiKey: 'apiKey' in patch ? patch.apiKey : current.apiKey,
+    tenantBaseUrl: 'tenantBaseUrl' in patch ? patch.tenantBaseUrl : current.tenantBaseUrl,
+  }
+  writeFileSync(CONFIG_PATH, JSON.stringify(next, null, 2) + '\n', { mode: 0o600 })
+  // mode 只在文件新建时生效；已存在的旧配置文件（可能是更早版本用默认权限创建的）显式收紧一次
+  chmodSync(CONFIG_PATH, 0o600)
+  return next
+}
+
+/** 清除登录态（token），保留其他配置 */
+export function clearToken(): StudioConfig {
+  return saveConfig({ token: '' })
+}
+
+/**
+ * 解析最终配置：环境变量 > 配置文件 > 默认值
+ * 优先级：MUSEAV_API_KEY / STUDIO_API_KEY 环境变量 > 文件里的 token > 文件里的 apiKey
+ * 缺任何凭证时抛错，提示 login 或 config
+ *
+ * 改名后新增 MUSEAV_* 两个环境变量，旧的 STUDIO_* 继续认：中台对外文档和已经跑起来的
+ * CI 里写的都是 STUDIO_API_KEY，改名不该让别人的流水线在毫无预警的情况下断掉。
+ * 两个都设时以 MUSEAV_* 为准（显式用了新名字就是明确意图）。
+ */
+export function loadConfig(): StudioConfig {
+  const file = readFileConfig()
+  const baseUrl = process.env.MUSEAV_BASE_URL || process.env.STUDIO_BASE_URL || file.baseUrl || DEFAULT_BASE_URL
+  // tenantBaseUrl 只来自配置文件（没有对应的环境变量），跟 token/apiKey 的取舍无关，
+  // 统一透出去，用不用由调用方（目前只有 products/assets 两个命令）决定
+  const tenantBaseUrl = file.tenantBaseUrl
+
+  // 环境变量 apiKey 优先（CI/agent 场景）
+  const envApiKey = process.env.MUSEAV_API_KEY || process.env.STUDIO_API_KEY
+  if (envApiKey) return { baseUrl, apiKey: envApiKey, tenantBaseUrl }
+
+  // 文件里的 token（个人用户 login）优先于 apiKey
+  if (file.token) return { baseUrl, token: file.token, tenantBaseUrl }
+  if (file.apiKey) return { baseUrl, apiKey: file.apiKey, tenantBaseUrl }
+
+  throw new Error(
+    `未登录。请运行：museav login\n` +
+    `（或租户/B端配置：museav config --apiKey sk-studio-xxx）`
+  )
+}