SaveSlot 文档

核心概念

可信度、版本与冲突

SaveSlot 里的每个值都说明了它有多确定。Agent 读值时连同标记一起读,所以能分清测量值和猜测。

四种可信度标记

标记含义例子
已确认由数据源测得,或由你确认Apple Health 的睡眠时长;包装上标注的热量
推断Agent 估计的,没有测量一碗面「大约 650 千卡」
未知还没人给这个字段赋值Agent 读到的是「空」,而不是 0
冲突两个来源对不上,还没人裁定体重秤记 73.0 公斤,你跟 Agent 说的是 72.4 公斤

你确认或纠正之后,推断值就变成已确认。

「过期」不是第五种标记。一个值可以是已确认的,但已经很旧;Agent 能看到它的生效时间,自己判断够不够新。

版本

纠正从不覆盖。它新增一个版本,旧值保留,并记下谁改的、什么时候、从哪改的。

  • 在「数据」里打开一条记录,查看它的版本历史。
  • 恢复会把某个旧值作为一个新版本加回来,历史本身不会被改写。
  • 属于未解决冲突的版本,要等冲突处理完才能恢复。

冲突

两个来源对不上时,SaveSlot 不替你选。这条记录会标为冲突,并且:

  • 每个读到它的 Agent 都会看到两个值和冲突标记,不会把任何一个当成事实;
  • 工作台首页的「需要处理」和记录本身都会显示它;
  • 你点「以这个为准」选出正确的值,之后所有 Agent 读到的都是你选的。处理完可以立即撤销。

Agent 也能用 saveslot_pending 工具看到待处理的冲突,并在你告诉它哪个对之后用 saveslot_resolve 处理。见 MCP 工具。

值从哪来

每条记录都列出来源:Garmin 这样的数据源、「Claude · 网页」这样的 Agent 连接,或者你本人。Agent 可以用 saveslot_sources 查询来源,它还能预览删除会影响哪些数据。