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；已验证版本和未验证范围见 兼容性说明。

快速开始

1. 确认 profile 已有一个你希望用于微信会话的工作目录。

2. 安装插件并重启 DSH：

   dsh plugin --profile <你的 profile> add dsh-channel-wechat
   

3. 打开 GUI 的 Plugins → dsh-channel-wechat，点击登录微信，使用手机扫码；需要验证码时在页面输入。

4. 从微信向 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。

友链

• LINUX DO — Where possible begins