🚀 PR 审查者设置指南

本指南将为你提供设置 PR 审查者项目的详细步骤，其中涵盖了与 GitHub 和 Notion 的集成方法，助你顺利完成项目搭建。

🚀 快速开始

本项目的设置需要一些先决条件，并按照特定步骤进行操作。下面将详细介绍每个步骤。

📦 安装指南

先决条件

• curl（适用于 MacOS/Linux）
• 系统上安装了 Python 3.x

第一步：安装 uv

MacOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

🔁 安装完成后，请重新启动终端以确保 uv 命令可用。

第二步：创建和设置项目

MacOS/Linux:

# 创建新目录用于项目
uv init pr_reviewer
cd pr_reviewer

# 创建并激活虚拟环境
uv venv
source .venv/bin/activate

# 安装核心依赖项
uv add "mcp[cli]" requests python-dotenv notion-client

第三步：创建 requirements.txt 并从中安装

创建一个名为 requirements.txt 的文件，并添加以下内容：

# PR 分析器的核心依赖项
requests>=2.31.0          # 用于GitHub API调用
python-dotenv>=1.0.0      # 用于环境变量
mcp[cli]>=1.4.0           # 用于MCP服务器功能
notion-client>=2.3.0      # 用于Notion集成

安装包：

uv pip install -r requirements.txt
pip install -r requirements.txt

第四步：设置环境变量

在根目录中创建一个 .env 文件，并添加以下内容：

GITHUB_TOKEN=your_github_token
NOTION_API_KEY=your_notion_api_key
NOTION_PAGE_ID=your_notion_page_id

GitHub 令牌：

1. 转到 GitHub → 设置 → 开发者设置 → 个人访问令牌。
2. 点击 “生成新的令牌（经典）”。
3. 启用以下范围：
   • read:org
   • read:repo_hook
   • repo
4. 将令牌复制到 .env 文件中作为 GITHUB_TOKEN。

Notion 集成：

1. 转到 Notion 集成。
2. 点击 “新建集成”，并设置类型为 内部。
3. 将其添加到你的工作区中。
4. 复制 内部集成密钥 作为 NOTION_API_KEY。
5. 复制 集成 URL 末尾的 UUID 作为 NOTION_PAGE_ID。

第五步：创建主脚本

创建一个空脚本文件用于服务器逻辑：

touch pr_reviewer

在该文件中添加你的应用程序逻辑。

第六步：运行应用程序

要运行项目，请确保环境已激活且 .env 已配置：

python pr_reviewer.py