---
title: 插件市场
description: 在 GitHub 上发现社区 Herdr 插件,并让你自己的插件被收录。
---

Herdr 插件市场是一个可供发现的社区插件索引。
访问 [herdr.dev/plugins](/plugins/) 浏览。它是公开 GitHub 仓库的自动索引,
而不是经过审核的目录。

## 浏览插件

[插件市场](/plugins/)会列出所有打了 GitHub 主题标签 `herdr-plugin` 的公开仓库。
你可以按名称、作者、描述或语言搜索,并按热度、最近活跃度或最新排序。
每个条目都直接链接到它在 GitHub 上的源码仓库。

收录是自动且未经审核的。被列出只说明仓库给自己打了标签,并不代表 Herdr
审查过它,所以在安装任何插件之前,请先阅读[信任指南](/zh-cn/docs/plugins/#信任与安全)。

## 安装插件

插件市场是在安装之上增加的发现渠道,它不会取代安装。任何插件都可以直接从
GitHub 安装:

```bash
herdr plugin install owner/repo[/subdir...]
```

发布一个普通的公开 GitHub 仓库,在根目录或子目录放一个 `herdr-plugin.toml`
清单,这条命令就能用了。清单和编写参考见[插件](/zh-cn/docs/plugins/)。

## 让你的插件被收录

给公开仓库添加 GitHub 主题标签 `herdr-plugin`。索引只使用这一个信号,
所以给公开插件打上标签就够了。索引每 30 分钟自动刷新,新打标签的仓库很快
就会出现,去掉标签的仓库会在下一次刷新时消失。

## 条目会展示什么

每张卡片展示 GitHub 仓库的元数据: 仓库名和作者、描述、star 数、主要语言、
最后 push 时间,以及指回源码的链接。索引从 GitHub 的仓库搜索读取这些信息,
所以保持仓库描述和主题标签的准确,是让条目有用的关键。

索引目前还不会解析 `herdr-plugin.toml`,所以插件 `id`、声明的 `platforms`、
`min_herdr_version` 等清单字段在 v1 中不会展示。Fork 和已归档的仓库会被排除。
