前言¶

DeepSeek Harness（DSH）把代碼編輯、工具調用和 Agent 編排都收斂在本機進程裏，開發者坐在終端或 Web UI 前就能驅動一整套智能體工作流。但現實溝通往往發生在飛書羣、微信私聊、Telegram 頻道或 Slack 線程裏——同事隨手 @ 你問一句，客戶在手機端拋來一張截圖，如果 Harness 只能守在本地界面，協作鏈路就會斷在「還要切回電腦」這一步。

社區插件 dsh-im（維護者 xmanrui，npm 包名 @xmanrui/dsh-im）正是爲解決這類「本地 Harness、遠端聊天」的錯位而生：通過掃碼、App Manifest 或機器人憑據，把九大 IM 渠道統一接到本機 DSH，並在 Harness 設置頁裏集中管理。插件在 SkillHub 插件庫 歸類爲「客戶端」，GitHub 開源倉庫截至覈實日約 789 star（MIT 許可證）。需要說明的是，SkillHub 是面向中國用戶的 DSH 插件社區目錄，與 DeepSeek / 幻方無官方從屬關係；DSH 本身秉持「一切皆插件」理念，具體能力以各插件倉庫與目錄頁說明爲準。

這是什麼¶

dsh-im 的定位可以概括爲：在本機 DeepSeek Harness 中註冊一個「IM 機器人」設置入口，統一管理飛書、微信、釘釘、企業微信、QQ、Slack、Telegram、Discord、WhatsApp 九個內置渠道，以及可選的 AI Office Connector（讓本機 Harness 主動連接公網 Office，無需公網 IP 或端口轉發）。

每個渠道都支持接入多個機器人，各機器人的憑據、連接狀態、工作區、Agent Preset 與會話綁定彼此獨立。用戶發來的 Secret、Token 只提交給本機 Harness Host，寫入受保護的憑據存儲；設置頁接口不會回傳這些敏感字段。

核心功能與亮點¶

九渠道統一接入¶

除文字外，九個渠道均支持向 Harness 發送 JPEG、PNG、WebP 及以圖片文件形式發送的 GIF（單張上限 5 MB，單條消息圖片合計上限 20 MB），並可附帶文字說明。Harness 生成的文件也可按各平臺能力回傳爲原生附件。

機器人命令與會話管理¶

插件在聊天側提供較完整的命令集，無需打開 Web UI 即可操控會話，例如：

• /help：查看命令列表
• /new：解除當前聊天會話綁定，下一條消息開啓新 Session
• /status：檢查機器人與 Harness 的連接狀態
• /models、/model：列出並切換模型與推理等級
• /presetlist、/preset：爲當前機器人選擇 Agent Preset
• /workspace、/sessionlist、/session：切換工作區或綁定已有會話
• /stop、/steer：停止任務或向運行中任務追加指令

Telegram 可爲每個機器人切換「兼容模式」與「私聊白名單安全模式」；WhatsApp 支持「僅自己」「指定聯繫人」「開放響應」等訪問策略，避免機器人被無關消息觸發。

AI Office Connector¶

「AI Office」頁讓本機 Harness 通過 Device Token 主動連接公網 Office：心跳鑑權後建立 SSE 下行，接收 job.available 拉取任務、續租執行，並把工具審批等問題回傳到 Office 人工面板。適合「辦公室在雲端、算力在本地」的混合部署，而不必把本機暴露到公網。

安裝與啓用¶

插件要求 Node.js >= 22.19。推薦從 npm 安裝已發佈穩定版：

dsh plugin --profile web add -w @xmanrui/dsh-im

安裝完成後重啓 dsh web，在 Harness 中打開 「設置 → 插件 → IM機器人」，按渠道引導掃碼或填寫憑據。

若要試用 GitHub 上尚未發佈到 npm 的最新代碼，可使用倉庫提供的安裝器：

npx -y github:xmanrui/dsh-im install

GitHub 源安裝會直接拉取並構建 Git 依賴；pnpm 10 及以上可能需先在 profile 的 pnpm-workspace.yaml 中允許該依賴執行構建腳本。普通用戶建議優先使用 npm 穩定版。

網絡提示： 本機訪問飛書需走代理時，可在啓動 dsh web 前設置 HTTPS_PROXY（如 http://proxy:8080）並重啓 Host。Telegram Bot API 若無法直連，需 Node.js 22.21+，並啓用 NODE_USE_ENV_PROXY=1 配合 HTTPS_PROXY / HTTP_PROXY。

典型用法示例¶

以最常見的「掃碼接入 + 私聊對話」爲例，流程如下：

1. 執行上述安裝命令並重啓 dsh web。
2. 進入「IM機器人」設置頁，在左側選擇目標渠道（如飛書或 Telegram）。
3. 按頁面提示掃碼創建應用，或手動填入平臺頒發的 App ID / Bot Token。
4. 在機器人卡片上確認工作區路徑與 Agent Preset（新機器人默認使用 Host 當時的工作目錄）。
5. 在手機或桌面客戶端向機器人發送普通消息，即可觸發 Harness 會話；需要換話題時發送 /new。

切換模型可先 /models 查看序號，再 /model 2；切換推理等級可用 /reasoninglist 與 /reasoning 2。飛書用戶若權限不全，可在私聊中發送 /repair 增量補全卡片回調與圖片讀寫權限。

在線時還可點擊機器人卡片上的「檢查連接」，向最近私聊發送一條連接測試消息（不創建 Session、不調用模型）。

適用場景與注意事項¶

適合誰用：

• 希望把本機 DSH Agent 接到團隊日常 IM，減少「複製粘貼到終端」的摩擦；
• 需要在飛書、釘釘、企業微信等國內平臺與 Telegram、Slack 等海外平臺之間統一一套 Harness 能力；
• 本地算力 + 雲端 Office 協同，希望通過 AI Office Connector 領取遠程任務。

使用前務必知曉：

1. 權限邊界：插件以當前 dsh 進程的權限運行，能訪問的工作區、工具和文件與 Host 一致。安裝前應閱讀 GitHub 源碼 與 MIT 許可證，確認符合你的安全策略。
2. 命令即能力：能向機器人發消息的用戶，通常也能執行 /workspace、/session 等命令，可能觸及本機其他項目路徑或會話。請只向可信用戶開放機器人，併合理配置 Telegram / WhatsApp 訪問模式。
3. 平臺差異：各 IM 對文件大小、流式展示、羣聊 @ 規則要求不同，README 中有逐渠道說明；部分能力（如飛書圖片下載）需額外租戶權限。
4. 局域網暴露：若在可信局域網對外提供 Web profile，可在 cordis.patch.yml 中將 rpcAuthority 設爲 trusted-host；這複用 Harness 的 Origin 防護，不是用戶認證，僅適用於可信網絡。

小結¶

如果你已經用 DeepSeek Harness 搭好了本地智能體，卻苦於它「只能坐在電腦裏」，dsh-im 用一套設置頁把九大 IM 和 AI Office 接到同一 Harness 上：掃碼或憑據即可上線，多機器人、多工作區、流式回覆與豐富命令讓聊天軟件變成 Agent 的前臺。不妨從 npm 穩定版裝起，在飛書或 Telegram 裏發一條 /help 試試。

• 插件目錄頁：https://www.skillhub.cn/plugins/xmanrui/dsh-im
• GitHub 倉庫：https://github.com/xmanrui/dsh-im