krudiy/wecom-bridge

README 摘要

wecom-bridge 使用说明（面向使用者） 把企业微信智能机器人接入 DeepSeek Harness (DSH) 的完整上手教程。 照着做，从零到能用大约 10 分钟。 0. 它是什么 - 不需要公网 IP、不需要配置回调地址和加解密 - 回答由本机 DSH agent 生成（和 DeepSeek 官方 API 共用凭据，也可接其他模型） 1. 你需要准备什么 1.1 企业微信侧（一次性） 1. 企业微信管理后台 → 找到「智能机器人」（应用管理 / 工作台里） 2. 进入机器人配置页 → 开启「API 模式」并选择「长连接」 3. 拿到两个凭证： - BotID ：机器人唯一标识 - Secret ：长连接专用密钥（注意：它 不是 回调模式的 Token/EncodingAESKey） 1.2 电脑环境 依赖 说明 检查命令 Node.js 18+ 跑 DSH node -v Python 3.10+ 跑桥接程序 python --version DSH + LLM 凭据 见第 2 节 npx -y @deepseek-ai/dsh --version Windows / macOS / Linux 均可（本说明以 Windows 为例）。 2. 配置 DeepSeek Harness（关键一步） 本程序本身不调用大模型， agent 全部由 DSH 执行 ，所以必须先让 DSH 能跑。 2.1 确认/安装 DSH 首次运行会自动下载。能输出版本号即 OK。 2.2 配置大模型凭据（二选一） - 方式 A（推荐） ：运行 npx -y @deepseek-ai/dsh web ，浏览器打开 http://127.0.0.1:3080 ，在 Models 页面填入你的 API Key （DeepSeek 官方 key 在 platform.deepseek.com 获取），保存后关掉即可。 - 方式 B ：参照 DSH 文档手动配置 /.dsh/.credentials.yaml 。 凭据存在 /.dsh/ 下，桥接程序与 Web 界面 共用同一份 ， 配一次即可。不需要一直开着 Web 界面。 2.3 验证 DSH 可用 输出 OK 即成功（首次会初始化 headless profile，稍慢属正常）。 3. 安装桥接程序 解压/克隆本目录后： 方式 1（Windows 一键） ：双击 启动WeCom桥接.bat （自动创建 .venv 、安装依赖、生成 config.yaml ）。 方式 2（手动，通用） ： 4. 填写配置 编辑 config.yaml ： config.yaml 包含真实 Secret， 不要发给别人、不要传 GitHub 。 5. 自检连接（30 秒） 看到 errcode=0 即连接成功： - 非 0：按第 7 节排查（多…

分类