写在前面

2026年8月13日，DeepSeek 正式开源了 DeepSeek Harness（简称 DSH） ——一款 MIT 协议、主打“一切皆插件”的 AI Agent 运行框架。

简单来说，DSH 不是一个新的模型，也不是一个 API 客户端，而是一套让模型能读文件、调工具、管上下文、连续干活几小时的工程系统。DeepSeek 官方的说法很形象：模型是 Agent 的灵魂，Harness 让 Agent 在真实环境里理解处境、使用工具、持续工作。

听起来很厉害，但对普通用户来说，配置起来确实有些门槛。我自己折腾了一晚上，踩了不少坑，也顺手做了一个桌面客户端来简化这件事。

这篇文章就把完整的配置步骤记录下来，希望能帮到同样想上手 DSH 的朋友。

---

一、DSH 是什么？为什么值得一试？

在动手之前，让我们先搞清楚 DSH 到底能做什么。

DSH 的核心设计理念是 “一切皆插件” ——模型、工具、技能、会话、沙箱、文件系统，甚至 Agent 循环本身，全部都可以像乐高积木一样自由组合、替换和扩展。

它内置了4 种预制运行模式：

模式	适用场景	核心特性
标准模式	代码开发、数据分析	全套工具：文件编辑、Shell、网页检索、子 Agent
PTC 模式	批量自动化流程	模型生成 TypeScript 脚本串联多步骤任务
极简模式	模型基准测试	仅保留 Shell + 文件编辑器
创造模式	插件开发	运行时调试、自定义 Agent 预设

你最关心的可能是：它能像 Claude Code 那样帮我写代码吗？

答案是肯定的。打开 DSH 后，你会看到一个网页版的 Coding Agent——左边是会话列表，按工作区组织（一个工作区对应你本地的一个项目目录）；中间是对话区，你说需求，它读文件、写代码、跑命令，每一步的工具调用都摊开在时间线上。

更厉害的是，DSH 有一个叫 Trajectory（轨迹） 的功能——模型看到的一切（系统提示词、推理过程、工具调用结果、子 Agent 调度）全部记录在一份只增不改的会话日志里。你可以完整复盘它到底看到了什么、为什么这么做。

---

二、准备工作

在开始配置之前，你需要准备好两样东西：

1. Node.js（版本 ≥ 22）

DSH 通过 npm 直接启动，所以需要先安装 Node.js。

• 访问 nodejs.org 下载最新 LTS 版本（建议 v22 或更高）
• 安装完成后，打开终端（Windows 用 PowerShell 或 CMD），输入以下命令验证：

node --version

如果显示 v22.x.x 或更高，说明安装成功。

2. DeepSeek API Key

DSH 本身是免费开源的，但调用模型需要 API Key。

• 访问 DeepSeek 开放平台 注册/登录
• 在控制台创建 API Key，复制保存（密钥只写不读，存放在本地，不会上传）

---

三、3 分钟快速上手 DSH

准备工作完成后，就可以启动了。

第 1 步：一条命令启动

打开终端，直接运行：

npx -y @deepseek-ai/dsh web

这条命令会自动下载并启动 DSH 的 Web UI。第一次运行可能需要几秒钟下载依赖，耐心等待即可。

第 2 步：打开浏览器

服务启动后，终端会提示服务已就绪。打开浏览器，访问：

http://127.0.0.1:3080

你就会看到 DSH 的 Web 界面了。

第 3 步：配置 API Key

在 Web 界面中：

1. 点击右上角的 Settings（设置）
2. 进入 Models（模型） 页面
3. 在 DeepSeek 卡片中粘贴你刚才复制的 API Key
4. 点击保存

API Key 会存放在 ~/.dsh/.credentials.yaml（Windows 下是 %USERPROFILE%\.dsh\.credentials.yaml），仅本地存储，不会上传。

第 4 步：选择工作区，开始对话

配置好 API Key 后：

1. 在界面左侧或顶部选择 Workspace（工作区） ——也就是你允许 AI 访问的本地项目文件夹
2. 在底部对话框输入你的需求，比如“帮我分析这个项目的代码结构”
3. 选择运行模式（建议先用 标准模式 体验完整功能）
4. 发送，开始体验

至此，你已经成功跑通了 DSH！

---

五、DSHDesktop

DSHDesktop 是一个 Tauri 2 + Vue 3 构建的一个轻量级桌面客户端。它的作用很简单：把 DSH 包装成一个可以直接双击运行的桌面应用。如果你不想配麻烦的环境，这个工具应该会适合你。

核心功能

• 一键启动/停止：点击“Start”按钮，即可自动在后台运行 npx @deepseek-ai/dsh web 命令，并通过轮询检测服务就绪状态——彻底告别手动敲命令的繁琐。
• 系统托盘常驻：关闭主窗口并不会退出程序，而是自动最小化到系统托盘，让 DSH 服务在后台持续运行。
• 实时状态监测：界面上的状态指示灯会实时反映 DSH 服务的运行状况，即使服务意外崩溃也能被及时检测到。
• 跨平台支持：支持在 Windows、macOS 和 Linux 三大主流操作系统上运行。
  

你可以直接从 GitHub Releases 下载最新安装包：

👉 github.com/szWrn/DSHDesktop/releases

下载后双击安装即可使用，无需额外配置。

⚠️ 注意：首次启动时，应用会通过 npx 拉取 @deepseek-ai/dsh 包，所以需要网络连接。后续启动会直接使用缓存，无需重复下载。

---

六、写在最后

DSH 是一个非常有潜力的 Agent 框架，它的“一切皆插件”理念让开发者可以自由组装和扩展能力。虽然目前还是 Developer Preview 阶段，但社区已经非常活跃——发布不到 24 小时，就涌现了 288 个插件仓库。

如果你在配置过程中遇到任何问题，欢迎在 DSHDesktop 的 GitHub Issues 提交反馈，我会第一时间处理。

如果这个工具对你有帮助，欢迎给 DSHDesktop 一个 ⭐ Star——这是对我最大的鼓励！

---

相关链接

• DSH 官方 GitHub
• DSHDesktop GitHub
• DSHDesktop Releases 下载