museav-cli 2.9.0 → 2.10.2

package/CHANGELOG.md

@@ -1,5 +1,61 @@
 # Changelog
 
+## 2.10.2 (2026-08-28)
+
+### 修复：排版模板的图层顺序失效，图片会盖住它下面该有的文字
+
+`slot` / `image` 图层被统一提到最后合成，导致**所有图片永远压在所有矢量层之上**，
+DSL 里 `layers` 的先后顺序当场失效。「图片铺满画面 + 文字压在上面」这类版式
+渲染出来是文字被图片盖掉。
+
+内置的粉青版式没受影响（那里图与文字不重叠），所以 2.10.1 发出去时没被发现 ——
+是拿一个结构完全不同的版式（满屏叠字）实测才暴露的。
+
+改成按 `layers` 顺序分段渲染：连续的矢量层攒成一段 SVG，遇到图片层就断开，
+按原顺序逐段叠加。
+
+## 2.10.1 (2026-08-28)
+
+> 这一版同时发布了另一条线的 `feedback` 命令（命令行提 bug/需求），
+> 下面记的是 slideshow 这条线的改动。
+
+### `slideshow` 的版面改由**排版模板**描述，模板库在中台
+
+2.9.0 的版面写死在代码里，改一个颜色都得发新版本。现在版面是一份**图层 DSL**：
+
+```bash
+museav slideshow-layouts                      # 看有哪些版式（内置 + 中台）
+museav slideshow ./图 --layout <slug>          # 用中台的模板
+museav slideshow ./图 --layout-file my.json    # 用本地 JSON（调模板时免登录）
+museav slideshow-layouts create my.json --name 我的版式 --slug my-style
+```
+
+DSL 支持 `rect` / `ellipse` / `text` / `slot` / `image` 五种图层，`text` 和 `slot` 用
+`bind` 绑定内容（title / subtitle / caption / footer / image），所以同一个模板能套任意素材。
+`image` 层可以写 `sticker://<id>` 直接引用中台贴图库里的透明装饰图。
+
+**免登录这条路原样保留**：不给 `--layout` 就用内置版式，全程不碰网络。这是 slideshow
+秒级出片、零成本的立身之本，接了模板库也不能丢。
+
+模板结构的真源在中台 `shared/slideshow-layout.js`，**校验也只在中台写入时做**。
+CLI 是消费方：遇到不认识的图层类型跳过该层并提示升级，不报错中断 ——
+两侧都校验的话，老 CLI 会把新写的合法模板判为非法，那才是真坏掉。
+
+### 行为变化：主图会比 2.9.0 略大（约 5%）
+
+`slot` 的 `box` 语义是**矩形框 + contain**（同 CSS `object-fit`），而 2.9.0 是把主图区
+当成正方形边长。差别在高瘦的图上：一张 219×229 的贴纸放进 518×701 的框，
+旧算法出 495×518（受高度限制），新算法出 518×542。
+
+换成框语义是刻意的 —— 框多大图就能占多大才符合直觉，也是「主图偏小」那个老问题的根治。
+实测两版逐像素比对：主图区差异 12%（就是这 5% 的尺寸差），其余区域 0.1~2.4%
+（亚像素位移的抗锯齿噪声）。版面结构完全一致。
+
+### 已知缺口
+
+CLI 内置的 `sticker-pink-mint` 与中台平台预置的同名模板是同一份 DSL，靠人工同步 ——
+本仓库还没有测试框架，这条一致性目前没有机器检查。
+
 ## 2.9.0 (2026-08-28)
 
 ### 新增：`slideshow` —— 一组图 + 文案 + 配乐 → 竖版短视频（免登录）

package/README.md

@@ -463,6 +463,37 @@ museav slideshow ./图片目录 --captions 文案.txt --title "作品集"
 
 默认 1080×1920 / 30fps / H.264+AAC，每张停 2.5 秒；`--size` 换尺寸、`--theme dark` 换深色底。
 
