DeepSeek Harness桌面版安装教程及api配置

如果你正在寻找一个可以在本地运行、支持插件、能够调用大模型完成编程和自动化任务的 AI 工具，DeepSeek Harness Desktop 值得尝试。

这篇文章会先介绍它适合什么人、有什么优势，再分别讲解 macOS 和 Windows 的安装方法，最后配置 llapi.org 的 API Key。

本文以 DeepSeek Harness Desktop 2.0.0 为例。桌面版是社区维护的开源项目，并非 DeepSeek 官方桌面客户端。下载时请认准官方项目仓库和项目下载页。

一、DeepSeek Harness 是什么

DeepSeek Harness（简称 DSH）是一个面向 AI Agent 的开源运行环境。它不只是一个聊天窗口，而是把模型、工具、文件、终端、工作区、会话和插件组合到了一起。

桌面版项目基于 DeepSeek 官方的 Harness 核心能力，负责把本地 Web UI、Agent 服务和桌面窗口打包在一起，让普通用户不用配置复杂的 Node.js、pnpm 或源码环境，也能直接使用。

二、为什么值得安装

1. 不只是问答，而是可以执行任务

普通聊天工具主要负责生成文字。Harness 更接近一个可以协助完成工作的 Agent：它可以阅读项目文件、分析代码、执行命令、整理资料，并在一个持续的会话中跟踪任务进度。

使用时仍然需要遵守权限确认和安全边界，尤其不要让不熟悉的模型随意执行删除、发布或涉及隐私的操作。

2. 工作区和会话可以长期保留

你可以把一个项目目录交给它，让它持续理解项目结构。会话、设置和工作区不必每次从头解释，适合编程、写作、数据分析和长期内容项目。

3. 插件化，扩展空间大

DeepSeek Harness 的核心理念是“一切皆插件”。模型、工具、界面和工作流都可以按需组合。桌面版还提供 Profile，可以为不同项目准备不同的插件和配置。

4. 本地运行桌面环境

应用窗口、托盘和本地服务都在电脑上运行。它不依赖一个必须长期打开的网页，也不要求新手先搭建完整的开发环境。

需要注意：本地运行不等于所有数据都不会离开电脑。你发送给模型的提示词、代码或文件，仍可能通过你配置的 API 服务发送给对应供应商。

5. 可以接入不同的模型供应商

只要供应商提供兼容 OpenAI API 的接口，就可以通过“自定义供应商”接入。本文使用 llapi.org 作为示例。

三、安装前准备

安装前准备三样东西：

一台 macOS 或 Windows 电脑。
一个可用的模型 API Key。
稳定的网络连接。

桌面版已经内置运行所需的 Node.js、Harness 和相关依赖，普通用户不需要另外安装 Node.js、pnpm 或 Python。

四、Mac 安装方法

第一步：确认 Mac 芯片

点击左上角苹果菜单，选择“关于本机”。

显示 Apple M1、M2、M3、M4 等：属于 Apple Silicon，可以安装当前 macOS 版本。
显示 Intel：当前桌面版 2.0.0 暂不支持 Intel Mac。

也可以在终端执行：

uname -m

显示 arm64 就是 Apple Silicon。

第二步：下载 DMG

打开 DeepSeek Harness Desktop 下载页，点击“下载 Mac 版”。

也可以从 GitHub Releases 下载。不要从不明网盘、破解站或二次打包网站下载。

第三步：拖入应用程序

双击下载的 .dmg 文件。
将 DSH Desktop.app 拖入“Applications（应用程序）”文件夹。
打开“应用程序”，启动 DSH Desktop。

如果 macOS 第一次弹出安全提示，请确认应用来自你刚才访问的官方项目下载页，再点击“打开”。

第四步：等待首次启动

首次启动时，应用会创建自己的数据目录，并自动启动本地 Harness 服务。窗口关闭后，应用可能仍然在系统托盘中运行；需要完全退出时，在托盘菜单中选择“退出”。

五、Windows 安装方法

当前桌面版提供 Windows x64 安装包。

第一步：下载 Windows 安装程序

打开 DeepSeek Harness Desktop 下载页，点击“下载 Windows 版”。

如果从 GitHub 下载，请选择 Windows x64 对应的安装程序，不要下载 macOS 的 DMG 文件。

