DeepSeek Harness 入门：一行起 Web UI，再跑通第一个仓库任务

这篇解决什么问题

DeepSeek Harness（命令行名 dsh）是 DeepSeek AI 开源的 agent 运行时。它不是 chat.deepseek.com，也不是一个新模型。它是套在模型外面的那一层：工具、文件、会话、循环、界面。官方 README 写得很清楚：目前是开发者预览，会有破坏兼容性的变更。

正确的学习顺序不是先读完 Cordis 论文，而是先跑通一条最小闭环。

第一步：用 npm 起 Web UI

先装 Node.js，然后：

sh npx @deepseek-ai/dsh web

该命令启动 Web UI，默认地址是 http://127.0.0.1:3080。调用目录会当作默认文件系统位置，但新开的 Web UI 还不会自动选中工作区。

从源码跑：

sh git clone https://github.com/deepseek-ai/deepseek-harness.git cd deepseek-harness pnpm install pnpm run build pnpm dsh web

命令与默认端口摘自官方 README / Web UI 指南。版本会变，部署前以仓库当前文档为准。

第二步：填模型 Key，再选工作区

打开 Settings → Models，填 DeepSeek API Key 并保存。官方说明：Key 只写不读，落在 $DSH_HOME/.credentials.yaml，改模型不必重启服务。

接着点 Choose workspace，把你启动 dsh 的项目目录加进去并选中。没选中之前，会话输入框不可用。

第三步：只发一个短任务

官方 Web UI 指南的第一个例子就够：

Summarize this repository and identify its main packages.

先别让它改代码、推仓库、装依赖。先看它能不能读文件、能不能在权限策略下跑命令。需要批准的操作，Web UI 会问你。

两条不要跳的路

• headless：dsh --profile headless "job" 跑一次会话、打出答案就退。适合脚本，不适合第一天熟悉界面。
• 自定义模型厂商：除了 DeepSeek Key，官方还支持 Anthropic / OpenAI 目录厂商，以及自定义 OpenAI 兼容端点。第一天先用 DeepSeek 跑通，再换端点。

边界

不要把开发者预览当成稳定生产底座。可以用它学架构、写插件、做实验；别把核心业务流程绑死在当前命令和配置上。许可证是 MIT。

专区入口：/zh/deepseek-harness。

常见问题

DeepSeek Harness 怎么安装？

装 Node.js 后跑 npx @deepseek-ai/dsh web。源码路径是 clone 仓库后 pnpm install && pnpm run build && pnpm dsh web。

为什么输入框是灰的？

官方 Web UI 指南写明：没选中工作区之前，会话编辑器不可用。先 Choose workspace。

它只能用 DeepSeek 模型吗？

不是。官方 providers 指南还支持目录厂商和自定义 OpenAI 兼容端点。

官方来源：DeepSeek Harness README 与 Web UI 指南。本文是学习路径导读，不替代官方文档。