# 影片筆記：DeepSeek Harness一键安装！不用命令行，双击直接部署｜从0配置API Key、网页开发到插件接入，完整跑通DSH实战流程


<!-- VIDEONOTE_PUBLICATION_WARNINGS_BEGIN -->
## ⚠️ 可先使用，仍有待修正項目

本筆記已完成可閱讀的逐字稿與時間跳轉；下列為待處理問題，建議播放原片確認。

- 待修正：逐字稿全文快速校讀未完成（已保留自動字幕/原始逐字稿並繼續生成筆記。；未完成的全文速讀項目可在精進模式回聽確認。）

<!-- VIDEONOTE_PUBLICATION_WARNINGS_END -->

## 一句話總結

DeepSeek Harness (DSH) 正式開源並推出免命令行的桌面端應用，解決普通用戶環境配置難題；該工具定位為通用 Agent 開發範式，採用「一切皆插件」架構，支援一鍵部署、API Key 配置及豐富的插件生態，並在性能與 Token 消耗上展現出優於競品的潛力。

## 核心重點

1.  **產品定位與架構**：
    *   DSH 被定義為通用的 **Harness 系統**（工程化腳手架/範式），而非單純的編程助手。
    *   底層採用類似 **Cordius** 的架構（類比 QQ 底層通信機制），強調「一切皆插件」，允許用戶自由插拔 Agent Loop、工具註冊等核心組件。
    *   核心概念包含 **Profile**（插件組裝後的基礎配置表）與 **Punch/Patch**（運行時的具體參數與執行對立）。

2.  **安裝與部署優勢**：
    *   針對普通用戶卡在環境安裝與命令行操作的痛點，團隊開發了 **DSH 桌面端應用**。
    *   桌面版內置 Node.js 環境，支援雙擊 APP 自動完成部署，無需用戶自行配置命令行。
    *   官方原版部署需自行安裝 Node.js 並通過 `npx deepseek-ai/dsh web` 啟動服務。

3.  **性能與生態表現**：
    *   性能測試顯示，DSH 搭配 **DeepSeek V4 Pro** 在運行效率與 Token 消耗上優於 **Codex** 搭配 **GPT-5.6**（Token 消耗約為後者的三分之一，運行時間約為一半，且具備高緩存命中率）。
    *   內測期間邀請 GitHub 高 Stars 項目作者參與，建立了豐富插件生態，支持將現有開源項目（如 Open Design）直接接入為插件。

4.  **功能與模式設定**：
    *   提供四種 Agent 預設模式：**標準模式**（完整編碼 Agent）、**TPC 模式**（支援 TypeScript 組合操作）、**極簡模式**（提升速度）、**創造模式**（支援自定義 Agent）。
    *   支援權限管理（只讀、工作區寫入、完全訪問）及 Session 導出。
    *   桌面端獨有功能包括背景切換（換皮膚）及視覺模型增強功能（調用阿里百煉 API Key）。

## 詳細大綱

### 一、 DeepSeek Harness (DSH) 概述與安裝痛點
*   DSH 正式開源，但普通用戶面臨環境配置、命令行操作等門檻。
*   團隊推出 DSH 桌面端應用，解決安裝難題，提供免命令行安裝、雙擊 APP 自動部署。

### 二、 DSH 桌面端應用功能介紹
*   內置視覺模型增強功能（調用阿里百煉 API Key）。
*   支持換皮膚、同步官方最新版本。
*   桌面版與官方命令行安裝方式的性能一致，但桌面版更為簡單。

### 三、 DSH 與競品 (Codex/Cloud Code) 的性能對比
*   測試結果顯示 DSH 運行效率更高，Token 消耗約為 Codex + GPT-5.6 的三分之一。
*   運行時間約為一半，緩存命中率高。
*   DeepSeek V4 Pro 在編程指標上與 Feybo 5 有來有回，甚至部分超標。

### 四、 DSH 的核心架構與定位
*   **定位**：通用的 Harness 系統（工程化腳手架），而非單一編程 Agent。
*   **理念**：「一切皆插件」，提供智能插座，用戶可自行組裝 Agent。
*   **底層技術**：基於 Cordius 架構（類似 QQ 底層通信機制），提供自由插拔能力。
*   **核心概念**：
    *   **Profile**：插件組裝後的基礎配置表（規定能做什麼、不能做什麼）。
    *   **Punch/Patch**：運行時的具體參數與執行對立（運行時架構）。

