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、完成第一個任務、選對模式。
dsh 對比 Claude Code
客觀比較：開放程度、價格、模型自由度與可擴充性。
Claude Code 免費替代方案
不花錢的開源 AI coding 工具盤點，以及 dsh 的位置。
設定與開發
Profile、Preset，以及寫自己的外掛。
安全與生態
沙箱、值得信任的外掛，以及更大的 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 路線全自動；進精選清單還能獲得分類和人工撰寫的描述。
閱讀教學