大家好,我是云途。今天第一次启动 Harness。启动成功只代表服务在运行,我们还要确认它看到的是正确目录,并且能够遵守只读要求。
所有安装与运行依赖都保留在练习项目或官方临时执行范围内,不把全局环境当作项目能力。
先理解今天的原理
启动链路包含 Node 环境、包版本、本地服务、浏览器地址和项目工作目录。任何一层不同,都可能让教程中的表现与本机不一致。
只读检查是风险最低的第一项任务。它可以验证项目路径、文件识别和指令遵守情况,同时不会改变现有文件。
为什么今天要做这件事
- 保存环境信息可以让后续错误具备可复现条件。
- 先验证只读能力,再逐步开放写入权限。
- 确认实际工作目录可以避免在错误项目中运行任务。
开始前检查
这是第 02 天。先完成下面的检查,再开始操作。缺少关键材料时,先补材料,不要让 Agent 猜。
- 昨天的边界记录已经完成。
- Node 版本满足官方 README 当前要求。
- 练习目录里只放可以公开和修改的测试文件。
一步一步完成
第 1 步:在终端记录 Node 与 npm 版本
这一步会生成后续课程继续使用的材料。文件名、保存位置和内容边界需要写清楚,让第二天重新打开项目时仍然知道它的用途。
- 在终端记录 Node 与 npm 版本。
- 打开新材料逐项检查,删除示例占位内容,补上本次真实信息。
- 记录保存路径,并确认关闭页面或重新打开项目后仍能找到。
- 对照今天的目标检查这一项,发现偏差时先处理偏差,再进入第 2 步。
完成这一步后,你应该看到:在终端记录 Node 与 npm 版本,产物内容完整并且可以重新找到。
第 2 步:按官方 README 的当前入口启动 Web UI
这一步会让环境或项目发生变化。开始前先保存当前状态,执行时记录真实入口、参数和输出,出现异常就停在当前步骤排查。
- 按官方 README 的当前入口启动 Web UI。
- 保存执行命令、输入参数、开始前状态和结束后的输出。
- 重新运行一次最小检查,确认结果可以稳定复现。
- 对照今天的目标检查这一项,发现偏差时先处理偏差,再进入第 3 步。
完成这一步后,你应该看到:按官方 README 的当前入口启动 Web UI,执行过程与可复现结果已经记录。

第 3 步:记录实际地址、启动时间和终端输出
这一步会生成后续课程继续使用的材料。文件名、保存位置和内容边界需要写清楚,让第二天重新打开项目时仍然知道它的用途。
- 记录实际地址、启动时间和终端输出。
- 打开新材料逐项检查,删除示例占位内容,补上本次真实信息。
- 记录保存路径,并确认关闭页面或重新打开项目后仍能找到。
- 对照今天的目标检查这一项,发现偏差时先处理偏差,再进入第 4 步。
完成这一步后,你应该看到:记录实际地址、启动时间和终端输出,产物内容完整并且可以重新找到。
第 4 步:在 UI 中选择练习目录,发出只读检查任务
这一步负责确认事实。请以当前页面、文件或命令输出为准,同时记下来源、版本和检查时间,避免只凭印象继续操作。
- 在 UI 中选择练习目录,发出只读检查任务。
- 把看到的实际信息摘出来;教程与本机不同的地方单独标注。
- 保存链接、截图或命令输出,确保之后可以复查。
- 对照今天的目标检查这一项,发现偏差时先处理偏差,再进入第 5 步。
完成这一步后,你应该看到:在 UI 中选择练习目录,发出只读检查任务,相关来源和实际结果已经保存。

第 5 步:核对返回的文件、项目类型和路径是否与磁盘一致
这一步负责确认事实。请以当前页面、文件或命令输出为准,同时记下来源、版本和检查时间,避免只凭印象继续操作。
- 核对返回的文件、项目类型和路径是否与磁盘一致。
- 把看到的实际信息摘出来;教程与本机不同的地方单独标注。
- 保存链接、截图或命令输出,确保之后可以复查。
- 对照今天的目标完成最后检查,确认所有证据已经保存。
完成这一步后,你应该看到:核对返回的文件、项目类型和路径是否与磁盘一致,相关来源和实际结果已经保存。
node --version
npm --version
npx @deepseek-ai/dsh web
# 在 Web UI 中发送:
请只读检查当前练习目录。
列出绝对路径、顶层文件、项目类型和可用的检查命令。
不要创建、修改、移动或删除任何文件。# 第 02 天操作记录
## 今天使用的入口与版本
## 实际完成的步骤
- [ ] 1. 在终端记录 Node 与 npm 版本。
- [ ] 2. 按官方 README 的当前入口启动 Web UI。
- [ ] 3. 记录实际地址、启动时间和终端输出。
- [ ] 4. 在 UI 中选择练习目录,发出只读检查任务。
- [ ] 5. 核对返回的文件、项目类型和路径是否与磁盘一致。
## 保存的证据
- 文件:
- 截图:
- 命令或测试结果:
## 与文章不同的地方
## 下一步这次真实操作得到了什么

- 锁文件安装 925 个包,完整构建退出码 0,本地 127.0.0.1:3080 返回 HTTP 200;没有输入真实 API Key。
本次实际结果:界面与配置可检查,但没有把无密钥启动说成真实模型调用通过。
正确结果长什么样
完成操作后,用结果来判断今天是否学会。页面能打开或命令能运行,只能说明流程启动了;下面这些证据同时出现,今天才算完成。
- Web UI 可以从记录的命令启动。
- 终端中保存了 Node、npm、Harness 入口和实际地址。
- 只读结果与练习目录完全一致。
- 任务完成后文件时间与内容没有发生修改。
常见错误与恢复
回到官方 README 检查运行要求,记录实际版本后再处理。
停止会话,重新选择独立练习目录并再次只读核对。
停止后续写入,保存证据并检查规则、工具权限和版本问题。
留给明天的材料
结束前把今天的关键结果保存到项目目录。下一天会直接使用这些材料,保存清楚可以减少重复说明和错误猜测。
- 可重复的启动命令与环境记录。
- 只读检查结果。
- 启动终端截图和实际访问地址。
第 02 天完成检查
- Web UI 可以从记录的命令启动。
- 终端中保存了 Node、npm、Harness 入口和实际地址。
- 只读结果与练习目录完全一致。
- 任务完成后文件时间与内容没有发生修改。