dsh-plugin-shop

dsh-plugin-shop 0.9.0 提供 DSH Web 插件商店，浏览目录、安装更新和启停当前 Profile 插件，并可触发宿主重启；这些操作会修改本机依赖与配置。

• DSH 版本组合（必需）：Node.js ^22.19.0 或 >=24；未声明 engines.dsh，三个 DSH peer 均为 >=0.1.1-rc.2 <0.3.0-0，按宿主含预发行版本的规则接受 0.2.1-rc.5。本页固定该宿主示例，只做源码与 npm 发行包静态复核，未运行验证；版本门禁通过不保证热挂载、RPC 或重启成功。
• 独立测试 Profile 与停机备份（必需）：命令使用 web Profile；使用单独 DSH_HOME 的测试实例，停机备份 profiles/web 的 package.json、pnpm-lock.yaml、cordis.patch.yml 和现有 bundle 配置，保留安装前 --dump-config。
• 网络与来源审核（必需）：确认允许访问 registry.npmjs.org、registry.npmmirror.com 和作者 GitHub Pages；目录中每款插件须单独审核，商店收录不代表允许安装。

本页命令固定使用 DSH 0.2.1-rc.5，与 npm 默认版本分别维护。切换 DSH 前核对本插件的兼容记录；新版 Session API 与格式变化见0.1.3-alpha.1 升级说明。源码审阅不等于运行验证。

下面的命令使用本站核验的 DSH 基线，并锁定插件版本或 Git commit，避免默认分支变化导致安装内容漂移。本站已核对安装目标，但尚未在你的系统和 Profile 中实际执行。

安装到

web Profile

DSH 基线

0.2.1-rc.5

安装来源

npm 预构建包（锁定版本）

固定目标

[email protected]

Node.js ^22.19.0 或 >=24；未声明 engines.dsh，三个 DSH peer 均为 >=0.1.1-rc.2 <0.3.0-0，按宿主含预发行版本的规则接受 0.2.1-rc.5。本页固定该宿主示例，只做源码与 npm 发行包静态复核，未运行验证；版本门禁通过不保证热挂载、RPC 或重启成功。

• DSH 版本组合来源 1 ↗（外部链接，在新标签页打开）
• DSH 版本组合来源 2 ↗（外部链接，在新标签页打开）
• DSH 版本组合来源 3 ↗（外部链接，在新标签页打开）

本目标是已发布的 npm 0.9.0，不安装仓库根目录或自行构建源码。第三方依赖若要求执行额外脚本，先暂停并单独审核，勿全局放行。

1. 01
   检查 Node.js 与 pnpm

   DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上，并且 pnpm 必须已在 PATH 中。先运行：

   环境检查复制命令

   node --version && pnpm --version

2. 02
   安装到 Web Profile

   这条命令会把插件加入 web Profile，并在插件声明 DSH Bundle 时自动加入配置层。

   npm 预构建包（锁定版本）复制命令

   npx --yes @deepseek-ai/[email protected] plugin --profile web add [email protected]

3. 03
   确认 Bundle 已进入配置

   先完成上方安装说明要求的准备或配置，再导出组合配置，不启动 Agent。输出中应能找到包名 dsh-plugin-shop或对应 Bundle 层。

   检查配置复制命令

   npx --yes @deepseek-ai/[email protected] --profile web --dump-config

4. 04
   启动并完成最小验证

   启动 Web Profile 后，只测试一个与插件功能直接相关的最小任务，并检查日志、文件、网络和凭据访问是否符合预期。

   启动 DSH Web复制命令

   npx --yes @deepseek-ai/[email protected] web

npx --yes @deepseek-ai/[email protected] plugin --profile web remove dsh-plugin-shop

$DSH_HOME/profiles/web/cordis.patch.yml

只覆盖已有 id: shop 条目的 config；不要重复 insert。catalogUrl 设置目录来源，cacheDir 默认 $DSH_HOME/shop。

$DSH_HOME/shop

目录缓存、Git repo pins 和 restart.log；重启日志不等于启动成功。安装与启停另写 Profile 依赖、锁文件和用户覆盖层。

- id: shop
  config:
    catalogUrl: https://LivXue.github.io/dsh-plugin-shop/v1/

1. 停机安装固定 npm 0.9.0，重启测试 DSH Web，再在主侧栏寻找 Shop/商店入口；不要安装仓库根目录。
2. 首次只浏览目录和已安装清单，核对 Profile、目标来源和版本，不点击安装、更新、启停或重启。
3. 需要实际变更时，先审核目标插件和备份，再逐项执行；源码没有可依赖的全局只读开关。

1. 01
   在测试实例确认 bundle 加载

   复制验证命令复制命令

   npx --yes @deepseek-ai/[email protected] --profile web --dump-config

   期望结果：组合配置只有一个 id: shop 条目，name 为 dsh-plugin-shop；无重复条目或缺模块错误。

2. 02
   启动测试 Web 并只读浏览一个已有插件

   复制验证命令复制命令

   npx --yes @deepseek-ai/[email protected] web

   期望结果：Shop 能显示当前 Profile 和目录来源，浏览后 Profile 的依赖及 cordis.patch.yml 无意外修改；目录缓存写入是预期行为。

3. 03
   核对失效目录的提示与回退边界

   期望结果：网络故障可能使用缓存并标记 stale；schema/hash 校验失败应排障，不通过绕过校验安装。此项需站长后续授权实际故障验证，本次没有执行。

• 先搜索一个已知插件，对照包名、source、repo/subdir、固定版本及权限，不进行安装；verified 只是该商店的目录分级。

经 shop Remote 暴露目录和管理操作，依赖宿主远程访问控制；读取当前 Profile 及插件清单、npm registry 配置，调用宿主插件管理服务或启动同一 DSH CLI 安装/更新/卸载，修改 package.json、锁文件、bundle 选择和 cordis.patch.yml；联网下载目录与包，并可启动重启辅助进程。

数据存储：目录缓存与 repo pins 默认保存在 $DSH_HOME/shop；Profile 依赖、锁文件和 cordis.patch.yml 可被修改。安装的插件可能再写自己的数据，卸载商店不会自动移除它们。

请注意：“源码已审阅”说明本站检查到的证据范围，不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。

安装目标不存在或版本不一致

确认 npm [email protected]，对照固定发行标签的 packages/dsh-plugin-shop；目录不含目标、deny、版本或重名冲突应停止，不改成 latest。

重启被拒绝或重启后失联

检查 Desktop/default Profile/Windows/systemd/--port 0 闸门及 restart.log；由原运维入口恢复。allowRestart:false 不是全局重启禁用，不能据此认为其他入口已被封禁。

安装完成但功能没更新，或启停只完成一部分

模块缓存、客户端加载和多条目切换可能需要停机重启；先检查依赖、锁文件、配置差异和加载错误，必要时恢复整套备份，勿反复点击更新。