如何为Devin's Badges贡献新徽章:提Issue的正确姿势与PR难合并的完整解析

原创2026-11-16 09:23:191,862 阅读

如何为Devin's Badges贡献新徽章:提Issue的正确姿势与PR难合并的完整解析

Devin's Badges(package.json 中名为 @intergrav/devins-badges)是一个开源的美观徽章资源库。想为它贡献新徽章?本文给你一条现实可行的路径:通过 Issue 提交徽章需求,并解释为什么官方几乎不合并 PR。

Devin's Badges 徽章贡献项目横幅,展示大量服务徽章的官方品牌图

项目速览:一个徽章资源库是如何组织的

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/ 翻译类徽章

Devin's Badges 徽章库社交预览图,深色卡片上展示项目标语

先说重点:为什么你提的PR大概率不会被合并?

在动手之前,先读 CONTRIBUTING.md,里面有一段对贡献者至关重要的说明:

  1. Git 不擅长处理二进制文件。本仓库包含 other/devinsbadges-template.fig 这类 Figma 二进制文件(见 other/README.md 的目录说明),导致 PR diff 无法有效审阅。
  2. 每个新徽章都要在 Figma 里手工整理。维护者必须逐一把新增/修改的徽章添加并组织进 Figma 工程,非常耗时,所以官方声明:PRs will likely not be merged(PR 很可能不会被合并)。
  3. 贡献入口是 Issue 而不是 PR。维护者会亲自在 Figma 中制作徽章,再统一发布。

另外还有一条政策变化需要特别注意(2026 年 1 月 16 日起生效,见 README.md 顶部的 Disclaimer):

官方仓库现在只接收"非常知名项目"的徽章。其他徽章,你可以自由使用徽章模板,自行托管和分发。

贡献新徽章的标准流程:提Issue让维护者来画

根据 README.md 的 "Adding more badges" 一节,官方推荐的贡献方式是:

  1. 确认项目够知名 —— 对照上面的政策,只向官方仓库提"非常知名项目"的徽章需求,避免被直接关闭。
  2. 打开一个 Issue,写清楚三件事:
    • 徽章对应的服务/项目名称(例如某个代码托管平台);
    • 你希望的分类(supported、requires、social……对应上面表格中的目录);
    • 该服务的品牌色和官方 Logo 来源,方便维护者还原风格。
  3. 等待维护者响应 —— 维护者会在 Figma 中制作徽章,产出 svg + png 双格式文件后发布到对应版本。

💡 小建议:同一服务只提一个 Issue;如果已有相似 Issue,补充信息而不是重复开帖。

自己动手:用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 分钟拥有自己的专属徽章。🚀

登录后查看全文
devins-badges