前言¶

DeepSeek Harness (DSH) 采用插件化架构，开发者经常需要在移动设备上与 agent 交互。dsh-weixin 插件解决了这一问题，它将手机微信作为对话 DSH agent 的入口，允许用户通过微信发送指令，由 agent 处理后通过微信回复，无需在手机上额外安装客户端。

dsh-weixin 是什么¶

这是一个 DeepSeek Harness 微信通道插件。由用户 wendayuan 维护，许可证为 MIT。它负责在微信端与 DSH 系统之间建立连接，使 agent 能够接收来自微信的消息，执行任务，并将结果返回给微信。

核心功能¶

1. 消息流转：手机微信发消息 → DSH agent 干活 → 回复发回微信。
2. 上下文连续：每个微信对话对应一个持久 session，支持多轮对话。
3. 凭据复用：复用 DSH 现有模型凭据（~/.dsh/.credentials.yaml），无需单独配置。
4. 规则注入：自动加载 ~/.dsh/AGENTS.md 与 workspace AGENTS.md，agent 具备与网页版一致的规则约束。
5. 进程常驻：插件随 DSH 进程常驻，无需独立守护进程。

安装与启用¶

使用官方安装命令添加插件：

dsh plugin --profile web add github:you/dsh-weixin

安装完成后，需要完成一次登录。插件复用微信官方 iLink 通道的扫码登录。

登录方式（推荐）：
使用桥接器 CLI 预登录，凭证存于 ~/.openclaw：

npx weixin-acp login

终端打印二维码，使用手机微信扫码并确认，终端显示「✅ 与微信连接成功」即可。之后该登录状态会随 DSH 进程自动复用。

配置¶

在 profile 的 cordis.patch.yml 中覆盖配置（均为可选）：

- id: weixin
  name: dsh-weixin
  config:
    cwd: /path/to/workspace   # agent 工作目录，默认为 DSH 启动目录
    provider: deepseek-official # 覆盖默认 provider 路由
    model: deepseek-v4-pro      # 覆盖默认模型

使用示例¶

配置完成后，在微信中依次发送以下消息进行验证：

1. 身份验证：发送「你是谁」，确认 agent 知道自身身份与工作目录。
2. 上下文测试：发送「记得刚才说了什么吗」，验证持久 session 与上下文连续性。
3. 工具测试：发送「用 bash 跑 pwd」，验证 agent 可以执行命令。
4. 规则测试：发送一个仅在 AGENTS.md 中有定义答案的问题，验证规则注入生效。

注：首次发送消息可能需要 10~30 秒的冷启动时间，属于正常现象。

安全与说明¶

• 通信安全：消息走微信服务器，非端到端加密。建议不要在微信中发送密码或 token。
• 安全边界：插件无消息白名单，安全边界等同于你的微信账号。建议微信开启双重验证或设备锁。
• 密钥存储：API key 不存储在本插件的任何文件中，由 DSH 凭据服务解析。
• 底层依赖：桥接底层使用社区包 weixin-agent-sdk，该包走微信官方 iLink 通道，但客户端代码非微信官方维护。
• 重启行为：DSH 重启会清空微信对话记忆（文件改动不受影响）。

结语¶

dsh-weixin 提供了将微信直接作为 DSH agent 界面的能力。它通过复用 DSH 的现有凭据与规则系统，降低了在移动端使用 agent 的门槛。更多细节与源码，请参考项目目录页或 GitHub 仓库。