开始之前
- 准备受支持的 Node.js 环境和一个可以安全检查的项目目录。
- 不要从包含秘密或绝不能修改的文件目录开始第一次体验。
- 让 Web UI 保持在默认本机回环地址,不要把它暴露到局域网。
- 准备好要配置的模型提供方凭据。
启动官方 Web UI
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完成一个小而可观察的任务
- 01
打开终端打印的本机地址
默认浏览器界面使用 3080 端口。以进程实际打印的地址为准,并保持终端继续运行。
- 02
配置一个模型
进入 Settings,添加所需提供方凭据。不要把凭据粘贴到对话或项目文件中。
- 03
选择可丢弃工作区
另建一个可丢弃的练习项目,或选择自己的目标项目,再添加并选中该目录。官方 Harness 固定源码目录用于运行环境,不应选为 Agent 的编辑工作区。选定工作区后,消息输入区即可使用。
- 04
先提出一个只读任务
可以先让 Agent 总结仓库并指出主要程序包。确认它读取了什么,再决定是否让它修改文件。
- 05
认真阅读每一次审批
检查命令、路径和预期效果。如果操作越过工作区或明显超出任务需要,应当拒绝。
第一次运行之后
完成第一项小任务
固定源码构建启动后,配置模型并明确选择项目。请求修正一处 README,检查差异,再确认重新打开会话后仍可继续对话。
检查我的 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 尚未选择工作区。请添加并选择项目目录,同时确认设置 → 模型中已配置可用模型。
继续学习
查看验证证据并继续操作
对比已发布制品,或返回安装文档。