- name
- browser-setup
- description
- >
Browser Setup
一键安装和验证 Playwright + Chromium 浏览器自动化环境。
快速流程
按顺序执行以下三步：
Step 1: 检查系统兼容性
bash scripts/check-compat.sh检查项：操作系统、内存（≥2GB，推荐 4GB+）、CPU（≥2核）、磁盘（≥1GB）、Node.js（≥18）、Xvfb 状态。
如果 FAIL > 0，先解决问题再继续。
Step 2: 安装浏览器环境
bash scripts/install-browser.sh <工作目录路径>自动完成：
- 安装 Xvfb 虚拟显示器（Linux）+ Chrome 系统依赖
- 安装 Playwright npm 包（全局 + 项目内）
- 下载 Chromium + Chrome Headless Shell
- 创建
scripts/start-xvfb.sh辅助脚本
Step 3: 验证
# 头模式（适合服务器）
bash scripts/verify-browser.sh <工作目录> /tmp/browser-verify.png headless
# 非头模式（模拟真实用户，需先启动 Xvfb）
bash scripts/verify-browser.sh <工作目录> /tmp/browser-verify.png headed验证脚本会：打开百度 → 截取屏幕 → 输出标题和热搜第一 → 返回截图路径。
非头模式说明
服务器环境没有物理显示器，需要 Xvfb 创建虚拟显示器：
export DISPLAY=:99
Xvfb :99 -screen 0 1280x900x24 -ac &之后 Playwright 设置 headless: false，浏览器在虚拟显示器中运行，行为与真实用户完全一致（加载所有扩展、渲染 WebGL、触发真实 DOM 事件）。
Playwright 代码示例
const { chromium } = require('playwright');
const browser = await chromium.launch({
headless: false, // 非头模式
args: ['--no-sandbox'] // 服务器环境必需
});
const page = await browser.newPage();
await page.goto('https://www.baidu.com');
await page.screenshot({ path: '/tmp/screenshot.png' });
await browser.close();截图发送到飞书
验证脚本生成截图后，可通过飞书 API 上传并发送：
# 1. 上传图片获取 image_key
IMAGE_KEY=$(curl -s -X POST "https://open.feishu.cn/open-apis/im/v1/images" \
-H "Authorization: Bearer $TENANT_TOKEN" \
-F "image_type=message" \
-F "image=@/tmp/browser-verify.png" | python3 -c "import sys,json; print(json.load(sys.stdin)['data']['image_key'])")
# 2. 发送图片消息
curl -s -X POST "https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=open_id" \
-H "Authorization: Bearer $TENANT_TOKEN" \
-H "Content-Type: application/json" \
-d '{"receive_id":"<open_id>","msg_type":"image","content":"{\"image_key\":\"'"$IMAGE_KEY"'\"}"}'