SuperAPI AI 工具集

verify-passwords-broker

编程与开发

查看项目

更新于 11-03 23:38

技能介绍

本技能面向 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。产物仅在需要验收时保留。