DeepSeek Harness 桌面客户端下载、安装与部署教程

DeepSeek Harness（简称 DSH）是一个基于 Electron 的 AI Agent 桌面客户端，提供代码编辑、文件管理、Web GUI、插件市场、MCP 连接器等完整能力。本教程从零开始，手把手带你完成下载、安装、配置和插件部署全流程。

记录时间：2026-09-25｜适用版本：DSH Desktop 2.0.x（CLI 0.1.1-rc.2）｜环境：Windows 10/11 x64

一、DSH Desktop 是什么

DeepSeek Harness Desktop 是一个本地 AI Agent 运行环境，核心能力包括：

• Web GUI：浏览器中使用的 AI 对话界面（默认 http://127.0.0.1:43120）
• 文件操作：读写、编辑、搜索本地文件系统
• 代码执行：运行 PowerShell、TypeScript 代码
• 插件系统：通过 npm/pnpm 包管理器安装社区插件
• MCP 连接器：连接外部 MCP Server，扩展工具能力
• 多模型支持：可配置 DeepSeek、GLM、Qwen 等多种 AI 模型
• 子代理：将任务委派给独立上下文的子 Agent
• 后台任务：长时间运行的后台命令和代理

与普通 AI 聊天工具的区别

二、系统要求

硬件

软件

注意：DSH Desktop 是 Electron 应用，自带 Chromium 和 Node.js 运行时，无需额外安装 Node.js 即可使用。但如果需要从源码开发插件，建议安装 Node.js 18+。

三、下载 DSH Desktop

3.1 从 GitHub Releases 下载（推荐）

DSH Desktop 的源码和发布包托管在 GitHub：

• 仓库地址：https://github.com/anywhere-labs/deepseek-harness-desktop
• 发布页面：https://github.com/anywhere-labs/deepseek-harness-desktop/releases

下载步骤：

1. 打开上述 Releases 页面
2. 找到最新稳定版本（非 Pre-release）
3. 下载对应平台的安装包：

– Windows：.exe 安装程序（如 DSH-Desktop-Setup-2.0.x.exe）

– macOS：.dmg 安装包

– Linux：.AppImage 或 .deb

如果国内访问 GitHub 较慢，可以使用镜像加速：

“`

https://ghfast.top/https://github.com/anywhere-labs/deepseek-harness-desktop/releases/download/v2.0.x/DSH-Desktop-Setup-2.0.x.exe

“`

3.2 验证下载

下载完成后，建议核对文件大小（通常 200MB+），确保下载完整。

四、安装 DSH Desktop

4.1 Windows 安装

1. 运行安装程序：双击下载的 .exe 文件
2. 选择安装路径：默认安装到 C:Program FilesDSH Desktop，可自定义为其他盘符（如 K:Program FilesDSH Desktop）
3. 等待安装完成：安装程序会自动解压所有文件，包括：

– DSH Desktop.exe — 主程序（Electron 应用）

– resources/app.asar — 应用核心代码包

– resources/app.asar.unpacked/ — 原生模块（node-pty 等）

– Chromium 运行时（DLL 文件）

1. 安装完成：桌面会出现 DSH Desktop 快捷方式

4.2 macOS 安装

1. 双击 .dmg 文件挂载磁盘映像
2. 将 DSH Desktop 拖入 Applications 文件夹
3. 首次打开时，右键点击选择”打开”（绕过 Gatekeeper）

4.3 Linux 安装

# AppImage 方式（推荐）
chmod +x DSH-Desktop-2.0.x.AppImage
./DSH-Desktop-2.0.x.AppImage

# deb 方式
sudo dpkg -i dsh-desktop_2.0.x_amd64.deb

4.4 安装后的目录结构

以 Windows 为例，安装完成后会在两个位置创建文件：

安装目录（程序文件）：

K:Program FilesDSH Desktop
├── DSH Desktop.exe          # 主程序
├── resources/
│   ├── app.asar             # 应用核心代码
│   └── app.asar.unpacked/   # 原生模块
├── chrome_100_percent.pak   # Chromium 资源
├── icudtl.dat               # 国际化数据
├── libEGL.dll               # 图形库
└── snapshot_blob.bin        # V8 快照

