v0.4.0 · Open Source

发现值得贡献的
开源 Issue

面向初中级开发者的开源贡献入口。搜索、过滤、评分 —— 帮你从海量 GitHub Issue 中快速找到适合上手的任务。

快速开始 GitHub
SCROLL

Features

核心能力

无需任何第三方依赖，一条命令即可搜索 GitHub 上的优质新手 Issue。

智能搜索

按语言、标签、Stars 和更新时间等维度精准筛选 GitHub Issue，告别盲目浏览。

自动过滤

自动排除已关闭、已指派、已关联 PR 和 Archived 仓库的 Issue，只保留真正可参与的任务。

智能评分

综合考虑项目活跃度、Issue 新鲜度、评论区讨论量和新手友好标签，给出贡献推荐分数。

多格式输出

支持 Table、Markdown 和 JSON 三种输出格式，方便集成到笔记、文档或自动化流程中。

零依赖

基于 Python 标准库构建，无需安装任何第三方包，拿到即可运行。

开发者预设

提供 junior、intermediate、senior 三种预设模式，满足不同经验开发者的需求。

搜索设置

Demo

示例输出

以下是运行 oss-issue-scout search --language python --label "good first issue" 的模拟结果。

oss-issue-scout ~ search
Score Repo Title Labels Stars
95 psf/requests Improve timeout error messages for connection pooling good first issue documentation ★ 52.4k
88 pallets/flask Add type annotations to flask.cli module good first issue enhancement ★ 67.8k
76 fastapi/fastapi Refactor test client to use httpx directly good first issue ★ 78.1k
72 tiangolo/sqlmodel Support composite primary keys for relationship() good first issue help wanted ★ 13.5k
68 numpy/numpy Add examples to numpy.einsum docstring good first issue ★ 28.6k
63 pydantic/pydantic Standardize error message format across validators enhancement ★ 21.3k

Scoring

评分规则

每个 Issue 从基础分 50 开始，根据项目活跃度、Issue 新鲜度等多个维度进行评分。支持 default、junior、intermediate、senior 四种预设模式。

加分因素

+30 仓库近 3 天内有 Issue 活动
+15 Issue 今日更新 / 仓库本周有活动
+15 评论数 ≤ 1，讨论量低，容易介入
+10~15 仓库 Stars 在 5k~50k 活跃范围
+10 带有 good first issue / help wanted 标签

减分因素

-40 仓库超过 30 天无 Issue 活动
-30 仓库 Issue 活动在 2~4 周前停滞
-20 Issue 超过 30 天未更新
-15 评论数 ≥ 5，讨论链过长
-10~15 仓库 Stars > 50k，竞争激烈

junior

新手友好预设，偏好小仓库、低讨论量、带有 good first issue 标签的任务。

intermediate

中级开发者预设，适合有一定经验的贡献者，关注 bug 和 enhancement 类型任务。

senior

资深开发者预设，偏好大型项目和复杂任务，对活跃度要求较低。

Quick Start

使用指南

Python 3.10+ 即可运行，无需安装任何第三方依赖。设置 GitHub Token 可获得更高 API 速率（5000 次/小时）。

PowerShell / Terminal 
# 基本搜索：查找 Python 语言的新手友好 Issue
$ oss-issue-scout search --language python
# 按标签过滤，限制返回数量
$ oss-issue-scout search --language python --label "good first issue" --limit 5
# 使用预设搜索：junior / intermediate / senior / default
$ oss-issue-scout search --language python --preset junior
# 高门槛过滤：Stars 500+、近 7 天有活动的仓库
$ oss-issue-scout search --language python --label "help wanted" --stars-min 500 --repo-updated-days 7
# JSON 格式输出，方便程序化处理
$ oss-issue-scout search --language python --format json
# 设置 Token 提升速率限制（Windows PowerShell）
$ $env:GITHUB_TOKEN="your_token_here"
$ oss-issue-scout search --language rust