DeepSeek Harness 教學：從安裝到 headless
十個經截圖驗證的步驟，從全新安裝一路走到 Agent 預設、Creator 模式外掛和 headless 執行——DSH 的完整導覽。
最近更新: 2026-09-14
DeepSeek Harness（DSH）是 DeepSeek 開源的智慧體執行框架，上線一週就拿下 169,000 GitHub stars：工作區、外掛、工具、子代理、可隨時更換的模型，連介面都能重建。本攻略把目前最完整的一支實拍教學拆成十個經截圖驗證的步驟：從一次全新 clone，到預設、外掛、沙箱和 headless 執行。
這是一頁看完的完整導覽。每一步都能深鏈回源影片的精確時刻；而裝外掛、換模型、配預設這些深挖主題，頁面底部各有一篇專屬攻略。
十個步驟，走完 DSH 全程
- 1
安裝 harness，啟動儀表板
DeepSeek Harness（DSH）就是幫模型裝上手腳的那層開源框架：檔案工具、shell、記憶、權限。官方文件給了兩條路——npx 一行指令，或者完整 clone 儲存庫（影片走的是 clone）。然後一條指令啟動 Web UI 並印出本地位址（影片裡是 127.0.0.1:3080），打開就是儀表板。首次啟動會彈出對話框索取 DeepSeek API key。
$git clone https://github.com/deepseek-ai/deepseek-harness$pnpm dsh web
兩種裝法：npx 一行指令，或 clone 儲存庫——影片選了後者。在 1:15 觀看 
一條指令啟動 Web UI，啟動後印出本地位址。在 1:38 觀看 - 3
先加工作區，再提任何要求
在 DSH 裡，想讓它幹正事就必須先給它一個資料夾：點側邊欄的 Add workspace 按鈕，或用輸入框上的工作區下拉。每個 Agent 工作階段都被限定在那個資料夾裡——這正是「專注一份工作」和「放它掃遍你整台電腦」的差別。工作階段還是持久的：今天關掉，明天打開，之前的工作原樣都在，接著做就行。
先選資料夾——每個工作階段都被限定在裡面。在 2:30 觀看 - 4
萬物皆外掛——包括你以為屬於核心的部分
這是 DeepSeek 官方打頭的那句話：跟模型對話的部分、工具清單、記錄一切的日誌，乃至驅動 Agent 走出下一步的迴圈——全是外掛。沒有受保護的核心，所以 DSH 裡沒有什麼是永久的，也就沒有什麼能困住你。打開 Settings → Plugins 一看便知：儲存、工作階段、審批，甚至 web server 都是帶 Enabled 徽章的外掛。生態裡已經有現成的連接器，但 DSH 還是開發者預覽版，readme 明說會有破壞性變更——動手造輪子之前先查外掛目錄，把自己做的東西當原型看待。
DeepSeek 官方的那句話：DSH 裡沒有什麼是永久的。在 4:15 觀看 
儲存、審批、web server——在這份清單裡都只是外掛。在 4:25 觀看 - 5
按任務挑執行模式
Settings → Agent presets 列出了內建的幾種重組方式。Standard 模式是全家桶：檔案編輯、檢索、shell、Skills、規劃、子代理。Code 模式暴露同樣的工具，但讓模型寫一段程式把它們串起來，而不是一次一個呼叫。Minimal 模式只留兩個工具：終端機和檔案編輯器。影片給同一個任務（重新命名 200 個檔案）做了基準：Standard 模式花了 30 次往返，Code 模式只花 3 次。同一套工具，三種成本——挑能做完事的最便宜一檔。
四套內建預設——複製一份改造，或讓 Creator 模式幫你起草。在 5:22 觀看 
同樣重新命名 200 個檔案：Standard 30 次往返，Code 模式 3 次。在 5:32 觀看 - 7
隨手讀 Trajectory 收據
模型看到和做過的每件事都寫進一份只增不改的日誌，Trajectory 頁就是它的回讀介面：系統提示詞、上下文注入、推理、每一次工具呼叫和結果。它出了錯，你能看到它到底被灌了什麼。這一頁同時也是工具清單——bash、skill 等等就是全部可動用的表面，不在清單裡就發生不了（Creator 模式還能再加）。
系統提示詞、上下文注入、工具呼叫——整份收據，只增不改。在 9:28 觀看 - 8
拴好繩子：沙箱層級與審批
三個沙箱層級管住每個工作階段：Read-only 只能看不能碰；Workspace write 只能改專案資料夾裡的東西，別處免談；Full access 顧名思義，而且由作業系統在底層強制執行。影片裡的唯讀工作階段拒絕複製 index.md，直到獲得明確批准——作者點了拒絕。DSH 沒有「總是允許」選項；完整存取會減少確認步驟，必須在一個警告對話框裡勾選風險後手動開啟。預設用 workspace write，full access 慎之又慎。
唯讀就是只能看不能碰：這次複製壓根沒發生。在 8:06 觀看 
完整存取是鄭重決定：一條警告、一個勾選框，沒有回頭路。在 9:05 觀看 - 9
讓它先亮計畫，再動手
Plan 模式讓 DSH 在動手之前先說清楚要做什麼——在輸入框裡敲 /plan，描述任務，讀完計畫再放行。讀計畫用不了一分鐘；返工 40 處改錯的檔案能拖上幾週。凡是會碰到兩個以上檔案的任務，都值得先來一份計畫。
讀完計畫，再放行 Agent。在 9:55 觀看 - 10
教它、派活給它，然後 headless 跑起來
Skills 是寫好一套流程的指令檔，放進專案或全域安裝——影片作者那批 Claude Code 全域技能就被自動接了進來。目標（/goal）給工作階段裝上一條終點線，讓它朝著結果一直跑；目標要寫得具體，它才知道何時停。DSH 沒有內建排程，但 Creator 模式能幫你起草一個排程任務外掛——只是工作階段一關它就停。長任務會派給子代理，每個子代理都有乾淨獨立的上下文；或者由它寫一段一次性的工作流程式去追一個結果。最後是 headless：一條指令，印出答案，直接離開——沒有視窗、沒有連接埠。凡是能執行指令的東西，從此都能調度一個 Agent。
$pnpm dsh --profile headless "<one-off task>"
Skills 是寫一次就反覆用的指令——可限定專案，也可全域安裝。在 10:35 觀看 
沒有視窗、沒有連接埠：一條指令進，一個答案出。在 13:30 觀看
DeepSeek Harness 教學：常見問題
這篇導覽最常被問到的幾件事。
安裝 DeepSeek Harness 最快的方式是什麼？
官方文件給了兩條路：一行 npx 指令直接啟動 Web UI，或者像影片裡那樣 clone git 儲存庫。無論哪種，一條指令——clone 下來後是 pnpm dsh web——就會把儀表板架在本地位址上（攻略裡是 127.0.0.1:3080），首次啟動會要求填 API key。
用 DSH 必須要 DeepSeek 的 API key 嗎？
不需要。首次執行的彈窗雖然會索取 key，但 Settings → Models → Add provider 接受清單裡任何供應商的金鑰。攻略用的是 OpenRouter，它暴露的每個模型都能在輸入框的模型選擇器裡按任務試用和切換。
應該從哪種執行模式起步？
Standard 模式——全家桶，帶檔案編輯、檢索、shell、Skills、規劃和子代理。便宜重複的活換 Minimal 模式；幾十次往返才能做完的活換 Code 模式：影片裡重新命名 200 個檔案的基準，Code 模式 3 次往返搞定，Standard 模式花了 30 次。
DeepSeek Harness 怎麼防止 Agent 弄壞我的檔案？
沙箱層級由作業系統在底層強制執行，不是提示詞裡的客套話：read-only 只能看不能碰；workspace write 只能改專案資料夾內的東西；full access 無所不能。攻略裡的唯讀工作階段拒絕複製檔案，直到獲得明確批准。DSH 沒有「總是允許」選項——完整存取要透過警告對話框手動開啟，也不該當預設。
DSH 真的能幫自己做外掛嗎？
能，靠的就是 Creator 模式。你用白話描述想要的能力，它檢視自己的執行環境、在記憶體裡試裝部件、定義外掛套件。影片裡一句話就讓一個能玩的 Pong 遊戲渲染在聊天裡；後來還讓 Creator 模式起草了一個排程任務外掛——注意，它只在工作階段存活期間執行。
不開 Web UI 也能跑 DeepSeek Harness 嗎？
Headless 模式用一條指令帶上任務，印出答案後直接離開——沒有視窗、沒有連接埠、什麼都不監聽。指令稿、排程任務、其他 Agent 工具因此都能從終端機呼叫 DSH：凡是能執行指令的東西，都能調度一個 Agent。
相關攻略
把這條路線上的每一環再挖深一點。
DeepSeek Harness 快速上手
5 分鐘裝好並跑起來的最短路徑，一步一步寫清楚。
閱讀教學DeepSeek Harness 外掛安裝指南
找社群外掛、從 npm 或 GitHub 新增、驗證載入成功。
閱讀教學DeepSeek Harness Agent 預設詳解
Standard、Code、Minimal、Creator 四種模式深入拆解，再加自訂預設。
閱讀教學DeepSeek Harness 切換模型指南
接供應商、比較模型、在輸入框裡按任務隨時切換。
閱讀教學DeepSeek Harness 必裝外掛
最值得先裝的那些社群外掛，以及各自補上了什麼。
閱讀教學DeepSeek Harness 子代理與多智慧體實戰
一次啟動五個子代理並行作業：從對話標頭逐一監控、完成報告逐份檢視、為每個子代理指定模型，附逐步截圖
閱讀教學來源與致謝
本頁所有截圖均來自下方公開的螢幕錄製，每張圖都可深鏈回擷取的精確時刻。攻略內容已與官方文件交叉核對。