还不知道 dsh 是什么？

先看文科生2分钟搞懂DeepSeek Harness，那篇讲清楚它是什么、和 Codex / Claude Code / WorkBuddy 差在哪。这一篇只讲怎么装。

给文科生的一键部署安装教程

一个完全没有技术知识的小白，想安装并使用 DeepSeek Harness（dsh），大概率会一路卡壳。

1. 第一步就懵：不知道“终端”是什么

  • 官方最简单的启动方式是打开电脑的“终端”（Windows 叫 PowerShell 或命令提示符，Mac 叫终端），敲一行英文命令。
  • 小白可能连“终端在哪里打开”都不知道，更别说敢往里面敲命令。看到黑乎乎的窗口就害怕。

2. 必须先装 Node.js，版本还挑

  • 需要先去官网下载并安装一个叫 Node.js 的东西（要求比较新的版本，比如 22 或 24）。
  • 小白不知道选哪个版本、装的时候要不要勾选选项、装完要不要重启电脑。
  • 装完后还要在终端里敲 node -v 检查，输错或版本不对，后面全报错。

3. 敲命令时各种报错

  • 敲 npx @deepseek-ai/dsh web 时：
    • 网络不好（尤其国内）下载会卡住或失败。
    • 弹出一堆英文提示，问“要不要安装？”不知道该回 y 还是 n。
    • 报“找不到命令”“权限不够”“端口被占用”等错误，完全看不懂。
  • Windows 用户更容易踩坑：中文路径、依赖包损坏、防火墙拦截等。

4. 好不容易打开网页，又卡住

  • 浏览器打开 http://127.0.0.1:3080（这个地址本身就很陌生）。
  • 第一次进来要填 API 密钥（需要先去 DeepSeek 官网注册、实名、充值、创建密钥）。小白可能不知道密钥是什么、去哪里找、怎么复制粘贴，填错就提示“凭证缺失”。
  • 还要选择“工作区”（指定一个电脑文件夹）。选错了（比如选了整个桌面或系统盘）会有安全风险，而且不知道该选哪个。

5. 界面完全看不懂

  • 界面偏工程师风格，术语多（轨迹、插件、预设、沙箱、权限等级……）。
  • 不知道该选哪种模式（标准、极简、创造……）。
  • 不知道怎么发第一条指令、怎么授权它读写文件、怎么看它在干什么。
  • 出了小问题（卡住、显示不准、任务跑一半停了）完全不会排查。

6. 用起来还要人盯着

  • 复杂任务容易翻车，需要自己检查结果、手动纠正。
  • 关掉终端窗口，网页就停了，不知道怎么让它后台一直跑。
  • 想卸载或清理，也不知道文件散落在哪里。

一键部署安装方案

1. 官方命令安装（需要 Node.js 环境）

DeepSeek Harness (dsh) 采用基于 Cordis 框架的“一切皆插件”架构。针对一键安装与快速启动，目前主要有以下几种主流方式与工具：

1. 官方 NPX 免安装即用（首选一键方案）
官方直接发布了 npm/npx 运行包，无需手动克隆仓库或配置复杂环境，一条命令即可自动下载依赖并拉起 Web UI：

npx @deepseek-ai/dsh web
  • 特点： 零门槛、自动解析依赖、适合日常快速体验与 Web 交互。

2. 源码一键 Clone & Run（适合开发者）
官方仓库对包管理器提供了开箱即用的支持，本地具备 Node.js（推荐 Node.js v20+ / v24+）与 pnpm 环境时：

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm dev
  • 特点： 便于二次开发、直接修改内置插件和配置文件。

安装与配置注意事项

  • 依赖环境： 基础框架运行依赖 Node.js 和 pnpm；若加载视觉等第三方复杂插件（如 DSH Vision Toolkit），需额外准备 Python 3.11+ 环境。
  • API Key： 首次启动后，在生成的配置或 Web 页面中填入 DeepSeek API Key 即可直接选择不同预设模式（标准模式、Minimal 模式、Code 模式等）开始使用。

2. 第三方客户端封装

