15,963 星的仓库,把免责声明写进 description
PR-Agent 最显眼的不是功能,是一句切割:仓库 description 写着「This project is not the Qodo free tier」。一个开源项目要把「我不是谁」写进简介,通常说明有人一直在认错。
2026-11-12 核对时,The-PR-Agent/pr-agent 有 15,963 星、2,179 fork,MIT 许可,主语言 Python,当天仍有推送。它做的事是给 Pull Request 自动写描述、提审查意见。
时间线有个错位:仓库创建于 2023-07-05,所属组织 The-PR-Agent 却注册于 2026-02-26。星标、提交和 issue 编号都跟着仓库转移,治理关系是后来才换的。
README 的「Big News」段给出解释:Qodo 把 PR-Agent 捐给了开源社区,项目现在完全社区所有,并正在走捐给一家开源基金会的流程。
下面这组字段全部来自仓库接口,先把身份摆清楚,再谈切割究竟走到了哪一步。
| 字段 | 核对值 |
|---|---|
| 星标 / fork | 15,963 / 2,179 |
| 仓库创建 / 组织注册 | 2023-07-05 / 2026-02-26 |
| 最近推送 | 2026-11-12 |
| 许可证 / 主语言 | MIT / Python,默认分支 main |
| open issue / PR | 11 / 17 |
| 订阅者 / 仓库体积 | 64 / 187,489 KB |
| tag / release | 43 / 42 |
| 主页 | pr-agent.ai |
28 是 open_issues_count,含 PR。用搜索接口拆开是 11 个 open issue、17 个 open PR,写成「28 个待修 bug」就错了。
11-11 开的 issue #4874 和 PR #4873 到核对时都还开着,项目不是归档状态,README 的 legacy 一词指的是归属,不是活跃度。
README 用四种口径切割,赞助栏仍挂着 Qodo
切割不是一句 slogan,README 至少从四个角度把自己和商业版分开。这四处措辞各自回答一个不同的问题,值得逐条看。
| 位置 | 原文口径 | 回答什么 |
|---|---|---|
| 仓库 description | not the Qodo free tier | 不是免费版 |
| README 首段 | not the Qodo offering for open-source projects | 不是给开源项目的托管服务 |
| 项目定位 | community-maintained legacy project of Qodo | 承认历史归属,自称 legacy |
| 对照说明 | Qodo offers a free version for open-source projects | 承认对方仍提供同类产品 |
但同一页的 Sponsors 段落里,Qodo 是唯一的 Gold Sponsor,链接直接指向它对开源项目的免费版。切割与赞助写在同一屏里。
「Big News」段另给了三条治理信息,措辞都比 description 谨慎,合起来才是完整状态。
- 归属:项目现居 PR-Agent 组织,fully community-owned
- 人选:首位外部维护者 Naor,账号 naorpeled
- 下一步:正在捐赠给开源基金会,in the process of
文档站的维护者页比「首位」具体:列 4 人,1 位 Lead Maintainer、2 位 Maintainer、1 位 Community Manager。
赞助入口 .github/FUNDING.yml 只有 github: naorpeled 一行,下一行注释还写着 open_collective: TBD。集体资助通道尚未落地。
换句话说,README 已经把「不是 Qodo」讲透,却把「归谁」讲成了一个进行时。
根目录那份配置,开源版自己都不读
真正标出切割边界的不是 README,是根目录那份 763 字节的 .pr_agent.toml。它的注释比配置本身更值得读。
文件首行写明:这份配置由 Qodo 的 qodo-free-for-open-source-projects bot 消费,那是一套独立、托管、闭源的服务;本仓库的开源版不读它,[review_agent] 段只存在于托管版。
而这份被「另一个程序」读取的配置,恰好写着几项最敏感的动作。把它和 v0.50.0 的发布说明并排放:
| 根目录配置 | 值 | 开源版 v0.50.0 口径 |
|---|---|---|
enable_auto_approval | true | 改为 host-only,自动批准路径仍禁用 |
approve_pr_on_self_review | true | 作为 no-op 设置移除,残留会告警 |
push 命令含 /agentic_review | 托管版 | 开源版无此命令 |
PR 命令含 /improve | 托管版 | issue #4874 说并入 /review 并将移除 |
两套配置没有互相覆盖,因为本仓库的审查 workflow 主动绕开了根目录那份。注释原话是:合并它会导致作业失败,因为 push 命令指向开源版没有的 /agentic_review。
于是 workflow 里设了 CONFIG__USE_REPO_SETTINGS_FILE: 'false',跑的是 docker://pragent/pr-agent:github_action,模型密钥取自 QODO_SPONSORSHIP_LLM_KEY。
11-11 的 PR #4873 下有两条评论来自 the-pr-agent-bot[bot],一条审查指南、一条代码建议,说明开源版确实在这个仓库跑。
这个 GitHub App 由 The-PR-Agent 组织持有,2026-10-10 创建,权限是 contents 读、issues 与 pull-requests 写,和 Qodo 托管 bot 不是同一个身份。
再看体量。拉完整 git 树,truncated=false,826 条目、778 个 blob、15,905,202 字节,可以放心数。
| 位置 / 类型 | 数量 | 说明 |
|---|---|---|
| tests/ | 443 文件 / 7,038,893 字节 | 占 blob 56.9%、字节 44.2% |
| pr_agent/ 与 docs/ | 162 / 123 文件 | 源码与文档站 |
| pr_agent/settings/ | 25 份 .toml | 提示词与运行配置 |
| pr_agent/commands/ | 15 个模块 | 含 help_docs、config 等 |
| 根目录指南 | AGENTS.md 15,490 / CONTRIBUTING.md 2,073 字节 | 给 agent 的比给人的长 7 倍 |
README 点名 5 个 git 平台:GitHub、GitLab、Bitbucket、Azure DevOps、Gitea。代码里 git_providers/ 有 16 个 .py,去掉基类、客户端与工具文件后是 10 份实现。
多出来的包括 Gerrit、CodeCommit、Bitbucket Server,以及本地 git 和纯 diff 模式。表格按「平台」计,目录按「接入实现」计,不是同一份名单。
v0.50.0 发布于 2026-11-07,发布说明 25,598 字符、292 行、262 条列表项。一个自称 legacy 的项目,一版仍有这样的体量。
| 章节 | 条数 | 章节 | 条数 |
|---|---|---|---|
| Breaking changes | 5 | Bug Fixes | 146 |
| Features | 19 | Performance | 38 |
| Documentation | 13 | Maintenance | 30 |
| Dependencies | 11 | 合计 | 262 |
146 条修 bug 加 38 条性能共 184 条,占 262 条的 70.2%。维护强度没降,降的是身份归属。
同一版还把 pacing、retry、custom labels 和 config.num_retries(上限 10)收归 host-only,README 却仍写着 Highly Customizable。
数据核对:以下字段均直接读取,未做二次推算。
- 身份:The-PR-Agent/pr-agent,15,963 星 / 2,179 fork,MIT,Python,创建 2023-07-05;组织注册 2026-02-26。
- 版本:v0.50.0 发布于 2026-11-07,说明 25,598 字符 / 262 条列表项;仓库 43 tag、42 releases。
- 目录:完整树 truncated=false,826 条目 / 778 blob / 15,905,202 字节;tests 443、settings 25 份 toml。
- 口径:open_issues_count 28 = 11 issue + 17 PR;6,500 次提交中 1,634 次在 2026-02-26 之后,贡献者 419 人。
- 边界:未安装、未运行、未做性能实测;Qodo 托管 bot 的当前活跃状态未核实,本文不作断言。
核对时间 2026-11-12。
三种安装方式,两个不该照抄的配置
对使用者来说,切割声明不影响安装,但升级与复制配置会踩坑。先把 README 给出的路径摆成表。
| 渠道 | 命令 / 入口 | 注意 |
|---|---|---|
| pip | pip install "pr-agent[github]" | Git provider SDK 是可选 extras |
| CLI | pr-agent --pr_url <PR_URL> review | 自行配置模型密钥 |
| GitHub Action | uses: the-pr-agent/pr-agent@main | 传 OPENAI_KEY 与 GITHUB_TOKEN |
| Docker | pragent/pr-agent | 0.34.2 起的新命名空间 |
README 的迁移提示很具体:0.34.2 起镜像发到 pragent/pr-agent,v0.31 及以前留在 codiumai/pr-agent 冻结归档,旧命名空间不再推新镜像。
钉死过 image 引用的 CI 要改名,否则会一直停在旧版本上。这类迁移不会报错,只会安静地不再更新。
升到 v0.50.0 之前,把仓库级 .pr_agent.toml 里的 pacing、retry、custom labels 搬到 host 配置,num_retries 不得超过 10。
三个容易踩的坑,都来自仓库自己的文件,不是推测:
- 照抄根目录 .pr_agent.toml:[review_agent] 段只属于托管版,开源版不认
- /help_docs:README 写自 v0.36.1 起暂时禁用,pr_help_docs.py 仍在树里
- /improve:11-11 的 issue #4874 说并入 /review、下版移除,别写进长期脚本
关于 /help_docs 还有一处时间差:README 写「pending a fix」,对应的 issue #2445 已在 2026-06-19 关闭,命令入口仍未恢复。
想贡献代码,仓库给了两份指南。AGENTS.md 15,490 字节是给编码 agent 的共享规范,CONTRIBUTING.md 2,073 字节给人看。
前者明确要求:未经维护者批准,不得删除或重命名配置、提示词、workflow 文件;新增依赖、改 workflow 也要先确认。
本地验证只跑单测,命令是 PYTHONPATH=. uv run pytest tests/unittest;e2e 需要 provider 凭证,必须显式调用。
完全社区所有,是一个进行时
「fully community-owned」描述的是方向,不是 2026-02-26 那天完成的状态。治理转移至少有四条线,逐条核比读一句 README 有用。
| 治理线 | 已转移 | 尚未收口 |
|---|---|---|
| 代码与仓库 | 新组织、新 App、新文档域 | 根目录仍留托管版配置 |
| 运行成本 | 社区 CI 跑开源版 | 模型密钥仍叫 QODO_SPONSORSHIP_LLM_KEY |
| 维护者 | 维护者页列 4 人 | 首位外部维护者、基金会捐赠进行中 |
| 资金 | 个人赞助入口可用 | FUNDING.yml 里 open_collective 仍是 TBD |
星标也不能当治理证据。15,963 星从 2023-07-05 起随仓库转移;6,500 次提交里,只有 1,634 次发生在组织注册之后。
贡献者 419 人,提交最多的 mrT23 有 2,735 次,首位外部维护者 naorpeled 是 63 次。历史贡献与当前维护责任不是同一批人。
这是捐赠型项目的常态,不算漏洞;但要把它写进团队流程,得接受维护梯队还在重组,升级节奏不由使用者决定。
更实际的风险是配置误读:同一个 .pr_agent.toml 文件名,根目录那份给托管 bot 用,你自己仓库里那份才给开源版用。
再补一处小反差:README 的演示区还挂着 /describe、/review、/improve 三张截图,而 /improve 已在 11-11 被排进移除清单。文档落后代码一个版本,是活跃仓库的代价。
所以我的判断是:判断一个开源项目归谁,别读 description,去读 workflow 里的密钥名、配置文件的首行注释,以及 App 的权限范围。
声明负责表态,这三者负责事实。PR-Agent 值得用的理由没变:10 份 provider 实现、一版 262 条变更、6,500 次提交都还在这里。
变的是你必须知道 哪一行配置会被哪套程序执行。这一点,README 的一句话切割替不了。
去看原始仓库
The-PR-Agent/pr-agent:Qodo 捐给社区的开源 PR 审查 agent,支持 GitHub、GitLab、Bitbucket、Azure DevOps、Gitea,MIT 许可。
前往 GitHub