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:

# 为项目创建一个新目录
uv init pr_reviewer
cd pr_reviewer

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

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

---

步骤 3：创建 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

---

步骤 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 → Settings → Developer Settings → Personal Access Tokens。
2. 单击 "Generate new token (classic)"。
3. 启用以下范围：
   • read:org
   • read:repo_hook
   • repo
4. 将 token 复制并粘贴到您的 .env 文件中，作为 GITHUB_TOKEN。

Notion 集成：

1. 转到 Notion Integrations。
2. 单击 "New integration" 并将类型设置为 Internal。
3. 将其添加到您的工作区。
4. 将 Internal Integration Secret 复制为 NOTION_API_KEY。
5. 将 集成 URL 末尾的 UUID 复制为 NOTION_PAGE_ID。

---

步骤 5：创建主脚本

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

touch pr_reviewer

将您的应用程序逻辑添加到此文件中。

---

步骤 6：运行应用程序

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

python pr_reviewer.py