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工具实战派,可免费阅读。
参考链接
- DeepSeek Harness 官方仓库:https://github.com/deepseek-ai/deepseek-harness
- 产品页:https://www.deepseek.com/harness/
- Web UI 指南(仓库 docs):https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/guide/index.md