+#### 排版模板：版面不写死在代码里
+
+版面由一份**图层 DSL** 描述，模板库在中台，改版式不用等 CLI 发新版：
+
+```bash
+museav slideshow-layouts                       # 看有哪些版式（内置 + 中台）
+museav slideshow ./图 --layout <slug>           # 用中台模板
+museav slideshow ./图 --layout-file my.json     # 用本地 JSON（调模板时用，免登录）
+museav slideshow-layouts create my.json --name 我的版式 --slug my-style
+```
+
+DSL 支持 `rect` / `ellipse` / `text` / `slot` / `image` 五种图层。`text` 和 `slot` 用 `bind`
+绑定内容（`title` / `subtitle` / `caption` / `footer` / `image`），所以同一个模板能套任意一套素材；
+`image` 层可以写 `sticker://<id>` 引用中台贴图库里的透明装饰图。
+
+```json
+{
+  "canvas": { "w": 1080, "h": 1920, "bg": "#ffffff" },
+  "layers": [
+    { "type": "ellipse", "cx": 190, "cy": -131, "rx": 510, "ry": 430, "fill": "#ffd6e2" },
+    { "type": "text", "bind": "title", "x": 540, "y": 394, "size": 84, "align": "center", "maxWidth": 0.86 },
+    { "type": "slot", "bind": "image", "box": [281, 660, 518, 701], "fit": "contain", "trim": true }
+  ]
+}
+```
+
+> **不给 `--layout` 就完全不碰网络**，用内置版式出片。免登录是这个命令的立身之本，接了模板库也没丢。
+>
+> 模板结构的真源与校验都在中台。CLI 是消费方，遇到不认识的图层类型**跳过该层并提示升级**，
+> 不报错中断 —— 老 CLI 碰上新层类型该少画一层，不是彻底出不了片。
+
 三个不写出来就会踩的点，已经在实现里处理掉了：
 
 - **小图会被显式放大**。240×240 的贴纸直接贴到 1080 宽的画布上只占两成宽，画面空得离谱。
@@ -596,6 +627,8 @@ console.log(r.sculpt.light)  // 光影分析
 | `upscale <file>` | 本地超分放大，2M 图变 10M+（免登录，Real-ESRGAN GPU，`--scale 2/3/4`） | 产物路径 |
 | `remove-watermark <file>` | 本地去水印（免登录，自动定位 + LaMa 修复，`--mask` 手工兜底） | 产物路径 |
 | `slideshow <图片或目录...>` | 图集转竖版短视频（免登录，带标题/逐张文案/配乐，需 ffmpeg） | 产物路径 |
+| `slideshow-layouts` | 查排版模板：内置版式（免登录）+ 中台模板（平台/租户/私有） | slug 列表 |
+| `slideshow-layouts create <json>` | 从 JSON 新建排版模板（结构校验在服务端做） | 新模板 id |
 | `projects` | 工作区（项目）列表：一账户多项目，各带自己的素材库 | 项目 id 列表 |
 | `projects assets --project` | 项目素材库：ls / add / rm（垫图母版，人像库/产品库各管各的） | `id<TAB>url` 行 |
 | `models` | 可用模型 | 模型名列表 |

package/dist/client.d.ts

