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