PR 审核者设置指南

本指南提供了设置 PR 审核者项目的逐步说明，其中包括与 GitHub 和 Notion 的集成。

先决条件

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

设置说明

步骤 1: 安装 uv

MacOS/Linux:

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

🔁 之后重启你的终端以确保 uv 命令可用。

步骤 2: 创建并设置项目

MacOS/Linux:

# Create a new directory for the project
uv init pr_reviewer
cd pr_reviewer

# Create and activate a virtual environment
uv venv
source .venv/bin/activate

# Install core dependencies
uv add "mcp[cli]" requests python-dotenv notion-client

步骤 3: 创建 requirements.txt 并从它安装

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

# Core dependencies for PR Analyzer
requests>=2.31.0          # For GitHub API calls
python-dotenv>=1.0.0      # For environment variables
mcp[cli]>=1.4.0           # For MCP server functionality
notion-client>=2.3.0      # For Notion integration

安装包：

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

步骤 4: 设置环境变量

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

GITHUB_TOKEN=your_github_token
NOTION_API_KEY=your_notion_api_key
NOTION_PAGE_ID=your_notion_page_id

GitHub Token:

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。

步骤 5: 创建主脚本

为您的服务器逻辑创建一个空脚本文件：

touch pr_reviewer

在这个文件中添加您的应用程序逻辑。

步骤 6: 运行应用程序

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

python pr_reviewer.py