This commit is contained in:
Masterain
2023-02-23 11:14:31 -08:00
parent da93fce44e
commit 61b76184e6
16 changed files with 9 additions and 9 deletions

115
docs/advanced/FAQ.md Normal file
View File

@@ -0,0 +1,115 @@
---
headerDepth: 2
icon: ask
category: [FAQ]
---
# 常见问题
## 如何创建胡桃的桌面快捷方式
::: tip 社区力量
感谢 [CzHUV 提供的解决方案](https://github.com/DGP-Studio/Snap.Hutao.Docs/issues/12)
:::
- `Win+R` 呼出运行窗口,在窗口中输入`shell:AppsFolder`
![Run](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01Jj8c6i1g6du728e5A_!!1797064093.png)
- Windows 会弹出应用程序目录,找到胡桃工具箱
- 右键,点击`创建快捷方式`
- 根据提示操作你就可以获得一个桌面快捷方式了
## 如何添加一个默认以管理员方式运行的快捷方式
::: tip 社区力量
感谢 [Parsifa1 提供的解决方案](https://github.com/DGP-Studio/Snap.Hutao.Docs/issues/17)
:::
基本原理:使用下方的 PowerShell 脚本可以以管理员方式运行胡桃
```PowerShell ts:no-line-numbers
Start-Process shell:AppsFolder\60568DGPStudio.SnapHutao_ebfp3nyc27j86!App -verb runas
```
- 保存胡桃工具箱的 Logo 资源
- 你可以点击[这里](https://github.com/DGP-Studio/Snap.Hutao/raw/main/src/Snap.Hutao/Snap.Hutao/Assets/Logo.ico)下载
- 在桌面点击右键,选择`新建` -> `快捷方式`
- 在`请键入对象的位置`中直接输入:
```PowerShell ts:no-line-numbers
powershell -WindowStyle Hidden -Command "Start-Process shell:AppsFolder\60568DGPStudio.SnapHutao_ebfp3nyc27j86!App -verb runas
```
- 将快捷方式命名为你需要的名称,比如`Snap Hutao`
- 确认创建,此时你会在桌面得到一个有 PowerShell 图标的快捷方式
- 右键该快捷方式,点击属性
- 将`运行方式`修改为`最小化`
- 点击更改图标,选择`浏览`,并选中刚刚下载的图标
- 这样你就获得了胡桃工具箱的桌面快捷方式,并且运行它将直接以管理员模式运行
- 你也可以将固定到任务栏或磁贴区
## 如何让胡桃工具箱开机自动启动
- 请参考如下思路
- 可以自行创建一个批处理文件,内容参考[此issue](https://github.com/DGP-Studio/Snap.Hutao/issues/184)中,令胡桃以管理员模式直接运行的命令。
- 设置一个**计划任务程序**令上述批处理文件开机自启,或将上述批处理文件加入**启动项**中
- 或有其他令胡桃工具箱可开机自启的思路,可自行探索
## 如何通过胡桃工具箱快速地启动游戏
- 在主程序中正确设置高级启动器功能
- 将胡桃工具箱在系统中固定在快速启动栏中
- 在快速启动栏中右键胡桃应用程序
![quick-start](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01Uu8QzN1g6du6MRp8h_!!1797064093.png)
- 选择`启动游戏`即可
## 如何通过网络代理使用胡桃工具箱
参考 [HttpRequestException 错误](exceptions.html#httprequestexception) 文档
## 为什么在设置中点击修改游戏路径无效
特定系统版本的用户由于微软对文件选择对话框的COM实现的差异会存在点击按钮后无响应的问题。
相关的 [Github Issue](https://github.com/microsoft/WindowsAppSDK/issues/2931)
## 为什么程序会出现乱码现象
- 当用户在 Windows 10 下使用胡桃且发现有乱码情况时:
- 可以下载 `Segoe Fluent Icons`字体
- 安装时选择`为系统所有用户安装`,即可解决问题
- 您可以从 [微软官方](https://aka.ms/SegoeFluentIcons)下载到该字体文件
## 为什么解锁帧率后使用心海时出现掉帧
原神的BUG和我们没关系
## 为什么会弹出需要使用新应用以打开的对话框
![uninstall-error](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01b3j0eY1g6duBXLJXg_!!1797064093.jpg)
如在卸载胡桃工具箱后出现如上图所示的`需要使用新应用以打开此 hutao 链接`,说明没有按文档要求在卸载前清除实时便笺定时任务。
请根据文档在设置中清除定时任务后再卸载胡桃工具箱。
- 如果你在系统定时任务中找不到胡桃的定时任务,但问题仍然出现,请参考[这份文档](https://github.com/DGP-Studio/Snap.Hutao.Docs/issues/18)来解决
## 为什么米游社帐号登录状态经常失效,添加的帐号消失
* 我们通过储存帐号的米游社 Cookie 来维持登录状态。
* 但是当用户在浏览器或其它设备上**注销帐号**后, 维持登录状态的 Cookie 将**失效**。
* 这会导致胡桃工具箱上的米游社帐号在启动后被自动移除。
* 此情况也可能因为网络连接问题导致无法检查Cookie有效性故出现此情况后请优先重启胡桃工具箱。
* 自2022年10月起米游社极大地提高了账号被判定为有风险的概率[账号有风险](mihoyo-risk-tip.md)时亦会令Cookie无法被识别为有效状态
* 自 1.4.15 版本起,你可以通过在帐号面板中刷新 Cookie 来刷新登录状态
## 为什么游戏登录状态会失效,导致切换帐号功能无效
- 保存游戏登录状态的要素有两个:网络环境和设备 ID
- 导致该问题的常见原因是:
- 网络环境频繁变换,如公网 IP 更换
- 操作失误,导致实际上根本没有保存登录状态(空的登录状态无法避免被胡桃识别)
- 确认你的帐号已登录后,进入游戏
- 关闭游戏后,确定游戏进程已关闭
- 再次进行帐号检测,来添加登录状态
## 为什么程序会提示注册计划任务失败
使用管理员模式使用一次实时便笺后,胡桃的任务计划会被以管理员权限创建。当再次以非管理员模式启动胡桃时,程序在修改计划任务时会缺少权限。
继续使用管理员模式即可解决该问题。
## 为什么在开启代理后胡桃工具箱会没有网络连接
参考 [HttpRequestException 错误](exceptions.html#httprequestexception) 文档
## 为什么商店版本和侧载版本不会相互覆盖升级
- 商店版本和侧载版本有不同的软件 ID所以会被系统识别为不同的程序
- 商店版的更新只会覆盖商店版应用;侧载版更新包只会更新侧载版应用
- 在你的系统中,商店版的胡桃工具箱名称为 `Snap Hutao`,侧载版的名称为 `胡桃`

View File

@@ -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并仅导入较老的数据
(因为始终可以从米哈游的服务器获取较新的数据,这种原始数据有更高的精确度)
### 祈愿的导出
~~尚未实现,正在设计~~
已实装

View File

@@ -0,0 +1,14 @@
---
category: [FAQ]
icon: read
---
# 圣遗物评分机制
因角色设定差异,圣遗物评分机制也必须随角色所需属性而确定。
如果你有兴趣探索我们的评分机制,
可以审阅[胡桃工具箱代码](https://github.com/DGP-Studio/Snap.Hutao/tree/main/src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/Factory)
来了解评分计算方法。
如果你对当前的圣遗物评分机制有新的建议,可以[在 GitHub 上开启 Issue 为圣遗物评分提供新的依据](https://github.com/DGP-Studio/Snap.Hutao/issues/new/choose)

View File

@@ -0,0 +1,38 @@
---
headerDepth: 2
icon: debug
category: [FAQ]
---
# 常见的程序异常
该文档包含由**用户端错误**造成的问题
## RuntimeEnvironmentException
- 异常:`RuntimeEnvironmentException`
- 提示:`未开启长路径功能,无法设置注册表键值`
- 问题来源:没有解除 Windows 目录长度限制
- 解决方案:下载 [EnableLongPaths.zip](https://d.hut.ao/d/tools/EnableLongPaths.zip) 后解压,以管理员身份运行解压后的 `.reg` 文件
## Return Code: -10001
- 该异常实际上来源于米游社的返回信息,包括:
- `Return Code: -10001`
- `Return Code: -100`
- 问题来源Cookie 过期或网络异常
- 解决方案:
- 在帐号面板中,点击`刷新 Cookie`
## HttpRequestException 元数据校验文件下载失败
### 403 (Forbidden)
解决方案:更新胡桃工具箱至[最新版本](https://apps.microsoft.com/store/detail/snap-hutao/9PH4NXJ2JN52)
### 502 (Bad Gateway)
> 相关 Issue: [https://github.com/DGP-Studio/Snap.Hutao/issues/100](https://github.com/DGP-Studio/Snap.Hutao/issues/100)
当胡桃工具箱无法从远程服务器获取到必要资源时(通常是配置文件和图片缓存),会在用户界面抛出如下图所示的 `HttpRequestException` 错误。
![HttpRequestException](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01Tb2RUm1g6du5YeNuy_!!1797064093.jpg)
当你遇到该情况,且已经确定本地网络没有互联网连接问题时,请检查是否启用了系统代理程序。如果是,请关闭。胡桃工具箱的远程服务器在全世界范围内都有类似的体验效果,
你无需为了胡桃工具箱的网络连接而使用代理网络。
如果系统代理是你的网络必须选项,请关闭系统代理而使用 TUN 模式代理;或者也可以通过 [Windows 8 AppContainer Loopback Utility](https://www.telerik.com/fiddler/add-ons)
解除 [Windows APP Container Loopback 的限制](https://learn.microsoft.com/zh-CN/windows/iot-core/develop-your-app/loopback) 。

View File

@@ -0,0 +1,42 @@
---
category: [FAQ, 第三方工具]
icon: read
---
# 使用第三方工具获取有 Stoken 的 cookie
::: warning
- 以下步骤中涉及的软件、开源项目等资源均来源于互联网,与 DGP-Studio 无关
- 本说明文档仅提供有关的解决思路,仅供学习使用,具体操作与操作后果与本项目无关
:::
## Android
Android 用户可以使用开源项目 GetToken 来获取包含 Stoken 字段的 cookie
::: tip GetToken 开源项目
- GitHub[HolographicHat/GetToken](https://github.com/HolographicHat/GetToken)
:::
- GetToken 项目的发布会包含两个 apk 文件,两者最终效果相同。根据你的设备情况选择适合你的版本即可
- `app-release.apk` 为一个 LSPosed 插件允许用户在官方米游社中使用 GetToken 功能
- 名称以`lspatched`结尾的 apk 文件是一个已包含 GetToken 功能的修改版米游社程序
- 你需要卸载官方版米游社以安装该版本的米游社
- 启用插件或安装修改版米游社后打开米游社,在底栏点击"我的",然后登录您的通行证
- 在右上角点击形如🔑形状的按钮
- 点击勾选 `Stoken` 选项
- 点击`复制登录信息`
- 将复制到的 Stoken 发送到已经安装了胡桃工具箱的电脑
-`胡桃工具箱`中的账号登录位置,点击`手动输入`
- 将之前获取到的 cookie 输入,此时即可完成登录
## iOS
iOS 用户可以在 App Store 下载抓包软件 Stream 来获取包含 Stoken 字段的 cookie
- 从 App Store 下载 [Stream](https://apps.apple.com/cn/app/stream/id1312141691)
- 对域名 `api-takumi.mihoyo.com` 进行抓包分析
- 找到并复制带有 `Stoken` 的数据
- 形如`stuid=****;stoken=v2****;mid=****;`
- 将复制到的 Stoken 发送到已经安装了胡桃工具箱的电脑
-`胡桃工具箱`中的账号登录位置,点击`手动输入`
- 将之前获取到的 cookie 输入,此时即可完成登录

View File

@@ -0,0 +1,54 @@
---
headerDepth: 2
icon: tool
category: [FAQ]
---
# 已知问题
该文档包含由**程序错误**造成的问题
## #1 微软商店下载应用程序
> 该问题来源并非胡桃工具箱,属于外部问题
> 该问题通常仅出现在东亚地区的网络环境下
- 发现于 2023/02/07
- 无法从微软商店下载的原因在于微软在东亚的授权服务器 `licensing.mp.microsoft.com` 掉线。当你在商店上下载一个新应用时,这实际上是一个授权/购买的过程。
当授权服务出现问题时,自然不会再进入到下一步下载环节,这就导致了用户无法安装
- 目前仅发现于微软商店新加坡授权服务器 `52.137.108.250` 出现了问题,所以你可以使用代理,切换到其它授权服务器,来实现下载。
- 授权服务器问题 DGP-Studio已反馈给微软等待解决。
- 临时的解决方案:
- **方法1**
- 使用[UsbEAm Hosts Editor](https://www.dogfight360.com/blog/475/)
- 在该工具箱内选择 `Microsoft Store - 微软商店` 中的 `微软授权验证`
- 点击`检测延迟`
- 选择一个对你而言延迟最低的服务器,选中后点击`应用选中`
- 此时重启微软商店后,你应当可以下载应用了
- 下载完成后,建议点击`清除当前`以删除对 `Hosts` 文件的修改
- 如果你懒得下载,可以尝试将 `licensing.mp.microsoft.com` 通过修改 `Hosts`文件解析到以下 IP 地址之一 (收集于 UsbEAm Hosts Editor
- `124.108.22.138`
- `92.38.149.175`
- `141.147.180.87`
- `103.151.179.4`
- **方法2**
- 将系统的DNS服务器设置为4.2.2.1和4.2.2.2(完事后记得改回原本的设置)
- **方法3**
- 使用北美地区的网络代理
- 如果使用加速器或网络代理,你需要[解除微软商店的 Windows App Container Loopback 限制](exceptions.html#_502-bad-gateway)
## #2 服务器切换导致31-4302报错
> 该问题已于 [1.4.15](/statements/update-log.html#1-4-15) 版本修复,请及时更新
- 使用高级启动器中的服务器切换功能时,可能会出现`31-4302`相关错误
- 目前的临时解决方案:
- 将原神截图目录中的服务器切换缓存目录删除
## #3 任务栏右键菜单中没有快速启动游戏的入口
- 胡桃使用 Windows 提供的 `JumpPath` 接口来提供快速启动游戏菜单
- 该接口需要用户在`系统设置 -> 个性化 -> 开始` 中启用`在“开始”菜单或任务栏的跳转列表中以及资源管理器的“快速使用”中显示最近打开的项` (该设置系统默认开启)
- 在下一版本,我们会使用 `JumpTask` 接口来代替 `JumpPath` 接口,用户将不再需要上述设置选项开启
## #4 无法使用管理员模式启动胡桃工具箱
> 该问题来源并非胡桃工具箱,属于外部问题
> 该问题仅存在于 Windows 10 低于22H2的版本中
- 当用户系统版本低于 `Windows Build 19045`(即 Windows 10 22H2 版本)时,可能无法通过管理员模式启动胡桃工具箱
- 该问题属于 Windows 内核级别问题,难以判断具体来源,故建议用户升级至 Windows 10 最新版本

View File

@@ -0,0 +1,37 @@
---
headerDepth: 0
icon: warn
category: [FAQ]
---
# 账号风险及异常提示
![image](https://user-images.githubusercontent.com/96916320/201329765-531d6eb6-2ec4-4022-9049-bcba3b4bf9cf.png)
![image](https://user-images.githubusercontent.com/96916320/204005371-ced5213b-a7af-4cba-baa3-818f9b7ade35.png)
- 当胡桃工具箱返回"账号有风险,请前往米游社查看"、"请求异常,请前往米游社对应功能页面查看"、"无感验证失败,请前往「米游社我的角色实时便笺」页面查看
"等错误提示时,代表当前的操作被米游社的验证系统所阻挡
- 解决方式
- 方法1 <Badge text="推荐" type="tip" />
- 自 1.4.15 版本起,在帐号面板内点击 `刷新 Cookie` 即可
- 方法2
- 使用手机打开米游社App
- 点击`我的`
- 点击`个人主页`
- 点击`我的角色`下方的角色标签
- 点击`全部角色`
- 或可以点击`实时便笺`窗体
- 完成**在此期间可能随机触发的验证流程**(例如验证码),即可解决本问题。
- 若此操作未触发验证流程,可重复进行多次,直到触发验证为止
- 若始终无法触发验证,可修改密码
::: tip
- 若风险提示过于频繁,或始终无法触发验证,代表您的账号风险已过高,请修改密码,使多个设备同时登录的状态被重置
:::
::: warning
- 若您**已绑定并使用可提供原神查询的Bot**或**同时有多个设备使用同一个米哈游通行证**,则本条目所示的情况,尤其**无感验证**将基本无法成功,这是米游社后端的**安全性**设计,不可避免,无法绕过
- 若您本地有多个**米哈游通行证**同时频繁与**米游社**进行数据交互则可能会被米游社在一定时间内封禁IP地址这是米游社后端的**安全性**设计,不可避免,无法绕过
:::

View File

@@ -0,0 +1,25 @@
---
category: [FAQ]
icon: delete
---
# 卸载胡桃工具箱
- 清除有关的任务计划
- 1.4.15 版本前,若不执行该步骤,胡桃用于获取实时便笺数据的计划任务将不会被删除,会出现[这个问题](FAQ.md#为什么会弹出需要使用新应用以打开的对话框)
- **方法1** <Badge text="仅限早于 1.4.15 的版本" type="tip" />
- 打开胡桃,选择 **设置** 页签
- 找到 **删除所有计划任务** 一栏中,点击右侧的 **执行** 按钮 <Badge text="需要管理员模式" type="tip" />
- **方法2**
- 执行下方的脚本
``` PowerShell
schtasks /delete /tn SnapHutaoDailyNoteRefreshTask
```
- **方法3**
- 打开 Windows 计划任务程序
- 找到 `SnapHutaoDailyNoteRefreshTask` 任务并删除
- 卸载软件
- 打开`开始菜单`
- 找到或搜索到`胡桃`
- 右键点击`胡桃`,并选择`卸载`
- 清除数据文件夹(如需完全卸载)
- 打开并删除该文件夹 `%userprofile%/Documents/Hutao`