前言¶
在 DSH 里接抖音，常见做法要么全靠浏览器自动化把「看视频」和「回消息」绑在一起，要么只做一个方向。浏览器占资源、会话和 Agent 也容易和主项目混在一起。下面介绍社区插件 抖音助手（Mengtiansoul/dsh-douyin-on-base）：内容侧用 star-browser 驱动浏览器刷推荐流并做视觉评估与互动，社交侧用 Node 直连 WSS（douyin-im）收发私信与群聊，完全不碰浏览器。维护者为 Mengtiansoul，在 SkillHub 目录中归类为联网工具；仓库当前约 1 star，许可证 MIT，版本 0.5.0（以 package.json 为准）。
这是什么¶
一句话：给 DeepSeek Harness 用的抖音插件，把「刷视频」和「回消息」拆成两个模块，设置面板分三页，配置写入插件目录的 config.json，保存即时生效，不用重启宿主。
插件通过 cordis.patch.yml 挂载三条入口：工具本体、设置面板宿主、会话桥。抖音相关消息会落在独立工作区分组里，会话桥自行登记，默认工作区标题为 Douyin，不塞进用户自己的项目目录。
核心功能¶
内容模块（主动式）¶
调用 star-browser 管家驱动浏览器：刷推荐流、评估画面、点赞收藏转发，用完后关浏览器。注册的工具包括（名称以 README 为准）：
| 工具 | 说明 |
|---|---|
douyin_recommend |
切到推荐流 |
douyin_search |
搜视频（读接口，不点页面） |
douyin_open |
按 aweme_id / 搜索结果序号打开 |
douyin_next |
下滑切下一条（累计浏览时长） |
douyin_state |
读播放/点赞/收藏/今日用量 |
douyin_look |
截图当前画面 |
douyin_evaluate |
截图 + 视觉模型打分（可自动互动） |
douyin_current_id |
取当前视频 aweme_id（带 DOM 反查校验） |
douyin_like / douyin_favorite |
点赞 / 收藏（点赞键走快捷键 Z） |
douyin_comment |
发评论（默认草稿，send=true 才发） |
douyin_share |
转发视频到群/好友（走社交通道，有服务端回执） |
douyin_press |
快捷键：w 清屏 / x 评论 / z 赞 / f 作者主页 / p 推荐给朋友 / v 分享 |
douyin_stop |
收工，通知守卫关浏览器 |
douyin_usage / douyin_api_log |
今日用量 / 接口原始返回 |
内容模块依赖另行安装的 star-browser 插件（9443 管家 + CDP）。首次在总设置里配置 OpenAI 兼容的视觉模型，供 douyin_evaluate 使用；并确保 star-browser 管家在运行。
社交模块（被动式）¶
social/bridge.mjs 通过 douyin-im 登录后监听消息，经 session-bridge.mjs（HTTP 3099）投入 DSH 会话，拿到整段回复后再发回抖音。特性包括：
- 一人一会话 / 一群一会话，重启不换会话（
agents.resume优先） - 白名单（群 / 好友）、通道开关（私信 / 群）、触发方式（仅 @ / 自行判断）
- 每日回复上限、分段间隔与段数
- 支持文本式自带表情（如
[呲牙]）、收藏表情（图片式）、视频卡片 - 出站投递箱
social/outbox.json：可主动往任意群/好友发文字或卡片
社交模块首次运行需扫码或短信登录，登录态在 data/，之后自动恢复。依赖 npm 包 douyin-im（^1.1.0），不需要浏览器。
行为约定¶
- 社交优先于内容：有消息进来时写
interrupt.flag，守卫约 5 秒内关掉管家浏览器让路。 - 浏览器用完就关：到每日上限、出时段、主动收工或消息打断，都会关掉管家 Edge。
- 日报：刷满当日上限时生成，或每天 23:59 兜底；口语化日记体（见
social/daily-report-guide.md）。
安装与启用¶
官方推荐一行安装（来自 README，勿自行改写法）：
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Mengtiansoul/dsh-douyin-on-base
装完后重启 DSH 宿主，或在插件面板启用；依赖由 pnpm 自动安装。本地开发可链接目录：
dsh plugin --profile web add link:/path/to/douyin-on-base
插件以当前 DSH 进程权限运行。安装前建议阅读 GitHub 源码与 MIT 许可证，确认可接受第三方库 douyin-im 的登录与接口风险（README 注明其尚未经过大规模真实账号验收）。
配置¶
打开 设置 → 抖音助手，三页：总设置 / 内容模块 / 社交模块。
建议填写 dshHome（本 DSH 实例家目录）：社交会话被误归档时插件可识别并恢复；不填只影响该项检查，收发消息不受影响。
若需为抖音社交会话指定 Agent 预设，在 cordis.patch.yml 的会话桥条目下加 agentPreset: '你的预设id'；改工作区显示名则加 workspaceTitle: '你的名字'。
首次启动要点：
- 无
config.json时自动写入默认配置（空密钥、空白名单、上限 60 分钟、自动互动关闭） - 无
data/时自动创建，社交模块需首次登录 - 桥登录成功后自动导出
social/channels.json，供白名单勾选
典型用法¶
Agent 在内容侧可按工具链操作推荐流，例如切推荐、截图评估、按评分决定是否点赞，最后 douyin_stop 收工。社交侧由桥把私信/群消息送入独立 Douyin 工作区，Agent 按 workspace/AGENTS.md 守则回复；主动外发可写 social/outbox.json。
Windows 上可用自检脚本核对计划任务、端口、配置与进程：
powershell -ExecutionPolicy Bypass -File social\selfcheck.ps1
非 Windows 时，social/*.ps1 守卫/看门狗/日报定时需自行用 cron/systemd 替代，或只跑不依赖这些脚本的社交模块。
适用场景与注意¶
适合：已在 DSH 中跑 Agent，希望抖音刷流与 IM 回复解耦；能接受 star-browser + douyin-im 两套依赖；需要白名单、回复上限、独立工作区隔离。
环境与限制（README 原文）：
- Node ≥ 20；社交模块因
douyin-im要求，请用 Node 22.5+ - 评论无法真 @ 选人，仅支持纯文本
@昵称；楼中楼回复未实现 - 视觉打分依赖模型输出含「评分：X/10」，自定义提示词需保留该格式
- 每日 04:00 自动备份
data/、config.json、social/sessions.json到backups/，保留 7 份（Windows 脚本路径）
DSH 社区插件目录在 SkillHub 等独立站点，与 DeepSeek / 幻方无官方从属关系；安装命令与能力描述以上述仓库 README 为准。
链接¶
- 目录页：https://www.skillhub.cn/plugins/Mengtiansoul/dsh-douyin-on-base
- GitHub：https://github.com/Mengtiansoul/dsh-douyin-on-base
- 架构说明：仓库内
docs/architecture.md
