1546 字
8 分鐘

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 的專案資料夾後執行:

Terminal window
cd /path/to/test-project
npx @deepseek-ai/dsh web

本機啟動時,Web UI 預設開在 http://127.0.0.1:3080,並自動打開瀏覽器;透過 SSH 啟動則只印出網址。不想自動開瀏覽器可以加 --no-open。DeepSeek Harness README

接著在畫面裡做三件事:Web UI 使用指南

  1. Settings → Models 貼上 DeepSeek API key 並儲存,不用重啟就能用。
  2. 按 Choose workspace,加入剛才啟動 dsh 的專案資料夾並選取。沒選工作區之前,輸入框不能送出。
  3. 開一個 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 說明

Terminal window
# 跑一次任務、印出最終答案後結束
dsh --profile headless "run the tests"
# 以 ACP 透過 stdio 提供給支援 ACP 的用戶端
dsh --profile acp

另外還有給 Python 程式呼叫的 SDK profile,以及官網提到的桌面 App。排程任務、Agent teams、自動核准審查等功能目前在官網標為 Experimental。

和 Claude Code、OpenHands 怎麼選#

三者都能讀寫專案、跑指令,差別在誰維護、預設跑在哪裡、怎麼擴充:

DeepSeek HarnessClaude CodeOpenHands 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 頁面當下列出的檔案為準。

參考資料:

DeepSeek Harness 官網

DeepSeek Harness README

DeepSeek Harness 安全須知

Web UI 使用指南

模型設定

dsh CLI 行為參考

OpenHands Agent Canvas Overview

DeepSeek Harness 怎麼裝?dsh Web UI 設定、權限模式,和 Claude Code、OpenHands 差在哪
https://laplusda.com/posts/deepseek-harness-install-setup-guide/
作者
Zero
發佈於
2026-11-22
許可協議
CC BY-NC-SA 4.0