museav-cli 2.10.2 → 3.0.0

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # Changelog
 
+## 3.0.0 (2026-08-28)
+
+### 破坏性变更：`slideshow` / `slideshow-layouts` 下线，出片改用 reel-kit
+
+2.9.0 在这里做了「图集转竖版短视频」。**当天就发现
+[reel-kit](https://github.com/webkubor/reel-kit) 早已做了同一件事，而且更好**：
+
+| | reel-kit | museav slideshow（已下线） |
+|---|---|---|
+| 排版 | HTML/CSS —— 文字换行、阴影、渐变都免费 | SVG，**不支持文字换行** |
+| 加版式 | 往 `templates/` 丢一个 HTML | 手写图层 DSL |
+| 配音 | 有，且**镜头时长由念白长度决定** | 无 |
+| TTS 成本 | 本地 voxcraft，一次性模型、之后免费 | — |
+
+所以能力收敛到 reel-kit 一处：
+
+```bash
+reel make --template sticker-promo \
+  --assets ./图片目录 --caps 文案.txt \
+  --title "标题" --bgm 儿童轻快 --out 成片.mp4
+```
+
+装：`cd <reel-kit 检出> && pnpm install && npm link`（需 ffmpeg + Chrome）。
+找不到检出位置就 `cs repo reel-kit`。
+
+**命令留了存根**而不是直接删：已发布过 2.9~2.10，脚本里可能写着 `museav slideshow`，
+直接删只会得到一句 `unknown command`。现在跑它会打印迁移说明并以退出码 1 结束，
+老参数（`--title` / `--layout` 等）也不会导致解析报错。下个大版本移除存根。
+
+一并移除：`src/local-slideshow.ts`、`src/slideshow-presets.ts`、`src/commands/slideshow.ts`，
+以及 `StudioClient` 上的 `slideshowLayouts` / `slideshowLayout` / `createSlideshowLayout`
+（`client.ts` 是包的公开导出，留没人调的方法会让人以为还能用）。
+
+中台的 `/api/slideshow-layouts` 与 `slideshow_layouts` 表**没有删**（删表不可逆），
+但当前没有消费者。若将来要给 reel-kit 做「模板跨机器共享」，那张表可以改存 HTML 模板复用。
+
+### museav 的边界因此更清楚了
+
+**museav 管素材**：`remove-bg` 抠图、`upscale` 超分、`remove-watermark` 去水印、
+`compress` 压缩、`gen` 生成图/视频素材。
+**reel-kit 管成品合成**：套版式、配文案、配乐、配音、烧字幕。
+
+reel-kit 那边早就明写了这条边界（「本工具不做抠图 —— 那是 museav remove-bg 的职责，
+在这里重做一遍只会变成第二套实现」），是这边越了界。教训：动手前先 `cs repo <关键词>` 搜一遍。
+
 ## 2.10.2 (2026-08-28)
 
 ### 修复：排版模板的图层顺序失效，图片会盖住它下面该有的文字

package/README.md

@@ -102,12 +102,14 @@
 | | 抠图去背景（输出透明 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` / `slideshow`）**不用登录、不花一分钱**，装了就能用；其余命令需要一个凭证（个人 `login` 或租户 apiKey）。
+> 本地工具（`compress` / `remove-bg` / `upscale` / `remove-watermark`）**不用登录、不花一分钱**，装了就能用；其余命令需要一个凭证（个人 `login` 或租户 apiKey）。
+>
+> **出成品视频不在这里** —— 图集转竖版短视频、配音、烧字幕走 [reel-kit](https://github.com/webkubor/reel-kit)（`reel` 命令）。
+> museav 管的是**素材**（抠图/超分/去水印/AI 生成），reel-kit 管**成品合成**。曾经有过 `museav slideshow`，3.0.0 已下线，见 CHANGELOG。
 >
 > 语音（`speak` / `transcribe`）是第三种情况：**不走中台身份**，直连小米 MiMo，只认 `MIMO_API_KEY` 环境变量。
 > 中台的出音链路还没接完，这批能力目前内部用，没有那把 key 的人（包括租户）用不了。
@@ -441,66 +443,27 @@ museav remove-watermark photo.jpg --mask mask.png      # 复杂画面手工掩
 - 依赖红线：本地**绝不自动拉起开源大模型**——这些工具是轻量 CNN/传统算法，用完即释放内存。reverse 的本地路已翻回显式 `--local`（需自备 Ollama），默认走中台 API。
 - 二进制与模型缓存：`~/.museav-bin/upscayl`（引擎）、`~/.museav-models/`（模型），Windows 对应 `%USERPROFILE%` 下同名目录；删除即彻底清理。
 
-### 图集转竖版短视频 `slideshow`（免登录）
+### 出成品视频请用 reel-kit（不在本 CLI）
 
-一组图 + 每张的文案 + 一段配乐 → 一条能直接发朋友圈 / 视频号 / 小红书的竖版视频。
-排版走 sharp + SVG（中文用系统字体），合成走 ffmpeg，**需要本机装了 ffmpeg**（`brew install ffmpeg`）。
+图集转竖版短视频、配音、烧字幕这些**成品合成**能力在
+[reel-kit](https://github.com/webkubor/reel-kit)（`reel` 命令），不在 museav：
 
 ```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 发新版：
+reel make --template sticker-promo \
+  --assets ./图片目录 --caps 文案.txt \
+  --title "标题" --bgm 儿童轻快 --out 成片.mp4
 
-```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 }
-  ]
-}
+reel templates    # 看版式（模板是 templates/*.html，丢一个进去就是新版式）
+reel bgm          # 看配乐库（带授权信息）
 ```
 
-> **不给 `--layout` 就完全不碰网络**，用内置版式出片。免登录是这个命令的立身之本，接了模板库也没丢。
->
-> 模板结构的真源与校验都在中台。CLI 是消费方，遇到不认识的图层类型**跳过该层并提示升级**，
-> 不报错中断 —— 老 CLI 碰上新层类型该少画一层，不是彻底出不了片。
+2.9.0 曾在 museav 做过一个 `slideshow`，当天就发现 reel-kit 早已做了同一件事而且更好
+（HTML/CSS 排版能换行、支持配音且镜头时长由念白决定、本地 TTS 零成本），
+**3.0.0 已下线**，命令留了存根打印迁移说明。
 
-三个不写出来就会踩的点，已经在实现里处理掉了：
+职责边界：**museav 管素材**（`remove-bg` 抠图、`upscale` 超分、`gen` 出图出视频素材），
+**reel-kit 管成品合成**。同一件事没必要两套实现。
 
-- **小图会被显式放大**。240×240 的贴纸直接贴到 1080 宽的画布上只占两成宽，画面空得离谱。
-  贴纸类图片还会先裁掉四周透明留白再放大（`--no-trim` 关掉），否则放大的是留白不是主体。
-- **配乐不会中途硬切断**。配乐通常比视频长几倍，直接 `-shortest` 会在句子中间断掉；
-  这里裁到视频时长并做首尾淡入淡出。
-- **末页不会一闪而过**。ffmpeg 的 concat demuxer 会忽略最后一项的 duration，实现里把末页多列了一次。
 
 ### 项目（工作区）与项目素材库 `projects`
 
@@ -626,9 +589,7 @@ 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 |
+| `slideshow` / `slideshow-layouts` | **已下线（3.0.0）**，出片走 reel-kit；跑一下会打印迁移说明 | 迁移指引 |
 | `projects` | 工作区（项目）列表：一账户多项目，各带自己的素材库 | 项目 id 列表 |
 | `projects assets --project` | 项目素材库：ls / add / rm（垫图母版，人像库/产品库各管各的） | `id<TAB>url` 行 |
 | `models` | 可用模型 | 模型名列表 |

package/dist/client.d.ts

@@ -343,20 +343,6 @@ 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[]>;
     /** 上传版式模板（不压缩，保留封面底图原样） */

package/dist/client.js

@@ -142,25 +142,11 @@ 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;
-    }
+    // slideshowLayouts / slideshowLayout / createSlideshowLayout 已随 slideshow 命令下线（3.0.0）。
+    // 中台的 /api/slideshow-layouts 与 slideshow_layouts 表仍在（没删表，那是不可逆操作），
+    // 但当前没有消费者 —— 出片走 reel-kit，它的版式是本地 HTML 模板。
+    // 若将来要给 reel-kit 做「模板跨机器共享」，那张表可以改存 HTML 模板复用，
+    // 到时再按需要的形状重写客户端方法，而不是留一份没人调的死代码在公开导出里。
     /** 版式模板清单（租户级资产）：封面底图 + 固定描述（{城市}{明星} 占位符） */
     async posterTemplates() {
         const r = await this.request('poster-templates');

package/dist/index.js

@@ -16,7 +16,6 @@ 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';
@@ -204,34 +203,42 @@ 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)));
+/**
+ * slideshow / slideshow-layouts —— 已下线（3.0.0），转向 reel-kit。
+ *
+ * 2.9.0 在这里做了「图集转竖版短视频」，当天就发现 reel-kit
+ * （github.com/webkubor/reel-kit）早已做了同一件事，而且更好：
+ * 版式走 HTML/CSS（文字能换行、能做阴影渐变，这里的 SVG 方案做不到）、
+ * 支持配音且镜头时长由念白长度决定、默认本地 TTS 零成本、
+ * 加版式只需往 templates/ 丢一个 HTML。
+ *
+ * 所以能力收敛到 reel-kit 一处，这边下线。**留存根而不是直接删命令**：
+ * 已发布过 2.9~2.10，脚本里可能写着 museav slideshow，
+ * 直接删会得到一句 "unknown command" 而不知道该去哪 —— 存根负责把人送到对岸。
+ * 下个大版本再移除。
+ *
+ * museav 的边界因此回到：素材处理（compress/remove-bg/upscale/remove-watermark）
+ * + AI 生成（gen）+ 中台资产。成品合成不在这里。
+ */
+const RETIRED_HINT = (cmd) => (`museav ${cmd} 已下线（3.0.0），出片能力收敛到 reel-kit：\n\n` +
+    `  reel make --template sticker-promo \\\n` +
+    `    --assets ./图片目录 --caps 文案.txt \\\n` +
+    `    --title "标题" --bgm 儿童轻快 --out 成片.mp4\n\n` +
+    `装： cd <reel-kit 检出目录> && pnpm install && npm link   （需 ffmpeg + Chrome）\n` +
+    `找： cs repo reel-kit\n` +
+    `看版式： reel templates    看配乐： reel bgm\n\n` +
+    `为什么换：reel-kit 的版式走 HTML/CSS（文字能换行、能做阴影渐变），\n` +
+    `还支持配音且镜头时长由念白决定，本地 TTS 零成本。同一件事没必要两套实现。`);
+for (const [name, args] of [['slideshow', ' [图片或目录...]'], ['slideshow-layouts', '']]) {
+    program
+        .command(`${name}${args}`)
+        .description(`（已下线，改用 reel-kit 的 reel make —— 跑一下看迁移说明）`)
+        .allowUnknownOption() // 老命令行里带着 --title/--layout 等参数，也要能跑到提示这一步
+        .action(() => {
+        process.stderr.write(`\n${RETIRED_HINT(name)}\n`);
+        process.exit(1);
+    });
+}
 // 工作区（项目）与项目素材库：平台 → 账户 → 工作区三层归属，素材挂工作区
 const projectsCmd = program
     .command('projects')

