meow-notify

第 2 步：注册到 DSH 全局配置

编辑 $DSH_HOME/cordis.patch.yml（默认 ~/.dsh/cordis.patch.yml；不存在就新建）：

## 5. 可调节的配置项

### 5.1 通过 GUI 卡片（推荐）

设置 → 插件 → 插件配置 → 「MeoW 推送」卡片，改完点保存，1~2 秒热生效。

### 5.2 通过 settings.yaml

GUI 保存的内容写入 `$DSH_HOME/settings.yaml`：

```yaml
meow-notify:
  nickname: "1529e2a0"
  turnEndMinIntervalMs: 60000

5.3 通过 cordis.patch.yml（base 层）

      config:
        nickname: "你的MeoW昵称"
        base: "https://api.chuckfang.com"
        turnEndMinIntervalMs: 25000
        includeChildren: true

配置项	类型	默认值	作用
nickname	string	无（必填）	MeoW 接收昵称。推送给谁的手机。
base	string	https://api.chuckfang.com	推送 API 根地址。一般不用动。
enabled	bool	true	总开关。false = 不推送。
turnEndMinIntervalMs	number	25000	「任务完成」推送的全局最小间隔（毫秒）。两条完成推送间隔不足此值时，后一条被跳过（记 SKIP-THROTTLE）。调大=更安静，调小=更即时但可能触发 MeoW 限流。
includeChildren	bool	true	是否通知子代理 / workflow 会话。子会话标题带 [子] 前缀。

节流机制说明（为什么有 turnEndMinIntervalMs）

MeoW 服务端有约每分钟 3 条的静默限流：超量请求 HTTP 仍返回「发送成功」，但手机实际收不到。因此插件内置客户端节流：

• approval/asked（需要介入）永不节流——人工介入最紧急，且这类事件本身稀少；它的发送也不占用完成推送的节流额度。
• turn/end（任务完成）维护自己的节流时间戳：距上一次完成推送不足 turnEndMinIntervalMs 就跳过，保证完成推送 ≤ 约 2.4 条/分钟，把额度让给介入通知。
• 节流是跨所有会话全局的（多会话叠加也不会超限）。

---

6. 日常使用

• 什么都不用做。插件在后台随 DSH 自动加载，事件触发自动推送。
• 手机上的推送点开后是纯文本；MeoW 支持点按通知打开 App 查看全文。
• 想看插件在干什么：翻 notify.log（在 profiles/node_modules/meow-notify/ 下，自动增长，可随时删除，删后下次推送会重建）。
• 多任务并行时，靠推送标题的会话名区分（见第 1 节推送格式）。想让标题更好认：在 DSH Web UI 侧栏给会话手动改名，改名后的推送立即使用新标题。

---