接入前的最小闭环

接入前的最小闭环

先把一个客户端与一个 host 的状态闭环跑通,再增加第二个客户端。这样遇到分歧时,能区分是本地 reducer、传输恢复还是并发裁决的问题。

1. 固定规范与 SDK

从官方仓库选取与你的语言相符的 SDK,并记录 SDK 版本及所支持的规范版本。本站内容依据 spec/v1.1.0;不要把不同 SDK 的相似版本号当作兼容性保证。

2. 明确能力边界

基础会话同步与可选功能需要分开处理。自动化、终端等能力应以双方实际握手结果为准。未协商的功能不显示为可用;客户端遇到不支持能力时,应给出可理解的反馈。

3. 验证一次状态变化

建立会话连接后取得起始状态,提交一个受支持动作,观察 host 裁决,并让客户端从 pending 收敛到已确认结果。记录关联标识与结果,日志中只保留排障所需信息,避免记录用户凭据或整段敏感会话。

4. 加入第二个客户端

检查两端是否得到相同的权威状态。随后同时执行会影响同一个对象的操作,确认它们遵循 host 的裁决,而不是各自成功后一直显示不同结果。

5. 断线后恢复

动作发出后立即断开连接,再重连。分别覆盖 host 尚未接收、host 已处理但客户端未见回显两种情况。恢复时协调 pending,不能直接重发所有本地操作。

以上是集成验收步骤,不包含假定可直接调用的协议端点。具体连接与消息 API 请从官方文档进入固定版本。继续阅读可靠性清单。

最后更新于