DeepSeek Harness 桌面版指南：安裝、模型支援與成本優化

AI
, , , ,
1

深入解析 DeepSeek Harness 桌面版：從安裝到模型替換、成本優化、優缺點與社群共識，一次看懂這個開源 Agent 框架是否適合你。

DeepSeek Harness（簡稱 dsh）是 DeepSeek AI 於 2026 年 8 月開源的 Agent Harness，以 MIT 授權釋出，核心設計原則是「Everything is a Plugin」（一切皆插件）。它不是一個新的 LLM 模型，而是一套讓模型能使用工具、執行任務、與開發者協作的基礎設施——如果把模型比作大腦，Harness 就是它的身體和工作台。

2026 年 9 月底，DeepSeek 推出 DeepSeek Harness Desktop v0.2 preview，提供 macOS（Apple Silicon）和 Windows x64 的原生安裝包，讓你不需終端機也能使用完整功能。本文將從安裝、模型支援、成本優化到社群評價，帶你全面了解這個備受矚目的開源專案。

什麼是 DeepSeek Harness？

底層架構基於 Cordis 框架，設計理念來自論文 A Programming Paradigm for Spatiotemporal Composability。每一個能力——包括模型轉接器（model adapter）、工具註冊表（tool registry）、session log、甚至 Agent Loop 本身——都是可替換的插件，可透過設定檔替換，而不需要 fork 整個專案。

截至 2026 年 10 月初，GitHub 上已累積超過 243k Stars、29k Forks，是 GitHub 歷史上最快突破 20k Stars 的專案。

桌面版的核心特性

  • 背景常駐執行，可同時跑多個長時間任務
  • 可編輯本地檔案
  • 透過選單列管理 dsh 命令與插件
  • 支援標準模式、PTC 模式、極簡模式和創作模式等 Agent 預設
  • 完整保留 CLI 版的所有功能，包括插件系統、排程任務、Workspace 等

主要用途與使用情境

情境 說明
日常文書處理 整理檔案、處理 Word/Excel/PDF 文件、分析資料、起草文件、製作投影片
程式開發 探索程式碼庫、修 bug、開發新功能、跑測試
研究調查 搜尋資訊、驗證事實、引用來源
背景任務 執行腳本、批次處理檔案、追蹤進度
排程任務 定期執行工作，例如「每週五 17:00 彙整本週專案筆記」
插件開發 透過 Creator Mode 直接用對話方式建立自訂插件

桌面版特別適合不想每次都從終端機啟動的使用者——安裝後可以在 dock 或工作列直接啟動，讓 Harness 像一般桌面應用一樣常駐在你其他工作旁邊。

安裝與使用方式

方法一：官方桌面版（推薦）

  1. 前往 DeepSeek 下載頁下載對應平台的安裝包
  2. macOS（Apple Silicon，需 macOS 13+）：打開 DMG，拖曳至 Applications
  3. Windows x64：執行安裝程式
  4. Linux 使用者目前需使用 CLI / Web UI 路線，或使用社群 Tauri 版
  5. 啟動後登入 DeepSeek 帳號或輸入 API Key
  6. 進入 Settings → Models 設定模型與 Provider

方法二：CLI / Web UI

# 需先安裝 Node.js
npx @deepseek-ai/dsh web
# 預設在 http://127.0.0.1:3080 開啟 Web UI
# SSH 環境加上 --no-open 參數

方法三：從原始碼編譯

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

方法四：社群桌面版

由於官方桌面版最初僅支援 macOS Apple Silicon 和 Windows x64，社群也推出了多個跨平台打包版本：

專案 特色 平台
dsh-tauri/deepseek-harness-desktop Tauri 2 + React 19，安裝包僅 5MB，11 個內建插件 Windows / macOS / Linux
dataelement/dsh-desktop 支援第三方模型、手機續接 session、PPTX 生成 跨平台
agent-earth/deepseek-harness-desktop 輕量本地優先，跨平台 macOS / Windows / Linux

關閉遙測（建議）

HN 社群發現桌面版預設啟用遙測。在首次啟動前，於 ~/.dsh/cordis.patch.yml 加入以下設定可關閉：

- id: desktop-product-telemetry
  disabled: true
- id: product-analytics
  disabled: true
- id: session-log-deepseek
  config:
    enabled: false

可以跑其他模型嗎？

可以，而且這是 DSH 的一大亮點。 DSH 本身是 model-agnostic 的——模型轉接器只是一個插件，可以替換為任何 OpenAI 相容的 endpoint。

