DeepSeek Harness 怎麼裝?dsh Web UI 設定、權限模式,和 Claude Code、OpenHands 差在哪
本文目錄
DeepSeek Harness 在 8 月以開源 Preview 推出,簡稱 dsh,官方定位是「everything is a plugin」的 Agent harness:同一套核心可以當 Web UI、桌面 App、無頭批次工具,也可以接進其他編輯器。想先試,只要裝好 Node.js,在專案資料夾執行一行 npx 就能開起來;真正要花時間看的,是它預設能動哪些檔案、哪些資料會回傳給 DeepSeek。DeepSeek Harness 官網
本文依 2026-11-22 的官方 README、使用者文件與 base bundle 設定整理,npm 上的 latest 是 0.2.2-rc.5。專案明說目前是 developer preview,會有破壞相容性的變更,版本差異請以你安裝當下的文件為準。
先準備什麼
- Node.js:README 只寫「安裝 Node.js」,CLI 套件的
engines要求>=24.9.0,舊版 Node 先升級。 - 模型金鑰:預設走 DeepSeek API,需要到 DeepSeek 開放平台建立 API key,依用量計費,價格以官方定價頁為準。
- 一個測試用專案:
dsh會把啟動時所在的資料夾當成預設工作區根目錄,第一次別在家目錄或放了金鑰的資料夾啟動。
一行指令開 Web UI
進入要交給 Agent 的專案資料夾後執行:
cd /path/to/test-projectnpx @deepseek-ai/dsh web本機啟動時,Web UI 預設開在 http://127.0.0.1:3080,並自動打開瀏覽器;透過 SSH 啟動則只印出網址。不想自動開瀏覽器可以加 --no-open。DeepSeek Harness README
接著在畫面裡做三件事:Web UI 使用指南
- Settings → Models 貼上 DeepSeek API key 並儲存,不用重啟就能用。
- 按 Choose workspace,加入剛才啟動
dsh的專案資料夾並選取。沒選工作區之前,輸入框不能送出。 - 開一個 session,先丟不會改檔的任務,例如請它摘要這個 repository 的主要套件。
金鑰存放在 $DSH_HOME/.credentials.yaml(預設 ~/.dsh),設定頁只拿得到遮蔽後的描述。另外,啟動資料夾裡的 .env 也會被當成憑證來源之一,專案裡如果放了正式環境的 .env,先移開再測。模型設定·CLI 行為參考
不想用 DeepSeek 也可以:Add model provider 裡有 anthropic、openai、Kimi(moonshotai)、GLM(zai)等內建供應商,也能填 OpenAI 相容的自訂端點。
三種權限模式,預設是可寫工作區
base bundle 的權限預設寫在設定檔裡,模式可由環境變數 DSH_PERMISSION_MODE 切換:base bundle 設定
| 模式 | 檔案範圍 | 需要核准嗎 |
|---|---|---|
read-only | 指令不能寫檔 | 會詢問 |
workspace-write(預設) | 只能寫工作區內 | 會詢問 |
danger-full-access | 不限制 | 不詢問 |
指令被沙盒擋下時,模型可以申請「放寬一級」,由你核准;沙盒無法套用時會直接失敗,不會偷偷改成無限制執行。不過這是和主機共用核心與檔案系統的同機沙盒,官方的安全須知也寫明專案未經安全稽核,建議用拋棄式 VM、容器或專用環境,並先備份它碰得到的檔案。sandbox 套件說明
有兩個地方容易漏看:
兩個預設值先確認
- Session Log 上傳預設開啟:使用官方 DeepSeek API 時,完整的 session 記錄會隨後續請求送給 DeepSeek。不想分享,到 Settings → General 關閉「Upload Session Log when using the official model API」。
web_fetch不逐次確認:啟用的抓取工具在任何沙盒或核准模式下都不會逐次詢問,而且連得到 loopback 與內網位址。公司內網有管理介面的話,要特別留意。
以上兩點出自 CLI 行為參考。外掛另有一層:Creator Mode 安裝的 Host 程式碼在程序內執行,不受工作區沙盒限制,驗收方式可看 DeepSeek Harness Creator Mode 外掛檢查。
Web UI 之外的用法
同一個 dsh 指令用 profile 切換入口:dsh CLI 說明
# 跑一次任務、印出最終答案後結束dsh --profile headless "run the tests"
# 以 ACP 透過 stdio 提供給支援 ACP 的用戶端dsh --profile acp另外還有給 Python 程式呼叫的 SDK profile,以及官網提到的桌面 App。排程任務、Agent teams、自動核准審查等功能目前在官網標為 Experimental。
和 Claude Code、OpenHands 怎麼選
三者都能讀寫專案、跑指令,差別在誰維護、預設跑在哪裡、怎麼擴充:
| DeepSeek Harness | Claude Code | OpenHands Agent Canvas | |
|---|---|---|---|
| 維護方 | DeepSeek,MIT 授權開源 | Anthropic 官方工具 | OpenHands 社群,開源 |
| 主要介面 | 本機 Web UI、桌面 App、headless、ACP | 終端機為主,另有 IDE 與桌面整合 | 瀏覽器介面,可接本機、Docker、VM 或 Cloud 後端 |
| 模型 | 預設 DeepSeek API,可加其他供應商 | Claude 模型,用 Claude 訂閱或 Anthropic API | 自選供應商金鑰、本機模型或 ACP Agent |
| 隔離 | 同機沙盒+核准;建議另開 VM 或容器 | 權限規則與核准 | 可選 Docker 後端,只看得到掛載的資料夾 |
| 擴充方式 | 一切皆外掛,可在對話中產生外掛 | MCP、Hooks、Skills 等 | MCP、Skills、Plugins、Automations |
想要整套可改、能自己寫外掛,又打算用 DeepSeek 模型壓低成本,DeepSeek Harness 值得在測試環境玩;它還在 Preview,正式專案先別當主力。已經在用 Claude 訂閱、重視穩定度的人,Claude Code 的安裝與權限設定比較成熟,可從 Claude Code 安裝教學開始。想要瀏覽器介面加 Docker 隔離、或要接排程 Automation,則看 OpenHands 教學。
常見問題
Q: DeepSeek Harness 要付費嗎?
A: 程式本身是 MIT 授權開源,不用付授權費。費用來自模型 API:預設用 DeepSeek API key,依 token 用量向 DeepSeek 開放平台付費;改接 Anthropic、OpenAI 等其他供應商,就依各家計費。長時間跑 subagent 或 headless 批次任務前,先在供應商後台設好用量提醒。
Q: 可以不用 Node.js,直接下載桌面版嗎?
A: 官網提到可以用桌面 App 執行,也有 Desktop 解除安裝的官方說明。不過 README 的主要安裝路徑仍是 Node.js 加 npx,或從原始碼 pnpm install、pnpm run build 後執行 pnpm dsh web。桌面版的下載與簽章狀態以 GitHub Releases 頁面當下列出的檔案為準。
參考資料: