docs(dingtalk): update documentation with new features

- Add proactive_send configuration option
- Add group_trigger configuration documentation
- Document health monitoring and auto-recovery mechanism
- Add structured logging examples
- Add environment variables reference table

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

docs/channels/dingtalk/README.zh.md

@@ -11,23 +11,83 @@
       "enabled": true,
       "client_id": "YOUR_CLIENT_ID",
       "client_secret": "YOUR_CLIENT_SECRET",
-      "allow_from": []
+      "allow_from": [],
+      "proactive_send": false,
+      "group_trigger": {
+        "mention_only": false,
+        "prefixes": []
+      },
+      "reasoning_channel_id": ""
     }
   }
 }
 ```
 
 | 字段                | 类型   | 必填 | 描述                                         |
-| ------------- | ------ | ---- | -------------------------------- |
+| ------------------- | ------ | ---- | -------------------------------------------- |
 | enabled             | bool   | 是   | 是否启用钉钉频道                             |
 | client_id           | string | 是   | 钉钉应用的 Client ID                         |
 | client_secret       | string | 是   | 钉钉应用的 Client Secret                     |
 | allow_from          | array  | 否   | 用户ID白名单，空表示允许所有用户             |
+| proactive_send      | bool   | 否   | 是否启用主动消息发送（通过机器人API）        |
+| group_trigger       | object | 否   | 群聊触发配置                                 |
+| reasoning_channel_id| string | 否   | 推理消息发送的目标频道ID                     |
+
+### 群聊触发配置
+
+| 字段        | 类型     | 描述                                       |
+| ----------- | -------- | ------------------------------------------ |
+| mention_only| bool     | 是否仅在@提及时响应                        |
+| prefixes    | []string | 触发前缀列表，如 `["/ai", "机器人"]`       |
+
+## 功能特性
+
+### 健康监控与自动恢复
+
+钉钉频道内置了连接健康监控机制，确保流式连接的稳定性：
+
+- **定期健康检查**：每 5 分钟检查一次连接状态
+- **自动恢复**：当连接超过 30 分钟未收到消息时，自动触发重连
+- **重试机制**：恢复失败时每 30 秒重试一次，直到成功
+
+### 主动消息发送
+
+启用 `proactive_send` 后，机器人可以主动向用户或群组发送消息：
+
+- **智能路由**：优先使用会话 webhook 发送，失效时自动切换到机器人 API
+- **Token 自动刷新**：每 5 分钟自动刷新访问令牌，确保 API 可用性
+- **支持场景**：
+  - 单聊消息：通过 `oToMessages/batchSend` API
+  - 群聊消息：通过 `groupMessages/send` API
+
+### 结构化日志
+
+所有钉钉相关的日志均采用结构化格式输出，便于调试和监控：
+
+```log
+INFO  dingtalk: DingTalk channel started {"proactive_send": true}
+DEBUG dingtalk: Received message {"sender_nick": "张三", "sender_id": "user123", "preview": "你好"}
+INFO  dingtalk: Connection recovered successfully {}
+```
 
 ## 设置流程
 
 1. 前往 [钉钉开放平台](https://open.dingtalk.com/)
 2. 创建一个企业内部应用
 3. 从应用设置中获取 Client ID 和 Client Secret
-4. 配置OAuth和事件订阅(如需要)
+4. 配置 OAuth 和事件订阅（如需要）
 5. 将 Client ID 和 Client Secret 填入配置文件中
+6. 如需主动消息功能，设置 `proactive_send: true`
+
+## 环境变量
+
+所有配置项均可通过环境变量设置：
+
+| 环境变量                                      | 对应配置项              |
+| --------------------------------------------- | ----------------------- |
+| PICOCLAW_CHANNELS_DINGTALK_ENABLED            | enabled                 |
+| PICOCLAW_CHANNELS_DINGTALK_CLIENT_ID          | client_id               |
+| PICOCLAW_CHANNELS_DINGTALK_CLIENT_SECRET      | client_secret           |
+| PICOCLAW_CHANNELS_DINGTALK_ALLOW_FROM         | allow_from              |
+| PICOCLAW_CHANNELS_DINGTALK_PROACTIVE_SEND     | proactive_send          |
+| PICOCLAW_CHANNELS_DINGTALK_REASONING_CHANNEL_ID| reasoning_channel_id   |