@wwlocal/aibot-connector 20260410.9.0

package/README.md

@@ -0,0 +1,471 @@
+# @wwlocal/aibot-connector
+
+企业微信私有化智能机器人连接器（Node.js版），可以通过简单配置将多个智能机器人和大模型/智能体服务建立连接，方便快速、便捷体验智能机器人功能。
+
++-----------------------+     +-------------------+     +-----------------------+
+|   企业微信私有化部署    |     |  aibot-connector  |     |   大模型/智能体服务     |
+|       (wwlocal)       |     |   (Node.js App)   |     |    (LLM / Agents)     |
++-----------------------+     +-------------------+     +-----------------------+
+|                       |     |                   |     |                       |
+| [ 个人机器人 ]         |     |                   |     | [ 大模型服务 (LLM) ]  |
+| - 张三的智能机器人      |     |    +---------+    |     | - DeepSeek            |
+| - 李四的智能助手       |     |    |         |    |     | - 腾讯混元            |
+|                     | <===>|   |Routing  |     | <===>| - 通义千问            |
+| [ 团队共享机器人 ]     |     |    |    &    |    |     | - Ollama              |
+| - 营销部智能小助手    |     |    | Adapter |    |     |                       |
+| - 人事部小管家        |     |    |         |    |     | [ 智能体 (Agent) ]    |
+|                     |     |    +---------+    |     | - Dify                |
+| [ 业务面向助手 ]      |     |                   |     | - ADP                 |
+| - IT客服小助手        |     |                   |     | - 等...               |
+| - 报销系统小i         |     |                   |     |                       |
++-----------------------+     +-------------------+     +-----------------------+
+            ^                           ^                           ^
+            |                           |                           |
+      (内部机器人接口)            (独立运行程序)              (外部服务接口)
+
+## 核心能力
+
+| 能力 | 说明 |
+|------|------|
+| **多账号管理** | 支持同时对接多个企微智能机器人和智能体服务 |
+| **多协议适配** | 支持 OpenAI、DeepSeek、Anthropic、Dify、自定义 Webhook 五种适配器 |
+| **思维链展示** | 支持 DeepSeek/Claude 推理模型的 thinking 内容折叠/显示/隐藏 |
+| **多轮对话** | 自动记忆对话历史（可配置轮数） |
+| **媒体处理** | 支持图片/文件的接收和发送 |
+| **模板卡片** | 支持企微模板卡片消息的生成与交互回调 |
+| **访问控制** | 私聊白名单、群组白名单、群内发送者白名单三层策略 |
+
+## 技术特性
+
+- **可插拔适配器架构**：通过 `provider` 配置字段自动路由到对应适配器，新增 AI 平台只需实现一个适配器类
+- **monitor 层统一节流**：替代各适配器的分散节流，在 monitor 层统一控制中间帧发送频率
+- **流式过期降级**：当企微流式消息超过 6 分钟时自动降级为主动发送
+- **LRU + TTL 内存管理**：消息状态、对话历史、ReqId 存储均有容量限制和自动过期清理
+
+
+## 技术栈与依赖
+
+### 语言与运行时
+
+- **语言**：TypeScript 5.x（strict 模式）
+- **运行时**：Node.js（ESM 模块系统）
+- **模块格式**：ESM 优先，同时输出 CJS
+
+### 核心依赖
+
+| 包名 | 版本 | 用途 |
+|------|------|------|
+| `@wecom/aibot-node-sdk` | ^1.0.4 | 企微私有部署 WebSocket 连接、消息收发、认证 |
+| `express` | ^4.21.0 | HTTP 健康检查和状态 API |
+| `file-type` | ^21.3.0 | 通过文件 buffer 嗅探 MIME 类型 |
+
+### 开发依赖
+
+| 包名 | 用途 |
+|------|------|
+| `rollup` + 插件 | 打包构建 |
+| `typescript` | TypeScript 编译 |
+| `rollup-plugin-dts` | 生成 `.d.ts` 类型声明 |
+
+## 整体架构图
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                      @wwlocal/aibot-connector                     │
+│                                                                     │
+│  ┌──────────┐   ┌──────────────┐   ┌─────────────────────────────┐  │
+│  │ index.ts │──→│ ServiceManager│──→│  monitorWeComProvider()     │ │
+│  │ (入口)    │   │ (多账号管理)  │   │  ┌──────────────────────┐    │ │
+│  └──────────┘   └──────────────┘   │  │ WSClient (SDK)       │   │  │
+│       │                             │  │ - 连接管理            │  │  │
+│       │         ┌──────────────┐   │  │ - 消息监听            │   │  │
+│       └────────→│ Express HTTP │   │  │ - 心跳保活            │   │  │
+│                 │ /health      │   │  └──────────┬───────────┘   │ │
+│                 │ /api/status  │   │             │               │ │
+│                 └──────────────┘   │  ┌──────────▼───────────┐   │ │
+│                                     │  │ processWeComMessage()│  │ │
+│                                     │  │ 1. 解析消息内容        │  │ │
+│                                     │  │ 2. 策略检查           │  │ │
+│                                     │  │ 3. 下载媒体           │  │ │
+│                                     │  │ 4. 初始化状态         │  │ │
+│                                     │  │ 5. 转发到智能体       │  │ │
+│                                     │  └──────────┬───────────┘  │ │
+│                                     │             │               │ │
+│                                     │  ┌──────────▼───────────┐  │ │
+│                                     │  │ routeAndDispatchTo   │  │ │
+│                                     │  │ Agent()              │  │ │
+│                                     │  │ - thinking 消息       │  │ │
+│                                     │  │ - deliver 回调       │  │ │
+│                                     │  │ - monitor 层节流     │  │ │
+│                                     │  │ - 流式中间帧         │  │ │
+│                                     │  └──────────┬───────────┘  │ │
+│                                     └─────────────┼───────────────┘ │
+│                                                   │                 │
+│  ┌────────────────────────────────────────────────▼──────────────┐  │
+│  │                     Agent Forwarder                           │  │
+│  │  ┌─────────────────────────────────────────────────────────┐  │  │
+│  │  │              Adapter Registry (适配器注册表)              │  │  │
+│  │  ├──────────┬──────────┬──────────┬─────────┬─────────────┤  │  │
+│  │  │ OpenAI   │ DeepSeek │Anthropic │  Dify   │  Webhook    │  │  │
+│  │  │ Adapter  │ Adapter  │ Adapter  │ Adapter │  Adapter    │  │  │
+│  │  └──────────┴──────────┴──────────┴─────────┴─────────────┘  │  │
+│  └──────────────────────────────────────────────────────────────┘  │
+│                                                                     │
+│                                   │                                 │
+│                                   ▼                                 │
+│                        ┌─────────────────┐                         │
+│                        │ 第三方 AI 平台   │                         │
+│                        │ (OpenAI/DS/...)  │                         │
+│                        └─────────────────┘                         │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+
+## 安装
+
+```bash
+# 全局安装
+npm install -g @wwlocal/aibot-connector
+# 会安装到：
+# /usr/local/lib/node_modules/@wwlocal/aibot-connector
+
+# 在项目目录中安装
+# 1. 创建项目目录
+mkdir ~/my-wecom-bot
+cd ~/my-wecom-bot
+# 2. 初始化 package.json
+npm init -y
+# 3. 安装依赖（会自动写入 package.json）
+npm install @wwlocal/aibot-connector
+# 包在 ~/my-wecom-bot/node_modules/ 下
+
+# 检查安装
+npm list @wwlocal/aibot-connector
+npm list @wecom/aibot-node-sdk
+
+```
+
+## 配置
+
+复制示例配置文件并修改：
+
+```bash
+cp config.example.json config.json
+```
+
+### 配置说明
+
+```jsonc
+{
+  // HTTP 服务端口（默认 3000）
+  "port": 3000,
+  
+  // 数据存储目录（媒体文件等）
+  "dataDir": "./data",
+  
+  // 智能体端点列表
+  "agents": [
+    {
+      "name": "default",                                    // 端点名称
+      "provider": "openai",                                 // 适配器类型：openai / deepseek / anthropic / dify / webhook（默认 openai）
+      "url": "https://api.openai.com/v1/chat/completions", // API URL
+      "apiKey": "sk-xxx",                                   // API Key
+      "model": "gpt-4o",                                    // 模型名称
+      "stream": true,                                       // 启用流式（默认 true）
+      "systemPrompt": "你是一个有用的助手",                   // 系统提示词
+      "timeoutMs": 300000,                                   // 请求超时（默认 5 分钟）
+      "maxHistoryRounds": 20,                                // 多轮对话最大保留轮数（0=禁用，默认 20）
+      "headers": {},                                         // 自定义请求头（可选）
+      "providerOptions": {}                                  // 适配器专属配置（可选，见下方各适配器说明）
+    }
+  ],
+  
+  // 企微账号列表
+  "accounts": [
+    {
+      "accountId": "bot-1",           // 账号标识
+      "name": "测试机器人",            // 显示名称
+      "enabled": true,                // 是否启用（默认 true）
+      "websocketUrl": "wss://...",    // WebSocket 连接地址
+      "botId": "xxx",                 // 机器人 ID
+      "secret": "xxx",                // 机器人密钥
+      "caCert": "cert.pem",           // CA 证书文件名（可选）
+      "sendThinkingMessage": true,    // 是否发送"正在思考…"提示（默认 true）
+      
+      // 访问控制
+      "dmPolicy": "open",             // 私聊策略：open/allowlist/disabled
+      "allowFrom": [],                // 私聊白名单 userid 列表
+      "groupPolicy": "open",          // 群组策略：open/allowlist/disabled
+      "groupAllowFrom": [],           // 群组白名单 chatid 列表
+      "groups": {},                   // 群聊专属配置（可为不同群指定不同的 agent）
+      
+      // 媒体与智能体
+      "mediaLocalRoots": [],          // 本地媒体文件搜索路径
+      "agentName": "default"          // 使用的智能体端点名称
+    }
+  ]
+}
+```
+
+## 启动
+
+```bash
+# 使用默认配置文件（./config.json）
+npm start
+
+# 指定配置文件
+npm start -- /path/to/config.json
+
+# 通过环境变量指定
+AIBOT_CONFIG=/path/to/config.json npm start
+```
+
+## API 接口
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | `/health` | 健康检查 |
+| GET | `/api/status` | 服务状态（各账号连接状态） |
+| POST | `/callback` | 模板卡片事件回调（预留） |
+
+### 健康检查
+
+```bash
+curl http://localhost:3000/health
+```
+
+```json
+{
+  "status": "ok",
+  "version": "1.0.0",
+  "uptime": 123.456,
+  "timestamp": 1712000000000
+}
+```
+
+### 服务状态
+
+```bash
+curl http://localhost:3000/api/status
+```
+
+```json
+{
+  "version": "1.0.0",
+  "accounts": [
+    {
+      "accountId": "bot-1",
+      "name": "测试机器人",
+      "running": true,
+      "lastConnectedAt": 1712000000000
+    }
+  ],
+  "timestamp": 1712000000000
+}
+```
+
+## 对接第三方智能体
+
+插件内置多种适配器，通过 `provider` 字段选择。OpenAI 适配器同时兼容所有 OpenAI API 兼容服务。
+
+### OpenAI（默认）
+
+兼容所有 OpenAI Chat Completions API 的服务（包括 Azure OpenAI、Ollama、vLLM 等）。
+
+```json
+{
+  "name": "openai",
+  "provider": "openai",
+  "url": "https://api.openai.com/v1/chat/completions",
+  "apiKey": "sk-xxx",
+  "model": "gpt-4o"
+}
+```
+
+### Azure OpenAI
+
+```json
+{
+  "name": "azure",
+  "provider": "openai",
+  "url": "https://your-resource.openai.azure.com/openai/deployments/gpt-4o/chat/completions?api-version=2024-08-01-preview",
+  "headers": {
+    "api-key": "your-azure-key"
+  }
+}
+```
+
+### DeepSeek
+
+支持普通对话模型和推理模型（思维链）。
+
+```json
+{
+  "name": "deepseek-chat",
+  "provider": "deepseek",
+  "url": "https://api.deepseek.com/chat/completions",
+  "apiKey": "sk-xxx",
+  "model": "deepseek-chat"
+}
+```
+
+推理模型示例（带思维链展示）：
+
+```json
+{
+  "name": "deepseek-reasoner",
+  "provider": "deepseek",
+  "url": "https://api.deepseek.com/chat/completions",
+  "apiKey": "sk-xxx",
+  "model": "deepseek-reasoner",
+  "providerOptions": {
+    "reasoningDisplay": "collapse"
+  }
+}
+```
+
+### Anthropic Claude
+
+支持 Anthropic 原生 Messages API，以及第三方兼容平台（如 MiniMax）。
+
+```json
+{
+  "name": "claude-sonnet",
+  "provider": "anthropic",
+  "url": "https://api.anthropic.com/v1/messages",
+  "apiKey": "sk-ant-xxx",
+  "model": "claude-sonnet-4-20250514",
+  "providerOptions": {
+    "maxTokens": 8192,
+    "reasoningDisplay": "collapse",
+    "useXApiKey": true,
+    "anthropicVersion": "2023-06-01"
+  }
+}
+```
+
+第三方兼容平台示例（MiniMax）：
+
+```json
+{
+  "name": "minimax-anthropic",
+  "provider": "anthropic",
+  "url": "https://api.minimaxi.com/anthropic",
+  "apiKey": "your-minimax-key",
+  "model": "MiniMax-M2.7",
+  "providerOptions": {
+    "maxTokens": 4096,
+    "useXApiKey": false
+  }
+}
+```
+
+### Dify
+
+对接 Dify Chatflow 应用。
+
+```json
+{
+  "name": "dify-assistant",
+  "provider": "dify",
+  "url": "https://api.dify.ai/v1/chat-messages",
+  "apiKey": "app-your-dify-app-key",
+  "providerOptions": {
+    "difyAppType": "chat",
+    "difyInputs": {
+      "language": "zh-CN"
+    }
+  }
+}
+```
+
+### 自定义 Webhook
+
+通过模板映射对接任意 HTTP API，无需写代码。
+
+```json
+{
+  "name": "custom-webhook",
+  "provider": "webhook",
+  "url": "https://your-internal-api.example.com/chat",
+  "headers": {
+    "X-API-Token": "your-internal-token"
+  },
+  "providerOptions": {
+    "requestTemplate": {
+      "message": "{{text}}",
+      "userId": "{{user}}",
+      "source": "wecom"
+    },
+    "responseTextField": "data.reply.content"
+  }
+}
+```
+
+### 本地模型（Ollama）
+
+```json
+{
+  "name": "ollama",
+  "provider": "openai",
+  "url": "http://localhost:11434/v1/chat/completions",
+  "model": "llama3"
+}
+```
+
+### providerOptions 参考
+
+| 适配器 | 选项 | 说明 |
+|--------|------|------|
+| deepseek | `reasoningDisplay` | 思维链展示模式：`show` / `hide` / `collapse`（默认） |
+| anthropic | `maxTokens` | Anthropic API 必传的 max_tokens（默认 4096） |
+| anthropic | `reasoningDisplay` | 思维链展示模式：`show` / `hide` / `collapse` |
+| anthropic | `useXApiKey` | 是否使用 `x-api-key` 头认证（默认 true）。第三方平台设为 false |
+| anthropic | `anthropicVersion` | API 版本头（默认 `2023-06-01`） |
+| dify | `difyAppType` | Dify 应用类型：`chat` |
+| dify | `difyInputs` | 传递给 Dify 工作流的自定义变量 |
+| webhook | `requestTemplate` | 请求体模板，支持 `{{text}}`、`{{user}}`、`{{chatId}}` 变量 |
+| webhook | `responseTextField` | 响应 JSON 中提取回复文本的字段路径（支持嵌套，如 `data.reply.content`） |
+
+## 项目结构
+
+```
+aibot-plugin/
+├── index.ts                  # 服务入口
+├── config.example.json       # 配置示例
+├── package.json
+├── tsconfig.json
+├── rollup.config.mjs
+├── src/
+│   ├── config.ts                  # 配置加载与校验
+│   ├── server.ts                  # Express HTTP 服务
+│   ├── service-manager.ts         # 服务生命周期管理
+│   ├── monitor.ts                 # 核心消息处理引擎
+│   ├── agent-forwarder.ts         # 智能体转发器（适配器调度层）
+│   ├── conversation-manager.ts    # 多轮对话历史管理（内存缓存、TTL、LRU）
+│   ├── message-parser.ts          # 消息解析
+│   ├── message-sender.ts          # 消息发送
+│   ├── template-card-parser.ts    # 模板卡片解析
+│   ├── media-handler.ts           # 入站媒体下载
+│   ├── media-uploader.ts          # 出站媒体上传
+│   ├── media-storage.ts           # 本地媒体存储
+│   ├── media-loader.ts            # 出站媒体加载
+│   ├── dm-policy.ts               # 私聊访问控制
+│   ├── group-policy.ts            # 群组访问控制
+│   ├── ca-cert.ts                 # CA 证书注入
+│   ├── state-manager.ts           # 状态管理
+│   ├── reqid-store.ts             # ReqId 存储
+│   ├── interface.ts               # 类型定义
+│   ├── const.ts                   # 常量定义
+│   ├── timeout.ts                 # 超时工具
+│   ├── version.ts                 # 版本信息
+│   └── adapters/                  # 适配器模块
+│       ├── index.ts               # 适配器注册与解析
+│       ├── types.ts               # 适配器公共类型
+│       ├── base-adapter.ts        # 基础适配器（OpenAI 兼容）
+│       ├── openai-adapter.ts      # OpenAI 适配器
+│       ├── deepseek-adapter.ts    # DeepSeek 适配器（支持思维链）
+│       ├── anthropic-adapter.ts   # Anthropic Claude 适配器（原生 API）
+│       ├── dify-adapter.ts        # Dify 适配器
+│       └── webhook-adapter.ts     # 自定义 Webhook 适配器
+```