第二步：运行安装程序

双击下载的 .exe 安装程序。
按安装向导选择安装位置。
安装完成后启动 DSH Desktop。

如果 Windows Defender SmartScreen 弹出提示，先确认文件来自官方项目地址，再选择“更多信息”并继续运行。不要对来源不明的安装包这样操作。

第三步：使用系统托盘

Windows 版启动后通常会在右下角系统托盘显示图标。关闭窗口可能只是隐藏窗口，右键托盘图标可以重新打开窗口或完全退出应用。

六、配置 llapi.org API Key

第一步：注册 llapi.org

打开 https://llapi.org，注册账号并登录控制台。

在控制台创建一个新的 API Key，并复制保存。Key 如果已经泄露或不再使用，应及时撤销并重新生成。

第二步：在 DSH Desktop 中添加供应商

打开 DSH Desktop，进入模型设置。不同版本的界面名称可能略有差异，通常可以在以下位置找到：

设置 → 模型 → 添加自定义供应商

填写以下内容：

配置项	填写内容
供应商名称	`llapi.org`
API 地址	`https://llapi.org/v1`
API Key	粘贴你在 llapi.org 创建的 Key
模型	选择 llapi.org 实际提供的模型

API 地址必须填写：

https://llapi.org/v1

不要填写成下面这些形式：

https://llapi.org/v1/chat/completionshttps://llapi.org/v1，https://llapi.org/v1 。

第一种多写了具体接口路径，后两种混入了中文标点，都可能导致连接失败。桌面应用会根据供应商类型自动拼接具体请求路径。

第三步：保存并选择模型

保存供应商配置后，刷新模型列表，选择一个 llapi.org 支持的模型，并将它设为当前模型。

不同供应商开放的模型名称和权限可能不同，不能直接套用其他平台的模型名。如果列表为空，先确认供应商配置已经保存，再刷新或重启 DSH Desktop。

第四步：发送测试消息

新建会话，发送一条简单消息：

你好，请回复“连接成功”。

能够正常收到回复，就说明 API 地址、Key 和模型配置都已经生效。

七、常见问题

1. macOS 提示无法打开

确认下载的是官方 DMG，并检查 Mac 是否为 Apple Silicon。如果仍然无法打开，可以在“系统设置 → 隐私与安全性”中查看是否有允许打开的提示。

2. Windows 安装后找不到程序

先检查开始菜单和桌面快捷方式，再查看系统托盘。部分桌面应用关闭窗口后会继续在后台运行。

3. API Key 无效

重新复制 Key，检查前后是否带有空格。如果仍然失败，到 llapi.org 控制台撤销旧 Key 并创建新的 Key。

4. API 地址报错

确认地址是：

https://llapi.org/v1

不要添加 /chat/completions，也不要使用中文标点。

5. 没有可用模型

确认 llapi.org 账号有模型权限，并在 DSH Desktop 中刷新模型列表。模型名称应以 llapi.org 控制台实际显示的内容为准。

6. 是否必须安装 Node.js

使用官方桌面安装包不需要。只有从源码参与开发时，才需要按照项目文档安装 Node.js、Yarn 和其他开发依赖。

八、安全和费用提醒

DeepSeek Harness Desktop 是社区开源桌面项目，不等同于 DeepSeek 官方桌面客户端。
llapi.org
是第三方 API 服务，具体价格、速率、模型权限和隐私政策以其官方说明为准。
不要把 API Key 发布到 GitHub、文章截图、聊天群或公开配置文件中。
不要把身份证、密码、私钥、支付信息等敏感资料直接交给 Agent 处理。
执行删除文件、安装软件、上传代码或发布内容等操作前，应先阅读命令并确认目标。

结语

DeepSeek Harness Desktop 的价值，不只是“多了一个聊天窗口”，而是提供了一个可以长期使用的本地 Agent 工作环境：它能理解工作区、调用工具、保留会话，并通过插件扩展能力。

新手最简单的使用路径是：先安装桌面版，再添加一个兼容 OpenAI API 的供应商，最后用一条简单消息测试连接。按照本文配置 llapi.org 后，就可以开始体验 Harness 的 Agent 能力了。

再次提醒：下载请认准 dshdesktop.cn 和 GitHub 官方项目仓库。