Back to directory

ax-feishu-bridge

Curated pickMaintenance: Active

ax1202/ax-feishu-bridge

飞书/Lark 机器人消息桥接,扫码或凭据接入,私聊/群聊/话题独立会话、流式回复与聊天内命令,同时支持 Pi 与 DSH 双平台

View on GitHub
$ dsh plugin --profile web add ax-feishu-bridge --ignore-scripts

50

stars

33

forks

TypeScript

Language

2026-05-25

Created

2026-08-27

Last push

An unlicensed (no LICENSE declared) TypeScript message-bridge plugin that turns Feishu / Lark into a remote front-end for your local DeepSeek Harness / Pi coding agent, with QR onboarding, streaming cards, group strategies and a persistent background service.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-09-01

License

Not specified by the author

01What can it help you accomplish?

  • Chat with your local DeepSeek Harness / Pi coding agent from anywhere inside Feishu / Lark

    A persistent bridge that forwards messages to the local agent and streams replies back into Feishu / Lark chats (DMs, groups, and topics each keep an independent session)

    Developers and teams who run DeepSeek Harness (dsh) or Pi locally and want to drive them remotely from a familiar chat UI

  • Trigger the agent from group chats and keep multi-turn context without switching apps

    Keyword-triggered replies, follow-ups on bot messages, interactive alert-card parsing, and in-chat commands (/new, /model, /thinking, /stop, /workspace, /status, /config)

    Teams that collaborate in Feishu / Lark groups and want the agent to participate in ongoing discussions

02How to install into DeepSeek Harness

Prerequisites

  • Local DeepSeek Harness (dsh) installed — the README states "本机已安装 dsh" as a prerequisite
  • A Feishu / Lark app: create one by QR scan, or bring your own App ID and App Secret
  • For the `open` group strategy, enable the bot's "获取群组中所有消息" permission in the Feishu developer console

Installation steps

  1. 01

    Install from npm: `dsh plugin --profile web add ax-feishu-bridge --ignore-scripts`

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

  2. 02

    Restart dsh; if no Feishu bot config is detected, the terminal setup wizard launches automatically — choose "扫码自动创建飞书助手" and scan the QR code, or manually enter App ID and App Secret

  3. 03

    After config, the bridge auto-starts and connects to Feishu / Lark; it reconnects automatically every time dsh launches

Verify the integration

  • In Feishu / Lark, send a DM to the bot and confirm a reply streams back in the same card
  • Run the DSH `/feishu status` management command to confirm the bridge is connected
  • Check that `~/.dsh/feishu/config.harness.json` exists (DSH uses its own isolated config under the dsh home directory)

Rollback

  • Run `dsh plugin --profile web remove ax-feishu-bridge` to remove the plugin (the README documents the `add` form but not an explicit uninstall; this is the inverse dsh plugin CLI command)

03DSH integration and capability boundaries

DSH integrationNative runtime

Distributed as a DeepSeek Harness bundle; install via `dsh plugin --profile web add ax-feishu-bridge`, then QR-code or manual App ID/Secret config; auto-starts and auto-connects on dsh launch

  • Feishu / Lark bot onboarding via QR scan

    a Feishu / Lark account, or an existing App ID and App Secret→a configured bot connected to the local DSH / Pi agent

    writes the bot config to `~/.dsh/feishu/config.harness.json` under the dsh home directorystarts a background service that keeps the bridge alive even after the Pi agent is closed
  • Streaming chat with in-chat commands

    text, images, code files and text attachments (image recognition depends on the current model)→Markdown-rendered replies streamed into the same Feishu card; in-chat commands /new, /resume, /model, /thinking, /stop, /workspace, /status, /config

  • Group chat strategy & interactive card parsing

    group messages, topic threads, and Feishu interactive alert cards→per-strategy replies (open / mention) and the original content forwarded to the agent

04Who is it for? When not to use it?

Good for

  • Developers and teams who run DeepSeek Harness (dsh) or Pi locally and want to drive them remotely from a familiar chat UI
  • Teams that collaborate in Feishu / Lark groups and want the agent to participate in ongoing discussions

Not for

  • With the group strategy set to `open`, the bot only replies to all group messages without an @ after you also enable "获取群组中所有消息" (or "获取群组中用户和机器人发送的消息") in the Feishu developer console — otherwise only @-mentions trigger replies.

05Compatibility, maintenance and safety notes

  • With the group strategy set to `open`, the bot only replies to all group messages without an @ after you also enable "获取群组中所有消息" (or "获取群组中用户和机器人发送的消息") in the Feishu developer console — otherwise only @-mentions trigger replies.
  • DSH uses its own isolated config at `~/.dsh/feishu/config.harness.json`; it does not share state with the Pi plugin, and both can be installed and run side by side.
  • Image recognition for attachments depends on whether the current model supports images; the bridge itself does not guarantee image understanding.
2026-05-252026-08-27v0.4.9

No license declared (license: null) · actively maintained, latest release v0.4.9 published 2026-08-27

06Frequently asked questions

How do I install ax-feishu-bridge for DeepSeek Harness?

Install from npm with `dsh plugin --profile web add ax-feishu-bridge --ignore-scripts`, restart dsh, and follow the terminal setup wizard — choose QR-code auto-creation or enter your own App ID and App Secret. The bridge then auto-connects on every dsh launch.

Does it work with both DSH and Pi?

Yes. The extension is distributed as a DeepSeek Harness bundle and also supports Pi; DSH uses its own isolated config at `~/.dsh/feishu/config.harness.json` so the two can coexist.

What chat commands are available inside Feishu?

DMs, groups and topics each keep an independent session. You can use /new, /resume, /model, /thinking, /stop, /workspace, /status and /config, plus the DSH `/feishu` management commands (setup / status / autostart / debug / reset).

08Data and sources

  • Author-claimedgithub.comaf56acbb1d4c…

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

  • Author-claimedgithub.comaf56acbb1d4c…

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

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-09-01. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

AD

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.