package/config.example.json

@@ -0,0 +1,169 @@
+{
+  "_comment_port": "HTTP 服务监听端口，用于健康检查 (/health) 和状态查询 (/api/status)，不影响消息收发",
+  "port": 3000,
+
+  "_comment_dataDir": "数据存储目录，用于缓存文件等",
+  "dataDir": "./data",
+
+  "_comment_agents": "智能体端点列表。每个端点定义一个 AI 后端的连接方式。accounts 通过 agentName 引用这里的 name",
+  "agents": [
+    {
+      "_comment": "========== OpenAI 适配器示例 ==========",
+      "name": "openai-gpt4o",
+      "_comment_provider": "适配器类型：openai / deepseek / anthropic / dify / webhook。不配置时默认为 openai",
+      "provider": "openai",
+      "_comment_url": "API 地址。OpenAI 兼容接口（如 Ollama、vLLM、Azure OpenAI）均可使用 openai 适配器",
+      "url": "https://api.openai.com/v1/chat/completions",
+      "apiKey": "sk-your-api-key-here",
+      "_comment_model": "模型名称，取决于你的 API 提供商支持的模型",
+      "model": "gpt-4o",
+      "_comment_stream": "是否启用流式响应（SSE），默认 true。流式可实现打字机效果，逐步推送回复",
+      "stream": true,
+      "_comment_systemPrompt": "系统提示词，设定 AI 的角色和行为",
+      "systemPrompt": "你是一个企业微信智能助手。",
+      "_comment_timeoutMs": "请求超时时间（毫秒），默认 300000（5分钟）",
+      "timeoutMs": 300000,
+      "_comment_maxHistoryRounds": "多轮对话最大保留轮数。默认 20 轮（即 AI 能记住最近 20 轮对话）。设为 0 可禁用对话记忆（每次对话都是全新的）",
+      "maxHistoryRounds": 20,
+      "_comment_headers": "自定义请求头，如需额外认证头可在此添加",
+      "headers": {}
+    },
+    {
+      "_comment": "========== DeepSeek Chat 示例（普通对话模型，无思维链） ==========",
+      "name": "deepseek-chat",
+      "provider": "deepseek",
+      "url": "https://api.deepseek.com/chat/completions",
+      "apiKey": "sk-your-deepseek-key",
+      "model": "deepseek-chat",
+      "stream": true,
+      "systemPrompt": "你是一个企业微信智能助手。"
+    },
+    {
+      "_comment": "========== DeepSeek Reasoner 示例（推理模型，有思维链） ==========",
+      "name": "deepseek-reasoner",
+      "provider": "deepseek",
+      "url": "https://api.deepseek.com/chat/completions",
+      "apiKey": "sk-your-deepseek-key",
+      "_comment_model": "deepseek-reasoner 为推理模型，会返回 reasoning_content（思维链内容）",
+      "model": "deepseek-reasoner",
+      "stream": true,
+      "_comment_providerOptions": "适配器专属配置，不同 provider 有不同的可选项",
+      "providerOptions": {
+        "_comment_reasoningDisplay": "推理思维链的展示模式（仅 deepseek 适配器有效）：hide = 完全隐藏推理过程，只显示最终回答；collapse = 用 <think>...</think> 标签折叠展示；show = 完整展示推理过程和回答",
+        "reasoningDisplay": "collapse"
+      }
+    },
+    {
+      "_comment": "========== Anthropic Claude 示例（原生 API） ==========",
+      "name": "claude-sonnet",
+      "provider": "anthropic",
+      "_comment_url": "Anthropic 原生 Messages API 地址",
+      "url": "https://api.anthropic.com/v1/messages",
+      "apiKey": "sk-ant-your-anthropic-key",
+      "_comment_model": "Claude 模型名称",
+      "model": "claude-sonnet-4-20250514",
+      "stream": true,
+      "systemPrompt": "你是一个企业微信智能助手。",
+      "_comment_providerOptions": "Anthropic 适配器专属配置",
+      "providerOptions": {
+        "_comment_maxTokens": "Anthropic API 要求必传的 max_tokens，默认 4096",
+        "maxTokens": 8192,
+        "_comment_reasoningDisplay": "思维链展示模式（仅 Claude 推理模型有效）：hide / collapse / show",
+        "reasoningDisplay": "collapse",
+        "_comment_useXApiKey": "是否使用 x-api-key 头认证（默认 true）。Anthropic 原生 API 用 true，第三方兼容平台（如百炼、MiniMax）设为 false",
+        "useXApiKey": true,
+        "_comment_anthropicVersion": "Anthropic API 版本头，默认 2023-06-01",
+        "anthropicVersion": "2023-06-01"
+      }
+    },
+    {
+      "_comment": "========== MiniMax Anthropic 兼容 API 示例 ==========",
+      "name": "minimax-anthropic",
+      "provider": "anthropic",
+      "_comment_url": "MiniMax 的 Anthropic 兼容接口地址",
+      "url": "https://api.minimaxi.com/anthropic",
+      "apiKey": "your-minimax-key",
+      "model": "MiniMax-M2.7",
+      "stream": true,
+      "providerOptions": {
+        "maxTokens": 4096,
+        "_comment_useXApiKey": "MiniMax 使用 Bearer Token 认证，设为 false",
+        "useXApiKey": false
+      }
+    },
+    {
+      "_comment": "========== Dify 适配器示例 ==========",
+      "name": "dify-assistant",
+      "provider": "dify",
+      "_comment_url": "Dify Chat 应用的 API 地址",
+      "url": "https://api.dify.ai/v1/chat-messages",
+      "_comment_apiKey": "Dify 应用的 API Key，以 app- 开头",
+      "apiKey": "app-your-dify-app-key",
+      "stream": true,
+      "providerOptions": {
+        "_comment_difyAppType": "Dify 应用类型：chat（对话型，支持会话管理）",
+        "difyAppType": "chat",
+        "_comment_difyInputs": "传递给 Dify 工作流的自定义变量",
+        "difyInputs": {
+          "language": "zh-CN"
+        }
+      }
+    },
+    {
+      "_comment": "========== 自定义 Webhook 适配器示例 ==========",
+      "name": "custom-webhook",
+      "_comment_provider": "webhook 适配器：通过模板映射对接任意 HTTP API，无需写代码",
+      "provider": "webhook",
+      "url": "https://your-internal-api.example.com/chat",
+      "headers": {
+        "X-API-Token": "your-internal-token"
+      },
+      "providerOptions": {
+        "_comment_requestTemplate": "请求体模板，支持变量替换：{{text}} = 消息文本，{{user}} = 用户ID，{{chatId}} = 聊天ID",
+        "requestTemplate": {
+          "message": "{{text}}",
+          "userId": "{{user}}",
+          "source": "wecom"
+        },
+        "_comment_responseTextField": "从响应 JSON 中提取回复文本的字段路径，支持嵌套（如 data.reply.content）",
+        "responseTextField": "data.reply.content"
+      }
+    }
+  ],
+
+  "_comment_accounts": "企微账号列表。支持多个，每个账号对应一个企微机器人的 WebSocket 连接",
+  "accounts": [
+    {
+      "_comment_accountId": "账号唯一标识，用于日志和状态查询",
+      "accountId": "bot-1",
+      "_comment_name": "账号显示名称，仅用于日志展示",
+      "name": "我的机器人",
+      "_comment_enabled": "是否启用此账号，设为 false 可临时禁用而无需删除配置",
+      "enabled": true,
+      "_comment_websocketUrl": "企微机器人 WebSocket 服务地址",
+      "websocketUrl": "ws://your-wecom-server:11712",
+      "_comment_botId": "企微机器人 ID",
+      "botId": "your-bot-id",
+      "_comment_secret": "企微机器人密钥",
+      "secret": "your-bot-secret",
+      "_comment_caCert": "CA 证书路径（可选），用于自签名 HTTPS/WSS 证书",
+      "caCert": "",
+      "_comment_sendThinkingMessage": "收到用户消息后是否先发送一条「正在思考…」提示消息。注意：这与 DeepSeek 的推理思维链（reasoningDisplay）是两个独立的功能",
+      "sendThinkingMessage": true,
+      "_comment_dmPolicy": "私聊策略：open = 接受所有人，whitelist = 仅允许 allowFrom 列表中的用户",
+      "dmPolicy": "open",
+      "_comment_allowFrom": "私聊白名单（仅 dmPolicy 为 whitelist 时生效），填入企微用户 ID",
+      "allowFrom": [],
+      "_comment_groupPolicy": "群聊策略：open = 接受所有群，whitelist = 仅允许 groupAllowFrom 列表中的群",
+      "groupPolicy": "open",
+      "_comment_groupAllowFrom": "群聊白名单（仅 groupPolicy 为 whitelist 时生效），填入群聊 ID",
+      "groupAllowFrom": [],
+      "_comment_groups": "群聊专属配置（可为不同群指定不同的 agent），key 为群聊 ID",
+      "groups": {},
+      "_comment_mediaLocalRoots": "本地媒体文件搜索路径（用于发送本地图片等）",
+      "mediaLocalRoots": [],
+      "_comment_agentName": "该账号使用的智能体端点名称，必须对应 agents 列表中某个 name",
+      "agentName": "openai-gpt4o"
+    }
+  ]
+}