pi-feishu-lark
Feishu/Lark bridge for Pi coding agent — chat with Pi from Feishu or Lark
Package details
Install pi-feishu-lark from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:pi-feishu-lark- Package
pi-feishu-lark- Version
0.1.4- Published
- May 26, 2026
- Downloads
- 364/mo · 364/wk
- Author
- ax1202
- License
- MIT
- Types
- extension
- Size
- 124 KB
- Dependencies
- 2 dependencies · 2 peers
Pi manifest JSON
{
"extensions": [
"./extensions/feishu/index.ts"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
pi-feishu-lark
目前功能最强，最易用的 Pi 连接 飞书/Lark 的扩展包！！
我的媒体平台 关注我第一时间了解最新AI工具
全平台账号名称：AX阿煊
B站：https://space.bilibili.com/4489397
小红书号：269094344
抖音号：191531443
主要能力
- 通过扫码快速创建飞书/Lark 机器人，减少手动配置
- 支持私聊、群聊、群话题分别维护独立的 Pi 会话
- 支持群聊策略：
open：群里和话题里可直接回复，不需要 @，还需手动在飞书开发者后台开启机器人“获取群组中所有消息”的权限mention：只有@机器人时才回复
- 支持图片、代码文件、文本文件等附件发送
- 支持飞书内切换对话模型
- 支持显示实时 Pi 任务执行状态
- 支持渲染显示 Markdown 格式内容
- Pi agent 关闭后，仍有后台常驻服务可以对话，pi agent无需前台运行。
快速开始
1. 安装
pi install npm:pi-feishu-lark
也可以从 Git 安装：
pi install git:github.com/AX1202/pi-feishu-lark
2. 初始化配置
在 Pi 里运行：
/feishu setup
推荐选择“扫码自动创建飞书助手”，按提示扫描终端里的二维码即可。
如果你已经有现成的飞书/Lark 应用，也可以选择手动填写 App ID 和 App Secret。
3. 启动桥接
/feishu start
如果开启了自动启动，Pi 会话启动时会自动连上飞书/Lark。
4. 开始聊天
在飞书/Lark 里打开机器人，直接发消息即可。
- 私聊：直接发消息
- 群聊：根据群聊策略决定是否需要
@机器人 - 话题：每个话题会独立对应一个 Pi 会话
飞书里怎么用
发送给机器人的常用命令：
| 命令 | 作用 |
|---|---|
/new |
为当前会话新建一个 Pi 会话 |
/model |
打开模型选择卡片，切换当前会话使用的模型 |
/stop |
停止当前这条回复的处理 |
Pi 里怎么管理
| 命令 | 作用 |
|---|---|
/feishu setup |
打开初始化配置 |
/feishu start |
启动飞书桥接 |
/feishu stop |
停止飞书桥接 |
/feishu restart |
重启桥接，并重新加载最新代码和配置 |
/feishu status |
查看连接状态、当前 owner 和配置 |
/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_REACT_EMOJI |
收到消息时的表情回应，默认 THUMBSUP |
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/locks.json |
当前飞书连接的 owner 锁 |
~/.pi/agent/sessions/ |
每个飞书会话对应的 Pi 会话文件 |
常见说明
- 图片能不能被识别，取决于当前选中的模型是否支持图片输入。
/feishu reset只会清掉配置和映射，不会删除会话历史。- 从 TUI、CLI 或其他渠道创建的任务，不会主动发到飞书。
常见问题
为什么机器人没回复？
先看三件事：
- 飞书机器人是否已经创建并配置好
/feishu start是否已经运行- 群聊策略是否要求
@机器人
为什么我在群里发了消息，机器人没有理我？
如果你把群聊策略设成了 mention，就需要 @ 机器人后它才会回复。open模式下：群里和话题里可直接回复，不需要 @，但还需手动在飞书开发者后台开启机器人“获取群组中所有消息”权限才能生效。