前言¶
用 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，由 HostPOST /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 上海报可能为占位图。
安装与启用¶
-
确认本机已安装 ffmpeg（红果片源播放必备）：
- macOS：brew install ffmpeg
- Windows：winget install Gyan.FFmpeg
- 其他平台：用系统包管理器安装 -
在 DSH 中从 GitHub 安装插件（不要用 npm 包名安装）：
dsh plugin add github:frostming/dsh-hongguo
安装时会一并安装依赖 openhongguo（npm 0.1.0）。插件以当前 dsh 进程权限运行，安装前建议浏览源码与 MIT 许可证，并知悉第三方短剧内容与 vendor/ 下播放库各自许可。
- 可选：在
cordis.patch.yml的hongguo.config中调整行为：
| 字段 | 默认 | 说明 |
|---|---|---|
autoPrompt |
true |
Agent 运行时是否显示等待提示 |
panelWidth |
480 |
播放器标签页默认宽度（px） |
source |
hongguo |
默认片源：hongguo 或 hghub；单条请求可用 ?source= 覆盖 |
profilePath |
插件数据目录 | 匿名设备档案；删除即更换设备 |
searchTerms |
总裁/重生/逆袭 |
推荐不足时补充列表的搜索词 |
典型用法¶
- 安装并重启或加载插件后，在右侧边栏打开「摸鱼短剧」，从推荐或搜索选剧，进入分集后点播。
- 启动 Agent 任务后，若未在播放器页且
autoPrompt为true，输入框上方会出现 3 部剧快捷入口；点剧名即播，或点「更多…」进完整列表。 - 需要长时间播放且会切换 DSH 对话时：在播放器标题栏点 ↗，在系统浏览器打开独立播放页，续播与边栏共用播放记录。
- 若本机无法或不想安装 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。
