dsh-TUI 在執行長輪次或需要人工審批時，通常需要開發者留在終端前。一旦離開，這些關鍵狀態可能被遺漏。下面介紹 dsh-tui-webhook，它通過配置本地 IM 機器人，將長輪次完成和審批請求推送到飛書、釘釘、企業微信或通用 webhook。
插件定位¶
這是一個爲 dsh-TUI 設計的社區插件。其核心作用是將 dsh-TUI 的關鍵事件（如長輪次結束、審批請求）推送到 IM 機器人，讓你在離開電腦時也能收到提醒。配置保存在本地 settings 文檔中，不上傳任何第三方。
核心功能¶
- 事件推送：支持將 dsh-TUI 事件推送到 IM 機器人。
- 多平臺支持：支持飛書、釘釘、企業微信以及任意通用 webhook。
- 關鍵通知：推送長輪次完成通知和工具審批請求通知。
- 會話統計：僅統計頂層會話的輪次，子 agent 不會重複推送。
- 本地配置：URL 與加簽密鑰保存在本機 dsh settings 文檔（webhook 命名空間）中。
安裝¶
目前該插件尚未發佈到 npm，需從源碼打包安裝。請在終端執行以下命令：
git clone https://github.com/FUSU123fusu/dsh-tui-webhook.git
cd dsh-tui-webhook
npm pack
dsh plugin --profile <你的profile> add file:dsh-tui-webhook-0.1.0.tgz
配置與使用¶
安裝後，在 dsh-TUI 中進入 /settings →「Webhook 通知」進行配置。配置項包括平臺、webhook 地址、加簽密鑰、最小輪次時長（默認 30 秒）以及開關。保存後立即生效，無需重啓。
查看配置狀態：
/webhook
該命令會顯示當前平臺、URL 掩碼（僅顯示前 30 個字符）以及開關狀態。
發送測試消息：
/webhook test
該命令會發送一條測試消息並返回 HTTP 狀態。
平臺配置指南¶
在配置 URL 和密鑰前，需在對應 IM 平臺創建機器人：
- 飛書：羣設置 → 羣機器人 → 自定義，複製 webhook。開啓「簽名校驗」後，將密鑰填入
secret。 - 釘釘：羣設置 → 機器人 → 自定義，複製 webhook。安全設置選「加簽」後，將密鑰填入
secret。 - 企業微信：羣設置 → 羣機器人 → 添加，複製 webhook（不支持加簽）。
- 通用：任意接收
POST {"text":"..."}的 HTTP 端點。
注意事項¶
- 隱私與安全：配置保存在本地，不上傳第三方。在
/webhook狀態頁，URL 僅顯示前 30 個字符。 - 統計範圍：插件只統計頂層會話的輪次。
- 許可證：項目採用 MIT 許可證。安裝前應檢查源碼，確保符合你的使用場景。
項目地址：https://github.com/FUSU123fusu/dsh-tui-webhook
