AllWorkin / Articles / 2026.08.14

DeepSeek Harness本地Web UI:3步打开,第一件事别写代码

DeepSeek 开源了本机 Agent 运行时 DeepSeek Harness。一条 npx 能打开本地网页。真正卡住的往往不是安装,是没选工作区,输入框一直灰着。3 步:密钥、专用目录、第一句只读。界面上四种模式:标准日常用,PTC 做多步编排,极简是基准对照,创造拿来做 preset。别把家目录直接当工作区。

2026.08.14约 4 分钟#DeepSeek#设计#Agent#Claude

DeepSeek 把 Agent 运行时,也就是Harness,开源了,启动就一行命令。

常见反应是:先收藏仓库,等「稳定了再装」。

很多人真正卡住的地方,不在安装。网页打开了,输入框是灰的。

之前写过《Harness / Loop / Graph不再混乱》。那篇讲改错层。这篇落到本机:打开本地网页,配密钥、选工作区,发一句只读任务。


一、一条命令,浏览器里出现界面

先装好 Node.js,终端执行(以 官方 README 当天文本为准):

npx @deepseek-ai/dsh web

官方写明:Web UI 默认在 http://127.0.0.1:3080。端口被占用时,以终端打印的 URL 为准。

要跟仓库、改组合,走源码路径:git clone 之后 pnpm install → pnpm run build → pnpm dsh web。入门不必两条都跑通。

产品处在 developer preview(开发者预览)。官方原话写得很硬:未来会有破坏兼容性的变更。别按生产 SLA 去赌。

npm 缓存权限报错时,社区讨论里常见做法是清 npx 缓存再跑,或换一个独立 cache 目录。先让页面出来,再排别的。

看到界面,只完成了 1/3。


二、灰输入框:还没选工作区

官方 Web UI 指南有一条硬条件:没选中工作区,会话输入框不可用。

dsh 进程会把你执行命令时的目录,当成默认文件系统位置。但新开的网页,不会自动帮你选中任何工作区。

所以会出现这种场面:服务起来了,浏览器也开了,你却发不了第一句。

不是坏了。是还没点「选择工作区」。

工作区用专用空目录,别用家目录、下载目录,也别指向整盘项目根。后面 Agent 一旦拿到写权限,改错地方不可逆。


三、3 步走完最小闭环

1、密钥

设置 → 模型。在 DeepSeek 卡片里填 API 密钥并保存。

官方说明:保存后立刻能用,不用重启服务。页面不回显明文。密钥落在本机凭据文件里,别把它粘进聊天。

Anthropic、OpenAI 或 OpenAI 兼容网关也可以,见官方《配置模型》指南。本步只要有一个可用模型。

2、工作区

添加那个专用目录,并选中它。

输入框应变成可发送。还是灰的,就回来检查有没有真的选中,而不是只「添加」了一下。

3、第一句用只读

新建会话,先发类似下面的话(可改目录名,不要一上来让它大范围改文件):

请只读查看当前工作区:列出顶层文件名,用几句话说明是不是空目录。
不要创建、修改或删除任何文件。若需要写权限,先说明原因等我确认。

审批弹窗出来时,先看路径落没落在工作区内。只读任务若弹出写入,拒绝。

两笔账要分开:本机文件改动,和模型 API 账单,不是同一件事。Agent「想了一会儿」也会产生费用;改了一个文件不一定贵,但可能回不去。


四、界面上那四种模式

网页开了之后,能切到四个运行模式:标准、PTC、极简、创造。

别四个都点一遍当仪式。官方定位差得很开。

标准模式:功能完整的编码 Agent。文件编辑、Shell、检索、Skills、计划、子代理、工作流都在这儿。第一句只读,用这个。日常也先停在这儿。

PTC 模式:标准那套能力都有。差别是工具会通过 Code Mode SDK 交给模型,让它写一段 TypeScript,把多步操作串起来。步骤清楚、要批处理时再切。边聊边改的任务,留在标准更省事。

极简模式:只留持久 bash 和一个字符串替换编辑器(str_replace_editor)。官方写明:用于最小化环境下的模型基准测试,不是日常全能。工具少不等于更安全,bash 照样能改文件。

创造模式:标准能力之外,多了运行时检查、插件实验、preset 创作指导。可以检查当前运行时,在内存里试 Cordis 插件,再组合新模式。第一次打开网页,别从这儿入门。

今天只要认得这四个名字。第一句只读走标准。切模式、读轨迹、做 preset,都是网页已经能发话之后的事。


五、和 Cursor / Claude Code / Codex 什么关系

不需要先卸载他们。

DeepSeek Harness 这一套是本机 Agent 运行时:模型在云端,工具、工作区、审批、会话日志在你电脑上。Cursor、Claude Code、Codex 解决的是另一条日常编码路径。

我的判断:先当「多一个能打开的本机界面」,别当「今天必须完全替代」。预览版菜单和命令都会变。命令以当天官方页面和终端输出为准。


打开了,灰框解开了,只读跑过了,就可以停。

别把家目录直接当工作区。别在预览版上承诺生产稳定。

我制作了《DeepSeek Harness 实战 16 讲》,已放在知识星球 AI工具实战派,可免费阅读。


参考链接

AI工具实战派

觉得有用?每周的新笔记先发公众号。

每周的实战笔记先发在这里。扫码关注,新文章第一时间推给你。

关注 / 加入社群 →