来源：DeepSeek Harness

本文属于《DeepSeek Harness 入门教程（实战版）》· 第二部分 · 安装并完成第一次启动

第 3 章　选择桌面端还是 CLI/Web

旧版本的教程只有一条安装路线：先安装 Node.js，再通过 npm 启动 DSH。官方桌面端发布以后，这个前提已经发生了变化。

现在需要先回答的是：你准备怎样使用 DSH？

这一章不安装任何东西。我们先选定路线、确认环境和准备凭证，下一章再按操作系统执行。选对路线以后，不必为了“学得更完整”而把另一套也安装一遍。

两条路线的差别

	桌面端	CLI/Web
启动方式	打开 DeepSeek Harness 应用	在终端运行 dsh web 或 npx @deepseek-ai/dsh@0.1.7-rc.2 web
DSH 自身是否需要系统 Node.js	不需要，应用携带匹配的运行时	需要
工作区选择	原生文件夹选择器	Web 中的 Host 目录选择器
插件安装环境	使用 Desktop 内置 pnpm	使用 CLI 所在的 Node/npm 环境
适合场景	本机日常使用、第一次体验	Linux、Headless、脚本、服务器、自定义 Profile
Profile	独立的 desktop Profile	web、headless 等 CLI Profile

桌面端本质上是在 Electron 外壳中运行完整 Web 应用，并携带与桌面版本匹配的 DSH 运行时。它不是一个只有部分功能的“简化版”。不过，桌面端和 CLI 不共享插件激活、依赖锁文件和 node_modules，公共 CLI 也不能直接管理 Desktop Profile。桌面端官方说明

用三个问题选路线

1. 你的系统是什么

• macOS 或 Windows：优先考虑桌面端；
• Linux：本教程走 CLI/Web；
• 远程服务器或只有 SSH 的环境：走 CLI/Web，不要依赖桌面窗口。

桌面安装包的系统和处理器支持范围可能随版本变化。真正下载前，以官方 Releases 页面当期提供的资产为准，不要从不明网盘或第三方软件下载站获取安装包。

2. 你是否需要命令行自动化

如果你明确需要下面任意一项，建议同时保留 CLI/Web 路线：

• 使用 Headless 在脚本或 CI 中运行任务；
• 在没有图形界面的机器上使用；
• 创建和管理自定义 CLI Profile；
• 调试插件或从源码开发 Harness；
• 通过标准输入和 JSON 事件流驱动任务。

如果你当前只是想完成本教程，不必提前安装两套。桌面端用户会在第15章需要 Headless 时再补 CLI 环境。

3. 你只是运行 DSH，还是还要运行项目

这是最容易被忽略的一点。

桌面端自带的 Node.js 和 pnpm 是给 DSH 自身及插件安装使用的私有运行环境，不会自动加入 Agent Shell 的 PATH。也就是说：桌面端可以在系统没有 Node.js 时启动，但 Agent 不一定能在终端里运行一个 Node.js 项目。

本教程的「日报助手」正是 Node.js 项目，因此无论选择哪条 DSH 路线，都需要让系统终端能够执行：

$ node -v
$ npm -v

二者都显示版本号，才说明日报助手具备运行条件。区别只是：

• 桌面端用户安装 Node.js 是为了运行练习项目；
• CLI/Web 用户安装 Node.js 既是为了运行 DSH，也是为了运行练习项目。

Node.js 应该装哪个版本

以 v0.1.7-rc.2 对应的官方仓库配置为准，DSH 的 Node.js 要求是：

^22.19.0 或 >=24.0.0

因此，本教程推荐安装符合要求的 Node.js 22 LTS 版本，并确认小版本不低于 22.19.0；如果你使用更新的 24 或更高版本，也要留意第三方插件的兼容性。官方 package.json

不要继续沿用旧教程中“Node.js 20 或更高”的说法。当前 DSH 的版本约束已经更高，Node 20 即使能执行部分命令，也不属于官方声明的兼容范围。

