DeepSeek Harness (DSH) 是一個本地 AI 編程環境。在開發過程中，頻繁切換窗口去網頁端 chat.deepseek.com 進行對話會打斷工作流。dsh-deepseek-chat-embed 插件旨在將官方聊天頁面深度集成到 DSH 桌面客戶端內，提供雙入口的聊天面板與持久登錄會話，解決多任務切換的痛點。
核心特性¶
插件採用策略模式架構，針對不同的桌面環境提供原生解決方案。
- 雙入口架構
- 左側導航主面板：在中央會話區域沉浸式全屏展開，適合進行長篇諮詢或深度規劃。
- 右側邊欄：以原生 Tab 形式並排展示，適合在編寫代碼或查看終端時即時查閱。
- 多桌面客戶端適配
- 支持官方 DSH 桌面版（Electron）與 DSH Dock（Tauri v2）。
- 支持通用原生多視窗協議，第三方桌面殼（如 Wails、Qt）也可通過標準接口接入。
- 宿主與客頁交互
- 實現了客頁與宿主側欄的雙向互斥與平滑摺疊。展開客頁時，宿主側欄自動收起；收起客頁時，宿主側欄平滑展開。
- 採用 CSS 同軌線性插值，消除佈局跳動。
- 健壯性設計
- 非侵入式 DOM 適配：通過結構語義啓發式查找節點，不依賴寫死的類名，抵抗前端站點迭代。
- 網絡隔離保護：高併發場景下管理 TCP 連接池，防止頁面卡死。
- 測試保障：內置 100 項自動化契約迴歸測試。
安裝與啓用¶
可以通過命令行或 DSH 客戶端圖形界面安裝。
命令行安裝¶
使用以下命令將插件添加到當前活動 Profile：
dsh plugin add github:realguan/dsh-deepseek-chat-embed
圖形界面安裝¶
- 打開 DSH 客戶端，進入 設置 → 插件。
- 點擊頁面右上角的 ＋ 添加插件。
- 粘貼 GitHub 倉庫地址：
github:realguan/dsh-deepseek-chat-embed
- 閱讀安全提示後點擊 安裝。
- 安裝完成後重啓客戶端生效。
使用方式¶
安裝完成後，插件提供兩種打開方式：
- 沉浸式模式：點擊左側導航欄的
💬 聊天圖標，在中央主工作區全屏展示 DeepSeek Chat。 - 協同模式：點擊右上角常駐按鈕，在右側邊欄以 Tab 形式並排展示。此時左側的代碼編輯器、文件列表或終端保持可見，便於邊寫代碼邊查閱。
注意事項¶
- 權限風險：插件在本機以你的權限運行，請僅安裝來源可信的插件。來源不明的插件可能損壞 DSH 或泄露數據。
- 手動更新：插件安裝後暫不支持自動更新。升級時需要先卸載舊版，再安裝新版。
- 環境依賴：需滿足
peerDependencies: @deepseek-ai/dsh >= 0.2.x。
生態鏈接¶
- GitHub 倉庫: https://github.com/realguan/dsh-deepseek-chat-embed
- 插件目錄: https://www.skillhub.cn/plugins/realguan/dsh-deepseek-chat-embed
