跳到主要内容
返回学习中心
05安装阅读 7 分钟入门

新手科普 · 第一次运行

DeepSeek Harness 快速上手

第一次体验可以走官方启动路径,但应使用可丢弃工作区,并让服务只监听本机回环地址。“体验 DSH”和“授权安装已验证主题”是两件不同的事。

最后验证
2026年9月6日
指南源码基线
0.1.3-alpha.1
安装状态
以所选条目的记录为准
验证范围
  • 精确 Alpha 源码构建启动
  • 官方 Web UI 使用指南
  • 本地回环地址与工作区安全边界
本页目录
  1. 开始之前
  2. 启动官方 Web UI
  3. 完成一个小而可观察的任务
  4. 完成第一项小任务

开始之前

  • 准备受支持的 Node.js 环境和一个可以安全检查的项目目录。
  • 不要从包含秘密或绝不能修改的文件目录开始第一次体验。
  • 让 Web UI 保持在默认本机回环地址,不要把它暴露到局域网。
  • 准备好要配置的模型提供方凭据。

启动官方 Web UI

bash
mkdir -p "$HOME/.dsh-themes/runtimes" &&
git clone --depth 1 --branch dsh-v0.1.3-alpha.1 https://github.com/deepseek-ai/deepseek-harness.git "$HOME/.dsh-themes/runtimes/0.1.3-alpha.1" &&
cd "$HOME/.dsh-themes/runtimes/0.1.3-alpha.1" &&
test "$(git rev-parse HEAD)" = "d347e703908d0406b7a7ef80e3a0e594d86b2215" &&
corepack pnpm install --frozen-lockfile &&
corepack pnpm run build:official &&
corepack pnpm dsh web
使用 Node.js 24 与 pnpm 11.7.0,依次运行每条命令。

完成一个小而可观察的任务

  1. 01

    打开终端打印的本机地址

    默认浏览器界面使用 3080 端口。以进程实际打印的地址为准,并保持终端继续运行。

  2. 02

    配置一个模型

    进入 Settings,添加所需提供方凭据。不要把凭据粘贴到对话或项目文件中。

  3. 03

    选择可丢弃工作区

    另建一个可丢弃的练习项目,或选择自己的目标项目,再添加并选中该目录。官方 Harness 固定源码目录用于运行环境,不应选为 Agent 的编辑工作区。选定工作区后,消息输入区即可使用。

  4. 04

    先提出一个只读任务

    可以先让 Agent 总结仓库并指出主要程序包。确认它读取了什么,再决定是否让它修改文件。

  5. 05

    认真阅读每一次审批

    检查命令、路径和预期效果。如果操作越过工作区或明显超出任务需要,应当拒绝。

第一次运行之后

完成第一项小任务

固定源码构建启动后,配置模型并明确选择项目。请求修正一处 README,检查差异,再确认重新打开会话后仍可继续对话。

text
检查我的 Node.js 与 pnpm 版本,从 d347e703908d0406b7a7ef80e3a0e594d86b2215 构建 DeepSeek Harness 0.1.3-alpha.1,并启动 Web UI。引导我在设置里填写自己的模型凭据,不要打印或编造凭据。
可以直接尝试的提示词

阅读一手官方资料

常见问题

修改前需要了解的事项

关于格式、兼容性、证据与回滚的简明说明。

这篇指南核实哪些范围?

本指南覆盖:精确 Alpha 源码构建启动;官方 Web UI 使用指南;本地回环地址与工作区安全边界

我应该先做什么?

第一次体验可以走官方启动路径,但应使用可丢弃工作区,并让服务只监听本机回环地址。“体验 DSH”和“授权安装已验证主题”是两件不同的事。

最需要记住的边界是什么?

使用 Node.js 24(仓库支持 ^22.19.0 或 >=24.0.0)和 Corepack。Corepack 为官方构建选择仓库声明的 pnpm 11.7.0,子进程可能使用不同的 pnpm 版本。截至 2026 年 9 月 6 日,这个 Alpha 的精确 npm 包和发布二进制不可用。下方已实测的源码构建使用 $HOME/.dsh-themes/runtimes 下的独立目录,请放在本网站及任何含 node_modules 的祖先目录之外,避免误用其他项目的 React 依赖。保留源码目录和构建产物,启动器仍需要它们。启动后选择工作区,并在设置 → 模型中配置自己的模型。

为什么仍然不能输入任务?

全新的 Web UI 尚未选择工作区。请添加并选择项目目录,同时确认设置 → 模型中已配置可用模型。

继续学习

查看验证证据并继续操作

对比已发布制品,或返回安装文档。