Skip to content

07 SDK Multi Surface ​

范围:

  • Web SDK 收口
  • future API SDK 预留继续细化
  • future App SDK 预留继续细化
  • 对外契约稳定性

约束:

  • web 端先落地;API 与 App 端面此后也已实现(sdk/packages/*、sdk/android、sdk/ios;验收记录见 sdk/ACCEPTANCE-M3.md / sdk/ACCEPTANCE-M4.md)
  • 各端面共享同一 contract core(sdk/packages/core)与 PROTOCOL fixtures

M1 web-sdk-completion ​

  • [x] 补 core capability negotiation 测试矩阵
  • [x] 补 reconnect policy 实现与测试
  • [x] 补 token refresh hook 实现与测试
  • [x] 补 react/vue/vanilla 对统一 contract 的 smoke tests
  • [x] 收敛当前 lint warning

验收:

  • Web SDK 达到可持续演进状态,不再依赖隐性行为

M2 api-sdk-reservation ​

  • [x] 在 api-client 中定义 server-side auth contract
  • [x] 定义 retry/backoff contract
  • [x] 定义 idempotency/request middleware contract
  • [x] 定义 bot/admin automation 使用示例

验收:

  • 后续做 server-to-server SDK 时可以直接沿用已有 contract

M3 app-sdk-reservation ​

  • [x] 在 app-core 中定义 offline queue contract
  • [x] 定义 push token registration contract
  • [x] 定义 reconnect/session restore contract
  • [x] 定义 mobile storage abstraction contract

验收:

  • 后续移动端 SDK 不会直接复制 Web SDK 结构

M4 surface-governance ​

  • [x] 定义 package 命名与发布策略
  • [x] 定义 public API 审核边界
  • [x] 增加 breaking change checklist
  • [x] 增加 examples 与 package README 对齐检查

验收:

  • SDK 对外 surface 有明确治理规则

M5 transport-evolution ​

  • [x] 细化 transport-http 包结构
  • [x] 细化 transport-websocket 包结构
  • [x] 预留 SSE / webhook callback transport contract
  • [x] 预留 API/App/Web 共享 serializer contract

验收:

  • transport 层成为真正独立能力,而不是 core 里的零散实现