learn
DeepSeek Harness 教學：安裝、設定與外掛開發完整指南
一份面向使用者與外掛開發者的實用教學：跑起來、搞懂 Profile 與 Preset、安全地安裝外掛、自己動手寫一個。
全域安裝、以 web profile 啟動，然後在網頁端填上 API key —— 環境變數裡已有則略過。除此之外，一切都是外掛。
這份 dsh 教學講什麼
DeepSeek Harness（dsh）是 DeepSeek 開源的 AI Agent 執行環境：模型是大腦，Harness 是身體，而身體的每一部分都是外掛。這份 DeepSeek Harness 教學就是那本缺失的說明書 —— 不講行銷話術，只講它到底怎麼組裝、怎麼運轉。
第一次來建議按順序讀，也可以直接跳到需要的章節。
- /01跑起來 —— 安裝、第一個任務、四種模式
- /02看懂組裝 —— Bundle、Profile、Patch、Preset
- /03用得安全 —— 沙箱三檔、審批、金鑰
- /04融入生態 —— 找外掛、裝外掛、發布外掛
guides
從這裡開始
Harness 是什麼，以及五分鐘跑通第一次。
DeepSeek Harness 是什麼？
Agent = Model + Harness 的思路、Profile 與 Patch、Preset 與四種模式。
dsh 外掛是什麼？
dsh 外掛到底是什麼、能改動什麼、外掛樹如何組裝。
DeepSeek Harness 安裝教學：5 分鐘跑通 dsh
安裝 DeepSeek Harness、啟動 Web UI、完成第一個任務、選對模式。
DeepSeek Harness：10 步全流程導覽
從 git clone 到 headless 模式——安裝、接供應商、配預設、Creator 模式做外掛、沙箱與軌跡收據，一篇導覽走完。
從需求到交付:用 DSH 做完一個真實專案
完整交付流程:追問需求、寫成 CONTEXT.md 與 ADR,整理成 PRD,拆成 GitHub 任務單,再逐單開發、合併、實機驗收。
DeepSeek Harness 子代理與多智慧體實戰
一次啟動五個子代理並行作業：從對話標頭逐一監控、完成報告逐份檢視、為每個子代理指定模型，附逐步截圖
dsh 對話回放與覆盤
打開執行軌跡面板、讀懂結構化回執、按輪次定位失敗，再從任意一步分支重跑，附逐步截圖
DeepSeek Harness Windows 安裝教學
10 步實機截圖安裝教學:Node.js、npm 全域安裝、3080 埠的 Web UI、API key,Win10/11 免 WSL。
Mac 安裝 DeepSeek Harness
截圖逐步驗證的 macOS 實機教學：一個 npx 指令，不需要 API key，第七步接好供應商。
DeepSeek Harness Linux 安裝教學
逐幀查證的 Linux 安裝教學：Node.js、一條 npx 指令、服務商設定，另附 Windows 使用者的 WSL 章節。
DeepSeek Harness 桌面版：官方 vs 社群
官方 Web UI、DSHDesktop 等社群客戶端，以及一份安全下載清單。
Ollama 與免費模型
把 DeepSeek Harness 指向 OpenRouter 免費模型或本地 Ollama 服務，不用付費 API key 也能跑會話。
切換模型與自訂 Provider
工作階段中途換模型、接上 NVIDIA NIM 或 Ollama 自訂 Provider，並驗證自己到底在和哪個模型說話。
dsh 用量與費用統計
看懂逐請求用量收據、用 Trajectory 找上下文大戶，再用模型降檔和統計外掛把費用壓下來。
升級 DSH 與外掛
經過核實的升級命令：查版本、升級 dsh CLI、在終端或 Web UI 外掛市場更新外掛，以及安全回滾。
dsh 外掛解除安裝與清理
移除單一外掛、解除安裝 dsh 本體、徹底清理 ~/.dsh 資料目錄——全部對照真實終端機輸出核實。
手機遠端控制 dsh
ngrok 內網穿透把網頁介面掛上公網,在外面用手機連回家裡的 Agent,免裝 App,實測截圖逐步對照。
四種模式：Standard、PTC、Minimal、Creator
每種 agent preset 包含什麼、什麼情境用哪一種，以及怎麼在 Creator 模式裡做自己的 preset。
計畫模式:/plan、審閱、核准
DeepSeek Harness 的 /plan 命令實測:橘色計畫標記、exit_plan_mode 審核卡,以及和直接執行的差別,10 張截圖逐步講清楚。
dsh 對比 Claude Code
客觀比較：開放程度、價格、模型自由度與可擴充性。
DeepSeek Harness vs OpenClaw 比較
同為 MIT 開源，一個是自己組裝的程式開發 Agent 執行環境，一個是住在你聊天軟體裡的助理。六個維度比較，附明確結論。
DeepSeek Harness 與 Cursor 比較
編輯器對 Harness 的誠實比較：價格、模型自由度、外掛生態，以及兩者一起用的方式。
DeepSeek Harness 與 Gemini CLI 比較
免費百萬 token 上下文對上「模型即外掛」的執行環境：六個維度比較、選型結論，以及兩者並用的方法
Claude Code 免費替代方案
不花錢的開源 AI coding 工具盤點，以及 dsh 的位置。
外掛 vs 技能:區別在哪
一個替換 harness 能力,一個教 agent 做事。對照表 + 實機截圖 + 兩個完整例項,一次分清。
技能安裝實作指南
從 mkdir 到 trajectory 回執的 7 步實測:建 .dsh/skills、寫 SKILL.md、確認目錄注入——全程無需重啟。
最值得安裝的 dsh 技能推薦
哪些 skill 值得裝、裝完能做什麼，逐一實測示範，附啟用步驟
用 DeepSeek Harness 架 AI 小說工作台
一行指令裝上三欄式寫作工作台:大綱推演、正文寫作、角色追蹤與去 AI 腔審校——草稿全部存在本機。
小說一鍵改短劇,分鏡自動生成
把小說拆成多集短劇,自動寫對白與反轉,逐鏡頭產生分鏡和 Midjourney/影片模型提示詞,匯出結構化資料對接下游製作。
設定與開發
Profile、Preset，以及寫自己的外掛。
Profile、Patch 與 Preset
一個 dsh 行程如何由層層設定組裝而成 —— 以及怎麼把它調成你的形狀。
打造自訂 DSH Agent 預設
用 Creator 模式設計專屬的 DeepSeek Harness 預設：配外掛、批准寫入、一鍵切換工作臺——逐格核實的實戰教學。
外掛開發入門教學
Cordis 外掛怎麼寫、怎麼發布、怎麼進目錄 —— 附官方錨點。
動手寫你自己的 DSH 外掛
完整開發實錄：最小契約、Config Schema、profile 安裝，外加 MCP Apps 實測演示驗證外掛真的能跑。
疑難排解與錯誤百科
症狀 → 原因 → 修復：安裝失敗、pnpm workspace allowlist 錯誤、cordis.patch.yml 衝突、bundle 格式錯誤與 Profile 設定無效。
安全與生態
沙箱、值得信任的外掛，以及更大的 dsh 世界。
沙箱、審批與金鑰
dsh 的安全模型：沙箱三檔、審批策略、守衛，以及你的金鑰去了哪裡。
安全地安裝外掛
dsh 裡「安裝外掛」到底發生什麼，附一套第三方程式碼審查清單。
必裝 dsh 外掛推薦清單
從全目錄挑出的 12 個值得優先安裝的外掛，涵蓋各個分類。
dsh 外掛生態盤點
官方套件、社群組織、dsh-plugin topic，以及本 DeepSeek Harness 外掛市集如何保持新鮮。
外掛 API 與 RSS
公開的唯讀 JSON API 與 RSS 訂閱源，查詢完整外掛目錄，無需 API Key。
faq
常見問題
大家搜 DeepSeek Harness 教學時最想找的短答案，都在這裡。
DeepSeek Harness 是什麼？
DeepSeek Harness（dsh）是 DeepSeek 開源的 AI Agent 框架：把模型變成能讀寫檔案、執行指令、連網搜尋的 Agent 的那一層執行環境。它的核心理念是「一切皆外掛」—— 工具、模型接入、UI，甚至主迴圈，都是外掛。
閱讀教學DeepSeek Harness 免費嗎？
Harness 本體開源（MIT）。模型呼叫是另一回事：你接入自己的供應商（例如 DeepSeek API），由對方按 token 計費。社群外掛大多也開源，安裝前看一下每個倉庫的授權條款。
DeepSeek Harness 怎麼裝？
全域安裝 CLI（npm install -g @deepseek-ai/dsh），然後執行 dsh --profile web 開啟網頁端，在頁面填上 API key —— 環境變數裡已有則略過。另外還有 headless CLI、Python / TypeScript SDK 和 ACP 伺服器。
閱讀教學dsh 外掛怎麼裝？
在 dsh 裡，「安裝」通常是在你的 Profile / Patch 設定裡加一行 —— 每個外掛的 README 都寫了自己的安裝方式。外掛隨之進入外掛樹，刪掉這一行就整體卸載，不留殘餘。
閱讀教學dsh 就是 Claude Code / Codex 嗎？
不一樣。Claude Code 和 Codex 交付的是開箱即用的 Agent；DeepSeek Harness 交付的是一套由你組裝的 Agent 執行環境，任何部分都能被外掛替換或擴充。同類工具，兩種思路。
怎麼讓我的外掛被這個目錄收錄？
幫公開倉庫加上 dsh-plugin topic，並向本目錄同步來源的社群清單提交 PR。topic 路線全自動；進精選清單還能獲得分類和人工撰寫的描述。
閱讀教學