feat(channel): KOOK Webhook(WH) 接收模式——与 WS 配置切换(ReceiveMode)

- kook.Config 加 ReceiveMode("ws"默认/"webhook") + WebhookPath(默认/webhook/kook) + WebhookVerifyToken + WebhookEncryptKey(AES-256-CBC)
- 按权威文档(Reference/kaiheila webhook.md)实现: 无X-Signature HMAC, 真实校验=d.verify_token比对(不匹配403)+可选AES解密+zlib解压+challenge回显
- webhook.go: InboundHandler+WebhookPath, POST→zlib解压→AES解密→verify_token校验→challenge回显→归一UnifiedMessage→SetMessageHandler; WS模式Connect不拨网关仅标记connected
- channelbridge/webhookAdapter 接口改用 WebhookPath(); WebhookHandlers 收KOOK WH(ws模式跳过); 既有webhook通道补WebhookPath照常挂载
- namedAdapter 转发InboundHandler/WebhookPath; kook env兜底 +4个CHANNEL_KOOK_*键
- 测试: verify_token 403/challenge/zlib/AES往返/WebhookPath按模式/WH不拨gateway/WebhookHandlers收KOOK; 全仓build/vet/test绿
- 待真token端到端实测(需主人提供CHANNEL_KOOK_TOKEN+开发者后台切WebHook配回调URL)

.env.example

@@ -101,8 +101,18 @@ ALLOWED_ORIGINS=http://localhost:5173,http://localhost:3000
 # 单账号走环境变量；多账号走下方 CHANNELS_JSON。
 # CHANNEL_KOOK_TOKEN 为 KOOK 开发者中心机器人 token（敏感，勿写日志/提交）。
 # CHANNEL_KOOK_BASE_URL 可选，默认 https://www.kookapp.cn/api/v3。
+# CHANNEL_KOOK_RECEIVE_MODE 可选：ws（默认，连 KOOK gateway WebSocket 收事件）| webhook
+#   （在 Cyrene gateway 挂一条路由接收 KOOK 的 POST 回调；webhook 与 ws 互斥，需在 KOOK
+#    开发者后台把机器人连接模式切到 WebHook 并填回调 URL）。
+# CHANNEL_KOOK_WEBHOOK_PATH 可选，webhook 模式回调路由，默认 /webhook/kook。
+# CHANNEL_KOOK_WEBHOOK_VERIFY_TOKEN 可选，KOOK 开发者后台 verify token（回调校验，不匹配 403）。
+# CHANNEL_KOOK_WEBHOOK_ENCRYPT_KEY 可选，KOOK Encrypt Key（回调 AES-256-CBC 解密）。
 # CHANNEL_KOOK_TOKEN=
 # CHANNEL_KOOK_BASE_URL=
+# CHANNEL_KOOK_RECEIVE_MODE=ws
+# CHANNEL_KOOK_WEBHOOK_PATH=
+# CHANNEL_KOOK_WEBHOOK_VERIFY_TOKEN=
+# CHANNEL_KOOK_WEBHOOK_ENCRYPT_KEY=
 
 # ---- IM 多账号 / 黑白名单（可选，design/16 §4.6 §5-6） ----
 # ⚠️ 本节是【兜底】：管理面板「渠道管理」页保存会写入本地 channels.json（默认 <DATA_DIR>/channels.json，已 gitignore），