dsh-message-gateway：DSH Web 多平臺消息網關

在 DSH Web GUI 的使用場景中，開發者常需要同時處理企業微信、Telegram、Discord 等多個平臺的消息。手動逐一配置既繁瑣又容易出錯。dsh-message-gateway 插件提供了一套統一的連接器管理方案，將消息平臺集成到側邊欄，支持流式回覆與主動推送。

核心功能¶

該插件在 DSH Web 側邊欄「新會話」按鈕下方提供「消息平臺」入口，全屏管理多平臺連接器。

多平臺連接器：支持 Telegram、Discord、QQ、Email、釘釘、飛書、Bark、Server醬、Webhooks、企業微信及企業微信智能機器人。
企業微信智能機器人常駐橋接：保存憑據後自動建立官方 SDK 長連接，支持流式回覆與上下文壓縮。
通用主動推送通道：通過 POST /gateway/push 接口，支持 Base64 圖片與 Markdown 格式，供定時任務或自動化腳本調用。
憑據管理：憑據明文落盤至 ~/.dsh/gateway.（權限 600）。
敏感信息脫敏：寫入日誌或控制台的消息內容會自動遮蔽疑似密鑰（如 sk-、GitHub token 等）。
連接測試：提供針對各平臺的連接測試功能。
Webhook 接收端點：支持 POST /gateway/webhook/in 接收外部系統消息。
微信個人號網關：支持對接 Wechaty 網關。
多語言支持：支持中文、English、Español。

安裝與啓用¶

使用官方安裝命令即可將插件接入 DSH Web 環境：

dsh plugin --profile web add dsh-message-gateway

重啓 dsh web 後，側邊欄「新會話」按鈕下方將出現「消息平臺」入口。

典型用法¶

打開 DSH Web（dsh web），點擊側邊欄「消息平臺」按鈕。
在管理頁左側選擇目標平臺，右側填寫對應的認證憑據（如 Token、AppID、Secret 等），點擊「保存」進行連接。
對於企業微信智能機器人，保存 botId 和 secret 後，插件會立即建立常駐連接，無需額外配置即可在企微中與機器人對話。
使用通用主動推送通道發送消息：

curl -X POST http://localhost:3000/gateway/push \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "telegram",
    "target": "123456789",
    "content": "這是通過網關主動推送的消息"
  }'

配置項¶

插件提供以下配置項，可通過 dsh plugin config 或 profile 配置文件調整：

botLocale：機器人回覆文案語言，默認 zh。
maxChatAgents：每機器人最多保留的聊天會話數，默認 40。
autoStartWecom：啓動時是否自動用已保存的企微智能機器人憑據連接，默認 true。
groupReply：是否回覆羣聊消息，默認 true。

注意事項¶

插件以當前 DSH 進程的權限運行，憑據明文落盤至 ~/.dsh/gateway.，請注意文件權限與系統安全。
使用前請檢查源碼與許可證（MIT），確保符合您的使用規範。

總結¶

dsh-message-gateway 通過統一入口與流式回覆能力，降低了多平臺消息管理的複雜度，適合需要構建跨平臺消息路由與自動化通知場景的開發者。