⬆️ 更新 UIGF 版本

close #96,close #95
2025-12-06 08:32:51 +08:00 · 2024-03-13 15:52:11 +08:00
parent 094f7b69fe
commit a3f4156ba8
2 changed files with 95 additions and 96 deletions
--- a/README.md
+++ b/README.md
@@ -2,12 +2,12 @@
 Author: 目棃
 Description: 说明文档
 Date: 2023-03-05
-Update: 2024-01-30
+Update: 2024-03-13
 ---

 > 本文档 [`Frontmatter`](https://github.com/BTMuli/MuCli#Frontmatter) 由 [MuCli](https://github.com/BTMuli/Mucli) 自动生成于 `2023-03-05 14:41:55`
 >
-> 更新于 `2024-01-30 13:25:48`
+> 更新于 `2024-03-13 15:51:39`

 ![](https://img.shields.io/github/last-commit/BTMuli/TeyvatGuide?style=for-the-badge) ![](https://img.shields.io/github/commits-since/BTMuli/TeyvatGuide/latest?include_prereleases&style=for-the-badge)

@@ -47,8 +47,8 @@ Game Tool for Genshin Impact player, supports Windows and macOS.
  - [x] 游戏内公告&活动获取
  - [x] 米游社官方帖获取（支持通过 ID 获取）
  - [x] 米游社各分区帖子获取（支持通过 ID 获取）
-  - [x] 成就管理（UIAF），支持 [`YaeAchievement`](https://github.com/HolographicHat/YaeAchievement) 导入
-  - [x] 祈愿管理（UIGF）
+  - [x] 成就管理（UIAF v1.1），支持 [`YaeAchievement`](https://github.com/HolographicHat/YaeAchievement) 导入
+  - [x] 祈愿管理（UIGF v3.0）

 - 登陆功能：

@@ -88,7 +88,7 @@ Game Tool for Genshin Impact player, supports Windows and macOS.
 - Changelog: [CHANGELOG](CHANGELOG.md)
 - 资源来源：[项目资源说明](docs/项目资源说明.md)
 - UIAF：[UIAF v1.1](docs/UIAF.md)
- UIGF：[UIGF v2.4](docs/UIGF.md)
+- UIGF：[UIGF v3.0](docs/UIGF.md)

 ## 特定项目 / Special Project

--- a/docs/UIGF.md
+++ b/docs/UIGF.md
@@ -2,23 +2,23 @@
 Author: 目棃
 Description: UIGF v2.4 Backup
 Date: 2023-11-15
-Update: 2023-11-15
+Update: 2024-03-13
 ---

 > 本文档 [`Frontmatter`](https://github.com/BTMuli/MuCli#Frontmatter) 由 [MuCli](https://github.com/BTMuli/Mucli) 自动生成于 `2023-11-15 20:58:36`
 >
-> 更新于 `2023-11-15 20:58:36`
->
-> 本文档为 [UIGF v2.4](https://github.com/UIGF-org/UIGF-org.github.io/blob/main/docs/zh/standards/UIGF.md) 的备份，仅供参考。
+> 更新于 `2024-03-13 15:50:36`

-# 统一可交换抽卡记录标准 v2.4
+> 本文档为 [UIGF v3.0](https://github.com/UIGF-org/UIGF-org.github.io/blob/main/docs/zh/standards/UIGF.md) 的备份，仅供参考。

-> Uniformed Interchangeable GachaLog Format standard (UIGF) v2.4 <Badge text="Current" type="message" />
+# 统一可交换抽卡记录标准 v3.0
+
+> Uniformed Interchangeable GachaLog Format standard (UIGF) v3.0 <Badge text="Current" type="message" />
 >
 > ::: warning UIGF 标准使用声明
 > 应用必须在同时支持 UIGF 数据格式**导入**和**导出**功能并在相关功能区域或文档中提供跳转至 [UIGF-Org](https://uigf.org) 的超链接后声明支持 UIGF 格式

-仅包含导入功能降低了用户数据可流通性，且将数据至于用户不可控的风险中，不符合 UIGF-Org 设计的初衷。
+仅包含导入或导出功能降低了用户数据可流通性，且将数据至于用户不可控的风险中，不符合 UIGF-Org 设计的初衷。
 :::

 ## 更新记录
@@ -29,12 +29,13 @@ Update: 2023-11-15
 | `v2.1`                        | 简化了部分语言表述，与 v2.0在数据格式上完全一致            | v2.1 and lower |
 | [`v2.2`](UIGF-legacy-v2.2.md) | 新增 `info.export_timestamp` 填充 UNIX 时间戳              | v2.2 and lower |
 | [`v2.3`](UIGF-legacy-v2.3.md) | 扩充至非中文语境，使用 Json Schema 表述。移除了 Excel 格式 | v2.3 and lower |
-| `v2.4`                        | 新增 `info.region_time_zone` 支持时区处理                  | v2.4 and lower |
+| [`v2.4`](UIGF-legacy-v2.4.md) | 新增 `info.region_time_zone` 支持时区处理                  | v2.4 and lower |
+| `v3.0`                        | 新增 集录祈愿类型支持                                      | v3.0 and lower |

-### v2.4 更新内容
+### v3.0 更新内容

- 国际化兼容性增强
-  - 在 `info` 对象中新增了 `region_time_zone` 字段
+- `gacha_type` 增加新枚举项
+  - 在 `gacha_type` 枚举新增值为 `500` 的项，用于表示集录祈愿类型

 ## `info` 字段说明

@@ -79,6 +80,7 @@ App 不应假定 `region_time_zone` 的值为上表中给出的值，应具有
 | `200`             | `200`          |
 | `301`             | `301` or `400` |
 | `302`             | `302`          |
+| `500`             | `500`          |

 ### `item_id`

@@ -90,102 +92,99 @@ App 不应假定 `region_time_zone` 的值为上表中给出的值，应具有

 ```json
 {
-  "root": {
-    "type": "object",
-    "properties": {
-      "info": {
+  "type": "object",
+  "properties": {
+    "info": {
+      "type": "object",
+      "properties": {
+        "uid": {
+          "type": "string",
+          "title": "导出记录的 UID"
+        },
+        "lang": {
+          "type": "string",
+          "title": "语言 languagecode2-country/regioncode2"
+        },
+        "export_timestamp": {
+          "type": "number",
+          "title": "导出 UNIX 时间戳（秒）"
+        },
+        "export_time": {
+          "type": "string",
+          "title": "导出时间",
+          "description": "yyyy-MM-dd HH:mm:ss"
+        },
+        "export_app": {
+          "type": "string",
+          "title": "导出 App 名称"
+        },
+        "export_app_version": {
+          "type": "string",
+          "title": "导出 App 版本"
+        },
+        "uigf_version": {
+          "type": "string",
+          "title": "UIGF 版本号",
+          "pattern": "v\\d+\\.\\d+"
+        },
+        "region_time_zone": {
+          "type": "number",
+          "title": "区域时区偏移"
+        }
+      },
+      "required": ["uid", "uigf_version"],
+      "title": "UIGF 导出信息"
+    },
+    "list": {
+      "type": "array",
+      "items": {
        "type": "object",
        "properties": {
-          "uid": {
+          "uigf_gacha_type": {
            "type": "string",
-            "title": "导出记录的 UID"
+            "title": "UIGF 卡池类型",
+            "description": "用于区分卡池类型不同，但卡池保底计算相同的物品"
          },
-          "lang": {
+          "gacha_type": {
            "type": "string",
-            "title": "语言 languagecode2-country/regioncode2"
+            "title": "卡池类型"
          },
-          "export_timestamp": {
-            "type": "number",
-            "title": "导出 UNIX 时间戳（秒）"
-          },
-          "export_time": {
+          "item_id": {
            "type": "string",
-            "title": "导出时间",
-            "description": "yyyy-MM-dd HH:mm:ss"
+            "title": "物品的内部 ID"
          },
-          "export_app": {
+          "count": {
            "type": "string",
-            "title": "导出 App 名称"
+            "title": "个数，一般为1"
          },
-          "export_app_version": {
+          "time": {
            "type": "string",
-            "title": "导出 App 版本"
+            "title": "获取物品的时间"
          },
-          "uigf_version": {
+          "name": {
            "type": "string",
-            "title": "UIGF 版本号",
-            "pattern": "v\\d+\\.\\d+"
+            "title": "物品名称"
          },
-          "region_time_zone": {
-            "type": "number",
-            "title": "区域时区偏移"
+          "item_type": {
+            "type": "string",
+            "title": "物品类型"
+          },
+          "rank_type": {
+            "type": "string",
+            "title": "物品等级"
+          },
+          "id": {
+            "type": "string",
+            "title": "记录内部 ID"
          }
        },
-        "required": ["uid", "uigf_version"],
-        "title": "UIGF 导出信息"
+        "required": ["uigf_gacha_type", "gacha_type", "id", "item_id", "time"],
+        "title": "UIGF 物品"
      },
-      "list": {
-        "type": "array",
-        "items": {
-          "type": "object",
-          "properties": {
-            "uigf_gacha_type": {
-              "type": "string",
-              "title": "UIGF 卡池类型",
-              "description": "用于区分卡池类型不同，但卡池保底计算相同的物品"
-            },
-            "gacha_type": {
-              "type": "string",
-              "title": "卡池类型"
-            },
-            "item_id": {
-              "type": "string",
-              "title": "物品的内部 ID"
-            },
-            "count": {
-              "type": "string",
-              "title": "个数",
-              "description": "一般为1"
-            },
-            "time": {
-              "type": "string",
-              "title": "获取物品的时间"
-            },
-            "name": {
-              "type": "string",
-              "title": "物品名称"
-            },
-            "item_type": {
-              "type": "string",
-              "title": "物品类型"
-            },
-            "rank_type": {
-              "type": "string",
-              "title": "物品等级"
-            },
-            "id": {
-              "type": "string",
-              "title": "记录内部 ID"
-            }
-          },
-          "required": ["uigf_gacha_type", "gacha_type", "id", "item_id", "time"],
-          "title": "UIGF 物品"
-        },
-        "title": "物品列表"
-      }
-    },
-    "required": ["info", "list"],
-    "title": "UIGF 根对象"
-  }
+      "title": "物品列表"
+    }
+  },
+  "required": ["info", "list"],
+  "title": "UIGF 根对象"
 }
 ```