{
  "module": "messenger",
  "purpose": "统一消息处理者——生产者与消费者解耦，按 job 配置路由消息通道",
  "human_help": {
    "title": "统一消息处理者",
    "description": [
      "messenger 是 MoFin 的统一消息处理者。所有脚本发送消息时调用 messenger，不需要关心消息去哪个通道。",
      "消息去向由【生产者是谁】（哪个 cron job）决定，配置在 jobs.json 的 delivery 字段。",
      "通道：broadcast(只写播报表) / xmpp(推用户+归档) / both(两者)。"
    ],
    "usage": [
      "脚本接入：文件开头加 from messenger import install_stdio_hook; install_stdio_hook()",
      "发送消息：messenger.send(title=..., content=..., source=脚本名)",
      "通道配置：健康 Tab cron 列表的'消息通道'列点击切换。",
      "操作推荐：messenger.send_action_recommendation() 强制走 xmpp。"
    ],
    "troubleshooting": [
      "消息没推 xmpp：检查该脚本的 delivery 配置是否为 broadcast。",
      "消息没进播报：检查 messenger 是否正确安装 hook。",
      "递归嵌套：已修复（写表直接操作DB不经send）。"
    ]
  },
  "ai_spec": {
    "purpose": "消息生产者与消费者解耦，统一通道路由",
    "apis": [
      {"method": "fn", "path": "messenger.send(title, content, source, channel, job_name)", "returns": "通道(broadcast/xmpp)"},
      {"method": "fn", "path": "messenger.send_action_recommendation(title, content, source)", "returns": "强制xmpp"},
      {"method": "fn", "path": "messenger.install_stdio_hook(script_name)", "returns": "当前通道"},
      {"method": "fn", "path": "messenger.get_channel(script)", "returns": "脚本通道配置"}
    ],
    "dependencies": ["jobs.json delivery", "broadcast_messages表"],
    "constraints": [
      "消费者按生产者(job)判通道，不按内容",
      "所有通道都写 broadcast_messages 归档",
      "xmpp 通道输出 stdout 供 hermes 捕获推 xmpp"
    ],
    "must_not": [
      "禁止按消息内容决定通道（内容分类仅用于 broadcast 表展示）",
      "禁止脚本绕过 messenger 直接 print 用户消息"
    ],
    "related_files": [
      "deploy/profile-scripts/messenger.py",
      "hermes jobs.json (delivery字段)"
    ]
  }
}