跳转至

贡献

在提交拉取请求之前,请先运行本地检查,并阅读桥接架构页面。

npm install
npm run check

测试报告

通过 test:report:generate 生成的本地报告仍是独立的 HTML 文件。合并的 CI 报告使用单独的 HTML、JavaScript 和数据文件,以避免超过 GitHub 的文件大小限制。下载并解压整个 combined-test-report 构件,然后打开其目录:

npm run test:report:open -- --report /path/to/extracted-report

对于多文件报告,此命令会启动已安装的 Allure 查看器。查看报告时请保持其运行,按 Ctrl+C 停止。GitHub Pages 发布会将报告资源保存在单独的报告仓库中。

Pull Request 检查清单

  • npm run check 通过测试。
  • 新的桥接行为已通过测试。
  • 上游 Playwright MCP 模式、描述和响应保持不变。
  • 用户可见的变更已记录在案。
  • CHANGELOG.md 已针对用户可见的变更进行更新。
  • 涉及安全敏感的变更已在 PR 描述中注明。

切勿这样做

  • 请勿重新引入已移除的原生浏览器适配器、工具注册表或功能模型。
  • 请勿将运行时日志写入 stdout;stdio 专用于 MCP JSON-RPC。
  • 除非被运行时或测试导入,否则不要添加依赖项。
  • 不要为了让更改通过而降低 TypeScript、ESLint 或 Prettier 的配置标准。
  • 请勿提交 dist/、coverage/、 artifacts/、site/、 .venv-docs/,或 node_modules/。

安全问题

请通过 GitHub 安全公告报告漏洞,而非公开问题。请参阅 SECURITY.md。