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 命令列速查表
安裝啟動、模式對照、外掛管理、設定檢查、版本固定——每條值得放在手邊的 dsh 指令，逐字對照官方文件核實。
從需求到交付:用 DSH 做完一個真實專案
完整交付流程:追問需求、寫成 CONTEXT.md 與 ADR,整理成 PRD,拆成 GitHub 任務單,再逐單開發、合併、實機驗收。
DeepSeek Harness 子代理與多智慧體實戰
一次啟動五個子代理並行作業：從對話標頭逐一監控、完成報告逐份檢視、為每個子代理指定模型，附逐步截圖
dsh 對話回放與覆盤
打開執行軌跡面板、讀懂結構化回執、按輪次定位失敗，再從任意一步分支重跑，附逐步截圖
dsh 會話備份與遷移：隔離 lane 實操
把 dsh 安裝複製成帶獨立 HOME 和連接埠的隔離 lane，副本驗收後再就地升級，對話按 lane 備份——7 張逐幀核對截圖。
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 等社群客戶端，以及一份安全下載清單。
一步步安裝 DSH Desktop 桌面客戶端
十三步截圖實測：目錄裡 star 數最高的社群客戶端——真實下載連結、macOS DMG 與 Windows NSIS 向導、首次執行，以及拿到檔案後的四項核對。
Ollama 與免費模型
把 DeepSeek Harness 指向 OpenRouter 免費模型或本地 Ollama 服務，不用付費 API key 也能跑會話。
dsh 白嫖免費模型：OpenRouter 實戰
跳過 DeepSeek 金鑰，在設定裡接入 OpenRouter 的 :free 免費模型，再用一個真實的 README 任務驗收——逐幀截圖攻略。
切換模型與自訂 Provider
工作階段中途換模型、接上 NVIDIA NIM 或 Ollama 自訂 Provider，並驗證自己到底在和哪個模型說話。
dsh 用量與費用統計
看懂逐請求用量收據、用 Trajectory 找上下文大戶，再用模型降檔和統計外掛把費用壓下來。
升級 DSH 與外掛
經過核實的升級命令：查版本、升級 dsh CLI、在終端或 Web UI 外掛市場更新外掛，以及安全回滾。
dsh 外掛解除安裝與清理
移除單一外掛、解除安裝 dsh 本體、徹底清理 ~/.dsh 資料目錄——全部對照真實終端機輸出核實。
手機遠端控制 dsh
ngrok 內網穿透把網頁介面掛上公網,在外面用手機連回家裡的 Agent,免裝 App,實測截圖逐步對照。
DSH Web UI 從啟動到手機
dsh web 一條指令啟動網頁版，摸透 3080 工作台、斜線技能與模型設定，再用 dsh-web 生態系把手機接進來——9 步實測截圖
區域網路存取與連接埠
為什麼 http://<你的IP>:3080 只有本機開得了，--port 怎麼用，以及用 dsh-LAN 外掛把 Web UI 連防火牆一起開放給手機。
dsh-pocket：把 DSH 放進口袋
電腦跑 dsh web，手機掃 QR Code 即同步畫面：區域網路直連或 Cloudflare 免費隧道，輸出即時同步、手機可反向操作——7 張逐格核對截圖。
DSH 常見錯誤與修復實操
照錯誤現象對照排查：安裝失敗、外掛導致啟動崩潰、更新後異常，全部步驟附真實錄影截圖，指令與官方 Discussions 交叉核對。
dsh 科研資料分析實戰
101,766 筆 EHR 資料集進，清洗、Cox 迴歸、期刊圖表、Word Results 章節出——逐格核對截圖。
DeepSeek Harness 後悔藥：一鍵撤回與存檔點
安裝 dsh-undo-savepoint，用 WebUI 按鈕、Ctrl+Alt+Z 或對話觸發撤銷，快照管理與崩潰救援全圖解。
dsh-dafeiyu：幫 DeepSeek Harness 裝一隻大肥魚桌寵
一道指令裝好大肥魚桌寵，跟著智慧體的真實任務狀態變換動作——逐格核對的圖文攻略。
dsh 換皮膚：client ui 佈景主題安裝與客製化
dsh 網頁介面換膚圖文教學：一鍵安裝流螢佈景主題，或用 dsh-client-ui-custom 自訂桌布、毛玻璃與六組預設，變更即時套用，附一鍵還原指令。
dsh 本體升級：更新、驗證與還原
外掛更新指南的本體篇：查版本、一條 npm 指令升級、讀懂 changed packages 完成訊息，出問題時用指定版本號裝回去。
dsh 酒館外掛 dsh-tavern:把 SillyTavern 搬進 dsh
角色卡 PNG/JSON 直導、開局選劇本、Guide 引導、單輪重寫、一鍵生圖,再到 /debug-card 自助除錯——12 張幀檢截圖,每步深鏈回源影片。
dsh 記憶外掛 meow-memory:給 dsh 裝上長期記憶
一條指令安裝 meow-memory,圖文拆解首輪整塊注入、memory_* 工具自動呼叫與 dream 閒置整理,附四款外掛選型與 mnemon 費用坑——8 張幀檢截圖,每步深鏈回源影片。
dsh QQ 機器人外掛:把 dsh 接進 QQ
兩條路線、9 張幀檢截圖:dsh-im 外掛掃碼串接 QQ 等 9 大平台,NapCat 協定端跑群組級 bot——每一步都深鏈回源影片。
dsh agent loop 詳解
一次 dsh 對話到底怎麼跑:turn 生命週期、外掛攔截點,以及防止工作階段失控的 loop guard。
四種模式：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/影片模型提示詞,匯出結構化資料對接下游製作。
讓 DSH 看懂圖片：兩種方式
路線一幫 DSH 接上 GLM 視覺模型；路線二裝免費的 dsh-vision-router 外掛——貼一張截圖，得到真正的回答。
把 DSH 接入微信和飛書
安裝 dsh-im、掃一次 QR Code，就能在微信或飛書裡和你的 harness 聊天——倒數計時、手機端確認與機器人回覆全程實錄。
用 DSH 處理辦公工作：一句話做出簡報
裝好 dsh-univer-office，一句話要一份行情簡報，看它查資料、產生六頁投影片、審閱合併並放映——全程實錄。
一段提示詞彙總 Excel 表格
三個部門費用表、1800 行資料：規則、對映與驗收寫進一段提示詞，圖文實錄。
在 DeepSeek Harness 裡玩小遊戲
裝上小遊戲面板，等模型幹活時來一局俄羅斯方塊，順手盯住賬戶餘額。
不寫程式碼，對話做出一個外掛
一句話想法 → 共創規格 → 創造模式開發 → 版本審核：一個外掛的完整誕生記。
把 dsh 部署到伺服器 7×24 常駐
十三張實測截圖:從一台空 VPS 到常運行的 DeepSeek Harness——SSH 與瀏覽器終端機、自訂模型與上下文視窗、不離開分頁裝外掛,建置結果直接給你公開網址。
把調通的流程做成可重複使用的 dsh 技能
七張實測截圖:從你剛調通的一套流程到 SKILL.md——檔案放在哪、name、description、whenToUse 各寫什麼,以及怎麼埋一個假金鑰來驗證它真的生效。
打造你的業務 Agent：從需求到驗收全流程
12 步實錄：先寫驗收標準，再配外掛、批一次權限，1800 筆資料彙總逐項核對。
上下文壓縮與長時間任務
80% 門檻、/compact 與工具結果裁剪如何搭配，長會話不再失控
dsh TUI 終端機上手
在終端機裡跑 dsh：profile 切換、SKILL 管理與背景任務同屏實錄
語音外掛雙場景上手
對 AI 說：本機語音輸入；聽 AI 說：TTS 播報，兩條路線都有逐格實錄
dsh 怎麼找外掛（實拍圖文）
外掛市場、awesome 目錄站、官方管理頁——三條找外掛路徑逐幀實測
把 Obsidian 變成 dsh 知識庫(圖文)
API 金鑰 → 工作區 → AGENTS.md 骨架 → 用庫內文風寫筆記,7 步接入實戰,幀幀可回源
dsh + ComfyUI 全自動影片生成(圖文)
提示詞模板變成技能,ComfyUI 工作流出 15 秒直式大片,顯示卡記憶體在背景自動釋放——全程逐幀核對
dsh 渲染插件:讓回答從能讀到能看(圖文)
raw-html 插件把純文字回答變成 HTML 卡片、圖表、動畫與風格系統——可信模式的安全邊界一併講清
用小鯨魚娘掛件盯住 dsh 餘額
把 dsh-whale-widget 掛進 web profile，設好角落那個顯示 DeepSeek 餘額、今日已用和重新整理倒數的泡泡。
用 AI 美化 dsh 介面
wallpaper-plugin 圖文攻略：外觀三態開關、預設工作室的圖層合成桌布，以及一句話讓 AI 搓出明暗雙模完整主題。
dsh 必裝外掛實操
必裝清單圖文版：把可搜尋的市場裝進管理面板，用星數和腳本稽核做篩選，再上手視覺、側邊欄與背景任務外掛——每步都有逐格核對的截圖。
可驗證的架構圖
讓 agent 畫出能拿去評審的系統圖，而不是一次性的草圖：裝好 archify skill，一句話下需求，然後讀完 9/9 驗證報告再決定信不信這張圖。
dsh 創造模式：對話做自訂 Agent 預設
從預設下拉到沙箱批准、掛載驗證，再到咖啡店營運分析與 Excel 公式核對——創造模式全流程圖文，9 張逐格核對截圖。
dsh 自動程式碼審查：預設與工作臺
唯讀風控審查預設、被預檢與測試把關的編碼預設、能抓 README 與執行時漂移的外掛工作臺——審查閉環 8 張逐格核對截圖。
dsh 無限畫布：用 ThoughtDAG 做會話分支
問題變節點，連線注入摘要或完整上下文，PDF 長出分支，舊 Claude Code 工作階段唯讀匯入——畫布工作流圖文攻略。
設定與開發
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 設定無效。
在 DeepSeek Harness 接上 MCP 伺服器
把 MCP 接進 dsh：Claude Code / Codex 欄位對照怎麼遷移、註冊好的服務卡長什麼樣、要貼上的 mcpServers 設定，以及 dsh 工作階段真正呼叫高德地圖 MCP 的實錄。
用 ACP 把 dsh 接上 Zed
dsh 的 Agent Client Protocol 實戰：官方 automation-only 伺服器和社群互動式路線怎麼選、Zed settings.json 怎麼填，外加一份涵蓋其他 ACP 用戶端的轉接器目錄。
安全與生態
沙箱、值得信任的外掛，以及更大的 dsh 世界。
沙箱、審批與金鑰
dsh 的安全模型：沙箱三檔、審批策略、守衛，以及你的金鑰去了哪裡。
安全地安裝外掛
dsh 裡「安裝外掛」到底發生什麼，附一套第三方程式碼審查清單。
必裝 dsh 外掛推薦清單
從全目錄挑出的 12 個值得優先安裝的外掛，涵蓋各個分類。
dsh 外掛生態盤點
官方套件、社群組織、dsh-plugin topic，以及本 DeepSeek Harness 外掛市集如何保持新鮮。
外掛 API 與 RSS
公開的唯讀 JSON API 與 RSS 訂閱源，查詢完整外掛目錄，無需 API Key。
中文系統教學
中文系統教學
社群累積的系統性中文學習資源，搭配本站教學一起看：從零理解 DeepSeek Harness 的概念、安裝與外掛體系。
系統化中文教學儲存庫
ht426 維護的系統性中文教學儲存庫：從安裝、核心概念到外掛體系逐章推進，適合從頭系統學習。
閱讀教學手把手理解教學
JingHao-Leon 的手把手入門教學：用白話講清 DeepSeek Harness 的心智模型與上手路徑，新手友善。
閱讀教學DSH 藍皮書文件站
dsh.hicyou.com 藍皮書文件站：功能速查、實踐筆記與進階用法，隨版本持續更新。
閱讀教學DeepSeek Harness：10 步全流程導覽
從 git clone 到 headless 模式——安裝、接供應商、配預設、Creator 模式做外掛、沙箱與軌跡收據，一篇導覽走完。
閱讀教學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 路線全自動；進精選清單還能獲得分類和人工撰寫的描述。
閱讀教學