前言¶
在 DSH 里做智能体时，常见做法是模型只处理你粘贴的链接或截图，无法按自己的「人格」在真实网页里连续浏览、换片、记下看过什么。若要把抖音观看和对话侧记忆打通，往往需要自建浏览器自动化和状态存储，维护成本高。
dsh-douyin-agent（npm 包名 dsh-douyin-browser-local）是 LockyBee 维护的第三方 DSH 原生插件，在专用 Microsoft Edge 里打开电脑网页版抖音，周期性采样画面交给已配置的视觉模型，在时段与轮次限制内做有限自主观看，并把兴趣与人格记忆与插件版、独立软件版共用。外发相关能力默认关闭，每项有独立开关与次数上限。本文介绍其定位、能力与安装启用步骤；事实以 GitHub 仓库 README 为准。
这是什么¶
一句话：DSH 原生抖音助手——有限自主观看、共享人格与兴趣记忆、原生设置页与观看日报。
- 维护者：LockyBee
- 社区目录：skillhub.cn 插件页（分类：记忆）
- 源码与文档：GitHub — LockyBee/dsh-douyin-agent
- 许可：原创代码 MIT；第三方见仓库内
THIRD_PARTY_NOTICES.md
这是第三方适配，不是 DeepSeek 官方出品。运行状态、浏览器资料、密钥、数据库、私信正文和联系人信息均保存在本机，不进入仓库。
核心功能¶
下面按 README 功能表归纳；默认值与验证状态见后文注意。
观看与记忆¶
| 能力 | 说明 | 默认 |
|---|---|---|
| 自主观看 | 按人格和兴趣搜索、换片、继续看或停止，并给出理由 | 需手动开始有限轮次 |
| 兴趣与人格 | 兴趣来自实际观看进度和已确认行为，不是看到主题就算喜欢 | 随观看自动积累 |
| 时间限制 | 每日允许时段（北京时间）加单轮时长，到点视频暂停 | 单轮 10 分钟 |
| 静默观看 | 静音，核对窗口归属后尝试最小化（仍是有窗口的 Edge，非 headless） | 关闭 |
| 观看日报 | 当天实际看过的标题、作者、链接汇总为 Markdown，不调用模型 | 可手动生成；每轮观看结束后也会尝试生成 |
技术路径：在专用 Edge 浏览网页版抖音，每隔几秒采样视频画面交给模型。插件版使用 DSH 里已配置的提供商（模型须支持图片）；tool-definitions.mjs 中登记 32 项工具，插件与独立软件共用。
外发与互动（默认关闭）¶
| 能力 | 说明 | 默认 |
|---|---|---|
| 主动分享 | 通过官方分享界面把当前作品发给许可好友 | 关闭；每天默认 3 次 |
| 自动问候 | 每位许可好友每天最多一次，合计默认 2 次，带「自动问候」标记 | 关闭 |
| 私信自动回复 | 仅处理你确认的最多两位好友，只回复启动之后的新消息 | 关闭 |
| 公开评论 | 每天默认 3 条，每轮 1 条，同一作品只评论一次 | 关闭 |
| 音频理解 | 本地 Whisper 转写对白，可选 MiMo 或 MiniMax 云端 | 关闭 |
发送结果不确定时一律暂停，不会自动重发。
两种用法¶
| 插件版 | 软件版 | |
|---|---|---|
| 入口 | DSH「设置 → 刷抖音」，按钮操作 | 独立 Windows 桌面软件，对话式下任务 |
| 模型 | DSH 已配置的提供商 | 自行填写 DeepSeek API Key |
| 版本 | 1.3（npm 1.3.1） | 已打包 1.2.0，1.3 尚未打包 |
两者共用同一份人格、兴趣和记忆；同一时刻只会运行一个自主观看。
安装与启用¶
环境要求：Windows、已安装 Microsoft Edge、DSH >=0.2.0-rc.2 <0.3.0（README 写明需在 0.2.0-rc.2 系列；DSH Desktop 2.0.17 上已核对设置页）。Node.js >=22.13 仅源码安装时需要。
npm 安装（1.3.1）¶
DSH Desktop：打开「应用 → 桌面插件」，在 npm 包输入框填写 dsh-douyin-browser-local@1.3.1 并点击「安装」。Desktop profile 由 Electron 管理，不能用普通 CLI 修改。
Web 版在终端运行：
dsh plugin --profile web add dsh-douyin-browser-local@1.3.1
安装后按宿主提示重新加载，在设置中打开「刷抖音」。抖音登录与验证由使用者自行完成。市场收录与 npm 包发布分别同步，不能把发布成功当成市场已刷新。
从源码安装（可选）¶
需要 Windows、Microsoft Edge、Node.js 22.13 以上，以及 DSH 0.2.0-rc.2 系列。仓库 README 提供 install-native.ps1 流程：先 pnpm install --frozen-lockfile 与检查脚本，完全退出 DSH 后再带 -Install 执行。细节见仓库 docs/plugin.md。
典型用法（插件版）¶
安装并重新打开 DSH 后，在「设置」里找到「刷抖音」，建议顺序：
- 基础设置：选提供商和模型（模型必须支持图片），保存。
- 视频观看：点「打开抖音」，在专用 Edge 里自行登录或过验证。
- 时段与轮次：设置允许时段和单轮时长，点「开始有限轮次」，再点「开始自主观看」。
每轮结束后可查看或生成观看日报；外发类功能需在设置中逐项打开并理解次数上限后再用。
开发自测（不碰真实抖音账号）可在克隆后的仓库内执行：
pnpm test
pnpm run test:native
pnpm test 会起临时 Edge 页面，不访问真实抖音。
适用场景与注意¶
适合谁：已在 Windows 上使用 DSH，希望模型在受控时段内自主浏览抖音网页版、并把观看行为沉淀为可共享的人格与兴趣记忆；需要原生设置页而非单独拼脚本的用户。
权限与安全：插件以当前 DSH 进程权限运行，可控制本机 Edge 与本地数据目录。安装前应阅读源码与 MIT / 第三方许可证，自行评估外发、私信、评论等开关的风险。
验证状态（README 摘要）：
- 真实环境验证过：推荐播放、搜索、上下切换、暂停、画面采样、限时到点暂停；旧版 DSH 原生工具调用；表情图片采样；一次人工授权的好友转发；DSH 2.0.17 设置页挂载并读回状态。
- 仅合成测试：自主分享、行为偏好、自动问候、自主评论、静默、日报等。
- 尚未验证：抖音最小化后持续播放、真实评论区、新私信完整自动回复、MiMo 与 MiniMax 云端、标准 bundle 安装等。
合成测试使用替身模型和临时页面，不能当作真实抖音可用性的证据。最新数字与已知失败见仓库 docs/verification/native-v10.md。
结尾¶
dsh-douyin-agent 把「专用 Edge + 画面采样 + 时段轮次限制」收进 DSH 原生插件，默认保守、外发可逐项开启，并与独立软件共享人格与兴趣记忆。若要查阅简介与分类，可看 SkillHub 目录页；安装命令、配置项与逐项说明以 GitHub 仓库 及 docs/plugin.md 为准。
