本技能面向 OpenSteer 项目中 Passwords broker 的开发与验证,适用于构建或测试原生 Passwords broker、导入 worker 或 Swift/TypeScript wire fixtures 的场景。
用途:在仓库根目录下构建开发版 broker,或运行聚焦于纯逻辑的 Swift 测试,以验证受影响的契约。
主要能力与命令:
- 构建开发版 broker:pnpm --filter @opensteer/desktop build:passwords-broker
- 运行纯逻辑 Swift 测试:swift test --package-path apps/desktop/native/passwords --skip "SecureEnclaveTests|SnapshotTests",可通过 --filter <class> 指定受影响的契约。
- 仅在有意变更契约时重新生成共享 wire fixtures:OPENSTEER_WRITE_WIRE_FIXTURE=1 swift test --package-path apps/desktop/native/passwords --filter WireFixtureTests,然后运行 pnpm exec vitest run packages/protocol/src/passwords-broker-wire.test.ts,并检查 apps/desktop/native/passwords/Tests/Fixtures/passwords-wire.json 的差异,保持旧条目可读。
约束与限制:
- 软件密钥与脚本化认证不得触发提示。
- AppKit SnapshotTests 只能通过 docs/testing.md 中描述的一次性 VM 工作流运行。
- SecureEnclaveTests 需要真实硬件,在 VM 中不合格;不得将跳过计为通过。
- 验证受保护的 keychain 行为时,使用 apps/desktop/SIGNING.md 进行签名发布构建。
- 密钥处理请阅读 apps/desktop/native/passwords/README.md;端到端验收使用保存登录流程(saved-login journey)。
证据产物:socket 证据默认写入 $TMPDIR/opensteer-passwords-broker-swift-e2e.json,可通过 OPENSTEER_PASSWORDS_BROKER_ARTIFACT 覆盖;窗口产物使用 OPENSTEER_PASSWORDS_UI_ARTIFACTS。产物仅在需要验收时保留。