feat(feishu): add require_mention config option for group chats

[hillerliao]

Feishu 群聊 require_mention 配置选项

允许在飞书群聊中关闭必须 @mention 机器人才能触发回复的限制。

使用方法

在 ~/.hermes/config.yaml 中添加：

platforms:
  feishu:
    extra:
      require_mention: false

然后 hermes gateway restart 重启网关即可。

⚠️ 重要前提：飞书应用权限

此配置依赖飞书平台级权限，仅修改配置不够。必须在 飞书开放平台 给应用添加以下权限：

权限	说明
im:message.group_msg（读取群组中所有消息）	接收群聊中所有消息（不需要 @mention）

如果只具备 im:message.group_at_msg（获取 @机器人的消息），飞书服务器本身不会把非 @mention 消息转发给应用，配置无效。

代码改动

• FeishuAdapterSettings：新增 require_mention: bool = True 字段
• _load_settings()：从 extra 读取 require_mention，默认为 true
• _should_accept_group_message()：require_mention=False 时跳过 @mention 检查但仍执行群策略

测试

4 个新增测试用例全部通过（118 passing）

[alt-glitch]

Multiple prior attempts at this feature exist: #4591, #5219, #7546. Consider consolidating.

[alt-glitch]

Multiple prior attempts at this feature exist: #4591, #5219, #7546. Consider consolidating.

[de1tydev]

Current-status note for reviewer context:

The underlying Feishu require_mention gap still exists on current main; Feishu group messages still require an explicit bot mention in Hermes-side filtering, and there is no upstream FEISHU_REQUIRE_MENTION / require_mention option yet.

This PR covers the core config-file path. A newer focused implementation is also open in #17406; it keeps the default behavior unchanged, preserves the group policy / allowlist gate before bypassing mention matching, adds env-var support, updates docs, and includes broader directed unit coverage. Maintainers may want to consolidate these rather than review them independently.

[teknium1]

Thanks for the focused Feishu configuration and test coverage. This is now implemented on current main; this is an automated hermes-sweeper review.

• plugins/platforms/feishu/adapter.py:1600 loads require_mention from Feishu config extra or FEISHU_REQUIRE_MENTION, defaulting safely to true.
• plugins/platforms/feishu/adapter.py:4270 applies the group-policy gate before plugins/platforms/feishu/adapter.py:4274 conditionally enforces a bot mention.
• plugins/platforms/feishu/adapter.py:4278 supports per-group group_rules.<chat_id>.require_mention overrides.
• tests/gateway/test_feishu_bot_admission.py:100 and :343 cover config/env resolution and unmentioned group admission when disabled.
• website/docs/user-guide/messaging/feishu.md:240 and :527 document the global and per-group controls.
• The merged implementation is b94cb8e2c4ebf2a8c7688cf676c3cf9899584adb (feat(feishu): operator-configurable bot admission and mention policy), included in v2026.5.7.

The earlier discussion correctly identified duplicate Feishu require_mention work; the PR's legacy target path has since migrated to the bundled platform plugin.