museav-cli 2.7.0 → 2.8.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 2.8.0 (2026-08-27)
+
+### 新增：贴图素材 + 版式模板命令（租户级资产，给封面/海报工具用）
+
+两个新命令，底层调中台 `/api/stickers` 和 `/api/poster-templates`，账户 Key / 租户 Key 均可（落到本租户）。
+
+- `museav stickers`：列出本租户贴图素材（PNG 透明装饰图）
+- `museav stickers add <file> --name <名称>`：上传贴图（不压缩，保留透明通道）
+- `museav poster-templates`：列出版式模板（封面底图 + 固定描述）
+- `museav poster-templates add <file> --name <名称> --prompt <描述>`：保存版式（`{城市}` `{明星}` 占位符会被替换）
+
+背景：好易美（hym）的闲鱼封面工具此前版式存学员本机桌面、贴图只在后台本地，无法共享。
+现在贴图素材 + 版式模板收归中台，CLI 一条命令加载/保存，学员间共享。
+
 ## 2.7.0 (2026-08-27)
 
 ### 修复：`remove-bg` 抠不出主体（三个静默 bug）

package/dist/client.d.ts

@@ -337,6 +337,18 @@ export declare class StudioClient {
     createTemplate(input: CreateTemplateInput): Promise<TemplateOption>;
     /** 新建视频模板。归属同图片模板：租户 apiKey 自动归租户，平台管理员归平台共享 */
     createVideoTemplate(input: CreateVideoTemplateInput): Promise<TemplateOption>;
+    /** 贴图素材清单（租户级资产，服务端已按调用者权限过滤）。PNG 装饰图，叠加在海报/封面上 */
+    stickers(): Promise<any[]>;
+    /** 上传贴图素材（不压缩——透明 PNG 压缩会破坏透明通道） */
+    createSticker(filePath: string, name: string): Promise<any>;
+    /** 删除贴图素材 */
+    deleteSticker(id: string): Promise<void>;
+    /** 版式模板清单（租户级资产）：封面底图 + 固定描述（{城市}{明星} 占位符） */
+    posterTemplates(): Promise<any[]>;
+    /** 上传版式模板（不压缩，保留封面底图原样） */
+    createPosterTemplate(filePath: string, name: string, prompt: string): Promise<any>;
+    /** 删除版式模板 */
+    deletePosterTemplate(id: string): Promise<void>;
     /** 提交出图任务，立即返回 jobId */
     generate(opts: GenerateOptions): Promise<{
         jobId: string;

package/dist/client.js

@@ -125,6 +125,41 @@ export class StudioClient {
         });
         return r.row;
     }
