DeepSeek Harness (DSH) 的插件化架構允許開發者根據需求擴展功能。對於需要通過協作平臺進行交互的場景，dsh-messaging-gateway 提供了一個直接的接入方案。
核心定位¶
這是一個消息 Gateway 插件。它遵循“一臺 DSH Host，一個 Gateway”的原則。開發者需要自己創建並配置 Slack 和飛書應用。插件負責處理消息路由、會話管理和本地狀態存儲。所有 Token 僅存儲在本地，不會上傳到第三方服務器。
安裝¶
安裝前請確保 DeepSeek Harness 版本 >= 0.2.0-rc.1（推薦 0.2.0-rc.2），且環境滿足 Node.js ^22.19.0 || >=24.0.0。
官方桌面 App¶
- 打開 設置。
- 進入 插件。
- 點擊 添加插件。
- 在“包名或地址”中輸入：
dsh-messaging-gateway@0.2.3
- 安裝完成後重啓 Host。
Web CLI¶
使用官方 CLI 命令安裝，該命令僅寫入 web profile：
dsh plugin --profile web add dsh-messaging-gateway@0.2.3
若 dsh 不在 PATH 中，請使用：
npx @deepseek-ai/dsh plugin --profile web add dsh-messaging-gateway@0.2.3
配置與連接¶
安裝並重啓 Host 後，進入 設置 → 消息。
Slack 集成¶
- 在消息頁點擊 複製 Manifest，前往 Slack API 創建並安裝應用。
- 填入配置：
- Bot Token：以xoxb-開頭。
- App-level Token：帶connections:write權限，以xapp-開頭。
- Member ID：你自己的用戶 ID。 - 保存配置，給 Bot 發送一條私信。在頻道中 @Bot 纔會響應。
- 注意：Slack 的斜槓面板（Slash Menu）通常需要約 5 分鐘才能出現。
飛書 集成¶
- 在飛書開放平臺創建企業自建應用，啓用機器人功能。
- 權限：發佈新版本以生效，包括
application:app_slash_command:write、application:app_slash_command:read、im:message.p2p_msg:readonly、im:message.group_at_msg:readonly、im:message:send_as_bot。 - 事件訂閱：選擇長連接，訂閱接收消息 v2.0。
- 填入配置：
- App ID：以cli_開頭。
- App Secret。
- Member ID：你自己的ou_...。 - 保存配置，給機器人發一條私信。
使用與命令¶
會話管理¶
在聊天中，你可以使用以下命令：
/new：開啓新會話。/reset：重置當前會話。/compact：壓縮上下文。/help：查看幫助文檔。/model：切換模型。
目錄與狀態¶
默認工作目錄位於：
- $DSH_HOME/messaging-gateway/workspaces/slack
- $DSH_HOME/messaging-gateway/workspaces/feishu
狀態文件保存在 $DSH_HOME/messaging-gateway/state.json。
配置模型¶
在 設置 → 消息 → Slack / 飛書 中，可以配置每個平臺的模型和推理強度。這些設置將用於首次私信以及 /new、/reset 命令。
技術細節¶
防重複機制¶
Gateway 在啓動時會原子租用 $DSH_HOME/messaging-gateway/instance.lock。如果同一 Home 目錄下已有其他 Host 進程佔用了鎖，當前 Gateway 將保持不活動狀態。修復重複 Host 後，只有留存的進程會繼續工作。
本地化安全¶
插件依賴 @slack/bolt 和 @larksuiteoapi/node-sdk。所有認證信息僅在本地內存中處理，不經過官方共享 bot。
許可¶
MIT 許可證。
