From 5a5e3c702863415319fc3ceedd689c9b1ee28316 Mon Sep 17 00:00:00 2001 From: Masterain98 Date: Thu, 16 Feb 2023 10:10:37 +0000 Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages=20from=20@=20DGP-Stud?= =?UTF-8?q?io/Snap.Hutao.Docs@6282d0a91fb0493454b88007c7e294d85fe4a968=20?= =?UTF-8?q?=F0=9F=9A=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 404.html | 4 ++-- FAQ/Gacha-system-and-export-principal.html | 4 ++-- FAQ/artifact-rating-rules.html | 4 ++-- FAQ/exceptions.html | 4 ++-- FAQ/get-stoken-cookie-from-the-third-party.html | 4 ++-- FAQ/how-to.html | 4 ++-- FAQ/index.html | 4 ++-- FAQ/known-issue.html | 8 ++++---- FAQ/mihoyo-risk-tip.html | 4 ++-- FAQ/why.html | 4 ++-- ...uePlayground-e899ba2e.js => VuePlayground-89efe97c.js} | 2 +- assets/{app-03946401.js => app-30d367b9.js} | 4 ++-- ...ssue.html-deabce42.js => known-issue.html-82c4658d.js} | 2 +- ...ssue.html-71a33e2f.js => known-issue.html-a1ef6e68.js} | 2 +- ...in-483b3e9c.js => mermaid-mindmap.esm.min-98ade07f.js} | 2 +- assets/{vue-repl-bd7c903a.js => vue-repl-803d510d.js} | 2 +- atom.xml | 8 ++++---- community.html | 4 ++-- development-log/index.html | 4 ++-- development-log/symposium1.html | 4 ++-- development-log/symposium2.html | 4 ++-- en/atom.xml | 2 +- en/index.html | 4 ++-- en/rss.xml | 4 ++-- features/achievements.html | 4 ++-- features/character-data.html | 4 ++-- features/character-wiki.html | 4 ++-- features/daily-notes.html | 4 ++-- features/develop-plan.html | 4 ++-- features/game-launcher.html | 4 ++-- features/hutao-API.html | 4 ++-- features/hutao-settings.html | 4 ++-- features/index.html | 4 ++-- features/mhy-account-switch.html | 4 ++-- features/weapon-wiki.html | 4 ++-- features/wish-export.html | 4 ++-- i18n.html | 4 ++-- index.html | 4 ++-- markmap.html | 4 ++-- project.html | 4 ++-- quick-start.html | 4 ++-- rss.xml | 6 +++--- service-worker.js | 2 +- service-worker.js.map | 2 +- side-load.html | 4 ++-- sitemap.xml | 2 +- star-request.html | 4 ++-- statements/bug-report.html | 4 ++-- statements/index.html | 4 ++-- statements/privacy-notice.html | 4 ++-- statements/tos.html | 4 ++-- statements/update-log.html | 4 ++-- 52 files changed, 100 insertions(+), 100 deletions(-) rename assets/{VuePlayground-e899ba2e.js => VuePlayground-89efe97c.js} (92%) rename assets/{app-03946401.js => app-30d367b9.js} (99%) rename assets/{known-issue.html-deabce42.js => known-issue.html-82c4658d.js} (82%) rename assets/{known-issue.html-71a33e2f.js => known-issue.html-a1ef6e68.js} (83%) rename assets/{mermaid-mindmap.esm.min-483b3e9c.js => mermaid-mindmap.esm.min-98ade07f.js} (78%) rename assets/{vue-repl-bd7c903a.js => vue-repl-803d510d.js} (99%) diff --git a/404.html b/404.html index c400ee2c3..4e61fa86e 100644 --- a/404.html +++ b/404.html @@ -32,10 +32,10 @@ } - +
- + diff --git a/FAQ/Gacha-system-and-export-principal.html b/FAQ/Gacha-system-and-export-principal.html index fb1308bb6..f9db51b00 100644 --- a/FAQ/Gacha-system-and-export-principal.html +++ b/FAQ/Gacha-system-and-export-principal.html @@ -32,10 +32,10 @@ } - +

祈愿系统与导出原理

DGP-StudioFAQ大约 2 分钟

祈愿系统与导出原理

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)并仅导入较老的数据

(因为始终可以从米哈游的服务器获取较新的数据,这种原始数据有更高的精确度)

祈愿的导出

