dsh-hongguo

dsh-hongguo

摸鱼短剧：一个 DSH 插件，在右侧边栏里播一部短剧，Agent 干活的时候提示你把它调出来。

数据来自 openhongguo（第三方短剧平台的非官方 SDK，匿名设备、无需登录）。请仅用于个人学习与研究，内容版权归权利人所有。

安装

npm 上的 dsh-hongguo 不是本插件，请从 GitHub 安装：

dsh plugin add github:frostming/dsh-hongguo

依赖 openhongguo 会从 npm 一并安装。

本仓库是个人 fork：新增浏览器播放页、倍速选择、滚轮调音量与画中画。上游项目见 frostming/dsh-hongguo。

在浏览器里播放

右侧边栏的标签页属于当前这个对话：切到别的对话，标签页会卸载，正在播的那一集也就停了。想让它一直播，就把播放交给浏览器里的播放页（Host 用 /api/hongguo/window 提供这个页面），它有自己的文档，切对话、换侧栏布局、刷新 DSH 都不受影响。

打开方式：点播放器标题栏右侧的 ↗（列表页是 默认浏览器打开）。DSH 桌面外壳会拦掉页面里的 window.open，所以由 Host 调用系统默认浏览器（POST /api/hongguo/open，URL 由 Host 自己拼，只接受剧集 id 和播放秒数）；Host 和浏览器不在同一台机器时退回页面自己的 window.open。

播放页具备：剧集列表、搜索、换一批、分集（50 集一段）、原生控件、画质切换、倍速、画中画、滚轮调音量、一集放完自动接下一集并自己接着播、续播（与边栏共用同一份播放记录）、以及「Agent 停下时自动暂停」。

截图

剧集列表：顶部推荐一部没看过的热门剧，下面每页 12 部，换一批 翻页；观看历史 点开才显示。

播放器：画面按视频比例自适应，画面内控制条（进度拖动、下一集、倍速、静音、全屏），选集按 50 集分段。

等待提示：Agent 运行时在输入框上方出现，点剧名直接开播，更多… 打开播放器。

功能

结构

• Host 半（index.js）：加载 openhongguo SDK、维护匿名设备档案，提供同源路由 /api/hongguo/{feed,series,play,search,media,stream,hghub-manifest,config,open,running}、/api/hongguo/cover、/api/hongguo/vendor 与 /api/hongguo/window（浏览器里的播放页）。启动时预先拉取剧集列表。CDN 只提供 HEIC 封面，Host 用 sips（macOS）或 ffmpeg（其他平台）转成 JPEG 并缓存。
• 备用片源（sdk/hghub/）：一份不依赖第三方包的客户端，见 sdk/hghub/README.md。它按 Minireel/HGhub 的做法对接「单一信封接口」：站点把全部 /api/** 收敛成一个 POST /api/edge/request，客户端只往里填 path——不签名、不登录、也不建任何设备档案。默认片源仍是红果，source: hghub 才切过去。
• Client 半（client.js）：注册侧边栏标签页类型 hongguo、侧栏底部按钮、conversation.input.dock 里的等待提示，以及把播放交给浏览器的 ↗ 按钮。
• 播放页（standalone/）：一个不依赖 DSH React 运行时的页面（index.html + app.js + app.css），只调用上面那些同源路由；播放位置与音量写在与边栏相同的 localStorage 记录里，两边互通。

播放与解密

视频是 CENC（cenc-aes-ctr）加密的 HEVC，浏览器无法直接解码（这是 hongguo 片源）。Host 用 SDK 解析出的内容密钥调用本机 ffmpeg 解密并重封装为普通 MP4（-c copy，不重编码），缓存在插件数据目录 media/（保留最近 40 集）。页面只拿到同源 /api/hongguo/media 地址，密钥不出 Host。

需要安装 ffmpeg：macOS brew install ffmpeg，Windows winget install Gyan.FFmpeg，其他平台用系统包管理器安装。封面转换复用同一个 ffmpeg，所以在 Windows / Linux 上没有 ffmpeg 时海报会显示占位图。

hghub 片源走的是另一条路：标准 HLS + AES-128，#EXT-X-KEY 指向 CDN 上的 16 字节密钥。 Host 只改写 m3u8（把分片与 key 指向同源 /api/hongguo/stream），不解密—— hls.js 自己向 CDN 取密钥并解密。所以这条路不需要 ffmpeg，也不占 media/ 缓存； 封面是 AES-128-CBC 密文，Host 直接解密，同样不需要 ffmpeg。

配置

cordis.patch.yml 中 hongguo 行的 config：

许可证

MIT。vendor/ 下的第三方播放库沿用各自的许可证（见同目录的 LICENSE 文件）；短剧内容版权归权利人所有。