开始前准备四样东西

1. 一个专门的练习目录

不要把个人主目录、整个“文档”目录或正在工作的公司仓库直接交给 Agent。先准备一个空目录，例如：

Documents/dsh-learning/daily-report

第7章会把这个空目录添加为工作区，并在里面创建日报助手。目录中不要放密钥、私人文件或其他不希望 Agent 读取的内容。

2. 可用的模型访问方式

后面第一次真正发送任务前，需要在下面两种方式中至少准备一种：

• 可以登录 DeepSeek Harness 的账号；
• 一个可用的模型 API Key。

API Key 可以来自 DeepSeek 官方 Provider、内置第三方 Provider 或兼容 API。现在不需要把密钥复制到文本文件，更不要放进项目目录；第7、8章会在产品提供的凭证界面中配置。

3. 可以访问必要服务的网络

根据所选路线，安装过程可能访问：

• DeepSeek Harness 官方发布页；
• npm 包仓库；
• 模型 Provider 的 API；
• 后续插件使用的官方源或国内镜像。

如果网页能打开但下载或 npm 安装失败，不要反复重装系统环境。先记录失败的域名和报错，第4～6章会给出对应检查方法，第10章还会说明插件镜像的选择。

4. 一点可恢复空间

安装前确认系统磁盘不是接近写满状态。桌面端包含应用运行时，CLI 首次通过 npx 启动也会下载并缓存包；后续插件、会话和工作区文件还会继续占用空间。

不需要为了教程关闭杀毒软件或系统安全功能。遇到拦截时，应先核对文件来源、签名和具体权限，而不是把所有保护永久关闭。

先检查你现在的状态

打开系统终端，运行：

$ node -v
$ npm -v

可能出现三种情况：

情况 A：两条命令都有符合要求的版本

例如：

v22.19.0
10.x.x

说明 Node.js 项目环境已经具备。下一章只需安装或启动 DSH。

情况 B：提示找不到命令

说明系统还没有可用的 Node.js。进入对应系统章节安装：

• macOS：第4章；
• Linux：第5章；
• Windows：第6章。

情况 C：有版本，但不满足 DSH 要求

先不要急着全局安装 DSH。按对应系统章节使用版本管理器或官方安装方式升级，然后重新打开终端验证。

如果电脑上有其他项目依赖旧版 Node.js，优先使用版本管理器，不要直接删除原项目依赖的环境。

选定路线并记录下来

继续之前，应该能完成下面这张检查表：

• 我选择了桌面端或 CLI/Web 作为当前主路线；
• 我知道桌面端与 CLI 的插件状态不会自动同步；
• 我准备了一个不含私人文件的空练习目录；
• 我知道后面使用账号登录还是 API Key；
• 系统终端中的 Node.js 满足练习项目需要，或者我知道去下一章安装；
• 安装包只从 DeepSeek 官方页面或官方 GitHub Releases 获取。

下一章从 macOS 开始。macOS 用户会先安装桌面端，再补齐练习项目需要的 Node.js；选择 CLI/Web 的用户则直接准备 Node.js 和 DSH 命令。

---

← 上一章：DeepSeek Harness 能做什么　|　回目录　|　下一章：macOS 安装 →

版本与桌面 CLI 的区别

公共 npm CLI 与桌面附带的 dsh 命令不是同一条安装路线。官方 dsh-v0.2.0-rc.2 已增加桌面应用菜单中的 dsh 命令安装／管理入口，可管理桌面插件，不需要为此另装 Node 或 pnpm；菜单文案按该发行版实际语言显示。本文后续公共 CLI 实验继续使用显式固定的旧基线，桌面用户不要拿它直接管理 Desktop Profile。若迁移到新版，先备份配置并在独立 Profile 验证，而不是把部分参数混入旧命令。

参考：官方发行说明。