安裝 DeepSeek Harness（DSH）
本指南協助你跑通 DeepSeek Harness Web UI。別名包含 DSH、DS Harness。請以官方 GitHub 為準。
前置條件
- Node.js 22.19+ 或 24+
- 可存取 npm
- DeepSeek API Key（如需）
- 可讀寫的專案目錄，勿一開始指向整個家目錄
依作業系統
Windows
先裝 Node LTS，重開終端後執行 npx @deepseek-ai/dsh web。建議在專案資料夾啟動。
macOS
用官方安裝程式或 Homebrew 裝 Node，再跑 npx。
Linux / WSL
使用 nvm 或發行版 Node 22/24，不要用 root。WSL 工作區放在 Linux 檔系統。
npx 快速體驗
1. 啟動 Web UI
執行 npx @deepseek-ai/dsh web 並保持終端運作。
2. 開啟介面
瀏覽 http://127.0.0.1:3080。
3. 設定模型
於設定中貼上 API Key 並選擇模型。
4. 選擇工作區
加入允許 Agent 存取的資料夾。
5. 發送任務
先從低風險指令開始，再逐步提高權限需求。
驗證
UI 可開啟、設定可儲存、簡單提示有回應即表示安裝大致成功。
原始碼安裝
克隆 deepseek-ai/deepseek-harness 並依倉庫說明安裝。
排錯
npx 逾時
檢查網路與 Node PATH。
API 錯誤
核對金鑰與額度。
看不到檔案
重新選擇工作區根目錄。
下一步
前往教學、模式與外掛頁繼續探索。