New translations wish-export.md (English)

docs/en/features/wish-export.md

@@ -0,0 +1,100 @@
+---
+headerDepth: 0
+category:
+  - 功能
+  - 教程
+order: 2
+---
+
+# 祈愿记录
+
+抽卡是原神的核心玩法之一，无论是出于纪念、炫耀的目的还是认真规划抽取计划，对历史抽卡进行统计分析都是非常重要的。 但是原神官方只为玩家提供了半年的抽卡记录，这是很不友好的（~~但是他们还是统计了你一整年杀了多少提米的鸽子~~）。 但是原神官方只为玩家提供了半年的抽卡记录，这是很不友好的（~~但是他们还是统计了你一整年杀了多少提米的鸽子~~）。
+
+因此，我们需要利用这半年的抽卡记录调取窗口，将抽卡记录转移到我们自己手中，这就是胡桃工具箱中祈愿记录导出功能的目的所在。
+
+有关原神祈愿记录导出的技术原理，你可以参阅我们的[**祈愿系统与导出原理**](/advanced/Gacha-system-and-export-principal.md)一文。
+
+![祈愿导出](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01B2DDii1g6du87XIIG_!!1797064093.png)
+
+**如上图所示，从胡桃工具箱的祈愿导出功能，你可以清晰地获取到包括：抽卡总数、当前已垫抽数、不同稀有度获取的数量和百分比、 每次五星稀有度获取的抽数以及保底情况。**
+
+::: note 原神抽卡记录的延迟性
+胡桃工具箱获取抽卡记录的来源也为米哈游服务器，因此短时间内刚刚结束的抽卡无法被获取。 当你在游戏内抽卡历史记录中看到了最新的一批抽卡记录，则可以在胡桃中获取统计数据。 当你在游戏内抽卡历史记录中看到了最新的一批抽卡记录，则可以在胡桃中获取统计数据。
+
+:::
+
+## 视频指南
+对于大多数人而言，遵循本页文档会有更高的效率。
+
+但如果你对其中包含的操作不熟悉，也可以回到这里来跟着视频指南操作。 ::: details 胡桃工具箱指南 5 - 祈愿记录导出篇
+<BiliBili bvid="BV1QR4y1z7bH" />
+:::
+::: details 胡桃工具箱指南 5 - 祈愿记录导出篇
+<BiliBili bvid="BV1QR4y1z7bH" />
+:::
+
+## 获取祈愿数据
+### 利用 Stoken 从服务器获取最新的祈愿记录 <Badge text="推荐" type="tip" />
+
+::: info 提示
+- 已登录的米游社帐号是使用 Stoken 刷新方法的前提，你可以参考[米游社多帐号切换](mhy-account-switch.md)一文在胡桃工具箱中登录你的帐号
+- Stoken 刷新方法暂不支持国际服
+:::
+
+- 在胡桃工具箱中确保你需要获取记录的米游社帐号已登录
+- 从左侧菜单栏进入`祈愿记录`
+- 点击右上角的`刷新`，并点击`Stoken刷新`
+- 等待读取完毕，即可查看最新的祈愿记录
+
+### 从网页缓存获取最新的祈愿记录 <Badge text="支持国际服" type="tip" />
+
+- 从左侧菜单栏进入`祈愿记录`
+- 启动游戏并登入游戏，打开游戏内的祈愿历史记录
+- 回到胡桃工具箱，点击`刷新`按钮，在刷新菜单中点击`网页缓存刷新`
+
+::: tip
+若出现`网页缓存刷新`功能异常的情况：
+- 从胡桃工具箱的`设置`
+- 在`删除游戏内网页缓存`功能中执行删除操作
+:::
+
+### 通过输入 Url 获取祈愿记录 <Badge text="支持国际服" type="tip" />
+- 如果你通过其它工具获取到了你祈愿历史记录的 Url，可以选择`手动输入Url`并根据提示操作
+- 但应注意此类 Url **具有时效性**
+
+### 对于全量刷新选项的补充说明
+
+在默认情况下，胡桃工具箱会在匹配到本地已有记录的祈愿ID后停止导入。 但如果你希望完整地获取原神服务器中所有的历史记录（即使它已经存在于你的本地祈愿记录中），你可以勾选`全量刷新`。 但如果你希望完整地获取原神服务器中所有的历史记录（即使它已经存在于你的本地祈愿记录中），你可以勾选`全量刷新`。
+
+**不勾选`全量刷新`不会使你丢失祈愿数据，勾选`全量刷新`也不会让你的本地记录错误地额外记录一次相同的祈愿数据。**
+
+### 从其它祈愿导出程序导入祈愿数据 <Badge text="UIGF" type="info" />
+胡桃工具箱支持导入 `UIGF 数据格式` 的祈愿记录数据[^UIGF-Org]
+
+如果你希望导入这一类数据，可以：
+- 启动胡桃工具箱，从左侧菜单栏进入`祈愿记录`
+- 点击右上角的`导入`
+- 选择你的 UIGF Json 数据文件
+- 根据界面确认导入数据
+
+### 从 Snap Genshin 转移祈愿记录数据
+如果你希望从 Snap Genshin 中转移祈愿数据至胡桃工具箱，你可以：
+- 升级 Snap Genshin 到最新版本
+- 进入`祈愿记录`功能
+  - 如果你由于无法登录米游社而无法进入 Snap Genshin，可以在胡桃工具箱中登录米游社帐号并复制 Cookie 到 Snap Genshin
+- 点击右上角的功能菜单
+- 通过`导出 UIGF Json 文件`导出 Json 格式的祈愿记录
+- 在胡桃工具箱中导入该文件
+
+## 导出祈愿数据 <Badge text="UIGF" type="info" />
+
+胡桃工具箱支持导出 `UIGF数据格式` 的 Json 文件格式的祈愿记录数据
+
+如果你希望导出祈愿数据，可以：
+- 启动胡桃工具箱，从左侧菜单栏进入`祈愿记录`
+- 选择您要导出的祈愿记录存档
+- 点击`导出`按钮
+  - 在弹出的界面选择您需要将此导出的祈愿记录数据文件存放的位置，并点击`导出`
+- 导出完成
+
+[^UIGF-Org]: 统一标准化的原神数据格式由 [UIGF-Org](https://uigf.org/) 提供