dsh-moyu：DeepSeek Harness 抖音推荐流播放器插件

前言¶

DeepSeek Harness（DSH）采用“一切皆插件”的架构，扩展能力集中在客户端插件。在本地开发或使用智能体时，频繁刷抖音是常见需求。传统方案要么依赖浏览器标签页，要么需要登录态与复杂的爬虫配置。dsh-moyu 为 DSH 客户端提供了一块可嵌入的抖音推荐流播放器：鼠标移到指定热点上即展开，移开自动收起并暂停，滚轮切换视频，无需登录账号，且利用宿主侧完成签名与媒体反代，浏览器侧仅负责渲染。

插件定位¶

名称：dsh-moyu
维护者：gongstudent
分类：客户端（dsh.client）
简介：给 DeepSeek Harness 的摸鱼套件抖音模块。鼠标悬停即现的推荐流播放器，滚轮切视频，移开自动暂停；宿主侧签名与媒体反代。
核心价值：在 DSH 界面内直接刷抖音推荐流，无需浏览器标签页、无需登录态，利用 DSH 进程权限完成签名与反代。

核心功能¶

悬停即用：静息态只留一个 6px 半透明圆点（pointer-events: none），不遮挡操作。鼠标移入热点后，推荐流展开为播放器，自动开始播放。
滚轮切换：向下滚轮为下一条，向上为上一条。带累加阈值与冷却，一次手势只跳一条。
暂停/恢复：鼠标移开时，播放暂停在当前帧；移回后从原处继续播放（不是重播）。
位置与透明度：支持通过设置拖动滑块或进入调整模式拖动虚线框，水平/垂直位置用自由空间比例表示（0~90%），透明度 15%~100%，适配不同显示器与窗口大小。
声音记忆：静音状态与音量大小均持久化。每次创建新的 <video> 元素后，音量会自动恢复至上次状态；从原生控制条修改音量也会被 volumechange 事件同步。
凭据机制：不需要登录抖音账号，只需一个匿名设备标识 ttwid。插件通过自动获取或手动粘贴方式获取并存储该凭据，用于发起推荐流与视频流请求。

安装与启用¶

桌面版（Desktop / 任意 Electron 发行版）¶

使用 Harness 自带的 CLI 安装最稳，版本与宿主对齐：

& "<Harness 安装目录>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add github:gongstudent/dsh-moyu

Web / CLI 版¶

如果已全局安装 @deepseek-ai/dsh：

dsh plugin add github:gongstudent/dsh-moyu

安装后操作¶

完全退出并重启 Harness。CLI 只修改 profile 的 package.json 与 node_modules，不触发热更新。
重启后进入设置 → 通用 → 抖音摸鱼，勾选“启用”。

卸载¶

dsh plugin remove dsh-moyu

通过插件市场安装¶

插件仓库自带符合 format 1 规范的市场索引：

在 Harness 里打开插件 → 实验性插件旁的「更多」→ 打开「自定义插件市场」。
在索引源里添加：

https://raw.githubusercontent.com/gongstudent/dsh-moyu/main/market/index.json

切换到「发现」标签页，找到「抖音摸鱼」并一键安装。

首次配置：获取 ttwid¶

插件不要求登录抖音账号，只需要一个匿名设备标识 ttwid。抖音通过该标识区分“真实浏览器”与爬虫，与登录态无关。

推荐方式：自动获取¶

进入设置 → 通用 → 抖音摸鱼 → 点“自动获取”。
插件会在本机启动一次隐形无头 Chrome 或 Edge，访问 douyin.com 获取 ttwid，存入本地凭据文件。
全程使用临时浏览器配置，不接触现有浏览器数据；结束后进程与临时目录会清空。
前提：本机装有 Chrome 或 Edge（绝大多数机器满足）。

手动方式（自动获取失败时）¶

用浏览器打开 https://www.douyin.com/，等待页面完全加载。无需登录。
打开开发者工具（Chrome/Edge：F12 或 Ctrl+Shift+I；Firefox：F12）。
在 Storage → Cookies → https://www.douyin.com 中找到名为 ttwid 的 Cookie。
复制 Value（不是 Name）。该值较长，形如 1%7Cxxxxxxxxxxxxxxxxxxxxxxx%7C...。
回到插件设置，输入 ttwid=1%7C你刚才复制的值（注意：不要对 %7C 做 URL 解码，原样粘贴）。
保存。如果视频能正常播放，说明配置成功。

凭据存储与安全¶

凭据存储在本机 ~/.dsh/storages/dsh-moyu.json，为纯文本。
仅用于拼 Cookie 请求头发给抖音，不经过任何第三方服务，不上传，不进入 git 仓库（.gitignore 已排除 _session.json）。
该文件只含匿名设备标识，不含账号密码。带 sessionid 的个性化推荐为可选项，未在项目中验证。

典型用法¶

浏览：将鼠标移到屏幕上的隐形热点（约 6px 圆点）上，播放器展开，视频开始播放。移开鼠标，播放器收起为圆点，播放暂停在当前帧。
切换视频：在播放器上滚动鼠标滚轮，向下切换下一条，向上切换上一条。
调整位置与透明度：通过设置或“调整模式”拖动播放器位置，调节透明度以融入背景。
老板键：鼠标悬停在播放器上时，按空格键可立即关闭浮层（等同于关闭“启用”开关，刷新后不会自动恢复）。
原生控制条：播放器内置播放/进度/音量/倍速控制，全屏键已移除（浮层尺寸固定，全屏会盖住整个界面）。

已知限制¶

内容范围：目前只实现了推荐流，关注流、喜欢列表、直播、弹幕、评论尚未支持。
分页机制：分页依赖 refresh_index 递增，实测单页条数由抖音决定，不受 count 参数控制。
视频声音：部分 Electron 发行版自带媒体库可能缺少 AAC 解码器，导致视频无声音。这是宿主层面问题，与插件无关，需借助 FFmpeg 等工具解决。
接口稳定性：抖音接口可能变更，签名参数与字段名一变需跟进适配。

适用场景与注意¶

适合需要在 DSH 界面内连续浏览抖音推荐流的场景，如本地开发调试、长时间观看视频、信息收集。
插件以当前 DSH 进程权限运行，安装前建议查看源码与许可证（MIT）。
凭据 ttwid 可能因抖音策略轮换或长期不使用而失效，失效时按“手动方式”重新获取即可。

短结尾¶

dsh-moyu 通过宿主侧签名与媒体反代、浏览器侧渲染分离的架构，在 DSH 中实现了一块可嵌入的抖音推荐流播放器。它无需登录、无需浏览器标签页，使用简单、配置直观，适合需要在本地开发或使用智能体时刷抖音的开发者。

插件目录页：https://www.skillhub.cn/plugins/gongstudent/dsh-moyu
GitHub：https://github.com/gongstudent/dsh-moyu