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

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

## 浏览插件

[插件市场](/plugins/)会列出带有 GitHub 主题标签 `herdr-plugin`,并且默认分支中
至少包含一个必需元数据可解析的 `herdr-plugin.toml` 的公开仓库。你可以搜索仓库和
插件元数据,并按热度、最近活跃度或最新排序仓库卡片。每张卡片链接到源码仓库,
并列出其中发现的所有插件。

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

## 安装插件

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

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

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

## 让你的插件被收录

给公开仓库添加 GitHub 主题标签 `herdr-plugin`,并在默认分支中放置一个或多个
必需元数据可解析的 `herdr-plugin.toml`。清单可以位于根目录或子目录。插件市场
每个仓库显示一张卡片,并把每份有效清单列为可单独安装的插件。索引每 30 分钟
自动刷新。

## 条目会展示什么

每张卡片展示 GitHub 仓库的名称、作者、描述、star 数、主要语言和最后 push 时间。
插件行展示每份清单的 `name` 和 `version`,并链接到精确的源码目录。索引还会记录
清单路径、`id`、`name`、`version`、`platforms`、`min_herdr_version`,以及默认分支的
精确提交。Fork、已归档仓库、没有有效插件清单的仓库以及无效清单元数据都会被排除。