package/package.json

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

package/src/client.ts

@@ -452,30 +452,11 @@ export class StudioClient {
     await this.request(`stickers?id=${encodeURIComponent(id)}`, { method: 'DELETE' })
   }
 
-  /** 排版模板清单（图集视频用）：平台共享 + 本租户 + 本人私有，服务端按身份过滤 */
-  async slideshowLayouts(): Promise<any[]> {
-    const r = await this.request('slideshow-layouts')
-    return Array.isArray(r) ? r : []
-  }
-
-  /** 按 slug 取单个排版模板（CLI 的 --layout 走这条） */
-  async slideshowLayout(slug: string): Promise<any> {
-    return this.request(`slideshow-layouts?slug=${encodeURIComponent(slug)}`)
-  }
-
-  /** 新建排版模板。layout 的结构校验在服务端做，这里不预校验——
-   *  两侧都校验的话，老 CLI 会把新写的合法模板判为非法。 */
-  async createSlideshowLayout(input: {
-    name: string; slug: string; layout: unknown
-    description?: string; category?: string; sample_url?: string
-  }): Promise<any> {
-    const r = await this.request('slideshow-layouts', {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(input),
-    })
-    return r.layout ?? r
-  }
+  // slideshowLayouts / slideshowLayout / createSlideshowLayout 已随 slideshow 命令下线（3.0.0）。
+  // 中台的 /api/slideshow-layouts 与 slideshow_layouts 表仍在（没删表，那是不可逆操作），
+  // 但当前没有消费者 —— 出片走 reel-kit，它的版式是本地 HTML 模板。
+  // 若将来要给 reel-kit 做「模板跨机器共享」，那张表可以改存 HTML 模板复用，
+  // 到时再按需要的形状重写客户端方法，而不是留一份没人调的死代码在公开导出里。
 
   /** 版式模板清单（租户级资产）：封面底图 + 固定描述（{城市}{明星} 占位符） */
   async posterTemplates(): Promise<any[]> {

package/src/index.ts

@@ -16,7 +16,6 @@ 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, resolveWorkspace } from './commands/projects.js'
 import { imageToTemplate } from './commands/image-to-template.js'
 import { upload } from './commands/upload.js'
