装 DSH plugin 之前要检查什么？有没有一份清单？

**装 DSH plugin 前有五项必须过：dsh 可运行、profile 已存在、包管理器可用、registry 可达、$DSH_HOME 可写。** DeepSeek Harness 的插件安装是往 profile 目录写文件并解析依赖，这五项任何一项不满足都会在安装阶段失败，提前一分钟检查能省掉后面反复排查。

插件市场里点安装报「找不到 profile」，是插件的问题吗？

**插件市场里报「找不到 profile」不是 DSH plugin 的问题，是目标 profile 还没被创建**。插件按 profile 隔离存放，安装前该 profile 必须先存在；网页版先用 `dsh web` 跑一次让它初始化，桌面端要先启动一次应用，之后再装插件就不会报 profile 不存在。

装 DSH plugin 一定需要自己先装 Node 和 pnpm 吗？

**装 DSH plugin 由 dsh 自己调用包管理器完成，不需要你手动敲 pnpm。** 但本机必须有一个能跑起来的 dsh：走 npx 或全局安装时 Node 由它带来，走源码构建路径则要自己准备 pnpm 并先完成构建。用桌面端时它自带运行时，无需额外装 Node。

装 DSH plugin 失败，怎么确认是网络问题而不是目录权限问题？

**装 DSH plugin 失败时分两步证伪：先看 registry 可达性，再看目录可写性。** 执行 `npm config get registry` 确认源地址，必要时换官方源重试；若报错词是 EACCES 或权限拒绝，则是 `$DSH_HOME` 不可写——多为历史上有过 sudo 安装导致目录属主变了，改回属主即可。

磁盘空间不够会导致 DSH plugin 安装失败吗，怎么提前确认？

**磁盘空间不够会导致 DSH plugin 安装失败，而且报错往往不直白。** DeepSeek Harness 的插件依赖会落进 profile 的 node_modules，pnpm 还有全局 store，两者都占空间；磁盘写满时安装可能中途失败或留下半个包。装插件前用 `df -h` 看一眼数据盘剩余空间，比事后排查省事。

DeepSeek Harness 插件市场装插件前要检查什么？版本、profile 与网络的前置清单

装 DSH plugin（中文也常写作 DSH插件、DeepSeek插件）之前要过五项检查：dsh 能不能跑、目标 profile 在不在、包管理器可不可用、registry 通不通、$DSH_HOME 可不可写。这五项对应安装过程中必然发生的三个动作——解析依赖、写入 profile 目录、登记依赖声明，任何一项不满足都会在安装阶段暴露成报错。这篇是动手之前的清单；如果你已经卡在安装中，去读《插件装卡住怎么办》。

检查一：dsh 可运行，且是能管 DSH plugin 的那个 dsh

插件安装命令由 dsh 提供，第一步先确认它确实能跑起来（来源）。 两步：

看版本 — 执行 dsh --version。预期：输出版本号；报「不是内部或外部命令」说明命令没进 PATH，见《dsh 命令找不到》。
确认它从哪来 — 桌面端内置的 dsh 与 npm 安装的 dsh 是同一套实现，但桌面端会独占 desktop profile。预期：清楚自己用的是哪一个，避免用桌面端的运行时装到错误的 profile，细节见《桌面端命令》。

检查二：目标 profile 已经存在，DSH plugin 才有落点

DSH plugin 按 profile 隔离，装之前那个 profile 必须已经创建出来（来源）。 两步：

列出已有 profile — 执行 echo $DSH_HOME 再 ls "$DSH_HOME/profiles"。预期：能看到 web、headless 或你自建的名字；什么都没有说明本体还没跑过一次。
按需先初始化 — 网页版先跑一次 dsh web，桌面端先启动一次应用。预期：对应 profile 目录出现 package.json 与 node_modules，之后的安装才有落点。

检查三：装 DSH plugin 的包管理器与网络就绪

插件安装由 dsh 调用包管理器完成，你不用手动敲 pnpm，但要保证这台机器具备解析依赖的条件。 三步：

看 Node 是否可用 — 执行 node -v。预期：输出版本号；走 npx 或全局安装路径时 Node 由那条路径带来，不需要额外准备。
源码构建路径才需要 pnpm — 执行 pnpm -v。预期：只有你走的是源码构建安装时才必须，缺了就先按本体安装文补齐。
确认 registry 可达 — 执行 npm config get registry。预期：输出一个可访问的源地址；下载慢或报 404 的处理见《插件下载慢、装一半失败》。

DSH Plugin Hub 设置页：npm 镜像源与代理地址在这里配，装插件前先核对网络条件

检查四：DSH plugin 的目录权限与磁盘空间

插件最终写进 $DSH_HOME/profiles/<名字>，所以这个目录必须对当前用户可写，磁盘也要留得下（来源）。 两步：

确认目录属主是你自己 — 查看 $DSH_HOME 的属主。预期：属主是当前用户；若历史上用 sudo 装过，目录会变成 root 所有，之后安装必然报权限错误，改回属主即可。
看数据盘剩余空间 — 执行 df -h。预期：数据盘有充足余量；插件依赖会同时占 profile 的 node_modules 与 pnpm 全局 store，空间不足时安装可能中途失败。

检查五：装之前先把插件市场入口准备好

前置条件都过了之后，第一件事是确保插件市场可用——它是后续找插件、装插件与复查的主界面。 两步：

装好 DSH Plugin Hub — 执行 dsh plugin --profile web add dsh-plugin。预期：装完重启 dsh web，设置页出现「插件市场」入口。
确认入口能打开 — 打开设置 → 插件市场。预期：能看到插件卡片列表；有入口但列表空，多半是网络或目录接口没通，回到检查三。

插件市场既是安装入口也是复查界面，前置检查过完之后顺手把它装上，后面找插件就不必回命令行。用法见《用插件市场装插件》。

装 DSH plugin 前置检查的注意事项与局限

检查的是环境，不是插件：五项全部指向本机条件，任何一项不过都别急着怀疑插件本身。
profile 必须存在：这是「装好了却看不到」最常见的原因，网页版与桌面端各自先初始化一次。
不要用 sudo 兜权限：目录属主写坏之后，后续每次安装都会报权限错误，先修属主再装。
网络问题分两类：慢与 404 是源的问题，超时与认证失败是链路的问题，分类处理更快。
装完仍要校验：前置检查保证「能装」，装没装到位还要用 list 与插件市场已安装列表两处确认。

前置条件备齐之后，按平台差异安装插件即可，见《插件按操作系统安装》。DSH Plugin Hub 是插件市场兼管理界面，已安装列表与更新检测都在里面。

来源：dsh CLI README（官方仓库）、DeepSeek Harness README（官方仓库）、dshplugin/dsh-plugin-hub