Flynor平台文档Flynor 首页
Flynor 文档/COMPONENT · EXPERIENCE
草案

Robot Connector

只处理企微/飞书的连接、消息、身份、图片、附件和回复。共享 Facade 已承接飞书、企微 callback/relay 与企微官方长连接的入站和出站投影,覆盖 reply/send/update 与 text/card/file/image;Delivery Receipt 元数据已关联共用 Runtime 账本并可跨重启查询,Outbox 仍是业务投递权威。原渠道协议、NormalizedMessage、Outbox 和 Provider 行为保持不变;enterprise-wechat-connector 仅保留为兼容 ID。

展示名称机器人连接器
类型robot-connector
成熟度试点
OwnerAI 运维组
01

职责与边界

负责

  • 企业微信长连接/回调与飞书长连接的建连、验签、解密、重放防护和限流
  • 用户/群/会话身份映射
  • 文本、卡片、图片、附件与回调规范化
  • 可靠回复、媒体上传与 Provider 投递回执

不负责

  • 不管理 Robot Job/Queue
  • 不理解项目问题
  • 不访问资源或模型
  • 不保存项目会话语义
02

数据与接口

拥有的数据

  • 企微/飞书连接配置引用、身份映射和 Provider Delivery Receipt

输入

企微/飞书回调或长连接事件;Channel Reply

输出

Channel Message Envelope;Delivery Receipt

协议

WeCom Callback/WebSocket;Lark/Feishu WebSocket;flynor/channel-message/v1alpha1;flynor/channel-delivery-receipt/v1alpha1

依赖

protocol;secret-store

03

运行与部署

Owner / 支持

AI 运维组 · pilot · active;升级路径:AI 运维组 → 运行平台组

交付策略

embedded · supported;Robot Connector 的兼容组件 ID;只承载企微/飞书连接、消息、身份、媒体和回复回执。

配置

企微/飞书应用、回调或长连接、限流和 SecretRef。

部署

嵌入 Robot Release Bundle,与 Robot Dispatcher / Queue / Outbox 通过标准渠道信封连接。

健康检查

三种渠道 Provider 的入站/出站契约、最小往返、媒体信封、投递重试和 Connector→Worker→reply 已有 devbox deployed-contract;企微官方长连接与飞书成熟使用事实已通过可核验 existing-evidence 与当前部署证据合并验收。

可观测性

tenant/conversation/message/trace、投递状态与 auditRef,不记录 Secret 和默认消息正文;标准媒体信封不暴露宿主机绝对路径。

升级与回滚

按渠道 Provider 版本回退,不改变 Robot Job/会话。

依据

architecture/audits/project-capability-runtime-closure-2026-08-30.md · architecture/evidence/AI-OCI-GOV014-20260830-R1.json · architecture/audits/oci-distribution-provider-closure-2026-08-30.md · architecture/schemas/robot-connector.schema.json · apps/robot/src/flynor_robot/robot_connector.py · apps/robot/src/flynor_robot/listener.py · apps/robot/src/flynor_robot/dispatcher.py · apps/robot/src/flynor_robot/qiyeweix.py · apps/robot/src/flynor_robot/qiyeweix_long.py · apps/robot/src/flynor_robot/feishu.py · apps/robot/tests/test_robot_connector.py · apps/robot/tests/test_dispatcher.py · apps/robot/tests/test_qiyeweix.py · apps/robot/tests/test_qiyeweix_long.py · architecture/audits/robot-connector-governance-2026-08-26.md