dsh-im-wecom — 企业微信 Bot × DeepSeek Harness 对话 Skill

让企业微信智能机器人与本机 DeepSeek Harness 对话。零手写桥接代码：接入由 @xmanrui/dsh-im 插件完成（官方 WebSocket 长连接、加密、流式回复全部内置）。 增强能力：企微发图 → 自动转交夸克千问侧栏分析 → 只把分析文本交给 Harness 模型（纯文本模型也能"看图"，且模型感知不到图片存在）。

核心认知（最重要，先读）

• ❌ 错误做法：手写 wecom_bot.py / 自己调企业微信 API 桥接——容易启动失败（exit code 1）、无流式、无会话管理、难维护。之前踩过的坑：进程起不来、文件写不进、连接不上。
• ✅ 正确做法：安装 @xmanrui/dsh-im 插件（一个插件统一九种 IM 渠道），在 Web 界面「设置 → IM机器人」里扫码或填凭据。
• 🧠 图片怎么办：默认模型若是纯文本模型（如 deepseek-v4-flash），企微发图会被拒（"当前模型不支持图片"）。不要因此切模型——安装本 skill 附带的 patch/ 补丁，图片会改走夸克千问侧栏（quark-qwen-vision skill 的 qwen-vision.js），模型只收到千问的分析文本。

功能特性

安装与接入步骤

第 0 步：企业微信侧准备（获取 Bot ID + Secret）

1. 打开企业微信客户端 → 工作台 → 智能机器人（若无入口，可在企业微信管理后台「应用管理」中启用/创建"智能机器人"）
2. 创建并设置智能机器人，接入方式选择 长连接
3. 复制机器人的 Bot ID 与 Secret（Secret 等同密码，妥善保管）
4. 把 Bot ID + Secret 交给 Harness 配置（下一步）

# 1. 安装插件（web profile，推荐 npm 稳定版）
dsh plugin --profile web add -w @xmanrui/dsh-im

# 2. 重启 dsh web，刷新浏览器，打开「设置 → IM机器人」→ 左侧选「企业微信」

# 3. 绑定凭据：把第 0 步的 Bot ID + Secret 填入「手动绑定」（或扫码创建智能机器人）
# 4. 配置热生效（无需重启）：企业微信群里 @ 机器人，或在单聊中直接发消息

本仓库已含源码副本与补丁：patch/ 目录（见 README 与 patch/README.md）。

千问侧栏读图代理（增强功能）

为什么需要：企微图片以 image block 进入 Harness 时，Host 会做模型能力预检；纯文本模型（deepseek-v4-flash 等）会拒绝（错误码 INPUT_INVALID / "当前模型不支持图片"）。

补丁做了什么：在 wecom-bridge.mjs 的图片处理处插入代理——图片不再构造 image block，而是：

企微图片 → SDK 下载(解密 aeskey) → 临时文件 → 夸克千问侧栏(CDP 粘贴+提问)
        → 千问分析文本 → [{type:'text'}] 纯文本进会话 → 模型正常回答

效果：模型请求中永远没有图片；预检永不触发；模型看到的是"一段图片分析文字"（等价于收到链接/描述而非图片）。千问页面为共享单例，代理已做全局串行队列。

安装（前置：夸克 9222 调试模式 + 千问对话页已开 + 有 quark-qwen-vision skill）：

powershell -ExecutionPolicy Bypass -File patch\apply-patch.ps1

完成后重启 dsh web，再在企微发图测试。

配置（环境变量）：

排错：发图仍报"不支持图片" = 代理 fallback 触发（夸克未开/千问页未开/脚本路径不对）。用 node <qwen-vision.js> <图> "问题" 单独验证。

使用方式

• 群聊：@ 机器人 → DSH 智能体接管并处理任务（在你指定的工作区创建文件夹、查看文件、跑 skill）
• 单聊：直接发消息即可
• 会话：每条聊天默认绑定独立 Harness 会话；/new 开新会话，/session 绑定已有会话
• 工作区：默认使用 Host 当时工作目录，可在机器人卡片改；也可发 /workspace <绝对路径> 切换

机器人命令速查

故障排查

关联

• 插件源码/文档：@xmanrui/dsh-im（npm / GitHub xmanrui/dsh-im），Node ≥ 22.19
• 视觉通道：quark-qwen-vision（夸克内置千问，CDP 网页操作，零 API Key）
• 本仓库：SuperMate-Ai/dsh-im-wecom（README.md 完整文档 / FEATURES.md 功能明细 / patch/ 补丁包）