快速开始：启动 Web 界面
本教程共 32 篇 · 第 3 篇 · 更新于 2026-08-15 · 约 4 分钟阅读
本节目标：把 dsh 的 Web 界面跑起来，完成第一次对话。学完你能自己配模型、选工作区、给 Agent 派第一个任务。
启动：dsh web
在项目目录下执行：
npx @deepseek-ai/dsh web首次运行会自动初始化 web 配置模板，然后终端打印访问地址：http://127.0.0.1:3080。在浏览器打开它，看到 DeepSeek Harness 界面就成功了。
Note部分环境会自动打开浏览器，没开就手动访问
http://127.0.0.1:3080。服务跑在终端进程里，关闭终端服务就停止。Windows 首次运行时若防火墙弹窗询问，选择允许本地访问。
界面布局
第一次打开，会先看到一个版本声明页——提示当前是 Developer Preview、可能有破坏性变更，点击继续（第三方教程里说的「内测声明」就是这个）。
进入工作台后，界面分几块：
- 左侧：可折叠的 Workbench 侧边栏，用于切换工作区和会话
- 中间：工作区选择区与对话区。首次使用会先让你选一个工作目录
- 右上角：浅色/深色主题切换
- 左下角：设置入口（Settings），界面语言也可以在这里切换成中文
Tip看不懂英文界面的话，在设置里把语言切到中文再继续。所有菜单路径本教程按中文界面写：设置 → 模型。
第一次对话：三步
官方 Web UI 指南把首次使用压缩成三步，缺一步都跑不通。
第 1 步：配置模型。 打开「设置 → 模型」，填入 DeepSeek API Key 并保存。Key 在 platform.deepseek.com 的 API Keys 页面创建，注意别泄露。模型路由立即可用，不需要重启服务器。
第 2 步：选择工作区。 点击「选择工作区」，把启动 dsh 时所在的项目目录添加进去并选中。这是新手最容易卡住的地方：选中工作区之前，会话输入框是不可用的。
Note选工作区等于划定 Agent 的活动范围。dsh 默认用「调用命令时的目录」作为文件系统位置，所以第 2 章让你先 cd 再启动，就是为了这一步方便。
第 3 步：发送任务。 输入框可用后，发一条轻量指令试试，比如官方快速入门推荐的：
Summarize this repository and identify its main packages.中文同样支持，例如「读一下当前目录的 README，总结它的核心功能」。Agent 会自己读文件、跑命令、整理答案。先让它熟悉工作区，再逐步交付真实任务。
对话时你会看到的
跑第一个任务时，界面里会出现几个后续章节会细讲的元素：
- 审批弹窗：Agent 的操作超出当前权限策略时，界面会先询问你，批准后才继续。这是它的安全机制，不是故障
- 轨迹（Trajectory）：每次工具调用、每个步骤都能回看，整个执行过程有迹可循
- Token 消耗：对话底部会显示本次任务消耗、上下文占用等信息
Tip官方建议的第一个任务，用「总结这个仓库」这类轻量指令起步，比一上来就让它改代码稳妥得多。先在测试目录里试，跑熟再上真实项目。
常见启动问题排查
| 现象 | 排查方法 |
|---|---|
浏览器打不开 http://127.0.0.1:3080 | 确认终端里 dsh 进程还在跑、没有报错；检查防火墙是否放行本地端口 |
| 端口被占用 | 换一个端口：dsh web --port 8080，再用新地址访问 |
| 页面空白或异常 | 用 dsh web --dump-config 检查插件树是否健康，配置解析失败会直接报错（详见第 4 章） |
| 模型不回复 | 检查 API Key 是否正确、网络是否可达；确认模型已选择 |
| 会话输入框不可用 | 十有八九是没选工作区，回到「选择工作区」添加并选中目录 |
| 改了配置不生效 | 保存后通常无需重启；仍不生效就重启 dsh 进程 |
Warning长任务跑起来后，别随手关终端窗口。服务终止任务就中断了。想挂着跑又不占窗口，可以配合第 5 章的无头模式在后台执行。
小结
启动三件事：dsh web 起服务、浏览器开 127.0.0.1:3080。首次对话三步：配 API Key、选工作区、发任务。
界面跑通，第一步就完成了。下一章学命令行基础，把 dsh 的常用命令和参数规则摸清。