前言¶

DSH 的理念是“一切皆插件”。如果開發者希望把 IM 文本消息接入 harness agent session，而不是隻在本地界面裏操作，可以把 IM 網關作爲一個插件掛到 profile 上。dsh-im-gateway 就是做這件事的：它把 messenger 橋接到 DeepSeek Harness 的 agent sessions，並支持 slash commands 控制會話。

這是什麼¶

dsh-im-gateway 由 jelech 維護，許可證是 MIT。

它的定位是：An IM gateway for the DeepSeek Harness: bridge messengers into harness agent sessions and control them with slash commands.

也就是說，它把 WeChat 等 IM 消息接到 harness agent，同時提供一組 slash commands 來管理會話和模型。

核心功能¶

WeChat 接入¶

• 使用 Tencent’s official iLink Bot transport。
• 登錄方式爲 QR login。
• 連接方式使用 long-poll。

Slash commands¶

當前支持以下命令：

• /help
• /new
• /sessions
• /status
• /model

會話隔離¶

插件爲每個 peer 維護一個 agent session，保持會話隔離。

瀏覽器 IM 網關設置區¶

可選的瀏覽器設置區提供：

• QR login
• status
• test

HTTP bridge¶

當 profile 提供 webServer 時，插件會暴露 /im-gateway/* routes。

安裝與啓用¶

先通過 GitHub 地址把插件加入 web profile：

dsh plugin --profile web add github:jelech/dsh-im-gateway

如果從本地目錄安裝，可以使用：

dsh plugin --profile web add file:/absolute/path/to/dsh-im-gateway

安裝後需要重啓 harness；composition 在啓動時讀取。

典型用法¶

登錄微信時，可以打開瀏覽器的：

設置 → IM 網關 → 掃碼登錄微信

也可以調用：

gateway.login()

然後在 host 控制檯掃描二維碼並確認。登錄 token 保存在內存中，持續整個進程生命週期。

接入後，普通文本消息會由 harness agent 回答；以 / 開頭的消息按命令處理。

常用命令如下：

1、/help：列出命令。
2、/new 或 /reset：歸檔當前會話，並開始新會話。
3、/sessions：列出當前 peer 的當前會話和已歸檔會話。
4、/status：顯示連接、模型和當前會話。
5、/model [provider:model]：查看當前模型，或切換到指定 provider:model 並進入新會話。

適用場景與注意¶

適合想把 IM 文本消息接到 harness agent session，並用 slash commands 管理會話的開發者。

需要注意：

• 當前只支持文本；媒體（image/voice/file）需要走 iLink CDN AES-128-ECB path。
• iOS 需要 WeChat ≈ 8.0.70；Android 可能會先提示更新 WeChat。
• 瀏覽器面板在 host 本地渲染登錄 QR：通過 qrcode npm 包，並以 SVG 從 /im-gateway/qrcode 提供。
• /im-gateway/* HTTP bridge 會在 harness web server 上註冊 raw routes；如果部署環境在路由層之上強制 HTTP auth，需要在 lib/http.js 中添加。
• 插件運行在 DSH 進程中，會擁有該進程可訪問的模型、文件和網絡權限。安裝前應檢查源碼與許可證（MIT）。

鏈接¶

• GitHub：jelech/dsh-im-gateway
• 目錄頁：jelech/dsh-im-gateway