Back to directory

dsh-lark-bot

Curated pickMaintenance: Active

plutokeating/dsh-lark-bot

Feishu/Lark bridge for DeepSeek Harness: scan-to-connect PersonalAgent binding, streaming cards, git-worktree project workspaces, parallel per-scope tasks, multi-role agents, cross-session notify, in-chat model/key management, and a safety-net guardian that still answers in Feishu after dsh crashes.

View on GitHubHomepage
$ npx dsh-lark-bot@latest setup --profile dsh-lark

41

stars

8

forks

TypeScript

Language

AGPL-3.0

License

2026-08-13

Created

2026-08-25

Last push

A native DeepSeek Harness bridge bot for Feishu/Lark — scan-to-connect, stream coding tasks into group/DM chat, and keep answering even when dsh crashes. No public server needed; AGPL-3.0.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-09-04

License

AGPL-3.0

01What can it help you accomplish?

  • Drive your local DeepSeek Harness coding agent from Feishu/Lark — phone, group chat, or topic — without a public IP, domain, or server.

    Feishu/Lark messages that run coding tasks, with streaming progress cards, isolated git-worktree project workspaces, and parallel per-scope task results.

    DeepSeek Harness users who want to command their local agent remotely from Feishu/Lark on mobile or in group chats.

  • Keep task throughput alive in Feishu/Lark even when DeepSeek Harness crashes, and recover queued jobs automatically.

    The safety-net guardian still replies in Feishu/Lark, queued tasks auto-resume after restart, and `/jobs` can explicitly retry.

    DeepSeek Harness users who need a high-availability bridge that does not drop connectivity when the harness crashes.

02How to install into DeepSeek Harness

Prerequisites

  • DeepSeek Harness (`dsh`) installed locally with `DEEPSEEK_API_KEY` configured
  • Node.js ≥ 22.19
  • A Feishu / Lark account

Installation steps

  1. 01

    Run `npx dsh-lark-bot@latest setup --profile dsh-lark` to install into the dsh profile (the safety-net guardian is installed by default)

    $ npx dsh-lark-bot@latest setup --profile dsh-lark

  2. 02

    Start with `dsh --profile dsh-lark`

    $ dsh --profile dsh-lark

Verify the integration

  • On first start the terminal prints a QR code — scan it with the Feishu app to create/select a PersonalAgent, then message it directly in private chat

03DSH integration and capability boundaries

DSH integrationNative runtime

Installs into a DeepSeek Harness profile as a native plugin (`dsh --profile dsh-lark`) and bridges Feishu/Lark over the official `@deepseek-ai/dsh-sdk-client` / `dsh-acp` adapters (default `sdk` adapter: native resume, streaming, image blocks).

  • Safety-net guardian (self-healing)

    Still replies in Feishu/Lark after dsh crashes; `/safemode` enters a core-only safe mode to self-heal; queued tasks auto-resume after restart, `/jobs` can retry.

  • Parallel multi-task (session isolation)

    Runs multiple tasks concurrently in the same group chat with isolated sessions.

  • Multi-role agents

    `/role` switches or assigns PM / dev / docs roles, each with persona, model preference and rules.

  • In-chat model & key management

    A `/config` card switches provider and hot-reloads keys without leaving Feishu/Lark.

  • Cross-session notify + @mention

    A-group task completion is pushed to B-group / private chat and @mentions you.

  • Per-session git-worktree workspace

    Each session auto-creates an isolated git worktree project workspace; `/session` browses/binds sessions, `/archive` + `/retention` auto-archives and cleans up.

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

Good for

  • DeepSeek Harness users who want to command their local agent remotely from Feishu/Lark on mobile or in group chats.
  • DeepSeek Harness users who need a high-availability bridge that does not drop connectivity when the harness crashes.

Not for

  • Default-deny posture: secret masking, path containment, SSRF protection, rejection of expired events, and interactive tools disabled by default (see SECURITY.md).
  • Validated against DeepSeek Harness 0.1.0-rc.8 (2026-08-25) via the official dsh-sdk-client / dsh-acp; pinned version & upgrade policy in docs/COMPATIBILITY.md.

05Compatibility, maintenance and safety notes

  • Default-deny posture: secret masking, path containment, SSRF protection, rejection of expired events, and interactive tools disabled by default (see SECURITY.md).
  • Bridges Feishu/Lark over an outbound WebSocket long connection — no public IP, domain, server, or intranet penetration needed; works behind NAT.
  • Runtime Node.js ≥ 22.19; platforms Linux / macOS / Windows. Default adapter `sdk` (native resume / streaming / image blocks); can switch to `acp` / `headless` / `web`.
  • Validated against DeepSeek Harness 0.1.0-rc.8 (2026-08-25) via the official dsh-sdk-client / dsh-acp; pinned version & upgrade policy in docs/COMPATIBILITY.md.
2026-08-132026-08-25v0.19.16

AGPL-3.0 · actively maintained (latest release v0.19.16, 2026-08-25)

06Frequently asked questions

How do I connect DeepSeek Harness to Feishu/Lark?

Install Node ≥ 22 and dsh (with DEEPSEEK_API_KEY), then run `npx dsh-lark-bot@latest setup --profile dsh-lark` and `dsh --profile dsh-lark`, then scan the QR code with the Feishu app. Private chat messages go straight to the agent; group/topic messages default to `@bot`.

Do I need a public IP, domain, or server?

No. The bridge uses an outbound Feishu WebSocket long connection, so it works behind NAT — no public server, domain, or intranet penetration required.

What happens if DeepSeek Harness crashes?

The safety-net guardian still replies in Feishu/Lark; `/safemode` enters a core-only safe mode to self-heal, and queued tasks auto-resume after restart. Use `/jobs` to explicitly retry.

Is it open source and how is it licensed?

Yes — GNU AGPL-3.0, self-hostable, free for personal/internal use. Commercial / SaaS / closed-source derivative works need a separate grant. Only the official repo and the `dsh-lark-bot` / `dsh-feishu-bot` npm packages (maintainer `plutokeating`) are genuine; there is no .exe or "download-and-run" build.

08Data and sources

  • Author-claimedgithub.com6e722e0272f3…

    经官方 `@deepseek-ai/dsh-sdk-client` / `dsh-acp` 接入

  • Author-claimedgithub.com6e722e0272f3…

    npx dsh-lark-bot@latest setup --profile dsh-lark

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

🏆

Best DeepSeek Harness Plugins

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

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.