LoginGet Started

Snapshots

为记忆提供版本控制。保存状态并随时恢复到任意时间点。

Snapshots 仪表盘，展示 Snapshot 列表及恢复选项

什么是 Snapshots？

Snapshots 是内存 Spaces 的时间点副本。就像代码的 Git 提交一样，Snapshots 让你能够：

  • 保存知识库的当前状态
  • 使用合并或替换模式恢复到以前的状态
  • 在恢复操作前自动创建备份
  • 在重大变更前创建检查点

分步指南

1

创建 Snapshot

在进行变更前保存 Space 的当前状态。

# 询问 Claude：

"Create a snapshot of my API-Docs space called 'Before Migration'"

Claude 将创建一个包含该 Space 中所有条目的 Snapshot。

2

查看 Snapshots 列表

查看所有可用的 Snapshots，了解你有哪些备份。

# 询问 Claude：

"Show me all my snapshots"

你将看到包含 Snapshot 名称、描述、创建日期和条目数量的列表。

3

恢复 Snapshot

将记忆恢复到以前的状态。可选择两种模式：

合并模式（默认）

添加 Snapshot 中缺失的条目，不删除当前条目。适合找回已删除的内容。

替换模式

删除所有当前条目，精确恢复 Snapshot 中的内容。完整回滚。

# 合并模式（安全）：

"Restore the 'Before Migration' snapshot using merge mode"

# 替换模式（完整回滚）：

"Restore the 'Before Migration' snapshot using replace mode"

自动备份：ContextForge 在每次恢复操作前自动创建备份 Snapshot，因此你随时可以撤销恢复操作。

4

删除 Snapshot

删除不再需要的 Snapshots 以释放存储空间。

# 询问 Claude：

"Delete the 'Before Migration' snapshot"

示例对话

你：

"我准备清理 API-Docs Space，请先创建一个备份。"

Claude：

已从 API-Docs Space 创建包含 47 个条目的 Snapshot "Backup-2026-01-15"。

你：

"删除所有标记为 'deprecated' 的条目"

Claude：

已删除 12 个标记为 'deprecated' 的条目。

你：

"等等，我需要找回其中一些。用合并模式恢复备份。"

Claude：

已自动创建备份。从 Snapshot 恢复了 12 个条目（合并模式——现有条目已保留）。

MCP 工具参考

memory_snapshot_create

创建当前内存状态的新 Snapshot。

名称类型描述
space_idstring要快照的 Space UUID（必填）
namestringSnapshot 名称（必填）
descriptionstring?可选描述
memory_snapshot_list

列出所有可用的 Snapshots。

名称类型描述
space_idstring?按 Space 筛选（可选）
memory_snapshot_restore

将内存恢复到以前的 Snapshot 状态。

名称类型描述
snapshot_idstring要恢复的 Snapshot UUID（必填）
modestring?"merge"（默认）或 "replace"
memory_snapshot_delete

永久删除一个 Snapshot。

名称类型描述
snapshot_idstring要删除的 Snapshot UUID（必填）

使用场景

重大变更前

在批量导入、清理操作或重组 Spaces 之前创建 Snapshot。

项目里程碑

在项目关键阶段保存 Snapshots，为将来的参考保留上下文。

实验探索

放心尝试不同的知识组织策略，随时可以回滚。

团队交接

在团队成员之间移交项目时创建版本化的 Snapshots。

最佳实践

  • 1

    使用带日期的描述性名称

    包含上下文信息："Pre-API-Migration-2026-01-15" 或 "Before-Cleanup"

  • 2

    部分恢复优先使用合并模式

    使用合并模式找回特定的已删除条目，同时不丢失新增内容

  • 3

    定期清理旧 Snapshots

    删除不再需要的 Snapshots，以保持在计划限额之内

  • 4

    善用自动备份功能

    ContextForge 在每次恢复前都会自动创建备份，因此你随时可以撤销

计划限额

Free

0

Snapshots 不可用

Pro

50

个 snapshots

Enterprise

无限制

个 snapshots