playwright-openwebui

重要说明 (Living Document)

这是一个持续演进的技能文件 (Living Skill)
每次测试会话结束后，必须将新发现的 selector、时序问题、已知坑点追加到 .agent/learnings/playwright-tests.md。
每次新会话开始前，必须先读取该文件，避免重复踩坑。
本文件本身也应在发现重大 UI 变化时更新（例如 OWUI 版本升级导致 selector 失效）。

配套 Agent: plugin-tester.agent.md — 完整的部署+测试+学习闭环。
Env 文件: .github/agents/.env.openwebui (OPENWEBUI_URL / USERNAME / PASSWORD)
Scripts Env: scripts/.env (api_key + url，用于 Python 部署脚本)

Instructions

Use Playwright browser tools to test and debug OpenWebUI plugins. Start every session with the login flow. Credentials and URL are read from .github/agents/.env.openwebui.

第一步：登录（每次会话必须先执行）

const fs = require('fs');
const path = require('path');

// 读取 .env.openwebui
function loadEnv() {
  const envPath = path.join(process.cwd(), '.github/agents/.env.openwebui');
  const raw = fs.readFileSync(envPath, 'utf-8');
  const env = {};
  for (const line of raw.split('\n')) {
    const trimmed = line.trim();
    if (!trimmed || trimmed.startsWith('#')) continue;
    const [key, ...rest] = trimmed.split('=');
    env[key.trim()] = rest.join('=').trim();
  }
  return env;
}

const env = loadEnv();
const BASE_URL = env.OPENWEBUI_URL || 'http://localhost:3000';

// 导航到登录页
await page.goto(`${BASE_URL}/auth`, { waitUntil: 'networkidle' });

// 检查是否已登录（已登录则跳过）
const isLoggedIn = await page.locator('[id="chat-textarea"], [placeholder*="message" i], div[contenteditable]').count();

if (!isLoggedIn) {
  // 填写 email
  await page.locator('input[name="email"], input[autocomplete="username"], input[type="email"]').first().fill(env.OPENWEBUI_USERNAME);
  // 填写密码
  await page.locator('input[type="password"]').first().fill(env.OPENWEBUI_PASSWORD);
  // 点击登录
  await page.locator('button[type="submit"]').first().click();
  // 等待登录完成
  await page.waitForURL(`${BASE_URL}/**`, { timeout: 10000 });
  await page.waitForTimeout(1500);
}

console.log('✅ 已登录 OpenWebUI:', await page.title());

---

常用操作模式

截图存档

await page.screenshot({ path: '/tmp/owui-before-fix.png' });