better-dsh 0.2.4 → 0.2.5

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/git-worktrees.md

@@ -0,0 +1,173 @@
+---
+sidebar_position: 3
+sidebar_label: "Git Worktrees"
+title: "Git Worktrees"
+description: "使用 git worktrees 和隔离检出在同一仓库中安全运行多个 Hermes agent"
+---
+
+# Git Worktrees
+
+Hermes Agent 常用于大型、长期维护的仓库。当你需要：
+
+- 在同一项目中**并行运行多个 agent**，或
+- 将实验性重构与主分支隔离，
+
+Git **worktrees** 是为每个 agent 提供独立检出（checkout）而无需复制整个仓库的最安全方式。
+
+本页介绍如何将 worktrees 与 Hermes 结合使用，使每个会话拥有干净、隔离的工作目录。
+
+## 为什么在 Hermes 中使用 Worktrees？
+
+Hermes 将**当前工作目录**视为项目根目录：
+
+- CLI：运行 `hermes` 或 `hermes chat` 时所在的目录
+- Messaging gateway：由 `MESSAGING_CWD` 设置的目录
+
+如果在**同一检出**中运行多个 agent，它们的变更可能相互干扰：
+
+- 一个 agent 可能删除或覆盖另一个正在使用的文件。
+- 难以区分哪些变更属于哪个实验。
+
+使用 worktrees 后，每个 agent 拥有：
+
+- **独立的分支和工作目录**
+- **独立的 Checkpoint Manager 历史**，用于 `/rollback`
+
+另请参阅：[Checkpoints 与 /rollback](./checkpoints-and-rollback.md)。
+
+## 快速开始：创建 Worktree
+
+在主仓库（包含 `.git/` 的目录）中，为功能分支创建新的 worktree：
+
+```bash
+# 从主仓库根目录
+cd /path/to/your/repo
+
+# 在 ../repo-feature 中创建新分支和 worktree
+git worktree add ../repo-feature feature/hermes-experiment
+```
+
+这将创建：
+
+- 新目录：`../repo-feature`
+- 新分支：`feature/hermes-experiment`，已在该目录中检出
+
+现在可以 `cd` 进入新 worktree 并在其中运行 Hermes：
+
+```bash
+cd ../repo-feature
+
+# 在 worktree 中启动 Hermes
+hermes
+```
+
+Hermes 将：
+
+- 将 `../repo-feature` 视为项目根目录。
+- 使用该目录进行上下文文件读取、代码编辑和工具调用。
+- 使用**独立的 checkpoint 历史**，`/rollback` 的作用范围限定在此 worktree。
+
+## 并行运行多个 Agent
+
+可以创建多个 worktree，每个对应独立的分支：
+
+```bash
+cd /path/to/your/repo
+
+git worktree add ../repo-experiment-a feature/hermes-a
+git worktree add ../repo-experiment-b feature/hermes-b
+```
+
+在不同终端中分别运行：
+
+```bash
+# 终端 1
+cd ../repo-experiment-a
+hermes
+
+# 终端 2
+cd ../repo-experiment-b
+hermes
+```
+
+每个 Hermes 进程：
+
+- 在各自的分支上工作（`feature/hermes-a` 与 `feature/hermes-b`）。
+- 在不同的 shadow repo 哈希下写入 checkpoint（由 worktree 路径派生）。
+- 可独立使用 `/rollback`，互不影响。
+
+以下场景尤为适用：
+
+- 批量重构。
+- 对同一任务尝试不同方案。
+- 将 CLI 与 gateway 会话配对，针对同一上游仓库运行。
+
+## 安全清理 Worktrees
+
+实验完成后：
+
+1. 决定是否保留该工作成果。
+2. 如需保留：
+   - 按常规方式将分支合并到主分支。
+3. 移除 worktree：
+
+```bash
+cd /path/to/your/repo
+
+# 移除 worktree 目录及其引用
+git worktree remove ../repo-feature
+```
+
+注意事项：
+
+- `git worktree remove` 在 worktree 存在未提交变更时会拒绝移除，除非强制执行。
+- 移除 worktree **不会**自动删除分支；可使用常规 `git branch` 命令决定是否删除分支。
+- `~/.hermes/checkpoints/` 下的 Hermes checkpoint 数据在移除 worktree 时不会自动清理，但通常体积很小。
+
+## 最佳实践
+
+- **每个 Hermes 实验对应一个 worktree**
+  - 为每项重要变更创建专用的分支/worktree。
+  - 这样可保持 diff 聚焦，PR 小而易于审查。
+- **以实验内容命名分支**
+  - 例如：`feature/hermes-checkpoints-docs`、`feature/hermes-refactor-tests`。
+- **频繁提交**
+  - 使用 git commit 记录高层级里程碑。
+  - 使用 [checkpoints 与 /rollback](./checkpoints-and-rollback.md) 作为工具驱动编辑之间的安全网。
+- **使用 worktrees 时避免从裸仓库根目录运行 Hermes**
+  - 优先使用 worktree 目录，使每个 agent 拥有明确的作用范围。
+
+## 使用 `hermes -w`（自动 Worktree 模式）
+
+Hermes 内置 `-w` 标志，可**自动创建一个一次性 git worktree** 及其独立分支。无需手动配置 worktree——只需 `cd` 进入仓库并运行：
+
+```bash
+cd /path/to/your/repo
+hermes -w
+```
+
+Hermes 将：
+
+- 在仓库内的 `.worktrees/` 下创建临时 worktree。
+- 检出一个隔离分支（例如 `hermes/hermes-<hash>`）。
+- 在该 worktree 内运行完整的 CLI 会话。
+
+这是获得 worktree 隔离的最简便方式。也可与单次查询结合使用：
+
+```bash
+hermes -w -z "Fix issue #123"
+```
+
+如需并行运行多个 agent，在多个终端中分别运行 `hermes -w`——每次调用都会自动获得独立的 worktree 和分支。
+
+## 综合运用
+
+- 使用 **git worktrees** 为每个 Hermes 会话提供独立的干净检出。
+- 使用**分支**记录实验的高层级历史。
+- 使用 **checkpoints + `/rollback`** 在每个 worktree 内从错误中恢复。
+
+这种组合带来：
+
+- 强有力的保证，确保不同 agent 和实验互不干扰。
+- 快速迭代周期，轻松从错误编辑中恢复。
+- 干净、易于审查的 pull request。

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/bluebubbles.md