用户数据目录（配置和缓存）：

C:Users<用户名>AppDataRoamingDSH Desktop
├── host-commands/           # 宿主命令（dsh.cmd）
│   └── desktop/bin/dsh.cmd
├── desktop-market/          # 插件市场状态
├── updates/                 # 自动更新状态
├── identity/                # 安装标识
├── logs/                    # 日志文件
└── Cache/                   # 缓存

五、首次启动与初始配置

5.1 启动 DSH Desktop

1. 双击桌面快捷方式或开始菜单中的 “DSH Desktop”
2. 首次启动会自动初始化用户目录 ~/.dsh/（即 C:Users<用户名>.dsh）
3. 初始化完成后，应用窗口打开，同时 Web GUI 在本地启动

5.2 DSH Home 目录结构

首次启动后，~/.dsh/ 目录结构如下：

C:Users<用户名>.dsh
├── profiles/                # 配置文件目录
│   └── desktop/             # 默认桌面 profile
│       ├── package.json     # 插件依赖声明
│       ├── cordis.yml       # Cordis 配置
│       ├── cordis.patch.yml # 用户补丁
│       ├── node_modules/    # 已安装插件
│       └── .dsh-market/     # 插件市场数据
├── sessions/                # 会话数据
├── skills/                  # 自定义技能
├── storages/                # 存储数据
├── settings.yaml            # 全局设置
└── .credentials.yaml        # API 密钥（敏感）

5.3 验证安装

打开 PowerShell 或终端，运行：

dsh --version

应输出类似：

0.1.1-rc.2

查看帮助：

dsh --help

六、配置 AI 模型

6.1 编辑 settings.yaml

DSH 通过 ~/.dsh/settings.yaml 配置 AI 模型。打开该文件：

notepad "$env:USERPROFILE.dshsettings.yaml"

6.2 配置模型提供商

在 settings.yaml 中添加 llm-pi-ai.providers 部分：

agent-default-model:
  provider: deepseek-v4
  model: deepseek_v4

llm-pi-ai:
  providers:
    deepseek-v4:
      displayName: DeepSeek V4
      apiKeyEnv: DEEPSEEK_V4_API_KEY
      api: openai-completions
      baseURL: https://api.deepseek.com/v1
      compat:
        maxTokensField: max_tokens
      models:
        - id: deepseek_v4
          name: DeepSeek V4
          contextWindow: 200000
          maxTokens: 32768
          input: [ text ]

    glm-5:
      displayName: GLM-5
      apiKeyEnv: GLM_5_API_KEY
      api: openai-completions
      baseURL: https://open.bigmodel.cn/api/paas/v4
      compat:
        maxTokensField: max_tokens
      models:
        - id: glm-52
          name: GLM-52
          contextWindow: 200000
          maxTokens: 32768
          input: [ text ]

    qwen3:
      displayName: Qwen3
      apiKeyEnv: QWEN3_API_KEY
      api: openai-completions
      baseURL: https://dashscope.aliyuncs.com/compatible-mode/v1
      compat:
        maxTokensField: max_tokens
      models:
        - id: qwen3.8
          name: Qwen3.8
          contextWindow: 246000
          maxTokens: 32768
          input: [ text ]

6.3 配置 API 密钥

API 密钥存储在 ~/.dsh/.credentials.yaml 中：

version: 1
refs:
  DEEPSEEK_V4_API_KEY: sk-your-deepseek-api-key
  GLM_5_API_KEY: your-glm-api-key
  QWEN3_API_KEY: your-qwen-api-key

安全提示：

– .credentials.yaml 包含敏感信息，切勿提交到 Git 仓库

– 该文件权限已设为仅当前用户可读写

– 如果使用自托管 API，将 baseURL 改为你的服务器地址

6.4 配置字段说明

6.5 其他全局设置

dsh-desktop:
  mode: advanced              # advanced 或 simple
  windowsMaterial: acrylic    # Windows 窗口材质
  openBrowser: false          # 启动时是否自动打开浏览器
  networkExposure: loopback   # 网络暴露范围：loopback（仅本机）

