pi-feishu-lark

飞书/Lark 桥接插件 for Pi，支持消息收发、会话管理、流式回复等功能。

Fork from AX1202/pi-feishu-lark。

新增功能

• 流式回复：AI 回复实时流式输出到飞书
• 会话管理：/sessions 浏览历史（卡片表格，含首条/尾条/轮次/上下文/时间），/session N 查看详情，/resume N 恢复历史会话，/name xxx 命名
• 上下文感知：/status 查看当前模型、工作目录、上下文占比及 Token 用量
• 模型切换：/model 在飞书内直接切换模型
• 进程管理：/restart 在飞书内重启桥接守护进程
• 命令帮助：/commands 列出所有可用命令

快速开始

1. 安装

npm i -g @ryanchan720/pi-feishu-lark
pi install npm:@ryanchan720/pi-feishu-lark

2. 初始化

在 Pi 里运行：

/feishu setup

推荐选择"扫码自动创建飞书助手"，按提示扫描终端里的二维码。

3. 启动

/feishu start

启动后 Pi agent 可以关闭，后台常驻服务会继续处理飞书消息。

飞书里支持的命令

命令	作用
/new	新建 Pi 会话
/sessions	浏览历史会话（表格卡片）
/session N	查看指定会话的预览内容
/resume N	切换到指定历史会话
/name xxx	给当前会话起名
/model	切换模型
/status	查看上下文占比、模型、目录
/stop	停止当前回复
/restart	重启飞书桥接守护进程
/commands	显示所有命令

Pi 里怎么管理

命令	作用
/feishu setup	初始化配置
/feishu start	启动飞书桥接
/feishu stop	停止飞书桥接
/feishu restart	重启并重新加载代码和配置
/feishu status	查看连接状态和配置
/feishu autostart	开关自动启动
/feishu debug	查看最近 20 条调试日志
/feishu reset	清除配置和映射（保留会话历史）

配置

配置文件：~/.pi/agent/feishu/config.json

环境变量：

变量	说明
FEISHU_APP_ID	飞书/Lark 应用 ID
FEISHU_APP_SECRET	飞书/Lark 应用密钥
FEISHU_DOMAIN	feishu 或 lark，默认 feishu
FEISHU_GROUP_POLICY	open 或 mention，默认 open
FEISHU_LANGUAGE	zh 或 en
FEISHU_AUTO_START	1 或 0

存哪些文件

路径	内容
~/.pi/agent/feishu/config.json	凭证和配置
~/.pi/agent/feishu/state.json	飞书- Pi 会话映射
~/.pi/agent/feishu/bridge.json	Pi 任务路由
~/.pi/agent/feishu/debug.log	调试日志
~/.pi/agent/sessions/	每个飞书会话对应的 Pi 会话文件

常见问题

机器人不回复？

• 飞书机器人是否已创建并配置好
• /feishu start 是否已运行
• 群聊策略是否要求 @ 机器人

群聊里不生效？

open 模式下还需在飞书开发者后台手动开启机器人"获取群组中所有消息"权限。

License

MIT · Fork from AX1202/pi-feishu-lark