前言¶

用 DeepSeek Harness（DSH）跑 Agent 時，任務往往要幾十秒甚至更久。這段時間界面多半停在「運行中」，人只能盯着進度條。和把播放器單獨開在一個窗口相比，把短劇嵌進 DSH 右側邊欄、並在 Agent 忙碌時主動提示，能減少來回切應用的次數。下面介紹社區插件 dsh-hongguo（摸魚短劇）：在 Agent 幹活時在邊欄播短劇，數據經 openhongguo 拉取，維護者爲 frostming。內容僅供個人學習與研究，版權歸權利人所有。

這是什麼¶

dsh-hongguo 是 DSH 的聯網類插件：在右側邊欄提供「摸魚短劇」標籤頁，含推薦、搜索、分集與播放器；Agent 運行時可在輸入框上方出現等待提示，左側欄底部也有一鍵入口。當前包版本爲 1.2.1（見倉庫 package.json），許可證 MIT，Node ≥ 20。

社區目錄頁：frostming/dsh-hongguo；源碼：github.com/frostming/dsh-hongguo。npm 上的包名 dsh-hongguo 不是本插件，須從 GitHub 安裝。

核心功能¶

右側邊欄與引導¶

• 標籤頁「摸魚短劇」：推薦卡片 → 劇集列表（封面、服務端搜索、翻頁）→ 分集 → 播放器。
• 列表按面板寬度自適應每行 6 / 4 / 3 / 2 部，每頁 12 部，「換一批」翻頁；搜索走紅果接口，首屏補滿 12 部，結果按 id 去重。
• 側邊欄引導頁提供「摸魚短劇」入口卡片；左側欄底部有「短劇」按鈕一鍵打開播放器。

Agent 等待時的提示與聯動¶

• Agent 運行中：輸入框上方浮框展示 3 部劇可直開，「更多…」打開完整播放器；當前頁已顯示播放器時不重複出現（可配置，見下文 autoPrompt）。
• Agent 從運行變爲空閒：邊欄與播放頁里正在播的短劇會自動暫停，並在畫面上提示。
• 播放歷史記錄每部劇看到第幾集、第幾秒；「觀看歷史」可續播、單條移除；邊欄與獨立播放頁共用同一份 localStorage 記錄。

播放器能力¶

• 畫面內控制條：進度、下一集、倍速（0.5–2×）、靜音、全屏；分集按 50 集一段。
• 畫中畫（視頻級 PiP）、鼠標滾輪在畫面上調音量（數值記在瀏覽器，邊欄與播放頁共用）。
• 自動連播：一集結束自動播下一集，無需再點。
• 標題欄 ↗ 可把播放交給系統默認瀏覽器中的獨立播放頁（Host 路由 /api/hongguo/window）；切對話、換側欄、刷新 DSH 不會打斷瀏覽器裏的播放。DSH 桌面外殼會攔截 window.open，由 Host POST /api/hongguo/open 調起默認瀏覽器。

Host 與片源（實現要點）¶

• Host（index.js）：加載 openhongguo、維護匿名設備檔案，提供同源 API（如 /api/hongguo/feed、search、play、media、open、running、window 等）；啓動時預拉劇集列表。
• 默認片源 hongguo：視頻爲 CENC 加密 HEVC，Host 用本機 ffmpeg 解密並重封裝爲 MP4 後緩存在插件數據目錄 media/（約保留最近 40 集），頁面只訪問同源 /api/hongguo/media。
• 備用片源 hghub（source: hghub）：標準 HLS + AES-128，Host 改寫 m3u8 指向同源 stream，不需要 ffmpeg，不佔 media/ 緩存；詳見倉庫 sdk/hghub/README.md。
• HEIC 封面由 Host 用 macOS sips 或其他平臺 ffmpeg 轉 JPEG 並緩存；無 ffmpeg 時 Windows/Linux 上海報可能爲佔位圖。

安裝與啓用¶

1. 確認本機已安裝 ffmpeg（紅果片源播放必備）：
   - macOS：brew install ffmpeg
   - Windows：winget install Gyan.FFmpeg
   - 其他平臺：用系統包管理器安裝

2. 在 DSH 中從 GitHub 安裝插件（不要用 npm 包名安裝）：

dsh plugin add github:frostming/dsh-hongguo

安裝時會一併安裝依賴 openhongguo（npm 0.1.0）。插件以當前 dsh 進程權限運行，安裝前建議瀏覽源碼與 MIT 許可證，並知悉第三方短劇內容與 vendor/ 下播放庫各自許可。

3. 可選：在 cordis.patch.yml 的 hongguo.config 中調整行爲：

典型用法¶

1. 安裝並重啓或加載插件後，在右側邊欄打開「摸魚短劇」，從推薦或搜索選劇，進入分集後點播。
2. 啓動 Agent 任務後，若未在播放器頁且 autoPrompt 爲 true，輸入框上方會出現 3 部劇快捷入口；點劇名即播，或點「更多…」進完整列表。
3. 需要長時間播放且會切換 DSH 對話時：在播放器標題欄點 ↗，在系統瀏覽器打開獨立播放頁，續播與邊欄共用播放記錄。
4. 若本機無法或不想安裝 ffmpeg，可在配置中將 source 設爲 hghub（能力以倉庫文檔爲準）。

經過上面的步驟，邊欄與瀏覽器兩套界面即可與 Agent 運行狀態聯動使用。

適用場景與注意¶

適合：在本地 DSH 里長時間跑 Agent、希望等待間隙用短劇打發注意力、且接受非官方 SDK 與個人學習用途聲明的開發者。

注意：

• 短劇內容與平臺歸屬第三方，插件不提供登錄；請遵守版權與當地法規，僅作學習研究。
• 紅果片源依賴本機 ffmpeg 做解密與重封裝，磁盤會緩存部分媒體文件。
• 右側邊欄標籤頁綁定當前對話，切換對話會卸載邊欄播放；持續觀看宜用瀏覽器播放頁。
• 社區目錄 skillhub.cn 與 DeepSeek / 幻方無官方從屬關係，DSH 生態奉行「一切皆插件」，安裝來源以你自行覈查的倉庫爲準。

若在 DSH 裏等 Agent 時希望有結構化短劇入口、並與任務空閒狀態聯動暫停，可從 GitHub 安裝 dsh-hongguo，並按需配置片源與提示行爲。目錄：https://www.skillhub.cn/plugins/frostming/dsh-hongguo；倉庫：https://github.com/frostming/dsh-hongguo。