AX1202/ax-feishu-bridge

Name: AX1202/ax-feishu-bridge
Author: AX1202

Plugin插件 Native原生 ⭐ 49 Notifications & Remote通知与远程 Sessions & Context会话与上下文

飞书/Lark 机器人桥接，同时支持 Pi 和 DeepSeek Harness（DSH）双平台，随时随地远程与你的编程助手对话

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

This is a native messaging bridge plugin built for both DeepSeek Harness (DSH) and Pi agent. It connects locally running DSH or Pi instances to Feishu/Lark, allowing users to collaborate continuously with their local AI agent directly inside the Feishu chat interface. It supports quick setup via QR code to automatically create a Feishu robot, cutting down manual configuration steps, and also accepts manual entry of existing Feishu app credentials for advanced users. For DSH users, installation is done via the DSH CLI, and configuration is stored separately from any existing Pi setup on the same machine.

The plugin maintains separate agent sessions for private chats, group chats, and group topics, and supports two configurable group chat policies that let you set whether the bot only replies when it is mentioned. It supports input of attachments including images, code files, and text files, and can parse Feishu interactive alert cards to pass original content to the agent. Users can switch models, workspaces, history sessions, and thinking intensity directly from Feishu, making it ideal for users who need to access local agent results on the go from the Feishu mobile or desktop app.

When running the plugin with Pi agent on Windows, users must pre-install Git for Windows and configure the Bash path in both Pi settings and system PATH. Currently, the plugin does not support system startup auto-run, so users need to manually start the Pi agent service after each system boot. After startup, the plugin can run in the background; even if the main agent window is closed, users can still start new conversations with the agent through Feishu. DSH and Pi configurations are stored separately, so both can be installed on the same machine without conflict.

这是一个专为DeepSeek Harness（DSH）和Pi开发的原生消息桥接插件，支持将本地运行的DSH或Pi代理接入飞书/Lark，让用户可以直接在飞书熟悉的聊天界面内和本地代理持续协作。它支持通过扫码快速创建飞书机器人，大幅减少手动配置步骤，同时也兼容用户使用已有现成飞书应用的手动接入方式。

支持私聊、群聊、群话题分别维护独立的代理会话，支持两种群聊策略，可配置是否需要@机器人才回复，还支持图片、代码文件、文本文件等附件输入，能解析飞书交互告警卡片并将原内容带给代理。用户可在飞书内直接切换会话模型、工作区、历史会话和思考强度，适合需要随时在飞书查看本地代理运行结果的用户。

在Windows平台运行Pi代理时，需要预先安装Git for Windows并配置Bash环境路径，目前未实现开机自启功能，用户需要每次开机后手动启动代理服务。插件启动后支持后台常驻，即使代理关闭前台进程，用户仍可在飞书内发起对话。配置文件分别存储在DSH和Pi的各自数据目录，双方可同时安装互不干扰。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】，检查通过再动手。

插件：ax-feishu-bridge（AX1202/ax-feishu-bridge）
仓库：https://github.com/AX1202/ax-feishu-bridge
本站详情页：https://www.yhbd.top/plugins/ax1202-ax-feishu-bridge/
本站登记：类型 plugin · 归类 原生 DSH 插件 · 许可证未声明 · ⭐ 49 · 最近提交 2026-08-27 · 主语言 TypeScript

按下面顺序执行，每步先把结论告诉我，再进入下一步：

【1 兼容性检查】
① 我这边：DSH 版本、Node 版本、操作系统、当前 profile（web / desktop）。
② 读它的 README、package.json、插件 manifest，列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对，结论只写「满足 / 不满足 / 未知」三种；不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突：命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。

【2 安全性检查】
① 仓库可信度：和上面「本站登记」是否一致；star / fork 数、创建时间、最近提交，是否归档或长期停更。
② 安装脚本：逐行看 package.json 的 preinstall / install / postinstall，以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名，立刻停下来告诉我，不要继续装。
③ 依赖：列出新增依赖，标出无人维护、或与知名包拼写近似的可疑包（typosquatting）。
④ 权限与副作用：它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限（filesystem / network / shell / clipboard 等），以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限，或权限明显超出功能所需，先停下来问我。

【3 安装】
上面两步没有「不满足」和「高危项」时才执行；用官方推荐方式安装，不要自行提权。

【4 汇报】
用表格输出：检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜，也不要替我决定。

Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH：它会先核对兼容性与安全性（逐条给「满足 / 不满足 / 未知」），确认没问题再安装，有高危项会停下来问你。框内可滚动，复制到的是完整提示词；安装命令不一定准确，发给 DSH 更稳。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意

No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」，商用或再分发前先问作者
49 stars - an early-stage project星标 49，属于早期项目

DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时（Electron / Python / Docker 等）是否齐备
Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突：命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致，是否归档或长期停更
Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需（filesystem / network / shell / clipboard）
Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限，以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照，不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装

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

把 AX1202/ax-feishu-bridge 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

16.2 KB · 缓存于 2026-08-23 03:40:56 · 16.2 KB

ax-feishu-bridge

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

中文 · English

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无需前台运行。

快速开始

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

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，两边同时启用也不会冲突。

Pi

1. 安装

pi install npm:ax-feishu-bridge

也可以从 Git 安装：

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

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要，完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

渲染基于仓库 AX1202/ax-feishu-bridge 的 README.md。在 GitHub 查看原文 →