museav-cli 2.4.1 → 2.5.0

package/AGENTS.md

@@ -87,7 +87,9 @@ museav products
 museav assets
 
 # Check who you're logged in as and whether the account is affiliated with a tenant
-# (personal login only — apiKey callers get an error, they're already acting as the tenant)
+# Works for both personal login and apiKey (platform account or tenant). For apiKey:
+#   platform-account → 账户: nickname + 邮箱 + 累计出图 + credits
+#   tenant          → 租户: tenant_id + name + logo
 museav whoami
 ```
 

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 2.5.0 (2026-08-17)
+
+### 修复
+- **`whoami` 不再拒绝 apiKey 模式**：之前会直接抛错「只支持个人 login 身份」。实际上 `/api/me` 对两种 apiKey 都返回真实数据——
+  - 平台账户 apiKey（`STUDIO_API_KEY` 指向 `accounts.sk-*`）→ 账户身份：邮箱 + nickname + 累计出图次数 + credits
+  - 租户 apiKey（指向 `api_tenants.tenant_key`）→ 业务身份：tenant_id + name + nickname + logo
+  修复后三种身份都能 `museav whoami` 查清楚当前是谁、关联到哪个租户。
+
+### 文档
+- AGENTS.md `whoami` 说明：去掉「apiKey 不可用」的旧断言。
+
 ## 2.4.0 · 2026-08-17
 
 **本地图像工具箱补全（免登录、零成本、macOS/Windows 通用）。** 均为轻量级工具，无大模型常驻内存。

package/README.md

@@ -214,6 +214,10 @@ curl -o poster.png "$URL"
 # 先查有哪些模板（自己租户建的 + 平台共享的）
 museav templates
 museav templates --category 电商白底图    # 按分类过滤
+museav templates --mine       # 只看我这个人建的
+museav templates --tenant     # 只看本租户专属的
+museav templates --platform   # 只看平台共享的
+museav templates --type image # 按类型过滤（image / article）
 
 # 没有占位符的模板，直接用
 museav gen --template <模板id>

package/dist/client.d.ts

@@ -71,6 +71,10 @@ export interface TemplateOption {
     sample_cover_image?: string | null;
     /** 归属：自己租户建的 vs 平台共享的（tenant_id 为空） */
     tenant_id: string | null;
+    /** 中台下发的归属标记：mine=本租户建的 / platform=平台共享 / personal=我这个人建的 */
+    source?: 'mine' | 'platform' | 'personal';
+    /** 创建人（平台管理员个人建的模板会带邮箱；租户建的为 null） */
+    created_by?: string | null;
     generation_configs: Array<{
         model: string;
         prompt_template: string;
@@ -319,8 +323,9 @@ export declare class StudioClient {
     /** 可用技能清单：私有 + 所属租户专属模板 + 公共库，服务端已按调用者权限过滤 */
     skills(): Promise<SkillOption[]>;
     /** 可用图片/文字模板清单：自己租户建的 + 平台共享的，服务端已按调用者权限过滤。
-     *  type=image|article 二选一（不传则图片+文字都返回，跟中台默认一致）。 */
-    templates(type?: 'image' | 'article'): Promise<TemplateOption[]>;
+     *  type=image|article 二选一（不传则图片+文字都返回，跟中台默认一致）。
+     *  source=mine|platform|personal|all（默认 all；mine=本租户，platform=平台共享，personal=我这个人建的）。 */
+    templates(type?: 'image' | 'article', source?: 'mine' | 'platform' | 'personal' | 'all'): Promise<TemplateOption[]>;
     /** 视频模板清单（POST /api/videos 用 template_id）。结构同图片模板的 generation_configs 形态 */
     videoTemplates(): Promise<TemplateOption[]>;
     /** 新建图片模板。归属（是否关联租户）由服务端根据鉴权身份决定，见 CreateTemplateInput 注释 */

package/dist/client.js

@@ -90,9 +90,15 @@ export class StudioClient {
         return Array.isArray(r) ? r : [];
     }
     /** 可用图片/文字模板清单：自己租户建的 + 平台共享的，服务端已按调用者权限过滤。
-     *  type=image|article 二选一（不传则图片+文字都返回，跟中台默认一致）。 */
-    async templates(type) {
-        const qs = type ? `?type=${type}` : '';
+     *  type=image|article 二选一（不传则图片+文字都返回，跟中台默认一致）。
+     *  source=mine|platform|personal|all（默认 all；mine=本租户，platform=平台共享，personal=我这个人建的）。 */
+    async templates(type, source) {
+        const params = new URLSearchParams();
+        if (type)
+            params.set('type', type);
+        if (source && source !== 'all')
+            params.set('source', source);
+        const qs = params.toString() ? `?${params}` : '';
         const r = await this.request(`templates${qs}`);
         return Array.isArray(r) ? r : [];
     }

package/dist/commands/projects.js

@@ -20,9 +20,12 @@ export async function projects(client) {
         process.stderr.write('还没有工作区（museav projects create --name 新建）\n');
         return;
     }
+    // 每个项目的素材数（模板不挂项目，这里统计的是项目素材库，不是模板）
+    const assetCounts = await Promise.all(list.map(async (w) => ({ id: w.id, n: (await client.workspaceAssets(w.id).catch(() => [])).length })));
+    const assetOf = Object.fromEntries(assetCounts.map((x) => [x.id, x.n]));
     process.stderr.write(`工作区（${list.length} 个）:\n`);
     for (const w of list) {
-        process.stderr.write(`  ${w.id}  ${w.name.padEnd(16)} 出图 ${w.gen_done ?? 0}/${w.gen_total ?? 0}${w.brand ? `  brand:${w.brand}` : ''}\n`);
+        process.stderr.write(`  ${w.id}  ${w.name.padEnd(16)} 出图 ${w.gen_done ?? 0}/${w.gen_total ?? 0}  素材 ${assetOf[w.id] ?? 0}${w.brand ? `  brand:${w.brand}` : ''}\n`);
     }
     process.stderr.write(`\n素材库: museav projects assets --project <id|名>\n出图归档: museav gen --project <id|名> ...\n`);
     // stdout 只出 id，便于脚本解析

package/dist/commands/templates.d.ts

@@ -1,9 +1,14 @@
-/** museav templates —— 查可用图片/文字模板（自己租户建的 + 平台共享的）
- *  --type image|article 可过滤（中台 templates 表同时装两种，不传则都列并标注类型） */
+/** museav templates —— 查可用图片/文字模板。
+ *  --type image|article 按类型过滤
+ *  --mine 只看本租户建的；--platform 只看平台共享的；都不传则全部列出
+ *  --category 按分类过滤 */
 import type { StudioClient } from '../client.js';
 export declare function templates(client: StudioClient, opts?: {
     category?: string;
     type?: string;
+    mine?: boolean;
+    tenant?: boolean;
+    platform?: boolean;
 }): Promise<void>;
 interface CreateTemplateOpts {
     name: string;

package/dist/commands/templates.js

@@ -1,5 +1,22 @@
 export async function templates(client, opts = {}) {
-    let list = await client.templates((opts.type === 'image' || opts.type === 'article') ? opts.type : undefined);
+    const type = opts.type === 'image' || opts.type === 'article' ? opts.type : undefined;
+    // 三个归属维度都走服务端 source 参数（正式 API，不再客户端猜）：
+    //   --mine     → source=personal（created_by = 当前账户邮箱，我这个人建的）
+    //   --tenant   → source=mine（本租户专属）
+    //   --platform → source=platform（平台共享）
+    let list;
+    if (opts.mine) {
+        list = await client.templates(type, 'personal');
+    }
+    else if (opts.tenant) {
+        list = await client.templates(type, 'mine');
+    }
+    else if (opts.platform) {
+        list = await client.templates(type, 'platform');
+    }
+    else {
+        list = await client.templates(type);
+    }
     if (opts.category) {
         const kw = opts.category.toLowerCase();
         list = list.filter((t) => (t.category || '').toLowerCase().includes(kw));
@@ -8,7 +25,13 @@ export async function templates(client, opts = {}) {
         process.stderr.write(opts.category ? `没有匹配「${opts.category}」的模板\n` : '没有可用模板\n');
         return;
     }
-    const tag = (t) => (t.tenant_id ? '' : '[平台]');
+    const tag = (t) => {
+        if (t.source === 'personal')
+            return '[个人]';
+        if (t.tenant_id)
+            return '[租户]';
+        return '[平台]';
+    };
     const typeTag = (t) => (t.template_type === 'article' ? '[文字]' : t.template_type === 'image' ? '[图片]' : '');
     process.stderr.write(`可用模板（${list.length} 个）:\n`);
     for (const t of list) {
@@ -19,7 +42,7 @@ export async function templates(client, opts = {}) {
         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`);
