DeepSeek Harness 插件市场点「安装」做了什么？插件安装的等价命令与落盘过程

在 DeepSeek Harness 插件市场点一下「安装」，后台执行的就是一条 dsh plugin --profile web add <包名>：包管理器取包、写进该 profile 的 node_modules、再更新 profile 的依赖声明（来源）。 界面没有自己的一套机制，它只是把命令的输入、过程与结果做成了按钮和进度条（这里的插件，中文也常写作 DSH插件、DeepSeek插件）。这篇讲清按钮与命令的对应、落盘结构，以及怎么手动复现同一步。

插件市场的安装按钮，对应哪条命令

安装按钮的等价命令就是 dsh plugin --profile <名字> add <包名或仓库>，--profile 取的是你当前这个界面所属的 profile（来源）。 一次点击拆开是三件事：

所以「确认弹窗里那条命令」不是装饰——它就是本次点击真正要执行的内容。想自己复现，抄它即可。

DSH plugin 落盘过程：文件到底写进了哪里

落点是当前 profile 的 node_modules，完整路径为 $DSH_HOME/profiles/<名字>/node_modules；$DSH_HOME 取不到时默认 ~/.dsh（来源）。 四步看清结构：

1. 看 profile 目录 — 执行 ls "$DSH_HOME/profiles/web"。预期：看到 package.json、配置文件与 node_modules 三样。
2. 看顶层目录 — 执行 ls "$DSH_HOME/profiles/web/node_modules"。预期：顶层目录名对应已装插件包名，且大多是符号链接。
3. 看真实文件 — 进入 node_modules/.pnpm。预期：包的真实内容按 <包名>@<版本> 分目录存放（来源）。
4. 看依赖声明 — 打开该 profile 的 package.json。预期：插件写在 dependencies 里，dsh.profile.bundles 列出要激活的组合包。

一个容易误判的点：dsh 内置的组合包（base / web / headless）不从 profile 目录解析，它们在 profile 的 node_modules 里缺席属正常现象，不代表安装失败。位置细节见《DSH plugin 装在哪个目录》。

怎么手动复现插件市场那一次 DSH plugin 安装

复现方式就是把界面做的事在终端做一遍：抄下弹窗里的命令，带上正确的 --profile 执行。 四步：

1. 先装好插件市场入口 — 执行 dsh plugin --profile web add dsh-plugin。预期：重启后设置页出现 DSH Plugin Hub 的插件市场。
2. 在市场上选一个插件，点安装 — 打开设置 → 插件市场，找目标插件点「安装」。预期：确认弹窗出现，里面显示插件名、来源与将要执行的命令。
3. 抄下命令到终端执行 — 把弹窗里的命令复制到终端运行，注意 --profile 与界面所属 profile 一致。预期：输出过程与界面进度一致，装完进已安装列表。
4. 两处校验 — 执行 dsh plugin --profile web list，再回插件市场已安装列表核对。预期：两处都能看到该插件，版本一致。

命令本身的参数与退出码，见《dsh plugin add 命令怎么用》。

插件市场把「取包 → 写入 → 登记」三步可视化，命令行则把同一套流程交给你直接调用，两者操作的是同一份数据。

理解 DSH plugin 安装机制的注意事项与局限

1. 界面不另立机制：插件市场的安装与命令行 add 是同一套实现，界面只是把过程与结果呈现出来。
2. profile 决定落点：同一个插件装进不同 profile 是两份独立记录，界面与命令行看不到对方那一份。
3. 符号链接不是快捷方式：顶层目录只是入口，改插件文件要认准 .pnpm 里的真实路径，否则会「改了不生效」。
4. 内置组合包例外：base / web / headless 从本体解析，不进 profile 目录，看不到它们是设计如此。
5. 装完要加载才生效：依赖已写入不等于已经激活，dsh.profile.bundles 与重启缺一不可。

机制清楚之后，按客户端选择入口更顺手，见《三个入口分别怎么安装插件》。DSH Plugin Hub 既是插件市场也是插件管理界面，已安装列表、更新检测与日志都收在里面。

来源：dsh CLI README（官方仓库）、打包与安装插件（官方文档）、pnpm 符号链接结构（官方文档）、dshplugin/dsh-plugin-hub