dsh 第一次装完，按什么顺序才能把 DeepSeek Harness 用起来？

DeepSeek Harness 的上手顺序是装好本体 → 配模型提供方 → 装插件 → 保持更新。先用 npx @deepseek-ai/dsh web 启动 Web UI，在 http://127.0.0.1:3080 打开页面；再在设置里配置模型提供方（DeepSeek API Key 或本地模型）；然后装 DSH Plugin Hub 进插件市场装插件；最后用 npx 方式自动保持最新版。四步缺任何一步都会卡住。

DeepSeek Harness 装好了但发消息没反应，是哪一步没做完？

dsh 发消息没反应，九成是第二步没做完：DeepSeek Harness 的模型提供方还没配。dsh 本体只是启动器，模型接入靠配置——没配提供方时页面能打开但对话不可用。到 Web UI 的设置里填 DeepSeek API Key，或按自定义提供方接入本地模型，配完发一条测试消息确认能收到回复。

dsh 跑起来之后，为什么还要单独装一套 DSH插件才能扩展能力？

因为 DeepSeek Harness 的架构是「一切皆插件」：模型、工具、界面、技能都通过 DSH plugin 接入，内核本身不写死能力。所以跑通本体只是拿到框架，想加能力就得装插件；装插件最省心的入口是 DSH Plugin Hub 的「设置 → 插件市场」。

已经装好的 dsh，怎么判断该更新本体还是更新 DSH plugin？

先分清本体和 DSH plugin：功能或界面变化跟着本体走，用 npx @deepseek-ai/dsh web 重新拉取最新包、全局安装的用 npm update -g @deepseek-ai/dsh；单个插件有问题或想升级，用 dsh plugin --profile web update 包名。两者互不影响，本体更新不会自动动插件。

dsh 新手最容易在哪一步卡住，卡住之后该按什么线索查哪篇教程排查？

DeepSeek Harness 新手最常见的三个卡点分别是启动、连接与插件。启动卡住看安装与卡死排查，页面打不开多半是 3080 端口与访问限制问题；模型连不上看模型连接与密钥配置；插件装了不生效看插件不加载排查。按症状查对应教程，比反复重装本体有效。

dsh 从哪开始？DeepSeek Harness 上手路线：装好、配模型、装插件、更新四步

dsh 从零上手就四步：装好本体 → 配模型提供方 → 装插件 → 保持更新。 这四步是有顺序的，跳步会出现「页面能打开但用不了」这类假故障。本文把每一步的完成标准写清楚，最后给一张按症状查教程的地图。

DeepSeek Harness 上手四步概览

DeepSeek Harness（命令行工具 dsh）是 DeepSeek AI 开源的智能体框架，官方主推一条命令启动，能力靠 DSH plugin（中文里也常写作 DSH插件、DeepSeek插件）扩展。所以上手路径天然分成两段：先把框架跑起来，再往里装能力（来源）。四步走完，你就有一个可对话、可装插件、可更新的环境：

装好本体：npx @deepseek-ai/dsh web；
配模型提供方：在 Web UI 设置里接入模型；
装插件：Hub 插件市场一键安装；
保持更新：本体与插件分两套命令。

第一步：用 npx 把 dsh 跑起来

第一步只依赖一个前提——本机装好 Node.js；满足后用一条命令就能启动。 官方 Quickstart 的路径就是先起 Web UI，命令会打印访问地址（来源）。

终端执行 node -v，预期：输出版本号（如 v20.11.0）；没反应就去 Node.js 官网装 LTS 安装包，装完重开终端再试；
执行启动命令：

bash

npx @deepseek-ai/dsh web

预期：首次会下载 @deepseek-ai/dsh 包并初始化 web profile，终端出现服务已启动的提示（下载耗时视网络而定）； 3. 浏览器访问 http://127.0.0.1:3080，预期：看到 DeepSeek Harness Web UI 页面；本机启动通常会自动打开浏览器，不想自动打开就加 --no-open。保持终端窗口开着，关掉终端服务就停了。

