git-into-gsoc

git-into-gsoc

利用真实数据而非猜测，找到你的第一个开源贡献机会，并为 Google Summer of Code（GSoC）做好准备。

每年，许多初次参与者都会加入一个不再回复的项目，询问一个已有三人认领的问题，或提交一份读起来和其他上百份提案相似的提案。git-into-gsoc 会读取 GSoC 官方网站、组织档案和 GitHub，并向你展示：

• 哪些组织符合你的知识和兴趣
• 哪些组织的代码仓库确实会合并新手的拉取请求（提议的更改）
• 哪些新手问题（报告的错误或任务）尚无人认领
• 项目当前进展如何，以及本周该做什么

它可以在终端以及 Claude Code、Codex、Cursor 和 VS Code 等 AI 助手中使用。它绝不会编造组织、问题或日期，也绝不会帮助任何人发送垃圾信息。

两分钟上手

1. 安装。 在 macOS、Linux 或通过 WSL（适用于 Linux 的 Windows 子系统）使用 Windows 时，打开终端并运行：

curl -fsSL https://raw.githubusercontent.com/anandkaranubc/git-into-gsoc/main/install.sh | bash

在 Windows PowerShell 中运行：

irm https://raw.githubusercontent.com/anandkaranubc/git-into-gsoc/main/install.ps1 | iex

你只需要连接互联网。如果缺少某些内容，安装程序会提供 uv，这是一款自带 Python 的免费工具。它会告诉你安装了什么，并连接它找到的所有 AI 助手。如果安装了 uv，uv 会将其文件夹添加到 shell 的启动文件中，以便在新终端中找到该命令。其他安装方式。

已经在使用 uv 或 pipx？请从 PyPI（Python Package Index，Python 包索引）安装软件包，然后连接你的助手：

uv tool install git-into-gsoc    # or: pipx install git-into-gsoc
git-into-gsoc setup

2. 回答四个问题，在新终端中运行：

git-into-gsoc start

你会获得适合你的组织、候选列表，以及附带准确命令的下一步操作。按 Enter 可跳过任何问题。

3. 随时回来查看。 单独运行 git-into-gsoc 可查看进度。git-into-gsoc next 会告诉你现在该做什么：截止日期、你关注的问题的变化，以及新出现的新手问题。

提示

搜索问题会使用 GitHub API，未登录时每小时最多只能请求 60 次。安装 GitHub 的 gh 工具并运行一次 gh auth login；git-into-gsoc 会自动识别。其他操作都不需要账户。

在 AI 助手中使用

安装程序会自动连接找到的助手。若要将 git-into-gsoc 添加为可随助手更新的插件，只需运行一行命令。你需要安装 uv，这是一个免费工具，可启动助手与之通信的 git-into-gsoc 服务。该服务使用 MCP（模型上下文协议），这是 AI 助手使用外部工具的标准方式。对于 Claude Code：

claude plugin install git-into-gsoc --marketplace anandkaranubc/git-into-gsoc

在 AI 助手中使用列出了 Codex、GitHub Copilot CLI、Gemini CLI、Antigravity、VS Code、Cursor、Windsurf 和 Claude Desktop 对应的命令行，以及如何更新或移除每个插件。

接着用自己的话提问，例如：“我想参加 Google Summer of Code。我会 Python，也喜欢科学。我该从哪里开始？” 助手会使用与终端相同的实时数据，并展示数据来源。

以下是一键安装按钮，仅用于安装服务。每个按钮都会安装最新版本：

从零开始完成第一个拉取请求

每个步骤都注明了执行该步骤的命令。新手指南会逐步讲解所有步骤，并说明预期结果。

步骤	命令	你会获得什么
找到适合你的组织	git-into-gsoc start	三个适合你的组织，并附上推荐理由
深入了解	git-into-gsoc org "NumFOCUS" --shortlist	创意页面、聊天频道和往届项目，并保存到你的候选清单
选择代码仓库	git-into-gsoc repos "NumFOCUS"	该组织的代码仓库，按导师活跃度和未解决的新手问题排序
确认项目欢迎你	git-into-gsoc repo OWNER/NAME --track	外部贡献者的拉取请求是否会被合并，以及合并速度
熟悉项目	git-into-gsoc orient OWNER/NAME	代码所在位置、CI（自动检查）运行的测试命令，以及项目规范
找一个可认领的问题	git-into-gsoc issues --repo OWNER/NAME	没有关联拉取请求、未分配给他人且近期无人认领的新手问题
评论前先确认	git-into-gsoc issue OWNER/NAME#123 --track	认领情况、关联的拉取请求，以及应先阅读的内容
提交你的拉取请求	git-into-gsoc pr-check OWNER/NAME#456	根据项目自身规则检查你的拉取请求
撰写提案	git-into-gsoc proposal draft.md	提案被组织拒绝的原因及相关依据

OWNER/NAME 和数字是所选代码仓库和问题的占位符。每个命令都支持 --output json，方便脚本使用；git-into-gsoc --help 会列出所有命令。

为什么你可以相信它提供的信息

• 依据证据，而非猜测。 组织信息来自官方列表和公开档案。日期来自官方网站，未来年份会标注为估算值。每项结果都会说明其排名依据。
• 可用就是真正可用。 问题是否可用，是根据该问题自身的时间线判断的：关联的拉取请求、认领人，以及带日期的“我可以处理这个问题吗？”认领声明。
• 只读且保护隐私。 它只读取公开数据，不会在任何地方发布内容。你的个人资料和进度保存在你电脑上的文件中。无需账户，不会跟踪，也没有遥测。请参阅隐私和信息来源与限制。
• 不走捷径。 它不会批量给维护者发消息、刷无关紧要的拉取请求，也不会替你撰写提案。它会引导你查看各组织的 AI 政策，并帮助你完成能够清楚解释的工作。

接下来可以做什么

我想……	从这里开始
先了解 GSoC 和开源	新手指南
连接特定的 AI 助手	助手设置
查询命令	命令参考
查看助手可用的工具	MCP 参考
解决设置问题	故障排除
提问或分享使用体验	提交问题

参与构建

git-into-gsoc 面向刚开始接触开源的人，是迈出第一步的好地方。修正一句令人困惑的话也算贡献，报告某个命令在你这里无法正常运行也一样。

• 从 CONTRIBUTING.md 开始。配置只需几分钟，无需任何开源经验。
• 选择一个标记为 good first issue 的问题。
• 阅读架构，了解终端工具、助手服务和技能（用来指导助手如何使用工具的文字说明）如何共用一个核心。

如果 git-into-gsoc 对你有所帮助，最有用的做法是告诉我们哪些内容有效，哪些无效。这会创建一个公开的 GitHub 问题，因此请勿留下任何私人信息。然后告诉一位刚起步的朋友。

许可证与免责声明

MIT，详见 LICENSE。

本独立项目与 Google 无关，也未获得 Google 的认可。Google Summer of Code 和 GSoC 是 Google LLC 的商标。请始终在项目官方网站查看日期、组织和规则。