dsh-wecom

dsh-wecom

English | 简体中文

DeepSeek Harness 的企业微信 AI 机器人渠道——支持持久化 agent、流式回复、思考卡片，以及单聊和群聊的历史会话切换。

通过官方长连接把企业微信「智能机器人」接入 dsh。每个会话对应一个持久化的 Harness agent（带工具），而不是裸聊天循环。

✨ 特性

• 🤖 一会话一 agent——在隔离 setup 里挂载 preset（默认 standard），天然拥有 preset 的工具（bash、read、edit、skills…）与人设；会话 id 由 sha256(namespace · scope · peer) 确定性派生（不落原始 userid），经 sessionPersistence 跨重启存活
• 🖼️ 多媒体——图片下载后用官方 SDK 解密、模型可看时自动附带；文件/视频落入 agent 工作区供工具读取
• ⚡ 流式回复——token 级文本流、原生 <think> 思考卡片、卡片内的紧凑工具调用列表
• 🛡️ 访问策略——单聊/群聊各自 open / allowlist / disabled（群按 chatid 控制）
• 🧹 消息治理——msgid 去重、按会话排队、全局并发上限、单轮超时主动 cancel 不留僵尸轮次
• 📡 自愈——长连接断开（被踢/鉴权失败/被新客户端顶掉）后按 restartIntervalMs（默认 10s）自动重连
• 🩺 可观测——每个机器人提供状态与重连服务，可接入独立管理面板
• 💬 机器人命令——/ping /help /status /stop /compact /new /session /current /resume

🚀 快速开始

dsh plugin --profile web add dsh-wecom

export WECOM_BOT_ID='你的机器人id'
export WECOM_BOT_SECRET='你的secret'   # 仅开发环境；生产用 credential 服务

dsh web

日志出现 WeCom AI Bot authenticated 后，发 /ping 应收到 pong。

持久化：WECOM_BOT_ID 写入 ~/.dsh/.env，WECOM_BOT_SECRET 写入 ~/.dsh/.credentials.yaml（引用 WECOM_BOT_SECRET）；DSH_WECOM_CWD 覆盖 agent 工作目录。

📦 从 npm 安装

发布包自带预构建的 dist/，安装时不会执行构建脚本：

dsh plugin --profile web add dsh-wecom          # 最新版
dsh plugin --profile web add dsh-wecom@0.5.3    # 锁定版本

升级同理：dsh plugin --profile web add dsh-wecom@<新版本>。装好后配置 WECOM_BOT_ID / WECOM_BOT_SECRET（见快速开始）并重启 dsh web。

需要 Node.js 22.19 或更新版本。版本变更见 CHANGELOG。

从 0.3.x 升级

0.5.3 包含 0.5.0–0.5.1 的历史会话切换、流式回复和图片卡片投递修复。 渠道插件现在提供状态与重连服务，不再自带浏览器状态面板、机器人管理界面或 /api/wecom/* 路由。需要这些界面时，请使用独立的面板集成。 升级时保持机器人的 namespace 和工作目录不变，以保留会话路由和持久化历史。

Harness 0.1.7-rc.2 请使用 0.5.3 或更新版本：0.5.2 仍按旧持久化接口读取， 可能导致历史列表为空。本次覆盖持久化 API 的 0.1.0-rc.6 和 0.1.7-rc.2； rc.2 的 CI 使用真实 JSONL 后端验证，不连接企微、不调用模型。

📦 从源码安装

Git 安装（请锁定 commit——构建脚本会在你机器上执行）：

dsh plugin --profile web add github:TtTRz/dsh-wecom#<sha>

如果 pnpm 报 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED，先审核固定的提交，再将它输出的完整 allowBuilds 条目加入对应 profile 的 pnpm-workspace.yaml。条目可能包含 Git URL 和提交 SHA，仅填写包名不够。重新安装，或改用本地构建的 tarball：

git clone https://github.com/TtTRz/dsh-wecom && cd dsh-wecom
npm install --legacy-peer-deps
npm pack                              # 产出 dsh-wecom-0.5.3.tgz
dsh plugin --profile web add ./dsh-wecom-0.5.3.tgz

本地目录：dsh plugin --profile web add /绝对路径/dsh-wecom（链接源码；先执行 npm install --legacy-peer-deps && npm run build 产出 dist/）。

⚙️ 配置

调整 ~/.dsh/profiles/web/cordis.patch.yml 中挂载的行：

- id: wecom-channel
  name: dsh-wecom
  config:
    botId: !!js process.env.WECOM_BOT_ID
    credentialName: WECOM_BOT_SECRET
    namespace: default
    # cwd 可选：默认 ~/.wecom-sessions（可用环境变量 DSH_WECOM_CWD 覆盖）
    cwd: /data/wecom
    preset: standard
    dmPolicy: open
    dmAllowlist: []
    groupPolicy: allowlist
    groupAllowlist: [wr_你的群chatid]
    greeting: 你好，我是助手。

多机器人配置

每个插件实例对应一个企微机器人。为新增实例设置不同的 namespace，并分别配置 凭据、访问策略、preset 和模型路由：

- insert:
    - id: wecom-channel-lab
      name: dsh-wecom
      config:
        botId: !!js process.env.WECOM_BOT_ID_2
        credentialName: WECOM_BOT_SECRET_2
        namespace: lab
        preset: standard

非默认实例提供 wecomChannelStatus.<namespace> 服务，路由状态保存在 .dsh-wecom-state.<namespace>.json。默认实例使用 wecomChannelStatus 和 .dsh-wecom-state.json。面板可直接消费各实例的服务，无需指定一个主机器人。

配置参考

💬 命令

🏗️ 工作原理

企业微信 AI 机器人
   │  WebSocket 长连接（wss://openws.work.weixin.qq.com）
   ▼
dsh-wecom（host 插件）
   │  msgid 去重 → 访问策略 → 按会话排队 → 全局并发上限
   │  创建/恢复 agent（setup 挂载 preset + 常驻指令段）
   │  agent.followup(userMessage) → await agent.whenIdle()
   │  超时 → agent.cancel()，不留僵尸轮次
   ▼
持久化的按会话 Harness agent（sessionPersistence）

为什么不是裸 agents.create：preset 在 setup 挂载（裸 agent 没有工具）、指令经 systemPrompt.section() 每轮常驻、超时取消保证下一条消息不被卡住、群聊按 chatid 白名单控制、全局 maxConcurrent 兜底。

🧩 集成

• 状态服务——ctx.get('wecomChannelStatus').snapshot() 返回标量（connected、stopping、conversations、authenticatedAt、lastError），供面板/UI 插件使用；其他机器人可用 channelStatusServiceName(namespace) 获取服务名
• 重连服务——调用同一个服务的 reconnect()，替换连接并唤醒重连循环
• 面板集成——渠道不注册 HTTP 路由或浏览器插槽；独立的 UI 插件可消费这些服务，并管理自己的路由、鉴权和展示

🧪 开发

npm install --legacy-peer-deps
npm run check   # biome + typecheck + test + build

# 在独立目录安装 Harness，用于持久化接口回归。
npm install --prefix /tmp/dsh-rc2 @deepseek-ai/dsh@0.1.7-rc.2
npm run test:persistence -- /tmp/dsh-rc2

📄 License

MIT