DSH 企业微信桥接
将以下提示词粘贴到你的 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` 的信息安全协作者