部署上手

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") → ③ 开会话发任务

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，已解答）

楼主自答(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 方案互参——此条解法待补