@@ -0,0 +1,143 @@
+# BlueBubbles（iMessage）
+
+通过 [BlueBubbles](https://bluebubbles.app/) 将 Hermes 连接至 Apple iMessage——这是一款免费、开源的 macOS 服务端，可将 iMessage 桥接至任意设备。
+
+## 前提条件
+
+- 一台**始终开机的 Mac**，运行 [BlueBubbles Server](https://bluebubbles.app/)
+- 该 Mac 上的 Messages.app 已登录 Apple ID
+- BlueBubbles Server v1.0.0+（webhook 需要此版本）
+- Hermes 与 BlueBubbles 服务端之间的网络连通性
+
+## 配置步骤
+
+### 1. 安装 BlueBubbles Server
+
+从 [bluebubbles.app](https://bluebubbles.app/) 下载并安装。完成设置向导——使用 Apple ID 登录，并配置连接方式（本地网络、Ngrok、Cloudflare 或动态 DNS）。
+
+### 2. 获取服务端 URL 和密码
+
+在 BlueBubbles Server → **Settings → API** 中，记录：
+- **Server URL**（例如 `http://192.168.1.10:1234`）
+- **Server Password**
+
+### 3. 配置 Hermes
+
+运行设置向导：
+
+```bash
+hermes gateway setup
+```
+
+选择 **BlueBubbles (iMessage)** 并输入服务端 URL 和密码。
+
+或直接在 `~/.hermes/.env` 中设置环境变量：
+
+```bash
+BLUEBUBBLES_SERVER_URL=http://192.168.1.10:1234
+BLUEBUBBLES_PASSWORD=your-server-password
+```
+
+### 4. 授权用户
+
+选择以下任一方式：
+
+**DM 配对（推荐）：**
+当有人向你的 iMessage 发送消息时，Hermes 会自动向其发送配对码。使用以下命令批准：
+```bash
+hermes pairing approve bluebubbles <CODE>
+```
+使用 `hermes pairing list` 查看待处理的配对码和已授权用户。
+
+**预授权特定用户**（在 `~/.hermes/.env` 中）：
+```bash
+BLUEBUBBLES_ALLOWED_USERS=user@icloud.com,+15551234567
+```
+
+**开放访问**（在 `~/.hermes/.env` 中）：
+```bash
+BLUEBUBBLES_ALLOW_ALL_USERS=true
+```
+
+### 5. 启动 Gateway
+
+```bash
+hermes gateway run
+```
+
+Hermes 将连接至你的 BlueBubbles 服务端，注册 webhook，并开始监听 iMessage 消息。
+
+## 工作原理
+
+```
+iMessage → Messages.app → BlueBubbles Server → Webhook → Hermes
+Hermes → BlueBubbles REST API → Messages.app → iMessage
+```
+
+- **入站：** 新消息到达时，BlueBubbles 向本地监听器发送 webhook 事件。无需轮询——即时送达。
+- **出站：** Hermes 通过 BlueBubbles REST API 发送消息。
+- **媒体：** 双向支持图片、语音消息、视频和文档。入站附件会被下载并在本地缓存，供 Agent 处理。
+
+## 环境变量
+
+| 变量 | 必填 | 默认值 | 说明 |
+|----------|----------|---------|-------------|
+| `BLUEBUBBLES_SERVER_URL` | 是 | — | BlueBubbles 服务端 URL |
+| `BLUEBUBBLES_PASSWORD` | 是 | — | 服务端密码 |
+| `BLUEBUBBLES_WEBHOOK_HOST` | 否 | `127.0.0.1` | Webhook 监听器绑定地址 |
+| `BLUEBUBBLES_WEBHOOK_PORT` | 否 | `8645` | Webhook 监听器端口 |
+| `BLUEBUBBLES_WEBHOOK_PATH` | 否 | `/bluebubbles-webhook` | Webhook URL 路径 |
+| `BLUEBUBBLES_HOME_CHANNEL` | 否 | — | cron 投递使用的手机号/邮箱 |
+| `BLUEBUBBLES_ALLOWED_USERS` | 否 | — | 逗号分隔的授权用户列表 |
+| `BLUEBUBBLES_ALLOW_ALL_USERS` | 否 | `false` | 允许所有用户 |
+
+自动将消息标记为已读由 `~/.hermes/config.yaml` 中 `platforms.bluebubbles.extra` 下的 `send_read_receipts` 键控制（默认值：`true`）。该选项没有对应的环境变量。
+
+## 功能特性
+
+### 文字消息
+发送和接收 iMessage。Markdown 会自动去除，以确保纯文本的整洁呈现。
+
+### 富媒体
+- **图片：** 照片在 iMessage 对话中原生显示
+- **语音消息：** 音频文件以 iMessage 语音消息形式发送
+- **视频：** 视频附件
+- **文档：** 文件以 iMessage 附件形式发送
+
+### Tapback 反应
+支持喜爱、点赞、踩、大笑、强调和疑问等反应。需要 BlueBubbles [Private API helper](https://docs.bluebubbles.app/helper-bundle/installation)。
+
+### 正在输入指示器
+Agent 处理消息期间，iMessage 对话中会显示"正在输入……"。需要 Private API。
+
+### 已读回执
+处理消息后自动标记为已读。需要 Private API。
+
+### 聊天寻址
+你可以通过邮箱或手机号寻址聊天——Hermes 会自动将其解析为 BlueBubbles 聊天 GUID，无需使用原始 GUID 格式。
+
+## Private API
+
+部分功能需要 BlueBubbles [Private API helper](https://docs.bluebubbles.app/helper-bundle/installation)：
+- Tapback 反应
+- 正在输入指示器
+- 已读回执
+- 通过地址创建新聊天
+
+不使用 Private API 时，基本文字消息和媒体功能仍可正常使用。
+
+## 故障排查
+
+### "Cannot reach server"
+- 确认服务端 URL 正确且 Mac 已开机
+- 检查 BlueBubbles Server 是否正在运行
+- 确保网络连通（防火墙、端口转发）
+
+### 消息未送达
+- 检查 webhook 是否已在 BlueBubbles Server → Settings → API → Webhooks 中注册
+- 确认 webhook URL 可从 Mac 访问
+- 查看 `hermes logs gateway` 中的 webhook 错误（或使用 `hermes logs -f` 实时跟踪）
+
+### "Private API helper not connected"
+- 安装 Private API helper：[docs.bluebubbles.app](https://docs.bluebubbles.app/helper-bundle/installation)
+- 不安装也可使用基本消息功能——仅反应、正在输入和已读回执需要它

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/dingtalk.md

@@ -0,0 +1,283 @@
+---
+sidebar_position: 10
+title: "DingTalk"
+description: "将 Hermes Agent 设置为钉钉聊天机器人"
+---
+
+# 钉钉设置
+
+Hermes Agent 可作为聊天机器人集成到钉钉（DingTalk），让你通过单聊或群聊与 AI 助手对话。机器人通过钉钉的 Stream Mode（流模式）连接——一种长连接 WebSocket，无需公网 URL 或 webhook 服务器——并通过钉钉的 session webhook API 以 markdown 格式回复消息。
+
+在开始设置之前，先了解大多数人最关心的内容：Hermes 进入你的钉钉工作空间后的行为方式。
+
+## Hermes 的行为方式
+
+| 场景 | 行为 |
+|---------|----------|
+| **单聊（1:1 对话）** | Hermes 响应每条消息，无需 `@提及`，每个单聊有独立会话。 |
+| **群聊** | Hermes 仅在被 `@提及` 时响应，未被提及则忽略消息。 |
+| **多用户共享群聊** | 默认情况下，Hermes 在群内按用户隔离会话历史。同一群中的两个用户不共享同一对话记录，除非你明确禁用该功能。 |
+
+### 钉钉中的会话模型
+
+默认情况下：
+
+- 每个单聊有独立会话
+- 共享群聊中的每个用户在该群内有独立会话
+
+通过 `config.yaml` 控制：
+
+```yaml
+group_sessions_per_user: true
+```
+
+仅当你明确希望整个群共享一个对话时，才将其设为 `false`：
+
+```yaml
+group_sessions_per_user: false
+```
+
+本指南将带你完成完整的设置流程——从创建钉钉机器人到发送第一条消息。
+
+## 前置条件
+
+安装所需的 Python 包：
+
+```bash
+cd ~/.hermes/hermes-agent && uv pip install -e ".[dingtalk]"
+```
+
+或单独安装：
+
+```bash
+pip install dingtalk-stream httpx alibabacloud-dingtalk
+```
+
+- `dingtalk-stream` — 钉钉官方 Stream Mode SDK（基于 WebSocket 的实时消息）
+- `httpx` — 异步 HTTP 客户端，用于通过 session webhook 发送回复
+- `alibabacloud-dingtalk` — 钉钉 OpenAPI SDK，用于 AI 卡片、emoji 反应和媒体下载
+
+## 第一步：创建钉钉应用
+
+1. 前往[钉钉开发者控制台](https://open-dev.dingtalk.com/)。
+2. 使用钉钉管理员账号登录。
+3. 点击**应用开发** → **自建应用** → **创建 H5 微应用**（或根据控制台版本选择**机器人**）。
+4. 填写：
+   - **应用名称**：例如 `Hermes Agent`
+   - **描述**：可选
+5. 创建完成后，进入**凭证与基础信息**，找到你的 **Client ID**（AppKey）和 **Client Secret**（AppSecret），复制两者。
+
+:::warning[凭证仅显示一次]
+Client Secret 仅在创建应用时显示一次。如果丢失，需要重新生成。切勿公开分享这些凭证或将其提交到 Git。
+:::
+
+## 第二步：启用机器人能力
+
+1. 在应用设置页面，进入**添加能力** → **机器人**。
+2. 启用机器人能力。
+3. 在**消息接收模式**下，选择 **Stream Mode**（推荐——无需公网 URL）。
+
+:::tip
+Stream Mode 是推荐的设置方式。它使用从你的机器发起的长连接 WebSocket，无需公网 IP、域名或 webhook 端点，可在 NAT、防火墙及本地机器后正常工作。
+:::
+
+## 第三步：找到你的钉钉用户 ID
+
+Hermes Agent 使用你的钉钉用户 ID 来控制谁可以与机器人交互。钉钉用户 ID 是由组织管理员设置的字母数字字符串。
+
+查找方式：
+
+1. 询问你的钉钉组织管理员——用户 ID 在钉钉管理后台的**通讯录** → **成员**中配置。
+2. 或者，机器人会在日志中记录每条传入消息的 `sender_id`。启动 gateway，向机器人发送一条消息，然后在日志中查找你的 ID。
+
+## 第四步：配置 Hermes Agent
+
+### 方式 A：交互式设置（推荐）
+
+运行引导式设置命令：
+
+```bash
+hermes gateway setup
+```
+
+在提示时选择 **DingTalk**。设置向导支持两种授权路径：
+
+- **二维码设备流（推荐）。** 用钉钉手机 App 扫描终端中打印的二维码——Client ID 和 Client Secret 将自动返回并写入 `~/.hermes/.env`，无需前往开发者控制台。
+- **手动粘贴。** 如果你已有凭证（或扫码不方便），在提示时粘贴你的 Client ID、Client Secret 和允许的用户 ID。
+
+:::note openClaw 品牌披露
+由于钉钉的 `verification_uri_complete` 在 API 层硬编码为 openClaw 身份，在 Alibaba / DingTalk-Real-AI 在服务端注册 Hermes 专属模板之前，二维码目前以 `openClaw` 来源字符串进行授权。这仅是钉钉呈现授权界面的方式——你创建的机器人完全属于你，且对你的租户私有。
+:::
+
+### 方式 B：手动配置
+
+在 `~/.hermes/.env` 文件中添加以下内容：
+
+```bash
+# 必填
+DINGTALK_CLIENT_ID=your-app-key
+DINGTALK_CLIENT_SECRET=your-app-secret
+
+# 安全：限制可与机器人交互的用户
+DINGTALK_ALLOWED_USERS=user-id-1
+
+# 多个允许用户（逗号分隔）
+# DINGTALK_ALLOWED_USERS=user-id-1,user-id-2
+
+# 可选：群聊门控（与 Slack/Telegram/Discord/WhatsApp 保持一致）
+# DINGTALK_REQUIRE_MENTION=true
+# DINGTALK_FREE_RESPONSE_CHATS=cidABC==,cidDEF==
+# DINGTALK_MENTION_PATTERNS=^小马
+# DINGTALK_HOME_CHANNEL=cidXXXX==
+# DINGTALK_ALLOW_ALL_USERS=true
+```
+
+`~/.hermes/config.yaml` 中的可选行为设置：
+
+```yaml
+group_sessions_per_user: true
+
+gateway:
+  platforms:
+    dingtalk:
+      extra:
+        # 在群聊中要求 @提及 后机器人才回复（与 Slack/Telegram/Discord 保持一致）。
+        # 单聊忽略此设置——机器人始终在 1:1 对话中回复。
+        require_mention: true
+
+        # 平台级白名单。设置后，只有这些钉钉用户 ID 可与机器人交互
+        # （语义与 DINGTALK_ALLOWED_USERS 相同，但作用域在此处而非 .env）。
+        allowed_users:
+          - user-id-1
+          - user-id-2
+```
+
+- `group_sessions_per_user: true` 在共享群聊中保持每个参与者的上下文隔离
+- `require_mention: true` 防止机器人响应每条群消息——仅在有人 @提及 时才回答
+- `dingtalk.extra` 下的 `allowed_users` 是 `DINGTALK_ALLOWED_USERS` 的替代方式；两者择一配置（若同时设置，只有同时出现在两个列表中的用户才会被授权）
+
+### 启动 Gateway
+
+配置完成后，启动钉钉 gateway：
+
+```bash
+hermes gateway
+```
+
+机器人应在几秒内连接到钉钉的 Stream Mode。发送一条消息——单聊或已添加机器人的群聊均可——进行测试。
+
+:::tip
+你可以在后台运行 `hermes gateway`，或将其配置为 systemd 服务以持续运行。详见部署文档。
+:::
+
+## 功能特性
+
+### AI 卡片
+
+Hermes 可以使用钉钉 AI 卡片代替纯 markdown 消息进行回复。卡片提供更丰富、更结构化的展示，并支持在 agent 生成响应时进行流式更新。
+
+要启用 AI 卡片，在 `config.yaml` 中配置卡片模板 ID：
+
+```yaml
+platforms:
+  dingtalk:
+    enabled: true
+    extra:
+      card_template_id: "your-card-template-id"
+```
+
+你可以在钉钉开发者控制台的应用 AI 卡片设置中找到卡片模板 ID。启用 AI 卡片后，所有回复均以带流式文本更新的卡片形式发送。
+
+### Emoji 反应
+
+Hermes 会自动在你的消息上添加 emoji 反应以显示处理状态：
+
+- 🤔Thinking — 机器人开始处理你的消息时添加
+- 🥳Done — 响应完成时添加（替换 Thinking 反应）
+
+这些反应在单聊和群聊中均有效。
+
+### 显示设置
+
+你可以独立于其他平台自定义钉钉的显示行为：
+
+```yaml
+display:
+  platforms:
+    dingtalk:
+      show_reasoning: false   # 在回复中显示模型推理/思考过程
+      streaming: true         # 启用流式响应（与 AI 卡片配合使用）
+      tool_progress: all      # 显示工具执行进度（all/new/off）
+      interim_assistant_messages: true  # 显示中间注释消息
+```
+
+若要禁用工具进度和中间消息以获得更简洁的体验：
+
+```yaml
+display:
+  platforms:
+    dingtalk:
+      tool_progress: off
+      interim_assistant_messages: false
+```
+
+## 故障排查
+
+### 机器人不响应消息
+
+**原因**：机器人能力未启用，或 `DINGTALK_ALLOWED_USERS` 中不包含你的用户 ID。
+
+**解决方法**：确认应用设置中已启用机器人能力且已选择 Stream Mode。检查你的用户 ID 是否在 `DINGTALK_ALLOWED_USERS` 中。重启 gateway。
+
+### "dingtalk-stream not installed" 错误
+
+**原因**：Python 包 `dingtalk-stream` 未安装。
+
+**解决方法**：安装它：
+
+```bash
+pip install dingtalk-stream httpx
+```
+
+### "DINGTALK_CLIENT_ID and DINGTALK_CLIENT_SECRET required"
+
+**原因**：凭证未在环境变量或 `.env` 文件中设置。
+
+**解决方法**：确认 `DINGTALK_CLIENT_ID` 和 `DINGTALK_CLIENT_SECRET` 已在 `~/.hermes/.env` 中正确设置。Client ID 是你的 AppKey，Client Secret 是钉钉开发者控制台中的 AppSecret。
+
+### Stream 断开 / 重连循环
+
+**原因**：网络不稳定、钉钉平台维护或凭证问题。
+
+**解决方法**：适配器会以指数退避（2s → 5s → 10s → 30s → 60s）自动重连。检查凭证是否有效，以及应用是否未被停用。确认你的网络允许出站 WebSocket 连接。
+
+### 机器人离线
+
+**原因**：Hermes gateway 未运行，或连接失败。
+
+**解决方法**：检查 `hermes gateway` 是否正在运行。查看终端输出中的错误信息。常见问题：凭证错误、应用被停用、`dingtalk-stream` 或 `httpx` 未安装。
+
+### "No session_webhook available"
+
+**原因**：机器人尝试回复但没有 session webhook URL。通常发生在 webhook 过期或机器人在收到消息和发送回复之间重启的情况下。
+
+**解决方法**：向机器人发送一条新消息——每条传入消息都会提供一个新的 session webhook 用于回复。这是钉钉的正常限制；机器人只能回复最近收到的消息。
+
+## 安全
+
+:::warning
+务必设置 `DINGTALK_ALLOWED_USERS` 以限制可与机器人交互的用户。若未设置，gateway 默认拒绝所有用户作为安全措施。只添加你信任的人的用户 ID——已授权用户对 agent 的全部能力拥有完整访问权限，包括工具使用和系统访问。
+:::
+
+有关保护 Hermes Agent 部署的更多信息，请参阅[安全指南](../security.md)。
+
+## 注意事项
+
+- **Stream Mode**：无需公网 URL、域名或 webhook 服务器。连接由你的机器通过 WebSocket 发起，可在 NAT 和防火墙后正常工作。
+- **AI 卡片**：可选择使用富文本 AI 卡片代替纯 markdown 回复。通过 `card_template_id` 配置。
+- **Emoji 反应**：自动添加 🤔Thinking/🥳Done 反应以显示处理状态。
+- **Markdown 响应**：回复以钉钉 markdown 格式呈现，支持富文本展示。
+- **媒体支持**：传入消息中的图片和文件会自动解析，可由视觉工具处理。
+- **消息去重**：适配器在 5 分钟窗口内对消息进行去重，防止同一消息被处理两次。
+- **自动重连**：若 stream 连接断开，适配器会以指数退避自动重连。
+- **消息长度限制**：每条消息的响应上限为 20,000 个字符，超出部分将被截断。