dsh-reel-studio

dsh plugin --profile web add dsh-reel-studio

dsh-reel-studio · 历史中文说明

本页保留原型阶段的说明记录。当前功能、安装步骤和限制请以[主 README](README.md)与源码为准：扫描工具仅检测 README 是否存在，分镜规划尚未接入自动渲染，模板中仍有 Better Sidebar 固定内容；DSH 宿主接入尚未完成真实环境验证。以下历史状态不代表当前版本已经通过全部验证。

把一个 DeepSeek Harness (DSH) 插件仓库，在本地变成一条 16:9 宣传片 + 一张 3:4 宣传图。

npm 包名：dsh-reel-studio · 仓库：Eileenes/dsh-reel

[当前主 README](README.md) · 历史中文说明

状态：可运行原型。Remotion 管线与两种输出已端到端验证；DSH host 插件包（dsh.bundle）已搭好骨架，但还没有在真实 DSH profile 里加载验证。

样片

• [看 32.5 秒宣传片](docs/demo.mp4)
• [宣传图（2160×2880 PNG）](docs/promo.png)
• [视频封面](docs/poster.png)

样片目标插件：omdsh-dev/DSH-better-sidebar（MIT）。这是非官方样片，用来验证“插件仓库 → 发布物料”的流程。截图来自该公开仓库；任务拓扑/侧边对话面板是合成的，不包含真实会话内容。

V0.1 真机界面宣传片管线（2026-11）

• [28 秒成片](docs/better-sidebar-v0.1.mp4)：Better Sidebar，1080p / 30fps / 带声音；
• [方法总结](docs/promo-method-v0.1.md)：读插件 → 分镜 → 素材 → 侧栏壳 → 鲸鱼运动 → 声音 → QA；
• [案例拆解](docs/case-better-sidebar-v0.1.md)：功能表、28s 时间线、素材来源、限制；
• [Onetake comp 参考](promo/comp-better-sidebar.html)：实际分镜/动画代码（依赖 Onetake，不随仓库分发）。

目前是手动分镜 + 外部 Onetake 渲染。

Onetake 许可说明：Onetake 不是商用授权，采用 PolyForm Noncommercial；本仓库的 comp/工作流仅用于开发和制作 DSH 插件宣传素材。任何人将 Onetake 或其渲染产物用于商业用途，需自行向 Onetake 作者取得另行商业授权。本仓库不分发 Onetake 运行时。

交流群

<img src="https://raw.githubusercontent.com/Eileenes/dsh-reel/main/docs/wechat-group.png" width="260" alt="dsh-reel-studio 交流群二维码" />

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

能产出什么

宣传片

• 32.5 秒 / 1920×1080 / 30fps / H.264 + AAC 立体声；
• 7 段结构：Hook → 问题 → 方案 → 四张功能王牌 → 怎么用 → 数据/安装/地址 → 片尾；
• 120 BPM 程序化配乐，场景切换与卡片入场落在半拍上；
• 真实 DSH 截图 + DSH 风格字标/配色 + 卡通小鲸鱼；
• 覆盖：是什么、解决什么问题、怎么用、安装命令、仓库地址、数据。

宣传图

• 1080×1440 设计稿，2× 输出 = 2160×2880 PNG；
• DSH 关联元素：deepseek HARNESS 字标、DSH 蓝/薄荷绿、网格、真实 DSH 截图、卡通小鲸鱼；
• 信息分区：是什么 / 解决什么 / 三步用起来 / 安装命令 / 地址 / 数据；
• 任务和侧聊使用合成 mock，不包含任何私有会话或个人信息。

环境要求

• Node.js 22+
• pnpm
• Chrome / Chromium（Remotion 用于渲染）；不在默认路径时设置 CHROME_PATH。
• Python 3 仅用于重新生成 BGM。

快速开始

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

# 可选：CLI 也会检查 macOS/Windows/Linux 的常见 Chrome 路径
export CHROME_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"

# 宣传片 + 封面 + 宣传图
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

输出在 studio/out/：

• <slug>-demo.mp4
• <slug>-poster.png
• <slug>-promo.png（2×）

可选参数：--poster-frame 825、--dry-run（只生成 props）。

Case 格式

一个 case 就是一个 JSON 文件，显式列出所有要展示的事实，便于人和 agent 审核：

{
  "plugin": {
    "name": "Better Sidebar",
    "handle": "dsh-better-sidebar",
    "version": "0.28.0",
    "repo": "github.com/omdsh-dev/DSH-better-sidebar",
    "install": "dsh plugin --profile web add dsh-better-sidebar",
    "downloads": 46445,
    "stars": 4297,
    "tagline": "一个侧边栏，装下整个开发工作台"
  },
  "features": [
    {"no": "01", "title": "文件树 + 编辑器", "desc": "...", "img": "shots/files-tree.png", "accent": "#4d6bfe"},
    {"no": "02", "title": "Git 工作台", "desc": "...", "img": "shots/changes-tree.png", "accent": "#5ef2c2"},
    {"no": "03", "title": "任务拓扑", "desc": "...", "mock": "tasks", "accent": "#ffb86b"},
    {"no": "04", "title": "侧边对话", "desc": "...", "mock": "sidechat", "accent": "#8ea6ff"}
  ],
  "promo": {
    "problem": "一个会话，五个工作面，却只有半块屏幕。",
    "what": "原生右栏 + 底部工作台。",
    "how": ["安装插件", "打开右侧栏", "按 tab 使用"],
    "address": "github.com/omdsh-dev/DSH-better-sidebar"
  }
}

图片从 studio/public/ 读取。请使用自己的干净截图或内置合成 mock，不要提交含隐私/密钥的素材。

作为 DSH 插件使用

仓库包含 host 侧插件包：

• reel_scan：读取本地插件 package/README/截图目录；
• reel_plan：把 brief 转成确定性 storyboard；
• reel_render：本地渲染 mode=video|image|both。

安装到 scratch profile（尚未在真实 DSH 构建上验证）。npm 发布后：

dsh plugin --profile scratch add dsh-reel-studio

在那之前可以直接从 GitHub 装：

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

限制 / 下一步

• case 目前需要手写；下一步接 reel_scan + reel_plan 自动生成。
• 只有 16:9 视频和 3:4 图片；9:16 竖版和 1:1 方版还没做。
• 没有旁白；当前是程序化 BGM + 字幕。
• host 插件还需要真实 profile 的加载/HMR/dispose 验证，以及更轻的市场发布包。
• 未获授权不要渲染第三方截图；优先用合成 mock 或自己的 UI。

发布 / 插件市场

见 [PUBLISHING.md](PUBLISHING.md)。

免责声明

这是非官方社区项目，与 DeepSeek 无隶属或背书关系。“DeepSeek”“DSH”等名称归其所有者，此处仅用于描述兼容性。卡通鲸鱼是原创插画，不是官方 logo。样片中的截图来自 MIT 许可的 better-sidebar 仓库；任务/侧聊面板为合成内容。

License

MIT，见 [LICENSE](LICENSE)。