前言¶
在 DSH 的插件化思路下，社区插件通常分散在不同仓库。dsh-plugin-index 提供的是一个社区插件索引：按 GitHub 星标浏览带 dsh-plugin topic 的仓库，并在 web profile 中完成安装、更新、修复、卸载。它解决的是“从哪找、怎么装、后续怎么维护”的问题。
这是什么¶
dsh-plugin-index 由 GGigHub 维护，许可证为 MIT。它面向 DSH web profile，把带 dsh-plugin topic 的 GitHub 仓库整理成可浏览的市场列表，并提供插件生命周期操作。
核心功能¶
- 按 GitHub 星标降序浏览带
dsh-plugintopic 的仓库。 - 在
web profile中安装、更新、修复、卸载插件。 - 市场与已安装插件按功能打多标签分类。
- 在已加载目录上按仓库名、描述、
spec、分类做本地过滤搜索。 - 点击分类芯片可查看含该标签的列表。
- 刷新会重新请求 GitHub，绕过 15 分钟缓存。
- 安装队列串行执行，可查看状态、耗时与日志。
- 对“未入 bundles”或已知需装子目录的插件，提供安装说明 / 复制安装命令。
安装与启用¶
安装命令如下：
dsh plugin --profile web add github:GGigHub/dsh-plugin-index
安装后重启 DSH，打开左侧栏「插件」。
卸载本包：
dsh plugin --profile web remove @dsh-external/dsh-plugin-index
然后重启 DSH。
仓库已带构建好的 lib/，安装不需要 prepare 或 pnpm allowBuilds。
典型用法¶
- 首屏会先返回第 1 页或本地缓存，后台补全后自动更新。
- 在列表中按星标浏览；点击分类芯片，查看含该标签的插件。
- 输入关键词后，只在已加载目录上做本地过滤，搜索范围包括仓库名、描述、
spec、分类；清空输入回到全量列表。 - 点击刷新时重新请求 GitHub，绕过 15 分钟缓存；搜索关键词不参与服务端过滤。
- 点击安装前会看到“未审计”风险确认。安装进入队列串行执行，可查看状态、耗时与日志。
- 装、更、修、卸成功后都要重启 DSH。
适用场景与注意¶
适合在 DSH web profile 中查找社区插件，并希望用统一入口做安装、更新、修复、卸载的使用者。
使用前注意：
- 本项目只作只读分发，不接受 Pull Request 与 Issue。
- 社区仓库索引中的插件均未检查木马、病毒或恶意代码，点击安装前有“未审计”风险确认。
- 一键安装不会替用户做安全审计；建议先
clone仓库、审查源码，再决定是否安装。 - 插件以当前
dsh进程权限运行，安装前应检查源码与许可证。 - 市场安装只接受
github:owner/repo，安装的是仓库根目录；已知需装子目录的仓库会禁用市场「安装」，需走手动流程。 - 当插件显示“未入 bundles”或已知需装子目录时，可使用安装说明 / 复制安装命令。
支持的环境变量：
GITHUB_TOKEN / GH_TOKEN
DSH_HTTPS_PROXY / DSH_HTTP_PROXY
DSH_HOME
DSH_PROFILE
DSH_CHECKOUT
结尾¶
dsh-plugin-index 把社区插件的查找和生命周期管理放进 DSH 的 web profile：从 GitHub dsh-plugin topic 浏览，到安装、更新、修复、卸载。仓库地址：
- https://github.com/GGigHub/dsh-plugin-index
目录页 URL 未在已核实资料中给出，本文不提供；安装后从左侧栏「插件」进入。
