DeepSeek Harness 安裝教學：5 分鐘跑通 dsh（快速上手）
最短的 DeepSeek Harness（dsh）安裝與使用教學：npm install -g @deepseek-ai/dsh、dsh --profile web 開啟網頁端、填上 API key、四個模式選一個，搞定。
最近更新: 2026-08-18
安裝：兩行指令
DeepSeek Harness（dsh）只需要 Node.js，沒有別的依賴。最短路徑：
npm install -g @deepseek-ai/dsh
dsh --profile web
第一行全域安裝 CLI；第二行以 web profile 啟動 Harness，並在瀏覽器裡開啟網頁端。
不想全域安裝？一行指令的等價方案：
npx @deepseek-ai/dsh web
過程中遇到問題，直接看 github.com/deepseek-ai/deepseek-harness —— README 和 issue 都在那裡，所支援的 Node.js 版本也以 README 為準。
API key，或者不用填
在網頁端填上 DeepSeek 的 API key，就能開始用了。如果本機環境變數裡已經有 DeepSeek 的 key，這一步都可以直接跳過。
Harness 是身體，模型才是大腦。想用別的模型也行，任何 OpenAI 相容端點都能在 UI 設定裡接入（見DeepSeek Harness 是什麼？）。
第一個任務之前
只確認一件事：從想讓代理幹活的資料夾啟動 dsh。 預設沙箱只允許它碰這個工作區，所以啟動目錄本身就是一道安全邊界。
你的第一個任務
網頁端開啟就是一個對話。描述你想要的結果，而不是具體操作——代理會自己規劃步驟。適合第一次試的任務：
- 「總結這個倉庫裡的 TODO，並給出完成的計畫。」
- 「修好這個專案裡失敗的測試，並執行測試確認。」
- 「用一篇短文解釋這個程式碼庫的結構。」
觀察發生了什麼：代理可能會先問一個釐清問題，或者先提出方案、等你批准再動手，然後開始一連串工具呼叫。會話記錄記錄模型看到的一切，所以之後可以隨時恢復或分叉這個會話。
遇到風險操作——寫工作區以外的檔案、連網、執行陌生指令——Harness 會先問你。那是審批系統在工作，不是 bug。
選對模式
介面頂部的模式選擇器，選的是當前會話的 Agent Preset。第一次跑用預設的標準模式就夠了。四個模式：
| 模式 | 是什麼 | 什麼時候用 |
|---|---|---|
| 標準模式 | 完整的程式設計助手：能理解需求、修改程式碼、執行指令並檢查結果 | 日常寫程式和調研 |
| PTC 模式 | 在標準模式基礎上，支援用 TypeScript 撰寫小程式，把多步操作組合成自動化流程 | 大量機械步驟的任務 |
| 極簡模式 | 只提供持續可用的終端和基礎文字替換工具 | 簡單的改動、基準測試，或想看零魔法的主迴圈 |
| 創造模式 | 在標準模式基礎上，額外支援執行時檢查、試用外掛，以及使用預設完成創作類任務 | 設計你自己的預設——信任等級等同 shell，謹慎使用 |
會話一旦產生內容就鎖定預設，所以先選模式、再開始輸入。
第一次會話之後
- 會話可恢復。 關掉分頁再回來，事件記錄支援恢復、分叉、檢索、回放。
- 「裝外掛」是改設定，不是套件管理器指令。 每個外掛的 README 都寫了自己的安裝方式；裝第一個之前先讀dsh 外掛安裝教學。
- Profile、Patch 與 Preset 決定了 Harness 如何圍繞你組裝——設定教學講清楚了疊加順序。內建 Patch 層也是 dsh 和其他 Agent 拉開差距的地方：子 Agent、條件規則、權限、UI 替換，全是設定。
跑不起來怎麼辦
- Node.js 版本 —— 最常見的首次執行失敗原因，對照官方 README 支援的版本。
- 模型沒回應 —— 檢查 UI 設定裡的 API key，以及機器能否連上供應商的端點。
- 指令被拒絕 —— 那是沙箱或審批策略在攔；要麼有意識地放寬沙箱（見安全指南），要麼就在工作區內幹活。
下一步
- DeepSeek Harness 是什麼？ —— 你剛跑起來的這套東西背後的概念
- dsh 外掛是什麼？ —— 裝一個外掛到底意味著什麼
- Profile、Patch 與 Preset —— 把 Harness 調成你的形狀
- 瀏覽外掛 —— 最快地感受「一切皆外掛」到底意味著什麼