DeepSeek Harness 安装和上手：桌面版、网页版怎么选，第一个任务怎么跑

DeepSeek Harness 是 DeepSeek 开源的智能体框架，命令叫 dsh。按官方页面的介绍，它能整理资料、分析表格、写文档、写代码和改仓库、查资料并标注来源、在后台跑耗时的任务，能力靠插件扩展。

上手只要四步：

装上：下载桌面应用，或者用一条命令启动网页界面；
在 设置 → 模型 里填 DeepSeek 的 API key；
选一个工作区，也就是让它干活的那个文件夹；
发一个任务。

动手之前先知道一件事：官方把它标为开发者预览，写明“未来将出现破坏兼容性的变更”，目前发布的全是预览版。本文按 2026-10-10 的官方文档写，界面上的名字以你装的版本为准。

桌面版还是网页版

	桌面应用	网页界面
怎么装	在官网下载安装包	装好 Node.js 后运行一条命令
支持的系统	官方页面列的是 macOS（Apple 芯片）和 Windows（64 位）	需要 Node.js，官方说明里没有单独列出支持的系统
自带的东西	自带 Python、Node.js 和 pnpm，做表格、文档这类任务不用另装环境	用你电脑上已有的环境
适合谁	想装上就用的人	习惯命令行的人，或者要在服务器上跑的人

拿不准就用桌面版。

桌面应用

到 DeepSeek Harness 官方页面点“下载桌面端”，装好打开。

官方说明里有几个行为和一般软件不太一样，知道了不会被吓到：

关掉主窗口只是隐藏，任务不会停。 页面和后台继续运行，下次显示时会话和草稿都在。macOS 从 Dock 图标找回窗口，Windows 从托盘找回。
真正退出时，有任务在跑会先问你。
可以顺带装上 dsh 命令。 应用里可以把命令行工具注册到系统，之后在终端里也能用。

网页界面

装好 Node.js，在你想让它干活的项目目录里运行：

npx @deepseek-ai/dsh web

官方说明，这条命令默认在 http://127.0.0.1:3080 启动网页界面，本机运行时还会自动用默认浏览器打开。常用的两个参数：

# 只启动服务，不自动打开浏览器
npx @deepseek-ai/dsh web --no-open

# 换一个端口
npx @deepseek-ai/dsh web --port 8080

在哪个目录运行很重要。 官方文档说明，dsh 进程会把启动时所在的目录当作默认的文件位置。

也可以从源码运行，官方给的步骤是克隆仓库后依次执行 pnpm install、pnpm run build、pnpm dsh web。一般用不到。

1配置模型

桌面应用的欢迎窗口

桌面应用第一次启动会先出一个欢迎窗口。按官方的说明，这时可以用 DeepSeek 账号登录，也可以进到填 API Key 的页面：

保存并继续：把你填的 key 存为 DeepSeek 官方接口的密钥，然后进入工作区。
稍后配置：先进工作区，以后再到设置里配。下次启动还会再检查一次。

在设置里填

网页界面，或者桌面应用进了工作区之后，打开 设置 → 模型。最上面是一张 DeepSeek 的卡片，输入 DeepSeek 的 API key 并保存。官方说明，模型马上可用，不需要重启。

key 在 DeepSeek 开放平台申请。官方文档还说明，密钥保存后页面上只显示脱敏后的样子，明文存在本机的 ~/.dsh/.credentials.yaml 里。

不想用 DeepSeek 官方接口的，同一个页面上可以“添加模型提供商”：

用 dsh 自带目录里的其他厂商，填对应的 key；
接中转站、公司网关或自建的服务，见DeepSeek Harness 接入中转站。

2选工作区

工作区就是它能读写的那个文件夹。

点 选择工作区，添加一个项目目录，再选中它。官方文档里有两个提醒：

全新的网页界面不会自动选中任何工作区，要自己加；
选中工作区之前，输入框是不能用的。 发现打不了字，先看是不是这一步没做。

第一次试用，建一个空文件夹，或者拿一个有备份的项目，不要直接指向放着重要文件的目录。

3发第一个任务

新建一个会话，发一条要它动手的任务。官方快速上手用的是这一句：

Summarize this repository and identify its main packages.

用中文也一样：

总结一下这个仓库，列出主要的几个目录是做什么的。

按官方的描述，智能体可以读取和编辑工作区里的文件、运行命令、把工作分派出去，并维护一份计划。按照当前的权限设置，某个操作需要你同意时，界面会先问你。

输入框里还有三样东西可以用，官方页面的界面上都能看到：

输入 / 调用指令，比如 /plan 进入计划模式、/permission 切换权限；
输入 @ 引用文件或者别的会话；
输入框上可以切换权限模式、模型和推理等级。

权限：默认不会乱动工作区以外的东西

输入框上的权限选择器，网页界面默认有三档：仅可查看、工作区内修改、完全权限。

第一次用保持“工作区内修改”就行。三档各自管什么、沙箱能拦住什么拦不住什么，见DeepSeek Harness 的权限怎么设。

插件

DeepSeek Harness 的口号是“一切皆插件”。在插件页可以安装现成的插件，官方页面上列出的官方插件有智能体团队、自动授权审查、自动化任务、语音输入、终端、子智能体等，其中几个标着“实验性”。

官方页面还演示了“创造模式”：用一句话描述，让它自己写一个插件并装上。

插件能执行代码、访问文件。官方的安全说明把“加载第三方插件”列为风险来源之一，装之前看清楚来源。

它的东西都放在哪里

位置	是什么
`~/.dsh`	它的主目录，官方文档里写作 `$DSH_HOME`
`~/.dsh/.credentials.yaml`	保存的密钥
`~/.dsh/profiles/web/cordis.patch.yml`	网页界面的配置
`~/.dsh/profiles/desktop/`	桌面应用自己的那一份配置

模型页上的设置最终都写进对应的 cordis.patch.yml。一般不用手动改，接中转站时才可能用到。

“开发者预览”意味着什么

官方的安全说明写得很直接，上手前值得读一遍。要点是：

它是实验性的开发者预览软件，没有接受过安全审计，不能当作安全的、可用于生产环境的软件。
它可以执行模型生成的代码和命令、加载第三方插件，并访问向它开放的网络、进程、凭据和文件。模型出错、软件缺陷、配置错误或不可信的插件，都可能损坏电脑、修改或删除文件、泄露数据。
沙箱、审批和权限控制能降低风险，但不保证隔离。

官方给的建议：只给最小的权限和访问范围；优先在一次性的虚拟机、容器或专用环境里运行；备份它能访问到的文件；不要让它接触敏感的凭据和数据。

常见问题

现象	检查什么
输入框不能打字	有没有选中工作区；默认模型指向的提供商是不是被删了
发了任务提示缺少凭据	设置 → 模型里有没有保存 key
网页界面打不开	看启动命令打印的地址；端口被占用时用 `--port` 换一个
模型请求一直连不上	网络问题，见在国内网络下怎么用
关了窗口，任务还在跑	桌面应用关窗口只是隐藏。要停就真正退出应用
升级之后配置或插件不能用了	它在预览阶段，官方提醒会有不兼容的改动。看那一版的更新说明

接下来

DeepSeek Harness 接入中转站：不用 DeepSeek 官方接口时怎么配。
DeepSeek Harness 的权限怎么设：三档权限、沙箱和计划模式。
在国内网络下怎么用：代理怎么设，哪些请求不走代理。
0.2.1-alpha.2 更新了什么：最近一版的变化。