前言¶

DSH 的插件生态强调「一切皆插件」。在 DSH web profile 中工作时，如果偶尔需要浏览 YouTube Shorts 或 B站竖屏，常见做法是另开浏览器标签页。dsh-shorts-wall 把这个入口搬进 DSH：默认以贴边竖栏运行，也可切换为可拖拽/缩放浮窗，并在同一窗口中切换 YouTube Shorts 与 B站竖屏。

它由 imkingjh999 维护，许可证为 MIT，仓库地址是 https://github.com/imkingjh999/dsh-shorts-wall。

定位¶

dsh-shorts-wall 是 DSH 的竖屏短视频插件，面向 web profile。它把竖屏内容做成一个可贴边、可浮窗、可最小化的侧边信息流：

• YouTube Shorts：使用官方 iframe embed 播放。
• B站竖屏：使用原生 mp4 video 播放，经宿主代理，Range 可拖进度。

它适合放在工作区边缘浏览，不需要登录，也不替代视频站点本身。

核心功能¶

窗口形态¶

下面这些窗口状态可以互相切换：

• 默认贴边竖栏运行。
• 可切换为可拖拽/缩放浮窗。
• 关闭后可以从右下角按钮唤回。
• 浮窗、贴边、最小化切换时，播放器保持挂载不重载。
• 9:16 竖屏锁定，宽高不超视口。

双源轮播¶

顶栏有 YT / B站 chip，点击即可切换来源，选择会被记住。

两种源的播放方式不同：

当 YouTube 源出现平台级不可用状态时，插件会显示「YouTube 暂不可用」提示，并提供一键切 B站。

切换与连播¶

可以用以下方式切换下一条或上一条：

• 滚轮
• ↑↓
• j / k
• ‹ / › 按钮

自动播放行为包括：

• 播完自动下一条。
• 到尾自动续批。
• 坏内容自动跳过；连续跳过 3 条时刹车。

关键词与批次¶

当前关键词以 chip 显示；点击该 chip 会弹出关键词选择列表，点选某个关键词后会切换加载。

「换一批视频」表示在同一关键词下重新取一批新视频，而不是更换关键词。

关键词面板支持：

• 预设词库
• 自定义地区 + 关键词
• 行内编辑
• 上移
• 删除
• 恢复默认

两源词表各自独立持久化到 localStorage。

快捷键与语言¶

• Alt+S：一键最小化；再按一次还原到最小化前的浮窗/贴边状态。最小化期间自动暂停，还原后继续。
• Alt+M：快速静音/开启声音。
• UI 跟随 DSH 宿主语言（中文 / English）实时切换。

安装与启用¶

前置¶

• DSH ≥ 0.1.0 的 web profile。
• better-sidebar 不再需要。
• YouTube 源需要本机浏览器能访问 YouTube；平台风控期间该源不可用，可一键切 B站。

安装¶

执行安装命令：

dsh plugin --profile web add github:imkingjh999/dsh-shorts-wall

安装后重启 dsh web，并在浏览器中硬刷新（⌘⇧R 或 Ctrl+Shift+R）。刷新后，页面右下角会出现「Shorts」浮窗入口。

可选配置¶

如果需要在 profile 的 cordis.patch.yml 中配置代理白名单或个人代理，可以写：

- id: shorts-wall
  config:
    extraAllowSuffixes: [cdn.example.com] # 代理白名单追加域名后缀
    resolveProxyUrl: http://127.0.0.1:7890 # 可选：YouTube 抓取/缩略图走个人代理（HTTP CONNECT）

这里有两个边界：

• extraAllowSuffixes 用于追加代理白名单域名后缀。
• resolveProxyUrl 是可选个人代理；未配置时可回退读 HTTPS_PROXY / HTTP_PROXY 等环境变量（仅 http://）。
• 无论哪种来源，只有 YouTube 系域名走隧道；B站 API 与视频 CDN 始终直连。

典型用法¶

1、安装并刷新后，从页面右下角的「Shorts」入口打开插件。

2、在顶栏点击 YT 或 B站 chip 切换来源。

3、点击关键词 chip 打开关键词选择列表；可以直接点选一个关键词。

4、需要维护词库时，打开关键词面板，用预设词库整组替换或追加，也可以添加地区 + 自定义关键词。

5、用滚轮、↑↓、j/k 或 ‹ / › 按钮切换视频；用「换一批视频」在同一关键词下重取一批。

6、需要临时收起时按 Alt+S；需要静音或开启声音时按 Alt+M。

本地开发安装¶

如果要从本地源码链接安装，先进入 web profile 目录：

cd ~/.dsh/profiles/web
pnpm add link:~/projects/dsh-plugins/dsh-shorts-wall

然后在 package.json 的 dsh.profile.bundles 中追加 "dsh-shorts-wall"，并在链接到的本地插件目录执行：

pnpm install && pnpm run build

适用场景与注意¶

• 它声明仅供个人观看；全部走匿名公开接口与官方播放通道，不登录、不破解、不伪造签名。使用前请遵守对应平台服务条款。
• 插件以当前 dsh 进程权限运行。安装前建议检查源码、依赖和许可证。
• 匿名档画质：YouTube 由官方 embed 决定；B站约 480p/720p，更高需登录。
• YouTube 匿名搜索无分页：每批约 15-30 条，续批靠同词重搜去重。
• YouTube 源需要本机浏览器能访问 YouTube；平台风控期间该源不可用，可一键切 B站。
• README 声明 review_audit 不是安全认证，分数只说明当前可度量的工程健康度。

结尾¶

dsh-shorts-wall 提供的是一个围绕 DSH web 工作区的竖屏短视频入口：默认贴边、可浮窗、可最小化，并支持 YouTube Shorts 与 B站竖屏双源轮播。

仓库地址：https://github.com/imkingjh999/dsh-shorts-wall