DeepSeek Harness (DSH) 通過插件機制提供多種集成能力。對於釘釘用戶，xmanrui/dsh-dingtalk 提供了一種將釘釘機器人接入 Harness 的方案。它通過二維碼授權創建機器人，並使用釘釘 Stream 長連接在 Host 進程內處理消息，無需瀏覽器直接接觸敏感憑據。
核心功能¶
- 掃碼授權：通過一次性二維碼在釘釘創建並授權機器人。
- Host 進程運行：插件運行在 Harness 的 Host 進程內，由 Host 通過釘釘 Stream 長連接收消息。
- 憑據管理：掃碼獲得的
client_secret直接寫入 Harness 憑據服務，瀏覽器端不接收敏感信息。 - 消息處理：支持私聊文字消息及羣聊明確 @ 機器人的文字消息。
- 會話與命令：支持連續對話，支持
/new（開啓新會話）、/status（檢查連接）、/help（顯示幫助）命令。 - AI Card 渲染：AI Card 會持續更新並在生成失敗時降級爲普通文本。
- 不支持：不支持圖片、文件、視頻或語音消息。
安裝與啓用¶
前提條件¶
- DeepSeek Harness 版本
0.1.0-rc.6。 - Node.js 版本
>=22.19。 - 釘釘 App，掃碼賬號必須已加入企業/組織並有權創建機器人。
安裝步驟¶
- 執行安裝命令：
npx -y github:xmanrui/dsh-dingtalk install
- 重啓
dsh web。 - 打開「設置 → 插件 → IM機器人 → 釘釘」。
- 點擊「掃碼接入釘釘」。
- 使用已加入企業/組織的釘釘賬號掃描頁面二維碼。
- 在釘釘授權頁點擊「一鍵創建新機器人」。
- 等待頁面自動顯示機器人已連接。
- 在釘釘中私聊機器人，消息會直接進入 Harness。
使用說明¶
基本交互¶
- 私聊：直接發送文字消息，進入 Harness 進行對話。
- 羣聊：僅處理明確 @ 機器人的文字消息。
- 命令：
/new：開啓一個新的會話。/status：檢查當前的連接狀態。/help：顯示幫助信息。
安全與訪問控制¶
- 瀏覽器端不接收
client_secret、device_code或原始 staff ID。 - 入站訪問權由釘釘機器人的可見範圍決定，無需 Harness 本地二次批准。請在釘釘開放平臺限制機器人可見範圍爲信任的組織、羣或成員。
- 會話 Webhook 僅在內存中使用，不寫入配置或日誌。
注意事項¶
- 項目狀態：本項目已不再維護，建議使用統一的插件
dsh-im（支持微信、飛書、釘釘、QQ、企微、Slack、Telegram、Discord、WhatsApp）。 - 刪除機器人：在釘釘中刪除機器人會停止連接，並刪除對應的憑據、配置、去重記錄和會話映射。
- 賬號要求：掃碼賬號必須擁有創建機器人的權限，若提示“賬號還未加入組織”，需重新登錄或切換賬號。
生態背景¶
DeepSeek Harness 的插件生態旨在實現功能模塊化。本插件由社區開發者 xmanrui 維護，遵循 MIT 許可證。相關資源及目錄可參考：GitHub | SkillHub 目錄。
