dsh-wecom-notify

使用

重启 dsh web，日志出现 [wechat-notify] plugin loaded； 打开 dsh 设置 → 企业微信通知：

• 粘贴你的 webhook key（可多个，一行一个，「＋ 添加一个群」继续加）；
• 点 「发送测试消息」 先验证（逐群显示结果）→ 点 「保存配置」 立即生效。

也可以 npm run install-dsh 一键构建并写入 patch（默认写到 ~/.dsh/profiles/web/，方式 B）。

⚙️ 配置（优先级：设置面板文件 > cordis.yml config > 环境变量 > 默认值）

① 设置面板（推荐）

dsh 设置 → 企业微信通知 面板保存后写入 /wecom-notify/config.json（DSH_HOME 缺省 ~/.dsh，0600 权限）。 文件存在时以文件为准（面板里清空 = 显式清空）；如需回到静态配置，删除该文件即可。

字段	说明
webhookKeys	群机器人 webhook 的 key 数组（可多个，同时通知所有群）
webhookUrl	附加的完整 webhook 地址（旧版兼容，额外目标）
mentionUserid	通知时 @ 的企业微信 userid（可选）
minIntervalMs	节流间隔（默认 10000）
dedupeWindowMs	去重窗口（默认 30000）
triggerOnAgentIdle	agent 空闲时也通知（默认关，防噪音）
turnSummaryEnabled	每轮对话完成推送总结（默认开）
maxBytes	单条消息最大字节数（上限 4096，默认 3800）

② cordis.yml config（静态声明，可选）

- insert:
    - id: wechat-notify
      name: 'file:///绝对/路径/dsh-WeCom-notify/lib/index.js'
      config:
        webhookKeys:            # 多个 key，同时通知
          - '你的第一个群机器人 webhook key'
          - '你的第二个群机器人 webhook key'
        # webhookKey: '旧版单 key（并入 webhookKeys）'
        # webhookUrl: '完整 webhook 地址（附加目标）'
        # mentionUserid: '通知时 @ 的企业微信 userid'
        # minIntervalMs: 15000

③ 环境变量兜底（兼容旧版）

环境变量	说明
WECHAT_WEBHOOK_KEYS	多个 key，逗号/分号/换行分隔（key1,key2）
WECHAT_WEBHOOK_KEY	单个 key（旧版，并入 keys）
WECHAT_WEBHOOK_URL	完整 webhook 地址（附加目标）
WECHAT_MENTION_USERID	通知时 @ 的企业微信 userid
NOTIFY_MIN_INTERVAL_MS	节流间隔
NOTIFY_DEDUPE_WINDOW_MS	去重窗口
NOTIFY_TRIGGER_AGENT_IDLE	agent 空闲时也通知（1/true 开启）
NOTIFY_TURN_SUMMARY	每轮总结推送（0/false 关闭）
NOTIFY_MAX_BYTES	单条消息最大字节数（上限 4096）

未配置 key 时插件正常加载，通知降级为日志提示，不报错。