Add base en-US doc

- not translated except index page
This commit is contained in:
Masterain
2023-01-11 16:51:03 -08:00
parent 486a411fb9
commit d96f0101b0
28 changed files with 1083 additions and 124 deletions

View File

@@ -0,0 +1,13 @@
# `HttpRequestException`错误
> 相关 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,9 @@
# 圣遗物评分机制
因角色设定差异,圣遗物评分机制也必须随角色所需属性而确定。
如果你有兴趣探索我们的评分机制,
可以审阅[胡桃工具箱代码](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,37 @@
# 使用第三方工具获取有 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 输入,此时即可完成登录

31
docs/en/FAQ/how-to.md Normal file
View File

@@ -0,0 +1,31 @@
---
headerDepth: 1
---
# 如何...
这篇文档将会列出一些最常见的以“如何”开头的问题
## 如何创建胡桃的桌面快捷方式
::: 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 会弹出应用程序目录,找到胡桃工具箱
- 右键,点击`创建快捷方式`
- 根据提示操作你就可以获得一个桌面快捷方式了
## 如何实现自动化管理员模式
请使用如下的 PowerShell 脚本启动胡桃
```PowerShell
Start-Process shell:AppsFolder\7f0db578-026f-4e0b-a75b-d5d06bb0a74d_7jfyf5536hdrr!App -verb runas
```
## 如何让胡桃工具箱开机自动启动
- 请参考如下思路
- 可以自行创建一个批处理文件,内容参考[此issue](https://github.com/DGP-Studio/Snap.Hutao/issues/184)中,令胡桃以管理员模式直接运行的命令。
- 设置一个**计划任务程序**令上述批处理文件开机自启,或将上述批处理文件加入**启动项**中
- 或有其他令胡桃工具箱可开机自启的思路,可自行探索

View File

@@ -0,0 +1,34 @@
---
headerDepth: 0
---
# 账号风险及异常提示
![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)
- 当胡桃工具箱返回"账号有风险,请前往米游社查看"、"请求异常,请前往米游社对应功能页面查看"、"无感验证失败,请前往「米游社我的角色实时便笺」页面查看
"等错误提示时,代表当前的操作被米游社的验证系统所阻挡
- 解决方式
- 使用手机打开米游社App
- 点击`我的`
- 点击`个人主页`
- 点击`我的角色`下方的角色标签
- 点击`全部角色`
- 或可以点击`实时便笺`窗体
- 完成**在此期间可能随机触发的验证流程**(例如验证码),即可解决本问题。
- 若此操作未触发验证流程,可重复进行多次,直到触发验证为止
- 若始终无法触发验证,可修改密码
::: tip
- 若风险提示过于频繁,或始终无法触发验证,代表您的账号风险已过高,请修改密码,使多个设备同时登录的状态被重置
:::
::: warning
- 若您**已绑定并使用可提供原神查询的Bot**或**同时有多个设备使用同一个米哈游通行证**,则本条目所示的情况,尤其**无感验证**将基本无法成功,这是米游社后端的**安全性**设计,不可避免,无法绕过
- 若您本地有多个**米哈游通行证**同时频繁与**米游社**进行数据交互则可能会被米游社在一定时间内封禁IP地址这是米游社后端的**安全性**设计,不可避免,无法绕过
:::

View File

@@ -1,9 +0,0 @@
---
headerDepth: 2
---
# 快速解答
## Windows 10 下程序乱码
当用户在 Windows 10 下使用胡桃且发现有乱码情况时,可以下载 `Segoe Fluent Icons`字体,并为系统所有用户安装,即可解决问题

34
docs/en/FAQ/why.md Normal file
View File

@@ -0,0 +1,34 @@
---
headerDepth: 1
---
# 为什么...
这篇文档将会列出一些最常见的以“为什么”开头的问题
## 为什么在设置中点击修改游戏路径无效
特定系统版本的用户由于微软对文件选择对话框的COM实现的差异会存在点击按钮后无响应的问题。
相关的 [Github Issue](https://github.com/microsoft/WindowsAppSDK/issues/2931)
## 为什么程序会出现乱码现象
- 当用户在 Windows 10 下使用胡桃且发现有乱码情况时:
- 可以下载 `Segoe Fluent Icons`字体
- 安装时选择`为系统所有用户安装`,即可解决问题
- 您可以从 [微软官方](https://aka.ms/SegoeFluentIcons)下载到该字体文件
## 为什么解锁帧率后使用心海时出现掉帧
原神的BUG和我们没关系
## 为什么会弹出需要使用新应用以打开的对话框
请根据文档在设置中清除定时任务后再卸载胡桃工具箱
## 为什么米游社帐号登录状态经常失效,添加的帐号消失
* 我们通过储存帐号的米游社 Cookie 来维持登录状态。
* 但是当用户在浏览器或其它设备上**注销帐号**后, 维持登录状态的 Cookie 将**失效**。
* 这会导致胡桃工具箱上的米游社帐号在启动后被自动移除。
* 此情况也可能因为网络连接问题导致无法检查Cookie有效性故出现此情况后请优先重启胡桃工具箱。
* 自2022年10月起米游社极大地提高了账号被判定为有风险的概率[账号有风险](mihoyo-risk-tip.md)时亦会令Cookie无法被识别为有效状态