用途:XL1 Testing 是测试与验证 XL1 工作的入口技能,负责把验证请求路由到正确的验证方式,记录各方式流程,并掌管 dApp 的 Definition of Done 完成门禁。它是 XYO 技能栈的第 7 层:xy-development(1) → xy-toolchain(2) → xyo-knowledge(3) → xl1-knowledge(4) → xl1-patterns(5) → xl1-dapp-kit(6) → xl1-testing(7) → xl1-scaffold(8) → xl1-build(9)。
主要能力:提供多种无头验证路径的选择与说明,包括无头测试网验证(Sequence,进程内助记词签名者,经 GatewayBuilder.buildRunner())、本地开发链验证(xl1 start chain + 进程内签名者)、通过 dApp Kit Vitest 的本地链(@xyo-network/dapp-kit-vitest-config local-xl1)、XYO 内部受限的 apiLocal(@xyo-network/xl1-vitest-config apiLocal)、本地链加 Aries 数据湖夹具、完整本地 XL1 dApp 栈(经典 aries-dapp-core 或 dapp-kit),以及无头浏览器模式测试(vitest browser mode + Playwright provider,MSW 模拟)。还涵盖通过 CLI 钱包无人值守驱动 Sequence 外部账户、以及用 Playwright 驱动真实 UI 或 XL1 钱包扩展(后者为 XYO 内部受限)。
dApp Definition of Done:在报告任何 XL1 dApp 工作完成前必须执行,逐项检查网关使用、数据湖设置、钱包集成、SDK 优先合规、载荷设计、索引器下限区块、提供者架构、显示约定、commit-reveal 正确性、结算权限、多方共签、架构原则、dApp Kit 与无头验证等规则与反模式,并在完成摘要中标注各相关部分的通过/失败。标记“(if applicable)”的章节仅在确实超出范围时可跳过,并需说明原因。它是三道完成门禁中的第 2 道;第 1 道为 xy-development 的通用 DoD,始终适用;第 3 道为 PRD.md 验收标准,仅在存在 PRD.md 时适用。
使用方式:先阅读本技能选择验证方式,再打开对应子文档获取完整流程。本地链启动可选 xl1 start(手动调试)、dapp-kit-vitest-config local-xl1(公开 CI/TDD 首选)或 xl1-vitest-config apiLocal(仅 XYO 内部)。应用组合可选经典 React/service + Aries reducer 发布,或 @xyo-network/dapp-kit* / xl1.dapp.json。这些方式可组合:用 CLI 钱包账户资助/操作 Sequence 账户,用无头测试网验证断言链交互,用浏览器 e2e 验证 UI。无头运行通过只证明链侧可用,不证明 UI 可用。
限制:默认仅面向测试网(sequence 或本地链),除非人工明确选择主网,否则常规或自动化运行不得访问 xl1-mainnet。种子与钱包密码属机密,不得提交、记录或回显;无人值守 CLI 钱包流程将密码存入操作系统钥匙串并自动解锁,属热钱包,仅可用于无价值测试代币。本地链使用简化开发共识且无 EVM 质押层,需在发布前于 Sequence 上确认。部分包(apiLocal、钱包 Playwright harness)为 XYO 内部受限。具体版本号需从本文件 frontmatter 的 metadata.version 读取。