让你的插件登上Herdr市场GitHub topic与索引规则完整指南【免费下载链接】herdrthe runtime your coding agents live on项目地址: https://gitcode.com/GitHub_Trending/her/herdr想让自制的 Herdr 插件被更多人发现吗Herdr 插件市场Marketplace是一个面向社区插件的自动索引只要你的公开仓库打上herdr-plugin这个 GitHub topic并在默认分支放置可解析的herdr-plugin.toml清单插件就会自动出现在市场卡片中。本文带你完整看懂 Herdr 插件市场的 GitHub topic 要求、索引刷新规则与上架检查清单。什么是 Herdr 插件市场Herdr 是一个让编码代理coding agents驻留的运行时runtime插件则是可共享、可执行的工作流包可以是一个 Bash 脚本、JavaScript 应用、Rust 二进制或任何机器能运行的 argv 命令。市场本身有几个关键定位特性说明索引范围只覆盖打了 topic 的公开仓库审核方式自动发现、不审核——上架意味着仓库自我标注而非 Herdr 官方认证刷新频率每 30 分钟自动刷新索引安装方式herdr plugin install owner/repo[/subdir...]直接从仓库安装规则细节可查阅官方文档marketplace.mdx 与 plugins.mdx。上架 Herdr 市场的 2 个硬性条件 上架不需要提交申请只需同时满足以下两点给公开仓库添加 GitHub topicherdr-plugin在仓库设置的 Topics 里加入herdr-plugin。默认分支上至少有一个可解析的herdr-plugin.toml清单可以放在仓库根目录也可以放在任意子目录中一个仓库可包含多份清单。满足后索引器会抓取默认分支的 HEAD解析清单必填元数据。解析失败 不上架。仓库内的测试样例可以参考这个最小可用的清单herdr-plugin.toml。清单必填字段上架的门槛元数据索引器检查的就是这些顶层必填字段缺一不可id example.workspace-tools name Workspace Tools version 0.1.0 min_herdr_version 0.7.0 description Small workspace helpers platforms [linux, macos, windows]id、name、version、min_herdr_version是必填项min_herdr_version设为你插件所依赖的最旧 Herdr 版本版本过新时 Herdr 会拒绝安装description可选但建议填写——它会提升卡片的信息量插件 id 仅允许 ASCII 字母、数字、点、冒号、下划线、连字符清单字段的完整定义见 manifest.rsCLI 侧的安装与 link 逻辑见 plugin.rs。索引刷新机制你的改动多久能上架这是新手最关心的问题规则如下定时刷新索引每30 分钟自动全量刷新一次增量重扫当仓库默认分支的 HEAD 发生变化时会触发重新扫描无需等待整轮记录到 commit索引会为每份清单记录 manifest 路径、id、name、version、platforms、min_herdr_version以及默认分支的确切 commit保证卡片内容与源码可对应 提示改完 topic 或清单后最坏等 30 分钟如果推送到了默认分支新 commit重扫会更早发生。这些仓库会被索引排除 ⚠️以下情况即使打了 topic 也不会出现在市场Fork 仓库已归档archived的仓库默认分支上没有有效herdr-plugin.toml的仓库清单必填元数据格式错误malformed的仓库市场卡片会展示什么每个仓库对应一张卡片仓库内每个有效清单则作为独立可安装的插件行列出仓库元数据仓库名与 owner、描述、star 数、主语言、最近推送时间插件行每个清单的name与version并链接到对应的源目录用户可以直接按仓库、插件元数据搜索并按热度、最近活动或最新创建排序。上架前自检清单 ✅推送默认分支前逐项核对仓库是公开的、非 Fork、非归档仓库已添加 topicherdr-plugin默认分支根目录或子目录至少有一份herdr-plugin.tomlid/name/version/min_herdr_version均存在且格式合法本地用herdr plugin link 路径验证清单可解析安装命令herdr plugin install owner/repo[/subdir]可正确指向插件目录另外请留意安全提示Herdr 不审核、不沙箱插件代码用户会自行审查herdr-plugin.toml与其运行的命令因此清单中的构建与启动命令尽量透明、易读。写在最后Herdr 的市场哲学是自动、开放、零门槛不需要 SDK、不需要提审一个 GitHub topic 加一份清单就能让你的插件进入社区视野。做好清单必填字段、保持默认分支可解析剩下的交给 30 分钟一次的自动索引即可。【免费下载链接】herdrthe runtime your coding agents live on项目地址: https://gitcode.com/GitHub_Trending/her/herdr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考