尚未实现,正在设计 已实装

评论
  • 按正序
  • 按倒序
  • 按热度
Powered by Waline v2.14.7
- + diff --git a/FAQ/artifact-rating-rules.html b/FAQ/artifact-rating-rules.html index 1396b1d72..b0ced8ffe 100644 --- a/FAQ/artifact-rating-rules.html +++ b/FAQ/artifact-rating-rules.html @@ -32,10 +32,10 @@ } - +

圣遗物评分机制

DGP-StudioFAQ小于 1 分钟

圣遗物评分机制

因角色设定差异,圣遗物评分机制也必须随角色所需属性而确定。

如果你有兴趣探索我们的评分机制, 可以审阅胡桃工具箱代码open in new window 来了解评分计算方法。

如果你对当前的圣遗物评分机制有新的建议,可以在 GitHub 上开启 Issue 为圣遗物评分提供新的依据open in new window

评论
  • 按正序
  • 按倒序
  • 按热度
Powered by Waline v2.14.7
- + diff --git a/FAQ/exceptions.html b/FAQ/exceptions.html index 8ae520413..a7f111eaf 100644 --- a/FAQ/exceptions.html +++ b/FAQ/exceptions.html @@ -32,10 +32,10 @@ } - +

常见的程序异常

DGP-StudioFAQ大约 1 分钟

常见的程序异常

该文档包含由用户端错误造成的问题

RuntimeEnvironmentException

  • 异常:RuntimeEnvironmentException
    • 提示:未开启长路径功能,无法设置注册表键值
  • 问题来源:没有解除 Windows 目录长度限制
  • 解决方案:下载 EnableLongPaths.zipopen in new window 后解压,以管理员身份运行解压后的 .reg 文件

Return Code: -10001

  • 该异常实际上来源于米游社的返回信息,包括:
    • Return Code: -10001
    • Return Code: -100
  • 问题来源:Cookie 过期或网络异常
  • 解决方案:
    • 在帐号面板中,点击刷新 Cookie

HttpRequestException 元数据校验文件下载失败

403 (Forbidden)

解决方案:更新胡桃工具箱至最新版本open in new window

502 (Bad Gateway)

相关 Issue: https://github.com/DGP-Studio/Snap.Hutao/issues/100open in new window

当胡桃工具箱无法从远程服务器获取到必要资源时(通常是配置文件和图片缓存),会在用户界面抛出如下图所示的 HttpRequestException 错误。

HttpRequestException

当你遇到该情况,且已经确定本地网络没有互联网连接问题时,请检查是否启用了系统代理程序。如果是,请关闭。胡桃工具箱的远程服务器在全世界范围内都有类似的体验效果, 你无需为了胡桃工具箱的网络连接而使用代理网络。

如果系统代理是你的网络必须选项,请关闭系统代理而使用 TUN 模式代理;或者也可以通过 Windows 8 AppContainer Loopback Utilityopen in new window 解除 Windows APP Container Loopback 的限制open in new window

评论
  • 按正序
  • 按倒序
  • 按热度
Powered by Waline v2.14.7
- + diff --git a/FAQ/get-stoken-cookie-from-the-third-party.html b/FAQ/get-stoken-cookie-from-the-third-party.html index 93b220a0c..0ddb63657 100644 --- a/FAQ/get-stoken-cookie-from-the-third-party.html +++ b/FAQ/get-stoken-cookie-from-the-third-party.html @@ -32,10 +32,10 @@ } - +

使用第三方工具获取有 Stoken 的 cookie

DGP-StudioFAQ第三方工具大约 2 分钟

使用第三方工具获取有 Stoken 的 cookie

注意

  • 以下步骤中涉及的软件、开源项目等资源均来源于互联网,与 DGP-Studio 无关
  • 本说明文档仅提供有关的解决思路,仅供学习使用,具体操作与操作后果与本项目无关

Android

Android 用户可以使用开源项目 GetToken 来获取包含 Stoken 字段的 cookie

