用途:在本地运行桥接进程,把飞书机器人收到的消息转发到 ThinkFleet Gateway,再由 AI 智能体处理并回复。架构为:飞书用户→飞书云←WS→bridge.mjs(本地)←WS→ThinkFleet Gateway→AI 智能体。飞书 SDK 采用出站连接,无需入站端口或公网 IP;桥接器使用已有 gateway token 认证;每个飞书会话映射为 ThinkFleet 会话(feishu:<chatId>)。
主要能力:支持私聊与群聊;群聊中仅在用户 @ 机器人、消息以 ?/?结尾、包含请求动词(帮/请/分析/总结等)或直呼机器人名称时才回复,可在 bridge.mjs 的 shouldRespondInGroup() 中自定义名称列表。
使用方式:先在 open.feishu.cn/app 创建自建应用并添加机器人能力,启用 im:message、im:message.group_at_msg、im:message.p2p_msg 权限,添加 im.message.receive_v1 事件并设为 WebSocket 长连接,发布应用后记录 App ID 与 App Secret。将密钥写入 ~/.thinkfleet/secrets/feishu_app_secret 并 chmod 600。进入 skill 目录执行 npm install,然后以 FEISHU_APP_ID=cli_xxx node bridge.mjs 启动。macOS 可用 FEISHU_APP_ID=cli_xxx node setup-service.mjs 配合 launchctl 设置自启。
诊断:launchctl list | grep feishu 查看服务,tail -f ~/.thinkfleet/logs/feishu-bridge.err.log 查看日志,launchctl unload 对应 plist 停止服务。
环境变量:FEISHU_APP_ID 必填;FEISHU_APP_SECRET_PATH 默认 ~/.thinkfleet/secrets/feishu_app_secret;THINKFLEET_CONFIG_PATH 默认 ~/.thinkfleet/thinkfleet.json;THINKFLEET_AGENT_ID 默认 main;FEISHU_THINKING_THRESHOLD_MS 默认 2500。
限制:需要本地 Node 环境与飞书自建应用权限审批;具体网关部署与计费信息暂未提供。