From 5f9bc2b2f5f5824448bca18abedde78c75728e9b Mon Sep 17 00:00:00 2001
From: Masterain <i@irain.in>
Date: Sat, 25 Feb 2023 04:00:30 -0800
Subject: [PATCH] New translations Gacha-system-and-export-principal.md
 (English, United States)

---
 .../Gacha-system-and-export-principal.md.md   | 63 +++++++++++++++++++
 1 file changed, 63 insertions(+)
 create mode 100644 docs/en/advanced/Gacha-system-and-export-principal.md.md

diff --git a/docs/en/advanced/Gacha-system-and-export-principal.md.md b/docs/en/advanced/Gacha-system-and-export-principal.md.md
new file mode 100644
index 000000000..513fec965
--- /dev/null
+++ b/docs/en/advanced/Gacha-system-and-export-principal.md.md
@@ -0,0 +1,63 @@
+---
+headerDepth: 0
+category:
+  - FAQ
+icon: read
+---
+
+# 祈愿系统与导出原理
+> Gacha System and Principal
+
+
+胡桃的祈愿系统相较 Snap Genshin 进行了整体架构上的重新设计。
+
+本文将解释原神的祈愿记录机制和胡桃工具箱中祈愿导出功能的技术原理。
+
+## 祈愿的获取
+
+获取祈愿记录需要请求米哈游的API
+
+关于此API, 有下列几个注意点
+* 通过米哈游服务器的API，只能查询到过去6个月内的祈愿记录
+  * 这也是原神客户端中祈愿记录的来源
+* API存在请求速率限制，过快的请求会导致后续的请求失败，无法正常获取数据
+
+为了请求此API，我们需要四个关键参数
+
+- 目前有下列几种方法可以获取这些参数
+  * 遍历 Unity 的日志文件，查找用户打开的祈愿记录URL
+  * 代理本机流量，筛选祈愿记录URL
+  * 查找 CefBrowser 的浏览器缓存，找到祈愿记录URL
+  * 对于包含了Stoken的Cookie，调用genAuthKey API,获取参数
+  * 高级用户手动输入相关URL
+
+在请求API后可以获取到零散的祈愿记录，在对其进行拼接后即可获得一份完整的祈愿记录列表
+
+## 祈愿的存储
+
+获得完整的祈愿记录列表后即可将其简单的序列化入本地数据库内，在需要时可从数据库中反序列化出来呈现给用户。
+
+后续的对服务器的请求只需要对比数据库中的数据请求新增的部分即可。
+
+这样，用户即可长期地保存帐号的完整祈愿记录
+
+## UIGF格式
+> 统一可交换祈愿记录标准
+> 
+> Uniformed Interchangeable GachaLog Format standard
+
+UIGF 是由我们联合其他祈愿记录应用倡导、推出并**持久维护**的一个统一的祈愿记录数据交换标准
+
+标准化的数据格式将允许用户将祈愿记录在不同的转移数据，以使用到不同原神工具中各自的特色功能
+
+### 祈愿的导入
+
+在使用 UIGF 数据格式的前提下，可以导入曾在其他应用中储存的数据
+
+胡桃在处理导入时，会对比本地储存中存在的最早的索引（ID）并仅导入较老的数据
+
+（因为始终可以从米哈游的服务器获取较新的数据，这种原始数据有更高的精确度）
+
+### 祈愿的导出
+
+~~尚未实现，正在设计~~ 已实装
\ No newline at end of file