DeepSeek Harness (DSH) 的核心设计理念是「一切皆插件」。dsh-wechat-bridge 是一个由 zxz9988 维护的联网工具插件,其核心作用是将手机微信接入 DSH 的 AI 助手。该插件使用腾讯官方的 iLink / ClawBot 协议,实现了在微信端与 DSH 进行流式交互的能力。
核心功能¶
插件主要解决了「如何在手机上方便地使用 DSH」的问题,具体能力如下:
- 连接与登录:支持扫码登录,登录凭证持久化存储;支持流式回复,模拟打字机效果。
- 会话管理:为每个联系人维护独立的 AI 会话,互不串扰;支持会话持久化,DSH 重启后可恢复上下文。
- 消息处理:支持语音消息转文字、图片接收与 OCR、文件接收与解析。
- 排版与回传:支持将 Markdown 格式转换为微信友好的纯文本;支持 AI 生成文件后自动回传到微信。
- 自动化与安全:支持通过 cron 配置定时任务;支持白名单 (
allowFrom) 和管理员 (admins) 权限控制;支持拦截纯链接消息;具备重试机制与日志记录。 - 群聊支持:代码层面已支持群聊,但受限于当前微信 ClawBot 平台限制,机器人无法被拉入群聊,因此群聊功能暂不可用。
安装与启用¶
DSH 插件安装在 profile 中(默认路径为 ~/.dsh/profiles/web/)。安装后,建议重启 DSH 以确保代码生效。
方式 A:官方命令安装(推荐普通用户)
dsh plugin --profile web add @zxz9988/dsh-wechat-bridge
方式 B:本地链接安装(推荐开发迭代)
cd "$env:USERPROFILE\.dsh\profiles\web"
pnpm add "link:<插件仓库路径>"
使用
link:方式安装后,修改源码并重启 DSH 即可生效,无需重复安装。
配置与用法¶
首次安装后,插件默认启用,会自动生成登录页面。使用 /help 命令可查看帮助,/new 命令可清空当前联系人的对话上下文。
1. 配置权限与任务
可通过 override.json 文件配置白名单、管理员列表及定时任务。该文件位于 ~/.dsh/wechat-bridge/,修改后约 5 秒热加载。
{
"allowFrom": ["<你的 iLink 用户 ID>"],
"admins": ["<你的 iLink 用户 ID>"],
"jobs": [
{
"id": "morning-news",
"cron": "0 7 * * *",
"prompt": "收集今天 AI 行业头条并总结要点",
"to": "<你的 iLink 用户 ID>"
}
]
}
2. 可选:网页抓取(MCP)
若需 AI 在微信中读取网页内容,可配置自研的 mcp-fetch 服务器。需在 cordis.patch.yml 中挂载工具 mcp__fetch__fetch。
注意事项¶
- 代码更新:修改插件源码后必须重启 DSH 才能加载新代码;配置项的修改通常支持热加载。
- Windows Defender:在 Windows 系统上,Windows Defender 可能会将
lib/index.js误报为威胁。如遇此情况,需在安全软件中将该文件或目录添加到排除列表。 - 依赖项:插件依赖
wechat-ilink-client(MIT),与 CC-Connect 项目无代码关联。 - 群聊限制:虽然代码已就绪,但由于平台限制,目前无法实现机器人入群。
结语¶
dsh-wechat-bridge 是一个功能完整的微信中转方案,通过官方协议保证了连接的稳定性。它适合需要在移动端通过微信调用 DeepSeek 能力的场景。项目源码及文档可查阅:https://github.com/zxz9988/dsh-wechat-bridge