DeepSeek Harness 設定教學：Profile、Patch 與 Agent Preset

一個 DeepSeek Harness（dsh）程序如何組裝：Bundle、Profile、Patch 層層疊加成外掛樹，Agent Preset 定義整個會話。完整的 dsh 設定教學。

最近更新: 2026-08-14

一切都是一棵外掛樹

執行中的 dsh 不是一個「自帶一堆功能的程式」，而是一棵外掛樹——啟動時由層層設定組裝出來的 Cordis 外掛系統。每一項能力（工具、模型接入、儲存、沙箱、UI、主迴圈）都是樹上的一個外掛，而設定層決定了存在哪些外掛、以什麼順序存在。

這就是全部的心智模型。剩下的篇幅就是把每一層拆開講。

從底層到頂層的各層

設定按固定順序疊加，上層覆蓋下層：

┌─────────────────────────────┐
│  Patch（你的覆蓋層）            ← 優先級最高
├─────────────────────────────┤
│  Profile（你的具名組裝清單）
├─────────────────────────────┤
│  Bundle（官方外掛組合包）
└─────────────────────────────┘

Bundle（組合包） —— 官方發佈的成套外掛。第一次啟動時的預設體驗就是一個 Bundle。
Profile —— 你機器上的具名組裝清單，內容是「載入哪些 Bundle 和外掛、用什麼設定」。可以保留多套、隨時切換。
Patch（覆蓋層） —— 你自己的修改層。可以精確定位到任意一個外掛條目並替換，不動它所屬的 Profile。

因為每一層都只是設定，分享一套環境就是分享幾個檔案——把 Profile / Patch 檔案發給你，就等於把「他的 dsh」交給你。

Patch 層：給 Agent 裝能力的裝扮系統

內建 Patch 層是 dsh 最不像其他 Agent 的部分。把它理解成一套裝扮系統——你決定代理「穿」上哪些能力，以及在什麼條件下生效：

把本機 Agent 掛成子 Agent。 你電腦上的 Codex 和 Claude Code 可以註冊為 Harness 調度的子 Agent，而不是被取代掉的競品。
接入各種能力。 安裝外掛來新增工具、接入外部的服務、調整執行權限、開啟全文搜尋。
替換 UI。 介面模組同樣是外掛——皮膚、面板甚至整個 UI 元件都能透過 Patch 換掉。
規則按條件生效。 規則用 JavaScript 表達式定義，讓能力只在你想要的地方生效：某個倉庫、某類檔案、某個時間段。

Patch 精確到單個外掛條目，所以上面每一項都是一個可加、可查、可移除的覆蓋，不動它下面的 Profile。

為什麼「裝外掛」其實是改設定

dsh 沒有那種「一鍵安裝、從此不管」的中央套件管理器。安裝外掛意味著往 Profile / Patch 層裡加一筆記錄，外掛倉庫的 README 會給出確切的那一行。下次啟動時外掛進入外掛樹；卸載時，它註冊過的一切自動撤銷——註冊必須是可逆的副作用，所以壞外掛也留不下殘餘（見外掛開發入門教學）。

Agent Preset：一個會話的形狀

介面頂部的模式選擇器，選的是 Agent Preset（代理預設）——當前會話裡代理的完整定義：

擁有哪些工具；
什麼樣的系統提示詞；
載入哪些 Skills；
子代理與工作流的設定。

預設不是「外掛清單 + 一段提示詞」，而是整個會話賴以執行的契約。所以會話一旦產生內容就鎖定預設——中途切換會讓歷史裡的工具呼叫無法被新工具集解釋。

四個內建預設：

預設	工具	適合
標準（Standard）	完整的程式設計助手：理解需求、修改程式碼、執行指令並檢查結果	日常寫程式和調研
PTC	標準模式的一切 + 程式化工具呼叫：用 TypeScript 小程式把多步操作組合成自動化流程	批次機械步驟，更省上下文
極簡（Minimal）	只有持續可用的終端和基礎文字替換工具	簡單的改動、基準測試、教學
創造（Creation）	標準模式的一切 + 執行時檢查、試用外掛、用預設完成創作類任務	設計你自己的預設

打造自己的預設

創造模式（Creation） 是設計新預設的正規途徑：直接描述需求（「一個唯讀的程式碼審查員，絕不改檔案，用中文回答」），Harness 會檢查當前執行時、在記憶體裡試驗外掛、起草設定、掛載驗證，最後儲存下來供複用。

官方文件裡的兩句提醒值得重複：

創造模式會執行模型寫的程式碼並修改執行時——信任等級等同 shell；
預設就是設定，把它設為預設之前，先檢查它到底儲存了什麼。

什麼時候該停止折騰設定

最舒服的預設是：用標準模式，幾乎什麼都不改。 只有當你反覆需要同一套環境（團隊共用一個 Profile）、想給某類工作固定工具箱、或者只想換掉一個元件（換模型接入、收緊審批策略）時，才去動 Profile 和 Patch。上層覆蓋層的存在，就是為了讓你只改一處、不必推倒重來。