docs: 定时通知补充飞书自定义机器人渠道说明

定时通知新增飞书渠道后同步文档:使用文档补充飞书渠道的配置方式与示例截图,开发文档补充 FEISHU 渠道类型与发送器实现,并在功能概览、技术栈等处同步“飞书”。

变更内容:
- guide/notifications.md 增加飞书渠道配置项与获取路径,新增飞书渠道配置示例图
- dev/notifications.md 渠道表新增 FEISHU(post 富文本、可选加签),补充 webhookUrl/secret 与 hasSecret 脱敏说明
- guide/introduction.md、guide/settings.md、index.md、dev/architecture.md 同步“飞书”
- scripts/ts/capture-elements.ts 新增 captureChannelFeishu 并纳入 main 全量调用
This commit is contained in:
2026-10-13 12:52:43 +08:00
parent b1fb2c68a9
commit 8bfdde24f2
7 changed files with 47 additions and 8 deletions
+2 -1
View File
@@ -17,13 +17,14 @@
|---|---|
| `EMAIL` | 邮箱 SMTP(如 QQ 邮箱),动态构建 `JavaMailSenderImpl`,默认 `smtp.qq.com:465` + SSL |
| `SERVERCHAN` | Server 酱 Turbo,推送到个人微信,校验返回 `code == 0` |
| `FEISHU` | 飞书自定义机器人 Webhook,post 富文本(标题保留为卡片标题、正文按行分段),可选加签(`timestamp` + HMAC-SHA256),校验 `code` / `StatusCode` |
发送器采用工厂模式:`NotificationSender` 接口 + `NotificationSenderFactory` 按类型分发,`AbstractHttpNotificationSender` 封装 JSON/表单 POST。
## 配置与日志
- `t_notification_config`:启用开关、周期、每月日期、每周星期、提醒时间、最近发送时间。
- `t_notification_channel`:类型、名称、启用、配置 JSON(SMTP 账号或 SendKey)。邮箱密码留空表示不修改,返回时脱敏。
- `t_notification_channel`:类型、名称、启用、配置 JSON(SMTP 账号、Server 酱 SendKey 或飞书 `webhookUrl` / `secret`)。邮箱密码与飞书密钥留空表示不修改,返回时脱敏,`NotificationChannelVO` 以 `hasPassword` / `hasSecret` 标记是否已配置。
- `t_notification_log`:每次发送的结果(成功/失败、渠道类型、说明),面板展示最近 20 条。
## 接口