+    /** 贴图素材清单（租户级资产，服务端已按调用者权限过滤）。PNG 装饰图，叠加在海报/封面上 */
+    async stickers() {
+        const r = await this.request('stickers');
+        return Array.isArray(r) ? r : [];
+    }
+    /** 上传贴图素材（不压缩——透明 PNG 压缩会破坏透明通道） */
+    async createSticker(filePath, name) {
+        const blob = new Blob([new Uint8Array(readFileSync(filePath))]);
+        const fd = new FormData();
+        fd.append('file', blob, basename(filePath));
+        fd.append('name', name);
+        return this.request('stickers', { method: 'POST', body: fd });
+    }
+    /** 删除贴图素材 */
+    async deleteSticker(id) {
+        await this.request(`stickers?id=${encodeURIComponent(id)}`, { method: 'DELETE' });
+    }
+    /** 版式模板清单（租户级资产）：封面底图 + 固定描述（{城市}{明星} 占位符） */
+    async posterTemplates() {
+        const r = await this.request('poster-templates');
+        return Array.isArray(r) ? r : [];
+    }
+    /** 上传版式模板（不压缩，保留封面底图原样） */
+    async createPosterTemplate(filePath, name, prompt) {
+        const blob = new Blob([new Uint8Array(readFileSync(filePath))]);
+        const fd = new FormData();
+        fd.append('file', blob, basename(filePath));
+        fd.append('name', name);
+        fd.append('prompt', prompt);
+        return this.request('poster-templates', { method: 'POST', body: fd });
+    }
+    /** 删除版式模板 */
+    async deletePosterTemplate(id) {
+        await this.request(`poster-templates?id=${encodeURIComponent(id)}`, { method: 'DELETE' });
+    }
     /** 提交出图任务，立即返回 jobId */
     async generate(opts) {
         // prompt / skill_slug / template_id 三选一：都传时服务端按 prompt > template_id > skill_slug

package/dist/commands/poster-templates.d.ts

@@ -0,0 +1,11 @@
+/**
+ * museav poster-templates —— 版式模板库（租户级资产）。
+ *  封面底图 + 固定描述（{城市} {明星} 占位符），选版式时把城市/明星名填进底图。
+ *  学员做的封面版式保存后全租户共享。
+ */
+import type { StudioClient } from '../client.js';
+export declare function posterTemplates(client: StudioClient): Promise<void>;
+export declare function createPosterTemplate(client: StudioClient, filePath: string, opts: {
+    name: string;
+    prompt: string;
+}): Promise<void>;

package/dist/commands/poster-templates.js

@@ -0,0 +1,23 @@
+export async function posterTemplates(client) {
+    const list = await client.posterTemplates();
+    if (!list.length) {
+        process.stderr.write('没有版式模板（可用 museav poster-templates add <底图> --name <名称> --prompt <描述> 保存）\n');
+        return;
+    }
+    process.stderr.write(`版式模板（${list.length} 个）:\n`);
+    for (const t of list) {
+        process.stderr.write(`  ${t.id.padEnd(38)} ${String(t.name || '').padEnd(18)} ${String(t.prompt || '').slice(0, 40)}\n`);
+    }
+    process.stderr.write(`\n保存: museav poster-templates add <底图路径> --name <名称> --prompt <描述>\n`);
+    console.log(list.map((t) => t.id).join('\n'));
+}
+export async function createPosterTemplate(client, filePath, opts) {
+    if (!opts.name?.trim())
+        throw new Error('--name 必填');
+    if (!opts.prompt?.trim())
+        throw new Error('--prompt 必填，{城市} {明星} 占位符会被替换');
+    const row = await client.createPosterTemplate(filePath, opts.name, opts.prompt);
+    const id = row?.template?.id || row?.id || '';
+    process.stderr.write(`✅ 版式模板已保存：${id}\n`);
+    console.log(id);
+}

package/dist/commands/stickers.d.ts

@@ -0,0 +1,10 @@
+/**
+ * museav stickers —— 贴图素材库（租户级资产）。
+ *  PNG 透明装饰图（logo/花纹/边框），叠加在海报/封面上。
+ *  列出的都是自己租户的贴图；上传用账户 Key 或租户 Key 均可（落到本租户）。
+ */
+import type { StudioClient } from '../client.js';
+export declare function stickers(client: StudioClient): Promise<void>;
+export declare function createSticker(client: StudioClient, filePath: string, opts: {
+    name: string;
+}): Promise<void>;

package/dist/commands/stickers.js

@@ -0,0 +1,22 @@
+export async function stickers(client) {
+    const list = await client.stickers();
+    if (!list.length) {
+        process.stderr.write('没有贴图素材（可用 museav stickers add <图片> --name <名称> 上传）\n');
+        return;
+    }
+    process.stderr.write(`贴图素材（${list.length} 个）:\n`);
+    for (const s of list) {
+        process.stderr.write(`  ${s.id.padEnd(38)} ${String(s.name || '').padEnd(20)} ${s.url || ''}\n`);
+    }
+    process.stderr.write(`\n上传: museav stickers add <图片路径> --name <名称>\n`);
+    // stdout 只出 id，便于脚本与 agent 解析
+    console.log(list.map((s) => s.id).join('\n'));
+}
+export async function createSticker(client, filePath, opts) {
+    if (!opts.name?.trim())
+        throw new Error('--name 必填');
+    const row = await client.createSticker(filePath, opts.name);
+    const id = row?.sticker?.id || row?.id || '';
+    process.stderr.write(`✅ 贴图素材已上传：${id}\n`);
+    console.log(id);
+}

package/dist/index.js

@@ -28,6 +28,8 @@ import { jobs } from './commands/jobs.js';
 import { whoami } from './commands/whoami.js';
 import { products } from './commands/products.js';
 import { assets } from './commands/assets.js';
+import { stickers, createSticker } from './commands/stickers.js';
+import { posterTemplates, createPosterTemplate } from './commands/poster-templates.js';
 import { speak, transcribeCmd } from './commands/speak.js';
 const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf-8'));
 // 每 12 小时最多查一次 npm registry，过期才提示，不拖慢日常调用
@@ -315,6 +317,25 @@ templatesCmd
     .option('--fields <json>', '占位符字段说明，JSON 数组，如 \'[{"key":"artist","label":"艺人名"}]\'；不传则自动从 --prompt 里的 {key} 提取')
     .option('--type <type>', '模板类型：image（图片，默认） / article（文字）')
     .action(withClient((client, opts) => createTemplate(client, opts)));
+const stickersCmd = program
+    .command('stickers')
+    .description('查贴图素材库（租户级资产：PNG 装饰图，叠加在海报/封面上）')
+    .action(withClient((client) => stickers(client)));
+stickersCmd
+    .command('add <file>')
+    .description('上传贴图素材（PNG 透明装饰图，不压缩保留透明通道）')
+    .requiredOption('--name <名称>', '贴图名称')
+    .action(withClient((client, file, opts) => createSticker(client, file, opts)));
+const posterTemplatesCmd = program
+    .command('poster-templates')
+    .description('查版式模板库（租户级资产：封面底图 + 固定描述，选版式把城市/明星名填进底图）')
+    .action(withClient((client) => posterTemplates(client)));
+posterTemplatesCmd
+    .command('add <file>')
+    .description('保存版式模板（封面底图 + 描述，描述里用 {城市} {明星} 占位）')
+    .requiredOption('--name <名称>', '版式名称')
+    .requiredOption('--prompt <描述>', '版式固定描述，{城市} {明星} 会自动替换')
+    .action(withClient((client, file, opts) => createPosterTemplate(client, file, opts)));
 program
     .command('products')
     .description('查所属租户自己的产品目录（数据在租户自己的后台，不在 Studio 中台；只支持已开通该接口的租户，仅租户 apiKey 身份可用）')

package/package.json

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

package/src/client.ts

@@ -432,6 +432,47 @@ export class StudioClient {
     return r.row
   }
 
+  /** 贴图素材清单（租户级资产，服务端已按调用者权限过滤）。PNG 装饰图，叠加在海报/封面上 */
+  async stickers(): Promise<any[]> {
+    const r = await this.request('stickers')
+    return Array.isArray(r) ? r : []
+  }
+
+  /** 上传贴图素材（不压缩——透明 PNG 压缩会破坏透明通道） */
+  async createSticker(filePath: string, name: string): Promise<any> {
+    const blob = new Blob([new Uint8Array(readFileSync(filePath))])
+    const fd = new FormData()
+    fd.append('file', blob, basename(filePath))
+    fd.append('name', name)
+    return this.request('stickers', { method: 'POST', body: fd })
+  }
+
+  /** 删除贴图素材 */
+  async deleteSticker(id: string): Promise<void> {
+    await this.request(`stickers?id=${encodeURIComponent(id)}`, { method: 'DELETE' })
+  }
+
+  /** 版式模板清单（租户级资产）：封面底图 + 固定描述（{城市}{明星} 占位符） */
+  async posterTemplates(): Promise<any[]> {
+    const r = await this.request('poster-templates')
+    return Array.isArray(r) ? r : []
+  }
+
+  /** 上传版式模板（不压缩，保留封面底图原样） */
+  async createPosterTemplate(filePath: string, name: string, prompt: string): Promise<any> {
+    const blob = new Blob([new Uint8Array(readFileSync(filePath))])
+    const fd = new FormData()
+    fd.append('file', blob, basename(filePath))
+    fd.append('name', name)
+    fd.append('prompt', prompt)
+    return this.request('poster-templates', { method: 'POST', body: fd })
+  }
+
+  /** 删除版式模板 */
+  async deletePosterTemplate(id: string): Promise<void> {
+    await this.request(`poster-templates?id=${encodeURIComponent(id)}`, { method: 'DELETE' })
+  }
+
   /** 提交出图任务，立即返回 jobId */
   async generate(opts: GenerateOptions): Promise<{ jobId: string; trace_id?: string }> {
     // prompt / skill_slug / template_id 三选一：都传时服务端按 prompt > template_id > skill_slug

package/src/commands/poster-templates.ts

@@ -0,0 +1,33 @@
+/**
+ * museav poster-templates —— 版式模板库（租户级资产）。
+ *  封面底图 + 固定描述（{城市} {明星} 占位符），选版式时把城市/明星名填进底图。
+ *  学员做的封面版式保存后全租户共享。
+ */
+import type { StudioClient } from '../client.js'
+
+export async function posterTemplates(client: StudioClient): Promise<void> {
+  const list = await client.posterTemplates()
+  if (!list.length) {
+    process.stderr.write('没有版式模板（可用 museav poster-templates add <底图> --name <名称> --prompt <描述> 保存）\n')
+    return
+  }
+  process.stderr.write(`版式模板（${list.length} 个）:\n`)
+  for (const t of list) {
+    process.stderr.write(`  ${t.id.padEnd(38)} ${String(t.name || '').padEnd(18)} ${String(t.prompt || '').slice(0, 40)}\n`)
+  }
+  process.stderr.write(`\n保存: museav poster-templates add <底图路径> --name <名称> --prompt <描述>\n`)
+  console.log(list.map((t) => t.id).join('\n'))
+}
+
+export async function createPosterTemplate(
+  client: StudioClient,
+  filePath: string,
+  opts: { name: string; prompt: string },
+): Promise<void> {
+  if (!opts.name?.trim()) throw new Error('--name 必填')
+  if (!opts.prompt?.trim()) throw new Error('--prompt 必填，{城市} {明星} 占位符会被替换')
+  const row = await client.createPosterTemplate(filePath, opts.name, opts.prompt)
+  const id = row?.template?.id || row?.id || ''
+  process.stderr.write(`✅ 版式模板已保存：${id}\n`)
+  console.log(id)
+}

package/src/commands/stickers.ts

@@ -0,0 +1,29 @@
+/**
+ * museav stickers —— 贴图素材库（租户级资产）。
+ *  PNG 透明装饰图（logo/花纹/边框），叠加在海报/封面上。
+ *  列出的都是自己租户的贴图；上传用账户 Key 或租户 Key 均可（落到本租户）。
+ */
+import type { StudioClient } from '../client.js'
+
+export async function stickers(client: StudioClient): Promise<void> {
+  const list = await client.stickers()
+  if (!list.length) {
+    process.stderr.write('没有贴图素材（可用 museav stickers add <图片> --name <名称> 上传）\n')
+    return
+  }
+  process.stderr.write(`贴图素材（${list.length} 个）:\n`)
+  for (const s of list) {
+    process.stderr.write(`  ${s.id.padEnd(38)} ${String(s.name || '').padEnd(20)} ${s.url || ''}\n`)
+  }
+  process.stderr.write(`\n上传: museav stickers add <图片路径> --name <名称>\n`)
+  // stdout 只出 id，便于脚本与 agent 解析
+  console.log(list.map((s) => s.id).join('\n'))
+}
+
+export async function createSticker(client: StudioClient, filePath: string, opts: { name: string }): Promise<void> {
+  if (!opts.name?.trim()) throw new Error('--name 必填')
+  const row = await client.createSticker(filePath, opts.name)
+  const id = row?.sticker?.id || row?.id || ''
+  process.stderr.write(`✅ 贴图素材已上传：${id}\n`)
+  console.log(id)
+}

package/src/index.ts

@@ -28,6 +28,8 @@ import { jobs } from './commands/jobs.js'
 import { whoami } from './commands/whoami.js'
 import { products } from './commands/products.js'
 import { assets } from './commands/assets.js'
+import { stickers, createSticker } from './commands/stickers.js'
+import { posterTemplates, createPosterTemplate } from './commands/poster-templates.js'
 import { speak, transcribeCmd } from './commands/speak.js'
 
 const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf-8')) as { name: string; version: string }
@@ -345,6 +347,29 @@ templatesCmd
   .option('--type <type>', '模板类型：image（图片，默认） / article（文字）')
   .action(withClient((client: StudioClient, opts: any) => createTemplate(client, opts)))
 
+const stickersCmd = program
+  .command('stickers')
+  .description('查贴图素材库（租户级资产：PNG 装饰图，叠加在海报/封面上）')
+  .action(withClient((client: StudioClient) => stickers(client)))
+
+stickersCmd
+  .command('add <file>')
+  .description('上传贴图素材（PNG 透明装饰图，不压缩保留透明通道）')
+  .requiredOption('--name <名称>', '贴图名称')
+  .action(withClient((client: StudioClient, file: string, opts: any) => createSticker(client, file, opts)))
+
+const posterTemplatesCmd = program
+  .command('poster-templates')
+  .description('查版式模板库（租户级资产：封面底图 + 固定描述，选版式把城市/明星名填进底图）')
+  .action(withClient((client: StudioClient) => posterTemplates(client)))
+
+posterTemplatesCmd
+  .command('add <file>')
+  .description('保存版式模板（封面底图 + 描述，描述里用 {城市} {明星} 占位）')
+  .requiredOption('--name <名称>', '版式名称')
+  .requiredOption('--prompt <描述>', '版式固定描述，{城市} {明星} 会自动替换')
+  .action(withClient((client: StudioClient, file: string, opts: any) => createPosterTemplate(client, file, opts)))
+
 program
   .command('products')
   .description('查所属租户自己的产品目录（数据在租户自己的后台，不在 Studio 中台；只支持已开通该接口的租户，仅租户 apiKey 身份可用）')