DeepSeek Harness 是 DeepSeek 開源的插件化 Agent 框架，本文解析其 Cordis 架構、四種運行模式、安裝步驟、Reddit 社群的正反評價與適用場景，助你判斷是否採用。
DeepSeek Harness（CLI 指令為 dsh）是 DeepSeek AI 於 2026 年 8 月 13 日開源的 Agent Harness（智能體執行框架），採用 MIT 授權。它的核心設計理念是「Everything is a Plugin」（一切都是插件），讓 LLM 變成可執行多步驟任務的自主 Agent。本文將解析其架構、安裝方式、四種預設模式、社群評價與適用場景。
核心架構與設計理念
插件化架構（Powered by Cordis）
DeepSeek Harness 基於 Cordis meta-framework 構建，這是一個以「時空可組合性（Spatiotemporal Composability）」為核心的編程範式。所有 Agent 能力皆以插件形式實現，包括：
- Models（模型適配器）
- Tools（工具註冊表）
- Skills（技能模組）
- Sessions（會話狀態處理器）
- Sandboxes（沙箱環境）
- Storage（存儲系統）
- Loops（執行循環）
- Scheduling（調度器）
- UI（使用者介面）
開發者無需修改 DeepSeek Harness 原始碼，即可在配置層替換或擴展任一能力。
四種預設運行模式
v0.1 開發者預覽版提供四種基線配置：
| 模式 | 描述 |
|---|---|
| Standard | 完整 Agent 環境，含 shell 執行與網頁檢索工具 |
| Code | SDK 介面，允許模型在程式化批次中執行多步驟工具調用 |
| Minimal | 限制為持久 shell 會話與文字編輯工具 |
| Creator | 診斷環境，用於測試插件配置 |
安裝與使用
快速啟動（Web UI）
使用 npx 即可啟動本地 Web UI：
npx @deepseek-ai/dsh web
預設在 http://127.0.0.1:3080 啟動。
從原始碼運行
git clone https://github.com/deepseek-ai/deepseek-harness
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
注意事項
- 目前為 Developer Preview，會有破壞性變更（compatibility-breaking changes）。
- 需安裝 Node.js，主要語言為 TypeScript（97.1%）。
- 預設語言為中文，需手動切換至英文。
Reddit 社群討論重點
正面評價
- 性能優異：有使用者表示「DSH performs exceptionally well」，特別是 Code Mode 受到高度評價，UI 設計也受到讚賞。
- 無需等待用戶互動：與其他 Harness 不同，它不會暫停等待用戶確認，而是主動識別運行錯誤並調試。
- 高快取命中率：多位使用者報告 90-99% 的 cache hit rate，顯示其上下文管理效率極高。
- 可擴展性強：有開發者已建立自定義插件（自動標題會話、git worktree 管理、即時成本顯示等），認為其「far surpasses Reasonix and Pi」。
- 成本效益：相比其他 Harness，每會話成本更低。
負面評價與問題
- 速度慢、Token 消耗高：有使用者指出系統運行緩慢且極度消耗 token，建議先在 Pi Harness 規劃再移植到 DSH 以節省約 20M tokens。
- UI 令人困惑：
.agents中的 skills 不會自動載入，文件缺乏直觀解釋，CLI 模式文件不明確。 - 子代理（sub-agents）問題：sub-agents 存在不少 bug 和 glitch，但社群理解這是 pre-release 階段的正常現象。
- 模型品質參差：有使用者認為「a significant drawback is its subpar model」，但可連結其他提供商的模型來解決。
- 工具請求過多：類似 GitHub Copilot 的問題，系統提示詞過大，工具本身也消耗大量資源。
社群生態
- 已建立專屬 subreddit：r/DeepSeekHarness
- 官方 Discord 社群與 GitHub Discussions 提供反饋管道。
- 開發者積極建立插件，生態系統快速成長中。
與其他 Agent Harness 的比較
| 特性 | DeepSeek Harness | Claude Code | Pi Harness |
|---|---|---|---|
| 架構 | 插件化（Cordis） | 固定工作流 | 插件化 |
| 授權 | MIT（開源） | 閉源 | 開源 |
| UI | 本地 Web UI + CLI | CLI 為主 | CLI |
| 快取命中率 | 90-99% | 未公開 | 未公開 |
| 子代理支援 | 有（pre-release bug 多） | 有 | 有 |
| 成本 | 較低 | 較高 | 中等 |
技術亮點與創新
- 可組合性（Composability）：基於 Cordis 的設計，允許開發者將不同插件自由組合，創造出適合特定場景的 Agent 配置。
- 事件日誌系統：內建 append-only event logging system，用於追蹤執行活動，便於調試與審計。
- 跨模型支援：雖然為 DeepSeek 模型優化，但可連結幾乎任何提供商的模型（包括 Claude Code、Codex 作為子代理）。
- 微核心架構：功能單元作為獨立擴展載入，而非單體模組，提升系統穩定性與可維護性。
適用場景與限制
適合
- 需要高度自定義 Agent 工作流的開發者
- 想實驗不同模型、工具、技能組合的研究人員
- 構建多步驟自主任務的應用（如自動化編碼、資料處理）
- 成本敏感且需要高快取效率的場景
不適合
- 追求穩定生產環境（目前為 Developer Preview）
- 需要完整中文文件與直觀 UI 的初學者
- 對 token 消耗極度敏感的輕量級應用
總結
DeepSeek Harness 代表了一種新的 Agent 基礎設施範式——將所有能力插件化，讓開發者能像組裝樂高一樣構建自主 Agent。雖然目前仍處開發者預覽階段，存在速度慢、token 消耗高、子代理 bug 等問題，但其高快取效率、低成本、強大的可擴展性已吸引大量開發者關注與貢獻。對於正在尋找 Claude Code 或 Pi Harness 替代方案的技術團隊，DSH 值得密切關注與實驗。