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
