2026-03-23-飞书WebSocket长连接上线.md

协调日志：飞书WebSocket长连接上线

日期: 2026-03-23 窗口: 本窗口 William在线: 全程参与（飞书开放平台配置）

一、核心成果

飞书模式2从webhook切换到WebSocket长连接，端到端验证通过。

William在飞书发"你好" → WebSocket收到 → stream_chat(MiniMax M2.5)回复 → 飞书收到回复。全链路约15秒。

二、技术方案变更

原方案（Webhook）	新方案（WebSocket）
需要公网URL	不需要
需要challenge验证	不需要
需要Tailscale Funnel/Nginx反代	不需要
需要防火墙/安全组放行	不需要
飞书→公网→本地Flask	飞书←→SDK长连接←→本地处理

切换原因： 1. Tailscale Funnel的.ts.net域名飞书服务器（中国大陆）无法在3秒内访问 2. 硅谷服务器43.162.98.174的80端口被腾讯云安全组拦截 3. WebSocket方案零配置，SDK自动重连，是飞书官方推荐的开发模式

三、新建文件

文件	说明
`feishu_ws_client.py`	WebSocket长连接客户端（~350行），独立运行或Flask集成

四、飞书开放平台配置（William操作）

新应用: cli_a94a641e73f99cc9（替代旧应用cli_a93ddf54eefa5bd2）
权限: im:message + im:message:send_as_bot + 群消息等8项权限已开通
事件订阅: im.message.receive_v1 已添加
可用范围: 深圳鲲腾产业服务（测试企业，5人以内免审核）
版本: 已发布上线

五、当前限制（William已知悉）

飞书Coco是MiniMax M2.5驱动的轻量聊天机器人，能聊天但不能干活： - ❌ 不能读写文件 - ❌ 不能访问task_registry - ❌ 不能派发任务/组织Agent - ❌ 不能执行代码

需要D9（工具层接入）才能让飞书Coco真正有用。

六、D板块更新后状态

ID	任务	状态
D1	feishu_bp.py改造	✅ Day1完成
D2	challenge验证	✅ WebSocket替代，不再需要
D3	卡片构建器	✅ Day1完成
D4	Funnel自启	✅ WebSocket替代，不再需要
D5	微信适配器	⬜ P2
D6	端到端验证	✅ 本窗口验证通过
D7	WebSocket客户端	✅ 本窗口新建+验证
D8	WS LaunchAgent	⬜ 待做
D9	飞书Coco工具层	⬜ 待做

D板块：6/9完成 = 67%

七、HiveOS V2.0整体进度

板块	完成率	状态
A.内核	100%	✅
B.多租户	100%	✅
C.模式1	100%	✅
D.模式2	67%	本窗口推进
E.模式3	60%	需第二台Mac
F.模式4	89%	需火山方舟账号
G.管理后台	100%	✅
H.蜂巢3D	100%	✅
I.演示	100%	✅
J.安全	100%	✅
总计	93%（54/58）	剩余4项

剩余4项：D5微信适配(P2) / D8 WS LaunchAgent / D9飞书工具层 / F6 BYOL适配器