Sequoia-X 飞书播报：按策略分群推送的 webhook 路由

1. 在飞书群里添加自定义机器人

   在目标群设置里添加「自定义机器人」，拿到该机器人的 Webhook 地址。开源项目不包含机器人创建能力，这一步在飞书侧完成。

2. 先配一个默认 Webhook

   把地址写进项目根目录 .env 的 FEISHU_WEBHOOK_URL。它是必填项——不填的话程序在读取配置阶段就会失败退出，连数据同步都不会开始。

3. 按策略补充专属 Webhook

   想让某个策略单独进群，就在 .env 里加对应的 STRATEGY_WEBHOOK_<KEY>，例如 STRATEGY_WEBHOOK_TURTLE。没配的键自动回落到默认地址。

4. 跑一次日常模式观察日志

   执行 python main.py，每条命中的策略都会打印一行推送结果：成功是「飞书推送成功 [key]，共 N 只股票」，失败会带上 HTTP 状态与飞书响应体。

5. 到群里核对卡片内容

   确认标题里的策略名、日期、数量与标的一一对应。若同一只股票出现在多条卡片里，那是因为它同时满足多个策略——这是预期行为。

命中的请求体（截取第 1 条，msg_type 为 interactive，即飞书卡片消息）：

{
  "msg_type": "interactive",
  "card": {
    "header": {"title": {"tag": "plain_text",
                         "content": "📈 Sequoia-X 选股播报 | MaVolumeStrategy"},
               "template": "blue"},
    "elements": [
      {"tag": "div", "text": {"tag": "lark_md",
        "content": "**日期：** 2026-10-10\n**策略：** MaVolumeStrategy\n**选股数量：** 5"}},
      {"tag": "hr"},
      {"tag": "div", "text": {"tag": "lark_md",
        "content": "**选股列表：**\n[东望时代](https://xueqiu.com/S/SH600052) [同仁堂](https://xueqiu.com/S/SH600085) ..."}}
    ]
  }
}

1. 路由真的生效了（这是本轮最有价值的一条）

   三条请求分别落到 /hook/ma_volume、/hook/turtle、/hook/rps——说明 STRATEGY_WEBHOOK_<KEY> 的名字（小写匹配 webhook_key）确实能把你带到不同机器人，而不是全都 fallback 到默认 URL。要自查是否真的分群，最直接的办法就是给每个 key 配一个不同的群，然后看哪个群收到哪条。

2. 成功判定：看返回体的 code，不是看 HTTP 状态码

   resp_json = resp.json()
   if resp.status_code != 200 or resp_json.get("code") != 0:
       logger.error(f"飞书推送失败 [{webhook_key}] HTTP状态={resp.status_code} 飞书响应={resp.text}")

   本站 mock 服务返回的是 {"code": 0, "msg": "success"}，日志随即打出 飞书推送成功 [key]。反过来说：HTTP 200 但 code 非 0 依旧算失败，而日志里那行 ERROR 飞书推送失败 会同时带上飞书的原始响应，排查时直接看这一行就够。

3. 三个典型「推不出去」的原因（对照请求体能直接分辨）

   现象	看请求体的哪里	结论
   日志里根本没有「飞书推送」这一行	——（没有请求体）	不是推送问题：策略 0 只时项目直接 跳过推送，先去看策略层
   有请求、飞书回 code != 0	响应体里的 msg（如签名/关键词校验失败）	机器人安全设置问题，与数据、策略无关
   有请求、飞书回 200 且 code: 0，但群里没看到	请求体里的 content 是否为空、卡片 elements 是否被安全设置过滤	通常是机器人被移出群或被限流；本项目不会重试，也不会告诉你没送达