@@ -343,6 +343,20 @@ export declare class StudioClient {
     createSticker(filePath: string, name: string): Promise<any>;
     /** 删除贴图素材 */
     deleteSticker(id: string): Promise<void>;
+    /** 排版模板清单（图集视频用）：平台共享 + 本租户 + 本人私有，服务端按身份过滤 */
+    slideshowLayouts(): Promise<any[]>;
+    /** 按 slug 取单个排版模板（CLI 的 --layout 走这条） */
+    slideshowLayout(slug: string): Promise<any>;
+    /** 新建排版模板。layout 的结构校验在服务端做，这里不预校验——
+     *  两侧都校验的话，老 CLI 会把新写的合法模板判为非法。 */
+    createSlideshowLayout(input: {
+        name: string;
+        slug: string;
+        layout: unknown;
+        description?: string;
+        category?: string;
+        sample_url?: string;
+    }): Promise<any>;
     /** 版式模板清单（租户级资产）：封面底图 + 固定描述（{城市}{明星} 占位符） */
     posterTemplates(): Promise<any[]>;
     /** 上传版式模板（不压缩，保留封面底图原样） */
@@ -478,6 +492,23 @@ export declare class StudioClient {
     models(): Promise<ModelOption[]>;
     /** 查上游余额 */
     balance(): Promise<Balance>;
+    /** 提交反馈（bug / 需求）。服务端按凭证归人：账户 Key 归账户，网页 JWT 归本人。 */
+    submitFeedback(input: {
+        type: 'bug' | '需求';
+        content: string;
+        images?: string[];
+    }): Promise<{
+        ok: boolean;
+    }>;
+    /** 拉我的反馈记录（个人账户 Key / JWT 看自己的，按时间倒序） */
+    listFeedback(): Promise<Array<{
+        id: string;
+        type: string;
+        content: string;
+        status?: string;
+        reply?: string;
+        created_at: string;
+    }>>;
 }
 /**
  * 区分 imageToTemplate() 拿到的是异步回执还是结果本体。

package/dist/client.js

@@ -142,6 +142,25 @@ export class StudioClient {
     async deleteSticker(id) {
         await this.request(`stickers?id=${encodeURIComponent(id)}`, { method: 'DELETE' });
     }
+    /** 排版模板清单（图集视频用）：平台共享 + 本租户 + 本人私有，服务端按身份过滤 */
+    async slideshowLayouts() {
+        const r = await this.request('slideshow-layouts');
+        return Array.isArray(r) ? r : [];
+    }
+    /** 按 slug 取单个排版模板（CLI 的 --layout 走这条） */
+    async slideshowLayout(slug) {
+        return this.request(`slideshow-layouts?slug=${encodeURIComponent(slug)}`);
+    }
+    /** 新建排版模板。layout 的结构校验在服务端做，这里不预校验——
+     *  两侧都校验的话，老 CLI 会把新写的合法模板判为非法。 */
+    async createSlideshowLayout(input) {
+        const r = await this.request('slideshow-layouts', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(input),
+        });
+        return r.layout ?? r;
+    }
     /** 版式模板清单（租户级资产）：封面底图 + 固定描述（{城市}{明星} 占位符） */
     async posterTemplates() {
         const r = await this.request('poster-templates');
@@ -450,6 +469,19 @@ export class StudioClient {
     async balance() {
         return this.request('balance');
     }
+    /** 提交反馈（bug / 需求）。服务端按凭证归人：账户 Key 归账户，网页 JWT 归本人。 */
+    async submitFeedback(input) {
+        return this.request('feedback', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ type: input.type, content: input.content, images: input.images || [] }),
+        });
+    }
+    /** 拉我的反馈记录（个人账户 Key / JWT 看自己的，按时间倒序） */
+    async listFeedback() {
+        const r = await this.request('feedback');
+        return Array.isArray(r) ? r : [];
+    }
 }
 function sleep(ms) {
     return new Promise((r) => setTimeout(r, ms));

package/dist/commands/feedback.d.ts

@@ -0,0 +1,5 @@
+import type { StudioClient } from '../client.js';
+export declare function feedback(getClient: () => StudioClient, content: string, opts?: {
+    type?: string;
+    list?: boolean;
+}): Promise<void>;

package/dist/commands/feedback.js

@@ -0,0 +1,67 @@
+/**
+ * museav feedback —— 通过命令行提 bug / 需求，或查我的反馈记录。
+ *
+ * 为什么需要它：之前 CLI 没有 feedback，用户只能在网页后台提。命令行跑出问题（出图
+ * 失败、CLI 报错）时，最顺手的就是当下在终端补一条反馈，而不是切到浏览器。
+ *
+ * 身份：跟 CLI 其它命令一致，走 loadConfig 的凭证——
+ *   - 个人 login token → /api/feedback 按本人落库
+ *   - 账户 API Key（sk-studio-*，指向 accounts.api_key_hash）→ /api/feedback 自解析身份（2026-08 补）
+ *   - 租户 API Key 会被服务端拒（反馈是个人行为，不该落到租户组织头上）→ 报错提示用个人身份
+ *
+ * 用法：
+ *   museav feedback "出图连续失败三次"
+ *   museav feedback --type 需求 "想要批量出图后自动拼长图"
+ *   museav feedback --type bug                     # 不带内容 → 交互式输入
+ *   museav feedback --list                         # 看我的反馈记录
+ */
+import { createInterface } from 'node:readline/promises';
+import { stdin as input, stdout as output } from 'node:process';
+export async function feedback(getClient, content, opts = {}) {
+    if (opts.list) {
+        await listFeedback(getClient);
+        return;
+    }
+    const type = opts.type === '需求' ? '需求' : 'bug';
+    let text = content?.trim() || '';
+    if (!text) {
+        // 交互式：没有在命令行给内容，就逐项问。这是给"想提但没想好格式"的人用的，
+        // 也给脚本调用了一个确定的形式（--type + 位置参数）。
+        const rl = createInterface({ input, output });
+        try {
+            const pick = await rl.question(`反馈类型？（bug / 需求，默认 ${type === '需求' ? '需求' : 'bug'}）: `);
+            const picked = pick.trim();
+            const finalType = picked === '需求' ? '需求' : picked === 'bug' ? 'bug' : type;
+            const body = await rl.question(`描述（你遇到的 bug 或想要的功能）: `);
+            text = body.trim();
+            if (text) {
+                process.stderr.write(`\n提交中...\n`);
+                await getClient().submitFeedback({ type: finalType, content: text });
+                process.stderr.write(`✅ 已提交${finalType === '需求' ? '需求' : 'bug'}反馈。可以在网页「意见反馈」页看到进度。\n`);
+            }
+            else {
+                process.stderr.write(`未输入内容，已取消。\n`);
+            }
+            return;
+        }
+        finally {
+            rl.close();
+        }
+    }
+    process.stderr.write(`提交${type === '需求' ? '需求' : 'bug'}反馈...\n`);
+    await getClient().submitFeedback({ type, content: text });
+    process.stderr.write(`✅ 已提交${type === '需求' ? '需求' : 'bug'}反馈。可以在网页「意见反馈」页看到进度。\n`);
+}
+async function listFeedback(getClient) {
+    const rows = await getClient().listFeedback();
+    if (!rows.length) {
+        process.stderr.write(`还没有反馈记录。\n`);
+        return;
+    }
+    process.stderr.write(`我的反馈（${rows.length} 条）:\n`);
+    for (const r of rows) {
+        const status = r.status === 'done' ? '已完成' : r.status === 'resolved' ? '已解决' : r.status === 'pending' ? '处理中' : (r.status || '处理中');
+        const reply = r.reply ? `\n     回复: ${r.reply}` : '';
+        process.stderr.write(`\n[${r.type}] ${status} ${r.created_at}\n  ${r.content}${reply}\n`);
+    }
+}

package/dist/commands/slideshow.d.ts

@@ -8,8 +8,17 @@ export interface SlideshowCmdOpts {
     music?: string;
     sec?: string;
     size?: string;
-    art?: string;
     theme?: string;
-    trim?: boolean;
+    layout?: string;
+    layoutFile?: string;
 }
 export declare function slideshowCmd(paths: string[], opts: SlideshowCmdOpts): Promise<void>;
+/** museav slideshow-layouts —— 列出可用排版模板（内置 + 中台） */
+export declare function slideshowLayoutsCmd(): Promise<void>;
+/** museav slideshow-layouts create —— 从 JSON 文件建一个排版模板 */
+export declare function createSlideshowLayoutCmd(file: string, opts: {
+    name: string;
+    slug: string;
+    description?: string;
+    category?: string;
+}): Promise<void>;

package/dist/commands/slideshow.js

@@ -1,9 +1,15 @@
 /** museav slideshow —— 一组图 + 文案 + 配乐 → 竖版短视频。
- *  纯本地、免登录、不碰中台；stdout 只出产物路径，进度与统计打 stderr。
- *  排版走 sharp + SVG（中文用系统字体），合成走 ffmpeg，不引入需要编译的重依赖。 */
+ *  纯本地渲染、不上传任何图片；stdout 只出产物路径，进度与统计打 stderr。
+ *
+ *  版面来自排版模板：不给 --layout 用内置的（**完全免登录、不碰网络**），
+ *  给了就去中台 slideshow_layouts 拉。免登录这条路必须一直留着——
+ *  秒级出片、零成本是这个命令的立身之本，不能因为接了模板库就没了。 */
 import { readFile, readdir, stat } from 'node:fs/promises';
 import { extname, isAbsolute, join, resolve } from 'node:path';
 import { makeSlideshow, fileSize } from '../local-slideshow.js';
+import { PRESETS, PRESET_LIGHT, PRESET_DARK } from '../slideshow-presets.js';
+import { loadConfig } from '../config.js';
+import { StudioClient } from '../client.js';
 const IMG_EXT = new Set(['.png', '.jpg', '.jpeg', '.webp']);
 function fmtBytes(n) {
     return n >= 1048576 ? `${(n / 1048576).toFixed(2)}MB` : `${(n / 1024).toFixed(1)}KB`;
@@ -34,6 +40,40 @@ async function collectImages(paths) {
     }
     return out;
 }
+/** 按需建 client：只有真要拉中台模板时才需要凭证，没有 --layout 就一路不碰网络 */
+function studioClient() {
+    const cfg = loadConfig();
+    if (!cfg.token && !cfg.apiKey) {
+        throw new Error('拉中台排版模板需要登录：museav login（或配 apiKey）。\n不想登录就别传 --layout，内置版式免登录可用');
+    }
+    return new StudioClient({ baseUrl: cfg.baseUrl, apiKey: cfg.apiKey, token: cfg.token });
+}
+async function loadLayout(opts) {
+    if (opts.layoutFile) {
+        const raw = await readFile(opts.layoutFile, 'utf8').catch(() => {
+            throw new Error(`排版模板文件读不到: ${opts.layoutFile}`);
+        });
+        try {
+            return { layout: JSON.parse(raw), label: `文件 ${opts.layoutFile}` };
+        }
+        catch (e) {
+            throw new Error(`排版模板不是合法 JSON: ${e.message}`);
+        }
+    }
+    if (opts.layout) {
+        // 内置的同名模板优先命中，省一次网络往返；不在内置里才去中台拉
+        const builtin = PRESETS[opts.layout];
+        if (builtin)
+            return { layout: builtin, label: `内置 ${opts.layout}` };
+        const client = studioClient();
+        const row = await client.slideshowLayout(opts.layout);
+        if (!row?.layout)
+            throw new Error(`模板 ${opts.layout} 没有 layout 内容`);
+        return { layout: row.layout, label: `中台 ${row.name}（${row.slug}）`, client };
+    }
+    const dark = (opts.theme || 'light') === 'dark';
+    return { layout: dark ? PRESET_DARK : PRESET_LIGHT, label: dark ? '内置深色' : '内置默认' };
+}
 export async function slideshowCmd(paths, opts) {
     const images = await collectImages(paths);
     let captions = opts.caption?.length ? [...opts.caption] : [];
@@ -46,11 +86,12 @@ export async function slideshowCmd(paths, opts) {
     if (captions.length && captions.length < images.length) {
         process.stderr.write(`⚠️  文案 ${captions.length} 条少于图片 ${images.length} 张，后面几张不带文字\n`);
     }
-    const sec = opts.sec ? Number(opts.sec) : 2.5;
-    if (!Number.isFinite(sec) || sec <= 0)
+    const { layout, label, client } = await loadLayout(opts);
+    const sec = opts.sec ? Number(opts.sec) : undefined;
+    if (opts.sec && (!Number.isFinite(sec) || sec <= 0))
         throw new Error('--sec 必须是正数');
-    let width = 1080;
-    let height = 1920;
+    let width;
+    let height;
     if (opts.size) {
         const m = /^(\d+)[x×](\d+)$/i.exec(opts.size.trim());
         if (!m)
@@ -58,25 +99,84 @@ export async function slideshowCmd(paths, opts) {
         width = Number(m[1]);
         height = Number(m[2]);
     }
-    const artSize = opts.art ? Number(opts.art) : Math.round(width * 0.48);
-    if (!Number.isFinite(artSize) || artSize < 16)
-        throw new Error('--art 至少 16px');
-    const theme = (opts.theme || 'light');
-    if (!['light', 'dark'].includes(theme))
-        throw new Error('--theme 只支持 light / dark');
     const out = opts.out ? resolve(opts.out) : resolve('slideshow.mp4');
-    const total = images.length * sec;
-    process.stderr.write(`${images.length} 张 × ${sec}s ≈ ${total.toFixed(0)}s · ${width}×${height}` +
+    const effSec = sec ?? layout.seconds ?? 2.5;
+    const w = width ?? layout.canvas.w;
+    const h = height ?? layout.canvas.h;
+    process.stderr.write(`${images.length} 张 × ${effSec}s ≈ ${(images.length * effSec).toFixed(0)}s · ${w}×${h} · 版式：${label}` +
         (opts.title ? ` · 「${opts.title}」` : '') +
         (opts.music ? ' · 带配乐' : ' · 无配乐') + '\n');
+    // 贴图只在模板真的引用了 sticker:// 时才去拉，且整轮只拉一次清单
+    let stickerUrls = null;
+    const resolveSticker = async (id) => {
+        if (!stickerUrls) {
+            const c = client ?? studioClient();
+            const rows = await c.stickers().catch(() => []);
+            stickerUrls = new Map(rows.filter((r) => r?.id && r?.url).map((r) => [r.id, r.url]));
+        }
+        return stickerUrls.get(id) ?? null;
+    };
     const start = Date.now();
     const r = await makeSlideshow({
-        images, out, width, height, artSize, seconds: sec, theme, trim: opts.trim,
+        images, out, layout, width, height, seconds: sec,
         title: opts.title, subtitle: opts.subtitle, footer: opts.footer,
         captions: captions.length ? captions : undefined,
         music: opts.music ? resolve(opts.music) : undefined,
+        resolveSticker,
+        onWarn: (m) => process.stderr.write(`⚠️  ${m}\n`),
     });
     process.stderr.write(`✅ 视频生成完成（${r.pages} 页，${r.seconds.toFixed(1)}s，` +
         `${fmtBytes(await fileSize(out))}，用时 ${((Date.now() - start) / 1000).toFixed(1)}s）\n`);
     console.log(out);
 }
+/** museav slideshow-layouts —— 列出可用排版模板（内置 + 中台） */
+export async function slideshowLayoutsCmd() {
+    process.stderr.write('内置版式（免登录可用）:\n');
+    for (const slug of Object.keys(PRESETS)) {
+        process.stderr.write(`  ${slug.padEnd(28)} ${PRESETS[slug].canvas.w}×${PRESETS[slug].canvas.h}\n`);
+    }
+    let rows = [];
+    try {
+        rows = await studioClient().slideshowLayouts();
+    }
+    catch (e) {
+        // 没登录不算错：内置版式已经列出来了，这条命令仍然有用
+        process.stderr.write(`\n（中台模板未列出：${e.message.split('\n')[0]}）\n`);
+        console.log(Object.keys(PRESETS).join('\n'));
+        return;
+    }
+    if (rows.length) {
+        process.stderr.write(`\n中台模板（${rows.length} 个）:\n`);
+        for (const r of rows) {
+            const src = r.source === 'platform' ? '[平台]' : r.source === 'mine' ? '[租户]' : '[私有]';
+            const size = r.layout?.canvas ? `${r.layout.canvas.w}×${r.layout.canvas.h}` : '';
+            process.stderr.write(`  ${String(r.slug).padEnd(28)} ${String(r.name).padEnd(20)} ${size.padEnd(10)} ${src}\n`);
+        }
+    }
+    else {
+        process.stderr.write('\n中台还没有模板。用 museav slideshow-layouts create 建一个。\n');
+    }
+    process.stderr.write('\n出片: museav slideshow ./图片目录 --layout <slug>\n');
+    console.log([...Object.keys(PRESETS), ...rows.map((r) => r.slug)].join('\n'));
+}
+/** museav slideshow-layouts create —— 从 JSON 文件建一个排版模板 */
+export async function createSlideshowLayoutCmd(file, opts) {
+    const raw = await readFile(file, 'utf8').catch(() => {
+        throw new Error(`读不到文件: ${file}`);
+    });
+    let layout;
+    try {
+        layout = JSON.parse(raw);
+    }
+    catch (e) {
+        throw new Error(`不是合法 JSON: ${e.message}`);
+    }
+    const row = await studioClient().createSlideshowLayout({
+        name: opts.name, slug: opts.slug, layout,
+        description: opts.description, category: opts.category,
+    });
+    process.stderr.write(`✅ 排版模板已建：${row.name}（${row.slug}）\n`);
+    process.stderr.write(`归属：${row.visibility === 'private' ? '仅本人可见' : row.tenant_id ? '本租户共享' : '平台共享'}\n`);
+    process.stderr.write(`\n出片: museav slideshow ./图片目录 --layout ${row.slug}\n`);
+    console.log(row.id);
+}

package/dist/index.js

@@ -16,7 +16,7 @@ import { printWelcome } from './commands/welcome.js';
 import { gen } from './commands/gen.js';
 import { reverse } from './commands/reverse.js';
 import { compressCmd, removeBgCmd, upscaleCmd, removeWatermarkCmd } from './commands/img-tools.js';
-import { slideshowCmd } from './commands/slideshow.js';
+import { slideshowCmd, slideshowLayoutsCmd, createSlideshowLayoutCmd } from './commands/slideshow.js';
 import { projects, createProject, listAssets, addAsset, removeAsset } from './commands/projects.js';
 import { imageToTemplate } from './commands/image-to-template.js';
 import { upload } from './commands/upload.js';
@@ -27,6 +27,7 @@ import { videoTemplates, createVideoTemplate } from './commands/video-templates.
 import { balance } from './commands/balance.js';
 import { jobs } from './commands/jobs.js';
 import { whoami } from './commands/whoami.js';
+import { feedback } from './commands/feedback.js';
 import { products } from './commands/products.js';
 import { assets } from './commands/assets.js';
 import { stickers, createSticker } from './commands/stickers.js';
@@ -213,12 +214,24 @@ program
     .option('--captions <file>', '文案文件（每行一条，按顺序对应每张图），与 --caption 二选一')
     .option('--footer <text>', '底部引导语')
     .option('--music <file>', '配乐音频。自动裁到视频长度并加首尾淡入淡出（不会中途硬切断）')
-    .option('--sec <n>', '每张停留秒数，默认 2.5')
-    .option('--size <WxH>', '画面尺寸，默认 1080x1920')
-    .option('--art <px>', '主图渲染边长，默认画面宽的 48%')
-    .option('--theme <name>', 'light（默认）/ dark')
-    .option('--no-trim', '不裁主图四周的透明留白（默认会裁，贴纸类图片不裁会显得很小）')
+    .option('--sec <n>', '每张停留秒数，默认取模板的（内置模板 2.5）')
+    .option('--size <WxH>', '画面尺寸，默认取模板画布（内置模板 1080x1920）；与模板不同则整体等比缩放')
+    .option('--theme <name>', 'light（默认）/ dark。只影响内置版式，给了 --layout 就以模板为准')
+    .option('--layout <slug>', '排版模板 slug：内置的直接用，其余去中台拉（需登录）。清单见 museav slideshow-layouts')
+    .option('--layout-file <path>', '直接用本地 JSON 排版模板（调模板时用，免登录）')
     .action(asyncRun((paths, opts) => slideshowCmd(paths, opts)));
+const slideshowLayoutsCommand = program
+    .command('slideshow-layouts')
+    .description('查排版模板：内置版式（免登录）+ 中台模板（平台共享 / 本租户 / 本人私有）。配合 slideshow --layout 使用')
+    .action(asyncRun(() => slideshowLayoutsCmd()));
+slideshowLayoutsCommand
+    .command('create <layout.json>')
+    .description('从 JSON 文件新建排版模板——归属由身份自动决定：租户 Key 建的归本租户，个人账号建的仅本人可见。结构校验在服务端做')
+    .requiredOption('--name <名称>', '模板中文名')
+    .requiredOption('--slug <slug>', '对外调用标识（小写字母/数字/连字符，全局唯一）')
+    .option('--description <text>', '模板说明')
+    .option('--category <name>', '分类，默认「其他」')
+    .action(asyncRun((file, opts) => createSlideshowLayoutCmd(file, opts)));
 // 工作区（项目）与项目素材库：平台 → 账户 → 工作区三层归属，素材挂工作区
 const projectsCmd = program
     .command('projects')
@@ -376,6 +389,12 @@ program
     .command('whoami')
     .description('查当前登录账户 + 租户归属（仅个人 login 可用，apiKey 调用会报错）')
     .action(withClient((client) => whoami(client)));
+program
+    .command('feedback [content]')
+    .description('提 bug / 需求（不带内容则交互式输入）；--list 看我的反馈记录。个人账户可提，租户 apiKey 会被服务端拒')
+    .option('--type <type>', '反馈类型：bug / 需求（默认 bug）')
+    .option('--list', '列出我的反馈记录')
+    .action(withLazyClient((getClient, content, opts) => feedback(getClient, content || '', opts)));
 program
     .command('config')
     .description('配置中台地址和 apiKey（存到 ~/.museav.json）')

package/dist/local-slideshow.d.ts

@@ -1,19 +1,62 @@
+/** 图层类型。与中台 shared/slideshow-layout.js 的 LAYER_TYPES 对应。 */
+export type LayerType = 'rect' | 'ellipse' | 'text' | 'slot' | 'image';
+export interface Layer {
+    type: LayerType | string;
+    fill?: string;
+    opacity?: number;
+    box?: [number, number, number, number];
+    radius?: number;
+    fit?: 'contain' | 'cover';
+    trim?: boolean;
+    src?: string;
+    cx?: number;
+    cy?: number;
+    rx?: number;
+    ry?: number;
+    bind?: string | null;
+    text?: string;
+    x?: number;
+    y?: number;
+    size?: number;
+    weight?: number;
+    align?: 'left' | 'center' | 'right';
+    maxWidth?: number;
+    minSize?: number;
+}
+export interface Layout {
+    version?: number;
+    canvas: {
+        w: number;
+        h: number;
+        bg?: string;
+    };
+    seconds?: number;
+    layers: Layer[];
+}
+/** 渲染时填进模板的内容。caption / image 逐页变化，其余全局固定。 */
+export interface PageContent {
+    title?: string;
+    subtitle?: string;
+    caption?: string;
+    footer?: string;
+    image: string;
+}
 export interface SlideshowOpts {
     images: string[];
     out: string;
+    layout: Layout;
+    captions?: string[];
     title?: string;
     subtitle?: string;
-    captions?: string[];
     footer?: string;
     music?: string;
     seconds?: number;
+    /** 目标尺寸。与模板 canvas 不同时整个版面按比例缩放 */
     width?: number;
     height?: number;
-    /** 主图渲染尺寸（正方形边长）。默认 520，约占 1080 宽的 48% */
-    artSize?: number;
-    theme?: 'light' | 'dark';
-    /** 放大前先裁掉主图四周的透明留白，默认开（仅对带 alpha 的图生效） */
-    trim?: boolean;
+    /** 解析 sticker://<id> → 图片 URL/本地路径。不传则跳过这类图层 */
+    resolveSticker?: (id: string) => Promise<string | null>;
+    onWarn?: (msg: string) => void;
 }
 export declare function makeSlideshow(opts: SlideshowOpts): Promise<{
     out: string;