@ryanchan720/pi-feishu-lark

Enhanced Feishu/Lark bridge for Pi — session browser, resume, streaming, and more. Fork of AX1202/pi-feishu-lark.

Packages

Package details

extension

Install @ryanchan720/pi-feishu-lark from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:@ryanchan720/pi-feishu-lark
Package
@ryanchan720/pi-feishu-lark
Version
0.3.1
Published
Jun 1, 2026
Downloads
not available
Author
ryanchan720
License
MIT
Types
extension
Size
156.7 KB
Dependencies
2 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./.pi/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

飞书/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