museav-cli 2.10.2 → 3.0.1

package/AGENTS.md

@@ -6,6 +6,24 @@ This CLI is designed to be used directly by coding agents (Claude Code, Codex, e
 
 A command-line client for the "studio" image-generation platform (`https://manager.museav.top`). It generates images from a prompt, reverse-engineers a prompt from an existing image, and lists your own generation history. All output is designed for machine consumption: **stdout carries only the final result** (a URL, a prompt string, or JSON); progress and human-readable info goes to stderr.
 
+## Scope: this tool makes *assets*, not finished videos
+
+Know the boundary before you pick a tool:
+
+| You need | Use |
+|---|---|
+| An image, or a raw video clip from a model | `museav gen` (add `--video`) |
+| Cut out a background / upscale / de-watermark / compress | `museav remove-bg` / `upscale` / `remove-watermark` / `compress` |
+| **A finished vertical short video** (images + per-shot captions + BGM/voiceover, templated) | **[reel-kit](https://github.com/webkubor/reel-kit)** — `reel make` |
+
+`museav gen --video` gives you a **silent, caption-less clip** — that's raw material, not
+something you post. Assembling material into a publishable short is reel-kit's job: its
+layouts are HTML/CSS templates, it does voiceover, and **shot length follows the narration**.
+
+> `museav slideshow` existed in 2.9–2.10 and was **retired in 3.0.0** — it duplicated
+> reel-kit. The command still exists as a stub that prints migration instructions.
+> Don't try to bring it back; use reel-kit.
+
 ## Auth: pick one identity, not both
 
 - **You're acting as an individual user** (a person's own account): `museav login` — opens a device-authorization flow (prints a code + URL, polls until the user approves in a browser). Token cached in `~/.museav.json`, valid 7 days.

package/CHANGELOG.md

@@ -1,5 +1,65 @@
 # Changelog
 
+## 3.0.1 (2026-08-28)
+
+### 把 reel-kit 的推荐位做实
+
+3.0.0 只是下线了 slideshow，但没告诉人「那该用什么」——README 里只有一句藏在引用块里的
+说明，agent 读的 AGENTS.md 里一个字都没提。补三处：
+
+- **README** 加独立小节「🎬 要出成品视频？用 reel-kit」，带命令示例与分工对照表
+- **AGENTS.md** 加 "Scope: this tool makes *assets*, not finished videos" ——
+  agent 被要求「做个视频」时，第一眼就能看到该去哪
+- **`gen --video` 出片后提示一行**：模型出的是无声无字幕素材，不是成品。
+  这不是广告，是防止两种误解——以为「出完了」，或以为 museav 该管配音烧字幕
+
+典型链路写清楚了：`museav gen` 出图 → `museav remove-bg` 抠图 → `reel make` 出片。
+
+## 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,16 +102,44 @@
 | | 抠图去背景（输出透明 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）。
 >
 > 语音（`speak` / `transcribe`）是第三种情况：**不走中台身份**，直连小米 MiMo，只认 `MIMO_API_KEY` 环境变量。
 > 中台的出音链路还没接完，这批能力目前内部用，没有那把 key 的人（包括租户）用不了。
 
+### 🎬 要出成品视频？用 [reel-kit](https://github.com/webkubor/reel-kit)
+
+museav 出的是**素材**：`gen --video` 给你的是一段**无声、无字幕的片子**，
+那是原料，不是能直接发的成品。把素材装配成能发的竖版短片是
+**[reel-kit](https://github.com/webkubor/reel-kit)** 的活：
+
+```bash
+reel make --template sticker-promo \
+  --assets ./图片目录 --caps 文案.txt \
+  --title "标题" --bgm 儿童轻快 --out 成片.mp4
+```
+
+- 版式是 `templates/*.html`，**改 CSS 就是改版式**，丢一个 HTML 进去就是一个新模板
+- 支持配音，且**镜头时长跟着念白走**（念快的不干等，念慢的不被切）
+- 配音默认走本地 TTS，批量出片不花钱
+
+两边的分工是明确的，reel-kit 也在它的 README 里写了同一条边界：
+
+| 你要的 | 用谁 |
+|---|---|
+| 一张图 / 一段模型出的原始片子 | `museav gen`（加 `--video`） |
+| 抠图 / 超分 / 去水印 / 压缩 | `museav remove-bg` / `upscale` / `remove-watermark` / `compress` |
+| **一支能直接发的竖版短片** | **`reel make`** |
+
+典型链路：`museav gen` 出图 → `museav remove-bg` 抠图 → `reel make` 出片。
+
+> `museav slideshow` 在 2.9~2.10 存在过，**3.0.0 已下线** —— 它和 reel-kit 重复了。
+> 命令还在但只会打印迁移说明。详见 [CHANGELOG](./CHANGELOG.md)。
+
 ---
 
 ## 快速开始
@@ -441,66 +469,16 @@ 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` 换深色底。
-
-#### 排版模板：版面不写死在代码里
+### 出成品视频：走 reel-kit
 
-版面由一份**图层 DSL** 描述，模板库在中台，改版式不用等 CLI 发新版：
+不在本 CLI，见上面 [🎬 要出成品视频](#-要出成品视频用-reel-kit)。常用三条：
 
 ```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
+reel make --template sticker-promo --assets ./图 --caps 文案.txt --out 成片.mp4
+reel templates    # 看版式
+reel bgm          # 看配乐库（带授权）
 ```
 
-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`
 
@@ -626,9 +604,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/commands/gen.js

@@ -88,6 +88,12 @@ export async function gen(client, opts) {
             throw new Error(`视频生成失败: ${result.error || '未知原因'}`);
         }
         process.stderr.write(`✅ 视频完成\n`);
+        // 模型出的是**无声、无字幕的素材**，不是能直接发的成品。这一行是为了让人在拿到
+        // URL 的那一刻就知道下一步去哪 —— 而不是以为「出完了」，或者反过来以为
+        // museav 该管配音烧字幕（那是 reel-kit 的活，两边边界见 AGENTS.md）。
+        // 只在视频模式提示，且走 stderr 不污染 stdout。
+        process.stderr.write(`   这是无声无字幕的素材。要装配成能发的成品（配文案/配乐/配音）：\n` +
+            `   reel make --assets <图目录> --caps 文案.txt   → github.com/webkubor/reel-kit\n`);
         console.log(result.cdn_url);
         return;
     }

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.1",
   "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/commands/gen.ts

@@ -109,6 +109,14 @@ export async function gen(client: StudioClient, opts: {
       throw new Error(`视频生成失败: ${result.error || '未知原因'}`)
     }
     process.stderr.write(`✅ 视频完成\n`)
+    // 模型出的是**无声、无字幕的素材**，不是能直接发的成品。这一行是为了让人在拿到
+    // URL 的那一刻就知道下一步去哪 —— 而不是以为「出完了」，或者反过来以为
+    // museav 该管配音烧字幕（那是 reel-kit 的活，两边边界见 AGENTS.md）。
+    // 只在视频模式提示，且走 stderr 不污染 stdout。
+    process.stderr.write(
+      `   这是无声无字幕的素材。要装配成能发的成品（配文案/配乐/配音）：\n` +
+      `   reel make --assets <图目录> --caps 文案.txt   → github.com/webkubor/reel-kit\n`,
+    )
     console.log(result.cdn_url)
     return
   }

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>;