diff --git a/docs/en/FAQ/HttpRequestException.md b/docs/en/FAQ/HttpRequestException.md new file mode 100644 index 000000000..0ec97fa0e --- /dev/null +++ b/docs/en/FAQ/HttpRequestException.md @@ -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) 。 + diff --git a/docs/en/FAQ/artifact-rating-rules.md b/docs/en/FAQ/artifact-rating-rules.md new file mode 100644 index 000000000..184ec649f --- /dev/null +++ b/docs/en/FAQ/artifact-rating-rules.md @@ -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) \ No newline at end of file diff --git a/docs/en/FAQ/get-stoken-cookie-from-the-third-party.md b/docs/en/FAQ/get-stoken-cookie-from-the-third-party.md new file mode 100644 index 000000000..b97caa522 --- /dev/null +++ b/docs/en/FAQ/get-stoken-cookie-from-the-third-party.md @@ -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 输入,此时即可完成登录 diff --git a/docs/en/FAQ/how-to.md b/docs/en/FAQ/how-to.md new file mode 100644 index 000000000..d0ff1e46b --- /dev/null +++ b/docs/en/FAQ/how-to.md @@ -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)中,令胡桃以管理员模式直接运行的命令。 + - 设置一个**计划任务程序**令上述批处理文件开机自启,或将上述批处理文件加入**启动项**中 +- 或有其他令胡桃工具箱可开机自启的思路,可自行探索 \ No newline at end of file diff --git a/docs/en/FAQ/mihoyo-risk-tip.md b/docs/en/FAQ/mihoyo-risk-tip.md new file mode 100644 index 000000000..f83b89ef4 --- /dev/null +++ b/docs/en/FAQ/mihoyo-risk-tip.md @@ -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地址,这是米游社后端的**安全性**设计,不可避免,无法绕过 +::: diff --git a/docs/en/FAQ/most-frequent-questions.md b/docs/en/FAQ/most-frequent-questions.md deleted file mode 100644 index ffa82dd06..000000000 --- a/docs/en/FAQ/most-frequent-questions.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -headerDepth: 2 ---- - -# 快速解答 - -## Windows 10 下程序乱码 -当用户在 Windows 10 下使用胡桃且发现有乱码情况时,可以下载 `Segoe Fluent Icons`字体,并为系统所有用户安装,即可解决问题 - diff --git a/docs/en/FAQ/why.md b/docs/en/FAQ/why.md new file mode 100644 index 000000000..8df844fd9 --- /dev/null +++ b/docs/en/FAQ/why.md @@ -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无法被识别为有效状态 diff --git a/docs/en/README.md b/docs/en/README.md index 73115fa0d..75408fbba 100644 --- a/docs/en/README.md +++ b/docs/en/README.md @@ -1,41 +1,91 @@ --- home: true icon: home -title: 首页 -heroImage: /images/202209/HeroImageLogo.png -heroText: 胡桃工具箱 -tagline: 一个实用的多功能原神工具箱 +title: Home +heroImage: https://img.alicdn.com/imgextra/i1/1797064093/O1CN01TOz2Cm1g6du5e8Hml_!!1797064093.png +heroText: Snap.Hutao +tagline: Multifunctional open-source Genshin Utility actions: - - text: 下载 - link: https://go.hut.ao/down + - text: Download + link: https://d.hut.ao/ type: primary - - - text: 快速开始 + - text: Quick Start link: /quick-start.md - - text: 文档 + - text: Document link: /features/ - - text: 项目进度 + - text: Project link: project.md features: - - title: 比 Snap Genshin 更好 + - title: Better than Snap.Genshin icon: /images/202209/SGLogoUpgrade64.png - details: 胡桃工具箱在继承 Snap Genshin 功能的前提下有更广泛的数据支持和更好的客户端性能表现 - link: https://www.snapgenshin.com/home/ + details: Snap.Hutao has more extensive data support and better client performance while inheriting all Snap.Genshin functionality + link: /project.md - - title: 祈愿记录 + - title: Daily Note + icon: /images/202301/live-stat-tracking-logo.png + details: No need to be tied to a mobile app anymore; get real-time notes and Windows native notification directly on your computer + link: /features/daily-notes.md + + - title: Spiral Abyss Record + icon: /images/202301/spiral-abyss-record-logo.png + details: Get the personal Spiral Abyss records, including statistics and detailed data, permanently save past Spiral Abyss challenges on your device + link: /features/hutao-API.md + + - title: Multi-Account Switch + icon: /images/202209/IndexIconMihoyoBBS.png + details: Snap.Hutao supports multiple MiHoYo BBS accounts to stay logged in and create separate profiles for each account in each function, so players can easily manage their multiple accounts + link: /features/mhy-account-switch.md + + - title: Wish History Record icon: /images/202209/IndexIconWish.png - details: 支持多UID切换,从游戏日志文件获取或从其它祈愿记录程序导出数据,永久保留玩家的祈愿记录 + details: Support switching between multiple UID, from the cache file or other method to save the wish history in your local machine. link: /features/wish-export.md - - title: 成就记录 - icon: /images/202209/IndexIconAchievements.png - details: 成就统计功能允许玩家导出成就数据并在游戏外进行统计;基于成就拆分,玩家可以对隐藏成就的阶段性目标进行管理 + - title: Achievement + icon: /images/202301/achievement.png + details: Achievement statistics feature allows players to export achievement data and keep statistics outside the game; based on achievement splitting, players can manage milestones for hidden achievements link: /features/achievements.md + - title: Advanced Game Launcher + icon: /images/202211/game-launcher-logo.png + details: With the advanced launcher in Snap.Hutao, players can easily switch their Genshin accounts, switch servers, modify game window settings and further explore more advanced features + link: /features/game-launcher.md + + - title: Hutao Database + icon: /images/202211/hutao-api-logo.png + details: Check out the details of community's current Spiral Abyss teaming, weapon matching, and artifact set matching; share your own Spiral Abyss lineup configuration + link: /features/hutao-api.md + + - title: Your Characters + icon: /images/202211/character-data-logo.png + details: View detailed data about the player's character, including level, constellations, weapons, talents, artifact set, etc.; automatically calculate artifact set score + link: /features/character-data.md + + - title: Character Wiki + icon: /images/202211/character-wiki-logo.png + details: Check the character's numerical information; talent and constellations; training materials; character's background story and other information; get the most weapons and artifact set matching scheme among players through the Hutao database + link: /features/character-wiki.md + + - title: Weapon Wiki + icon: /images/202301/weapon-wiki-logo.png + details: Check weapon values and stories; get the most character matching data among players through the Hutao database + link: /features/weapon-wiki.md + + - title: Development Calculator + icon: /images/202301/dev-plan-logo.png + details: Make implementable character development plans based on your actual situation; support multiple accounts, multiple plan lists, and backpack item records + link: /features/develop-plan.md copyright: false footer: MIT Licensed | Copyright © 2019-present Mr.Hope - --- - +