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
- 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
- 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
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.
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.
07Related DSH workflows
dsh-notification
by omdsh-dev
Desktop notifications for DeepSeek Harness turn completions, with per-outcome controls and include/exclude keyword rules.
dsh-session-notification
by dingyi222666
Notifications for four session states, with browser alerts and prompts.
dsh-chatgpt-web
by wlv-zedd
DSH ChatGPT Free bridges standard ChatGPT Web directly into DeepSeek Harness
dsh-open-in-vscode
by omdsh-dev
Open DeepSeek Harness workspace directories in VS Code directly from the web GUI.
08Data and sources
经官方 `@deepseek-ai/dsh-sdk-client` / `dsh-acp` 接入
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.
