vault backup: 2026-11-09 09:42:19

小鱼/闲鱼消息通知/README.md

@@ -15,6 +15,34 @@
 2. **双击 `probe.bat`** → 生成 `probe-result.json`，把结果发给助手校准未读元素的选择器。
 3. **双击 `start-watch.bat`** 测试；确认能弹窗后，改用 `start-watch-hidden.vbs` 后台常驻。
 
+## 防刷屏 / 防乱发
+
+`config.json` 里的 `rateLimit` 是 webhook 的闸门：
+
+```json
+"rateLimit": { "minIntervalSeconds": 60, "maxPerHour": 30 }
+```
+
+- **合并而非丢弃**：60 秒内的多次新消息不会发多条，而是攒起来，到点合成一条"合并 N 条提醒"发出去。信息不丢，群里不刷屏。
+- **小时上限**：企业微信群机器人官方限制 20 条/分钟（超了返回 `45009`），这里默认 30 条/小时，远低于阈值，不会触发封禁。
+- **本地弹窗不走节流**，因为那是给你自己看的；只有转发到群的受限制。
+- **只在未读数变大时触发**，已读、刷新页面、重复渲染都不会误报。
+
+## 密钥安全（重要）
+
+webhook 的 URL 本身就是密码：拿到 URL 的任何人都能往你群里发任意消息。
+
+这个文件夹在 **Obsidian 库里**，如果你的库有同步/进 Git，密钥会跟着上云。所以配置文件支持不写明文：
+
+```json
+"webhooks": [
+  { "type": "wecom", "url": "env:WECOM_HOOK" }
+]
+```
+
+然后在系统环境变量里设 `WECOM_HOOK=https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx`。
+（注意：环境变量对当前用户所有程序可见，安全性高于明文但不等于保险箱。）
+
 ## 通知配置
 
 - 只想要本地弹窗/声音：默认即可。