Agent Skills
返回列表
DSH 企业微信桥接

DSH 企业微信桥接

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_7d16a562/dsh-wecom-bridge。

技能介绍

要解决什么问题

企业微信侧的「智能机器人」通常以长连接模式与业务进程对接,而 DSH 智能体运行在独立的 Cordis 插件栈里:会话、工具、技能与流式输出都不在企业微信原生协议中。要把同一套 DSH 能力接到企微单聊与群聊,还要在多轮对话、图片消息和技能热更新下稳定运维,单靠官方文档往往不够——很多坑来自源码构建依赖、字节级流式上限和 sessionId 持久化冲突。

本技能把作者在生产环境里跑通的架构理解、目录约定、.env 含义与故障对照表整理成可按章节执行的运维手册,而不是抽象的产品说明。

技能如何工作

  • 桥接层(dsh-wecom-bridge/):Node 进程主动出站连企微 WS,处理消息、按用户隔离会话(sessionId = wecom-<userId>),并把 DSH 输出事件实时转发为企微流式回复。
  • 运行时层:由 runtime.cordis.yml 组合 DSH 插件(agent-spine、工具、技能系统、compaction);多轮延续依赖 DSH 原生能力与 history.js 在重启后播种上下文。
  • 配置与运维:BOT_ID/BOT_SECRET、DEEPSEEK_API_KEY、BOT_NAME(须与企微显示名一致)等变量有明确必填语义;日志在 data/bridge.log,会话落盘在 data/sdk-sessions/(按进程时间戳子目录,避免 id collision)。
  • 边界能力:超长回复按字节截断并拆段(企微单条约 20480 字节上限);无视觉模型时用本地 OCR;新技能走 bridge/skills/**/SKILL.md 与 skill-installation 流程,watch 热更新。

适用边界与注意点

  • DSH 必须源码构建(部分 npm 包未发布完整),内网环境需考虑镜像与免 sudo 自启方式。
  • 同一 BotId 只允许一个长连接;多机部署须各用独立机器人。
  • 群聊对全体成员开放即等于允许群友触发本机命令能力,只放进可信群;.env 与技能内明文密钥勿入库,敏感技能可设 disable-model-invocation: true。

使用场景

  • 在内网 Ubuntu 服务器上首次把 DSH 源码构建好,并让企业微信智能机器人通过出站长连接连上桥接进程
  • 群成员 @ 机器人无响应时,对照日志里的 `botName` 核对 `BOT_NAME` 是否与企微后台显示名一致并重启
  • 智能体输出很长、企微流式回复被截断时,确认桥接的字节级拆段与续发策略是否按预期生效
  • 在多台桥接机上同步更新 `bridge/skills/` 目录后,依赖 watch 热加载让新装技能无需整栈重启即可被 DSH 注册

适合人员

  • 负责内网 Linux 上企微机器人与 Node 桥接进程常驻、用 crontab 或 nohup 避免 SSH 断开即停服的基础架构工程师
  • 维护 DSH 工作区与 `runtime.cordis.yml` 插件栈,需要把单聊白名单、群前缀 `GROUP_TRIGGER` 与真实触发行为对齐的智能体运维
  • 每周要对照 `data/bridge.log` 与 `sdk-sessions` 目录排查 session 持久化冲突或 DeepSeek API key 读空的 ML 平台值班
  • 只把桥接放进可信企微群、并要为 LIMS 等敏感技能配置 `disable-model-invocation` 的信息安全协作者