如何为Devin's Badges贡献新徽章:提Issue的正确姿势与PR难合并的完整解析
如何为Devin's Badges贡献新徽章:提Issue的正确姿势与PR难合并的完整解析
Devin's Badges(package.json 中名为 @intergrav/devins-badges)是一个开源的美观徽章资源库。想为它贡献新徽章?本文给你一条现实可行的路径:通过 Issue 提交徽章需求,并解释为什么官方几乎不合并 PR。
项目速览:一个徽章资源库是如何组织的
Devin's Badges 收录了 GitHub、npm、Modrinth、Spotify 等数十个服务的徽章,每个徽章都提供两种风格:
compact—— 图标 + 文字的完整版cozy—— 更宽松的 64 像素高版本
并且每种风格都有 _vector.svg(矢量)和 _46h.png / _64h.png(位图)两个文件。资源按用途分类存放在 assets/ 目录下:
| 目录 | 用途 |
|---|---|
| assets/compact/available/ | "可在某某平台获取"类徽章 |
| assets/compact/supported/ | "支持某某平台"类徽章 |
| assets/compact/built-with/ | "使用某某技术构建"类徽章 |
| assets/compact/requires/ | "依赖某某"类徽章 |
| assets/compact/donate/ | 捐赠渠道类徽章 |
| assets/compact/social/ | 社区/社交类徽章 |
| assets/compact/documentation/ | 文档类徽章 |
| assets/compact/translate/ | 翻译类徽章 |
先说重点:为什么你提的PR大概率不会被合并?
在动手之前,先读 CONTRIBUTING.md,里面有一段对贡献者至关重要的说明:
- Git 不擅长处理二进制文件。本仓库包含 other/devinsbadges-template.fig 这类 Figma 二进制文件(见 other/README.md 的目录说明),导致 PR diff 无法有效审阅。
- 每个新徽章都要在 Figma 里手工整理。维护者必须逐一把新增/修改的徽章添加并组织进 Figma 工程,非常耗时,所以官方声明:PRs will likely not be merged(PR 很可能不会被合并)。
- 贡献入口是 Issue 而不是 PR。维护者会亲自在 Figma 中制作徽章,再统一发布。
另外还有一条政策变化需要特别注意(2026 年 1 月 16 日起生效,见 README.md 顶部的 Disclaimer):
官方仓库现在只接收"非常知名项目"的徽章。其他徽章,你可以自由使用徽章模板,自行托管和分发。
贡献新徽章的标准流程:提Issue让维护者来画
根据 README.md 的 "Adding more badges" 一节,官方推荐的贡献方式是:
- 确认项目够知名 —— 对照上面的政策,只向官方仓库提"非常知名项目"的徽章需求,避免被直接关闭。
- 打开一个 Issue,写清楚三件事:
- 徽章对应的服务/项目名称(例如某个代码托管平台);
- 你希望的分类(supported、requires、social……对应上面表格中的目录);
- 该服务的品牌色和官方 Logo 来源,方便维护者还原风格。
- 等待维护者响应 —— 维护者会在 Figma 中制作徽章,产出 svg + png 双格式文件后发布到对应版本。
💡 小建议:同一服务只提一个 Issue;如果已有相似 Issue,补充信息而不是重复开帖。
自己动手:用Figma徽章模板制作私有徽章
如果你等不及,或者你的项目不在"非常知名"之列,官方明确鼓励你自己做徽章。模板就放在仓库里:
- other/devinsbadges-template.fig —— 官方徽章模板,"用 Figma 打开,跟着里面的说明操作即可"(见 other/README.md);
- other/devinsbadges.fig —— 全部徽章的 Figma 源文件,可用于参考现有徽章的画法,或修改一个已存在的徽章。
操作流程大致是:Figma 打开模板 → 替换 Logo 与文字 → 按模板标注导出 46h/64h 高度的 png 与 svg → 自行托管(GitHub Pages、CDN 等)→ 在 README 里引用你自己的链接。整个 other/ 目录说明见 other/README.md。
🎨 徽章本身采用 CC0 1.0 协议(LICENSE),你可以随意使用和修改设计,甚至不需要署名(但官方表示会很感谢署名)。
贡献者避坑清单:哪条路适合你
| 你的情况 | 推荐路径 |
|---|---|
| 项目是 GitHub、Maven 级别的大平台 | 提 Issue,等官方制作 |
| 项目较小众,但急需徽章 | 用 other/devinsbadges-template.fig 自制并自行托管 |
| 想给已有徽章改颜色/加文字 | 基于 other/devinsbadges.fig 修改后自托管(官方不收 PR) |
| 想直接发 PR 让仓库收录 | ❌ 不推荐,官方已声明 PR 大概率不合并 |
写在最后
Devin's Badges 的贡献模式很特别:它把"提需求"(Issue)作为贡献,把"画徽章"留给了维护者,这既保证了徽章风格的高度统一,也解释了 PR 为何难合并。理解这条规则后,你会省下一周等待 PR 审阅的时间——直接提一个高质量的 Issue,或者打开 Figma 模板,10 分钟拥有自己的专属徽章。🚀

