飞书通灵
把正在运行的 Paseo agent 接到飞书机器人上,在手机上继续和它对话。
飞书通灵把一个正在运行的 Paseo agent 接到飞书机器人上,离开电脑后可以在手机上继续对话。打开一个 agent,在命令面板(⌘K)里选「通灵到飞书 (Feishu séance)」,机器人会在飞书里确认,该 agent 的输入框上方出现「通灵中」胶囊。点击胶囊即可归位;归档这个 agent,或对另一个 agent 发起通灵,也会归位。
通灵期间,每个完成的 turn 都会以 Markdown 卡片发到飞书。权限请求和失败的 turn 会作为通知推送,但审批权限仍需在 Paseo 里完成。你发给机器人的文字、图片和富文本消息会作为 prompt 发给 agent。turn 进行中收到的消息会打断当前 turn,和在 Paseo 里直接输入一样。发送 /status 可以查看当前通灵状态。
使用前需要一个飞书企业自建应用。在飞书开放平台开发者后台创建企业自建应用,添加机器人能力,开通 im:message 和 im:message:send_as_bot 权限,事件订阅选择「使用长连接接收事件」并订阅 im.message.receive_v1,然后创建并发布版本。发布可能需要租户管理员审批。最后在飞书里打开与机器人的私聊,随便发一条消息。
然后创建 ~/.paseo/feishu-seance.config.json,填写 appId、appSecret、chatId(接收回复的私聊)和 allowedChatIds(允许发 prompt 的会话,默认只有 chatId)。飞书客户端不显示会话 id:先在 chatId 里随便填一个占位值,重载插件,发起一次通灵,再给机器人发条消息,再从插件日志里被拒绝的会话记录中读出真正的 oc_...。也可以用环境变量 FEISHU_SEANCE_CONFIG 指定其他路径。没有配置时插件进入 dry-run 模式,出站消息只写进插件日志。
这个机器人是通往你电脑的远程 prompt 通道:任何能在允许的会话里发消息的人,都能以该 agent 的权限驱动它。所以 allowedChatIds 只放你自己的私聊。App Secret 只保存在 daemon 端。插件只与飞书开放平台通信:把 agent 回复和通知发过去;你发来的图片会下载到临时文件,转发后立即删除。当前通灵状态保存在配置文件同目录的 feishu-seance.state.json 中,daemon 重启后仍会保留。
飞书长连接只在通灵期间保持,所以没有通灵时发的消息不会有回复。多台 daemon 共用一个机器人时,飞书会把每条消息随机投递给其中一条连接,所以要先在一台上归位,再到另一台上通灵。插件重载或 daemon 重启后、重新连上之前完成的 turn 不会推送。飞书可能重投未确认的消息,插件暂时不做去重。工具调用只计数不展示,超长回复也不会拆分。