针对 DeepSeek Harness (dsh)，由于它是一个开源的底座运行时（Agent Runtime），社区和周边生态围绕“启动管理”、“工作流集成”与“跨端封装”迅速推出了几款实用的第三方客户端与集成工具：

1. DeepSeek Harness - Obsidian 插件

  • 定位： 本地笔记与知识库专属的桌面端嵌入封装。
  • 亮点：
    • 一键安装与自动检测： 插件设置内提供“Install DSH”一键克隆与依赖配置，自动识别本地 Node/dsh 环境。
    • 静默后台守护： 打开 Obsidian 侧边栏自动按需拉起 DSH 守护进程（Windows 下无黑窗静默运行），关闭后随之终止或保持独立常驻。
    • 工作区联动： 默认将当前 Obsidian Vault 映射为 Agent 专属工作区，适合文档撰写、个人知识库自动化维护。

2. Open Design 桌面端（UI/前端设计专用封装）

  • 定位： 面向 UI、前端原型与视觉交互的 GUI 宿主。
  • 亮点：
    • 弥补原生“缺眼睛”短板： 原生 dsh 缺乏视觉闭环，Open Design 在桌面端集成了实时渲染预览窗口与设计上下文解析。
    • 本地 CLI 自动绑定： 桌面端能自动探测本地的 dsh 环境与 API 凭据，将 Harness 作为后端 Agent 驱动前端代码生成与迭代。

3. VS Code / Cursor 社区 Extension（开发集成）

  • 定位： IDE 内置的轻量侧边栏控制器。
  • 亮点：
    • 将 dsh web 的 Web 视图直接内嵌在编辑器侧边栏面板。
    • 自动将当前 IDE 打开的 Workspace 作为 Harness 根目录，省去手动切换终端和复制路径的步骤。

4. 社区自制一键桌面启动器（Windows / macOS Quick Launcher）

  • 定位： 解决终端黑窗、环境变量与端口冲突的简易封装工具。
  • 亮点：
    • 基于 Electron 或 Tauri 封装，打包了内置的 Node.js 运行时与镜像加速源（npmmirror），解决国内安装依赖超时和 koffi 原生模块报错问题。
    • 提供托盘图标管理，支持一键重启、清除沙箱缓存和多模式预设快速切换。

目前针对 DeepSeek Harness（dsh），社区中最受认可、稳定性较好的两款桌面启动管理工具如下：

1. deepseek-harness-desktop（全平台 Tauri 客户端，首选推荐）

  • 技术架构： 基于 Rust + Tauri v2 构建的轻量级原生外壳，内存占用极低。
  • 核心优势：
    • 零配置开箱即用： 内置便携式 Node.js 运行时与官方 Harness 包，无需手动安装 Node.js、pnpm 或配置全局环境。
    • 无黑窗后台常驻： 提供系统托盘图标、原生菜单栏与窗口状态记忆，关闭窗口自动收起至托盘，彻底告别命令行窗口。
    • 版本静默追踪： 每次启动自动对比上游最新提交/发布版本，提供一键平滑升级，完美应对预览版频繁迭代的问题。
    • 支持平台： macOS（DMG）、Windows（EXE/MSI）、Linux（AppImage）。

2. dsh-launcher（Windows 专属轻量守护与启动管理）

  • 技术架构： 专为 Windows 环境定制的无黑窗后台守护与注册工具。
  • 核心优势：
    • 一键注册桌面快捷方式与全局指令： 安装后自动生成桌面图标与全局 deepseek 指令，双击即可无黑窗静默拉起后台服务并自动唤起浏览器。
    • 内置进程与状态管理： 支持一键状态检测（deepseek --status）、端口防冲突终止（deepseek --stop）以及后台日志实时查看（deepseek --logs）。
    • 针对 Windows 痛点优化： 自动处理 Windows 下容易出现的路径编码、进程误杀及 npx 缓存重置问题。
    • 支持平台： Windows 10 / Windows 11。

选型建议

  • 偏好类似常规软件的独立桌面窗口与跨端一致体验（无需打开浏览器），直接安装 deepseek-harness-desktop。
  • 在 Windows 下习惯使用默认浏览器、仅需解决“后台黑窗、开机自启、一键关停”等运维痛点，使用 dsh-launcher 更为轻巧。