dsh-webui-market-plugin
English | 中文
在 dsh web GUI 内部的社区插件市场：浏览 awesome-dsh-plugin.com 的插件目录，直接在 设置 → 插件 → 插件市场 里安装 / 卸载插件到 profile。界面风格与 harness 前端一致（跟随系统深浅色主题），支持中英文（按系统语言自动切换）。
推荐 awesome-dsh-plugin.com 网站的实现 dsh-market。
效果展示
插件市场效果
安装
方式一：从 npm registry 安装（推荐，无 git 克隆 / prepare 脚本步骤）：
dsh plugin --profile web add @sanqi-normal/dsh-webui-market-plugin
方式二：从 GitHub 源码安装：
dsh plugin --profile web add github:Sanqi-normal/dsh-webui-market-plugin
安装后重启 web 服务生效：
pnpm dsh web
GitHub 源安装会执行包内 prepare 脚本，如被 pnpm 拦截，把提示的包名加入 profile 的 pnpm-workspace.yaml 的 allowBuilds 后重试。
pnpm 11 起，依赖树中"构建脚本未在 allowBuilds 中显式放行或拒绝"的包会直接导致 ERR_PNPM_IGNORED_BUILDS。若该包在当前 profile 不需要执行构建脚本，可把对应项写成 false（明确拒绝）而不是 true（放行执行）；市场插件的试装验证会继承真实 web profile 的 pnpm-workspace.yaml，因此这里的 true/false 决策也会作用于试装环境。
宿主依赖说明
本插件是 DSH web profile 内运行的插件，不是独立 npm 应用。以下 peer 依赖由 DSH 宿主环境提供，用户无需手动安装：
@deepseek-ai/cordis@deepseek-ai/dsh-client-runtime@deepseek-ai/dsh-client-ui-slots
当前版本面向 DSH 0.0.1-rc.2+（不含已知解析问题的 0.0.1-rc.1）及 0.1.0-rc.2+ 环境。若使用纯 npm registry 工具解析本包，可能因为 DSH 上游部分 host 包未发布而提示依赖图不完整，这属于 DSH 宿主依赖的发布问题。
使用
打开 设置（Settings）→ 插件（Plugins）→ 插件市场（Plugin Market）：
- 目录按分类分组，支持搜索与"已安装"过滤；每个卡片显示 GitHub Star 数（无数据不显示），可一键按 最热（Star 降序，无 Star 的排最后）/ 最新（收录日期） 排序，或恢复官网默认顺序；大目录分批渐进渲染，避免打开瞬间一次性插入数百卡片造成卡顿
- 点 详情 查看该插件的官方安装命令（含目标 profile）
- 跨 Profile 安装 / 一键同步（desktop 等）：官网目录只发布
--profile web 命令，而桌面端（desktop shell）启动的是自己独立的 profile（如 desktop），市场装进 web 的插件桌面应用不会自动加载。面板顶部有 安装设置（含说明）与 跨 Profile 同步 区，自动列出本机已初始化的 profile：
- 默认「有什么装什么」：
安装设置 里的「自动同步到其它 profile」默认开启——安装插件时自动装到本机所有已初始化的 profile（有 web 装 web，有 desktop 也装 desktop；在确认框直接选了 desktop 的也会自动补装到 web）；关闭后仅装到安装时选择的 profile
- 安装确认框可选目标 profile（默认 web）；跨 Profile 同步 区把 web 里已装的插件一键补装到目标 profile（只新增缺失项）
- 同步是本地复制：源已在源 profile 安装过（syncFrom 校验），所以不再受目录白名单限制——装在 web 但不在精选目录的插件（如 aegis）也能同步；每个补装任务照常做安装前快照 + FIFO 队列，装完后重启对应应用生效
- 安装 / 更新 / 卸载 组成 FIFO 任务队列：多个插件可以连续排队提交，任务面板固定在右下角、不随页面滚动隐藏，实时显示「排队中 / 校验中 / 执行中 / 完成 / 失败 / 已终止 / 超时」，可取消排队项、终止执行项、查看每个任务的 pnpm 日志；每个任务默认超过 120 秒自动超时（可用环境变量
DSH_MARKET_OP_TIMEOUT_MS 调大，如 300000）；遇到 pnpm 的临时网络错误（GET ... error / ETIMEDOUT / ECONNRESET 等）会自动重试一次，持续失败时给出代理/镜像排查提示；一键更新全部会把所有可更新插件依次加入队列；队列头部「清空」可一键清除全部已完成/失败记录（逐条清除也支持），清除会同步到服务端，刷新或重新打开面板后不会再次出现
- 失败后询问 DSH：安装 / 更新 / 卸载失败（含超时、已终止、已拒绝）后，失败弹窗和任务队列的失败行会出现 询问 DSH 按钮；点击后前端会新建一个对话，并把操作目标、状态、环境信息和完整错误日志作为 prompt 自动发送给 AI，方便直接排查或解释状况
- pnpm ≥11 默认开启 24 小时 minimumReleaseAge 供应链策略：依赖里刚发布（24 小时内）的包会让所有安装/更新/卸载被 pnpm 拦截。遇到 ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION 时市场会自动把违规的 name@version 合并进 profile 的 pnpm-workspace.yaml 的 minimumReleaseAgeExclude（同名多版本写成 name@v1||v2 联合，避免 pnpm 只认首条同名规则）并自动重试一次，无需手动改配置
- 停用 / 启用：停用保留依赖与磁盘文件，只把插件移出激活的 bundle 层（重启后仍保持停用）；启用按原顺序恢复，免删装；卡片操作区横向排列在卡片底部，避免右侧按钮拥挤
- 本机插件：列出所有由依赖管理的插件（含在市场之外安装的、以及未进 bundle 层的 client-only/普通依赖），标注目录内/目录外、已停用、来源类型，可直接停用、启用或卸载（内置 bundle 与本地 link/file 源不会提供删除）
- 每个插件卡片显示真实的已安装状态（与 profile 的
package.json 同步）：安装状态按「作者 + 仓库」（owner/repo）识别，目录里有同名插件（如两个作者的 dsh-memory）时，装了哪个作者就只显示哪个已安装，不会误标另一位作者的卡片；「本机插件」列表也会显示解析出的 owner/repo 身份
- 顶部显示插件目录来源官网链接，可直接打开
工作原理
持久化 bundle（package.json 的 dsh.bundle.patch → cordis.patch.yml），由 dsh plugin add 的 reconcile 自动加入 profile 的 dsh.profile.bundles 层：
- Host 半（
lib/host.js）：注册 /api/dsh-market 路由，提供 list（读取官网 JSON API plugins.json，失败回退内置离线快照，含 stars/added；与官方 dsh-market 一致：先试官网 JSON，再用过期缓存，最后落离线快照，不解析官网 HTML）、probe（环境探测，含本机已初始化 profile 列表）、installed / installedAll（读取 profile package.json 与已装包 manifest）、syncPlan（跨 profile 只读差异：web 已装、目标 profile 缺失的插件清单）、install / update / updateAll / uninstall（FIFO 队列 + 后台 spawn dsh plugin CLI，白名单在队列头对所有 profile 执行、试装验证仅对 web 执行）、disable / enable（停用/启用并持久化到 dsh.market.disabled）、op（队列快照）、kill（终止/取消任务）
- Client 半（
lib/client.js）：通过 exports["./client"] + dsh.client 声明被 web 前端加载，注册到 settings.plugins.tab 槽位
安全与限制
- 来源白名单：安装只接受精选目录（awesome-dsh-plugin.com curated registry）收录的
github: 源，目录外的一律拒绝，与 dsh-market 的白名单策略一致（目录抓取失败或 registry/link 源不做此限制）；该白名单对所有目标 profile（含 desktop 同步）生效，勾选"跳过安全检查"才可绕过
- npm 优先（官方同款镜像策略）：目录条目带
npm 映射时，优先用 npm 包名安装/更新（npm tarball 走 CDN/镜像，不依赖 GitHub 下载）；只有未发布 npm 的 GitHub-only 插件才走 GitHub 源。用户可在 npm/pnpm 配置中设置国内 registry 镜像（如 registry=https://registry.npmmirror.com），npm 源的安装/更新会自动走该镜像
- 试装验证（trial boot）：白名单通过后，若插件未声明 web client 半端（
dsh.client.platform === 'web'），会先做试装验证：在临时 DSH_HOME 里按 web profile 模板重建组合，用同一套 dsh plugin add 装入候选插件，再以 --port 0（系统空闲端口）实际启动一次，只有出现 dsh web: 就绪行（Loader 树成功结算后才打印）才判定可装。验证失败会给出真实的启动错误（如重复 api-gateway / webserver 等）并拒绝安装，此时真实 profile 从未被写入、试装目录自动清理，无需任何回退操作。试装验证仅对 web profile 执行：非 web profile（如 desktop）的组合由对应桌面壳定义、市场无法在临时环境复刻，其安装由「来源白名单 + 安装前快照」把关（同样无破坏性，只是没有启动判定）。试装环境会继承真实 web profile 的 pnpm-workspace.yaml（allowBuilds / minimumReleaseAgeExclude），因此已在真实 profile 中显式拒绝（false）的构建脚本不会在试装时被重新放行或执行。
- 跨 profile 同步只增不删：
syncPlan 只计算「web 已装、目标缺失」的插件，且要求目标 profile 已初始化（避免误建空 profile）；同步仅补装、绝不删除或降级目标 profile 里已有的任何内容。同步安装携带 syncFrom 来源校验：仅当目标源确为源 profile 已装依赖时才放行（本地复制，不视为新的远端信任决策），未通过校验的仍走目录白名单；装到 desktop 等 profile 后需重启对应应用生效
- 同源校验：
install / uninstall / update / kill 写操作只接受同源 POST（Origin 头与 Host 一致），跨源请求一律 403
- 热挂载（免重启）：安装成功后，若新插件的
cordis.patch.yml 是纯 id/name 插入行，会尝试挂入运行中的组合并自动刷新页面生效（无需手动操作）；patch 复杂或环境不支持时回退"重启生效"。热挂载输入存于 <profile>/.dsh-market/，每次启动自动清理；热挂载、热卸载与 Loader 停用/启用只作用于运行中的 web profile，desktop 等其它 profile 的操作不会触碰 web 的运行态
- 更新检测与更新：已安装插件卡片自动显示"更新"按钮（github 源对比 lockfile 锁定 commit 与 GitHub HEAD；registry 源对比 npm latest 与已装版本；本地 link/file 源不检测），点击即重新解析最新版本并作为后台任务执行，完成后下次重启生效；检测失败静默降级为"无更新"，不会阻塞列表。github 源更新时会把检测到的 HEAD commit 写成
github:owner/repo#<sha> 再执行，避免 pnpm 走 git ls-remote（SSH）解析 HEAD 时因未配置 SSH key 报 Permission denied (publickey)
- 离线目录快照：
data/catalog-snapshot.json 作为官网抓取失败时的离线兜底，可用 pnpm run snapshot 从官网 JSON API 直接抓取刷新（不走回退链，官网不可达时会失败而非复制旧数据）
