今天發點 DeepSeek Harness 的使用攻略。

最近 DeepSeek Harness 真的有點火，幾天就在GitHub 幹到 12 萬 Stars但是 DeepSeek Harness 發佈後，每天看到的文章都是在說，一行命令啓動，所有東西都是插件。真正體驗過一遍，會發現這些話只描述了入口。

DeepSeek Harness 可以理解成一套給 AI 配工具、管任務的系統。接入後，AI 能讀取和修改文件、運行電腦命令、搜索網頁、拆分任務，還能調用其他 AI 一起工作。整套系統都是開源的，開發者可以根據需要增加、刪除或替換功能。

本文從安裝開始，講清楚 DeepSeek Harness 的配置、四種模式、插件用法、推薦插件。

01. 使用途徑

安裝前，根據官方的要求 Node.js 22 系列至少需要 22.19.0 版本，也可以使用 Node.js 24 或更高版本。

方案一：npm 啓動，適合絕大多數用戶

在 PowerShell 進入準備交給 AI 使用的目錄：

cd "D:\你的項目目錄"npx -y @deepseek-ai/dsh@latest web

命令啓動後，在瀏覽器打開：

http://127.0.0.1:3080

關閉服務時回到 PowerShell，按 Ctrl+C。下次使用時，在同一個目錄重新運行啓動命令。

這條路線適合大多數用戶。npx 會臨時獲取 DeepSeek Harness，無需先把整個源碼倉庫下載到電腦

方案二：源碼安裝，準備開發插件時使用

想閱讀源碼、修改程序或開發插件，可以克隆官方倉庫：

git clone https://github.com/deepseek-ai/deepseek-harness.gitcd deepseek-harnessnpm install -g pnpm@11.7.0pnpm installpnpm run buildpnpm dsh web

更新源碼後重新安裝依賴並構建：

git pullpnpm installpnpm run buildpnpm dsh web

源碼運行不會自動檢查前端文件是否已經重新構建。拉取新代碼後漏掉 pnpm run build，瀏覽器可能繼續顯示舊界面。

方案三：桌面版安裝，適合不想碰命令行的用戶

DSH Desktop 把官方 Harness 的 Web 界面裝進原生桌面應用，安裝包已內置 Electron、Node.js、pnpm 和固定版本的 DSH 依賴，普通用戶不需要單獨配置命令行環境。

打開 GitHub Releases 頁面下載對應平台的安裝包：

https://github.com/anywhere-labs/deepseek-harness-desktop

• Windows x64：下載 NSIS 安裝程序，雙擊運行並按提示完成安裝
• macOS（Apple 芯片）：下載 DMG，打開後將 DSH Desktop 拖入 Applications

首次啓動會自動創建默認 desktop profile，並在本機啓動官方 DSH Web 界面。之後通過桌面窗口和系統托盤使用，關閉窗口即停止服務。

方案四：命令行 TUI 安裝，適合習慣終端操作的用戶

dsh-TUI 是 Claude Code 風格的全屏終端界面插件，前置條件是可用的終端 TTY、pnpm 10+，運行模型還需要配置 DEEPSEEK_API_KEY。

在 PowerShell 執行全局安裝（插件自帶 dsh-tui 直達命令）：

npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui

然後在準備交給 AI 使用的目錄啓動：

cd "D:\你的項目目錄"dsh-tui

首次運行會自動初始化 dsh-tui profile（需要 pnpm）。恢復上次會話用 dsh-tui –resume，退出時在空閒狀態連按兩次 Ctrl+C。下次使用時，在同一個目錄重新運行 dsh-tui。

02. 使用配置

打開 web 頁面後我們需要輸入一個 DeepSeek 的API。

如果想換成其他模型，打開設置 → 模型，在 DeepSeek 卡片中填寫 API Key 並保存。模型配置會在下一次請求時生效，無需重啓服務。

點擊選擇工作區，添加準備讓 AI 處理的目錄並選中，工作區決定 AI 默認操作哪些文件。

新會話默認使用 workspace-write。在這個模式下，AI 可以修改工作區和臨時目錄中的文件；讀取、網絡和進程可見範圍相對寬鬆。

官方 DeepSeek chat-completions 路由當前按純文本處理。自定義視覺模型需要在 $DSH_HOME/settings.yaml 中聲明圖片輸入：

llm-pi-ai:  providers:    my-gateway:      apiKeyEnv: GATEWAY_API_KEY      api: openai-completions      baseURL: https://gateway.example/v1      models:        - id: vision-model          input: [text, image]

這段配置只是聲明接口支持圖片，不會改變模型本身。接口實際不支持圖片時，請求仍會失敗。

03. 四種模式如何選

中文界面提供標準模式、PTC 模式、極簡模式和創造模式。

標準模式

標準模式包含文件編輯、Shell、文件搜索、網頁搜索、Skills、計劃、目標、子代理和工作流。普通用戶可以長期把標準模式設爲默認。

標準模式的工具較多，發給模型的系統說明也更長。複雜任務能得到更多幫助，簡單任務有時會多走幾步。

PTC 模式

PTC 模式保留標準模式的能力，同時把工具交給 Code Mode SDK。模型可以在一段 TypeScript 程序裏連續調用工具，再統一處理結果。

批量搜索幾十個文件、讀取多份結果並統計數據時，PTC 模式可能更省輪次。普通的單文件修改沒有必要專門切到 PTC。

極簡模式

