ts-agent · QualityExec Agent

QualityExec 平台的本地执行代理（qexec-agent）：在本机驱动 Playwright/Chrome 执行测试用例，自带本地 SQLite 与 Web 调试界面；也可作为执行场地通过 /run-bulk 接收平台调度。术语见 CONTEXT.md。

安装（npm 公共仓库）

前置要求：Node.js ≥ 24（LTS）。

mkdir my-agent && cd my-agent
npm install qualityexec-agent

# 安装浏览器内核(也可稍后在 Web UI「执行配置 → 浏览器」里改用系统 Chrome/Edge 免下载)
npx playwright install chromium

# 可选:想要录屏时安装(仅约 2.5MB,不下载浏览器内核;截图不需要它)
npx playwright install ffmpeg

# 国内网络提示:better-sqlite3 的预编译二进制默认从 GitHub Releases 下载,
# 拉取失败会导致缓存路由 500(agent 启动自检会提示)。用镜像重装即可:
npm_config_better_sqlite3_binary_host=https://registry.npmmirror.com/-/binary/better-sqlite3 npm install -g qualityexec-agent

# 启动，Web UI 默认 http://localhost:21011
npx qexec-agent

数据目录默认在 ~/.qualityexec/agent（AGENT_CACHE_DIR 可改）：首次使用时自动 创建并初始化本地 SQLite（cache.db），无需手动建表；浏览器等内核由上面的 playwright install 安装到系统缓存目录。

快速开始（开发）

# 开发
npm run dev

# 构建（服务端 + UI）
npm run build:all

# 启动
npm start

Web UI 默认跑在 :21011（配置见 docs/CONFIGURATION.md），提供状态、数据、 运行、历史、配置五个页面。

品牌

• 预览全部素材：brand/preview.html（mark 三变体、favicon 尺寸阶梯、lockup、banner、OG、色板与使用规则）
• Logo「Orbit Loop」：靛蓝开口执行回路环 + 环心播放键 + 右下轨道绿点（与主站 Cycle Q 的 Q 尾同位呼应）
• SVG 源在 brand/src/，改完后 node brand/render.mjs 一键重渲染 PNG 并同步到 ui/public/