dsh-phone-bridge
把 DeepSeek Harness(DSH)变成随身可用的东西 —— 一个能在微信里随时对话的机器人,加上一个把 DSH 网页界面重排成手机 App 的插件。
English · 部署指南 · 装成手机 App · 踩坑记录 · 使用边界
> ⚠️ 仅限个人自用。这是一个"一个人 + 一个机器人 + 一段对话"的单人工具,不授权用于对外提供服务、群发营销、骚扰他人、窥探隐私、绕过平台规则或替他人托管账号——详见 使用边界。一切后果由使用者自负。
包含两个独立插件
可以只用其中一个。
1. dsh-wechat-connect —— 微信桥接
在服务器上长轮询微信 iLink 机器人网关。文字、图片、语音、文件双向收发,单一工作目录 + 单一 DSH 会话——这个机器人只服务它自己的主人。
- 发图片给机器人 → DSH 用视觉工具读;发文档 → DSH 直接打开处理
- 要文件 → 模型在回复里写
[[send:/绝对路径]],桥接自动上传回聊天 - 定时早报 —— 每天到点自动联网汇总前一天的国际 + AI 要闻,以文字消息 + Word 文档两种形式推送
- 自愈 —— 长轮询循环失败后自动重建;同时写心跳文件,外部看门狗能发现"进程活着但卡死"
2. dsh-mobile-ui —— 手机端界面适配
DSH 自带的是三栏桌面布局:手机上输入框被键盘遮住、侧栏把正文挤成一条缝、设置页每个字竖排一行。本插件通过官方 webserver/index-inject 注入口送一份样式表 + 一小段脚本,不改 DSH 源码、不打 dist 补丁:
| 手机上的问题 | 插件做的事 |
|---|---|
| 左侧图标栏占 56px,控件只有 28px 高 | 底部四格导航,触摸目标 44px |
| 键盘遮住输入框 | 布局高度跟随 visualViewport |
| 侧栏把正文挤成 132px | 全屏会话抽屉,选完自动收起 |
| 设置页文字竖排 | 全屏单列,导航变成顶部横向条 |
| 右侧栏打开后没有返回入口 | 常驻「← 返回对话」按钮 |
| iOS 聚焦时整页放大 | 输入框强制 16px |
| 没有主屏图标 | PWA 清单 + PNG 图标 → 可装成 App(独立图标、全屏、无地址栏) |
> 📱 还能变成真正的手机 App —— 不用写 APK、不用上架:Chrome 里「添加到主屏幕」即可,
> 独立图标 + 全屏运行;清单的 start_url 指向登录短链后,App 每次启动都会自动登录。
> 详见 docs/MOBILE-APP.md。
目录结构
packages/
dsh-wechat-connect/ 微信桥接插件(iLink 网关)
dsh-mobile-ui/ 手机端适配插件(HTTP 注入,不改源码)
deploy/
systemd/ 开机自启、崩溃重启、看门狗、会话归类、journald 上限
scripts/ 看门狗与会话归类脚本
nginx/ 反向代理 + mTLS 设备级访问控制示例
pwa/ 手机 App 清单示例 + 图标渲染脚本
docs/
SETUP.md 从零部署全流程
MOBILE-APP.md 把网页界面装成手机 App(PWA)
PITFALLS.md 18 条踩坑记录(DSH 内部机制 + 微信网关)
USAGE-BOUNDARY.md 仅限个人自用的使用边界
快速开始
# 服务器需要 Node 20+
npm i -g @deepseek-ai/dsh
# 把插件放进 DSH profile 的 node_modules 并加进 bundles —— 见 docs/SETUP.md
最小配置($DSH_HOME/profiles/wechat/cordis.patch.yml):
- id: wechat-connect
config:
enabled: true
sessionProfile: headless
workDir: /root/dsh-convos/wechat
allowFrom: "wxid_your_peer@im.wechat" # 只放行你自己
workDir: /root/dsh-convos/wechat # 单一工作目录(不分子目录)
schedule:
enabled: true
time: "06:00"
peers: ["wxid_your_peer@im.wechat"]
prompt: |
[定时任务·每日早报] 检索昨天的大事,写成 Word 文档,
再输出一段精简版微信消息,最后写 [[send:文档绝对路径]]。
完整流程(模型 API、扫码登录、反向代理 + 客户端证书、保活体系)见 docs/SETUP.md。
设计要点
- 不 fork、不打补丁:手机端适配走官方注入口;微信桥接是标准 DSH 插件。
- 克隆而不是搬动 DOM:需要往 React 管的界面里加按钮时(底部导航、输入框右侧控件),克隆原节点并转发点击,绝不动 React 的树。
- 单人单会话:桥接只维护一个工作目录、一条 DSH 会话 —— 这正是微信机器人网关被设计出来的用法。没有多人联系人那套东西可以配错。
- 三层保活:systemd 崩溃重启 → 插件内循环重建 → 外部心跳看门狗(对付"进程活着但没在工作")。
已知边界
- 机器人是独立的微信账号,不是你本人:它只能看到发给它的消息,读不到你个人微信里的聊天。
- 它只为一个主人服务。请把
allowFrom设成你自己的微信 id,这样别人即使找到这个机器人也会被忽略。 - 主动推送(早报)依赖微信网关的
context_token,需要你先给机器人发过一条消息。 - iLink 机器人网关不是公开版本化的 API,
channel_version不同会导致上传接口返回结构不同(代码已兼容两种)。
License 与使用边界
代码用 MIT 许可;使用范围仅限个人自用,详见 使用边界。