dsh-desktop-notifications:
  enabled: true
  notifyOnTurnCompletion: true
  notifyOnTurnFailure: true

七、使用 Web GUI

7.1 启动 Web GUI

DSH Desktop 启动后，Web GUI 自动在本地启动。也可手动启动：

dsh web

Web GUI 默认地址：http://127.0.0.1:43120

在浏览器中打开该地址即可使用。

7.2 运行时环境变量

DSH 运行时会设置以下环境变量：

7.3 Profile 系统

DSH 使用 Profile 系统管理不同的运行配置：

八、安装插件市场

DSH 的插件系统基于 npm/pnpm 包管理器，插件安装后会出现在 Profile 的 node_modules 目录中。

8.1 内置插件市场（dshmarket）

DSH Desktop 默认内置了 dshmarket 插件（v1.38.x），这是一个可视化插件市场，可以在 Web GUI 中浏览、搜索和一键安装社区插件。

使用方法：

1. 打开 Web GUI（http://127.0.0.1:43120）
2. 在设置或侧边栏中找到插件市场入口
3. 浏览或搜索插件，点击安装即可

8.2 命令行安装插件

使用 dsh plugin 命令安装插件（底层调用 pnpm）：

# 基本语法
dsh plugin --profile <profile名> add <包名>

# 示例：安装到 desktop profile
dsh plugin --profile desktop add dsh-better-sidebar

# 从 GitHub 安装
dsh plugin --profile desktop add github:AwesomeHou/dsh-plugin-marketplace

# 安装指定版本
dsh plugin --profile desktop add dsh-better-sidebar@0.18.0

# 卸载插件
dsh plugin --profile desktop remove dsh-better-sidebar

8.3 安装第三方插件市场

除了内置的 dshmarket，还可以安装功能更丰富的第三方插件市场：

方案 A：dsh-plugin-marketplace（推荐）

dsh plugin --profile web add github:AwesomeHou/dsh-plugin-marketplace

功能：实时同步 GitHub dsh-plugin 主题下的 1800+ 仓库，提供可搜索、分页的设置面板，支持一键安装和 Agent 工具（market_search / market_install）。

方案 B：dsh-whale-market（鲸鱼插件市场）

dsh plugin --profile web add github:hoangdtdoothanh-svg/dsh-whale-market

功能：浏览、搜索、一键安装和更新 DSH 插件，带 Web 设置界面。

8.4 插件安装原理

当你执行 dsh plugin add 时，DSH 会：

1. 在 Profile 目录（如 ~/.dsh/profiles/desktop/）下运行 pnpm 安装包
2. 将包添加到 package.json 的 dependencies 中
3. 将包名添加到 package.json 的 dsh.profile.bundles 数组中
4. 重启 Profile 使插件生效

安装后 package.json 示例：

{
  "name": "dsh-profile-desktop",
  "private": true,
  "dependencies": {
    "dsh-better-sidebar": "0.18.0",
    "dsh-find-plugin": "0.3.7",
    "dshmarket": "1.38.1"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-better-sidebar",
        "dsh-find-plugin",
        "dshmarket"
      ]
    }
  }
}

九、推荐插件

9.1 核心插件

9.2 功能插件

9.3 一键安装所有推荐插件

dsh plugin --profile desktop add dsh-better-sidebar
dsh plugin --profile desktop add dsh-find-plugin
dsh plugin --profile desktop add dsh-mcp-connector
dsh plugin --profile desktop add @liustack/modlens
dsh plugin --profile desktop add @picgo/dsh-plugin
dsh plugin --profile desktop add @zseven-w/dsh-openpencil

安装完成后重启 DSH Desktop 使所有插件生效。

十、MCP 连接器使用

10.1 什么是 MCP

MCP（Model Context Protocol）是一个标准化协议，允许 AI Agent 连接外部工具和数据源。DSH 通过 dsh-mcp-connector 插件支持 MCP。

10.2 连接 MCP Server

在 Web GUI 中：

1. 打开 MCP 连接器市场（侧边栏或设置中）
2. 浏览可用的连接器（企业数据/办公协作/地图出行/金融行情/开发工具/数据库/AI 模型等）
3. 点击连接：

