docs: sync documentation with current codebase

- Update event formatter count 23 -> 28 (add ping, workflow_job, status, deployment, check_suite)
- Document Telegram support end-to-end (routes, /gh commands, richheader, secrets)
- Fix route schema to use targets array and group fields (owners, emoji)
- Correct KV/D1 storage layout (msg:*, i18n:*, D1 links/send_logs)
- Note GITHUB_APP_ID/GITHUB_PRIVATE_KEY are unused; drop legacy DISCORD_CHANNEL_ID/PORT/CONFIG_PATH
- Remove stale Docker deployment section
- Update color table, branch filter compatibility, admin API endpoints
- AGENTS.md: add Documentation section requiring doc updates after functional changes

docs/zh/api/oauth.md

@@ -47,6 +47,7 @@ GitHub 授权后重定向到此地址。将 code 交换为访问令牌并存储
 - **浏览器流程**（`Accept: text/html`）：设置管理员会话 Cookie，然后重定向到 `redirect` 目标；无管理权限的用户被重定向到 `/admin?error=forbidden`。
 - **JSON 流程**：返回 `{ "userId": "...", "login": "...", "redirectTo": "..." }`。
 - **Discord 绑定流程**（以未决的 `discordUserId` 启动时）：将 Discord 用户绑定到此 GitHub 账号，返回 `{ "ok": true, "discordUserId": "...", "login": "..." }`——浏览器中则显示成功页面。
+- **Telegram 绑定流程**（以未决的 `telegramUserId` 启动时）：将 Telegram 用户绑定到此 GitHub 账号，返回 `{ "ok": true, "telegramUserId": "...", "login": "..." }`，并向未决的 `telegramChatId` 发送确认消息。
 
 ### 撤销 Token
 
@@ -77,7 +78,7 @@ Token 以键模式 `token:{userId}` 存储在 KV 中：
 }
 ```
 
-`expiresAt` 是毫秒级 Unix 时间戳。KV 条目在 Token 有效期的 90% 时过期（至少 60 秒）。反向索引 `token-reverse:{sha256 of token}` 将访问令牌映射回用户 id，使 Bearer 鉴权的端点能解析调用者。与 GitHub 账号绑定的 Discord 用户存储在 D1 的 `discord_links` 表中。
+`expiresAt` 是毫秒级 Unix 时间戳。KV 条目在 Token 有效期的 90% 时过期（至少 60 秒）。反向索引 `token-reverse:{sha256 of token}` 将访问令牌映射回用户 id，使 Bearer 鉴权的端点能解析调用者。与 GitHub 账号绑定的 Discord 用户存储在 D1 的 `discord_links` 表中；Telegram 用户存储在 D1 的 `telegram_links` 表中。
 
 ## 使用 Token
 

docs/zh/api/overview.md

@@ -33,6 +33,7 @@ https://your-worker.workers.dev
 | `PUT`    | `/admin/api/groups/:id/routes` | 管理员会话   | 替换某分组的路由                                 |
 | `GET`    | `/admin/api/me`                | 管理员会话   | 当前会话信息                                     |
 | `GET`    | `/admin/api/logs`              | 管理员会话   | 发送日志（按权限过滤）                           |
+| `GET`    | `/admin/api/logs/:id`          | 管理员会话   | 单条发送日志（按权限过滤）                       |
 
 ## 管理控制台
 
@@ -40,7 +41,7 @@ https://your-worker.workers.dev
 
 - `GET /admin` — 提供配置控制台 HTML
 - `GET /admin/api/routes` — 返回 `{ "routes": Route[] }`
-- `PUT /admin/api/routes` — 请求体为 `{ "routes": Route[] }`；校验每条路由（id 格式、唯一 id、name、enabled、groupId、过滤器、平台感知的 target：Discord 需 `target.channelId`，Telegram 需 `target.chatId`）并持久化到 KV `config:routes`。返回 `200 { ok, count }` 或 `400 { error }` / `401 { error }`。
+- `PUT /admin/api/routes` — 请求体为 `{ "routes": Route[] }`；校验每条路由（id 格式、唯一 id、name、enabled、groupId、过滤器、平台感知的 targets：Discord 需 `target.channelId`，Telegram 需 `target.chatId`）并持久化到 KV `config:routes`。返回 `200 { ok, count }` 或 `400 { error }` / `401 { error }` / `403 { error }`。
 
 ## 健康检查
 
@@ -66,11 +67,11 @@ POST /webhook
 
 **请求头：**
 
-| 头部                  | 必需 | 说明             |
-| --------------------- | ---- | ---------------- |
-| `X-Hub-Signature-256` | 是   | HMAC-SHA256 签名 |
-| `X-GitHub-Event`      | 是   | 事件类型名称     |
-| `X-GitHub-Delivery`   | 是   | 唯一投递 ID      |
+| 头部                  | 必需 | 说明                          |
+| --------------------- | ---- | ----------------------------- |
+| `X-Hub-Signature-256` | 是   | HMAC-SHA256 签名              |
+| `X-GitHub-Event`      | 是   | 事件类型名称                  |
+| `X-GitHub-Delivery`   | 否   | 唯一投递 ID（存在时用于去重） |
 
 **请求体：** GitHub webhook JSON 载荷（最大 1MB）。
 
@@ -82,6 +83,8 @@ POST /webhook
 }
 ```
 
+当 `X-GitHub-Delivery` 存在且同一投递在最近 5 分钟内已被处理时，Worker 返回 `200 { "ok": true, "duplicate": true }`，不再重复分发。
+
 **错误响应：**
 
 | 状态码 | 响应体                           | 原因                         |