+    process.stderr.write(`筛选: --mine(我建的) --tenant(本租户) --platform(平台共享) --type image|article --category <分类>\n`);
     // stdout 只出 id，便于脚本与 agent 解析
     console.log(list.map((t) => t.id).join('\n'));
 }

package/dist/commands/whoami.d.ts

@@ -1,3 +1,9 @@
-/** museav whoami —— 查当前登录账户 + 租户归属 */
+/** museav whoami —— 查当前身份 + 关联信息。
+ *
+ * apiKey 模式下也支持（2026-08-17 修复）：服务端 /api/me 对两种 apiKey 都返回真实数据——
+ *   - 平台账户 apiKey（STUDIO_API_KEY 指向 accounts.sk-*） → 走个人身份，含 credits / gen 统计
+ *   - 租户 apiKey（指向 api_tenants.tenant_key）              → 走业务身份，只下发 tenant 信息
+ * 个人 login（museav login）走完整 me，输出不变。
+ */
 import type { StudioClient } from '../client.js';
 export declare function whoami(client: StudioClient): Promise<void>;

package/dist/commands/whoami.js

@@ -1,14 +1,19 @@
-import { loadConfig } from '../config.js';
 export async function whoami(client) {
-    // 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());
+    if (me.identity === 'tenant') {
+        const t = me.tenant;
+        process.stderr.write(`身份: 租户 API Key\n`);
+        process.stderr.write(`租户: ${t.nickname || t.name}（${t.name}）\n`);
+        process.stderr.write(`tenant_id: ${t.id}\n`);
+        if (t.logo)
+            process.stderr.write(`logo: ${t.logo}\n`);
+    }
+    else {
+        process.stderr.write(`账户: ${me.nickname || me.email}（${me.email}）\n`);
+        process.stderr.write(me.brand ? `业务系统: ${me.brand.name}\n` : `身份: 平台账户 API Key\n`);
+        process.stderr.write(`出图: 累计 ${me.gen_total ?? 0} 次，成功 ${me.gen_done ?? 0} 次\n`);
+        if (me.credits != null)
+            process.stderr.write(`credits: ${me.credits}\n`);
     }
-    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/dist/index.js

@@ -262,6 +262,9 @@ const templatesCmd = program
     .description('查可用图片/文字模板：自己租户建的 + 平台共享的（跟技能是两套不同的机制，见 gen --template）')
     .option('--category <name>', '按分类过滤，如 电商白底图 / 演唱会')
     .option('--type <type>', '按类型过滤：image（图片） / article（文字），不传则两类都列并标注')
+    .option('--mine', '只看我这个人建的模板（created_by 是我，排除系统种子和租户专属）')
+    .option('--tenant', '只看本租户建的模板')
+    .option('--platform', '只看平台共享的模板')
     .action(withClient((client, opts) => templates(client, opts)));
 const videoTemplatesCmd = program
     .command('video-templates')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "museav-cli",
-  "version": "2.4.1",
+  "version": "2.5.0",
   "description": "MUSE AV 出图中台官方 CLI —— 命令行调中台 API 出图、出视频、读图逆向、图生模板",
   "type": "module",
   "bin": {

package/src/client.ts

@@ -123,6 +123,10 @@ export interface TemplateOption {
   sample_cover_image?: string | null
   /** 归属：自己租户建的 vs 平台共享的（tenant_id 为空） */
   tenant_id: string | null
+  /** 中台下发的归属标记：mine=本租户建的 / platform=平台共享 / personal=我这个人建的 */
+  source?: 'mine' | 'platform' | 'personal'
+  /** 创建人（平台管理员个人建的模板会带邮箱；租户建的为 null） */
+  created_by?: string | null
   generation_configs: Array<{
     model: string
     prompt_template: string
@@ -386,9 +390,13 @@ export class StudioClient {
   }
 
   /** 可用图片/文字模板清单：自己租户建的 + 平台共享的，服务端已按调用者权限过滤。
-   *  type=image|article 二选一（不传则图片+文字都返回，跟中台默认一致）。 */
-  async templates(type?: 'image' | 'article'): Promise<TemplateOption[]> {
-    const qs = type ? `?type=${type}` : ''
+   *  type=image|article 二选一（不传则图片+文字都返回，跟中台默认一致）。
+   *  source=mine|platform|personal|all（默认 all；mine=本租户，platform=平台共享，personal=我这个人建的）。 */
+  async templates(type?: 'image' | 'article', source?: 'mine' | 'platform' | 'personal' | 'all'): Promise<TemplateOption[]> {
+    const params = new URLSearchParams()
+    if (type) params.set('type', type)
+    if (source && source !== 'all') params.set('source', source)
+    const qs = params.toString() ? `?${params}` : ''
     const r = await this.request(`templates${qs}`)
     return Array.isArray(r) ? r : []
   }

package/src/commands/projects.ts

@@ -22,10 +22,15 @@ export async function projects(client: StudioClient): Promise<void> {
     process.stderr.write('还没有工作区（museav projects create --name 新建）\n')
     return
   }
+  // 每个项目的素材数（模板不挂项目，这里统计的是项目素材库，不是模板）
+  const assetCounts = await Promise.all(
+    list.map(async (w) => ({ id: w.id, n: (await client.workspaceAssets(w.id).catch(() => [])).length })),
+  )
+  const assetOf = Object.fromEntries(assetCounts.map((x) => [x.id, x.n]))
   process.stderr.write(`工作区（${list.length} 个）:\n`)
   for (const w of list) {
     process.stderr.write(
-      `  ${w.id}  ${w.name.padEnd(16)} 出图 ${w.gen_done ?? 0}/${w.gen_total ?? 0}${w.brand ? `  brand:${w.brand}` : ''}\n`,
+      `  ${w.id}  ${w.name.padEnd(16)} 出图 ${w.gen_done ?? 0}/${w.gen_total ?? 0}  素材 ${assetOf[w.id] ?? 0}${w.brand ? `  brand:${w.brand}` : ''}\n`,
     )
   }
   process.stderr.write(`\n素材库: museav projects assets --project <id|名>\n出图归档: museav gen --project <id|名> ...\n`)

package/src/commands/templates.ts

@@ -1,9 +1,25 @@
-/** museav templates —— 查可用图片/文字模板（自己租户建的 + 平台共享的）
- *  --type image|article 可过滤（中台 templates 表同时装两种，不传则都列并标注类型） */
+/** museav templates —— 查可用图片/文字模板。
+ *  --type image|article 按类型过滤
+ *  --mine 只看本租户建的；--platform 只看平台共享的；都不传则全部列出
+ *  --category 按分类过滤 */
 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)
+export async function templates(client: StudioClient, opts: { category?: string; type?: string; mine?: boolean; tenant?: boolean; platform?: boolean } = {}): Promise<void> {
+  const type = opts.type === 'image' || opts.type === 'article' ? opts.type : undefined
+  // 三个归属维度都走服务端 source 参数（正式 API，不再客户端猜）：
+  //   --mine     → source=personal（created_by = 当前账户邮箱，我这个人建的）
+  //   --tenant   → source=mine（本租户专属）
+  //   --platform → source=platform（平台共享）
+  let list: Awaited<ReturnType<StudioClient['templates']>>
+  if (opts.mine) {
+    list = await client.templates(type, 'personal')
+  } else if (opts.tenant) {
+    list = await client.templates(type, 'mine')
+  } else if (opts.platform) {
+    list = await client.templates(type, 'platform')
+  } else {
+    list = await client.templates(type)
+  }
   if (opts.category) {
     const kw = opts.category.toLowerCase()
     list = list.filter((t) => (t.category || '').toLowerCase().includes(kw))
@@ -13,7 +29,11 @@ export async function templates(client: StudioClient, opts: { category?: string;
     return
   }
 
-  const tag = (t: (typeof list)[number]) => (t.tenant_id ? '' : '[平台]')
+  const tag = (t: (typeof list)[number]) => {
+    if (t.source === 'personal') return '[个人]'
+    if (t.tenant_id) return '[租户]'
+    return '[平台]'
+  }
   const typeTag = (t: (typeof list)[number]) => (t.template_type === 'article' ? '[文字]' : t.template_type === 'image' ? '[图片]' : '')
 
   process.stderr.write(`可用模板（${list.length} 个）:\n`)
@@ -27,7 +47,7 @@ export async function templates(client: StudioClient, opts: { category?: string;
     )
   }
   process.stderr.write(`\n出图: museav gen --template <模板id> [--fields '{"key":"值"}']\n`)
-  process.stderr.write(`按类型过滤: museav templates --type image|article\n`)
+  process.stderr.write(`筛选: --mine(我建的) --tenant(本租户) --platform(平台共享) --type image|article --category <分类>\n`)
   // stdout 只出 id，便于脚本与 agent 解析
   console.log(list.map((t) => t.id).join('\n'))
 }

package/src/commands/whoami.ts

@@ -1,19 +1,46 @@
-/** museav whoami —— 查当前登录账户 + 租户归属 */
+/** museav whoami —— 查当前身份 + 关联信息。
+ *
+ * apiKey 模式下也支持（2026-08-17 修复）：服务端 /api/me 对两种 apiKey 都返回真实数据——
+ *   - 平台账户 apiKey（STUDIO_API_KEY 指向 accounts.sk-*） → 走个人身份，含 credits / gen 统计
+ *   - 租户 apiKey（指向 api_tenants.tenant_key）              → 走业务身份，只下发 tenant 信息
+ * 个人 login（museav login）走完整 me，输出不变。
+ */
 import type { StudioClient } from '../client.js'
-import { loadConfig } from '../config.js'
+
+/** /api/me 实际返回的形状：可能是账户身份也可能是租户身份（apiKey 模式） */
+type MeResponse =
+  | {
+      identity?: 'account'
+      id: string
+      email: string
+      nickname?: string | null
+      bio?: string | null
+      role: string
+      credits?: number | null
+      gen_quota?: number | null
+      gen_total?: number
+      gen_done?: number
+      brand?: { name: string } | null
+    }
+  | {
+      identity: 'tenant'
+      tenant: { id: string; name: string; nickname?: string | null; logo?: string | null }
+    }
 
 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()) as MeResponse
+
+  if (me.identity === 'tenant') {
+    const t = me.tenant
+    process.stderr.write(`身份: 租户 API Key\n`)
+    process.stderr.write(`租户: ${t.nickname || t.name}（${t.name}）\n`)
+    process.stderr.write(`tenant_id: ${t.id}\n`)
+    if (t.logo) process.stderr.write(`logo: ${t.logo}\n`)
+  } else {
+    process.stderr.write(`账户: ${me.nickname || me.email}（${me.email}）\n`)
+    process.stderr.write(me.brand ? `业务系统: ${me.brand.name}\n` : `身份: 平台账户 API Key\n`)
+    process.stderr.write(`出图: 累计 ${me.gen_total ?? 0} 次，成功 ${me.gen_done ?? 0} 次\n`)
+    if (me.credits != null) process.stderr.write(`credits: ${me.credits}\n`)
   }
-  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/index.ts

@@ -281,6 +281,9 @@ const templatesCmd = program
   .description('查可用图片/文字模板：自己租户建的 + 平台共享的（跟技能是两套不同的机制，见 gen --template）')
   .option('--category <name>', '按分类过滤，如 电商白底图 / 演唱会')
   .option('--type <type>', '按类型过滤：image（图片） / article（文字），不传则两类都列并标注')
+  .option('--mine', '只看我这个人建的模板（created_by 是我，排除系统种子和租户专属）')
+  .option('--tenant', '只看本租户建的模板')
+  .option('--platform', '只看平台共享的模板')
   .action(withClient((client: StudioClient, opts: any) => templates(client, opts)))
 
 const videoTemplatesCmd = program