極簡模式只保留持久 Bash 和 str_replace_editor。工具少，首輪上下文也短。模型可能更快進入任務，也可能因爲缺少網頁搜索、計劃和子代理而無法完成某些步驟。

極簡模式適合做固定條件的對比測試。日常使用先看任務是否真的只需要命令行和文本編輯。

創造模式

創造模式在標準模式基礎上增加運行時檢查、插件實驗和 Agent 預設編寫指導。創造模式可以複製現有預設，再修改工具和提示詞。

本機自定義預設通常保存在：

$DSH_HOME/.agent-presets/<預設ID>/

預設可以調用插件和 Shell，修改前會像審查程序代碼一樣檢查權限。

我看有人說極簡模式纔是最好的，但是我想說，極簡模式並沒有讓模型本身變強，而是讓模型在一個極度受限的環境裏跑。

沒有了，聯網搜索、任務規劃、Skills 技能、子 Agent、上下文壓縮這些功能。

04. 插件安裝

插件可以給 DeepSeek Harness 增加新功能。插件來源包括 npm 包、GitHub 倉庫、壓縮包和本地目錄。

DeepSeek Harness 目前沒有統一審覈的官方應用商店。

大家可以通過在 GitHub 搜索帶 #dsh-plugin 話題的項目來找插件。

雖然 Web 可以用 npx 直接啓動，官方插件命令仍會調用 pnpm 管理依賴，所以安裝插件前要先裝 pnpm：

npm install -g pnpm@11.7.0pnpm -v

然後檢查當前版本：

pnpm dsh --version

插件 README 如果明確要求 rc.6，rc.5 源碼運行時可能無法加載。

之後就可以安裝插件：

npx -y --package @deepseek-ai/dsh@latest dsh plugin --profile web add <包名或Git地址>

查看已安裝項目：

npx -y --package @deepseek-ai/dsh@latest dsh plugin --profile web list --depth 0

更新和移除：

npx -y --package @deepseek-ai/dsh@latest dsh plugin --profile web update <包名>npx -y --package @deepseek-ai/dsh@latest dsh plugin --profile web remove <包名>

源碼用戶運行時把命令開頭換成 pnpm dsh。

安裝完成後重啓 dsh web，再按 Ctrl+Shift+R 硬刷新瀏覽器。

05. 插件推薦

插件不用一次裝很多。普通用戶可以根據任務來裝插件。記憶、多 Agent 和自動化會改變任務上下文或執行方式，熟悉基礎功能後再安裝。

推薦插件 1：dsh-at-file，在輸入框裏引用文件

npx -y --package @deepseek-ai/dsh@latest dsh plugin --profile web add https://github.com/omdsh-dev/dsh-at-file/archive/refs/tags/v0.6.0.tar.gz

輸入 @ 後搜索工作區文件或目錄，選中後把路徑加入消息。插件不會在提交時把整個文件塞進提示詞，Agent 會在需要時讀取對應路徑。

推薦插件 2：Better Sidebar，增加文件、終端和 Git 面板

npx -y --package @deepseek-ai/dsh@latest dsh plugin --profile web add dsh-better-sidebar@0.12.2

Better Sidebar 提供文件樹、編輯器、文檔預覽、內嵌瀏覽器、終端、Git diff 和後台任務面板。文件較多、經常查看修改結果的用戶，可以少在瀏覽器和文件管理器之間切換。

推薦插件 3：ModLens，讓純文本模型讀取圖片

npx -y --package @deepseek-ai/dsh@latest dsh plugin --profile web add @liustack/modlens3.16.6

ModLens 把圖片發送給選定的視覺 Provider，再把 OCR、佈局和內容說明交給文本模型。報錯截圖、設計稿、圖表和網頁參考圖都可以通過這條方式處理。

推薦插件 4：dsh-memento，增加跨會話記憶

npx -y --package @deepseek-ai/dsh@latest dsh plugin --profile web add dsh-memento

dsh-memento 用本地 SQLite 保存記憶，並提供寫入批准、字符上限和審計記錄。默認策略是每次寫入都詢問用戶。

推薦插件 5：dsh-automation，按時間運行獨立任務

npx -y --package @deepseek-ai/dsh@latest dsh plugin --profile web add github:titanwings/dsh-automation#v0.1.5

dsh-automation 可以創建定時或一次性任務。每次執行都會新建 Agent 和會話，並記錄工作區、權限、結果和錯誤。

06. 挖一挖

DeepSeek Harness 目前是一套開放程度很高的 Agent 工具。模型接口、工具、工作模式、會話記錄和界面都可以通過插件重新組合。開發者因此能看到 Agent 每一步接收了什麼信息，又爲什麼調用某個工具。

但是開放也帶來了額外工作。用戶需要自己處理 Node.js、API Key、模型費用、插件版本和權限。Developer Preview 的更新速度很快，今天可用的社區插件，明天升級後可能就需要重新配置。

DeepSeek Harness 插件可能接觸文件、網絡、API Key 和進程。插件越開放，安裝前的來源檢查、版本固定和權限說明越重要。

DeepSeek Harness 給了開發者較深的修改權限，這也是 DeepSeek Harness 和 Codex、Claude Code 的主要區別。Codex 與 Claude Code 的日常產品體驗更成熟，DeepSeek Harness 更適合研究和定製 Agent 本身。

願意花時間配置的用戶，可以更清楚地知道 AI 做了什麼，也能把 Agent 改成更符合自己工作習慣的樣子。

原文鏈接：DeepSeek Harness 保姆級教程，附4種使用途徑和必裝插件