---

能做什么

2026 campaign（v2）	案例模板（v1）	本地工作流
24 秒、1920×1080、30fps 品牌宣传片	32.5 秒横屏视频模板（case JSON 驱动）	全部素材在本机 Remotion / Chrome 内渲染
2160×2880 海报、1920×1080 封面、1080×1080 方图	2160×2880 宣传图 + 从视频导出的 16:9 封面	CLI 分别导出视频、图片或全部产物
体素鲸鱼、DSH 插件市场真实界面、事件音效	七段结构、程序化 BGM、截图与合成界面	--dry-run 先生成渲染参数，不启动渲染

两条管线并存：

• v2 campaign（新）：studio/src/v2/ 下的品牌片与海报系统，默认讲 dsh-reel-studio 自己的故事（在 DSH 里搜插件 → 安装 → 读仓库 → 写分镜 → 出片），画面使用暗色 DSH 插件市场 UI 与体素鲸鱼。海报/封面由 design/ 的 HTML 模板生成。
• v1 案例模板：studio/src/PluginDemo.tsx + cases/*.json，用于把某个插件的资料套进固定 32.5 秒模板；仍需要人工适配部分镜头（见编辑案例）。

当前是可运行的示例项目，不是"给个仓库地址就自动出片"的成品。 宿主工具（reel_scan / reel_plan / reel_render）仍是脚手架能力；v2 campaign 目前是 dsh-reel 自己的品牌物料，参数化到任意插件是下一步路线。

样片与素材

观看 24 秒 campaign 片 · 3:4 安装海报 · 16:9 封面 · 1:1 方图 · 关键帧

新版 campaign 讲的是 dsh-reel-studio 自己：在 DSH 插件市场里搜到它、安装、让它把一个插件仓库读成一条片子和一张图。片中市场界面按真实 dshmarket / DSH 插件页结构重建，文案逐字取自已核对文案；不包含伪造的下载量、星数或"官方认证"。

v1 案例模板的旧示例介绍的是 omdsh-dev/DSH-better-sidebar（MIT 许可，截图来自该仓库，任务/侧边对话面板为合成界面）；案例里的下载量与 Stars 是静态示例数据。

V0.1 真机界面宣传片管线（Better Sidebar）

2026-11 新增：以目标插件的真实界面为主、30 秒以内的宣传片方法。首个案例是 Better Sidebar（MIT，截图来自其官方仓库）。

• 28 秒成片（1080p / 30fps / 带声音）
• 方法总结：读插件 → 定分镜 → 收干净素材 → 侧栏壳 → 鲸鱼运动 → 声音 → QA
• 案例拆解：功能表、28s 时间线、素材来源、已知限制
• Onetake comp 参考：实际分镜/动画代码（依赖 Onetake 运行时，不随仓库分发）

安装 / 使用海报

3:4 · 2160×2880：插件市场搜索、命令行安装、三步使用、Star 入口和微信群二维码。源文件在 design/install-poster.html。

这条管线目前是手动分镜 + 外部 Onetake 渲染：素材、tab 坐标、音频事件需要按目标插件逐个调整；不是“给仓库地址就自动出片”。

Onetake 许可说明（重要）

• 本仓库里的 Onetake comp / 工作流，仅用于开发和制作 DSH 插件相关的宣传素材；
• Onetake 本身不是商用授权：它是 PolyForm Noncommercial 许可，只能用于非商业用途；
• 任何人如果要把 Onetake 或其渲染产物用于商业用途，需要自行向 Onetake 作者取得另行商业授权；
• 本仓库不包含、也不分发 Onetake 运行时；商用前请同时确认 Onetake、截图、字体、音乐等全部素材的许可。

交流群

对 dsh-reel-studio 感兴趣、想反馈问题或一起做插件宣传片，可以扫码进群：

群聊：dsh-deel · 二维码 7 天内有效（11 月 11 日前）

快速开始

1. 准备环境并安装渲染依赖

需要 Node.js 22+、pnpm 和 Chrome／Chromium。下面的命令在仓库的 studio/ 中安装 Remotion 依赖；单独渲染示例无需先接入 DSH。

git clone https://github.com/Eileenes/dsh-reel.git
cd dsh-reel/studio
pnpm install
cd ..

CLI 会检查 macOS、Windows 与 Linux 的常见 Chrome 路径。浏览器不在这些位置时，可设置 CHROME_PATH；以下是 macOS shell 示例：

export CHROME_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"

未找到浏览器时，CLI 会使用 Remotion 的默认浏览器处理方式。首次安装依赖或获取浏览器可能需要联网。

2. 渲染 2026 campaign（v2，推荐先看这个）

# 24 秒品牌片（1920×1080 / 30fps）
cd studio
node_modules/.bin/remotion render src/v2/entry.tsx ReelPromo out/reel-promo.mp4 \
  --codec h264 --crf 16 --concurrency=1
cd ..

# 海报 / 封面 / 方图（HTML 模板 → headless Chrome → docs/）
bash design/build.sh

本机 macOS 上 3D 场景走 ANGLE/Metal；remotion.config.ts 已设置 setChromiumOpenGlRenderer('angle')。 1080p 全片建议 --concurrency=1，4 并发在 24GB 机器上会 OOM。

音轨 studio/public/audio/v2/preview-mix.mp3 已随仓库提供：**120 BPM 卡点 BGM（A 小调，Am–F–C–G）

• 事件驱动音效**，两条 24s 片共用。重做声音：

python3 studio/scripts/make_music_v2.py          # -> public/audio/v2/music-bed.wav
python3 studio/scripts/make_sfx_v2.py \
  --music public/audio/v2/music-bed.wav \
  --mix out/p1-audio-mix.wav
ffmpeg -i out/p1-audio-mix.wav -b:a 192k public/audio/v2/preview-mix.mp3

没有音乐时 make_sfx_v2.py 仍会退回到原来的 drone + 音效版本。

3. 检查案例，再渲染（v1 模板）

在仓库根目录执行：

# 只检查基础字段并生成 props，不渲染
node scripts/reel.mjs --case cases/dsh-better-sidebar.json --dry-run

# 生成视频、视频封面和宣传图
node scripts/reel.mjs --case cases/dsh-better-sidebar.json --mode both

也可以分别生成：

# 视频和视频封面
node scripts/reel.mjs --case cases/dsh-better-sidebar.json --mode video

# 仅宣传图
node scripts/reel.mjs --case cases/dsh-better-sidebar.json --mode image

4. 查看结果并检查内容

产物写入 studio/out/。文件名前缀取自 plugin.handle，未提供时使用 plugin.name，再转换成小写英文、数字和连字符。

文件	用途
props-<slug>.json	本次使用的案例参数；dry-run 也会生成
<slug>-demo.mp4	H.264 视频，包含配乐
<slug>-poster.png	视频封面，默认第 825 帧
<slug>-promo.png	按 2 倍尺寸导出的宣传图

使用 --poster-frame 825 可指定封面帧；当前视频的有效帧为 0–974。同一文件名前缀再次渲染会覆盖已有结果，请先保存需要保留的版本。发布前逐帧检查文案、截图、数字、安装命令与授权信息。

编辑案例与模板

以 现有案例 为起点复制一份 JSON，然后修改字段：

区域	内容	注意事项
plugin	名称、英文 handle、版本、地址、安装命令、标语、下载量、Stars	数字由案例提供，不会联网核实；repo 用于画面展示
features	功能编号、标题、说明、配色及截图或 mock	当前布局按四张功能卡片设计；改变数量需检查布局
promo	问题、产品介绍、操作步骤与地址	宣传图读取这些字段；视频只读取其中部分字段

功能截图的 img 路径相对 studio/public/，例如 shots/files-tree.png；内置 mock 可选 tasks 或 sidechat。完整字段形状见 数据类型与默认值。CLI 只校验 plugin.name、非空 features 和 promo.address，通过 dry-run 不代表其他字段、素材或画面已经完整。

案例配置尚未覆盖整个画面。 视频模板 和 宣传图模板 中仍有固定标题、侧栏文案、截图路径、MIT 标签和 DSH 版本文字；宣传图主截图也不是从 features 读取。为其他项目制作素材时，请逐项替换这些内容，不能仅更改 JSON 就直接发布。

v2 campaign 与 v1 案例是两套模板。 studio/src/v2/ 的 24 秒片、海报与封面目前为 dsh-reel-studio 自身定制，数据与文案集中在 src/v2/data/、src/v2/scenes/；把 campaign 参数化到任意插件（由 case JSON 驱动镜头与文案）是下一阶段工作，尚未完成。

已核实的介绍与截图 → 案例 JSON → 模板适配 → 本地渲染 → 内容与画面检查

DSH 宿主接入

仓库通过 cordis.patch.yml 和 package.json 中的 dsh.bundle 声明宿主入口，工具实现在 lib/index.js。

工具	当前实现
reel_scan	读取本地 package.json，检测部分 README 文件名是否存在，列出 docs/screenshots、assets、preview 中的顶层图片
reel_plan	将名称、简介和数据点填入固定的七段分镜对象；引入、问题与用法仍是侧栏示例文案
reel_render	调用本地 CLI，根据案例文件渲染视频、图片或全部产物

reel_scan 不会解析 README 正文或自动提取卖点；reel_plan 的分镜结果也未自动转换为渲染案例。这些工具尚未构成“给一个仓库地址就自动出片”的完整流程。

原说明提供了以下 GitHub 安装方式，仅供在测试 profile 中验证：

dsh plugin --profile scratch add github:Eileenes/dsh-reel

宿主运行还依赖兼容的 @deepseek-ai/dsh-tools、Remotion 和浏览器。真实 DSH profile 的安装、加载、工具返回值、热更新与卸载仍待验证，不据包声明推断已经兼容所有 DSH 版本或已经发布到 npm。

使用条件与当前限制

场景	需要什么	当前状态
渲染 2026 campaign	Node.js 22+、Chrome／Chromium	24 秒片由 studio/src/v2/entry.tsx 渲染；海报/封面由 design/build.sh 生成；均已实测
渲染 v1 案例	Node.js 22+、pnpm、Chrome／Chromium	用 scripts/reel.mjs --mode both 在本地生成，仓库不再内置旧的 Better Sidebar 样片
换成其他插件	已核实的信息、可使用的截图、JSON 与 TSX 修改	v1 模板仍含 Better Sidebar 固定内容；v2 尚未参数化
调整画幅或时长	修改 Composition、布局、镜头时间线和配乐	v2 目前 24s / 16:9 + 3:4 + 1:1；无通用竖屏预设
重新生成配乐/音效	Python 3（纯标准库）	make_music_v2.py 合成 120BPM 卡点 BGM；make_sfx_v2.py --music ... 叠 15 类音效并铺 24s 混音
旁白与宿主自动化	额外实现与验证	当前没有旁白生成；宿主流程仍未完成真实环境验收

campaign 片为 H.264 / yuv420p / AAC 48kHz 双声道，24.0s（720 帧 @30fps）；配乐为本地合成的 120BPM 卡点 BGM（A 小调、Am–F–C–G，8 个 cut 各带 impact）+ 事件驱动音效，无第三方版权音乐。仓库没有独立自动化测试套件；--dry-run 只检查参数路径，不能替代完整渲染和画面验收。

文档与维护

文档或入口	内容
案例 JSON	v1 内置 Better Sidebar 示例数据
v2 渲染入口	24 秒 campaign 片的 Composition
v2 时间线	场景边界与音效锚点（改节奏先改这里）
设计源文件	海报 / 封面 / 方图模板与生成命令
配乐合成	120BPM 卡点 BGM（120 拍/12 小节/8 个 impact），纯 Python
音效/混音	15 类事件音效 + 与 music bed 混音（可选 --music），纯 Python
渲染 CLI	v1 参数、浏览器查找与输出路径
Composition 定义	v1 视频时长、帧率与两种画幅
发布检查清单	npm 打包与 DSH 市场发布的规划
原中文说明	原型制作与初版使用记录

发布清单中关于根目录 package.json 的 private: true 描述已过时：当前根包是 private: false，studio 子包仍是私有包。原中文说明中的“扫描／规划自动化”应结合上面的实际实现理解。打包状态以当前配置为准，发布和兼容性仍需要单独验证。

目录结构

dsh-reel/
├── README.md                 # 介绍、使用与当前边界
├── lib/index.js              # DSH 宿主工具
├── cordis.patch.yml          # DSH 插件配置入口
├── scripts/reel.mjs          # v1 本地渲染 CLI
├── cases/                    # v1 案例 JSON
├── docs/                     # 24s 片、海报、封面、方图
├── design/                   # 海报/封面/方图 HTML 模板 + 构建脚本
├── studio/
│   ├── src/                  # v1 Remotion 模板
│   ├── src/v2/               # 2026 campaign：tokens / 鲸鱼 / 市场 UI / 场景
│   ├── public/v2/            # campaign 用素材
│   ├── public/audio/v2/      # 120BPM 卡点 BGM + 15 类事件音效 + 混音
│   └── scripts/make_sfx_v2.py# 音效合成
├── PUBLISHING.md             # 发布检查清单
└── LICENSE                   # MIT 许可证

遇到问题可提交 Issue，附上 Node.js、浏览器、运行命令和脱敏后的错误信息。

来源与授权

项目代码采用 MIT 许可证，版权声明为 2026 dsh-reel-studio contributors。campaign 中的体素鲸鱼、海报、封面与音效均为本仓库自制（无第三方采样/字体/图片），市场界面按真实产品结构重绘、文案取自已核对内容。第三方截图、名称和标识的使用仍需遵守各自授权条件；适配新案例时请使用自己的素材或已获许可的素材。

这是非官方社区项目，与 DeepSeek 无隶属或背书关系。“DeepSeek”“DSH”等名称用于描述兼容目标，相关标识归其所有者。原说明将卡通鲸鱼标注为原创插画，并非官方 Logo；任务与侧边对话画面是合成示例。