dsh-channel-wechat
English | 中文
把微信（腾讯 iLink / ClawBot）接入 DeepSeek Harness 的通道插件。它以一个 npm 包同时提供 Harness bundle 和 GUI 浏览器端，运行在 Harness 进程内。
能做什么
- 微信文本、图片、文件等消息与 DSH 双向收发。
- 微信消息进入 DSH 会话，回复从
session/event 回到微信。
- 微信内置命令（含
/models、/model、/help）、/stop、审批卡和提问卡。
- GUI 插件页扫码登录、退出登录、配置工作目录、卡片投递方式、模型和权限。
- 长轮询与会话处理解耦；诊断写入终端和插件日志。
群聊、运行期多账号、主动推送和独立权限系统不在当前范围内。
环境要求
| 组件 | 要求 |
|---|
| Node.js | ^22.19.0 或 >=24.0.0 |
| pnpm | 11（仓库声明 pnpm@11.7.0） |
| DeepSeek Harness | >=0.2.0-rc.1 |
安装门槛来自 package.json 的 engines；已验证版本和未验证范围见 兼容性说明。
快速开始
-
确认 profile 已有一个你希望用于微信会话的工作目录。
-
安装插件并重启 DSH：
dsh plugin --profile <你的 profile> add dsh-channel-wechat
-
打开 GUI 的 Plugins → dsh-channel-wechat，点击登录微信，使用手机扫码；需要验证码时在页面输入。
-
从微信向 bot 发一条消息，确认 DSH 回复返回微信。
安装后必须完全退出并重启 DSH，宿主才能发现浏览器端配置页。刚发布版本若被 pnpm 的观察期跳过，可使用：
dsh plugin --profile <你的 profile> add dsh-channel-wechat@latest --config.minimumReleaseAge=0
配置
GUI 页面可编辑全部配置。也可以在 profile 的 cordis.patch.yml 中写：
- id: channel-wechat
config:
cwd: /你的/工作目录
cards: wechat
provider: ''
model: ''
permission: workspace-write
cwd 必须是绝对路径；它在会话创建时写入且不可变，修改只影响之后的新会话。完整字段、默认值和权限边界见 配置参考。
没有 web app 的 profile 可以使用终端登录：
dsh <profile> login
dsh <profile> status
dsh <profile> logout
web/desktop profile 的启动器会先拒绝 login 位置参数，请改用 GUI 登录。
数据与日志
| 内容 | 位置 |
|---|
| 会话记录 | ~/.dsh/sessions/<cwd 转义>/channel-wechat-<peerId>[~g<N>]/session.v4.jsonl.zstd |
| 插件状态 | ~/.dsh/channel-wechat/ |
| 诊断日志 | ~/.dsh/channel-wechat/log/channel-wechat-YYYY-MM-DD.log，保留 7 天 |
| 登录凭证 | ~/.dsh/.credentials.yaml |
聊天记录由 DSH 持久化，/new 只创建新的会话代次，不删除旧记录。排障时不要分享 token、Cookie 或凭证文件内容。
常见问题
- 插件页没有配置区：完全退出并重新打开 DSH，见 故障排查。
- 登录命令报参数错误：web/desktop 只支持 GUI 登录。
- 消息没有回复：先查插件日志、账号状态和
cwd 是否为绝对路径。
- 引用或媒体降级为文本：部分引用字段和服务端 uint64 消息 id 是已记录限制，详见故障排查。
文档索引
用户指南
获取帮助
请先查看故障排查和插件日志。仍未解决时，请在 GitHub Issues 提供 DSH 版本、插件版本、profile 类型、复现步骤和脱敏日志；不要提交 token、Cookie 或凭证文件。
开发与设计
贡献与维护
欢迎通过 GitHub Issues 报告问题或提出建议，也可以提交 Pull Request。提交前请阅读 开发与验证，并运行构建、类型检查和相关测试。项目维护者与仓库信息见 GitHub repository。
本地开发
pnpm install
pnpm build
pnpm typecheck
pnpm test
pnpm test:integration
集成测试使用隔离的临时 DSH_HOME，默认寻找本地 DeepSeek Harness checkout；需要时设置 DSH_CHECKOUT=/path/to/deepseek-harness。详细说明见 开发与验证。
许可证与第三方声明
本项目使用 MIT，第三方代码和完整版权声明见 LICENSE 与 THIRD_PARTY_NOTICES.md。协议实现参考腾讯的 openclaw-weixin。
友链
