前言¶
在 DSH 的插件化使用方式下，dsh-plugin-wechat 提供一个微信入口。它解决的问题很具体：让你用微信里的文字消息触发 DeepSeek Harness（DSH）的 AI，并收到带工具和记忆的回复。
如果你已经在用 DSH，并希望有一个微信入口来做查询、处理文字任务，下面介绍它的功能、安装命令和日常维护方式。
这是什么¶
仓库名：gnulife/dsh-plugin-wechat。
许可：MIT。
一句话定位：把 DeepSeek Harness（DSH）变成个人微信机器人——微信扫码接入，每条微信消息由 DSH 的 AI（带工具和记忆）回复。
它使用腾讯官方 ClawBot（iLink）通道，需遵守《微信ClawBot功能使用条款》。
核心功能¶
- 微信扫码接入。
- 每条微信消息由 DSH 的 AI（带工具和记忆）回复。
- 支持联网搜索，使用
web_search工具；可用WECHAT_ENABLE_SEARCH=false关闭。 - 目前只支持文字消息，其他类型会收到“暂不支持”提示。
- 支持 macOS launchd 开机自启和崩溃自动重启。
- 支持通过环境变量或 DSH 插件配置界面设置
workspace、session mode、force login、mode、enable search、DSH_WEB_PORT。
安装与启用¶
启动¶
先运行：
npx -y dsh-plugin-wechat
启动后，终端里会出现二维码。用手机微信扫码确认。
接着打开：
http://127.0.0.1:3080
在「设置 → 模型」填入 DeepSeek API Key。完成后，用微信发送文字消息测试回复。
日常使用¶
重跑初始化脚本：
bash scripts/setup.sh
该脚本幂等，可重复执行。
停止¶
pkill -f "dsh web"
日志¶
日志目录：
~/.dsh-plugin-wechat/logs/
典型用法¶
换账号或重新登录¶
删除本地登录凭证并重新扫码：
rm -rf ~/.dsh/wechat/accounts.json && node scripts/login.js
也可以使用：
dsh-wechat-login
登录凭证保存在：
~/.dsh/wechat/accounts.json
首次登录仍需终端扫码一次。
macOS 自启¶
先确认已登录过微信：
node scripts/login.js
安装并启动后台服务：
bash scripts/service.sh install
查看状态：
bash scripts/service.sh status
日常命令：
bash scripts/service.sh status
bash scripts/service.sh start
bash scripts/service.sh stop
bash scripts/service.sh uninstall
这套服务支持 macOS launchd 开机自启和崩溃自动重启。
指定工作目录¶
让微信 agent 在指定目录下工作：
WECHAT_WORKSPACE=/Users/you/my-projects bash scripts/service.sh start
也可以在 DSH 插件配置界面的 workspace 字段填写。修改配置后需要重启 DSH 生效：
bash scripts/service.sh start
配置项¶
可以通过环境变量或 DSH 插件配置界面设置：
WECHAT_WORKSPACE/workspaceWECHAT_SESSION_MODE/session modeWECHAT_FORCE_LOGIN/force loginWECHAT_MODE/modeWECHAT_ENABLE_SEARCH/enable searchDSH_WEB_PORT
关闭联网搜索：
WECHAT_ENABLE_SEARCH=false
扫码网络错误¶
如果扫码时遇到网络错误，可能是代理工具劫持了微信域名。需要给微信域名加直连规则，例如：
prepend-rules:
- DOMAIN-SUFFIX,weixin.qq.com,DIRECT
- DOMAIN-SUFFIX,liteapp.weixin.qq.com,DIRECT
加完规则后重跑：
bash scripts/setup.sh
适用场景与注意¶
适合的场景：
- 你希望用微信文字消息触发 DSH 的 AI。
- 你希望在本机维护一个被动回复的微信机器人。
- 你需要在 macOS 上做开机自启和崩溃自动重启。
注意事项：
- 目前只支持文字消息，图片、语音等类型会收到“暂不支持”提示。
- 建议只做被动回复，不群发、不营销。
- 保持 DSH 权限为
workspace-write，勿开danger-full-access；桥默认只监听本机。 - 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
- Windows 环境请用 Git Bash 或 WSL。
- 修改配置后需重启 DSH 生效。
结尾¶
dsh-plugin-wechat 的价值在于把微信文字消息接到 DSH 的 AI 会话上，让你可以在微信里完成查询和文字任务。
仓库地址：
https://github.com/gnulife/dsh-plugin-wechat.git
