.meta 资源元信息

.meta 是 SuccApp CLI / SuccApp for VS Code 将服务器元数据同步到本地工作区时生成的目录级索引。它记录同一目录下直接子资源的资源 id、版本、描述、排序、图标、隐藏状态等元信息；服务器数据库中没有名为 .meta 的业务文件。

需要查看完整 JSON 结构、字段含义、可编辑性和 option 子字段时，优先阅读 DTS。

存放方式

每个 .meta 只描述它所在目录的直接子文件和子目录。文件资源和目录资源自身的元信息，都写在父目录 .meta 的同名 key 下；子目录内部的 .meta 继续描述该子目录自己的直接子资源。

例如 /DEMO/app/DEMO.app/index.tpg 的资源元信息保存在：

DEMO/app/DEMO.app/.meta

示例结构：

{
	"index.tpg": {
		"id": "UfOoq4xbolMgpuFPItTdcE",
		"order": 6,
		"creator": "admin",
		"createTime": 1567404411123,
		"modifier": "system",
		"modifyTime": 1658473419755
	}
}

本地刚新建的资源可能暂时没有对应 .meta 条目；首次 push 成功后，SuccApp 会按服务器返回结果刷新所在目录的 .meta。

DTS 入口

• 根结构：types/meta/file-types/dot-meta.d.ts
• 文件类型入口：types/meta/file-types/index.d.ts
• 图片填充类型：types/api/succ.types.d.ts

编辑边界

通常只有在调整资源描述、图标、排序、隐藏状态、标签、自定义属性，或手工移动、重命名资源时，才需要关注 .meta。id、revision、创建人、修改人和时间戳等服务器字段以服务器为准，不要通过修改本地 .meta 改变资源身份。

移动或重命名文件时，检查原父目录和目标父目录的 .meta；移动或重命名目录时，目录内部 .meta 会随目录整体移动，但目录自身的条目仍在父目录 .meta 中。推送前应确认 .meta 是合法 JSON，避免影响同步和冲突判断。