安装 DeepSeek Harness 并完成第一个任务

DeepSeek Harness（dsh）是 DeepSeek 开源的编码智能体工具框架。最快的体验方式是运行软件包自带的浏览器界面。本教程把首次操作控制在较小范围：启动界面、连接模型、选择一个可丢弃的测试工作区，并要求智能体先分析、后修改。

官方目前将 DeepSeek Harness 标记为开发者预览版。请先在测试仓库中使用，逐项检查工具调用，并确保密钥不在工作区内。

准备工作

你需要较新的 Node.js，以及模型服务商提供的 API 密钥。先确认 Node 和 npm 可用：

node --version
npm --version

本文使用 Node.js 24 核验。如果启动器在旧版本上报错，请升级到当前仍受支持的 Node.js LTS 版本后重试。

启动 Web 界面

直接运行官方软件包，无需全局安装：

npx @deepseek-ai/dsh web

终端会打印 Web 界面的本地访问地址。当前预览版通常使用 http://127.0.0.1:3080。使用期间不要关闭运行该命令的终端。

首次评估使用 npx 的好处是不会留下必须维护的全局安装。第一次运行可能需要下载软件包，确认包名无误后再同意执行。

连接模型

在 Web 界面的设置区域添加模型服务商，填入该服务商提供的 API 密钥，并选择要使用的模型。

DeepSeek Harness 负责调度，模型访问权限和费用仍由你配置的服务商管理。不要把 API 密钥粘贴到聊天消息、源代码，或可能提交进 Git 的仓库环境文件中。

选择安全的工作区

新建一个小型测试目录，或者使用状态干净的 Git 仓库，然后将它设为工作区。智能体可能读取和修改授权范围内的文件，因此不要直接选择主目录，也不要选择包含其他项目凭证的目录。

第一个提示词可以这样写：

检查这个项目，解释它的结构，并提出一项小改进。
在我批准方案之前，不要修改任何文件。

这样可以先确认智能体能够读取目标工作区，同时让第一次交互保持可控、可回退。

批准一项小改动

阅读智能体给出的方案后，只授权一项范围明确的修改。接受结果前检查差异，并运行项目原有的检查命令。Git 是最可靠的恢复层：授予写入权限前，请先提交或暂存自己的工作。

验证是否成功

满足以下条件，就说明基础配置已经可用：

• 本地 Web 界面能够打开；
• 所选模型能够正常回复；
• Harness 能读取指定工作区；
• 工具调用会显示出来供你审核；
• 一项已批准的小改动能生成清晰可读的差异。

如果界面无法启动，请查看 Web 界面无法启动排查清单。

停止或移除

在启动 Web 服务的终端按 Ctrl+C。本教程使用 npx，因此不需要执行全局卸载。若不再使用，还应分别清理模型服务商凭证和应用产生的本地数据。

来源与核验说明

启动命令和产品定位来自 DeepSeek Harness 官方仓库。开发者预览阶段的界面名称可能变化。本文在页面信息中记录了核验环境和更新时间，便于你判断教程是否适用于当前版本。