支援的 Provider 包括：

  • DeepSeek 官方 API（V4-Pro、V4-Flash 等）
  • Anthropic、OpenAI、Bedrock、Azure 等主流 Provider（內建預設）
  • OpenRouter（透過 Pi LLM SDK 內建支援）
  • 任何 OpenAI 相容的自訂 Provider——在 Settings → Models → Add a custom provider 中輸入 base URL、API protocol、API key 即可
  • 本地模型——可指向 Ollama、LM Studio 或任何本地推理服務

實測中，使用者成功將 DSH 指向 Strix Halo 機器上跑的 Qwen3.8 Flash Next 本地模型。透過 DeepInfra 等第三方推論服務，同一個 endpoint 還可使用 Qwen、Kimi、GLM、Llama 等模型。

更特別的是，DSH 可以把 Claude Code 和 Codex 當作子代理（subagent） 來呼叫——透過 subagent-claude-code 和 subagent-codex 插件，DSH 的外層循環可以用便宜模型跑，需要前沿模型判斷時再委派給 Claude Code 或 Codex，所有軌跡保留在同一個 session 中。

成本優化策略

DSH 支援 per-step 的模型切換，例如：

  • 主循環用 V4-Pro 處理複雜推理
  • 機械性子任務用 V4-Flash，輸出價格相差 14 倍

DeepSeek 自 2026 年 8 月 16 日起採用尖峰/離峰計費，離峰時段為北京時間 01:00-04:00 和 06:00-10:00 以外的時間，費率為尖峰的一半。美國使用者白天使用時正好可享受離峰優惠。

優點

  1. 極致可組合性——從模型轉接器到 Agent Loop 本身，每一層都可替換。社群評論形容它可能成為「harness 界的 Emacs」
  2. 極高的快取命中率——採用 append-only context 設計，避免了其他 harness 常見的快取失效問題。多位使用者回報 90-100% 的快取命中率，大幅降低 token 成本
  3. 透明可觀測——Trajectory view 暴露完整的 append-only session log，可檢查每一個 prompt、回應和 tool call 的原始內容，而非僅看到清理過的聊天介面
  4. 主動除錯——不像其他 harness 會暫停等待使用者介入，DSH 會主動識別執行時錯誤、停止應用程式並啟動除錯流程
  5. AI 可自行寫插件——使用者可以直接在 Creator Mode 中用對話方式讓 AI 建立插件。有 HN 使用者請 DSH 建立一個字體縮放插件和任務完成時響鈴的插件，一次就成功
  6. 可呼叫其他 Agent——Claude Code、Codex、ACP 協議的 Agent 都可作為子程序被委派，實現混合模型策略
  7. 開源 MIT 授權——可自由使用、修改、商用，與 Claude Code 的閉源形成鮮明對比
  8. Headless 模式適合 CI/CD——dsh --profile headless "任務" 可跑單一任務後退出，不監聽任何 port，適合腳本化和 CI 管線

缺點與風險

  1. 仍是 Developer Preview——README 明確警告會有破壞性變更，插件設定可能在 release candidate 之間變動。建議 pin 版本
  2. Token 消耗量大——多位使用者反映系統速度慢、token 用量高。有使用者表示需要先在 Pi Harness 上規劃，再到 DSH 上執行，節省了約 2000 萬 token
  3. 安全漏洞歷史——2026 年 9 月，安全公司 OX Research 披露了 CVE-2026-82533（CVSS 9.4），允許 sandbox 中的 Agent 用一條命令關閉自己的沙盒。DeepSeek 在 3 天內公開修補
  4. Workspace Write 只限制寫不限制讀——沙盒限制 Agent 可寫入的範圍，但不限制讀取。測試中 Agent 第一個動作就是讀取了工作區外 Obsidian vault 的筆記，且無審批提示
  5. 插件品質參差不齊——Reddit 使用者指出，雖然插件數量多，但很多只是原型等級的 demo，真正好用的不到 20 個。不同插件之間可能衝突
  6. 安裝體驗粗糙——首次 npx 啟動可能長時間無輸出，看起來像卡住了；從原始碼安裝需 clone 100+ MB、安裝 800+ 依賴，約 27 分鐘
  7. 遙測與隱私爭議——桌面版預設啟用遙測；session-log-deepseek 會將 session 附加到 DeepSeek API 請求中。雖然可以關閉，但社群對於資料流向中國的擔憂引發了大量討論
  8. 「Done」不等於正確——測試發現 Agent 可能回報成功但產出有問題。Atlas Cloud 測試中，三次建構都印出 “Done” 但只有一次真正可用

