展开本页目录
开始前准备什么
- Node.js 24 和 npm。
- 下载并解压本页的复现包。样例在本机运行。
- 准备样例
- 运行脚本
- 对照结果
- 核对自己的应用
下载脚本和完整输出
包含版本锁定文件、操作说明、运行脚本和原始输出。
操作步骤
- 解压样例,在解压目录运行 npm ci 和 node ag-ui.mjs,把输出中的 history 段单独保存。
- 对照 initialIds 和 sdkIds。样例预先放入旧助手消息 a-1 和临时用户消息 u-temp,服务端则发送 u-1、a-1 的完整有序快照。
- 在 onMessagesSnapshotEvent 记录 event.messages。该样例把服务端快照用作独立的渲染输入,实际得到 u-1、a-1,且助手内容更新成「库存还有 7 件」。
- 如果项目支持分页历史,只有完整快照才能替换完整列表。还有未确认的本地消息时,先按客户端请求 ID 与服务端 ACK 关联,再归入已确认历史。
关键代码
ag-ui.mjs
javascript
let authoritativeSnapshot;
await agent.runAgent({}, {
onMessagesSnapshotEvent({ event }) {
authoritativeSnapshot = event.messages;
},
});
const renderIds = authoritativeSnapshot.map(message => message.id);实测结果
| 检查点 | 实际 ID 顺序 |
|---|---|
| 本地初始 | a-1 → u-temp |
| SDK 合并后 | a-1 → u-1 |
| 直接按服务端快照渲染 | u-1 → a-1 |
- 检查点
- 本地初始
- 实际 ID 顺序
- a-1 → u-temp
- 检查点
- SDK 合并后
- 实际 ID 顺序
- a-1 → u-1
- 检查点
- 直接按服务端快照渲染
- 实际 ID 顺序
- u-1 → a-1
怎样确认已经完成
- 比对三份 ID 列表,定位顺序最先变化的位置。
- 核对已确认消息的正文和顺序。
- 局部快照保留未包含的分页历史。
常见问题
升级 SDK 后还需要保留这项检查吗?
需要用你的 SDK 版本和历史数据重跑。上表记录 @ag-ui/client 1.0.5 对这份特定输入的行为。
