管理数据表

从桌面打开「数据库」，可以查看当前用户创建的全部逻辑数据表，包括手动创建和 Agent 创建的表，不受应用绑定范围限制。其它用户的数据不会出现在这里。

数据表与记录

左侧可以搜索数据表、新建数据表；选择一张表后，右侧以表格展示记录。支持搜索文本、点击列标题排序、切换每页 10 / 25 / 50 / 100 条以及前后翻页。

记录由服务端分页返回，不会一次下载整张表。搜索只覆盖 string 字段。勾选「系统字段」可以查看记录 ID、创建时间和更新时间。

「新增记录」和每行的编辑按钮提供与字段类型匹配的输入控件。JSON 内容需要符合 JSON 语法；数字、布尔值和日期时间按照实际类型保存。删除记录需要再次确认。

字段管理

点击「管理字段」可以修改表名、添加字段、重命名字段、调整字段类型和必填状态、调整顺序或删除字段。

• 每张表保留 1 至 50 个字段。名称最多 64 个字符，以中英文字母或下划线开头，后续可以包含数字。
• 字段名称不能重复，也不能使用 id、table_id、created_at、updated_at 等系统保留名称。
• 重命名会同步迁移已有记录中的键，保留值及其类型。依赖旧字段名的应用源码需要同步修改。
• 新增可选字段不会自动填充历史记录。新增必填字段之前，应先以可选字段添加并补充历史值，再设置必填。
• 类型调整不会自动转换数据。已有值与目标类型不兼容时，整次更新会被拒绝，并提示需要处理的记录。
• 删除字段会永久移除所有记录中该字段的值，保存前必须确认。

表结构与记录迁移在同一事务内完成，更新失败不会只修改一部分。两个页面同时编辑时，过期版本会被拒绝；取消编辑、刷新后可以根据最新结构重新修改。

宿主开发接口

以下接口用于宿主和开发工具，不属于应用的 platform.data JSB。用户应用仍不能修改 schema。

PUT /api/tables/DATASET_ID/schema
Content-Type: application/json

{
  "name": "待办",
  "expected_updated_at": "从 GET /api/tables/DATASET_ID 获取的 updated_at",
  "fields": [
    { "source": "title", "name": "name", "type": "string", "required": true },
    { "source": "done", "name": "done", "type": "boolean" },
    { "name": "note", "type": "string" }
  ]
}

fields 是最终完整字段列表。已有字段必须提供原字段名称 source，新字段省略 source；未保留的原字段会被删除。数组顺序就是表格列顺序。成功返回最新数据表，版本冲突返回 HTTP 409。

记录新增和修改接口可以携带 X-Table-Version（表的 updated_at）检查 schema 版本；修改接口也支持 If-Match（带引号的记录 updated_at）检查记录版本。数据库页面会自动携带这些信息。