dsh-douyin-bridge（刷抖音）
把抖音私信接进 DSH。
好友在抖音给你发消息 → 消息进 DSH 会话 → agent 拿到上下文 → agent 用工具反过来 刷视频、分享、把话回过去。
抖音私信 DSH
┌───────────────┐ ┌──────────────────────┐
│ 好友的消息 │──── 读 ─────────────▶│ 注入 → 会话 → LLM │
│ │ │ │
│ 视频卡片 │◀─── 分享 / 回话 ──────│ douyin_* 工具 │
└───────────────┘ └──────────────────────┘
▲
会话数据**全在这里**
它解决的是什么问题
qq-bridge 那套是：QQ 客户端 → SnowLuma（OneBot 网关）→ DSH → LLM，
会话数据全在 DSH 里。
抖音没有这种现成的网关。这个项目做的就是那一层：
| QQ 那套 | 这个项目 | |
|---|---|---|
| IM 侧网关 | SnowLuma（现成） | 本插件自带（浏览器 DOM 操作） |
| 桥接形态 | MCP server + 桥接进程 | DSH 插件（宿主半 + 浏览器半） |
| 消息进 DSH | session/prompt |
注入 DSH 会话（agent/inbox/spliced + user/message） |
| 会话数据在哪 | DSH | DSH（本插件只留映射和去重指纹） |
| LLM 侧动作 | mcp__snowluma__* 工具 |
douyin_* 工具 |
也就是说：这个插件扮演的是 SnowLuma 的角色，只不过桥的是抖音私信而不是 QQ， 而且它直接长在 DSH 里，所以会话数据天然落在 DSH 的 session 日志中。
装
# 本地开发
dsh plugin --profile desktop add link:<这个目录>
# 或从 npm
dsh plugin --profile desktop add dsh-douyin-bridge
装完重启一次 DSH（bundle 层要重启才组装）。
然后：
- 打开 设置 → 刷抖音
- 点 「打开浏览器登录」 —— 会弹出一个抖音网页版的 Edge/Chrome 窗口
- 在那个窗口里扫码登录（用你要跟人聊的那个号）
- 别关那个窗口（登录态靠它）
之后它自己就开始轮询了。
⚠️ 桌面版（Electron）的 profile 只能由应用自己管。
dsh plugin --profile desktop …会直接报profile "desktop" is managed exclusively by the Electron application。 桌面版请在 设置 → 插件 里装，或者用tools/dsh-rpc.mjs调pluginManager/installBundle（见tools/README.md）。
排障：装上了但没反应
# ① 插件真的激活了吗（看 fiberPhase 是不是 active）
node tools/dsh-rpc.mjs pluginManager/listPlugins "{}" | grep -A2 douyin
# ② 桥接活着吗
node tools/dsh-rpc.mjs GET /dsh-douyin-bridge/status
# ③ 浏览器登录了没、会话列表读得到吗
node tools/dsh-rpc.mjs POST /dsh-douyin-bridge/stop
node tools/probe.mjs
如果 fiberPhase 是 failed，最常见的原因是读了没声明 inject 的服务：
cordis 对 ctx.agents 这种没声明过的服务是抛异常（不是返回 undefined），
插件直接不激活，而且这条错误不进任何日志文件。改完代码先跑：
node tools/_load-test.mjs # 用假 ctx 复现 cordis 的 Proxy 陷阱
配置
真正的配置在 $DSH_HOME/douyin-bridge/config.json（不在插件目录里，
升级重装不会丢）。设置页能改的：
| 项 | 默认 | 意思 |
|---|---|---|
mode |
simulation |
simulation = AI 自己决定要不要回；mirror = AI 的每条回复自动发回抖音；off = 只给工具，不自动注入 |
peers |
[] |
好友白名单。空 = 所有会话都进 DSH（自己发的消息永不回灌） |
sharePeers |
[] |
允许把视频分享给谁。空 = 跟随 peers |
pollIntervalMs |
20000 |
轮询间隔。别调太短（见下面的风控提示） |
maxInjectChars |
4000 |
单条注入消息的字符上限 |
autoReply |
true |
收到新消息时自动唤醒 agent |
browserPort |
47881 |
CDP 端口 |
userDataDir |
<家目录>/profile |
浏览器 profile（登录态在这里） |
peers 建议填上。 空 = 所有会话都进 DSH，等于把你整个私信列表喂给模型。
工具（LLM 侧）
| 工具 | 干什么 |
|---|---|
douyin_search |
搜视频 |
douyin_detail |
读视频详情（完整文案正文、作者、时长、统计、话题） |
douyin_share |
分享视频到私信（可捎一句话 note） |
douyin_dm_list |
列出会话 |
douyin_dm_read |
读某个好友的私信（图片/表情/语音/位置/视频/分享卡片都会标出类型） |
douyin_dm_send |
发私信（纯文本） |
douyin_dm_send_image |
发图片（本机文件，或 base64） |
douyin_dm_send_emoji |
发表情（按名字，支持部分匹配） |
douyin_history |
读某个好友的完整历史（从 DSH 会话日志，不受抖音虚拟列表限制） |
douyin_duty |
读值班章程 |
douyin_status |
看桥接状态（含当前模型、附件服务有没有挂上） |
douyin_whoami |
看登录态 |
douyin_login |
打开浏览器登录 |
douyin_selftest |
选择器自检（改版时先跑这个） |
douyin_share / douyin_dm_send / douyin_dm_send_image / douyin_dm_send_emoji
的 to 留空 = 当前会话对应的好友，所以在某个好友的会话里聊天时不用传参数。
发送类工具受白名单约束：peers 配了就只有名单里的人能收到消息。
图片是真的给模型看
对方发来图片时，桥接会：
- 从 DOM 里把图片的
data:URL 抠出来（抖音网页端自己就把图转成 base64 内联了） - 用
attachments.saveImages()存进 DSH 的附件库 - 在注入的消息里挂一个
{type:'image', attachment: ref}块
模型收到的是图片本身，不是「[图片 200×150]」这行字。
⚠️ 前提是模型支持图像输入。文本模型收到 image 块时，DSH 会把它换成一句
[image omitted because this model accepts text only; …]，模型只看到一串 sha。
查当前模型支不支持：
curl "http://127.0.0.1:<DSH端口>/dsh-douyin-bridge/models" # 看 canSeeImage
curl "http://127.0.0.1:<DSH端口>/dsh-douyin-bridge/status" # 看 agentModel / attachments
如果 canSeeImage 是 false，在 profile 的 cordis.patch.yml 里给那个模型补一行
（dsh-llm-pi-ai 的 catalog 不一定标对了能力，实测 MiniMax 就是漏标的）：
- id: llm-pi-ai
config:
providers:
<provider>:
models:
- id: <model>
input: [text, image] # ← 补这个
改完不用重启，llm.listModels() 会立刻读到新值。
值班章程
prompts/duty.md 是注入进桥接会话的系统提示（怎么回话、什么时候分享、什么不做）。
你可以直接改它，改完新会话立刻生效。
数据落在哪
| 数据 | 位置 |
|---|---|
| 对话正文 | DSH 的 session 日志（~/.dsh/sessions/...） |
| 好友名 ↔ session id 映射 | $DSH_HOME/douyin-bridge/sessions.json |
| 消息去重指纹 | 同上 |
| 配置 | $DSH_HOME/douyin-bridge/config.json |
| 抖音登录态 | $DSH_HOME/douyin-bridge/profile/ |
| 运行日志 | $DSH_HOME/douyin-bridge/bridge.log |
这个插件不另存对话副本。 会话数据全在 DSH 里 —— 这是它跟一堆「自己搞个 jsonl 存聊天记录」的玩具脚本最本质的区别。
已知限制
- 抖音改版就会失效。 本仓库的 DOM 选择器都是 2026-10 实测的。
失效时先跑
node tools/probe-canary.mjs看哪条降级链挂了。 - 视频页会被风控挡掉。 短时间开太多视频页会被重定向到
/jingxuan， 分享会失败。插件返回VIDEO_UNAVAILABLE，不会假装成功。 - 私信面板需要够宽的屏幕。 视口 <1800 CSS px 时面板渲染成 0×0。 屏幕本身不够宽的话（比如 1920 物理 + 125% 缩放 = 1536 CSS px）， 把系统缩放调到 100%。
- 轮询别太频繁。 20 秒一轮是实测能用的节奏；5 秒一轮大概率触发风控。
- 私信只能读最近一屏（虚拟列表），历史要靠
scrollBack往上滚。 想看完整历史用douyin_history（读 DSH 会话日志，不受这个限制）。 mirror模式有重复发的风险：agent 自己调douyin_dm_send发的内容 也会被mirror回发一遍。同一时刻只用一种模式。- 语音只能读、不能发。 网页端没找到发送入口。
想改代码？
抖音的页面结构、cordis 的坑、媒体的坑，全在 PITFALLS.md。 25 条，都是实测撞出来又修掉的 —— 改之前先扫一眼，能省很多时间。
几条最要命的先放这：
ctx.agents读一下就抛异常（不是 undefined），整条插件会不激活，而且不报错- 改浏览器窗口大小会把私信面板关掉
- 发消息只看「输入框空不空」会假成功 —— 输入框可能在视口外，
insertText静默失败
隐私与合规
先读 DISCLAIMER.md。 摘要：
- 本项目只用于学习研究，使用后果由使用者自行承担
- 你必须自行遵守抖音的平台规则和适用法律法规
- 插件会读你的私信 ⇒ 好友的消息会进模型上下文，你选的模型服务商看得到
- 推到 GitHub 之前自己查一遍隐私（DISCLAIMER 里给了自查命令）
致谢与许可
MIT。实现上参考了 dsh-bili-scroll（同为 MIT）与 DSH 内置的插件开发指引，
详见 NOTICE.md。
No comments yet. Be the first to write one.