按理说，

一份写给前端开发者的 Python 小项目实战教程

1. 实战的观点是。搭建 AI Code Review 自动化流水线
2. GitLab-Runner + AI 代码审查服务 + 远程大模型 全套部署运维实战

缘起这方面，为什么我要写这份笔记？不过，

前几天我搭了一套 AI 代码审查服务，用 Python + Flask 写了大概 行代码。实现了：当 GitLab 收到 MR 时自动调用 AI 分析代码 diff，接下来把审查意见贴回 MR 评论区。

团队里几个前端同事看了都很好奇：“我不会 Python，这个能学会吗？” 我就想，干脆写一份零基础也能看懂的学习笔记。把我踩过的坑、理解的过程都记录下来。

痛点 ①：人工 review 慢且容易忽略细节

• 每次有人提 MR。都要人工 review，很慢，而且有些低级错误反复出现。
• 我们希望让 AI 先帮忙扫一遍，把明显的错误挑出来人工只需要看复杂逻辑。

痛点 ②：团队规范更新后手动同步成本高

团队代码规范可能会更新。若把规范文件硬编码在脚本里每次更新都得改代码并重新启动，极易出错。

三、手把手运行起来

. 安装 Python

brew install python3
python3 --version # 应该显示 v3.x.x

. 下载代码与依赖文件

将 app.py 保存到一个文件夹。例如 /Users/you/ai-review-service/

Create a requirements.txt:

flask
openai
python-dotenv
requests
gitpython
pyyaml
jsonschema
colorama
urllib3==1.26.15
certifi==2024.7.4
chardet==5.1.0
idna==3.7
urllib3==1.26.15
PyYAML==6.0
PyJWT==4.8.0
# 如果你想支持本地模型，请自行添加 ollama 等库。

. 安装依赖

cd /Users/you/ai-review-service/
python3 -m venv venv # 创建虚拟环境
source venv/bin/activate # 激活虚拟环境
pip install -r requirements.txt # 安装依赖包

. 设置环境变量（创建 .env)

OPENAI_API_KEY=sk-xxxxxxxxxxxxxx # OpenAI 或兼容接口密钥
OPENAI_BASE_URL=https://api.openai.com/v1 # 如需国内通义千问可改为阿里云地址
OPENAI_MODEL=gpt-4o-mini # 使用的模型名称
GITLAB_TOKEN=glpat-xxxxxxxxxxxx # GitLab Personal Access Token
GITLAB_URL=https://gitlab.com # GitLab 实例地址
REVIEW_SPEC_PATH=./specs/frontend-code-review.md # 审查规范文件方法
AUTO_SYNC_SPEC=true # 是否自动同步最新规范
SKILLS_REPO_URL=https://gitlab.com/your-team/skills.git # 存放规范文件的仓库地址
SECRET_TEST_TOKEN=test-token- # 用于 CI 调用测试时校验 token 的字符串，可自行修改
export SECRET_TEST_TOKEN # 必须导出以供 CI 使用

. 开启服务 

python app.py // 启动 Flask 服务

四、配置文件 .env 详解 

)
REVIEW_SPEC_PATH 
)
AUTO_SYNC_SPEC 
)
SKILLS_REPO_URL 
)
SECRET_TEST_TOKEN 


Caution:
- GITLAB_TOKEN 必须包含 api 权限，否则无法在 MR 下发评论。- 若仅做实验，可暂时不配置 GITLAB_TOKEN。服务将返回 “无法获取 diff” 提示，但不会报错。

五、主要功能拆解​— 对前端友好版​ 

. 导入依赖 & 读取配置​ — 相当于 Express 的 app 对象和 dotenv 包​ 


变量名 
含义 
获取方式 



OPENAI_API_KEY 
调用 OpenAI 或兼容接口所需密钥。可在 OpenAI 官网或阿里云 DashScope 中申请。
直接复制粘贴密钥即可。按理说，

OPENAI_BASE_URL 
API 接口地址。默认使用 openai 官方域名；
怎么说呢，如果国内网络受限，可改为通义千问等兼容域名。
根据你使用的网站自行填写。

OPENAI_MODEL 
使用的大模型名称，如 gpt‑4o‑mini、qwen‑vllm‑base 等。
参考官方文档或你所在网站提供的模型列表。

GITLAB_TOKEN 
GitLab Personal Access Token，至少需要 api 权限才能拉取 MR diff 并发评论。老实说，


GITLAB_URL 
 GitLab 实例根地址。如 https://gitlab.your-company.com。如果是 gitlab.com 则直接留空或填写该域名即可。

代码审查规范文件相对方法；默认会从 SKILLS_REPO_URL 拉取当前版本；可以直接放在 repo 根目录下也可以放在 ./specs 文件夹内。

是否自动同步最新规范；建议开启 true，以免出现老版本规则导致误判。

存放团队统一审查规则的 git 仓库地址，例如 https://gitlab.com/your-team/skills.git。仓库内需包含 frontend-code-review.md 或类似命名的规则文档。

CI 调用测试时校验 Token 的字符串；在 .gitlab-ci.yml 中不必设此项。若想更安全，可改为随机字符串并导入 .env 中。