贡献¶
在提交拉取请求之前,请先运行本地检查,并阅读桥接架构页面。
测试报告¶
通过 test:report:generate 生成的本地报告仍是独立的 HTML 文件。合并的 CI 报告使用单独的 HTML、JavaScript 和数据文件,以避免超过 GitHub 的文件大小限制。下载并解压整个 combined-test-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。