前言¶
如果你已经在用 DeepSeek Harness（DSH）做智能体流程，下面这个插件适合用来接入企业微信：它把企业微信 AI Bot 作为一个通道接到 DSH，让单聊或群聊消息进入一个持久 Harness 代理。
先做 X，再做 Y 的路径也比较直接：先安装 dsh-wecom，再准备 WECOM_BOT_ID 和 WECOM_BOT_SECRET，最后启动 dsh web。经过上面的步骤后，聊天消息就可以进入带预设、工具和会话状态的代理链路。
这是什么¶
dsh-wecom 是 TtTRz 维护的 DSH 插件，许可证为 MIT。
它的定位是一句话：WeCom AI Bot channel for DeepSeek Harness — each chat runs a persistent, preset-backed agent over the official long connection。
也就是说，它不是简单地在企业微信和模型之间转发消息，而是让每个单聊或群聊对应一个持久 Harness 代理，并挂载预设（默认 standard）以提供工具和 persona。
核心功能¶
下面按已核实能力介绍。
会话代理¶
每个单聊或群聊对应一个持久 Harness 代理。代理会挂载预设，默认是 standard，以此提供工具和 persona。
消息处理¶
插件支持以下消息链路控制：
msgid去重- 单会话队列
- 全局并发上限
- 单轮超时取消
长连接断开后，通道会按 restartIntervalMs（默认 10s）自动重启。
媒体与输出¶
媒体方面，图片可以下载、解密，并在模型可看图时附带；文件和视频会进入代理工作区。
输出方面，插件支持：
token级流式回复- 原生
think推理卡片 - 紧凑工具调用列表
访问策略¶
单聊和群聊的访问策略支持：
openallowlistdisabled
群聊按 chatid 限制。
状态与命令¶
插件提供 wecomChannelStatus 服务、GET /api/wecom/status 状态接口、侧边栏状态点和浮动状态面板。
聊天侧支持以下命令：
/ping
/help
/status
/stop
/compact
/new
安装与启用¶
资料给出的安装命令是：
dsh plugin --profile web add dsh-wecom
安装后，先准备凭据，再启动 web：
export WECOM_BOT_ID='your-bot-id'
export WECOM_BOT_SECRET='your-bot-secret' # dev only — 生产环境使用 credential service
dsh web
如果希望跨重启保留配置，资料建议：
- 将
WECOM_BOT_ID写入~/.dsh/.env - 将
WECOM_BOT_SECRET写入~/.dsh/.credentials.yaml
如果希望覆盖代理工作目录，可以设置：
DSH_WECOM_CWD
源码安装示例如下，需要固定提交：
dsh plugin --profile web add github:TtTRz/dsh-wecom#<sha>
注意：Git 安装会运行构建脚本；pnpm >=10 会拒绝 git 依赖构建脚本，建议优先使用预构建包。
典型用法¶
启用插件后，可在：
~/.dsh/profiles/web/cordis.patch.yml
中配置 wecom-channel 行。
下面只列已核实资料中明确提到的配置要点：
- 预设默认值为
standard - 单聊和群聊访问策略可为
open、allowlist或disabled - 群聊按
chatid限制 DSH_WECOM_CWD可覆盖代理工作目录
安装完成并启动后，可以发送 /ping 检查连通性，再用 /status 查看会话状态，或用 /stop 取消当前生成。
适用场景与注意¶
适合这些场景：
- 已经使用 DSH，希望把企业微信单聊或群聊作为智能体入口
- 希望每个会话拥有持久代理、预设工具和
persona - 需要访问策略、并发控制、超时取消、流式回复和状态观察
使用前注意：
WECOM_BOT_SECRET环境变量被文档标注为dev only；生产环境使用 credential service- 插件以当前
dsh进程权限运行，安装前应检查源码和许可证 engines.node要求>=22.19- 已核实资料中
package.json版本为0.3.0，README 示例中也出现过0.1.17和0.1.5；如果需要固定版本，安装前先核对目标版本
链接¶
GitHub 仓库：
https://github.com/TtTRz/dsh-wecom
已核实资料未提供可核实的社区目录页 URL，本文不列出。
