跳到正文

AnacondaKC/dsh-douyin

30最近提交 2026年8月13日

dsh-douyin DSH 插件

该插件聚合来自 api.yujn.cn 分类接口的视频源,通过 host resolver 获取真实 mp4 直链,交给原生 <video> 播放。提供两种模式:安装 dsh-better-sidebar 后自动注册侧栏标签,或使用自带浮动悬浮面板,无需额外依赖。支持自动连播、手势/滚轮切换、键盘控制以及失败自愈机制。

如何安装 dsh-douyin DSH 插件

dsh plugin --profile web add /path/to/DSH-douyin

复制不会执行命令。安装 dsh-douyin DSH 插件前请核对仓库和版本。

dsh-douyin DSH 插件数据来源

dsh-douyin DSH 插件快照日期:2026年8月16日

discovered

dsh-douyin DSH 插件能做什么

  • 原生播放器,直接解析 302 重定向后的视频直链
  • 21 个内置系列(学姐、甜妹、COS、舞蹈等),顶部横向滚动导航
  • 自动连播,精确历史回放(上滚回到同一段视频,而非随机重新请求)
  • 手机手势:上滑下一段,下滑上一段;桌面滚轮切换
  • 键盘快捷键:空格/K 播放暂停,M 静音,方向键快进快退/切换视频
  • 失败自愈:单段失败递增退避自动跳过,连续 3 次失败后停止并显示错误界面
  • 双模式挂载:dsh-better-sidebar 侧栏标签或自带浮动面板,按需加载
  • 音量调节:右下角滑块实时调节,图标按音量分档(静音/低/高)
  • 宽度自适应:9:16 比例,限制在 380px–700px 之间,窄屏自动铺满
  • 三种源类型:feed(随机视频)、direct(固定文件)、web(iframe 嵌入)

dsh-douyin DSH 插件适合哪些场景

  • 在 DSH WebUI 侧栏中刷短视频,利用工作间隙放松
  • 作为后台播放器,在聊天或编程时观看视频
  • 快速浏览 21 个分类的泛娱乐短视频内容
  • 利用精确回放反复观看同一条视频(历史栈存真实直链)
  • 无需额外插件,在 DSH 工作区中嵌入轻量级媒体播放器

dsh-douyin DSH 插件适合谁

  • 喜欢在 DSH WebUI 中刷短视频的用户
  • 希望在开发环境中快速娱乐放松的开发者
  • 偏好侧栏集成媒体播放器而非单独浏览器标签的用户

dsh-douyin DSH 插件的限制

  • feed 源依赖第三方接口可用性,连续失败 3 次后停止播放
  • 内容为随机泛娱乐短视频,非用户自选内容
  • 视频 object-fit: cover 对横屏/方形内容居中裁切左右两侧
  • headless 自动化环境(如 agent-browser)可能对个别视频报格式错误(真实浏览器不受影响)
  • 仅支持 DSH WebUI 模式(需要浏览器环境)

dsh-douyin DSH 插件的仓库 README 摘录

以下文字摘自 dsh-douyin DSH 插件的上游仓库 AnacondaKC/dsh-douyin 的 README,版权归原作者,仅作引用。

DSH WebUI 侧栏短视频插件:**原生播放器直接解析视频直链播放**。顶部可选择学姐、甜妹、COS、舞蹈等 21 个系列,支持自动连播、滚轮切换与精确历史回放。 ![dsh-douyin 在 DSH WebUI 中的短视频侧栏效果](docs/images/dsh-douyin-preview.png) ## 原理 聚合视频源来自 `api.yujn.cn` 的分类接口。每次请求会 302 到随机 mp4 直链;插件通过 host resolver 读取 `Location`,再交给原生 `<video>` 播放。历史栈保存真实直链,因此向上滚动能回到同一段视频。 ## 安装 ```sh dsh plugin --profile web add /path/to/DSH-douyin # 重启 dsh web 后生效 ``` ## 使用 ### 模式一:dsh-better-sidebar(装了它时自动生效) 自动注册侧栏 tab「刷视频」(单实例),在侧栏 + 菜单打开。 ### 模式二:自带浮动 dock(未装 better-sidebar 时) 页面右侧边缘播放按钮可展开/收起全黑沉浸式播放面板。零额外插件依赖。 ### 播放操作 - **点击暂停**:点击视频画面暂停,再点画面或中央播放按钮继续;暂停时中央按钮常驻显示 - **播放进度**:底部显示当前时间 / 总时长,拖动进度条可定位;固定视频播完后可从头重播 - **音量调节**:点击右下角音量按钮弹出滑块(0–100%),拖动实时调节并自动取消静音;图标按音量分档(静音 / 低 / 高) - **短视频手势**:手机视频区上滑 → 下一段,下滑 → 上一段;滑动后不会误触暂停 - **视频滚轮**:桌面视频区向下滚 → 下一段,向上滚 → 上一段(400ms 防抖;顶部悬浮栏空白处滚轮同样切视频) - **键盘控制**:空格 / `K` 播放暂停,`M` 静音,左右方向键快退/快进 5 秒,上下方向键切换视频 - **系列导航**:在顶部轨道滚轮或触控横滑,也可使用左右箭头、键盘方向键和点击切换系列 - **精确回放**:每段先经 host 路由(`/dsh-douyin/resolve`)用 Node fetch 解析出 302 后的**真实 mp4 直链**再播放——历史栈存的是直链,上滚回放的**就是刚才那段**(同一 URL),而非接口重新随机 - **自动连播**:feed 源每段播完自动前进(优先走历史,末尾才请求新段) - **失败自愈**:单段加载/解码失败会递增退避并自动跳过;连续失败 3 次后停止请求并显示错误界面 ### 界面 视频上方是抖音式横向系列导航轨道。当前系列固定居中,采用白字与红/青双侧强调;相邻项随距离逐渐淡化。轨道支持滚动

阅读完整 README仓库许可: BSD-3-Clause

dsh-douyin DSH 插件常见问题

如何安装 dsh-douyin?

在终端中运行 `dsh plugin --profile web add /path/to/DSH-douyin`,然后重启 DSH web 服务即可生效。如果你安装了 dsh-better-sidebar,插件会自动注册到侧栏标签中;否则,页面右侧边缘会出现一个播放按钮,点击即可展开浮动面板。

可以添加自己的视频源吗?

可以。插件支持三种源类型:feed(随机视频接口)、direct(单个视频文件链接)和 web(可嵌入的网页)。你可以通过源管理界面添加自定义源。但请注意,feed 解析器只接受内置的 HTTPS 端点,不会代理任意 URL,以确保安全性。

为什么视频有时无法加载?

feed 源依赖第三方接口的可用性。如果单个视频加载失败,插件会自动进行指数退避重试。连续失败 3 次后,播放会停止并显示错误界面。这是内置的容错机制,避免无限加载循环。

支持哪些键盘快捷键?

空格或 K 键播放/暂停,M 键静音,左右方向键快退/快进 5 秒,上下方向键切换视频。这些快捷键在视频面板聚焦时生效。你也可以在视频区域或系列导航栏上使用滚轮来切换视频。

插件在手机上能用吗?

可以。插件针对手机做了适配:在视频区域上滑切换到下一段,下滑切换到上一段。面板宽度会根据视口自适应,窄屏时自动铺满。浮动面板在手机上会折叠为一个小按钮,点击即可展开。