前言¶
在 DSH 里给陪伴角色接抖音，常见两种做法：要么插件自带一套模型和人设，记忆只留在本插件里；要么自己写工具把画面采样结果塞进上下文，和 QQ、微信、B 站那边的「同一个人」对不齐。dsh-whale-douyin 走另一条路——沿用 LockyBee/dsh-douyin-agent 的本地 Edge 刷抖音与画面采样能力，去掉内置 AI 与人格，把观看记录、兴趣变化和可共享的记忆写入 dsh-whale-world。下面介绍它是什么、能做什么，以及 1.4.6 的安装与第一次使用步骤。
这是什么¶
dsh-whale-douyin 由社区维护者 SenuMirai 发布，DSH 社区目录分类为「记忆」。npm 包名仍为 dsh-douyin-browser-local（与上游 id 一致，便于 Whale 系插件互相识别），当前资料中的版本为 1.4.6，许可证 MIT。
相对上游 LockyBee/dsh-douyin-agent，本仓库主要改动是：
- 不再自带独立对话模型和内置人格卡；
- 浏览、停留、兴趣更新等结果接入 dsh-whale-world 记忆中枢，与 dsh-whale-qq、dsh-whale-wechat、dsh-whale-bili 共用同一套「世界」记忆。
运行环境：Windows、Microsoft Edge、兼容 DSH 宿主；资料写明已核对 0.2.0-rc.2、0.2.1-rc.2 两代 SDK，完整允许范围以包内 package.json 的 engines.dsh 为准。
核心功能¶
能力大体继承上游 1.4.6 说明，记忆与人格部分改为走 Whale 生态。
| 能力 | 说明 |
|---|---|
| 自主观看 | 在允许时段与每日额度内，于专用 Edge 打开抖音电脑版，按兴趣和真实观看行为挑片、停留、换片或停止；可手动启停 |
| 画面采样与分镜 | 观看决策、分享与观察工具可将多帧 JPEG 拼成分镜图（默认总像素预算 480000），供支持图片的模型理解 |
| 每日额度 | 「高级选项」可设每日观看分钟数、每日模型请求数，或设为不限 |
| 兴趣更新 | 依据播放进度、观看比例和已确认互动更新兴趣；「看到主题」不等于自动标记为喜欢 |
| 好友互动与分享 | 总开关管理许可会话的回复与观看中自主分享；须本人勾选许可好友或群聊；群聊仅在被 @ 或叫到设定昵称时回复 |
| 观看日报 | 从本机观看记录生成 Markdown，不额外调用模型 |
| 静默观看 | 持续静音，核实窗口归属后尝试最小化；仍使用有窗口 Edge |
人格与兴趣由 dsh-whale-world 与 Whale 系其它插件共用，不再使用原插件内置人格。安装 dsh-whale-world 后，抖音侧刷过的内容和口味变化会进入同一记忆中枢。
同一时刻只运行一条自主观看；插件版与上游独立软件版共享每日账本（本仓库 README 仍描述两版关系，插件入口在 DSH「设置 → 刷抖音」）。
安装与启用¶
资料中的固定安装入口对应 1.4.6。是否在 npm / 市场可下，以 GitHub 与 npm 页面为准。
DSH Desktop：打开「应用 → 桌面插件」，填写包名安装或更新：
dsh-douyin-browser-local@1.4.6
更新后需完全退出并重新打开同一份 DSH Desktop（profile 由 Electron 管理，不要用普通 CLI 另改一份）。
Web profile 在终端执行：
dsh plugin --profile web add dsh-douyin-browser-local@1.4.6
引擎要求（来自 package.json）：Node >=22.13；DSH >=0.2.0-rc.2 <0.2.1-0 || >=0.2.1-rc.2 <0.3.0-0。
若要与「一整只 Whale」联动，资料建议在装好本插件的同时安装 dsh-whale-world；QQ、微信、B 站侧可选对应 dsh-whale-* 仓库。社区目录页：skillhub.cn/plugins/SenuMirai/dsh-whale-douyin。
典型用法：第一次使用¶
按 README「第一次使用」顺序操作即可复现：
- 在 DSH 中配置支持图片的主模型（插件从 DSH 目录选择；不再依赖本插件内置模型）。
- 点击「打开抖音」，在专用 Edge 中手动登录或完成验证码。
- 在「视频观看」选择时段；按需展开「高级选项」设置每日分钟数和请求数，再开启「允许自动观看」。应用需保持运行，无需先手动开新轮次。
- 在「好友互动」读取当前会话，核对稳定身份并勾选许可好友或群聊；按需填写群聊响应昵称。总开关开启且模型、名单就绪后，可自动准备回复；观看中可自主分享（须先由你指定许可对象）。
遇到问题可先走「自检与用量 → 一键自检」，按报告处理限定修复项；登录、验证码、无效 Key 等问题不能靠删除锁或记忆目录「硬清」。
适用场景与注意¶
适合谁：已在 Windows 上用 DSH 跑陪伴类智能体，并希望角色在本地 Edge 里「真的刷抖音」，且希望观看与兴趣与 QQ / 微信 / B 站共用 dsh-whale-world 记忆，而不是再养一套抖音专用人格。
务必注意：
- 插件以当前 DSH 进程权限运行，会驱动本机 Edge 与页面自动化（Playwright）；安装前建议阅读仓库源码与 LICENSE、THIRD_PARTY_NOTICES.md。
- 第三方适配，非 DeepSeek 官方发行；社区插件目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
- README 列有未完全验收项（如推荐流换片、长时播放体量等），生产环境宜以自检结果和本机实测为准。
- 从源码安装上游 agent 的步骤在资料中指向 LockyBee 仓库的
install-native.ps1；使用 SenuMirai 适配版 时仍以 npm 包dsh-douyin-browser-local@1.4.6或本仓库发布为准，勿与上游 git clone 流程混为一谈。
结尾¶
dsh-whale-douyin 把本地抖音观看链路留在成熟的上游实现上，用「去掉内置 AI + 接入 whale-world」解决记忆与人格分裂问题。若你正在拼 Whale 五件套，刷抖音这一块可以用它把口味写回同一只「她」。