@@ -212,36 +211,45 @@ program
   .option('--overwrite', '允许覆盖已存在的输出文件')
   .action(asyncRun((input: string, opts: any) => 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: string, acc: string[]) => [...acc, v], [] as string[])
-  .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: string[], opts: any) => 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: string, opts: any) => createSlideshowLayoutCmd(file, opts)))
+/**
+ * slideshow / slideshow-layouts —— 已下线（3.0.0），转向 reel-kit。
+ *
+ * 2.9.0 在这里做了「图集转竖版短视频」，当天就发现 reel-kit
+ * （github.com/webkubor/reel-kit）早已做了同一件事，而且更好：
+ * 版式走 HTML/CSS（文字能换行、能做阴影渐变，这里的 SVG 方案做不到）、
+ * 支持配音且镜头时长由念白长度决定、默认本地 TTS 零成本、
+ * 加版式只需往 templates/ 丢一个 HTML。
+ *
+ * 所以能力收敛到 reel-kit 一处，这边下线。**留存根而不是直接删命令**：
+ * 已发布过 2.9~2.10，脚本里可能写着 museav slideshow，
+ * 直接删会得到一句 "unknown command" 而不知道该去哪 —— 存根负责把人送到对岸。
+ * 下个大版本再移除。
+ *
+ * museav 的边界因此回到：素材处理（compress/remove-bg/upscale/remove-watermark）
+ * + AI 生成（gen）+ 中台资产。成品合成不在这里。
+ */
+const RETIRED_HINT = (cmd: string) => (
+  `museav ${cmd} 已下线（3.0.0），出片能力收敛到 reel-kit：\n\n` +
+  `  reel make --template sticker-promo \\\n` +
+  `    --assets ./图片目录 --caps 文案.txt \\\n` +
+  `    --title "标题" --bgm 儿童轻快 --out 成片.mp4\n\n` +
+  `装： cd <reel-kit 检出目录> && pnpm install && npm link   （需 ffmpeg + Chrome）\n` +
+  `找： cs repo reel-kit\n` +
+  `看版式： reel templates    看配乐： reel bgm\n\n` +
+  `为什么换：reel-kit 的版式走 HTML/CSS（文字能换行、能做阴影渐变），\n` +
+  `还支持配音且镜头时长由念白决定，本地 TTS 零成本。同一件事没必要两套实现。`
+)
+
+for (const [name, args] of [['slideshow', ' [图片或目录...]'], ['slideshow-layouts', '']] as const) {
+  program
+    .command(`${name}${args}`)
+    .description(`（已下线，改用 reel-kit 的 reel make —— 跑一下看迁移说明）`)
+    .allowUnknownOption() // 老命令行里带着 --title/--layout 等参数，也要能跑到提示这一步
+    .action(() => {
+      process.stderr.write(`\n${RETIRED_HINT(name)}\n`)
+      process.exit(1)
+    })
+}
 
 // 工作区（项目）与项目素材库：平台 → 账户 → 工作区三层归属，素材挂工作区
 const projectsCmd = program

package/dist/commands/slideshow.d.ts

@@ -1,24 +0,0 @@
-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

@@ -1,182 +0,0 @@
-/** 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);
-}