前言¶

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