7 天学会 DeepSeek Harness

启动 Web UI
并完成只读检查

从官方入口启动当前版本,保存环境信息,并用一次只读任务验证目录边界。

预计阅读 25 分钟公开免费核验于 2026.08.19
内容目录 当前:第 02
7 天完成第一个 AI 项目7
7 天学会 DeepSeek Harness7
7 天建立 Agent 工作流7
7 天做出个人知识库7
本文目录 8 个部分

大家好,我是云途。今天第一次启动 Harness。启动成功只代表服务在运行,我们还要确认它看到的是正确目录,并且能够遵守只读要求。

所有安装与运行依赖都保留在练习项目或官方临时执行范围内,不把全局环境当作项目能力。

先理解今天的原理

启动链路包含 Node 环境、包版本、本地服务、浏览器地址和项目工作目录。任何一层不同,都可能让教程中的表现与本机不一致。

只读检查是风险最低的第一项任务。它可以验证项目路径、文件识别和指令遵守情况,同时不会改变现有文件。

Node、包、Harness 服务、浏览器和项目目录共同组成一次可运行环境。你的命令npm / npxnpm管理项目依赖npx执行包命令Node.js实际运行
Node、包、Harness 服务、浏览器和项目目录共同组成一次可运行环境。

为什么今天要做这件事

  1. 保存环境信息可以让后续错误具备可复现条件。
  2. 先验证只读能力,再逐步开放写入权限。
  3. 确认实际工作目录可以避免在错误项目中运行任务。

开始前检查

这是第 02 天。先完成下面的检查,再开始操作。缺少关键材料时,先补材料,不要让 Agent 猜。

  1. 昨天的边界记录已经完成。
  2. Node 版本满足官方 README 当前要求。
  3. 练习目录里只放可以公开和修改的测试文件。

一步一步完成

第 1 步:在终端记录 Node 与 npm 版本

这一步会生成后续课程继续使用的材料。文件名、保存位置和内容边界需要写清楚,让第二天重新打开项目时仍然知道它的用途。

  1. 在终端记录 Node 与 npm 版本。
  2. 打开新材料逐项检查,删除示例占位内容,补上本次真实信息。
  3. 记录保存路径,并确认关闭页面或重新打开项目后仍能找到。
  4. 对照今天的目标检查这一项,发现偏差时先处理偏差,再进入第 2 步。
完成这一步后,你应该看到:在终端记录 Node 与 npm 版本,产物内容完整并且可以重新找到。

第 2 步:按官方 README 的当前入口启动 Web UI

这一步会让环境或项目发生变化。开始前先保存当前状态,执行时记录真实入口、参数和输出,出现异常就停在当前步骤排查。

  1. 按官方 README 的当前入口启动 Web UI。
  2. 保存执行命令、输入参数、开始前状态和结束后的输出。
  3. 重新运行一次最小检查,确认结果可以稳定复现。
  4. 对照今天的目标检查这一项,发现偏差时先处理偏差,再进入第 3 步。
完成这一步后,你应该看到:按官方 README 的当前入口启动 Web UI,执行过程与可复现结果已经记录。
DeepSeek Harness Web UI 首次启动时的 API Key 配置提示
真实软件截图:本地 Web UI 已成功启动,并明确提示配置 API Key。课程没有输入或保存任何真实密钥,而是使用“稍后配置”继续核对无密钥边界。浏览器工具栏已裁掉。

第 3 步:记录实际地址、启动时间和终端输出

这一步会生成后续课程继续使用的材料。文件名、保存位置和内容边界需要写清楚,让第二天重新打开项目时仍然知道它的用途。

  1. 记录实际地址、启动时间和终端输出。
  2. 打开新材料逐项检查,删除示例占位内容,补上本次真实信息。
  3. 记录保存路径,并确认关闭页面或重新打开项目后仍能找到。
  4. 对照今天的目标检查这一项,发现偏差时先处理偏差,再进入第 4 步。
完成这一步后,你应该看到:记录实际地址、启动时间和终端输出,产物内容完整并且可以重新找到。

第 4 步:在 UI 中选择练习目录,发出只读检查任务

