Testmax

Testmax 是一个面向 Agent 的自动化测试平台。它把测试用例、浏览器 profile、执行任务、运行证据、报告和修复建议统一存到本地 SQLite，并通过多个平级 skill 暴露给 Codex/Agent 工作流。

Quickstart

cd /Users/yanghanwen/Development/Other/testmax
/Users/yanghanwen/.cache/codex-runtimes/codex-primary-runtime/dependencies/python/bin/python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e '.[dev]'
testmax db init --root /Users/yanghanwen/Development/Other/testmax
pytest

如果要接真实浏览器执行，再安装：

python -m pip install -e '.[browser]'
playwright install chromium

Skill 安装与初始化

普通用户可以直接通过结构化命令或自然语言完成安装：

testmax skill install \
  --root /Users/yanghanwen/Development/Other/testmax \
  --source local \
  --repo /Users/yanghanwen/Development/Other/testmax \
  --manifest /Users/yanghanwen/Development/Other/testmax/skill-manifest.json \
  --host codex

testmax init \
  --root /Users/yanghanwen/Development/Other/testmax \
  --workspace /Users/yanghanwen/Development/Other/testmax

testmax ask "安装并初始化 testmax skill" \
  --root /Users/yanghanwen/Development/Other/testmax \
  --source local \
  --repo /Users/yanghanwen/Development/Other/testmax \
  --manifest /Users/yanghanwen/Development/Other/testmax/skill-manifest.json \
  --host codex \
  --workspace /Users/yanghanwen/Development/Other/testmax

支持的宿主目录：

• ~/.codex/skills
• ~/.agents/skills
• ~/.claude/skills

默认是复制安装。开发联调可以加 --link 切成软链模式，后续用 testmax skill update 同步版本。

npm 分发

仓库同时提供一个 npm 发布物，包含 skill-manifest.json 和 .codex/skills/ 下的全部 skill，用于通过 npx 或全局安装完成 skill 落地。

npm install -g @yhanwen/testmax
testmax-skill list
testmax-skill install --host codex

发布前本地检查：

npm run pack:check

Core Capabilities

• 多系统、多环境共享一个 .testmax/testmax.sqlite
• 结构化测试用例和步骤断言
• suite 内串行、suite 间可并行的任务编排
• 基于 Playwright persistent context 的独立 profile 管理
• 浏览器与 API 混合任务执行
• 本地 Markdown/JSON 报告和 solution draft 生成
• 测试用例列表和测试任务列表的静态 HTML 页面导出
• 通过 .codex/skills/ 暴露多个平级测试 skill

Web Views

当用户想直接看测试用例列表或任务列表时，可以生成静态 HTML：

testmax web cases --root /Users/yanghanwen/Development/Other/testmax --suite-id 1
testmax web tasks --root /Users/yanghanwen/Development/Other/testmax --run-id 1

输出文件默认落在 .testmax/reports/。

Project Layout

• testmax/: Python runtime
• tests/: runtime regression tests
• .codex/skills/: skill families
• skill-manifest.json: skill distribution manifest
• docs/: schema、profile、runbook、report docs
• .testmax/: 本地状态目录