DeepSeek Harness 快速入门四道门:启动、模型、工作区、任务各用什么判据确认通过
DeepSeek Harness 的快速入门不是「四步点完」,而是「四道门依次放行」:进程打印出访问地址,模型选择器可用,会话输入框解锁,第一条任务返回结果。 四道门有先后依赖,前一道门没过,后一道门的现象会骗人。这篇把每道门的判据、最小验证动作和三个常见误判放在一张表里,具体点击顺序见《DeepSeek Harness Web UI 怎么用》。
DeepSeek Harness 为什么快速入门要按门走
因为快速入门的前一步没完成时,后一步往往不是「没反应」,而是「有反应但结果不对」。 例如没配模型时输入框可能已经能打字,发出去却迟迟没有返回;没选工作区时页面看起来正常,输入框却一直是灰的。把四步当成四道门,先确认放行判据,再往下一步走,能少绕很多路。(来源)
官方 Quickstart 给出的顺序是:先启动 Web UI,再打开「设置 → 模型」配置密钥,然后添加并选中工作区,最后启动会话发一条任务(来源)。这个顺序本身就是依赖顺序:模型配置决定请求能不能发出去,工作区决定 agent 对哪里动手,任务则同时验证前两道门。
四道门不是官方术语,而是把官方四步改写成四个可判断的状态。官方页面描述的是「做什么」,这里补的是「做到什么程度算完成」。如果你已经按官方步骤点过一遍,但不确定是否真的成功,就按这张判据表逐项对照,而不是再从头点一遍。
需要区分的是「快速入门」和「安装验收」。安装验收看的是二进制、端口、插件目录这些更底层的东西;四道门看的是浏览器里能不能完成一次真实任务。两者有交集,但不能互相替代。安装验收通过而四道门没过,说明问题在配置或界面状态;四道门过了而安装验收没过,通常只是还没检查插件、更新与卸载这些后续环节。
DeepSeek Harness 四道门的判据表
每道门只认一个判据,不要把「页面打开了」「按钮能点」当成通过。 下面这张表是本篇的主干(来源):
| 门 | 放行判据 | 最小验证动作 | 没过时最先看 |
|---|---|---|---|
| 1 启动 | 终端打印访问地址且进程不退出 | 回到启动终端看最后几行 | 终端报错、端口占用 |
| 2 模型 | 模型选择器可用,保存后下一次请求能返回 | 保存密钥,发一条最小任务 | 密钥、提供商、模型列表 |
| 3 工作区 | 添加并选中目录后输入框解锁 | 点「选择工作区」选中项目目录 | 目录权限、是否真的选中 |
| 4 任务 | 会话返回一条结果,且能看到执行过程 | 发送一条只读任务 | 审批等待、模型报错、进程退出 |
这张表有两个用法。第一种是正向走:每完成一步就对照判据,通过了再走下一步。第二种是反向查:任务没返回时,从第四道门往回退,先看输入框是否可用,再看模型是否可用,最后看进程是否还活着。
表的第三列是「最小验证动作」,不是完整测试。它的作用是让你用最少操作拿到一个明确结果:看一次终端、发一条最短消息、选一次目录。快速入门阶段不要一上来就跑复杂任务,复杂任务会把模型、工作区、审批、插件的问题混在一起。
判据之所以要「可观察」,是因为快速入门阶段最缺的是区分能力。日志、报错、界面状态都可能同时出现,只有把判据固定成一个具体现象,才能判断自己到底停在哪。比如「保存成功」是界面反馈,「请求返回」才是模型可用;「目录已添加」是列表状态,「输入框解锁」才是工作区生效。
DeepSeek Harness 逐门看判据:启动与模型
第一道门的判据是终端里的访问地址,不是浏览器里的页面。 启动 dsh 后,进程会打印 Web UI 的访问地址;地址出现且进程保持运行,才算启动成功(来源)。如果终端没有这行地址,先不要刷新浏览器:看终端是报错退出、端口被占用,还是仍在启动。启动阶段的排查可以对照《dsh web 第一次打开的五分钟》。
第二道门的判据是「保存后下一次请求能返回」,不是「密钥输入框有内容」。 打开「设置 → 模型」,填入 DeepSeek API 密钥并保存;官方说明模型变更在下一次请求时生效,不需要重启服务器(来源)。所以保存完要发一条最小任务,拿到返回才算通过。
最小验证分三步,不要省:
- 看选择器 — 模型选择器里能看到至少一个模型,并且当前选中的不是空值;
- 发一条最短任务 — 例如让它用一句话说明当前目录是什么项目;
- 看返回 — 有正常回复即通过;报凭据错误、模型不存在或连接失败,都算没过。
这里有一个容易忽略的细节:保存成功只代表配置写入成功,不代表密钥一定可用。密钥错误、端点不通、模型不存在,都会在请求阶段才暴露。模型这道门要同时看「配置是否保存」和「请求是否返回」,只看前者会把问题带到下一道门。
还有一点:不要为了「让它生效」反复重启进程。官方明确说模型变更在下一次请求生效,重启不是必要动作。反复重启只会打断你观察第一次请求的结果,让排查更难。
如果你用的是第三方提供商或自定义模型 API,判据不变,但检查项会多一层:提供商 ID、基础 URL、API 协议、模型 ID 是否匹配。具体配置方法见《DeepSeek Harness 模型提供方怎么配》。
DeepSeek Harness 逐门看判据:工作区与任务
第三道门的判据是会话输入框解锁,不是「目录出现在列表里」。 全新的 Web UI 不会自动选中任何工作区;dsh 进程会把启动时所在的目录作为默认文件系统位置,但界面侧仍要你点「选择工作区」,添加启动目录并选中它(来源)。选中前输入框不可用,选中后才解锁。
这里要分清两个概念:启动目录是进程的默认文件系统位置,工作区是这次会话的操作边界。两者可以相同,也可以不同。快速入门阶段建议先用启动目录,减少变量;等跑通后再考虑多工作区。工作区的概念与多目录管理见《DeepSeek Harness 工作区怎么选》。
第四道门的判据是任务返回结果,并且你能看到它做了什么。 官方示例是发送「Summarize this repository and identify its main packages.」;agent 可以读取和编辑工作区文件、运行命令、委派工作并维护计划,按当前权限策略需要审批的操作会先询问你(来源)。第一条任务建议用只读任务,先看它能不能读文件、给结论,再考虑让它改东西。
任务返回后,不要只看最后一段文字。还要看它有没有读到你点名的目录、有没有执行你预期的那类动作、有没有停在审批上。第一条任务的写法可以对照《DeepSeek Harness 第一条任务怎么写》。
具体看三处:
- 看它读了什么 — 结果里是否提到你选中目录里的文件或项目结构;完全没提,说明工作区可能没生效;
- 看它做了什么 — 是否出现了读文件、列目录、跑命令这类动作;只有一段泛泛而谈,可能是任务描述太宽;
- 看它停在哪 — 如果停在审批,先处理审批;如果报错,记下错误码回到模型那道门检查。
第一条任务建议用只读任务,原因不是 agent 不能改文件,而是只读任务能把「模型能不能工作」和「文件改得对不对」分开。先确认前者,再让它动手,排查成本会低很多。
DeepSeek Harness 三个常见误判
快速入门阶段最常见的错误,不是不会点,而是把一种停住误判成另一种。 下面三个误判几乎每个新手都会遇到一个(来源):
- 把白屏当模型问题。 页面打不开、白屏、连接失败,属于启动与访问问题,不是模型配置问题。先回终端看进程和地址,再对照《DeepSeek Harness Web UI 打不开、白屏排查》。
- 把灰输入框当浏览器问题。 输入框一直是灰的,最常见原因是没选中工作区,而不是浏览器缓存。先看「选择工作区」里有没有已选中的目录。
- 把审批等待当卡死。 agent 停在审批弹窗时,任务并没有失败,只是在等你的决定。先看界面上有没有待处理的审批,再决定批准、拒绝还是取消。
这三个误判有一个共同点:都把「下一道门的问题」当成了「当前这道门的问题」。按门走的价值,就是让你在出错时知道该往回退到哪一道。
DeepSeek Harness 四门全过之后的最小可用状态
四门全过之后,你得到的不是「配置完成」,而是一个可以重复的最小闭环:能启动、能发请求、能对选中目录动手、能拿到结果。 这个闭环足够支撑下一步的扩展,但不等于所有配置都正确。(来源)
最小可用状态包括四件事:
- 启动稳定 — 终端能稳定打印访问地址,进程不因普通操作退出;
- 模型可用 — 模型选择器里有一个可用模型,发请求能返回;
- 工作区生效 — 已选中目录,agent 能读到目录里的文件,而不是只能空谈;
- 任务闭环 — 第一条任务能完整走完,审批、执行、返回都有记录。
四项都满足,再谈插件、自动化和多环境。少一项就先去补那一项,不要用更复杂的任务去「试试看」。
想扩展 Web UI 的能力,可以从插件市场开始:先装 DSH Plugin Hub,再在「设置 → 插件市场」里浏览、搜索并安装社区插件。插件装完不生效,通常要回到 profile 与刷新页面这两处检查,不要把它和四道门混在一起。
四道门的详细分支在后面几篇:密钥为什么保存后看不见看第 2 篇,输入框不可用看第 3 篇,模型列表与换模型看第 5、6 篇,首次审批与卡住分诊看第 9、10 篇。
常见问题
DeepSeek Harness 启动成功的判据是进程在终端打印出访问地址并保持运行。先看终端有没有这行地址,再打开浏览器;终端没有地址,刷新页面不会让它出现。
DeepSeek Harness 的模型变更在下一次请求时生效,保存动作只完成配置写入。发一条最小任务并拿到返回,才是模型这道门的放行判据。
DeepSeek Harness 的全新 Web UI 不会自动选中任何工作区。dsh 进程只是把启动目录当作默认文件系统位置,界面侧仍要你添加并选中目录,选中前会话输入框不可用。
DeepSeek Harness 第一条任务返回只说明模型、工作区和执行链路都通了,不说明插件、审批策略和长期配置都正确。四道门只覆盖首次成功,扩展能力要另做验证。
相关术语
- 快速入门四道门
- 快速入门四道门是 DeepSeek Harness 首次成功路径上的四个放行点:启动进程、配置模型、选中工作区、跑通任务;前一道门没过,后一道门的现象会误导判断。— DeepSeek Harness 官方文档 - 使用 Web UI
- 放行判据
- 放行判据是判断某一步是否真的完成的可观察证据,例如终端打印访问地址、模型选择器可用、会话输入框解锁、任务返回结果。— DeepSeek Harness 官方文档 - 使用 Web UI
- 工作区
- 工作区是 DeepSeek Harness Web UI 中供 agent 读写的文件系统位置,必须显式添加并选中;未选中前会话输入框不可用。— DeepSeek Harness 官方文档 - 使用 Web UI
- 模型路由
- 模型路由是 DeepSeek Harness 把一次请求交给哪个模型提供商与模型的配置结果,保存后在下次请求生效,不需要重启服务器。— DeepSeek Harness 官方文档 - 配置模型
来源
- DeepSeek Harness 官方文档 - 使用 Web UI· deepseek-harness
- DeepSeek Harness 官方文档 - 配置模型· deepseek-harness
- DeepSeek Harness 根目录 README - 运行· deepseek-ai