DeepSeek Harness 安裝教學:5 分鐘跑通 dsh(快速上手)

最短的 DeepSeek Harness(dsh)安裝與使用教學:Node.js 24.9+ 上跑 npx @deepseek-ai/dsh web,網頁端在 http://127.0.0.1:3080,Settings → Models 填 API key,五分鐘跑完第一個任務。

最近更新: 2026-11-12

一句話答案

DeepSeek Harness(dsh)是 DeepSeek 開源的、萬物皆外掛的智慧代理執行環境,目前仍是開發者預覽版,版本之間會有破壞性變更。先裝 Node.js 24.9 或更新版本(官方 README 與 @deepseek-ai/dsh npm 套件宣告的下限),然後執行:

npx @deepseek-ai/dsh web

網頁端預設起在 **http://127.0.0.1:3080**,通常會自動開啟瀏覽器。在 Settings → Models 填上 API key,選一個工作區,再讓代理跑一個小任務就完成了。如果只想在終端機裡跑一次性任務:

npx @deepseek-ai/dsh --profile headless "總結這個專案,並說明主要檔案各自做什麼"

先 npm install -g @deepseek-ai/dsh 再 dsh web 依然可用,但那只是可選路徑——官方推薦的零安裝入口是 npx。本頁內容在 2026-11-12 對照官方 README 與已發佈的 npm 套件核過;第三方教學與之衝突時,以 README 為準。

安裝:一行指令

npx @deepseek-ai/dsh web

首次執行會下載套件(提示 “Ok to proceed?” 時輸入 y),以 web profile 啟動,並在瀏覽器裡開啟網頁端。

想要一個常駐的 CLI?裝一次,之後每次啟動就不用再下載:

npm install -g @deepseek-ai/dsh
dsh web          # 與 dsh --profile web 等價

過程中遇到問題,直接看 github.com/deepseek-ai/deepseek-harness —— README 和 issue 都在那裡,所支援的 Node.js 版本也以 README 為準。

API key,或者不用填

在網頁端開啟 Settings → Models,填上 DeepSeek 的 API key 並儲存,模型路由立刻可用,不需要重啟。如果本機環境變數裡已經有 DeepSeek 的 key,這一步都可以直接跳過。

Harness 是身體,模型才是大腦。想用別的模型也行,任何 OpenAI 相容端點都能在 UI 設定裡接入(見DeepSeek Harness 是什麼?)。

第一個任務之前

只確認一件事:從想讓代理幹活的資料夾啟動 dsh。 預設沙箱只允許它碰這個工作區,所以啟動目錄本身就是一道安全邊界。

你的第一個任務

網頁端開啟就是一個對話。描述你想要的結果,而不是具體操作——代理會自己規劃步驟。適合第一次試的任務:

  • 「總結這個倉庫裡的 TODO,並給出完成的計畫。」
  • 「修好這個專案裡失敗的測試,並執行測試確認。」
  • 「用一篇短文解釋這個程式碼庫的結構。」

觀察發生了什麼:代理可能會先問一個釐清問題,或者先提出方案、等你批准再動手,然後開始一連串工具呼叫。會話記錄記錄模型看到的一切,所以之後可以隨時恢復或分叉這個會話。

遇到風險操作——寫工作區以外的檔案、連網、執行陌生指令——Harness 會先問你。那是審批系統在工作,不是 bug。

選對模式

介面頂部的模式選擇器,選的是當前會話的 Agent Preset。第一次跑用預設的標準模式就夠了。四個模式:

模式是什麼什麼時候用
標準模式完整的程式設計助手:能理解需求、修改程式碼、執行指令並檢查結果日常寫程式和調研
PTC 模式在標準模式基礎上,支援用 TypeScript 撰寫小程式,把多步操作組合成自動化流程大量機械步驟的任務
極簡模式只提供持續可用的終端和基礎文字替換工具簡單的改動、基準測試,或想看零魔法的主迴圈
創造模式在標準模式基礎上,額外支援執行時檢查、試用外掛,以及使用預設完成創作類任務設計你自己的預設——信任等級等同 shell,謹慎使用

會話一旦產生內容就鎖定預設,所以先選模式、再開始輸入。

第一次會話之後

  • 會話可恢復。 關掉分頁再回來,事件記錄支援恢復、分叉、檢索、回放。
  • 裝外掛就是一行指令: dsh plugin --profile web add <套件名或 github:owner/repo>,然後重啟 dsh web。它把參數轉給 profile 目錄裡的 pnpm;裝第一個之前先讀dsh 外掛安裝教學。
  • Profile、Patch 與 Preset 決定了 Harness 如何圍繞你組裝——設定教學講清楚了疊加順序。內建 Patch 層也是 dsh 和其他 Agent 拉開差距的地方:子 Agent、條件規則、權限、UI 替換,全是設定。

跑不起來怎麼辦

  • Node.js 版本 —— 最常見的首次執行失敗原因。dsh 需要 Node.js 24.9 或更新版本,先跑 node --version;這個下限若有變動,以官方 README 為準。
  • 模型沒回應 —— 檢查 Settings → Models 裡的 API key,以及機器能否連上供應商的端點。
  • 3080 連接埠被佔用 —— 用 npx @deepseek-ai/dsh web --port 8080,再開啟終端機印出來的位址。
  • 指令被拒絕 —— 那是沙箱或審批策略在攔;要麼有意識地放寬沙箱(見安全指南),要麼就在工作區內幹活。

下一步

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。