DSH 是一个插件驱动的环境。当安装了大量插件后,在「插件」页面逐个查找变得低效。dsh-plugin-search 通过在插件页注入搜索条,支持按名称、描述或包名过滤,解决了插件列表繁多时的筛选困难问题。
插件信息¶
- 名称: dsh-plugin-search
- 核心功能: 给 DSH「插件」页加上关键词搜索
- 作者: huangxp12
- 分类: 客户端
- Star 数: 1
- 开源协议: MIT
核心能力¶
- 注入搜索条: 在插件页(侧栏「插件」)注入一条搜索框,边输入边过滤卡片。
- 多维度过滤: 匹配范围包括卡片上的可见文字(标题、描述、标签)以及
data-plugin-package/data-plugin-item中的包名或注册 ID。 - 匹配规则: 支持大小写不敏感的子串匹配;多个关键词之间为 AND 逻辑(例如输入
task 看板,需要同时命中)。 - 智能分组: 当某个分组下没有任何卡片命中时,整组隐藏(包括组标题和计数)。
- 计数显示: 搜索条右侧显示
命中 / 总数;无匹配时显示提示文案。 - 快捷操作: 支持使用右侧的 × 或
Esc键清空搜索词。 - 语言跟随: 自动跟随 DSH 界面语言(中文/英文)。
- 运行机制: 只读 DOM 状态,不修改任何数据或会话。
安装与启用¶
使用官方命令安装:
dsh plugin --profile web add github:huangxp12/dsh-plugin-search
--profile是必需项,通常web为标准 Web profile。- 安装后刷新页面即可生效(前端插件无需重启)。
典型用法¶
装了很多插件时,在搜索框输入关键词(如「看板」),页面会实时过滤卡片。官方组与已安装组会分别显示命中的卡片,并在搜索条右侧显示命中数量。
注意事项¶
- 运行范围: 插件仅操作 DOM 状态,不进行任何网络请求,也不读也不写会话日志。
- 权限范围: 不修改 Loader 的启用状态或装卸插件,不修改插件的配置。
- 空状态: 搜索词为空时,页面状态与未安装时一致。
- 手动安装: 若使用自定义 profile(如
desktop),需手动将包放入 profile 的node_modules,并在cordis.patch.yml中追加配置项id: plugin-search。
总结¶
dsh-plugin-search 是一个轻量级的客户端插件,旨在优化 DSH 插件列表的查看体验。它不改变底层逻辑,仅通过前端过滤提升检索效率。
- GitHub: https://github.com/huangxp12/dsh-plugin-search
- 目录页: https://www.skillhub.cn/plugins/huangxp12/dsh-plugin-search