ax-feishu-bridge

支持 Deepseek Harness/Pi 接入 飞书/Lark 的消息桥接扩展：在熟悉的聊天界面里与本机 DSH/Pi 持续协作。

<b>中文</b> · <a href="./README_EN.md">English</a>

DSH、Pi飞书交流反馈群：https://applink.feishu.cn/client/chat/chatter/add_by_link?link_token=57dvecbb-95d3-4d01-b689-6ebc3d17c867

扩展有什么问题可以加群反馈。

我的媒体平台 关注我第一时间了解最新AI工具

全平台账号名称：AX阿煊

B站：https://space.bilibili.com/4489397

主要能力

• 通过扫码快速创建飞书/Lark 机器人，减少手动配置
• 支持私聊、群聊、群话题分别维护独立的 Pi 会话
• 支持群聊策略：
  • open：群里和话题里可直接回复，不需要 @，还需手动在飞书开发者后台开启机器人“获取群组中所有消息”的权限
  • mention：只有 @ 机器人、命中关键词或回复机器人消息时才会回复（后两项可选开启）
• 支持图片、代码文件和文本文件等附件输入；图片识别取决于当前模型是否支持图片
• 支持解析飞书 interactive 告警卡片；回复一条消息或卡片时，可把原内容一并带给 Pi
• 支持群聊关键词触发、回复机器人消息继续追问
• 支持在飞书内切换当前会话的模型、工作区、历史会话和思考强度
• 收到消息后立即显示“正在回复…”，后续答案在同一张卡片中流式输出；可停止，并会显示完成或失败状态
• 支持渲染显示 Markdown 格式内容
• Pi agent 关闭后，仍有后台常驻服务可以对话，pi agent无需前台运行。

<br />

---

快速开始

下面的快速开始先介绍 DeepSeek Harness（DSH），Pi 用户可直接跳到 Pi 快速开始。

<a id="dsh-quick-start"></a>

DeepSeek Harness（DSH）

本扩展同时以 DeepSeek Harness 组合包（bundle）形式分发，飞书机器人的配置和聊天体验与 Pi 一致。

1. 安装

前提：本机已安装 dsh

从 npm 安装

dsh plugin --profile web add ax-feishu-bridge --ignore-scripts

2. 启动与首次配置

安装后重启dsh,如果没有检测到飞书机器人配置，会自动进入终端配置向导：推荐选择“扫码自动创建飞书助手”，按提示扫描终端里的二维码即可；如果你已经有现成的飞书/Lark 应用，也可以选择手动填写 App ID 和 App Secret。

配置完成后桥接会自动启动并连上飞书/Lark，之后每次启动 dsh 也会自动连接。

DSH 使用独立的配置文件 ~/.dsh/feishu/config.harness.json（存放在 dsh 自己的家目录下），与 Pi 的配置互不干扰，两边可以同时安装、共存。

3. 在飞书里互动

• 私聊：直接发消息
• 群聊：根据群聊策略决定是否需要 @ 机器人
• 话题：每个话题会独立对应一个会话

群聊策略设为open后，想要不@机器人就能回复任何群内消息，还需要到飞书开发者后台 - 对应机器人事件与回调 - 打开“获取群组中所有消息”或“获取群组中用户和机器人发送的消息”这两个任意一个权限。

/new、/resume、/model、/thinking、/stop、/workspace、/status、/config 等聊天内命令同样可用，完整列表见下文“飞书里怎么用”。

两点区别需要注意：

• DSH 的 /feishu 管理命令是精简版：提供 setup / status / autostart / debug / reset，没有 start / stop / restart——桥接随 dsh 自动启停，由配置里的 autoStart 控制。
• DSH 的环境变量前缀是 HARNESS_（例如 HARNESS_APP_ID），而不是 Pi 的 FEISHU_；卡片回调端口默认也不同——Pi 默认 3001，DSH 默认 3002，两边同时启用也不会冲突。

<a id="pi-quick-start"></a>

Pi

1. 安装

pi install npm:ax-feishu-bridge

也可以从 Git 安装：

pi install git:github.com/AX1202/ax-feishu-bridge

2. 初始化配置

在 Pi 里运行：

/feishu setup

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

如果你已经有现成的飞书/Lark 应用，也可以选择手动填写 App ID 和 App Secret。

3. 启动桥接

/feishu start

如果开启了自动启动，Pi 会话启动时会自动连上飞书/Lark。

4. 开始聊天

在飞书/Lark 里打开机器人，直接发消息即可。

• 私聊：直接发消息
• 群聊：根据群聊策略决定是否需要 @ 机器人
• 话题：每个话题会独立对应一个 Pi 会话

群聊策略设为open后，想要不@机器人就能回复任何群内消息，还需要到飞书开发者后台 - 对应机器人事件与回调 - 打开“获取群组中所有消息”或“获取群组中用户和机器人发送的消息”这两个任意一个权限。

---

Windows 上运行 Pi Agent 飞书插件配置方法

解决方法

1. 先安装 Git for Windows

安装后一般会有这个文件：

C:\Program Files\Git\bin\bash.exe

这个就是 Windows 上给 Pi 使用的 Bash 环境。

---

2. 配置 Pi 的 settings.json

打开：

C:\Users\你的用户名\.pi\agent\settings.json

在大括号里加这一行：

"shellPath": "C:\\Program Files\\Git\\bin\\bash.exe"

注意：如果你原来文件里还有其他配置，不要删掉，只加这一行即可。

这个配置主要是告诉 Pi 主程序 使用哪个 Bash。

---

3. 把 Git Bash 加到 Windows PATH

有些插件会直接调用：

bash

它不一定读取 Pi 的 shellPath 配置，所以还需要把 Git Bash 加到系统 PATH。

在 PowerShell 里执行：

[Environment]::SetEnvironmentVariable(
  "Path",
  [Environment]::GetEnvironmentVariable("Path", "User") + ";C:\Program Files\Git\bin",
  "User"
)

---

4. 重启 PowerShell

执行完上面的命令后，要关闭 PowerShell，再重新打开。

然后验证：

where.exe bash

如果输出：

C:\Program Files\Git\bin\bash.exe

说明修复成功。

---

5. 再运行 Pi

pi

---

…