dsh-im

English · 中文

dsh-im

Sidebar below New Session → IM bots: connect the local Harness to chat apps.

Feishu · WeChat · DingTalk · WeCom · QQ · Slack · Telegram · Discord · WhatsApp · AI Office

English · 中文 · xiaotaozi-dsh · THIRD_PARTY_NOTICES.md

A DeepSeek Harness plugin. Scan a QR code, paste an App Manifest, or enter bot credentials. Each channel can hold several bots. Credentials stay in the Host credential store.

Runtime logic lives under src/channels/; Cordis RPC wiring is under src/host/; the Web UI is src/client/.

Part of the xiaotaozi-dsh monorepo. User-facing copy follows the Harness language (Chinese / English). Channel adapters come from xmanrui/dsh-im (MIT). See THIRD_PARTY_NOTICES.md. Do not dsh plugin add the repository root.

Features

• Nine chat channels plus experimental AI Office. QR, App Manifest, or existing secrets, depending on the product.
• Several bots per channel. Secrets never go in the client bundle.
• Files in both directions. Ordinary chat files go into the current Harness session; result files and images come back as native attachments (dsh_im_return_file).
• Bot commands in the chat. /help /new /status /models /model /presetlist /preset /stop /steer /compact /workspace /workspacelist /sessionlist /session
• Per-bot Agent Preset. Pick a preset in the IM hub or with /preset; new sessions follow it, existing chats need /new first.
• Per-bot role / scope. A short instruction on the bot card, applied on every inbound turn. Project AGENTS.md stays shared; Agent Preset still owns the toolset.
• English bot copy. Host language: en or DSH_IM_LANGUAGE=en switches prompts and command help. Untranslated strings stay Chinese.
• Resilience and authority. Config defaults to loopback RPC, isolated channel failures, a 600000ms reply timeout, and a 20000ms connect timeout. QQ, WhatsApp, and Office are loaded on demand; agentPreset can provide the default preset.

Install

dsh plugin --profile web add github:kedoupi/xiaotaozi-dsh#path:plugins/im
dsh web

Then open IM bots in the sidebar, directly below New Session (and below Xiaotaozi Market if that plugin is installed). Leave sandbox pnpm dev running while you edit; host restarts itself when lib/index.js changes.

Screenshots

Channels

Channel	Setup
Feishu	QR or App ID + Secret; streaming cards; group @/all-message mode; session watches
WeChat	QR via Tencent iLink
DingTalk	QR or Client ID + Secret; AI Card stream
WeCom	QR or Bot ID + Secret
QQ	QR or AppID + AppSecret; Markdown replies, one progress bubble in DMs
Slack	App Manifest + Bot/App tokens
Telegram	BotFather token; optional DM allowlist; native Rich Messages (draft in DMs, in-place in groups/topics)
Discord	Bot token. Enable Message Content Intent. Server text/announcement mentions open a Public Thread; grant Create Public Threads, Send Messages in Threads, Send Messages, and Read Message History. Result files also need Attach Files.
WhatsApp	Linked-device QR (unofficial WhatsApp Web; use a dedicated number). Default access is Only me; Selected contacts and Open responses are available per bot.
AI Office	Outbound heartbeat + SSE; experimental, off unless officeEnabled: true

Chat files (not just images) are staged into the current session workspace. Harness can send a result file back with the dsh_im_return_file tool. Slack apps need files:write as well as files:read.

Develop

AI Office is disabled by default. Enable it per profile with officeEnabled: true in Config (or office.enabled: true); the channel then also needs its own connector credentials.

From the monorepo root:

pnpm --filter dsh-im test
pnpm --filter dsh-im build
node scripts/link-plugin.mjs --profile web im
pnpm dev

Documentation

Doc	Read it when
THIRD_PARTY_NOTICES.md	Upstream MIT attribution
Workflow	Create, install, simplify, commit
Conventions	Package identity and two homes
xiaotaozi-dsh	The rest of the monorepo

License

MIT