dsh-feishu — Feishu (Lark) IM bridge for DeepSeek Harness

Pluggable cordis plugin wiring a Feishu self-built bot into a running DeepSeek Harness (dsh) web profile — installable via dsh plugin add.

┌────────┐   WS    ┌──────────────┐   cordis    ┌──────────┐    LLM    ┌──────────┐
│ Feishu │ ──────> │  this plugin │ ──────────> │ dsh agent │ ────────> │ DeepSeek │
│  IM    │ `).
- Multi-turn conversations across reconnects.
- Streams assistant replies back into Feishu, chunked at 4000 chars.
- Filters DeepSeek `` tool-call markers from outbound text.
- Pure ESM, no TypeScript compile step.
- No telemetry, fully local.

## Installation

### 1. Install dsh

```bash
npm install -g @deepseek-ai/dsh
dsh web --help

2. Install the plugin

dsh plugin add dsh-feishu

This installs the plugin into ~/.dsh/profiles/web/node_modules/dsh-feishu and patches cordis.patch.yml automatically.

3. Configure your Feishu app

Create a Custom App at and copy appId + appSecret.

Under Event Subscriptions (事件与回调):

• Set mode to Receive events via persistent connection (使用长连接接收事件/回调).
• Add the event im.message.receive_v1.

Under Permissions (权限), grant:

• im:message
• im:message.p2p_msg (required for DMs)

Publish a version (发布版本) — without this the bot cannot receive events. Wait ~2 minutes after publishing.

4. Export env vars and run

export DEEPSEEK_API_KEY="sk-..."
export FEISHU_APP_ID="cli_..."
export FEISHU_APP_SECRET="..."

dsh web

You should see in logs:

[feishu] WebSocket started (appId=cli_xxx)
[feishu] FeishuBridgeService initialized

DM the bot anything — the agent will reply in the same conversation.

Environment variables

Variable	Required	Default	Notes
DEEPSEEK_API_KEY	yes (LLM)	—
DEEPSEEK_BASE_URL	no	https://api.deepseek.com	For proxies
FEISHU_APP_ID	yes	—	cli_xxx from app console
FEISHU_APP_SECRET	yes	—	From app console — never commit

How a message flows

1. User DMs the bot.
2. Feishu SDK fires im.message.receive_v1 → this plugin.
3. Plugin loads/creates the agent for feishu:.
4. Plugin calls agent.followup(userMessage).
5. When agent returns to idle, plugin reads agent.session.events, strips DSML noise, and posts the reply via larkClient.im.message.create(...).

Limitations

• Text only. Image / file / card / post messages are not handled.
• No streaming. Reply sent after turn completes.
• No groups yet. DMs only.

License

MIT.

Author

itr-del — 13918029394@163.com

Built while integrating dsh with a self-hosted Feishu bot on Ubuntu 22.04.

📖 Open-sourcing story: PUBLISHING.md — how this repo got published and listed.

中文文档见 README.zh.md。