michaelcode-wang/dsh-wecom
WeCom (Enterprise WeChat) Smart Robot bridge for DeepSeek Harness — two-way chat over the aibot WebSocket gateway, no public endpoint needed.
已收录
0
Notify
Bundle 已验证
预览
功能介绍
企业微信智能机器人桥接:aibot WebSocket 双向对话(bot_id + secret),无需公网回调。
适合
- 希望员工通过企业微信智能机器人直接与 DSH agent 对话的团队。
- 无法暴露公网回调地址、希望使用 aibot WebSocket 网关的部署。
- 需要按聊天隔离 agent 会话、保留上下文、用户白名单和空闲回收的多用户聊天工作流。
不适合
- 没有企业微信智能机器人的 bot_id 与 secret 的组织。
- 尚未手动补充所需 preset roster 的独立 im profile。
- 安全敏感但将 allowedUserIds 留空的部署,因为此时任何用户都可能驱动主机工具。
README
dsh-wecom
企业微信(WeCom)智能机器人桥接插件:通过 aibot WebSocket 网关,让 DeepSeek Harness 的智能体变成能在企业微信里双向对话的助手。无需公网地址、无需自建应用回调,只需智能机器人的 bot_id + secret。
协议移植自 Hermes Agent 的 plugins/platforms/wecom/adapter.py(aibot_subscribe 认证 → aibot_msg_callback 收消息 → aibot_respond_msg / aibot_send_msg 回复)。
特性
- 企业微信智能机器人 WebSocket 长连接(
wss://openws.work.weixin.qq.com),断线自动退避重连 - 每个聊天一个独立 agent 会话,多轮上下文保留,空闲自动回收
- 白名单访问控制(
allowedUserIds) - markdown 回复 + 超长消息自动分片(默认 4000 字符)
- 聊天命令:
/help、/reset、/status
安装
# 从 npm(推荐)
dsh plugin --profile im add dsh-wecom
# 或从 GitHub
dsh plugin --profile im add github:michaelcode-wang/dsh-wecom
前置条件
-
企业微信智能机器人:在企业微信后台创建一个「智能机器人」,拿到
bot_id和secret。 -
im profile 需要 preset roster:独立
improfile(dsh-base+ 本插件)没有 web 层,而 preset roster(agent-presets)默认由dsh-web-app提供。若要让 agent 挂载某个 preset,需在 im profile 的cordis.patch.yml里手动插入 roster(见下方完整示例)。
配置
在 $DSH_HOME/profiles/im/cordis.patch.yml 中:
# 1) 插入 preset roster(im profile 无 web 层,需手动补)
- insert:
- id: agent-presets
name: '@deepseek-ai/dsh-agent-presets'
config:
default: taibai # 默认 preset;可按需改成你自己的 preset
# 2) 启用本插件
- id: dsh-wecom
disabled: false
config:
botId: '你的机器人ID'
secret: '你的机器人密钥'
allowedUserIds: ['你的企业微信userid']
agent:
preset: taibai # 每个企业微信聊天对应的 agent preset
启动:
dsh --profile im(建议配 launchd / systemd 常驻)。
配置项
| 键 | 默认 | 说明 |
|---|---|---|
enabled |
true |
总开关 |
botId |
'' |
企业微信智能机器人 ID |
secret |
'' |
企业微信智能机器人密钥(只写) |
websocketUrl |
wss://openws.work.weixin.qq.com |
WebSocket 网关地址 |
allowedUserIds |
[] |
允许对话的 userid 白名单;留空=所有人 |
agent.preset |
taibai |
挂载的 agent preset |
agent.cwd |
'' |
agent 工作目录(默认进程 cwd) |
agent.provider / agent.model
|
'' |
模型覆盖;留空=部署默认 |
agent.maxMessageLength |
4000 |
单条外发消息最大字符数 |
agent.idleTimeoutMs |
1800000 |
聊天空闲多久后释放 agent(0=永不) |
安全
-
务必配置
allowedUserIds白名单——留空意味着任何人都能驱动你的智能体执行主机工具。 -
secret标记为role('secret'),不会回显到浏览器。
常见问题常见问题
在启用了 DSH 的终端中执行已验证命令 dsh plugin --profile default add github:michaelcode-wang/dsh-wecom。命令会解析公开 package 元数据,并保持插件与本页展示的目录身份一致。
兼容性以页面上展示的 bundle 与 profile 状态为准。如果某个 profile 尚未检测到,请先保持禁用,并在生产启用前阅读仓库文档。
GitHub 链接和 activity 元数据是 release 与维护状态的来源。新版本发布后重新查看本页,确认目录已经观察到最新版本。