dsh-douyin-bridge
DSH 插件：把抖音私信接进 DSH —— 私信进 DSH 会话，AI 用工具刷视频、分享、聊天
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:pcmxiao/dsh-douyin-bridge#b2cacc0b73661fd6c5d824575939f4cd8b6d31b8Douyin Bridge 以 dsh-douyin-bridge 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
把抖音私信接进 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 层要重启才组装）。
然后：
之后它自己就开始轮询了。
⚠️ 桌面版（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，等于把你整个私信列表喂给模型。
| 工具 | 干什么 |
|---|---|
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 配了就只有名单里的人能收到消息。
对方发来图片时，桥接会：
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 存聊天记录」的玩具脚本最本质的区别。
node tools/probe-canary.mjs 看哪条降级链挂了。/jingxuan，
分享会失败。插件返回 VIDEO_UNAVAILABLE，不会假装成功。scrollBack 往上滚。
想看完整历史用 douyin_history（读 DSH 会话日志，不受这个限制）。mirror 模式有重复发的风险：agent 自己调 douyin_dm_send 发的内容
也会被 mirror 回发一遍。同一时刻只用一种模式。抖音的页面结构、cordis 的坑、媒体的坑，全在 PITFALLS.md。 25 条，都是实测撞出来又修掉的 —— 改之前先扫一眼，能省很多时间。
几条最要命的先放这：
ctx.agents 读一下就抛异常（不是 undefined），整条插件会不激活，而且不报错insertText 静默失败先读 DISCLAIMER.md。 摘要：
MIT。实现上参考了 dsh-bili-scroll（同为 MIT）与 DSH 内置的插件开发指引，
详见 NOTICE.md。