社群討論總覽

社群對 DSH 的看法呈現明顯的兩極分化：

正面陣營

  • HN 使用者 wg0 稱其為「Web/Desktop 領域的 OpenCode（甚至比 OpenCode 更好）」，讚揚其輕量、快速，以及子代理可雙向溝通的設計
  • Reddit 使用者回報在 RTX 3090 上跑了 16 小時、處理超過 2000 萬 token，所有任務都成功完成且經過驗證
  • HN 使用者 Kuyawa 用它花了不到 50 美分就建了一個 30 個 RSS 來源的新聞聚合器，稱其為「a beast」
  • Reddit - AISEOInsider 比較測試顯示 DSH 完成初始建構約 11 分鐘，而 Claude Code 約 30 分鐘，速度快約 3 倍

負面陣營

  • Reddit - r/opensource 使用者直言「DeepSeek Harness still feels like a toy」，認為插件品質不一致，不推薦用於正式生產環境
  • X - Zhihu Frontier 引用知乎作者錦恢的深度分析，結論是「promising architecture, ordinary first impressions, and a product that still needs time」——架構有前景，但首次印象普通，產品仍需時間成熟
  • DeepInfra 評測的結論是：opencode 仍是更好的日常驅動，Claude Code 仍是絕對意義上更好的程式開發 Agent。DSH 更適合「在 Agent 之上建構」的人，而非「只是使用 Agent」的人

隱私爭議

HN 討論串中最熱烈的爭論之一是資料安全。一方認為 DeepSeek 來自中國、資料會流向 CCP；另一方則反駁美國公司（Anthropic、OpenAI）同樣與美國政府分享資料，且 DeepSeek 以 10% 的價格提供 95% 的品質。有使用者指出 DSH 是開源的，可以自行編譯，且使用本地模型時不會向 DeepSeek 傳送任何資料（除了 web_search 工具）。

社群共識

綜合各方意見，社群的共識大致如下：

  • 適合誰：正在建構 Agent 基礎設施的人、想要可審計軌跡的人、想用一個 runtime 同時呼叫多種 Agent 的人、想要用便宜模型跑大部分工作的人
  • 不適合誰：需要穩定依賴的人、想要終端機優先且免組裝的人、有截止日期要趕的人、需要 Agent 在筆電關機時持續運行的人
  • 核心判斷：DSH 目前是「可組合的底盤」而非「完成的產品」。它的價值取決於你是「在 Agent 上建構」還是「只是使用 Agent」

與其他 Harness 的比較

DeepSeek Harness opencode Claude Code
授權 MIT MIT 專有
介面 Browser UI、Headless、社群 TUI Terminal-native Terminal-native
模型支援 任意（透過插件轉接器） 任意 僅 Anthropic
成熟度 Developer Preview 已成熟 已成熟
擴充模型 每一層皆可替換 Plugins + LSP Hooks、MCP、Subagents
可呼叫其他 Agent Claude Code、Codex、ACP 否 否

實用建議

  1. 先關遙測再啟動——在首次啟動前編輯 ~/.dsh/cordis.patch.yml
  2. Pin 版本——preview 階段可能有破壞性變更
  3. 用 V4-Flash 跑機械性任務——成本僅 V4-Pro 的 1/14
  4. 善用 Headless 模式做 CI/CD——dsh --profile headless "任務"
  5. 用 --dump-config 檢查組合後的設定——dsh --profile web --dump-config
  6. 不要只看 “Done”——務必檢查實際產出，Agent 可能回報成功但結果有問題
  7. 使用本地模型時——dsh web 不會向 DeepSeek 傳送任何資料（web_search 除外）
  8. 遠端使用——可透過 SSH port forwarding 使用 Web UI
  9. 從原始碼安裝的好處——docs/ 目錄的文件比行銷網站上的完整許多
  10. 善用子代理委派——用便宜模型跑外層循環，需要時委派給 Claude Code 處理複雜任務

結論

DeepSeek Harness 是一個極具野心且可組合性極高的 Agent 框架，桌面版降低了使用門檻，讓更多人能體驗其靈活的插件系統與模型中立設計。然而，它仍處於 Developer Preview 階段，插件品質、穩定性與隱私議題都需要時間驗證。如果你正在建構 Agent 基礎設施，或想用一個 runtime 同時呼叫多種模型與 Agent，DSH 值得一試；但若你需要穩定、成熟的工具，建議等待正式版或繼續使用 opencode 與 Claude Code。