rosercode
8bfdde24f2
定时通知新增飞书渠道后同步文档：使用文档补充飞书渠道的配置方式与示例截图，开发文档补充 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 全量调用
43 lines
2.2 KiB
Markdown
43 lines
2.2 KiB
Markdown
# 定时提醒与通知
|
||
|
||
系统可按周期提醒你导入新账单，并通过邮箱、Server 酱或飞书推送通知。配置入口为「设置 → 定时通知」。
|
||
|
||
|
||
|
||
## 提醒周期
|
||
|
||
- **通知链接地址**：通知正文中附带的跳转链接（如指向账单导入页 `/bill-import`）。
|
||
- **启用定时提醒**：开启后按周期发送。
|
||
- **提醒周期**：每天 / 每周（选择星期几）/ 每月（选择 1–28 日，默认每月 1 日）。
|
||
- **提醒时间**：`HH:mm` 格式（如 `09:00`）。
|
||
|
||
## 推送渠道
|
||
|
||
点击「添加渠道」新增，支持三种类型：
|
||
|
||
| 渠道 | 配置项 |
|
||
|---|---|
|
||
| Server 酱 | SendKey（在 sct.ftqq.com 获取），可推送到个人微信 |
|
||
| 邮箱 | SMTP 服务器、端口、邮箱账号、授权码、收件人、是否使用 SSL |
|
||
| 飞书 | Webhook 完整地址（飞书群「设置 → 群机器人 → 添加机器人 → 自定义机器人」获取）；若机器人开启了「签名校验」，再填写签名密钥，可推送到飞书群 |
|
||
|
||
|
||
|
||
飞书渠道配置示例（类型选择「飞书」，填写 Webhook 地址与可选的签名密钥）：
|
||
|
||
|
||
|
||
每个渠道可单独「测试」「编辑」「删除」，并可通过启用开关控制是否参与发送。
|
||
|
||
面板右上角的「立即发送」可向所有启用渠道立即发送一次提醒，用于验证配置。
|
||
|
||
## 发送日志
|
||
|
||
「定时通知」面板下方展示最近发送记录（最多 20 条），包含成功/失败、时间、渠道类型与说明，便于排查问题。
|
||
|
||
## 说明
|
||
|
||
- 首次启用提醒时，系统会将「上次发送时间」置为当前，避免启用后立即补发历史提醒。
|
||
- 提醒正文默认提示导入新账单，并附带配置的通知链接地址。
|
||
- 若当前没有任何启用的渠道，到点时不会发送，待配置渠道后在本周期内仍可触发。
|