__init__.py 2.2 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950
  1. """
  2. 飞书渠道(Gateway Python 包)
  3. **Python 模块**
  4. - ``types``:规范化入站事件 ``IncomingFeishuEvent``、回复上下文 ``FeishuReplyContext``
  5. - ``connector``:请求飞书 HTTP 适配层(通常即本目录旁的 Node 服务)
  6. - ``identity``:``open_id`` 等 → 渠道 ``user_id``
  7. - ``protocols``:收窄的 ``FeishuExecutorBackend`` / ``FeishuUserIdentityResolver``
  8. - ``router``:``FeishuMessageRouter``(Trace 会话准备 → 调执行器 → 绑定 Agent ``trace_id``)
  9. - ``bridge``:``FeishuHttpRunApiExecutor``(Agent Trace HTTP 建链/续跑、WS 跟单、assistant 回推飞书)
  10. - ``manager``:``FeishuChannelManager`` 组装 Connector / Lifecycle / bridge / router
  11. - ``api``:FastAPI 挂载 ``/api/channels/feishu/...``
  12. **同目录非 Python 包(勿当模块 import)**
  13. - ``openclaw-lark/``:git 子模块,飞书适配上游;Docker 见 ``docker/Dockerfile.feishu``
  14. - ``openclaw-lark-patch/``:构建时覆盖补丁;compose 可挂 ``config.yml`` 等
  15. 类名 ``FeishuHttpRunApiExecutor`` 保留历史含义(调用 Agent Trace HTTP);实现位于 ``bridge``。
  16. """
  17. from gateway.core.channels.feishu.bridge import FeishuHttpRunApiExecutor
  18. from gateway.core.channels.feishu.api import FeishuChannelApi
  19. from gateway.core.channels.feishu.connector import FeishuConnector, TYPING_REACTION_EMOJI
  20. from gateway.core.channels.feishu.identity import DefaultUserIdentityResolver
  21. from gateway.core.channels.feishu.manager import FeishuChannelConfig, FeishuChannelManager
  22. from gateway.core.channels.feishu.protocols import FeishuExecutorBackend, FeishuUserIdentityResolver
  23. from gateway.core.channels.feishu.router import FeishuMessageRouter
  24. from gateway.core.channels.feishu.types import (
  25. FeishuReplyContext,
  26. IncomingFeishuEvent,
  27. feishu_event_to_mapping,
  28. mapping_to_feishu_event,
  29. )
  30. __all__ = [
  31. "FeishuChannelApi",
  32. "FeishuHttpRunApiExecutor",
  33. "DefaultUserIdentityResolver",
  34. "FeishuChannelConfig",
  35. "FeishuChannelManager",
  36. "FeishuConnector",
  37. "TYPING_REACTION_EMOJI",
  38. "FeishuExecutorBackend",
  39. "FeishuMessageRouter",
  40. "FeishuReplyContext",
  41. "FeishuUserIdentityResolver",
  42. "IncomingFeishuEvent",
  43. "feishu_event_to_mapping",
  44. "mapping_to_feishu_event",
  45. ]