为什么选「文档与本地化」这条线

绝大多数开源 AI 项目(推理框架、Agent 框架、微调工具链、评测集)的代码贡献者远多于文档贡献者。结果是:英文 README 尚可,中文文档常年停留在两三个版本之前,术语不统一,示例跑不通。

这类缺口有三个特点,恰好对你有利:

  • 维护者没有时间补,但知道它影响采用率;
  • 衡量标准清晰(文档覆盖率、翻译完成度、示例可运行),不用争论「贡献值不值」;
  • 可重复:版本一更新,文档又要跟一轮,天然形成周期。

关键在于:你要的不是一次性的致谢名单,而是一条能持续产出额度的通道。

操作步骤

第一步:筛选「有回馈机制」的项目

不是所有项目都发额度。按以下顺序排查,命中率最高:

  1. 官方文档仓库与主仓库分离的项目。这类项目通常有独立的 docs 或 website 仓库,贡献门槛低,PR 合并快。
  2. README 里出现 Contributors、Sponsors、Community 页面的项目。有赞助商或商业实体在背后(云厂商、模型厂商、API 网关)的项目,最有可能把额度作为贡献激励。
  3. 有 CONTRIBUTING.md 且明确写了「翻译/文档贡献同等计入」的项目。这句话本身就是回馈意愿的信号。
  4. Discord / Slack 里有 #docs、#translation、#i18n 频道。进去潜水两天,看维护者怎么回复文档 PR,比读文档更快判断氛围。

排除项:个人玩具项目、长期无人 review 的仓库、以及明确声明「不接受 AI 生成内容」的项目(很多项目现在有这条,务必先读 CONTRIBUTING)。

第二步:先做一件「小而完整」的事

不要一上来就提「我要翻译整站」。维护者最怕的是接手一个半成品。

推荐的第一件贡献:

  • 把 Quickstart 跑一遍,把跑不通的地方修好并提 PR。这是最容易合并、也最容易被记住的贡献。
  • 补一份术语对照表(英文术语 → 中文译名 → 出处)。这类文件维护者自己不会写,但一旦有了会长期保留。
  • 翻译一个不超过 500 行的核心页面,并保持与英文原文的锚点一致,方便后续 diff。

提 PR 时在描述里写清:改了什么、为什么这么译、还有哪些页面可以接着做。第三条是关键——它把你的 PR 从「一次性补丁」变成「可延续的工作流」。

第三步:把回报形式谈清楚

合并之后,在 issue 或私信里提出后续合作,措辞要具体、可执行。可用的三种回报形式,按落地难度排序:

  1. 项目方直接发放的 API 额度 / 兑换码。适用于背后有商业实体的项目。通常以「社区贡献者额度」名义发放,金额用「约」「通常」这类词判断即可,不要预设数字。
  2. 贡献者身份带来的免费层升级。部分平台对已合并贡献者开放更高的免费层或更长的上下文配额,需要你用 PR 链接申请。
  3. 赞助商额度转赠。项目在 Open Collective、GitHub Sponsors 或类似平台上有赞助方时,可以询问是否以「文档维护者」身份获得赞助方提供的推理额度。

提出请求时,附上:已合并 PR 链接、后续可承接的工作清单、预计节奏(例如每月一个页面)。维护者更愿意支持一个有节奏的人。

第四步:把它变成周期

一次性额度会花完,节奏不会。做法是:

  • 在项目里开一个 tracking issue,列出待翻译 / 待补全页面,自己认领一部分;
  • 每到新版本发布,主动跟进 changelog 里的文档变更;
  • 如果项目有 release notes 翻译需求,争取固定负责某一模块。

固定模块 = 固定产出 = 可预期的回馈请求依据。

注意事项

  • 先读 CONTRIBUTING 和 AI 使用政策。2026 年越来越多项目要求披露是否使用 AI 辅助翻译,未披露可能直接被 close。
  • 不要机翻直出。术语不一致、示例代码未验证的翻译 PR 会被打回,反而消耗信誉。
  • 不要在公开 issue 里直接谈钱。先用私信或社区频道的贡献者通道沟通,避免被当成推广。
  • 额度通常有有效期与限速,拿到后先确认过期时间和并发限制,别攒着不用。
  • 保留所有 PR 链接与合并记录。这是你后续申请任何形式回馈的唯一凭证。

适用场景

  • 你英文读写尚可,但不熟悉项目核心代码;
  • 你能保持每月几小时到十几小时的稳定投入,而不是一次性爆发;
  • 你希望额度来源相对稳定,而不是靠抢限时活动;
  • 你所在的项目生态里,中文文档质量确实落后于英文版本。

常见误区

  • 只翻译 README 顶部:维护者看得出你只想拿好处。选一个完整模块做完更重要。
  • 同时铺十个项目:没有一个项目会把你当固定贡献者,回馈请求自然没人应。
  • 把额度当成唯一目标:文档贡献的长期价值在于你成为项目里「那个负责中文文档的人」,这个身份本身会持续带来机会。