项目数据集合用于保存结构化资料，例如道具目录、角色档案、任务、敌人参数或地点信息。数据表属于项目资源，会跟随项目分享、历史记录和成品构建，也可以由多个扩展按数据契约共同使用。
打开数据集合
进入 资产 → 数据集合。左侧列出项目数据表，右侧用于搜索、编辑字段和记录。首次使用时点击「新建数据表」，输入名称即可开始，不需要配置数据库服务。
设置表格列
打开一张表后点击「设置表格列」。每一列只需要填写显示名称并选择最合适的类型，稳定的内部字段名由 Studio 自动生成和维护。
| 列类型 | 适合内容 |
|---|
| 文字 / 长文字 | 名称、分类、说明、剧情介绍 |
| 数字 | 数量、价格、等级、排序 |
| 开关 | 是否可见、是否启用等二值状态 |
| 选项 | 从预设分类或状态中选择 |
| 图片 | 从项目图片中选择并显示缩略图 |
| 资源 | 选择图片、音频、视频或任意项目素材 |
| 颜色 | 使用取色器填写颜色 |
| 角色 | 关联项目中的角色 |
| 剧情片段 | 关联一个 Fragment |
编辑记录
数据表提供两种视图：
- 列表视图：逐条展开编辑，适合字段多、长文字或需要查看完整资源预览的数据。
- 表格视图：像电子表格一样分列查看，适合批量维护名称、数字、开关和选项。
点击新增按钮后，Studio 会为记录生成不可修改的稳定 id。这个编号用于扩展引用，重命名表格、调整列顺序或编辑内容都不会改变它。
列表视图中的修改可以逐条保存或撤销。删除记录和数据表无法恢复，操作前建议先创建项目历史快照。
运行时策略
每张表可以决定成品游戏如何处理运行时修改：
| 策略 | 行为 | 适合场景 |
|---|
| 只允许读取 | 游戏读取基础数据，不允许写入 | 道具定义、角色目录、关卡参数 |
| 关闭游戏后还原 | 修改只在本次运行有效 | 临时计算结果、当前会话缓存 |
| 跟随玩家存档 | 每个存档分别保存修改 | 当前任务、背包数量、剧情进度 |
| 所有存档共用 | 修改跨存档保留 | 图鉴解锁、全局成就、周目资料 |
与扩展共用数据
扩展可以声明自己需要的数据契约。打开项目时，Studio 会寻找兼容数据表并自动绑定；没有兼容表时，可以按扩展模板创建。多个扩展声明同一份兼容契约后，可以读取或更新同一张表，而不需要各自复制数据。
出现以下情况时，数据集合页会显示待处理提示：
- 找不到扩展要求的数据表；
- 同时存在多张兼容表，需要选择绑定目标；
- 已绑定表的契约版本不兼容；
- 数据表被删除或绑定失效。
绑定只表示扩展可以使用这张表。扩展不会拥有数据表，卸载扩展也不会自动删除项目数据。
扩展开发者请继续阅读项目数据库 API。
分享与构建
数据集合文件保存在项目的 databases/ 目录，并参与资源扫描、项目历史、协作和构建。图片或资源列引用的素材也会参与路径迁移与打包检查。
把「数据定义」和「玩家状态」分开：只读表保存道具名称、图片和价格等定义，跟随存档的表只保存玩家持有数量和状态。这样更容易维护，也方便多个扩展复用目录数据。
不要在系统文件管理器中随意修改 databases/ 内的 JSON 文件。需要调整列、记录、策略或扩展绑定时，请回到 Studio 的数据集合页面操作。