– OAuth 型：自动打开浏览器进行授权

– API Key 型：输入密钥后连接

– 无鉴权型：直接连接

10.3 命令行配置 MCP

也可以通过 JSON 批量导入 MCP 连接：

{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["path/to/server.js"],
      "env": { "API_KEY": "xxx" }
    }
  }
}

十一、命令行进阶

11.1 查看当前配置

# 打印当前 Profile 的完整配置树
dsh --dump-config

# 打印不含用户覆盖层的默认配置
dsh --dump-default-config

11.2 使用自定义补丁

# 使用额外补丁层启动
dsh --profile desktop --patch ./my-overrides.yml

11.3 Headless 模式（单次任务）

# 执行单个任务并退出
dsh --profile headless "帮我读取 package.json 并总结依赖"

11.4 恢复会话

# 恢复之前的会话
dsh --profile web --resume <session-id>

十二、常见问题与排错

Q1：Web GUI 打不开

原因：端口被占用或服务未启动。

解决：

# 检查端口是否被占用
netstat -ano | findstr :43120

# 手动启动 Web GUI
dsh web

Q2：插件安装失败

原因：npm 网络问题或权限不足。

解决：

# 设置 npm 镜像（国内）
npm config set registry https://registry.npmmirror.com

# 手动进入 profile 目录安装
cd "$env:USERPROFILE.dshprofilesdesktop"
pnpm add <插件名>

Q3：API 密钥不生效

原因：.credentials.yaml 格式错误或密钥过期。

解决：

1. 检查 ~/.dsh/.credentials.yaml 格式是否正确（YAML 缩进必须一致）
2. 确认 settings.yaml 中的 apiKeyEnv 与 .credentials.yaml 中的 key 名一致
3. 重启 DSH Desktop

Q4：DSH 命令找不到

原因：PATH 环境变量未包含 DSH 命令路径。

解决：

# 检查 dsh 是否在 PATH 中
where.exe dsh

# 手动添加到 PATH（临时）
$env:PATH += ";C:Users$env:USERNAMEAppDataRoamingDSH Desktophost-commandsdesktopbin"

Q5：更新 DSH Desktop

DSH Desktop 支持自动更新。也可以手动下载最新版本覆盖安装，用户数据（~/.dsh/）不会丢失。

# 查看当前版本
dsh --version

Q6：插件不生效

原因：插件安装后未重启 Profile。

解决：

1. 完全关闭 DSH Desktop
2. 重新启动
3. 检查 package.json 中 dsh.profile.bundles 是否包含该插件

十三、文件清单

十四、快速上手清单

# 1. 下载安装 DSH Desktop
#    从 GitHub Releases 下载 .exe 安装

# 2. 启动并验证
dsh --version

# 3. 配置 API 密钥
#    编辑 ~/.dsh/.credentials.yaml 填入 API Key

# 4. 配置模型
#    编辑 ~/.dsh/settings.yaml 设置 provider 和 model

# 5. 打开 Web GUI
#    浏览器访问 http://127.0.0.1:43120

# 6. 安装推荐插件
dsh plugin --profile desktop add dsh-better-sidebar
dsh plugin --profile desktop add dsh-find-plugin
dsh plugin --profile desktop add dsh-mcp-connector

# 7. 安装第三方插件市场
dsh plugin --profile web add github:AwesomeHou/dsh-plugin-marketplace

# 8. 重启 DSH Desktop，开始使用

相关链接

• DSH Desktop GitHub：https://github.com/anywhere-labs/deepseek-harness-desktop
• 插件市场（dshmarket）：内置
• 第三方插件市场：https://github.com/AwesomeHou/dsh-plugin-marketplace
• 插件目录浏览：https://awesome-dsh-plugin.com
• DeepSeek API：https://platform.deepseek.com
• MCP 协议文档：https://modelcontextprotocol.io

提示：DSH Desktop 处于快速迭代中，具体界面和功能可能随版本更新有所变化。遇到问题时，首先检查 dsh --version 确认版本，然后查看 %APPDATA%DSH Desktoplogs 下的日志文件排查。