diff --git a/docs/.vuepress/public/images/202209/wish-export.png b/docs/.vuepress/public/images/202209/wish-export.png new file mode 100644 index 000000000..a517b349c Binary files /dev/null and b/docs/.vuepress/public/images/202209/wish-export.png differ diff --git a/docs/.vuepress/sidebar/zh.ts b/docs/.vuepress/sidebar/zh.ts index cbbc3c09d..28b6b83c3 100644 --- a/docs/.vuepress/sidebar/zh.ts +++ b/docs/.vuepress/sidebar/zh.ts @@ -14,6 +14,13 @@ export const zhSidebar = sidebar({ prefix: "documents/features/", children: "structure" }, + { + icon: "ask", + text: "常见问题", + prefix: "documents/FAQ/", + children: ["most-frequent-questions.md", "Gacha-system-and-export-principal.md"] + //children: "structure" + }, { icon: "article", text: "声明和公告", diff --git a/docs/documents/FAQ/Gacha-system-and-export-principal.md b/docs/documents/FAQ/Gacha-system-and-export-principal.md new file mode 100644 index 000000000..c22903089 --- /dev/null +++ b/docs/documents/FAQ/Gacha-system-and-export-principal.md @@ -0,0 +1,60 @@ +--- +headerDepth: 0 +--- + +# 祈愿系统与导出原理 +> 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 diff --git a/docs/documents/FAQ/most-frequent-questions.md b/docs/documents/FAQ/most-frequent-questions.md new file mode 100644 index 000000000..ffa82dd06 --- /dev/null +++ b/docs/documents/FAQ/most-frequent-questions.md @@ -0,0 +1,9 @@ +--- +headerDepth: 2 +--- + +# 快速解答 + +## Windows 10 下程序乱码 +当用户在 Windows 10 下使用胡桃且发现有乱码情况时,可以下载 `Segoe Fluent Icons`字体,并为系统所有用户安装,即可解决问题 + diff --git a/docs/documents/features/achievements.md b/docs/documents/features/achievements.md index 7e3c3e7bf..180a18cea 100644 --- a/docs/documents/features/achievements.md +++ b/docs/documents/features/achievements.md @@ -2,7 +2,7 @@ headerDepth: 0 --- -# 成就管理 +# 成就管理 ![](https://image.snapgenshin.com/imgs/2022/05/02/21047ff544f318fa.png) diff --git a/docs/documents/features/wish-export.md b/docs/documents/features/wish-export.md index f9abbb365..ae145e64d 100644 --- a/docs/documents/features/wish-export.md +++ b/docs/documents/features/wish-export.md @@ -2,12 +2,16 @@ headerDepth: 0 --- -# 原神祈愿记录导出 +# 原神祈愿记录导出 +有关原神祈愿记录导出的技术原理,你可以参阅我们的[**祈愿系统与导出原理**](/documents/FAQ/Gacha-system-and-export-principal.md)一文 + +## 从原神服务器获取最新的祈愿记录 - 打开原神游戏本体,进入祈愿界面,点击 `历史记录` -- 启动 Snap Genshin,从左侧菜单栏进入 `祈愿记录` -- 点击右上角的 `代理模式刷新` 按钮 - - 第一次使用该功能时,Snap Genshin 需要添加证书至系统,你需要根据系统提示,允许 Snap Genshin 添加证书以保证祈愿记录导出功能正常 -- 根据提示,进入游戏祈愿功能并点击历史记录,等待祈愿记录获取完成 +- 启动胡桃工具箱,从左侧菜单栏进入 `祈愿记录` +- 点击右上角的 `刷新` 按钮 + - 在大多数情况下,点击`从缓存刷新`后胡桃工具箱即可开始获取你的祈愿记录 + - 如果你通过其它工具获取到了你祈愿历史记录的Url,可以选择`手动输入Url`并根据提示操作 +- 等待祈愿记录获取完成 -![wish-export-sample](https://image.snapgenshin.com/imgs/2022/09/22/4b43c28556b2abf7.png) +![wish-export-sample](/images/202209/wish-export.png)