museav-cli 2.8.0 → 2.10.1

package/CHANGELOG.md

@@ -1,5 +1,69 @@
 # Changelog
 
+## 2.10.0 (2026-08-28)
+
+### `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` —— 一组图 + 文案 + 配乐 → 竖版短视频（免登录）
+
+```bash
+museav slideshow ./表情图 --title "莓啾日常" --caption "催外卖 / 催开饭" --music bgm.mp3
+```
+
+默认 1080×1920 / 30fps / H.264+AAC。排版走 sharp + SVG（中文用系统字体，不引入需要编译的
+canvas），合成走 ffmpeg（**要求本机装了 ffmpeg**，这是唯一的外部依赖）。
+
+这个能力原本长在微信表情包的 skill 里（一个 Python 脚本），做推广视频用。但「图集 + 文案 +
+配乐 → 竖版视频」跟表情包没关系，产品图、作品集、日报一样要用，所以下沉到 CLI，
+skill 那边退化成读配置拼参数的薄封装。
+
+移植时保留了三个已经踩过的坑的修法，它们的共同点还是**不报错、只是结果不对**：
+
+1. **小图不会被自动放大。** PIL 的 `thumbnail` 和 sharp 的 `withoutEnlargement` 都只缩不放，
+   240×240 的贴纸贴到 1080 宽的画布上会原样贴，在竖屏里只占两成宽。要显式 `resize` 到目标尺寸。
+   贴纸类图片还得先 `trim` 掉四周透明留白再放大——否则放大的是留白，主体照样小。
+2. **配乐直接 `-shortest` 会中途硬切断。** 配乐通常比视频长几倍，切在句子中间很难听。
+   要 `atrim` 裁到视频时长 + 首尾 `afade`。
+3. **ffmpeg 的 concat demuxer 会忽略最后一项的 `duration`。** 末页一闪而过，
+   只能把末页在列表里多写一次。
+
 ## 2.8.0 (2026-08-27)
 
 ### 新增：贴图素材 + 版式模板命令（租户级资产，给封面/海报工具用）

package/README.md

@@ -102,11 +102,12 @@
 | | 抠图去背景（输出透明 PNG） | `remove-bg` |
 | | **放大清晰度**（2M → 10M+ 级） | `upscale` |
 | | 去水印 | `remove-watermark` |
+| | **一组图 → 竖版短视频**（带标题/文案/配乐） | `slideshow` |
 | **语音**（直连小米 MiMo，需 `MIMO_API_KEY`） | 文字转语音 / 音色设计 / 音色克隆 | `speak` |
 | | 语音转文字 | `transcribe` |
 | **素材与统计** | 上传素材 / 查任务 / 查余额 / 查模型 / 查身份 | `upload` / `jobs` / `balance` / `models` / `whoami` |
 
-> 本地工具（`compress` / `remove-bg` / `upscale` / `remove-watermark`）**不用登录、不花一分钱**，装了就能用；其余命令需要一个凭证（个人 `login` 或租户 apiKey）。
+> 本地工具（`compress` / `remove-bg` / `upscale` / `remove-watermark` / `slideshow`）**不用登录、不花一分钱**，装了就能用；其余命令需要一个凭证（个人 `login` 或租户 apiKey）。
 >
 > 语音（`speak` / `transcribe`）是第三种情况：**不走中台身份**，直连小米 MiMo，只认 `MIMO_API_KEY` 环境变量。
 > 中台的出音链路还没接完，这批能力目前内部用，没有那把 key 的人（包括租户）用不了。
@@ -440,6 +441,67 @@ museav remove-watermark photo.jpg --mask mask.png      # 复杂画面手工掩
 - 依赖红线：本地**绝不自动拉起开源大模型**——这些工具是轻量 CNN/传统算法，用完即释放内存。reverse 的本地路已翻回显式 `--local`（需自备 Ollama），默认走中台 API。
 - 二进制与模型缓存：`~/.museav-bin/upscayl`（引擎）、`~/.museav-models/`（模型），Windows 对应 `%USERPROFILE%` 下同名目录；删除即彻底清理。
 