GetToken 开源项目

  • GetToken 项目的发布会包含两个 apk 文件,两者最终效果相同。根据你的设备情况选择适合你的版本即可
    • app-release.apk 为一个 LSPosed 插件允许用户在官方米游社中使用 GetToken 功能
    • 名称以lspatched结尾的 apk 文件是一个已包含 GetToken 功能的修改版米游社程序
      • 你需要卸载官方版米游社以安装该版本的米游社
  • 启用插件或安装修改版米游社后打开米游社,在底栏点击"我的",然后登录您的通行证
  • 在右上角点击形如🔑形状的按钮
  • 点击勾选 Stoken 选项
  • 点击复制登录信息
  • 将复制到的 Stoken 发送到已经安装了胡桃工具箱的电脑
  • 胡桃工具箱中的账号登录位置,点击手动输入
  • 将之前获取到的 cookie 输入,此时即可完成登录

iOS

iOS 用户可以在 App Store 下载抓包软件 Stream 来获取包含 Stoken 字段的 cookie

  • 从 App Store 下载 Streamopen in new window
  • 对域名 api-takumi.mihoyo.com 进行抓包分析
  • 找到并复制带有 Stoken 的数据
    • 形如stuid=****;stoken=v2****;mid=****;
  • 将复制到的 Stoken 发送到已经安装了胡桃工具箱的电脑
  • 胡桃工具箱中的账号登录位置,点击手动输入
  • 将之前获取到的 cookie 输入,此时即可完成登录
评论
  • 按正序
  • 按倒序
  • 按热度
Powered by Waline v2.14.7
- + diff --git a/FAQ/how-to.html b/FAQ/how-to.html index d1667ab4b..dc9252faa 100644 --- a/FAQ/how-to.html +++ b/FAQ/how-to.html @@ -32,12 +32,12 @@ } - +

如何...

DGP-StudioFAQ大约 2 分钟

如何...

这篇文档将会列出一些最常见的以“如何”开头的问题

如何创建胡桃的桌面快捷方式

  • Win+R 呼出运行窗口,在窗口中输入shell:AppsFolderRun
  • Windows 会弹出应用程序目录,找到胡桃工具箱
  • 右键,点击创建快捷方式
  • 根据提示操作你就可以获得一个桌面快捷方式了

如何添加一个默认以管理员方式运行的快捷方式

基本原理:使用下方的 PowerShell 脚本可以以管理员方式运行胡桃

Start-Process shell:AppsFolder\60568DGPStudio.SnapHutao_ebfp3nyc27j86!App -verb runas
 
  • 保存胡桃工具箱的 Logo 资源
  • 在桌面点击右键,选择新建 -> 快捷方式
  • 请键入对象的位置中直接输入:
  powershell -WindowStyle Hidden -Command "Start-Process shell:AppsFolder\60568DGPStudio.SnapHutao_ebfp3nyc27j86!App -verb runas
 
  • 将快捷方式命名为你需要的名称,比如Snap Hutao
  • 确认创建,此时你会在桌面得到一个有 PowerShell 图标的快捷方式
  • 右键该快捷方式,点击属性
    • 运行方式修改为最小化
    • 点击更改图标,选择浏览,并选中刚刚下载的图标
  • 这样你就获得了胡桃工具箱的桌面快捷方式,并且运行它将直接以管理员模式运行
    • 你也可以将固定到任务栏或磁贴区

如何让胡桃工具箱开机自动启动

  • 请参考如下思路
    • 可以自行创建一个批处理文件,内容参考此issueopen in new window中,令胡桃以管理员模式直接运行的命令。
    • 设置一个计划任务程序令上述批处理文件开机自启,或将上述批处理文件加入启动项
  • 或有其他令胡桃工具箱可开机自启的思路,可自行探索

如何通过胡桃工具箱快速地启动游戏

  • 在主程序中正确设置高级启动器功能

  • 将胡桃工具箱在系统中固定在快速启动栏中

  • 在快速启动栏中右键胡桃应用程序

    quick-start

  • 选择启动游戏即可

如何通过网络代理使用胡桃工具箱

参考 HttpRequestException 错误 文档

评论
  • 按正序
  • 按倒序
  • 按热度
Powered by Waline v2.14.7
- + diff --git a/FAQ/index.html b/FAQ/index.html index 6dcc07932..65e29fcf3 100644 --- a/FAQ/index.html +++ b/FAQ/index.html @@ -32,10 +32,10 @@ } - +
- + diff --git a/FAQ/known-issue.html b/FAQ/known-issue.html index ddf385514..08cbd1f07 100644 --- a/FAQ/known-issue.html +++ b/FAQ/known-issue.html @@ -5,7 +5,7 @@ - 已知问题 | 胡桃工具箱