前言¶

用 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。