三、源码运行 PageEyes agent

一、克隆 PageEyes 并安装依赖

# 激活 py312 环境
conda activate py312

# 克隆项目源码
git clone https://github.com/tencentmusic/page-eyes-agent.git


# 进入 page-eyes-agent
cd page-eyes-agent 

# 通过依赖文件（pyproject.toml）编译出 requirements.txt 文件
uv pip compile pyproject.toml -o requirements.txt

# 安装依赖
pip install -r requirements.txt

二、通过源码编译安装 PageEyes

# 激活 py312 环境
conda activate py312

# 进入 page-eyes-agent
cd page-eyes-agent

# 卸载现有的 page-eyes 包
pip uninstall page-eyes

# 编译源码并安装
pip install -e .

# 确认是否成功安装 page-eyes
pip list | grep page-eyes

完成后如下图，能看到 pip 安装的 page-eyes 包，是用源代码编译的

三、不安装 PageEyes 直接用源码运行

# 激活 py312 环境
conda activate py312

# 进入 page-eyes-agent 目录
cd page-eyes-agent

# 卸载现有的 page-eyes 包
pip uninstall page-eyes

# 进入 src 目录
cd src 

# 查看是否有 __init__.py 文件
cat page_eyes/__init__.py

# 没有创建 __init__.py 文件
touch page_eyes/__init__.py 


# 复制测试脚本到 src 目录中
cp ../tests/main.py .

# 运行测试脚本
python main.py

运行脚本后如下图，图中虽然报错，但能看到已经可以运行脚本了：

四、修改测试脚本

将第 13 行的：

    ui_agent = await WebAgent.create(simulate_device='iPhone 15 Pro Max', debug=False)

修改为：

    ui_agent = await WebAgent.create(simulate_device='Intel MacBook Pro 13-inch', debug=False)

修改后如下图：

在第 3 行添加：

import os

在第 12 行添加：

    os.environ["OPENAI_API_KEY"] = "你的 api key"
    os.environ["OPENAI_BASE_URL"] = "https://api.deepseek.com/v1"

添加后如下图：

再次运行后，看到如下图，已经正常运行

四、增加自己的调试信息

A）使用任意编辑器，加载克隆下来的 PageEyes 源码

B）打开刚才复制过来的 main.py 测试脚本

C）点进 run 方法

D）添加 log 信息

E）重新运行测试脚本，这时就能看到刚添加的调试信息。