### 五、 插件生態與開源項目接入
*   內測期間邀請 GitHub 高 Stars 項目作者參與，快速建立豐富生態。
*   支持將現有開源項目（如 Open Design、繪製思維導圖/產品原型項目）接入為插件。
*   區別於 XIGBT 的插件市場模式，DSH 允許任意項目通過開放接口接入。

### 六、 實際安裝部署流程（官方原版 vs 桌面版）
*   **官方原版部署步驟**：
    1.  下載並安裝 Node.js（Windows/Linux/Mac）。
    2.  驗證環境：終端輸入 `node -v` 和 `npm -v`。
    3.  啟動服務：使用命令 `npx deepseek-ai/dsh web`。
    4.  訪問介面：運行後彈出端口 3080，複製 `127.0.0.1:3080` 至瀏覽器打開。
    5.  API Key 配置：首次進入需輸入 Deep Seek API Key，默認支持 Deep Seek 模型，也可點擊「稍後配置」更換其他模型 API Key。
*   **桌面版安裝**：由講者團隊提供，安裝路徑不同但性能一致，內置 Node.js 環境，無需用戶自行部署。

### 七、 DeepSeek Harness 介面與運行機制解析
*   **對話與響應流程**：用戶輸入指令 -> 模型上下文注入 -> Think（思考鏈） -> 返回結果。
*   **介面顯示內容**：
    *   上下文注入顯示：清晰展示運行前注入的上下文內容，包括 `DSH-System Prompt`。
    *   思考鏈（Think）：展示模型的思考過程。
    *   運行軌跡：顯示用戶輸入與模型響應的對應關係。
    *   技術指標：顯示緩存命中情況、輸入/輸出 Token 數量、響應時間等。
    *   Session 管理：支持 Session 導出與下載。
*   **基本操作功能**：支持模式切換、輸入命令、圖片輸入、選擇模型與推理等級。

### 八、 項目管理與工作區設定
*   **主目錄重要性**：需認清主目錄，因為隱藏文件、Agent CMD 等文檔均位於對應操作目錄中。
*   **工作區與對話管理**：左側為當前項目管理區域，支持添加新對話、新增工作區（理解為文檔），自由切換對話。

### 九、 Agent 預設模式（Preset）與權限設定
*   **Agent 預設模式（四種）**：
    1.  **標準模式**：功能完整的編碼 Agent（類似 Codex），包含文件編輯管理、Shell 命令行操作、文件與網頁檢索、Skills、Tools。支持 Plan（計劃模式）與 Goal（目標模式）。
    2.  **TPC 模式**：具備標準模式全部能力，通過 CodeModel SDK 呈現工具，讓模型使用 TypeScript 程序組合多個操作，支援並行操作。
    3.  **極簡模式**：主要操作本地 Bash 和文件夾，移除部分功能以提升速度。
    4.  **創造模式**：具備標準能力全部能力，支持在標準能力基礎上增加自定義 Agent。Preset 概念類似 Profile 的關鍵參數定義。
*   **權限設定**：Read Only（只讀）、Workspace Write（可寫）、Full Access（讀寫刪除均可，警告誤選可能導致大量文件被刪）。

### 十、 模型與插件系統
*   **模型接入**：支持自由添加模型，可更換 Deep Seek API Key 或增加其他選項，支持自定義設置方便本地部署特殊格式大模型。
*   **插件系統**：插件列表展示標準模式下支持的核心功能。用戶不能直接通過列表進行過多操作或切換，否則會導致當前模式失效。

### 十一、 實際測試演示
*   **測試任務**：編寫個人簡歷網站。
*   **運行過程**：輸入複雜指令，Agent 進行運行與規劃，生成前端代碼。
*   **結果評估**：生成了一個個人簡歷網站模板，整體交互、背景隔板、運行效果不錯，基本審美在線。
*   **限制**：目前不具備生成圖片（深圖）能力，圖表與 SVG 圖片均為示意圖編寫。

