前言¶

在 DSH 里做「会看视频、会聊天」的智能体，常见做法是自己在宿主营地里接浏览器自动化，再把人格、兴趣、额度台账拆成一堆脚本。抖音电脑版有登录、验证码和页面状态校验，公开评论和好友互动一旦失控，还容易重复发送或越权回复。

Summer77177/dsh-douyin-agent 是社区插件 LockyBee/dsh-douyin-agent 的二次开发分支（版本 1.5.0），以 DSH 插件形态提供：在本机专用 Microsoft Edge 中浏览抖音，采样真实画面交给模型，并按人格与实际观看行为更新兴趣。本文只依据仓库 README 与 package.json 说明定位、安装与用法；该插件为第三方适配，不是 DeepSeek 官方发行版。

这是什么¶

• npm 包名：dsh-douyin-browser-local（版本 1.5.0，资料写明尚未发布到 npm，需从源码安装）
• 维护者：贡献者 Summer77177；上游作者 LockyBee，上游 MIT 授权
• 分类：联网工具（SkillHub 目录归类）
• 仓库：https://github.com/Summer77177/dsh-douyin-agent

本分支保留上游 1.4.5 的全部功能，并增加评论区读取与带护栏的自动回复、OCR 读屏、本地语音转写接入评论链路、私信策略、全屏保护、「@ 我」监测、账单统计等模块。不包含上游独立桌面软件（desktop/）及独立安装脚本，仅提供 DSH 插件这一种用法。

运行数据默认写在 $DSH_HOME/douyin-browser/；state/ 与 media/.env 不入库。

核心功能¶

本分支新增模块（README 模块表）¶

设计沿用上游：先看设置与额度，再读真实页面状态，最后才执行动作；任一步未确认则停止并交给人。

上游能力（插件内仍可用）¶

• 自主观看：在允许时段与每日额度内挑片、停留、换片或停止；保留手动启动／暂停
• 每日额度：高级选项可设每日观看分钟数、每日模型请求数（可选不限）
• 人格与兴趣：共用人格卡；兴趣依据播放进度、观看比例与已确认互动
• 好友互动：总开关管理许可会话的新消息回复及观看中的自主分享（默认开启，须本人勾选许可好友或群聊）
• 群聊回复：仅回复已许可群聊中被 @ 或叫到设定昵称的消息
• 自主分享：通过官方面板发送当前观察作品的卡片，同作品同会话去重
• 公开评论：独立开关，默认关闭；有每日及每次观看尝试上限，同作品不重复评论
• 静默观看：持续静音，核实窗口归属后尝试最小化
• 自检与用量：一键诊断、限定修复建议、请求与 token 用量、进行中状态
• 观看日报：从本机观看记录生成 Markdown，不额外调用模型
• 可选音频：本地 Whisper 转写对白；视频音频可选 MiMo 或 MiniMax 云端后端

环境与依赖¶

• 系统：Windows
• 浏览器：Microsoft Edge
• Node.js：>=22.13（package.json engines.node）
• DSH SDK：>=0.2.0-rc.2 <0.2.1-0 || >=0.2.1-rc.2 <0.3.0-0（完整范围以 engines.dsh 为准）
• 主要依赖：@playwright/cli 0.1.22、@playwright/mcp 0.0.83

已文档核对兼容 DSH 0.2.0-rc.2、0.2.1-rc.2 两代；其他 0.2.x 预发布宿主需以实际自检与加载结果为准。

安装与启用¶

本分支未上架 npm。README 给出的方式是从源码检出后，在 DSH profile 的 package.json 里用 file: 依赖挂载，并把 bundle 名写入 dsh.profile.bundles，然后完全退出 DSH 再打开。

先获取源码（路径按本机替换）：

git clone https://github.com/Summer77177/dsh-douyin-agent.git
cd dsh-douyin-agent

在 profile 中配置示例：

{
  "dependencies": {
    "dsh-douyin-browser-local": "file:D:/path/to/dsh-douyin-agent"
  },
  "dsh": {
    "profile": {
      "bundles": ["dsh-douyin-browser-local"]
    }
  }
}

装完后建议两步验证：

1. 在插件目录执行语法检查（不联网、不启动浏览器）：

node scripts/verify.mjs

2. 在插件设置页运行「一键自检」。

第一次使用¶

README 建议按下列顺序操作：

1. 配置支持图片的主模型；插件从 DSH 目录选择模型。
2. 点击「打开抖音」，在专用 Edge 中手动登录或完成验证码。
3. 在「视频观看」选择时段；按需展开「高级选项」设置每日分钟数与请求数，再开启「允许自动观看」。应用需保持运行，无需先开始新轮次。
4. 在「好友互动」读取当前会话，核对稳定身份并勾选许可好友或群聊；按需填写群聊响应昵称。总开关开启且模型、名单就绪后自动准备回复；观看中可自主分享。

设置页：普通项自动保存；文本在离开输入框后提交；开关与下拉修改后提交，以页面回读为准。模型 Key 与音频 Key 有独立保存入口，不回显。

状态、边界与注意¶

• 顶部状态栏区分在线、观看中、准备中与需要处理；未确认发送或待人工处理会显示原因，不能仅凭总开关认为服务已就绪。
• 遇到问题：「自检与用量 → 一键自检」，按报告处理限定修复项。登录、验证码、无效 Key 等不能靠删锁或登录目录绕过；发送结果不确定时保留收据，等待人工核对，不自动重发。
• README 写明：真实群聊、长期连续运行、新私信自动回复、MiMo／MiniMax 云端与真实公开评论等仍需单独实测；后台拉起浏览器偶有超时。
• 安全与权限：插件在当前 DSH 进程权限下运行，可控制本机 Edge、读取页面并代发互动。安装前应自行审阅源码与 MIT LICENSE、THIRD_PARTY_NOTICES.md。社区目录 SkillHub 为独立站点，与 DeepSeek／幻方无官方从属关系。

结尾¶

dsh-douyin-browser-local 把抖音电脑版的观看、好友／群聊互动、公开评论与可选语音转写收进 DSH 插件，并在 1.5.0 分支上补强评论护栏、OCR、私信策略与用量账单。若你需要在 Harness 里做「有额度、有护栏」的抖音自动化，可从下面链接查看目录说明与源码：

• 目录页：https://www.skillhub.cn/plugins/Summer77177/dsh-douyin-agent
• GitHub：https://github.com/Summer77177/dsh-douyin-agent