---
name: world_snapshot
description: world_snapshot 模块技能文档——世界快照管理（世界状态快照生成、查询与恢复）。
---

# world_snapshot 模块

世界状态快照模块，聚合世界 + 场景 + 实体当前状态生成快照，支持查询与恢复。

## 数据模型
表 `world_snapshot`：id、world_id、name、snapshot_type、snapshot_json、status、snapshot_date(date)、created_at。

## 关键接口
- create_snapshot / restore_snapshot / list_snapshots / get_snapshot / update_snapshot / delete_snapshot
- 下拉：list_worlds_for_snapshot / list_snapshot_types / list_snapshot_statuses

## 陷阱
- 库名禁止硬编码，统一 get_module_dbname("world_snapshot")
- dspy 无 import
- create_snapshot 必须设置 created_at/snapshot_date
- snapshot_date 用 date 类型（业务日期仅到天）