插件下载中心 · DSH Plugin Hub
左侧栏里的 GitHub 下载器：粘一个仓库地址就能选版本、下载 ZIP；常用插件摆成卡片，随手取用。
- 仓库：
- 下载：
- 版本发布：
- 许可：MIT
功能
- 左侧栏入口：和「插件」「自动化任务」同一组，点图标打开中央面板。
- 快速下载：粘贴
owner/repo或任意 GitHub 链接 → 解析仓库 → 选默认分支 / 其它分支 / 标签 → 下载 ZIP；顺手标出它是不是 DSH 插件（读仓库里的package.json）。 - 插件卡片：内置常用插件，也可自己加；每张卡片能选版本再下载、复制安装说明符、打开仓库。
- 一键安装：卡片和快速下载结果上都有「安装到 DSH」——先点一次确认，再点一次就装进当前 profile；显示计时与结果，过程中可取消。面板通过 Host 半边的同源路由
POST /plugin-hub/install调插件管理器的installBundle，装到$DSH_HOME/profiles/里，和插件页装的完全一致。 - 安装说明符：一键复制
github:owner/repo，粘到插件管理的安装框，或直接交给 Agent 执行install_bundle。 - 搜索过滤：按名称、仓库、描述即时筛选；自定义列表存在本机
localStorage（键dsh.plugin-hub.sources.v1），不会上传。 - 实时信息：星标、更新时间、默认分支、体积走 GitHub 公共 API；离线、限流或被 CSP 拦截时自动退回静态信息，下载链接照常可用。
安装
方式一：ZIP（推荐）
- 打开 ，点 Code → Download ZIP。
- 解压到任意目录。
- 在 DSH 里用插件管理器安装这个目录：
plugin_manager的install_bundle，target填解压目录的绝对路径。 - 刷新页面，左侧栏出现「插件下载中心」。
方式二：安装说明符
github:zx19491001/dsh-plugin-hub
粘到插件管理的安装框，或让 Agent 执行 install_bundle。
> 本机 git ls-remote github.com 要约 6 秒，而插件管理器探测默认 5000ms 就超时。本 profile 已把 githubConnectionTimeoutMs 调到 20000（在 cordis.patch.yml 里覆盖 plugin-manager 行），实测 github: 说明符可以直装（约 1–2 分钟，含拉取与校验）。换一台机器还是默认 5000 时，需要做同样的覆盖。
方式三：本地开发
本仓库就是插件目录。改完 client.js 后刷新 DSH 页面即可生效——本地安装是目录链接，不需要重新打包，也不需要重启。
使用
- 快速下载：顶部输入框粘地址 → 「解析」→ 选版本 → 「下载 ZIP」。文件由浏览器下载，落在系统下载目录。
- 卡片：「安装到 DSH」两步确认后直接安装；「下载 ZIP」按当前所选版本下载；「选版本」展开分支/标签下拉（首次展开才请求，省 API 次数）；「安装说明符」复制
github:owner/repo。 - 添加 / 移除：搜索框右侧「添加仓库」接受
owner/repo、GitHub 网页链接、git@github.com:owner/repo.git；自定义卡片右上角×移除。 - 刷新：右上角「刷新」重新拉取仓库信息。
结构
| 文件 | 作用 |
|---|---|
client.js |
唯一的 Web 实现：注册 sidebar.panellist（id plugin-hub）与 main（key plugin-hub），快速下载、卡片、版本选择、搜索都在这里。 |
index.js |
Host 半边，不注册任何东西。 |
cordis.patch.yml |
插入 plugin-hub 行。 |
locale/zh.json、locale/en.json |
插件管理页显示的标题与描述。 |
icon.svg |
插件图标（原创）。 |
test/client.test.mjs |
结构测试：清单、补丁、注册、链接、文案、图标。 |
test/wiring.test.mjs |
装载测试：用假 __ModuleLoader__ 与假 React 跑一遍 apply()，确认两个槽位和侧栏文案。 |
测试
npm test
无依赖，Node 22+ 直接运行；GitHub Actions 在 push / PR 时跑同一套测试。
已知限制
- 下载由浏览器接管：面板负责选版本和拼地址，文件进系统下载目录，拿不到保存路径回填。
- 列表是「内置种子 + 手动添加」，不做全站插件搜索。
- GitHub 未认证 API 每小时 60 次；超限或网络不可用时，星标与更新时间不显示，其余功能不受影响。
- 私有仓库对其他人不可下载：卡片会标出「私有」或「私有或不存在」。
- 安装说明符受 Git 探测超时影响：默认 5000ms 在本机会超时，本 profile 已调到 20000。
- 「安装到 DSH」走 Host 同源路由：只接受
github:owner/repo，要求回环 Host、同源 Origin 与x-plugin-hub头；Host 半边未加载时按钮会退化成提示。首次安装约 1–2 分钟（取包 + 校验 + 启用）。
许可
MIT
