shrekcg/dsh-im-channel

---

Introduction

DSH ↔ IM Channel is a unified multi-channel plugin that connects DeepSeek Harness (DSH, an AI agent runtime) to multiple IM platforms (Feishu, DingTalk, Telegram, Slack, Discord, QQ...). It gives your AI assistant a "first-class app" experience inside Feishu:

• 💬 Persistent conversations: cross-message context memory, topic isolation, group & DM chat
• ⌨️ True streaming output: token-by-token display with a smooth typewriter effect
• 🛠️ 40 Feishu object tools: the agent can operate docs, sheets, calendar, tasks, mail, and more
• 🧩 Pluggable plugin form: no changes to the DSH core; one-click install / uninstall

Aligned with the capabilities of the OpenClaw Feishu plugin, but built on the DSH ecosystem.

---

✨ Features

🌐 Supported Channels

⚠️ Honest status: Feishu and Telegram are fully stable (bidirectional). DingTalk/Slack/Discord are experimental/partial (see below). QQ/WeChat/WhatsApp adapters are not provided in this version.

Send /channels in Feishu to see all channels and setup steps, or /channels add <channel> for a guide.

💬 Conversation

📎 Messaging

🛠️ Feishu Object Tools (MCP × 40)

Exposes 40 Feishu tools via Model Context Protocol, callable natively as mcp__feishu__*:

🧩 Platform

⌨️ Slash Commands

Type commands directly in Feishu chat (instant response, no AI call consumed):

---

📦 Quick Start

Prerequisites

Install

# 1. Clone
git clone https://github.com/shrekcg/dsh-im-channel.git
cd dsh-im-channel

# 2. Install dependencies
npm install

# 3. Setup wizard (app creation / auth / event subscription, step by step)
npm run setup

# 4. Install as plugin + launchd service
npm run install-bridge

# 5. Verify
npm run doctor        # diagnostics (21 checks)
npm run features      # feature checklist

See docs/SETUP.md and docs/INSTALL.md for details.

---

🔧 Configuration

Configure via environment variables or config.json (see config.example.json):

---

🚀 Usage

Chat

• DM: message the bot directly in Feishu
• Group: add the bot to a group, then chat (with or without @, depending on config)
• Thread: create a thread on a group message for an isolated context

Feishu Tools

Just ask in natural language:

• "What's on my calendar today?"
• "Create a doc with the content ..."
• "Send a message to XX"
• "List my to-do tasks"

Management Commands

npm start                # start the bridge
# Status page: open http://127.0.0.1:8899 (Feishu online status / account / health)
npm run setup            # setup wizard
npm run doctor           # diagnostics (--fix auto-repair)
npm run features         # feature checklist
npm test                 # run tests (65 cases)
npm run install-bridge   # install plugin + launchd service
npm run uninstall-bridge # uninstall (reversible, no DSH core impact)
npm run mcp              # run MCP server standalone

---

🏗️ Architecture

┌──────────────────────────────────────────────────┐
│                     Feishu / Lark                 │
│   DM · Group · Thread · Reaction · Comment · Card │
└───────────────────────┬──────────────────────────┘
                        │ WebSocket long-connection (SDK)
┌───────────────────────▼──────────────────────────┐
│               bridge (daemon process)            │
│  ┌─────────┐ ┌────────────┐ ┌─────────────────┐  │
│  │ channel │ │  inbound   │ │    outbound     │  │
│  │ (SDK)   │ │ policy     │ │ stream (true)   │  │
│  │         │ │ media      │ │ mention (@)     │  │
│  │         │ │ reaction   │ │ footer (elapsed)│  │
│  │         │ │ merge-fw   │ │                 │  │
│  └────┬────┘ └─────┬──────┘ └────────┬────────┘  │
│       └────────────┼─────────────────┘           │
└────────────────────┼─────────────────────────────┘
                     │ DSH headless (persistent session)
              ┌──────▼──────┐
              │  agents.resume│
              │  + MCP client │
              └──────┬──────┘
                     │ mcp__feishu__* (40 tools)
              ┌──────▼──────┐
              │ Feishu MCP  │
              │ server      │
              └──────┬──────┘
                     │ lark-cli
              ┌──────▼──────┐
              │  Feishu OpenAPI│
              └─────────────┘

• Receive: @larksuite/channel SDK WebSocket long-connection (no public callback URL needed)
• Session: fixed session + DSH agents.resume (cross-message memory)
• Tools: 40 MCP tools with lark-cli execution backend

See docs/ARCHITECTURE.md for details.

---

📁 Project Structure

dsh-im-channel/
├── src/
│   ├── index.js              # entry (multi-account message pipeline)
│   ├── config.js             # configuration
│   ├── channel.js            # Feishu channel (SDK + streaming)
│   ├── session.js            # persistent sessions + mutex lock
│   ├── core/
│   │   ├── scope-manager.js  # permission management
│   │   ├── adaptive.js       # adaptive streaming step
│   │   └── pacing.js         # streaming pacing control
│   ├── inbound/
│   │   ├── policy.js         # group policy / bot / @
│   │   ├── media.js          # media receive
│   │   ├── reaction.js       # reaction feedback
│   │   ├── merge-forward.js  # merge-forward
│   │   └── comment.js        # doc-comment @
│   ├── outbound/
│   │   └── mention.js        # @ rendering
│   ├── tools/
│   │   └── mcp-server.js     # Feishu MCP server (40 tools)
│   └── commands/
│       ├── doctor.js         # diagnostics & self-repair (21 checks)
│       └── features.js       # feature checklist
├── dsh-lark-session/         # DSH plugin (persistent-session runner)
├── scripts/
│   ├── install.js            # install / uninstall / status
│   └── setup.js              # setup wizard
├── tests/                    # 65 unit tests
└── docs/                     # documentation

---

📚 Documentation

---

🧪 Testing

npm test    # 65 unit tests

CI (GitHub Actions) automatically runs: unit tests + syntax checks + MCP server smoke verification.

---

📄 License

MIT

🙏 Credits

• DeepSeek Harness — Agent runtime
• OpenClaw & the official Feishu plugin
• @larksuite/channel — Feishu SDK
• lark-cli — Feishu CLI