这一步负责确认事实。请以当前页面、文件或命令输出为准,同时记下来源、版本和检查时间,避免只凭印象继续操作。

  1. 在 UI 中选择练习目录,发出只读检查任务。
  2. 把看到的实际信息摘出来;教程与本机不同的地方单独标注。
  3. 保存链接、截图或命令输出,确保之后可以复查。
  4. 对照今天的目标检查这一项,发现偏差时先处理偏差,再进入第 5 步。
完成这一步后,你应该看到:在 UI 中选择练习目录,发出只读检查任务,相关来源和实际结果已经保存。
DeepSeek Harness 无密钥进入后的工作区选择主页
真实软件截图:跳过密钥配置后可以进入本地主页,但必须先选择独立练习工作区;此时不能声称已经完成模型任务。

第 5 步:核对返回的文件、项目类型和路径是否与磁盘一致

这一步负责确认事实。请以当前页面、文件或命令输出为准,同时记下来源、版本和检查时间,避免只凭印象继续操作。

  1. 核对返回的文件、项目类型和路径是否与磁盘一致。
  2. 把看到的实际信息摘出来;教程与本机不同的地方单独标注。
  3. 保存链接、截图或命令输出,确保之后可以复查。
  4. 对照今天的目标完成最后检查,确认所有证据已经保存。
完成这一步后,你应该看到:核对返回的文件、项目类型和路径是否与磁盘一致,相关来源和实际结果已经保存。
启动与只读任务SHELL
node --version
npm --version
npx @deepseek-ai/dsh web

# 在 Web UI 中发送:
请只读检查当前练习目录。
列出绝对路径、顶层文件、项目类型和可用的检查命令。
不要创建、修改、移动或删除任何文件。
截至 2026-08-19,官方默认地址为 http://127.0.0.1:3080;以你核验到的 README 为准。
当天操作记录MARKDOWN
# 第 02 天操作记录

## 今天使用的入口与版本

## 实际完成的步骤
- [ ] 1. 在终端记录 Node 与 npm 版本。
- [ ] 2. 按官方 README 的当前入口启动 Web UI。
- [ ] 3. 记录实际地址、启动时间和终端输出。
- [ ] 4. 在 UI 中选择练习目录,发出只读检查任务。
- [ ] 5. 核对返回的文件、项目类型和路径是否与磁盘一致。

## 保存的证据
- 文件:
- 截图:
- 命令或测试结果:

## 与文章不同的地方

## 下一步
请填写实际发生的情况。没有执行的步骤保持未勾选,遇到的差异直接写入记录。

这次真实操作得到了什么

S02 第 2 天真实操作结果
官方 Web UI 在无密钥状态下启动
  1. 锁文件安装 925 个包,完整构建退出码 0,本地 127.0.0.1:3080 返回 HTTP 200;没有输入真实 API Key。
本次实际结果:界面与配置可检查,但没有把无密钥启动说成真实模型调用通过。

正确结果长什么样

完成操作后,用结果来判断今天是否学会。页面能打开或命令能运行,只能说明流程启动了;下面这些证据同时出现,今天才算完成。

  1. Web UI 可以从记录的命令启动。
  2. 终端中保存了 Node、npm、Harness 入口和实际地址。
  3. 只读结果与练习目录完全一致。
  4. 任务完成后文件时间与内容没有发生修改。

常见错误与恢复

命令找不到或版本不符

回到官方 README 检查运行要求,记录实际版本后再处理。

打开了错误目录

停止会话,重新选择独立练习目录并再次只读核对。

只读任务仍修改文件

停止后续写入,保存证据并检查规则、工具权限和版本问题。

留给明天的材料

结束前把今天的关键结果保存到项目目录。下一天会直接使用这些材料,保存清楚可以减少重复说明和错误猜测。

  1. 可重复的启动命令与环境记录。
  2. 只读检查结果。
  3. 启动终端截图和实际访问地址。
完成检查

第 02 天完成检查

  • Web UI 可以从记录的命令启动。
  • 终端中保存了 Node、npm、Harness 入口和实际地址。
  • 只读结果与练习目录完全一致。
  • 任务完成后文件时间与内容没有发生修改。

官方依据与延伸阅读

DeepSeek Harness 官方仓库图文教程:Harness 安全启动图文教程:Harness 插件判断