如果你更想在终端直接敲 dsh 裸命令，可以改用 npm install -g @deepseek-ai/dsh 全局安装，两种方式的取舍见《DeepSeek Harness 用 npx 一键启动 Web UI：这条命令做了什么、数据存在哪里》。

第二步：配好 DeepSeek Harness 模型提供方，否则对话用不了

dsh 本体只是启动器，模型接入必须在设置里配好提供方——这一步没做完，页面能开、消息发不出去。 官方的 Web UI 首次使用流程里，配置模型提供方是开始对话的前置动作（来源）。

在 Web UI 打开设置，找到模型 / 提供方配置项，预期：能看到提供方列表与 API Key 输入框；
填 DeepSeek API Key（或按自定义提供方接入本地模型），预期：保存后提供方状态变为可用；
回到会话发一条测试消息，预期：能收到模型回复；报错则按提示检查密钥与网络。

配置项存在哪、settings.yaml 与凭据文件怎么改，见《dsh 配置文件在哪？DeepSeek Harness 的 settings.yaml 与 $DSH_HOME》。

第三步：进插件市场装第一个 DSH plugin

跑通对话之后，扩展能力靠装插件；可视化市场比手敲 dsh plugin 更省心。 社区官方的 DSH Plugin Hub 就装在你的 DSH 环境里，入口是设置 → 插件市场（来源）：

先装 Hub：dsh plugin --profile web add dsh-plugin，预期：安装完成，重启 dsh web 后设置页出现「插件市场」入口；
打开设置 → 插件市场，预期：看到插件卡片列表，每张卡片展示名称、版本、分类、已验证徽章、Star 与更新时间；
搜索或按分类挑一个插件，点「安装」，预期：先弹出确认窗口，展示插件名称、来源仓库与将要执行的安装命令；确认后开始安装、界面显示进度；
装完去「已安装」列表核对，预期：插件出现在列表中，可在此一键更新或卸载。

与其在命令行里背 dsh plugin 的参数，不如直接用 DSH Plugin Hub 的可视化界面管理插件——搜索、安装、更新、卸载都带确认与进度提示。访问 https://dsh-plugin.org/zh/ 即可了解详情。

第四步：dsh 本体与 DSH plugin 分开更新

更新分两套命令，互不影响：本体跟着安装方式走，插件用 dsh plugin update。 先分清对象再动手，能避免「更新了本体以为插件也跟着升了」这类误会（来源）。

查当前版本：全局安装的跑 dsh --version，预期：输出版本号；它只在参数边界之前打印启动器版本；
更新本体：npx 方式直接重跑 npx @deepseek-ai/dsh web 就是最新版；全局安装的跑 npm update -g @deepseek-ai/dsh；源码版在仓库目录 git pull 后重新构建；
更新单个插件：dsh plugin --profile web update 包名，预期：只更新该插件；不带包名才是更新 profile 里全部依赖；
更新完验证：打开 Web UI 能正常进会话、插件列表里目标插件版本已变，即完成。

完整的版本固定、回滚与失败兜底见《dsh 怎么更新？DeepSeek Harness 更新到最新版三种方式》。

卡住时按症状查 dsh 教程，不要重装本体

新手遇到的「用不了」几乎都不是本体坏了，按症状查对应环节最快。 下面按症状给出对应的教程入口（来源）。

启动就卡住、下载无进度 → 查《dsh 安装卡住不动怎么办》；
页面打不开、访问被拒 → 查《127.0.0.1:3080 打不开、访问被拒怎么办》；
模型连不上、密钥报错 → 查《DeepSeek Harness 模型连不上》；
插件装了不生效、加载失败 → 查《DeepSeek Harness 插件不加载怎么办》；
设置页没有插件市场入口 → 多半是 Hub 没装上或没生效，重装 dsh plugin --profile web add dsh-plugin 后重启 dsh web 再刷新。

数据都在 $DSH_HOME（默认 ~/.dsh）里，与安装方式无关——重装程序不会丢配置和会话，所以排查时不必急着卸载重来。

来源：deepseek-ai/deepseek-harness、DeepSeek Harness 官方文档 - Quickstart、dsh CLI README