+### 图集转竖版短视频 `slideshow`（免登录）
+
+一组图 + 每张的文案 + 一段配乐 → 一条能直接发朋友圈 / 视频号 / 小红书的竖版视频。
+排版走 sharp + SVG（中文用系统字体），合成走 ffmpeg，**需要本机装了 ffmpeg**（`brew install ffmpeg`）。
+
+```bash
+# 最简：一个目录里的图，按文件名排序串成视频
+museav slideshow ./图片目录 --out 成片.mp4
+
+# 完整：标题 + 逐张文案 + 配乐
+museav slideshow ./表情图 \
+  --title "莓啾日常" --subtitle "莓啾 · 微信表情包" \
+  --caption "需要被安慰的时候" --caption "催外卖 / 催开饭" \
+  --footer "微信搜「莓啾日常」添加整套" \
+  --music bgm.mp3 --sec 2.2 --out 推广视频.mp4
+
+# 文案多的时候写文件里，每行一条
+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 宽的画布上只占两成宽，画面空得离谱。
+  贴纸类图片还会先裁掉四周透明留白再放大（`--no-trim` 关掉），否则放大的是留白不是主体。
+- **配乐不会中途硬切断**。配乐通常比视频长几倍，直接 `-shortest` 会在句子中间断掉；
+  这里裁到视频时长并做首尾淡入淡出。
+- **末页不会一闪而过**。ffmpeg 的 concat demuxer 会忽略最后一项的 duration，实现里把末页多列了一次。
+
 ### 项目（工作区）与项目素材库 `projects`
 
 层级：**平台 → 账户 → 工作区**。一个账户最多 5 个项目，每个项目挂自己的素材库——「人像库的项目出模特图、产品库的项目出电商图」，业务隔离互不污染：
@@ -564,6 +626,9 @@ console.log(r.sculpt.light)  // 光影分析
 | `remove-bg <file>` | 本地抠图去背景（免登录，输出带 alpha 的 PNG） | 产物路径 |
 | `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

@@ -0,0 +1,24 @@
+export interface SlideshowCmdOpts {
+    out?: string;
+    title?: string;
+    subtitle?: string;
+    footer?: string;
+    caption?: string[];
+    captions?: string;
+    music?: string;
+    sec?: string;
+    size?: string;
+    theme?: string;
+    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

@@ -0,0 +1,182 @@
+/** museav slideshow —— 一组图 + 文案 + 配乐 → 竖版短视频。
+ *  纯本地渲染、不上传任何图片；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`;
+}
+/** 入参可以是若干张图，也可以是一个目录（目录内按文件名排序，所以图片建议带序号前缀） */
+async function collectImages(paths) {
+    const out = [];
+    for (const p of paths) {
+        const abs = isAbsolute(p) ? p : resolve(p);
+        let st;
+        try {
+            st = await stat(abs);
+        }
+        catch {
+            throw new Error(`路径不存在: ${p}`);
+        }
+        if (st.isDirectory()) {
+            const names = (await readdir(abs))
+                .filter((n) => !n.startsWith('.') && IMG_EXT.has(extname(n).toLowerCase()))
+                .sort((a, b) => a.localeCompare(b, 'zh-Hans-CN', { numeric: true }));
+            if (!names.length)
+                throw new Error(`目录里没有图片: ${p}`);
+            out.push(...names.map((n) => join(abs, n)));
+        }
+        else {
+            out.push(abs);
+        }
+    }
+    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] : [];
+    if (opts.captions) {
+        const text = await readFile(opts.captions, 'utf8').catch(() => {
+            throw new Error(`文案文件读不到: ${opts.captions}`);
+        });
+        captions = text.split('\n').map((l) => l.trim()).filter(Boolean);
+    }
+    if (captions.length && captions.length < images.length) {
+        process.stderr.write(`⚠️  文案 ${captions.length} 条少于图片 ${images.length} 张，后面几张不带文字\n`);
+    }
+    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;
+    let height;
+    if (opts.size) {
+        const m = /^(\d+)[x×](\d+)$/i.exec(opts.size.trim());
+        if (!m)
+            throw new Error('--size 格式是 宽x高，如 1080x1920');
+        width = Number(m[1]);
+        height = Number(m[2]);
+    }
+    const out = opts.out ? resolve(opts.out) : resolve('slideshow.mp4');
+    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, 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,6 +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, 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';
@@ -26,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';
@@ -202,6 +204,34 @@ program
     .option('--mask <file>', '手工掩码图（白色=要去除的区域），跳过自动定位')
     .option('--overwrite', '允许覆盖已存在的输出文件')
     .action(asyncRun((input, opts) => removeWatermarkCmd(input, opts)));
+program
+    .command('slideshow <图片或目录...>')
+    .description('本地图集转竖版短视频（sharp + ffmpeg，免登录）：默认 1080×1920 / 30fps / H.264，可加标题、逐张文案与配乐。需要本机有 ffmpeg')
+    .option('--out <path>', '输出 mp4（默认当前目录 slideshow.mp4）')
+    .option('--title <text>', '顶部主标题（大字）')
+    .option('--subtitle <text>', '顶部副标题（小字）')
+    .option('--caption <text>', '单页文案，可重复传，按顺序对应每张图', (v, acc) => [...acc, v], [])
+    .option('--captions <file>', '文案文件（每行一条，按顺序对应每张图），与 --caption 二选一')
+    .option('--footer <text>', '底部引导语')
+    .option('--music <file>', '配乐音频。自动裁到视频长度并加首尾淡入淡出（不会中途硬切断）')
+    .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')
@@ -359,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）')