前言¶
DeepSeek Harness (DSH) 採用「一切皆插件」的架構設計。當需要在 Discord 公會中管理 AI 會話時，直接使用 Discord 原生功能往往難以複用 DSH 的會話管理與模型調度能力。@addozhang/dsh-discord 是一個 Discord-first 適配器，它將 DSH 會話掛載到你的 Discord 公會中。插件由 addozhang 維護，允許用戶通過 Discord 的 Mention 觸發會話，並在 Discord 界面中流式查看結果、進行審批與控制，無需額外進程。
核心功能¶
該插件將 DSH 的核心能力映射到 Discord 命令與交互組件上：
- Mention 驅動的會話：在綁定的頻道中發送
@bot <task>，會自動錨定一個線程並創建 DSH 會話。支持圖片上傳，模型將自動處理圖片內容。 - 流式渲染：提供打字指示器，回答內容原地編輯，工具活動行實時展示，長文本分段展示。
- 審批與提問：DSH 的審批與提問以按鈕、下拉菜單或文本模態框形式呈現。點擊權屬於發起者或線程擁有者，支持過期自動失效。
- 會話控制：提供
/steer、/stop、/queue list|remove等命令控制會話流轉。 - 模型與權限管理：通過
/model select交互式選擇模型，或使用/permission show/set切換權限預設。 - 雙語支持：界面內置中英文切換，適配 DSH 的語言偏好。
- 安全加固：採用“拒絕優先”的授權策略，雙重抑制提及，提交機制爲“最多一次”且保留未知狀態的恢復邏輯。
安裝與啓用¶
插件作爲 DSH 插件掛載到 dsh web 配置文件。請確保安裝前已安裝 dsh CLI 並運行 web profile。
- 安裝插件：
使用 CLI 安裝插件包到當前 profile：
dsh plugin --profile web add @addozhang/dsh-discord
重啓 `dsh web` 並刷新瀏覽器。`dsh plugin` 會自動處理配置的合併。
-
版本兼容性：
插件有穩定版與 Next 版，需與 DSH CLI 版本嚴格匹配，不可混用：插件行 插件版本 DSH CLI 版本 stable 0.5.0 0.1.7-rc.1 next >=0.6.0-rc.1 0.2.0-rc.2 若 CLI 與插件版本不匹配，插件將在啓動時被禁用並報錯。
-
配置：
在 DSH 的設置卡片中配置 Discord Token、允許的 Guild ID（公會給定）、成員權限白名單及語言偏好。所有 Token 存儲在 Host 憑證服務中，不進入日誌或設置文件。
典型用法¶
通過 Discord 命令與交互操作 DSH 會話：
- 啓動任務：
@bot <task> - 會話控制：
/steer,/stop,/queue list|remove - 項目與會話綁定：
/project bind|list|info,/session resume - 清理操作：
/guild forget - 模型選擇：
/model show,/model select - 權限切換：
/permission show,/permission set - 權限集配置：
/permission show / set（需 Host 權限）
適用場景與注意¶
- 運行環境：插件依賴 Node.js
^22.19.0 || >=24.0.0。 - Discord 配置：必須創建 Discord Bot 應用，並在開發者門戶中啓用 MESSAGE CONTENT 特權網關意圖。
- 架構說明：會話狀態保留在 DSH 中，持久化綁定存儲在 Profile 的存儲域中。
- 權限控制：插件內置顯式的 Guild 允許名單，名單外的請求會被直接忽略。
- 生態背景：本插件爲社區維護項目，與 DeepSeek 或官方應用商店無官方從屬關係。
結尾¶
@addozhang/dsh-discord 通過將 DSH 的會話管理與 Discord 的即時通訊結合，爲 Discord 用戶提供了標準化的 AI 交互入口。如需查看完整文檔或源碼，可訪問社區目錄或GitHub 倉庫。