## 工具 / 模型 / 名詞整理

*   **DeepSeek Harness (DSH)**：影片主要介紹的產品，被稱為 Deep-Sea Carnage / Deep-Carnies / Deepstick Harness / Deep-C Chronicles / Deep-Sea Cardness / Deepseq / Deep-Z-Harness 等（疑點：聽寫變體）。
*   **Codex / Codex APP / Codex Cloud Code / Clockcode / Kodax**：競品名稱，疑點：聽寫變體。
*   **Cloud Code**：競品名稱。
*   **Node.js**：開發環境。
*   **NPM / NPX**：Node.js 庫管理與包執行器。
*   **DeepSeek V4 Pro / Deep-seek V4 Pro / Deep-seek vs Pro**：模型名稱，疑點：聽寫變體。
*   **GPT-5.6 / GPT5.6sau / GBT5.6 / GP5.6**：模型版本號，疑點：聽寫變體。
*   **Feybo 5**：模型或產品名稱，疑點：聽寫變體。
*   **阿里百煉**：提供視覺模型 API Key 的服務。
*   **千萬系列模型 / 千萬3.8 / 千問系列模型**：疑似指代阿里百煉旗下的具體模型版本，疑點：聽寫變體。
*   **Cordius / Cordis**：底層架構名稱，疑點：聽寫變體。
*   **LongChain**：被提及為受衝擊的框架。
*   **Open Design / OpenDXR**：開源設計項目。
*   **QQ**：作為 Cordius 架構類比的例子。
*   **XIGBT**：被提及作為插件市場失敗的案例，疑點：聽寫變體。
*   **TypeScript**：編程語言。
*   **Bash**：命令行工具。
*   **SVG**：圖片格式。
*   **TPC 模式**：Agent 預設模式之一。
*   **Profile**：插件組裝後的基礎配置表。
*   **Punch/Patch**：運行時的具體參數與執行對立。
*   **Think**：思考鏈。
*   **Session**：會話管理。
*   **Agent CMD**：Agent 命令行文檔。
*   **NPA**：本地環境運行相關縮寫，疑點：聽寫變體。
*   **Deepseek Provider**：模型請求相關組件。
*   **Segu**：提及作為對比體系，疑點：聽寫變體。
*   **TileCode**：Codex 相關功能，疑點：聽寫變體。
*   **SGUES PLAN**：特定功能名稱，疑點：聽寫變體。
*   **子理工作流**：特定術語，疑點：聽寫變體。
*   **STERS / 80多K的stars / 8萬多的STARS**：GitHub Stars 數量，疑點：聽寫變體。
*   **勾字系統**：疑似指代 "Hook" 系統，疑點：聽寫變體。
*   **不我毛**：形容換皮膚後的形象，疑點：聽寫變體。
*   **撥刃**：疑似指代 "預設" 或 "默認" 設置，疑點：聽寫變體。
*   **手法法**：疑似指代 "功能" 或 "操作"，疑點：聽寫變體。

## 操作流程整理

### 官方原版部署流程
1.  **下載 Node.js**：從 Node.js 官網下載對應版本安裝包。
2.  **安裝 Node.js**：點擊安裝，一路點擊下一步完成。
3.  **驗證環境**：打開終端（以 MacOS 為例），輸入 `node -v` 和 `npm -v` 檢查版本是否裝好。
4.  **啟動服務**：
    *   使用命令：`npx deepseek-ai/dsh web`。
    *   命令解析：`npx` 為 Node.js 庫安裝包；`deepseek-ai` 為官方庫名；`dsh` 為組件名；`web` 代表啟動 Web 服務。
    *   首次運行會下載或更新對應庫。
5.  **訪問介面**：運行後彈出端口 3080，複製 `127.0.0.1:3080` 至瀏覽器打開。
6.  **API Key 配置**：首次進入需輸入 Deep Seek API Key，默認支持 Deep Seek 模型，也可點擊「稍後配置」更換其他模型 API Key。

### 桌面版部署流程
*   由講者團隊提供安裝包。
*   雙擊 APP 自動完成部署，內置 Node.js 環境。
*   無需用戶自行配置命令行，點擊拖拽即可使用。

