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