DeepSeek Harness plugins directoryDSH Pluginsdsh 插件目录
返回指南

DeepSeek Harness 教程：5 分钟跑通 dsh（快速上手）

最短的 DeepSeek Harness（dsh）使用教程：Node.js 24.9+ 上跑 npx @deepseek-ai/dsh web，网页端在 http://127.0.0.1:3080，Settings → Models 填 API key，五分钟跑完第一个任务。

最近更新: 2026-11-12

一句话答案

DeepSeek Harness（dsh）是 DeepSeek 开源的、万物皆插件的智能体运行时，目前仍是开发者预览版，版本之间会有破坏性变更。先装 Node.js 24.9 或更新版本（官方 README 与 @deepseek-ai/dsh npm 包声明的下限），然后运行：

npx @deepseek-ai/dsh web

网页端默认起在 **http://127.0.0.1:3080**，一般会自动打开浏览器。在 Settings → Models 填上 API key，选一个工作区，再让智能体跑一个小任务就完成了。如果只想在终端里跑一次性任务：

npx @deepseek-ai/dsh --profile headless "总结这个项目，并说明主要文件各自做什么"

先 npm install -g @deepseek-ai/dsh 再 dsh web 依然可用，但那只是可选路径——官方推荐的零安装入口是 npx。本页内容在 2026-11-12 对照官方 README 与已发布的 npm 包核过；第三方教程与之冲突时，以 README 为准。

安装：一条命令

npx @deepseek-ai/dsh web

首次运行会下载安装包（提示 “Ok to proceed?” 时输入 y），以 web profile 启动，并在浏览器里打开网页端。

想要一个常驻的 CLI？装一次，之后每次启动就不用再下载：

npm install -g @deepseek-ai/dsh
dsh web          # 与 dsh --profile web 等价

过程中遇到问题，直接看 github.com/deepseek-ai/deepseek-harness —— README 和 issue 都在那里，所支持的 Node.js 版本也以 README 为准。

API key，或者不用填

在网页端打开 Settings → Models，填上 DeepSeek 的 API key 并保存，模型路由立刻可用，不需要重启。如果本机环境变量里已经有 DeepSeek 的 key，这一步都可以直接跳过。

Harness 是身体，模型才是大脑。想用别的模型也行，任何 OpenAI 兼容端点都能在 UI 设置里接入（见什么是 DeepSeek Harness？）。

第一个任务之前

只确认一件事：从想让智能体干活的文件夹启动 dsh。 默认沙箱只允许它碰这个工作区，所以启动目录本身就是一道安全边界。

你的第一个任务

网页端打开就是一个对话。描述你想要的结果，而不是具体操作——智能体会自己规划步骤。适合第一次试的任务：

  • "总结这个仓库里的 TODO，并给出完成的计划。"
  • "修好这个项目里失败的测试，并运行测试确认。"
  • "用一篇短文解释这个代码库的结构。"

观察发生了什么：智能体可能会先问一个澄清问题，或者先提出方案、等你批准再动手，然后开始一连串工具调用。会话日志记录模型看到的一切，所以之后可以随时恢复或分叉这个会话。

遇到风险操作——写工作区以外的文件、联网、运行陌生命令——Harness 会先问你。那是审批系统在工作，不是 bug。

选对模式

界面顶部的模式选择器，选的是当前会话的 Agent Preset。第一次跑用默认的标准模式就够了。四个模式：

模式是什么什么时候用
标准模式完整的编程助手：能理解需求、修改代码、运行命令并检查结果日常写代码和调研
PTC 模式在标准模式基础上，支持用 TypeScript 编写小程序，把多步操作组合成自动化流程大量机械步骤的任务
极简模式只提供持续可用的终端和基础文本替换工具简单的改动、基准测试，或想看零魔法的主循环
创造模式在标准模式基础上，额外支持运行时检查、尝试插件，以及使用预设完成创作类任务设计你自己的预设——信任等级等同 shell，谨慎使用

会话一旦产生内容就锁定预设，所以先选模式、再开始输入。

第一次会话之后

  • 会话可恢复。 关掉标签页再回来，事件日志支持恢复、分叉、检索、回放。
  • 装插件就是一条命令： dsh plugin --profile web add <包名或 github:owner/repo>，然后重启 dsh web。它把参数转给 profile 目录里的 pnpm；装第一个之前先读安全地安装插件。
  • Profile、Patch 与 Preset 决定了 Harness 如何围绕你组装——配置指南讲清了叠加顺序。内置 Patch 层也是 dsh 和其他 Agent 拉开差距的地方：子 Agent、条件规则、权限、UI 替换，全是配置。

跑不起来怎么办

  • Node.js 版本 —— 最常见的首次运行失败原因。dsh 需要 Node.js 24.9 或更新版本，先跑 node --version；这个下限若有变动，以官方 README 为准。
  • 模型没响应 —— 检查 Settings → Models 里的 API key，以及机器能否访问供应商的端点。
  • 3080 端口被占用 —— 用 npx @deepseek-ai/dsh web --port 8080，再打开终端打印出来的地址。
  • 命令被拒绝 —— 那是沙箱或审批策略在拦；要么有意识地放宽沙箱（见安全指南），要么就在工作区内干活。

下一步

DSH Plugins 是独立的 DeepSeek Harness 插件目录，与 DeepSeek 官方无关，也不代表官方背书。第三方插件未经安全审计，安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件，绝不滥发。