表名	内容	类型	是否必要
统计分析	统计分析内容等	任意	否
角色活动祈愿	`gacha_type` : `301\|400` 的祈愿数据	祈愿表	否，但是应该导出
武器活动祈愿	`gacha_type` : `302` 的祈愿数据	祈愿表	否，但是应该导出
常驻祈愿	`gacha_type` : `200` 的祈愿数据	祈愿表	否，但是应该导出
新手祈愿	`gacha_type` : `100` 的祈愿数据	祈愿表	否，但是应该导出
原始数据	全部祈愿数据	数据表	详见下方原始数据表结构说明

表的顺序可以是任意的
可以隐藏部分表，防止用户随意篡改数据
Sheet 的名称应与游戏内祈愿记录页面显示的名称保持一致

App间应依据 原始数据表 的内容，来进行数据互通

祈愿表结构

本节内容是为了规范兼容分析类App

表头对应的内容填充顺序需要严格按照下方说明排布
共享保底的卡池按祈愿类型 (gacha_type) 区分
此类 Sheet 存在的目的，是为了便于用户观看与祈愿分析工具的分析

表头	内容	是否必要
时间	`yyyy-MM-dd HH:mm:ss` 格式的 `time` 时间	是
名称	`name`物品名称	是
物品类型	`item_type`	是
星级	`rank_type`	是
祈愿类型	`gacha_type` 的转义名称	是，尽管部分工具不会分析此项
...	...	否

如果你认为有必要的话，可以额外增加其他表头，但请确保表头的前几列为上表规范的内容
表内的数据通常按祈愿Id升序或降序排列，分析App不应假设表内的顺序为特定的升序与降序

`gacha_type` 转义名称

gacha_type	名称
100	新手祈愿
200	常驻祈愿
301	角色活动祈愿
400	角色活动祈愿-2
302	武器活动祈愿

示例

时间	名称	类别	星级	祈愿类型	...
2021-02-17 18:45:09	以理服人	武器	3	角色活动祈愿-2	...
...	...	...	...	...	...

原始数据表结构

导出时

App 在导出时应尽可能询问用户是否应包含原始数据表
一旦在工作簿内包含了名为 原始数据 的表，即表示支持本格式
该表内的内容应严格按照本格式所述填充
表头的顺序需严格按照下表设置。
现有的字段采用字典顺序递增排序，后续新增的字段依添加的顺序排在后侧。
若无特殊需求，我们建议导出所有json 数据内包含的字段

导入时

强烈建议您编写不依赖于列的顺序位置便可实现导入的程序，以达到最大化的兼容。
如果省略了其中某些非必要字段的值，请保持表头存在，对应的列则空置。

表头	是否必要
`count`	否，但是建议保留，不排除后续会有`count`不为1的情况
`gacha_type`	是
`id`	是，且大部分App按此字段排序数据
`item_id`	否，目前官方已经弃用了此字段
`item_type`	是
`lang`	否，但建议保留，以便国际化
`name`	是
`rank_type`	否，但建议保留，以便分析
`time`	否，但建议保留，以便分析
`uid`	否，但建议将选择权交予用户，保留以便分析
`uigf_gacha_type`	是

示例

count	gacha_type	id	item_id	item_type	lang	name	rank_type	time	uid	uigf_gacha_type
1	301	1613556360008291100		武器	zh-cn	以理服人	3	2021-02-17 18:45:09	123456789	301
...	...	...	...	...	...	...	...	...	...	...

Json 格式

Uniformed Interchangeable GachaLog Format standard of Json (UIGF.J)

Json 格式由于与从官方接口获取到的格式一致
更便于各App的导入与导出，我们也在此做出规范
该格式应仅用于各App间的数据互通

导出的格式

以同值字段提取至上层的思想，我们拟定了以下json格式

{
    "info" : {
        "uid" : "000000000",
        "lang" : "zh-cn",
        ...
    },
    "list" : [
        {
            "gacha_type": "000",
            "item_id": "",
            "count": "1",
            "time": "yyyy-MM-dd HH:mm:ss",
            "name": "以理服人",
            "item_type": "武器",
            "rank_type": "3",
            "id": "1600099200004770203",
            "uigf_gacha_type": "000",
        },
        ...
    ]
}

`info`

除了从 {gacha_item} 中提取的 uid,lang字段，还可以包含我们认可的以下字段

字段名	值	说明
`export_time`	导出时间 : `yyyy-MM-dd HH:mm:ss`
`export_timestamp`	导出UNIX时间戳	v2.2+
`export_app`	导出此份记录的App名称，详见下方表格
`export_app_version`	导出此份记录的App版本号
`uigf_version`	所应用的 `UIGF` 的版本,包含此字段以防 `UIGF` 出现中断性变更时，App无法处理

`uigf_version`

合法值

值	说明	兼容
`v2.0`	首个正式版本	v2.0
`v2.1`	简化了部分语言表述，与 v2.0在数据格式上完全一致	v2.1 and lower
`v2.2`	新增 `info.export_timestamp` 填充 UNIX 时间戳	v2.2 and lower

`export_app`

未实现导出支持的以 - 代替

导出 App	`export_app` 的值
biuuu/genshin wish export	`genshin-wish-export`
DGP Studio/Snap.Genshin	`Snap Genshin`
MUK/应急食品	`MUKGenshinTool`
Scighost/KeqingNiuza	-
Scighost/Xunkong	`Xunkong.Desktop`
sunfkny/genshin gacha export	`genshin-gacha-export`
TremblingMoeNew/DodocoTales	-
voderl/genshin gacha analyzer	-