========================================
 LB Down 主题 · 通知功能配置教程
 邮件 / 飞书 / 企业微信 / 钉钉 / PushPlus
========================================

【后台入口】
登录 Typecho 后台 → 控制台 → 设置外观 → 「邮件通知」分类

========================================
一、邮件通知（SMTP）
========================================

【获取配置】
1. 使用 QQ 邮箱：设置 → 账户 → 开启「POP3/SMTP 服务」→ 生成授权码（不是登录密码）
2. 使用 163 邮箱：设置 → POP3/SMTP/IMAP → 开启服务 → 获取授权码
3. 使用 Gmail：需开启两步验证并生成「应用专用密码」

【后台填写】
1. 邮件通知开关：开启
2. SMTP 服务器：
   - QQ 邮箱：smtp.qq.com
   - 163 邮箱：smtp.163.com
   - Gmail：smtp.gmail.com
3. SMTP 端口：465（SSL）或 587（TLS）
4. SMTP 账号：你的完整邮箱地址
5. SMTP 密码/授权码：填写授权码（不是邮箱登录密码！）
6. 发件人名称：选填，如「LB下载站」
7. 管理员接收邮箱：填你要接收通知的邮箱

【测试】
点「测试邮件发送」按钮，能收到邮件即配置正确。

========================================
二、飞书通知（群机器人）
========================================

【获取 Webhook】
1. 打开飞书 → 进入目标群聊
2. 群设置 → 群机器人 → 添加机器人 → 选择「自定义机器人」
3. 起个名字（如「下载站通知」），点击「添加」
4. 复制生成的 Webhook 地址（形如：
   https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxx）

【后台填写】
1. 飞书通知开关：开启
2. 飞书群机器人 Webhook：粘贴上面的地址

【测试】
点「测试飞书」按钮，群里收到消息即配置正确。

========================================
三、企业微信通知（群机器人）
========================================

【获取 Webhook】
1. 打开企业微信（电脑端/网页端）
2. 进入目标企业微信群 → 右上角「...」→ 群机器人 → 添加机器人
3. 创建后复制 Webhook 地址（形如：
   https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxxxx）

【后台填写】
1. 企业微信通知开关：开启
2. 企业微信机器人 Webhook：粘贴上面的地址

【测试】
点「测试企业微信」按钮，群里收到消息即配置正确。

========================================
四、钉钉通知（群机器人）
========================================

【获取 Webhook】
1. 打开钉钉 → 进入目标群
2. 群设置 → 智能群助手 → 添加机器人 → 自定义（通过 Webhook 接入）
3. 安全设置：建议选「自定义关键词」并填一个关键词
   （如：通知 / 求软件 / 举报，否则消息可能被拒收）
4. 复制 Webhook 地址（形如：
   https://oapi.dingtalk.com/robot/send?access_token=xxxxxxxx）

【后台填写】
1. 钉钉通知开关：开启
2. 钉钉群机器人 Webhook：粘贴上面的地址

【测试】
点「测试钉钉」按钮，群里收到消息即配置正确。

【注意】
钉钉机器人若在安全设置里勾选了「加签」，需要在代码里额外支持
签名（当前版本不支持加签）。建议改用「自定义关键词」方式，
并在关键词里包含「通知」二字（测试消息文案里已含「测试」，
若仍被拒收，把关键词改成「测试」或「LB Down」）。

========================================
五、PushPlus 通知（微信推送）
========================================

【获取 Token】
1. 打开官网：http://www.pushplus.plus
2. 微信扫码登录
3. 登录后进入「一对一推送」页面
4. 复制你的 Token（一长串字符）

【后台填写】
1. PushPlus 通知开关：开启
2. PushPlus Token：粘贴你的 Token

【测试】
点「测试PushPlus」按钮，微信收到服务通知即配置正确。

【免费额度】
免费版每天 200 条，个人站完全够用。

========================================
六、通知方式组合
========================================

所有渠道的开关都可以「同时开启」：
- 想邮件 + 飞书：邮件开关开 + 飞书开关开
- 想全部推送：全部开关打开

求软件 / 内容举报提交后，所有开启的渠道都会收到通知，
任一渠道发送成功即提示「提交成功」。

========================================
七、常见问题
========================================

1. 测试提示「无权限操作」→ 需要先登录 Typecho 后台
2. 测试提示「发送失败，请检查XX配置」→ 对应渠道的
   服务器/账号/Webhook 填错了，或网络不通
3. 邮件发不出去 → 确认用的是「授权码」不是登录密码；
   端口 465 配 SSL、587 配 TLS
4. 钉钉收不到 → 检查「自定义关键词」设置，或改用加签
5. 飞书/企微/钉钉频率限制：每秒钟 5 条、每分钟 100 条，
   正常使用完全够用，无每日总量限制

========================================
 END · 配置完成
========================================
