在 DeepSeek Harness (DSH) 的開發場景中，Agent 工作流與社區溝通往往處於割裂狀態。DSH-Guild 插件旨在解決這個問題，它將 Discord 式的社區功能直接集成到 DSH 面板內，支持實時聊天、@ 提醒、文件傳輸、權限管理以及 DSH 會話分享，讓社區內容與你的 Agent 工作區融爲一體。
功能概覽¶
DSH-Guild 提供了一套完整的社區運營與協作能力：
- 賬號與身份：支持郵箱註冊（6 位驗證碼）、密碼登錄、忘記密碼重置（面板內直接完成）、修改用戶名與頭像。
- 社區管理：支持創建/加入公開或私有社區，通過邀請碼加入；提供公開社區發現與搜索功能；支持官方社區種子；提供成員管理（踢人、封禁、轉讓所有權）及社區刪除功能。
- 頻道體系：支持三種頻道類型（文字、公告、話題）。公告頻道默認全員只讀；話題頻道支持 24 小時無人回覆自動歸檔。
- 權限與角色：採用 Discord 式的角色模型，支持自定義角色、細粒度權限位（查看頻道、發送消息、管理等）以及頻道權限覆蓋。
- 討論組：支持在頻道下創建私密或公開討論組，支持設置進入密碼。
- 消息交互：支持消息編輯/刪除/置頂、表情回應、搜索（支持時間範圍篩選）。支持粘貼/拖拽上傳附件。
- 實時與狀態：基於 WebSocket 的實時連接，支持斷線重連、輸入狀態顯示、在線人數統計與聚合、已讀狀態上報與提及提醒。
- 協作與分享：支持邀請成員（站內信+郵件）、分享 DSH 會話（打包分享）、會話克隆。
安裝與啓用¶
在使用前，請確保環境滿足以下要求：Node.js ≥ 20、已安裝 pnpm 以及 npx @deepseek-ai/dsh。
- 安裝插件：
npx @deepseek-ai/dsh plugin --profile web add dsh-guild@0.0.3
- 啓動 DSH Web：
npx @deepseek-ai/dsh web
- 配置代理（可選）：
Server 默認部署在 Cloudflare（地址：https://dsh-guild-api.huiwang.fun）。國內用戶建議在代理工具中將該域名走代理，以確保連接穩定。
啓動後，在 DSH 側欄底部會出現 DSH-Guild（社區） 入口。首次使用時，需在面板內通過郵箱註冊並完成驗證碼驗證，隨後即可創建或加入社區。
典型用法¶
- 插件作者管理社區：用於發佈插件更新公告、收集用戶反饋、分流技術討論。
- 團隊/小組內部協作：將溝通與 DSH 會話上下文放在一起，便於協作。
- 會話分享廣場：創建公開社區，運營會話分享廣場，允許用戶克隆 DSH 會話。
配置與限制¶
DSH-Guild 的核心服務運行在 Cloudflare，客戶端（瀏覽器）與主機（Node.js）通過 REST API 和 WebSocket 通信。
在 DSH 設置頁的插件配置中，可調整以下參數：
* serverUrl：默認爲 https://dsh-guild-api.huiwang.fun，自託管時可修改。
* autoReconnect：WebSocket 斷線自動重連（默認開啓）。
* share.maxSizeMb：會話分享包體積上限（默認 50MB）。
使用限制：
* 每個用戶自建社區與加入社區的上限均爲 20 個。
* 自建社區受每 24 小時 5 個的滾動頻率限制。
生態背景¶
DSH 理念是「一切皆插件」，社區目錄是獨立站點。本插件由第三方開發者 seolhw 維護，遵循 MIT 許可證。
