概览
@sanqi-normal/dsh-webui-market-plugin
社区 · Topic 自动分析 — 通过 GitHub dsh-plugin Topic 自动发现。静态检查在不执行第三方代码的前提下，验证了固定公开版本的根目录 bundle 契约与已提交文件；这不等于人工审核、安全审计、运行时冒烟测试、发布者身份验证或官方背书。
从 GitHub 安装此组合包
CLI 会验证组合包、调用原生 DSH 安装，成功后才上报完成。
npx dshpub add Sanqi-normal/dsh-webui-market-plugin --ref b719e716d4f68afc823d6ef6b825281ee597aa88能力
它贡献了什么
README / ZH
插件文档
在 dsh web GUI 内部的社区插件市场：浏览 awesome-dsh-plugin.com 的插件目录，直接在 设置 → 插件 → 插件市场 里安装 / 卸载插件到 profile。界面风格与 harness 前端一致（跟随系统深浅色主题），支持中英文（按系统语言自动切换）。
LIMITATIONS
已知限制
- **来源白名单**：安装只接受精选目录（awesome-dsh-plugin.com curated registry）收录的 `github:` 源，目录外的一律拒绝，与 [dsh-market](https://github.com/dsh-market/dsh-market) 的白名单策略一致（目录抓取失败或 registry/link 源不做此限制） - **试装验证（trial boot）**：白名单通过后，若插件未声明 web client 半端（`dsh.client.platform === 'web'`），会先做**试装验证**：在临时 DSH_HOME 里按 web profile 模板重建组合，用同一套 `dsh plugin add` 装入候选插件，再以 `--port 0`（系统空闲端口）实际启动一次，只有出现 `dsh web:` 就绪行（Loader 树成功结算后才打印）才判定可装。验证失败会给出**真实的启动错误**（如重复 api-gateway / webserver 等）并拒绝安装，此时真实 profile 从未被写入、试装目录自动清理，无需任何回退操作 - **同源校验**：`install` / `uninstall` / `update` / `kill` 写操作只接受同源 POST（Origin 头与 Host 一致），跨源请求一律 403 - **热挂载（免重启）**：安装成功后，若新插件的 `cordis.patch.yml` 是纯 `id`/`name` 插入行，会尝试挂入运行中的组合并**自动刷新页面生效**（无需手动操作）；patch 复杂或环境不支持时回退"重启生效"。热挂载输入存于 `<profile>/.dsh-market/`，每次启动自动清理 - **更新检测与更新**：已安装插件卡片自动显示"更新"按钮（github 源对比 lockfile 锁定 commit 与 GitHub HEAD；registry 源对比 npm latest 与已装版本；本地 link/file 源不检测），点击即重新解析最新版本并作为后台任务执行，完成后下次重启生效；检测失败静默降级为"无更新"，不会阻塞列表 - **离线目录快照**：`data/catalog-snapshot.json` 作为官网抓取失败时的离线兜底，可用 `pnpm run snapshot` 刷新 - **安装前自动快照**：写入真实 profile 前会把 `package.json` 备份为同目录 `.mkts-snapshot-<时间戳>.json`，配合 `dsh plugin --profile web remove <包名>` 可手工回退 - **CI=true**：pnpm 子进程以 CI 模式运行，避免无 TTY 时静默卡在交互提示 - 安装 / 卸载后需重启 web 服务生效（热挂载成功的除外，本插件不做自动重启） - 目录数据来自官网静态页解析，官网无 JSON API；插件数量与分类以官网为准