DeepSeek Harness 插件市场里装 DSH plugin 装不上，第一步到底该先看哪里？

**在 DeepSeek Harness 插件市场装 DSH plugin 失败时，第一步是看终端或界面的最后几行输出停在哪一步**。DeepSeek Harness 插件安装分取包、解析依赖、写入并登记三个阶段：停在取包看镜像与网络，停在解析看依赖与构建脚本，写入后不生效则属于加载阶段——先定位阶段，再决定看哪篇专文。

装 DSH plugin 时，安装命令直接报错和装完不生效，是同一类问题吗？

**装 DSH plugin 时，命令直接报错与装完不生效不是同一类问题，判定方式也不同**。前者在安装阶段就中断，终端有明确报错码；后者命令成功退出、文件也写进了 profile，但插件没被加载。判断依据是 `dsh plugin --profile web list` 里有没有它，以及重启后功能是否出现。

DSH plugin 装完在插件市场里看不到，是安装失败了还是看错了地方？

**DSH plugin 装完在插件市场里看不到，先确认你看的是不是同一个 profile**。DSH plugin 按 profile 隔离，插件市场展示的是当前界面所属 profile 的已安装列表；命令行装到另一个 profile 时，界面里自然看不到。对齐 `--profile` 之后再判断是否真的安装失败。

装 DSH plugin 下载到一半就断了，这类失败该按什么顺序排查？

**装 DSH plugin 下载到一半就中断，按网络 → 镜像 → 代理的顺序排查**。先确认当前 registry 地址能否访问，再确认镜像是否同步滞后（表现为立刻报错），最后检查公司网络是否需要代理。三类症状表现相近但处理不同，详见插件下载慢与装到一半失败那篇。

装 DSH plugin 后提示构建脚本被拦截，这算失败还是正常？

**装 DSH plugin 后提示构建脚本被拦截，是被拦下而不是安装失败，但插件确实还没装好**。含原生依赖的 DSH plugin 在安装时会触发构建脚本，包管理器出于安全默认拦下并要求确认。这类提示有专门的处理方式，按它给出的包名放行后重装即可，不要直接忽略。

DeepSeek Harness 插件市场装不上、装完不生效？插件安装失败的排查总表与内链分流

DeepSeek Harness 插件市场里装 DSH plugin（中文也常写作 DSH插件、DeepSeek插件）失败，先按症状分三类：安装命令直接报错、下载卡住或中断、装完不加载不生效——每一类对应不同的判定命令与专文。这篇不重复单个报错的细节，只做「先定位阶段、再分流」的总表；确认失败属于哪一类之后，直接跳对应文章。

三步定位：先判断 DSH plugin 安装失败发生在哪个阶段

插件安装必经三个动作——取包、解析依赖、写入并登记；输出停在哪一步，就决定了该看哪篇专文。 三步定位：

看输出停在哪 — 停留在下载相关输出、报出明确错误码、还是命令成功但功能没出现。预期：能判断出是安装阶段还是加载阶段。
跑一次列表命令 — 执行 dsh plugin --profile web list。预期：列表里有它 = 安装成功，问题在加载；没有它 = 安装阶段失败。
对齐 profile — 确认界面所属 profile 与命令里的 --profile 是否一致。预期：两边一致后再下结论，避免把「看错 profile」误判成安装失败。

先装好 DSH Plugin Hub，插件市场与已安装列表都在它的设置页里。

DSH plugin 安装失败排查总表：症状、判定命令与分流

下表按症状组织，每行给出一条判定命令和一个去向，照着做即可（来源）。 对照使用：

症状	判定	去向
立刻失败、报 404 类错误码	`npm config get registry` 看当前源	《ERR_PNPM_FETCH_404 排查》
下载慢、装到一半中断	看输出停在取包还是编译	《插件下载慢、装一半失败》
依赖装不上、解析阶段报错	看报错是否含依赖包名	《插件依赖装不上》
提示构建脚本被拦截	看提示里的包名	《构建脚本被拦截》
pnpm 在 profile 目录失败	看是否指向 profiles 路径	《pnpm 在 profile 失败》
装完不加载、功能没出现	`list` 有、页面无	《插件装完不加载》
装完但一直未激活	看配置里是否启用	《插件未激活》
加载时报模块格式错误	看是否含 ESM 关键词	《插件构建与 ESM》
插件树整体加载失败	看是否提示树加载	《插件树加载失败》

表里每一篇都只处理一个具体错因，先定位再跳转，不要同时怀疑三四个方向。

按阶段给 DSH plugin 安装失败的判定命令

三类失败各有几条最省事的判定命令，先跑命令再看结论。 分阶段列出：

安装阶段：确认目标与落点 — 执行 dsh plugin --profile web list 与 ls "$DSH_HOME/profiles"。预期：列表里没有该插件、且 profile 名字与你预期一致，说明是安装阶段失败。
下载阶段：确认源与网络 — 执行 npm config get registry。预期：源地址可达；慢与 404 的区分标准见《插件下载慢、装一半失败》。
写入阶段：确认文件是否到位 — 查看 $DSH_HOME/profiles/web/node_modules。预期：顶层目录名对应插件包名；结构细节见《DSH plugin 装在哪个目录》。
加载阶段：确认是否被激活 — 看 profile 的 package.json 与运行日志。预期：依赖在里面但功能没出现，就是加载或激活环节的问题，按上表分流。

DSH Plugin Hub 系统日志：安装、卸载与诊断的操作轨迹都记在这里，排查时按级别筛

DSH plugin 装完不生效：这一类怎么单独判断

「装不上」和「装完不生效」是两回事，后者命令成功、文件到位，只是没被加载。 三步：

确认已安装列表里有它 — 打开设置 → 插件市场 → 已安装，再跑一次 list。预期：两边都有，说明安装本身成功。
确认是否需要重启 — 插件依赖在重启后按加载声明生效。预期：重启后功能出现即正常，见《插件装完不加载》。
确认是否被禁用或未激活 — 查看该插件的启用状态。预期：启用后生效，细节见《插件未激活》。

插件市场的已安装列表是界面侧判据，list 是命令侧判据，两者一致才算安装成功，剩下的才归到加载问题。

用 DSH plugin 安装失败排查总表的注意事项与局限

先定位阶段再选文章：三类失败的判定命令不同，跳错文章只会多绕一圈。
对齐 profile 再看结论：界面与命令看不同 profile 时，「看不到」不等于「没装上」。
一篇只解一个错因：各专文按具体报错拆分，本篇不重复它们的细节，遇到具体错因请按表跳转。
报错原文优先：专文的标题多为报错原文，能直接对上时优先按标题匹配，比按症状猜更准。
前置检查能省一半排查：环境类失败多半能在动手前避免，见《装插件前的前置清单》。

大部分安装失败都能在这张表里找到去向。DSH Plugin Hub 既是插件市场也是管理界面，已安装列表、日志与诊断收在一处，是定位问题最快的地方。

来源：dsh CLI README（官方仓库）、dshbase 常见问题排错、dshplugin/dsh-plugin-hub