一条命令装好 DeepSeek Harness：新手 5 分钟上手
⚠️ 本文基于开发者预览版 v0.1 撰写，项目仍处预览期，官方提示「会有破坏性变更」。命令与界面以你安装时的官方仓库为准。
DeepSeek Harness（社区简称 dsh）是 DeepSeek 于 2026-08-13 开源的 AI Agent 框架，核心理念是「一切皆插件」。一句话理解：它是给 AI 装上「手脚」的那一层——让模型能读文件、跑命令、调工具，把一件事从头做到尾。
本篇带你用一条命令跑起来。
一、环境要求
- Node.js 22.19+ 或 24+（太低会报错）
- 一个可用的模型 API Key（DeepSeek 或其他 38+ 家支持的供应商）
- 本地有浏览器（Web UI 走 127.0.0.1:3080）
二、安装并启动
打开终端，直接跑：
npx @deepseek-ai/dsh web首次会自动拉取并启动一个本地 Web UI，默认地址 http://127.0.0.1:3080。
想从源码跑也行：
git clone https://github.com/deepseek-ai/deepseek-harness && cd deepseek-harness && pnpm install && pnpm run build && pnpm dsh web
三、填 Key 就能用
浏览器打开后，在设置里填入你的 API Key（DeepSeek 开放平台申请），选好模型，就能开始对话、让它操作本地文件了。
数据都在本地，不经过第三方服务器（模型调用除外，取决于你选的供应商）。
四、四种模式一句话区别
| 模式 | 适合场景 |
|---|---|
| 标准 | 完整工具组合，日常通用 |
| PTC（程序化工具调用） | 模型生成代码组合多轮工具调用，复杂任务更稳 |
| 极简 | 只留 shell + 文件编辑，最小环境基准测试 |
| 创造 | 开放更多能力，探索玩法 |
新手先用「标准」即可。
五、下一步
- 想搞懂底层设计 → 看《「一切皆插件」到底指什么？》
- 想写自己的扩展 → 看《写你的第一个 dsh 插件》
- 想横向对比 → 看《Harness vs Claude Code vs Codex》
本站为第三方独立科普站，与 DeepSeek 无官方关联。内容以官方仓库最新文档为准。