DeepSeek Harness 藍皮書 — 一本dsh實戰指南

DeepSeek Harness 藍皮書是一份以真實任務爲主線的實戰指南，30 章正文加 4 篇附錄，七萬五千字，開源 放在網上，打開就能讀。它講的是怎麼把一個命令行智能體框架用順：從第一個能驗收的智能體開始，一路到能反覆調用的工作系統，首頁寫着三天入門的目標。歸到 AI教程 這一類，它屬於能邊看邊敲的實戰書；做 AI編程 的人順着目錄走，基本就是一條上手路線。

dsh，全名 DeepSeek Harness，是 DeepSeek 在 2026 年 8 月 13 日放出來的智能體運行框架。官方給的等式是：模型加框架，纔等於一個能幹活的智能體——大語言模型 負責想，框架負責讀文件、敲命令、調接口、管上下文、做計劃。它跟常見的編碼助手不是一類東西：後者是成品，工具、會話、沙箱全封在一個殼裏。dsh 只管底下那一層，寫代碼是它預置的一套組合，也能拼出跟編程無關的活。

功能特點

• 真實任務驅動：每章內容來自真實實操——命令、截圖、報錯全部真實，可照做復現

• 6 種語言：中文（默認）、English、日本語、한국어、Español、Português

• 插件優先：圍繞 dsh"一切皆插件"架構展開——從會裝、會寫到會發

• E-INK 風格：米白紙底、墨字、熒光黃標註，零干擾動效

• 圖片查看器：點擊放大、Ctrl+滾輪縮放、左右鍵切換、拖拽平移、ESC 退出

六段路徑，按目標進

首頁把 30 章切成六段，每段標着覆蓋的章節號，可以挑着讀：

• PART 01 從 0 到 1（第 2 至 7 章）：認識、安裝、第一次對話、命令行、配置模型、排障，新手從這裏進。

• PART 02 理解骨架（第 8 至 10 章）：插件樹怎麼搭起來的、核心子系統與消息流轉、會話日誌。

• PART 03 組裝智能體（第 11 至 16 章）：工具與沙箱、子代理、定時任務、本地部署。

• PART 04 會裝會寫會發插件（第 17 至 23 章）：從裝第一個插件、寫 hello-plugin，到造工具、寫鉤子、做界面、發佈。

• PART 05 場景實操（第 24 至 26 章）：個人網站、演示文稿、視頻。

• PART 06 生產與生態（第 27 至 29 章）：部署選型、安全合規、可觀測與上下文管理。

另外還有 PART 00 開篇（爲什麼學、怎麼讀）和 4 篇附錄：術語表、命令速查、學習路徑、面試題。就算不打算馬上動手，把它當 AI資料 翻一遍，這套框架的骨架也能摸清。

每章一個固定套路

每章開頭標出全文字數、預估耗時、前置條件和難度，正文按「本章目標 → 動手 → 按圖片內容分小節 → 這一章學到了什麼」走。章末那節是一份勾選清單，能自己檢查到底學會沒有。

圖是真的，看也方便

全書 120 張配圖都是真實截圖，命令、報錯都不做假。頁面是米白紙底配墨字、熒光黃標註的紙感風格，點圖能放大，滾輪縮放、左右鍵切換、拖着看、按退出鍵關閉。

寫書也有硬規矩

作者在倉庫裏寫明瞭寫作規範：內容必須能覈驗，命令和截圖不許編造；用第一人稱實操口吻寫，保留真實踩過的坑，句子要短；核心概念一律配自己畫的架構圖；演示統一用一個帶視覺的模型；每個動手章還要補一節「讓 dsh 自己搭」，給出一條能直接用的提示詞。

六種語言與協作流程

站點支持中文、英文、日文、韓文、西班牙文、葡萄牙文六種語言，中文是源語言。改內容只改中文，改動記進根目錄的一個日誌文件，收到翻譯指令後才按中文到英文、再到其餘四種語言的順序翻，翻完刪掉日誌。

整本也能自己搭一份

它是靜態站點，裝好依賴後能在本地跑起來邊改邊看，構建產物輸出到一個固定目錄，可以丟到常見的靜態託管平臺。習慣自己折騰 開發者工具 的人，照這套結構改也很省事。