部署上手

DEPLOY

從零到跑起來，四步。全部指令都與官方 README 逐條核對過。

安裝 CLI

npx 一行指令直接跑，macOS / Linux / Windows 都行，Node 22.19+ 即可。

串接模型

填入 DeepSeek API key，或接 Ollama 直接用你本機跑的模型。

啟動

終端機裡直接開工；不愛看命令列，用 dsh web 啟動瀏覽器介面。

裝第一個外掛

從精選清單挑一個裝上——從這裡開始，一切皆外掛。

REQUIREMENTS

runtime · readme_wording

Install `Node.js`, then run: npx @deepseek-ai/dsh web

runtime · package_json_engines_node

^22.19.0 || >=24.0.0

runtime · package_json_packageManager

pnpm@11.7.0

runtime · root_package

@deepseek-ai/dsh-root 0.1.0-rc.7

runtime · engines_source_url

https://raw.githubusercontent.com/deepseek-ai/de…

linux_build_tools_note

官方未寫，但社群討論(#1772/#49/#897)證實 Linux 上 node-pty 原生模組需本機編譯：Debian 需 build-essential,Arch 需 base-devel,g++ 需支援 gnu++20(GCC 10+)

status_warning

DeepSeek Harness is currently in _developer preview_ and is iterating rapidly. THERE WILL BE COMPATIBILITY-BREAKING CHANGES.(README 原文）

npx 直接執行（官方 README 首選）

★

npx @deepseek-ai/dsh web

原文

原始碼執行(pnpm)

git clone https://github.com/deepseek-ai/deepseek-harness.git

cd deepseek-harness

pnpm install

pnpm run build

pnpm dsh web

原文

Ollama 整合（本機/私有化）

ollama launch dsh

原文

npm 全域安裝（社群用法，官方 README 未列）

npm install -g @deepseek-ai/dsh

dsh web

原文

MODEL

api · deepseek_key

Web UI 內 Settings → Models，在 DeepSeek 卡片填入 API key（來自 https://platform.deepseek.com/ )並儲存；官方原文："The model route becomes usable immediately without restarting the server"（儲存即生效，無需重新啟動伺服器）

api · key_storage

providers.md 原文："Keys are write-only. The page receives a redacted descriptor after saving, never the literal secret. The key is stored in `$DSH_HOME/.credentials.yaml`"；模型定義存放在 $DSH_HOME/settings.yaml

api · catalog_providers

Anthropic

api · catalog_providers

OpenAI

api · catalog_providers

Bedrock

api · catalog_providers

Vertex

api · catalog_providers

Azure

api · catalog_providers

Codex

api · catalog_config

Add provider → 選廠商 → 填 API key → 儲存；Bedrock/Vertex/Azure/Codex 分別用 AWS 憑證+region、ADC project、api-version、OAuth

api · env_var

憑證可用環境變數注入（設定範例中的 apiKeyEnv 欄位，如 GATEWAY_API_KEY)

api · source_url

https://github.com/deepseek-ai/deepseek-harness/…

local · custom_openai_compatible

Add a custom provider：填 Provider ID（小寫、永久）、顯示名稱、base URL、API 協定、憑證、至少一個模型；支援 Fetch available models 呼叫 OpenAI 相容的 GET /models 自動拉取模型清單，不支援的端點就手動填模型名稱

local · ollama

ollama launch dsh 一條指令完全在本機執行，預裝 Ollama web search 外掛(Ollama 官方說法）

local · source_url

https://github.com/deepseek-ai/deepseek-harness/…

LAUNCH

web_ui · command

npx @deepseek-ai/dsh web

web_ui · alias

dsh web 是 dsh --profile web 的別名

web_ui · default_address

http://127.0.0.1:3080

web_ui · first_run_flow

① Settings → Models 填 DeepSeek API key → ② Choose workspace 選工作目錄（官方原文："The session composer remains unavailable until a workspace is selected") → ③ 開 session 發任務

web_ui · source_url

https://github.com/deepseek-ai/deepseek-harness/…

terminal · headless

dsh --profile headless "job" — 官方描述："Run one fresh persisted session, print the final answer, and exit"

terminal · profile

dsh --profile <name> — "Boot the named profile under $DSH_HOME/profiles/<name>";web/headless 兩個 profile 首次使用時會自動從模板初始化，其他 profile 須經 dsh plugin 建立

terminal · plugin_mgmt

dsh plugin --profile <name> <pnpm args> — 把 pnpm 參數轉發到 profile 目錄管理外掛

terminal · flags

--port

terminal · flags

--resume

terminal · flags

--patch

terminal · flags

--dump-default-config

terminal · flags

--dump-config

terminal · flags

--help

terminal · source_url

https://github.com/deepseek-ai/deepseek-harness/…

modes · list · name_zh

標準模式

modes · list · name_en

Standard

modes · list · dir

standard

modes · list · official_desc_zh

功能完整的程式開發 Agent，支援檔案編輯、Shell、檔案與網頁檢索、Skills、計畫、目標、子代理與工作流程。

modes · list · name_zh

PTC 模式

modes · list · name_en

Code

modes · list · dir

code

modes · list · official_desc_zh

具備標準模式的全部能力，並透過 Code Mode SDK 呈現工具，讓模型用一支 TypeScript 程式組合多步驟操作。

modes · list · name_zh

極簡模式

modes · list · name_en

Minimal

modes · list · dir

minimal

modes · list · official_desc_zh

僅提供持久 bash 與 str_replace_editor 的雙工具程式開發 Agent。

modes · list · name_zh

創造模式

modes · list · name_en

Creator

modes · list · dir

cordis

modes · list · official_desc_zh

用於建立自訂 Agent preset：具備標準模式的全部能力，並提供執行階段檢查、外掛實驗與 preset 創作指引。

modes · definition_location

apps/cli/config/agent-presets/ 下四個目錄(code/cordis/minimal/standard),preset 定義檔官方直接用中文撰寫

modes · source_url

https://github.com/deepseek-ai/deepseek-harness/…

UPGRADE / UNINSTALL

note

README、apps/cli/README.md、docs 使用者指南均未提供升級/解除安裝指令（逐一核對為 ABSENT)；社群討論中出現過清 npx 快取的做法(rm -rf ~/.npm/_npx，見 #49/#897)，屬排除故障的手段，非官方升級流程

ISSUES

npx 無法安裝 | npm 也無法安裝 (#1772，已解答）

原PO自答(2026-08-16):Debian 未裝 build-essential 導致 node-pty 原生模組編譯失敗；用 apt 安裝 build-essential 後安裝成功

在 ArchLinux 上無法安裝 (#49,18 則留言）

高讚解法：① pacman -Syu base-devel 裝編譯工具；② 改用 Bun:bun add --global @deepseek-ai/dsh(node-pty 在 Bun 白名單內）;③ 堅持用 npm 就清快取後放行建置腳本：rm -rf ~/.npm/_npx && npx --allow-scripts=node-pty @deepseek-ai/dsh@0.1.0-rc.6 web；另一方案：npm config set allow-scripts=@deepseek-ai/dsh-subprocess-local,koffi,node-pty,@google/genai,protobufjs --location=user

命令列方式安裝不成功 (#897,10 則留言）

社群診斷：系統預設的 g++ 9.4.0 不支援 -std=gnu++20（需 GCC 10+)；解法：先清 npx 快取，再 CC=gcc-11 CXX=g++-11 npm install -g @deepseek-ai/dsh，之後 dsh web

npm 全域安裝後 dsh web 啟動失敗：node-pty 原生模組 pty.node 缺失 (#1219)

根本原因：node-pty v1.1.0 沒有 Linux x64 (Node 24/ABI 137) 的預編譯產物，npm 安裝腳本靜默失敗；手動繞過：進入 node-pty 目錄執行 npx node-gyp rebuild 產生缺少的 pty.node；貼文內無官方回覆(0 回覆）

dsh 安裝外掛時報錯 Ignored build scripts (#2230)

未抓取到解法細節(1 則留言，未深入核對）；現象與 pnpm 預設忽略相依套件建置腳本的安全策略有關，可與 #49 的 allow-scripts 方案互相參照——此條解法待補