安裝 DeepSeek Harness，完成第一個任務

DeepSeek Harness（dsh）是 DeepSeek 開源的程式開發 Agent 框架。想快速體驗，可以先啟動套件內建的瀏覽器介面。這份教學會把第一次操作控制在小範圍內：啟動介面、連接模型、選擇可隨時刪除的測試工作區，並要求 Agent 先分析、取得同意後再修改檔案。

DeepSeek 目前將 Harness 標示為 Developer Preview。建議先在測試儲存庫使用，逐一確認工具呼叫內容，也不要把 API 金鑰放在工作區內。

開始前要準備什麼

你需要較新的 Node.js，以及模型供應商提供的 API 金鑰。先確認 Node 與 npm 可以正常使用：

node --version
npm --version

本文以 Node.js 24 驗證。若啟動程式在舊版 Node 報錯，請升級到目前仍受支援的 Node.js LTS，再開啟新的終端機重試。

啟動 DeepSeek Harness Web UI

直接執行官方套件，不需要先做全域安裝：

npx @deepseek-ai/dsh web

終端機會顯示 Web UI 的本機網址。現階段通常是 http://127.0.0.1:3080，仍請以實際輸出為準。使用期間不要關閉執行這項指令的終端機。

第一次評估時使用 npx，可以避免留下需要長期維護的全域安裝。初次執行可能會下載套件；看到確認提示時，先核對套件名稱再繼續。

連接模型供應商

前往 Web UI 的模型設定，選擇供應商、填入對方提供的 API 金鑰，再指定要使用的模型。

DeepSeek Harness 負責協調 Agent 工作流程；模型的存取權限、資料政策與費用，仍由你選用的供應商管理。請勿把 API 金鑰貼進對話、原始碼，或可能提交至 Git 的環境設定檔。

選擇安全的工作區

建立一個小型測試資料夾，或使用狀態乾淨的 Git 儲存庫，再把它設為工作區。Agent 可能讀取與修改授權範圍內的檔案，因此不要直接選擇家目錄，也不要選擇存放其他專案憑證的資料夾。

第一個提示詞可以這樣寫：

請檢查這個專案，說明它的結構，並提出一項小幅改善。
在我同意方案之前，不要修改任何檔案。

這樣可以先確認 Agent 能讀取指定工作區，同時讓第一次互動保持可控，也方便復原。

核准一項小幅修改

讀完 Agent 提出的方案後，只核准一項範圍明確的修改。接受結果前先檢查 diff，並執行專案原有的檢查指令。Git 是最可靠的復原機制；授予寫入權限前，建議先 commit 或暫存自己的工作。

如何確認安裝成功

符合以下條件，就代表基本設定已經可以使用：

• 本機 Web UI 可以正常開啟；
• 選定的模型能回覆；
• Harness 可以讀取指定工作區；
• 工具呼叫會顯示出來，讓你先行審核；
• 核准一項小修改後，能看到清楚可讀的 diff。

若介面無法啟動，請參考 DeepSeek Harness Web UI 無法啟動的排查步驟。

停止服務與清理資料

在啟動 Web 服務的終端機按下 Ctrl+C。本教學使用 npx，不需要另外移除全域套件。若確定不再使用，也請分別清除模型供應商憑證與應用程式產生的本機資料。

資料來源與驗證範圍

啟動指令與產品定位取自 DeepSeek Harness 官方儲存庫。Developer Preview 階段的介面名稱與操作方式仍可能調整；頁面會保留驗證環境與更新日期，方便你判斷內容是否適用於目前版本。