### 介面基本操作
1.  **模式切換**：默認為標準模式，可切換至 TPC、極簡、創造模式。
2.  **輸入指令**：點擊加號輸入命令，支援圖片輸入。
3.  **模型選擇**：選擇模型與推理等級（演示全程使用 Flash 模型）。
4.  **Session 管理**：支持 Session 導出與下載。
5.  **工作區管理**：左側為當前項目管理區域，支持添加新對話、新增工作區。

### 權限設定
*   根據需求選擇：Read Only（只讀）、Workspace Write（可寫）、Full Access（讀寫刪除均可）。

## 值得注意的限制或風險

1.  **文件刪除風險**：選擇 **Full Access**（完全訪問）權限時，誤操作可能導致大量文件被刪除。
2.  **插件操作限制**：用戶不能直接通過插件列表進行過多操作或切換，否則會導致當前模式失效（例如刪除 API 插件會導致無法接入模型）。
3.  **圖片生成限制**：目前 DSH 不具備生成圖片（深圖）能力，圖表與 SVG 圖片均為示意圖編寫。
4.  **模型名稱辨識**：影片中提及的模型名稱（如 GPT-5.6、Feybo 5、DeepSeek V4 Pro 等）可能存在聽寫錯誤，實際性能對比需以官方數據為準。
5.  **架構名稱辨識**：底層架構名稱 "Cordius" 及相關術語可能存在聽寫錯誤，需進一步查證。

## 逐字稿辨識疑點

*   **產品名稱變體**：Deep-Sea Carnage / Deep-Carnies / Deepstick Harness / Deep-C Chronicles / Deep-Sea Cardness / Deepseq / Deep-Z-Harness。這些名稱在逐字稿中頻繁出現，疑似均指代 "DeepSeek Harness"，但聽寫極不統一。
*   **競品名稱變體**：Codex Cloud Code / Clockcode / Codex APP / Kodax。這些名稱疑似將 "Codex" 與 "Cloud Code" 混淆或口誤。
*   **模型版本號變體**：GPT-5.6sau / GBT5.6 / GP5.6。模型版本號疑似聽寫錯誤，通常為 "GPT-4" 或 "GPT-4o" 等，需查證。
*   **不明確模型/產品**：Feybo 5、Segu、XIGBT、NPA、Deepseek Provider、TileCode、SGUES PLAN、子理工作流、TPC 模式。這些名稱在逐字稿中出現，疑似特定產品名稱、功能名稱或聽寫錯誤，需查證具體指代。
*   **阿里模型變體**：千萬3.8 / 千萬系列模型。疑似指代阿里百煉旗下的具體模型版本（如 "千問" 系列），需查證。
*   **架構名稱變體**：Cordius / Cordis。底層架構名稱，疑似指代 "Cordis" 或其他特定架構名稱，需查證。
*   **其他聽寫錯誤**：STERS / 80多K的stars / 8萬多的STARS（GitHub Stars 數量稱呼）、勾字系統（疑似 Hook 系統）、不我毛（形容換皮膚後的形象）、撥刃（疑似預設/默認設置）、手法法（疑似功能/操作）。

## 可延伸追問

1.  **DeepSeek Harness 的 "Cordius" 架構具體是什麼？** 影片中將其類比為 QQ 底層通信機制，但 "Cordius" 或 "Cordis" 是否為真實存在的開源架構或內部代號？
2.  **DSH 與 Codex/Cloud Code 的性能對比數據來源？** 影片中提到的 "DeepSeek V4 Pro" 與 "GPT-5.6" 的性能對比，其測試環境、Prompt 設計及評估標準為何？
3.  **"TPC 模式" 與 "CodeModel SDK" 的具體技術實現？** 如何通過 TypeScript 程序組合多個操作進行並行操作？
4.  **DSH 插件生態的開放程度？** 目前是否允許第三方開發者自由發布插件？接入現有開源項目（如 Open Design）的具體技術門檻為何？
5.  **桌面版與官方命令行版的差異細節？** 除了安裝便利性外，兩者在功能完整性、更新頻率及穩定性