https://hut.ao/ 胡桃工具箱 多功能的原神工具箱 DGP-Studio https://github.com/DGP-Studio https://img.alicdn.com/imgextra/i1/1797064093/O1CN01TOz2Cm1g6du5e8Hml_!!1797064093.png Copyright by DGP-Studio 2023-02-14T08:02:57.484Z vuepress-plugin-feed2 DGP-Studio https://github.com/DGP-Studio 已知问题 https://hut.ao/FAQ/known-issue.html 2023-02-14T08:01:50.000Z 已知问题

该文档包含由程序错误造成的问题

#1 微软商店下载应用程序

该问题来源并非胡桃工具箱，属于外部问题

  • 发现于 2023/02/07
  • 无法从微软商店下载的原因在于微软在东亚的授权服务器 licensing.mp.microsoft.com 掉线。当你在商店上下载一个新应用时，这实际上是一个授权/购买的过程。 当授权服务出现问题时，自然不会再进入到下一步下载环节，这就导致了用户无法安装
    • 目前仅发现于微软商店新加坡授权服务器 52.137.108.250 出现了问题，所以你可以使用代理，切换到其它授权服务器，来实现下载。
  • 授权服务器问题 DGP-Studio已反馈给微软，等待解决。
  • 临时的解决方案：
    • 方法1：
      • 使用UsbEAm Hosts Editor
        • 在该工具箱内选择 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：
]]> 已知问题

该文档包含由程序错误造成的问题

#1 微软商店下载应用程序

该问题来源并非胡桃工具箱，属于外部问题

  • 发现于 2023/02/07
  • 无法从微软商店下载的原因在于微软在东亚的授权服务器 licensing.mp.microsoft.com 掉线。当你在商店上下载一个新应用时，这实际上是一个授权/购买的过程。 当授权服务出现问题时，自然不会再进入到下一步下载环节，这就导致了用户无法安装
    • 目前仅发现于微软商店新加坡授权服务器 52.137.108.250 出现了问题，所以你可以使用代理，切换到其它授权服务器，来实现下载。
  • 授权服务器问题 DGP-Studio已反馈给微软，等待解决。
  • 临时的解决方案：
    • 方法1：
      • 使用UsbEAm Hosts Editor
        • 在该工具箱内选择 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：

#2 服务器切换导致31-4302报错

该问题已于 1.4.15 版本修复，请及时更新

  • 使用高级启动器中的服务器切换功能时，可能会出现31-4302相关错误
  • 目前的临时解决方案：
    • 将原神截图目录中的服务器切换缓存目录删除
]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2023-02-11T08:39:29.000Z Copyright by DGP-Studio 更新日志 https://hut.ao/statements/update-log.html 2023-02-14T08:01:39.000Z 更新日志

1.4.16

  • 优化
    • 将JumpList菜单更换为JumpTask，即使用户关闭最近文件功能也可以使用快速启动菜单了

1.4.15

  • 新增
    • 重置图片资源的入口
    • 刷新 Cookie 方法
  • 修复
  • 优化
    • 优化了养成计划界面 #486
    • 完善英语和繁体中文翻译
    • 在触发 Windows 长路径限制时增加提示
    • 优化了定时任务的唤醒方式
]]> 更新日志

1.4.16

  • 优化
    • 将JumpList菜单更换为JumpTask，即使用户关闭最近文件功能也可以使用快速启动菜单了

1.4.15

  • 新增
    • 重置图片资源的入口
    • 刷新 Cookie 方法
  • 修复
  • 优化
    • 优化了养成计划界面 #486
    • 完善英语和繁体中文翻译
    • 在触发 Windows 长路径限制时增加提示
    • 优化了定时任务的唤醒方式

1.4.14

  • 修复了养成计划无法添加的问题
  • 支持英语界面
  • 其他的问题修复

1.4.11

  • 商店初版
]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2023-02-11T08:39:29.000Z Copyright by DGP-Studio 常见的程序异常 https://hut.ao/FAQ/exceptions.html 2023-02-14T08:01:50.000Z 常见的程序异常

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

RuntimeEnvironmentException

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

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

RuntimeEnvironmentException

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

Return Code: -10001

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

HttpRequestException

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

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

HttpRequestException

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

如果系统代理是你的网络必须选项，请关闭系统代理而使用 TUN 模式代理；或者也可以通过 Windows 8 AppContainer Loopback Utility 解除 Windows APP Container Loopback 的限制 。

]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2023-02-07T06:20:11.000Z Copyright by DGP-Studio 国际化支持 https://hut.ao/i18n.html 2023-02-06T06:31:43.000Z 国际化支持

国际化进度

Snap Hutao 虽然基于原神国服提供功能，但项目也有意提升国际化支持，包括语言本土化和功能国际化。目前国际化进度如下：

  • Snap Hutao 主项目
      • 进度：Crowdin
  • Snap Hutao 文档
    • 进度：Crowdin
]]> 国际化支持

国际化进度

Snap Hutao 虽然基于原神国服提供功能，但项目也有意提升国际化支持，包括语言本土化和功能国际化。目前国际化进度如下：

  • Snap Hutao 主项目
      • 进度：Crowdin
  • Snap Hutao 文档
    • 进度：Crowdin

参与国际化

  • Snap Hutao 主项目
    • 我们在 GitHub 上创建了一个名为 [Hoyolab]: Globalization support 的 Issue
      • 我们会在该 Issue 中更新当前主程序国际化进度
      • 你可以在这里宣布参与主程序某一部分的国际化支持，我们会为此提供支持
        • 我们也欢迎直接通过分支发起 Pull Request
    • 你可以在 translate.hut.ao 参与客户端的翻译工作
  • Snap Hutao 文档
]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2023-02-06T06:31:43.000Z Copyright by DGP-Studio https://hut.ao/side-load.html 2023-02-03T02:35:02.000Z 侧载安装

通用安装方式

  • 在系统设置中打开开发者设置界面，勾选 开发人员模式 和 允许 PowerShell 脚本 （自行百度）
  • 解压已下载的压缩包，找到Install.ps1文件，右键选择使用PowerShell运行，按照提示允许PowerShell执行操作即可
  • 安装完毕，胡桃将出现在您的开始菜单中
]]> 侧载安装

通用安装方式

  • 在系统设置中打开开发者设置界面，勾选 开发人员模式 和 允许 PowerShell 脚本 （自行百度）
  • 解压已下载的压缩包，找到Install.ps1文件，右键选择使用PowerShell运行，按照提示允许PowerShell执行操作即可
  • 安装完毕，胡桃将出现在您的开始菜单中

小白级安装方式

  • 解压已下载的安装包
  • 运行 Snap.Hutao.Installer.exe
    • 该程序将执行上述通用安装方式的命令
  • 安装完毕，胡桃将出现在您的开始菜单中

升级胡桃工具箱

  • 解压你下载的最新版本压缩包
  • 重复 安装胡桃工具箱 的步骤
  • 若您安装失败或出现异常情况，可参考如下步骤
    • 先卸载已经安装的胡桃工具箱
    • 重复 安装胡桃工具箱 的步骤
]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2023-02-03T02:35:02.000Z Copyright by DGP-Studio https://hut.ao/star-request.html 2023-02-03T02:34:14.000Z 如果你认为胡桃工具箱是一个好的项目或者有帮助到你，你可以通过以下方式支持我们

]]> 如果你认为胡桃工具箱是一个好的项目或者有帮助到你，你可以通过以下方式支持我们

commit_activity hutao-last-commit

]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2023-01-12T11:46:12.000Z Copyright by DGP-Studio 加入用户社区 https://hut.ao/community.html 2023-02-11T04:56:22.000Z 加入用户社区

作为开源软件，社区动力是胡桃工具箱生态的重要组成部分，你可以在通过下面的方式加入到胡桃的用户社区中。

如果你认为胡桃工具箱是一个好的项目或者有帮助到你，你可以通过以下方式支持我们

]]> 加入用户社区

作为开源软件，社区动力是胡桃工具箱生态的重要组成部分，你可以在通过下面的方式加入到胡桃的用户社区中。

如果你认为胡桃工具箱是一个好的项目或者有帮助到你，你可以通过以下方式支持我们

commit_activity hutao-last-commit

GitHub 讨论

Snap.Hutao Discussion

QQ 群

Discord

邀请链接：https://discord.gg/Yb8bykaUKp

]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2023-01-12T11:31:30.000Z Copyright by DGP-Studio 胡桃工具箱 https://hut.ao/markmap.html 2023-01-12T00:31:56.000Z 胡桃工具箱

米游社功能

  • 活动公告
  • 帐号登录
  • 实时便笺
  • 深境螺旋
    • 我的深渊记录
    • 胡桃数据库 - 深渊数据

游戏性增强

  • 高级启动器
  • 祈愿记录
  • 成就管理

养成计划

  • 养成计算器
    • 属性统计
    • 角色 Wiki
    • 武器 Wiki
]]> 胡桃工具箱

米游社功能

  • 活动公告
  • 帐号登录
  • 实时便笺
  • 深境螺旋
    • 我的深渊记录
    • 胡桃数据库 - 深渊数据

游戏性增强

  • 高级启动器
  • 祈愿记录
  • 成就管理

养成计划

  • 养成计算器
    • 属性统计
    • 角色 Wiki
    • 武器 Wiki
]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2023-01-12T00:31:56.000Z Copyright by DGP-Studio 第一期开发组座谈会 https://hut.ao/development-log/symposium1.html 2023-01-14T00:09:10.000Z 第一期开发组座谈会

复制自 GitHub 讨论帖，总结于群讨论

为啥胡桃在电脑上要做成类似uwp格式的应用？

开发MSIX封装的应用是桌面端的开发趋势，开发体验更佳，用户体验也能提升。

胡桃的作用是啥，和SG有什么区别？

胡桃是SG的次世代版本，更新/更快/更强。

胡桃会全面继承 SG 的功能吗？SG的一些功能会在hutao里被弃用吗？

]]> 第一期开发组座谈会

复制自 GitHub 讨论帖，总结于群讨论

为啥胡桃在电脑上要做成类似uwp格式的应用？

开发MSIX封装的应用是桌面端的开发趋势，开发体验更佳，用户体验也能提升。

胡桃的作用是啥，和SG有什么区别？

胡桃是SG的次世代版本，更新/更快/更强。

胡桃会全面继承 SG 的功能吗？SG的一些功能会在hutao里被弃用吗？

多数功能会完全继承与升级。少数功能会以整合功能的形式出现在胡桃中。

为啥不把胡桃和 SG 集合到一起，而是要分开呢？和sg有什么侧重上的不同？

Snap Genshin 采用 WPF 技术开发，该技术基于 DirectX 9，而 胡桃 采用 WinUI 3 开发，该新技术基于DirectX 12与其他较新的显示技术，呈现的效果更好，同时也更易于开发，胡桃 与 Snap Genshin 类似，但侧重于流畅、简单的用户体验，同时也更注重程序架构的可维护性，更关注性能表现。

除了SG的旧功能迁移，还会有新功能开发吗？

随着原神的发展，我们也会推出更多的功能。

SG永远不会更新了吗？SG是快不能用了吗？

没有严重的数据异常问题不会再更新。由于缺乏维护，不保证在何时由于某些不确定的原因会导致SG的部分功能失效（如先去的签到功能）。 Snap.Genshin 已停止更新，项目已归档

胡桃的使用文档秋梨膏？

使用文档 @Masterain98 正在制作中，很快就会和大家见面。 你现在看到的就是

胡桃图标还会更新嘛？

不会，我们持有胡桃图标的版权。

什么时候上微软商店？上微软商店是否不需要自己信任证书了？胡桃以后会在线更新嘛？

会在所有功能完善后上架。不需要证书。上架后就可以支持在线更新了。

有考虑增加根据角色展示面板来计算伤害的功能吗？什么时候胡桃能当启动器，解锁帧率？这个无边框全屏的功能以后会不会支持？

面板功能会在用户系统重构后进行开发，并且会在完成面板查询功能后实现启动游戏相关功能。启动参数包括在内。

胡桃数据库 和 Hutao 是否有关系？什么时候上胡桃数据库？

胡桃数据库是 HutaoAPI 的一部分，包含了深渊相关的数据，HutaoAPI是胡桃使用的 RESTful API，同时面向其他应用的开发者开放，接入成本低，接入收益高。胡桃数据库将会在后续版本实装。 已经实装

会把胡桃放到右下角任务栏吗？会考虑在角色里添加立绘吗？

基本不会考虑。后续可能会考虑。

你可以通过快速启动栏来快速启动游戏，具体方法可见此文档

将来会有移动端吗？有考虑根据胡桃做个手机桌面小组件吗？胡桃以后支持插件吗？胡桃会有插件开发文档吗？

短时间内不会考虑移动端。手机桌面小组件也基本不会考虑。不会再支持插件。同样也不会有插件文档。

离支持外服账号还有多远？会整合其他插件比如空荧酒馆这种嘛？

Hoyolab 的相关支持需要其他开发者的帮助。由于技术栈的不同，很难整合。

受益于开源社区力量，目前高级启动器、祈愿记录导出和成就管理功能已支持国际服。

有没有打算添加收费功能，还是说只靠捐助？

由于服务器需要资费，与服务器存储相关的功能可能会进行收费。 Snap.Hutao等有关项目均为公益项目

是用爱发电吗？开发胡桃，是业余时间开发的吗？

显然是。

]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2023-01-11T09:40:39.000Z Copyright by DGP-Studio 第二期开发组座谈会 https://hut.ao/development-log/symposium2.html 2023-01-11T09:40:39.000Z 第二期开发组座谈会

复制自 GitHub 讨论帖，总结于群讨论

现在成就导出的json格式也是UIGF的嘛

A: UIAF

能否适配祈愿系统数据UEFI旧版本的导入，和SG一样就可以

A: 首先它叫 UIGF 格式，其次一直是适配的，只是SG的导入导出规则较为宽泛，如果您从始至终仅使用且正确使用了我们的产品，是不会出现导入导出异常的问题的

]]> 第二期开发组座谈会

复制自 GitHub 讨论帖，总结于群讨论

现在成就导出的json格式也是UIGF的嘛

A: UIAF

能否适配祈愿系统数据UEFI旧版本的导入，和SG一样就可以

A: 首先它叫 UIGF 格式，其次一直是适配的，只是SG的导入导出规则较为宽泛，如果您从始至终仅使用且正确使用了我们的产品，是不会出现导入导出异常的问题的

啥时候会有sg那种自动检查更新下载

A: 自动更新不能在MSIX包上实现，检查更新会在后续版本推出。

我同一个设备上同时登陆SG，hutao会算作一个设备还是两个设备

A: 两个设备,理论上每次重启胡桃后均相当于切换了设备

我感觉胡桃有些页面的加载需要很久，会影响使用体验，感觉胡桃的界面有点掉帧

A: 深渊统计页面在1.2.6版本前确实存在加载慢的问题，已在新版本解决，如果有其他页面的卡顿问题，通常是因为你的显卡不够强劲，或者胡桃通过你的集显进行渲染。

属性统计经常加载不了

A: 历史遗留问题，可以通过备份数据后删除 userdata.db 解决

自定义网页功能是否还有规划

A: 别急

微软方面的问题，我们无法解决

  • 有的时候使用管理员启动并不能获取到管理员权限，需要关掉后二次启动
  • 胡桃的图标尺寸可不可以改成像其他图标—样的小尺寸呀
  • 写入的注册表文件，在更新时遇安装问题，尝试所有修复无果，在卸载重装进行修复的过程中会否因卸载残留问题对重装造成影响
]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2023-01-11T09:40:39.000Z Copyright by DGP-Studio 为什么... https://hut.ao/FAQ/why.html 2023-02-14T08:01:36.000Z 为什么...

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

为什么在设置中点击修改游戏路径无效

特定系统版本的用户，由于微软对文件选择对话框的COM实现的差异，会存在点击按钮后无响应的问题。

相关的 Github Issue

为什么程序会出现乱码现象

  • 当用户在 Windows 10 下使用胡桃且发现有乱码情况时：
    • 可以下载 Segoe Fluent Icons字体
    • 安装时选择为系统所有用户安装，即可解决问题
  • 您可以从 微软官方下载到该字体文件
]]> 为什么...

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

为什么在设置中点击修改游戏路径无效

特定系统版本的用户，由于微软对文件选择对话框的COM实现的差异，会存在点击按钮后无响应的问题。

相关的 Github Issue

为什么程序会出现乱码现象

  • 当用户在 Windows 10 下使用胡桃且发现有乱码情况时：
    • 可以下载 Segoe Fluent Icons字体
    • 安装时选择为系统所有用户安装，即可解决问题
  • 您可以从 微软官方下载到该字体文件

为什么解锁帧率后使用心海时出现掉帧

原神的BUG，和我们没关系

为什么会弹出需要使用新应用以打开的对话框

uninstall-error

如在卸载胡桃工具箱后出现如上图所示的需要使用新应用以打开此 hutao 链接，说明没有按文档要求在卸载前清除实时便笺定时任务。 请根据文档在设置中清除定时任务后再卸载胡桃工具箱。

  • 如果你在系统定时任务中找不到胡桃的定时任务，但问题仍然出现，请参考这份文档来解决

为什么米游社帐号登录状态经常失效，添加的帐号消失

  • 我们通过储存帐号的米游社 Cookie 来维持登录状态。
  • 但是当用户在浏览器或其它设备上注销帐号后， 维持登录状态的 Cookie 将失效。
  • 这会导致胡桃工具箱上的米游社帐号在启动后被自动移除。
  • 此情况也可能因为网络连接问题导致无法检查Cookie有效性，故出现此情况后请优先重启胡桃工具箱。
  • 自2022年10月起，米游社极大地提高了账号被判定为有风险的概率，账号有风险时亦会令Cookie无法被识别为有效状态
  • 自 1.4.15 版本起，你可以通过在帐号面板中刷新 Cookie 来刷新登录状态

为什么游戏登录状态会失效，导致切换帐号功能无效

  • 保存游戏登录状态的要素有两个：网络环境和设备 ID
  • 导致该问题的常见原因是：
    • 网络环境频繁变换，如公网 IP 更换
    • 操作失误，导致实际上根本没有保存登录状态（空的登录状态无法避免被胡桃识别）
      • 确认你的帐号已登录后，进入游戏
      • 关闭游戏后，确定游戏进程已关闭
      • 再次进行帐号检测，来添加登录状态

为什么程序会提示注册计划任务失败

使用管理员模式使用一次实时便笺后，胡桃的任务计划会被以管理员权限创建。当再次以非管理员模式启动胡桃时，程序在修改计划任务时会缺少权限。 继续使用管理员模式即可解决该问题。

为什么在开启代理后胡桃工具箱会没有网络连接

参考 HttpRequestException 错误 文档

为什么商店版本和侧载版本不会相互覆盖升级

  • 商店版本和侧载版本有不同的软件 ID，所以会被系统识别为不同的程序
  • 商店版的更新只会覆盖商店版应用；侧载版更新包只会更新侧载版应用
  • 在你的系统中，商店版的胡桃工具箱名称为 Snap Hutao，侧载版的名称为 胡桃
]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2023-01-11T08:44:12.000Z Copyright by DGP-Studio 如何... https://hut.ao/FAQ/how-to.html 2023-02-14T08:01:50.000Z 如何...

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

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

社区力量

感谢 CzHUV 提供的解决方案

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

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

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

社区力量

感谢 CzHUV 提供的解决方案

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

如何实现自动化管理员模式

请使用如下的 PowerShell 脚本启动胡桃

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

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

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

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

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

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

    quick-start

  • 选择启动游戏即可

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

参考 HttpRequestException 错误 文档

]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2023-01-11T08:06:20.000Z Copyright by DGP-Studio 用户数据和隐私权益 https://hut.ao/statements/privacy-notice.html 2023-02-11T08:44:41.000Z 用户数据和隐私权益

胡桃工具箱充分尊重用户的隐私，目前我们会按下方的说明使用用户的数据：

  • 使用胡桃后，在 数据目录 中以数据库文件的形式

    • 储存
      • 米游社 Cookie
      • 胡桃的软件设置信息
      • 全部的用户数据

  • 使用胡桃主程序时，胡桃会因开发和统计为目的匿名化地收集程序意外停止或出错时抛出的日志，包括：

    • 用户设备 ID
    • 错误与崩溃日志
    • 用户活跃数据统计信息

  • 使用 胡桃数据库 (深渊记录/深渊统计) 功能并选择上传数据时，

    • 向 胡桃 API 上传
      • 用户的游戏 UID
      • 用户的深境螺旋记录
      • 用户的角色信息及其装备的武器和圣遗物信息

  • 使用实时便笺功能后

    • 在 Windows 定时任务中创建一个用于获取数据的定时任务

  • 使用高级启动器中的服务器切换功能后，在原神截图目录中

    • 储存服务器转换所需要的文件
]]> 用户数据和隐私权益

胡桃工具箱充分尊重用户的隐私，目前我们会按下方的说明使用用户的数据：

  • 使用胡桃后，在 数据目录 中以数据库文件的形式

    • 储存
      • 米游社 Cookie
      • 胡桃的软件设置信息
      • 全部的用户数据

  • 使用胡桃主程序时，胡桃会因开发和统计为目的匿名化地收集程序意外停止或出错时抛出的日志，包括：

    • 用户设备 ID
    • 错误与崩溃日志
    • 用户活跃数据统计信息

  • 使用 胡桃数据库 (深渊记录/深渊统计) 功能并选择上传数据时，

    • 向 胡桃 API 上传
      • 用户的游戏 UID
      • 用户的深境螺旋记录
      • 用户的角色信息及其装备的武器和圣遗物信息

  • 使用实时便笺功能后

    • 在 Windows 定时任务中创建一个用于获取数据的定时任务

  • 使用高级启动器中的服务器切换功能后，在原神截图目录中

    • 储存服务器转换所需要的文件
]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2023-01-11T07:17:53.000Z Copyright by DGP-Studio 用户使用协议和法律声明 https://hut.ao/statements/tos.html 2023-01-27T06:07:29.000Z 用户使用协议和法律声明

总则

  • 本"用户使用协议和法律声明"（以下简称"条款"或"使用协议"）适用于DGP-Studio开发团队（以下简称"本团队"或"我方"）开发的全部软件作品、各开发项目的官方网站、附属的自媒体账号等。
    • 请您仔细阅读本用户使用协议的全部内容，在您阅读"使用协议"后，若对此用户使用协议中的任何条款有异议，请立刻停止使用本团队所开发的任意项目。
    • 如您未满18周岁，请在法定监护人陪同下仔细阅读并充分理解本协议，并征得法定监护人的同意后使用本团队所开发的任意项目。
    • 若您已安装、使用或在开发时引用本团队所开发的任意项目，表示您已主动阅读(已阅读完毕)并完全同意本使用协议所列明的条款，即已充分理解本协议并承诺作为本协议的一方当事人接受协议、法律声明、隐私政策以及与本团队所开发的任意项目相关的规则、规范、声明、公告、通知等内容的约束。
    • 此《用户使用协议》是由用户(以下或称"您")与本团队所开发的任意项目所订立的用户使用协议和法律声明，本协议对用户和本团队均具有法律效力。
]]> 用户使用协议和法律声明

总则

  • 本"用户使用协议和法律声明"（以下简称"条款"或"使用协议"）适用于DGP-Studio开发团队（以下简称"本团队"或"我方"）开发的全部软件作品、各开发项目的官方网站、附属的自媒体账号等。
    • 请您仔细阅读本用户使用协议的全部内容，在您阅读"使用协议"后，若对此用户使用协议中的任何条款有异议，请立刻停止使用本团队所开发的任意项目。
    • 如您未满18周岁，请在法定监护人陪同下仔细阅读并充分理解本协议，并征得法定监护人的同意后使用本团队所开发的任意项目。
    • 若您已安装、使用或在开发时引用本团队所开发的任意项目，表示您已主动阅读(已阅读完毕)并完全同意本使用协议所列明的条款，即已充分理解本协议并承诺作为本协议的一方当事人接受协议、法律声明、隐私政策以及与本团队所开发的任意项目相关的规则、规范、声明、公告、通知等内容的约束。
    • 此《用户使用协议》是由用户(以下或称"您")与本团队所开发的任意项目所订立的用户使用协议和法律声明，本协议对用户和本团队均具有法律效力。

项目性质、服务以及有关责任与义务的界定

  • 一、由于本团队所开发的任意项目，均"开源"、"非经营性质"，故本团队可随时执行全权决定：包括但不限于更改"使用协议"，修改本团队所开发的任意项目内的任何内容。如"条款"及"作品的内容"有任何变更，我方将在相关的项目展示网站上刊载公告作为通知。经修订的"条款"一经在官方网站上公布后，即自动生效。

  • 二、本软件以"学习开发知识"、"积累开发经验"为目的进行开发，所有项目所提供的功能，均"开源"、"非经营性质"，如用户对本团队所开发的任意项目的安全性表示不满，请立即卸载/删除/停用，如您仍在正常使用，则表示您认可本团队所开发的任意项目的安全性。

  • 三、一切因使用本团队所开发的任意项目的内容而导致的"任何意外损失(包括但不限于：软件、硬件、财产以及虚拟物品等)"、"合约毁坏"、"诽谤"、"版权或知识产权侵犯"及其所造成的损失与责任，均为使用者自身对于网络公开的开源软件的使用过程中自身发生的使用行为所引致的"损失与责任",基于全部作品在其开放源代码的位置(即Github)中所声明的MIT license以及本声明所约定的内容，应当认定前述的"损失与责任"与全部项目的有关开发者无责任关联。

  • 四、用户使用本团队所开发的任意项目期间，本团队不做任何不发生如下情况的保证：

    • 因网络状况、通讯线路等任何技术原因而导致用户不能正常使用或更新；
    • 因使用"第三方开发的本软件内插件"、"第三方进行二次编译的本软件的修改版"、"复用本开发团队所创作的项目代码而编译成的软件"造成负面结果。

  • 五、用户认可本团队所开发的任意项目，除被动接收软件或其他相关项目中的必要的上传报告或有关信息外，所有信息的上传均需要用户的主动触发；

    • 用户认可本团队所开发的任意项目，均完全尊重并保护所有用户的"个人隐私权"，项目代码亦完全公开，用户不具有"因隐私权收到侵犯"而对开发团队或团队成员发起控诉的主观理由。
    • 本团队所开发的任意项目不会向第三方共享、转让您的个人信息，除非经过您本人事先授权同意，或者共享、转让的个人信息是去标识化处理后的信息，且共享第三方无法重新识别此类信息的自然人主体。
    • 本团队所开发的任意项目包含到其他站点的链接，当您访问第三方链接时，请认真阅读第三方站点的用户协议和声明，本团队对于第三方站点的内容、隐私条款、使用协议等不负任何责任。
    • 在使用本团队所开发的任意项目时，提交任意资料的过程中，本团队不保证提交的信息保存成功，您需要对您提交的资料做好存储保管。本团队所开发的部分项目为"被授权数据"提供存储，但在存储过程中存在各种不可抗力的因素，本团队无法承诺对用户的存储信息无限期保留，您的重要信息请自行备份。

权利和义务

  • 六、我方允许任何单位或个人在没有本开发团队授权的情况下,对本团队所开发的任意项目进行的二次开发、功能修改以及复用我方创作的代码进行其他项目的开发，但对其所侵犯我方计算机软件著作权的行为，我方保留追责的权利。

    • 我开发团队不对任何单位或个人在使用本团队所开发的任意项目的内容进行的公开发布行为（包括但不限于制作视频、发布带有本软件内容的文章、上传至非我开发团队指定的下载网站提供下载等）的内容所致的任意结果进行负责。
    • 我开发团队不对使用"第三方开发的可用于本团队所开发的任意项目的附属程序或额外代码"、"第三方进行二次编译的本团队所开发的任意项目的修改版"、"复用本开发团队所创作的项目代码而编译成的软件"造成的任意结果负责。
    • 在此基础上，根据《计算机软件保护条例》第二条与第三条对于"计算机软件"和"文档"的法律定义，本软件开发团队（DGP Studio）保留全部我方开发项目的计算机软件著作权，其包括但不限于项目构建所需的全部信息、全部项目有关的所有文档资料（即用来描述程序的内容、组成、设计、功能规格、开发情况的程序设计说明书、流程图、用户手册等），具体内容以各项目《计算机软件著作权登记证书》的实际内容为准。

  • 七、本团队所开发的任意项目仅作用于合法、合规范围内的学习及研究所用，不得利用本软件系统从事违法活动。

    • 本团队仅作为项目的开发团队（非法人性质，为自然人组成的团体），对任何使用结果不负任何连带责任，软件以及我方开发的任意项目的使用过程中产生的任何法律后果我们概不负责、不承担任何法律责任。
    • 若用户已开始使用本团队所开发的任意项目，即已同意"使用协议"，表明本团队已履行完毕"本使用协议第十款"的告知情形。

  • 八、所开发项目的著作权。

    • 本软件开发团队对所开发的"Snap.Genshin软件"、"Snap.Hutao软件"等作品的软件本身（不包括软件内除功能模块外的显示内容）、上述作品的全部历史版本以及周边网站，以及本团队所开发的任意其他作品，拥有软件内的"各商标的所有权"（引用于网络的图片除外），"著作权"等有关的应有权益。
    • 本团队所开发的任意项目的统计数据全部来源于软件用户主动提交，经过对数据简单地筛选后进行展示，因此本团队所开发的任意项目不对数据的准确性负责，该数据也与我方无关。
    • 使用本团队所开发的任意项目的过程中可能会产生拥有原有版权的数据，对于这些数据，本团队所开发的任意项目不拥有它们的所有权，为了避免造成侵权，使用者有义务完全阅读并履行"本使用协议第十条"的内容。本软件内使用的资源（包括但不限于字体、图片、文字等）均来源于互联网的公开信息，如果出现侵权可立即联系我方移除。

其他条款

  • 九、对于团队所开发项目的"非经营性质"的确定。

    • 本团队所开发的任意项目，均无任何经营性质。

    • 若开发团队的个别或部分成员，在参与开发本团队所开发的任意项目期间，与本团队所开发的任意项目的第三方用户间产生了包括但不限于：赠与、交换、买卖等关系，其所产生的关系与本开发团队无关，此种情形的发生不基于团队开发有关项目这一事实，而是基于其与第三方用户，在发生上述关系的互联网交互位置或现实地点所产生的独立事件，应当以发生上述关系的互联网交互位置的用户使用条款或结合其在现实地点所发生的具体行为来判定此行为的性质。

  • 十、本团队所开发的任意项目（含网站），均以"学习开发知识"、"积累开发经验"为目的进行开发，仅供学习交流，严禁用于商业用途，请您在下载或进行查看学习后的24小时内自行删除全部相关信息，若您无视本条要求，本软件开发团队不对"可能产生的版权纠纷、著作权侵权以及民事纠纷等问题"负责。

  • 十一、本协议的成立、生效、履行、解释及争议的解决均应适用中华人民共和国大陆地区法律。倘本协议之任何规定因与中华人民共和国的法律抵触而无效，则这些条款将尽可能接近本协议原条文意旨重新解析，且本协议其它规定仍应具有完整的效力及效果。

  • 十二、本协议签订地点为辽宁省盘锦市辽河油田矿区，在履行本协议中发生纠纷，由双方协商解决，如协商不成，由辽河人民法院管辖，所产生的每阶段费用均由上诉人即时承担。

  • 十三、本协议中的标题（包括副标题）仅为方便及阅读而设，并不影响本协议中任何规定的含义或解释。

  • 十四、您和本开发团队均是独立的主体，在任何情况下本协议不构成本开发团队对用户的任何形式的明示或暗示担保或条件，双方之间亦不构成代理、合伙、合营或雇佣关系。

  • 十五、本"用户使用协议和法律声明"中，"我方"或称"本开发团队"(区别于"用户"或"您")的实际主体为DGP-Studio开发团队的团队整体及每个成员个人，即包含前述网站中，DGP-Studio开发团队的全部成员。

]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2023-01-11T06:50:45.000Z Copyright by DGP-Studio 使用第三方工具获取有 Stoken 的 cookie https://hut.ao/FAQ/get-stoken-cookie-from-the-third-party.html 2023-01-12T13:18:04.000Z 使用第三方工具获取有 Stoken 的 cookie

注意

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

Android

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

]]> 使用第三方工具获取有 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 下载 Stream
  • 对域名 api-takumi.mihoyo.com 进行抓包分析
  • 找到并复制带有 Stoken 的数据
    • 形如stuid=****;stoken=v2****;mid=****;
  • 将复制到的 Stoken 发送到已经安装了胡桃工具箱的电脑
  • 在胡桃工具箱中的账号登录位置，点击手动输入
  • 将之前获取到的 cookie 输入，此时即可完成登录
]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2023-01-10T11:24:42.000Z Copyright by DGP-Studio 养成计划 https://hut.ao/features/develop-plan.html 2023-01-12T13:18:04.000Z 养成计划

dev-plan

添加养成目标进入材料清单

基于 WIKI 资料添加

  • 在胡桃工具箱的左侧栏目中，点击角色资料或武器资料功能
  • 在"胡桃工具箱"的整体界面右上部分，点击养成计算按钮
  • 在弹出的"添加到当前养成计划"的窗口中，填写角色需要计算的各项属性的起始等级以及目标等级
    • 基于 WIKI 资料添加的养成目标，默认初始值为1级
]]> 养成计划

dev-plan

添加养成目标进入材料清单

基于 WIKI 资料添加

  • 在胡桃工具箱的左侧栏目中，点击角色资料或武器资料功能
  • 在"胡桃工具箱"的整体界面右上部分，点击养成计算按钮
  • 在弹出的"添加到当前养成计划"的窗口中，填写角色需要计算的各项属性的起始等级以及目标等级
    • 基于 WIKI 资料添加的养成目标，默认初始值为1级

基于玩家数据添加

  • 在"胡桃工具箱"的左侧栏目中，点击我的角色功能
  • 在选中角色后，点击右上角的养成计算按钮
  • 在弹出的"添加到当前养成计划"的窗口中，填写角色需要计算的各项属性的"起始等级"以及"目标等级"
    • 基于玩家数据添加的养成目标，默认初始等级为玩家当前的角色等级
    • 请参考属性统计文档以获取更多信息

背包物品

  • 在"胡桃工具箱"的左侧栏目中，点击"养成计划"功能
  • 点击"背包物品"功能栏
  • 在"胡桃工具箱"的整体界面右上部分，点击"新建计划"按钮
  • 在弹出的"创建新的养成计划"的窗口中，填写需要创建的养成计划名称
    • 此处可勾选"绑定当前选中的账号角色"
    • "新建计划"按钮左侧的下拉选项框，可自行切换不同的养成计划
  • 点击下方的任意物品图标或数字区域，即可手动编辑该种材料的数目
    • 背包物品的具体材料信息，对应于其修改时，所切换至的养成计划
  • 在"胡桃工具箱"的整体界面右上部分，可点击"删除计划"按钮，将当前的养成计划删除
    • 在删除当前养成计划后，处于切换至该养成计划时，输入的背包物品信息将一同删除

功能说明

此功能尚在完善阶段，若您有建设性的建议，或发现了显著的问题，请按此页面直接向我们反馈，感谢您的贡献！

]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2022-12-15T18:18:42.000Z Copyright by DGP-Studio 武器资料 https://hut.ao/features/weapon-wiki.html 2023-01-12T13:18:04.000Z 武器资料

weapon-wiki

武器资料是胡桃工具箱中内置的用于查询各个武器的外观、参数、精炼效果、推荐搭配等数据的 Wiki

已包含的数据

  • 武器列表
    • 使用列表左上角的按钮，可切换列表显示的方式：即"缩略图与名称"或"仅缩略图"
    • 单击列表中的缩略图或名称，即可跳转到相应的介绍页面
  • 数据内容
    • 武器基本信息
      • 突破前后的武器图标对比
      • 对应武器的立绘展示
      • 武器的简介内容
      • 可切换至对应等级的武器各项数值
    • 武器精炼信息
      • 对应精炼阶数的精炼属性
    • 根据胡桃数据库的统计信息而展示的武器使用的相关推荐
]]> 武器资料

weapon-wiki

武器资料是胡桃工具箱中内置的用于查询各个武器的外观、参数、精炼效果、推荐搭配等数据的 Wiki

已包含的数据

  • 武器列表
    • 使用列表左上角的按钮，可切换列表显示的方式：即"缩略图与名称"或"仅缩略图"
    • 单击列表中的缩略图或名称，即可跳转到相应的介绍页面
  • 数据内容
    • 武器基本信息
      • 突破前后的武器图标对比
      • 对应武器的立绘展示
      • 武器的简介内容
      • 可切换至对应等级的武器各项数值
    • 武器精炼信息
      • 对应精炼阶数的精炼属性
    • 根据胡桃数据库的统计信息而展示的武器使用的相关推荐
]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2022-11-29T09:29:08.000Z Copyright by DGP-Studio 软件设置 https://hut.ao/features/hutao-settings.html 2023-01-18T19:58:16.000Z 软件设置

相关信息

  • 以下内容将以胡桃工具箱内的设置功能的条目排列顺序为介绍顺序

关于 胡桃

  • 胡桃工具箱的图标：您可以在胡桃的首页查看它的原图
  • 胡桃的版本号
  • 设备ID
  • 反馈
    • 点击前往反馈的按钮，即可跳转至相关页面
]]> 软件设置

相关信息

  • 以下内容将以胡桃工具箱内的设置功能的条目排列顺序为介绍顺序

关于 胡桃

  • 胡桃工具箱的图标：您可以在胡桃的首页查看它的原图
  • 胡桃的版本号
  • 设备ID
  • 反馈
    • 点击前往反馈的按钮，即可跳转至相关页面

外观

  • 背景材质
    • 在此选项中，您可以更改背景的材质为：
      • 亚克力
      • 云母
      • 变种云母
    • 每个背景材质被选中后，您可以即时查看更改后的效果

祈愿记录

  • 在此条目中，您可以选择是否隐藏无记录的历史祈愿活动，即"没有祈愿记录的卡池"

游戏

  • 游戏路径

    • 在此条目中，可以修改或设置您的游戏路径
    • 选择游戏路径时，请注意此处选择的应是游戏本身
    • 形如："$\Genshin Impact\Genshin Impact Game\YuanShen.exe"

  • 删除游戏内网页缓存

    • 若您在使用祈愿记录功能时，选择使用"从缓存刷新"，但频繁提示验证密钥过期，可以尝试此操作
    • 点击此选项内的删除按钮即可

测试功能

  • 打开数据文件夹

    • 在此选项中点击"打开"按钮，即可打开包含"用户数据/日志/元数据"的文件夹
    • 尤其在您需要反馈或需要以通用方式排查问题时，可以在此处快捷打开此文件夹，并进行进一步操作

  • 打开缓存文件夹

    • 在此选项中点击"打开"按钮，即可打开包含"图片缓存"的文件夹
    • 在此文件夹内，存储了胡桃工具箱在运行期间产生的图片缓存

米游社每日签到

提示

米游社签到功能主要用于米游社帐号登录状态监测

  • 如何使用
    • 首先需要您在米游社多账号切换功能中，选中当前需要进行签到的米游社账号
    • 点击"打开签到对话框"按钮
    • 胡桃工具箱会打开签到页面，随后你即可手动签到
  • 该功能的正常使用界面：
    米游社每日签到

危险功能

  • 删除所有计划任务
    • 当你需要卸载胡桃工具箱时，可以使用此功能以删除胡桃工具箱的定时数据拉取任务
  • 删除所有用户
    • 此功能的作用是删除用户表的所有记录
    • 点击执行按钮即可完成删除
    • 通常情况下，用户不需要使用此功能来删除用户表的信息
]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2022-11-27T07:34:56.000Z Copyright by DGP-Studio 账号风险及异常提示 https://hut.ao/FAQ/mihoyo-risk-tip.html 2023-02-14T08:01:50.000Z 账号风险及异常提示

image image

]]> 账号风险及异常提示

image image

  • 当胡桃工具箱返回"账号有风险，请前往米游社查看"、"请求异常，请前往米游社对应功能页面查看"、"无感验证失败，请前往「米游社我的角色实时便笺」页面查看 "等错误提示时，代表当前的操作被米游社的验证系统所阻挡

  • 解决方式

    • 方法1
    • 方法2：
      • 使用手机打开米游社App
      • 点击我的
      • 点击个人主页
      • 点击我的角色下方的角色标签
        • 点击全部角色
        • 或可以点击实时便笺窗体
      • 完成在此期间可能随机触发的验证流程（例如验证码），即可解决本问题。
        • 若此操作未触发验证流程，可重复进行多次，直到触发验证为止
        • 若始终无法触发验证，可修改密码

提示

  • 若风险提示过于频繁，或始终无法触发验证，代表您的账号风险已过高，请修改密码，使多个设备同时登录的状态被重置

注意

  • 若您已绑定并使用可提供原神查询的Bot或同时有多个设备使用同一个米哈游通行证，则本条目所示的情况，尤其无感验证将基本无法成功，这是米游社后端的安全性设计，不可避免，无法绕过
  • 若您本地有多个米哈游通行证同时频繁与米游社进行数据交互，则可能会被米游社在一定时间内封禁IP地址，这是米游社后端的安全性设计，不可避免，无法绕过
]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2022-11-11T10:26:36.000Z Copyright by DGP-Studio 实时便笺 https://hut.ao/features/daily-notes.html 2023-01-12T13:18:04.000Z 实时便笺

相关信息

该功能需要你在胡桃工具箱中登录米游社帐号，登录方法可见米游社多帐号切换文档

live-data-tracking

]]> 实时便笺

相关信息

该功能需要你在胡桃工具箱中登录米游社帐号，登录方法可见米游社多帐号切换文档

live-data-tracking

添加角色

  • 点击添加角色按钮
  • 在弹出的添加角色浮窗中，选择您要添加的游戏角色，并单击其右侧的加号按钮
  • 此时您添加的游戏角色即可显示在实时便笺页面中
    • 实时便笺是间隔固定时间自动刷新的
      • 你可以点击窗口右上角的通知设置来设置查询的间隔时间
      • 如您需要立即刷新以获取实时的最新数值，请单击立即刷新按钮
    • 如出现"账号有风险，请前往米游社查看"字样的提示

全局通知设置

  • 在窗口右上角点击通知设置可以修改实时便笺的全局设置，包括：
    • 数据刷新间隔时间
    • 通知免打扰
    • 高优先度通知
      • 这将避免胡桃工具箱的通知被自动收入操作中心
      • 请注意，开启此设置可能会让您在日常使用电脑期间受到打扰

帐号独立设置

  • 胡桃工具箱的实时便笺功能允许用户对每一个被监控的帐号给予不同的设置
  • 将鼠标停留在需要被设置的角色实时便笺的窗体上
  • 点击其窗体右上角出现的设置图案按钮，即可修改如下参数
    • 原粹树脂提醒阈值
    • 洞天宝钱提醒阈值
    • 启用参量质变仪提醒
    • 启用每日委托上限提醒
    • 启用探索派遣完成提醒
    • 启用在主页显示卡片 (未上线的新功能)
  • 点击保存，即可保存您当前所设置的通知选项

删除角色

  • 将鼠标停留在需要被设置的角色实时便笺的窗体上
  • 点击其窗体右上角出现的移除标志按钮，即可移除该角色对应的实时便笺
]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2022-11-11T10:26:36.000Z Copyright by DGP-Studio 圣遗物评分机制 https://hut.ao/FAQ/artifact-rating-rules.html 2023-01-12T13:18:04.000Z 圣遗物评分机制

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

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

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

]]> 圣遗物评分机制

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

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

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

]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2022-11-11T06:55:02.000Z Copyright by DGP-Studio 属性统计 https://hut.ao/features/character-data.html 2023-01-18T19:58:16.000Z 属性统计

相关信息

该功能需要你在胡桃工具箱中登录米游社帐号，登录方法可见米游社多帐号切换文档

属性统计，即主程序侧栏中的我的角色功能，可读取当前账号所拥有角色的具体数据，包括等级、命之座、武器、天赋、圣遗物等；并自动计算圣遗物评分和双爆评分

属性统计示例图

]]> 属性统计

相关信息

该功能需要你在胡桃工具箱中登录米游社帐号，登录方法可见米游社多帐号切换文档

属性统计，即主程序侧栏中的我的角色功能，可读取当前账号所拥有角色的具体数据，包括等级、命之座、武器、天赋、圣遗物等；并自动计算圣遗物评分和双爆评分

属性统计示例图

同步角色信息

从 Enka API 同步

同步特征

  • Enka API 同步游戏内角色橱窗中公开展示的角色的信息
    • 该同步方式包括圣遗物具体数据
    • 该同步方法包括角色着装信息
    • 该同步方式一次最多包含8个角色
  • 在游戏中将角色橱窗设置为公开并添加需要获取详细资料的角色进入橱窗展示
    • 角色橱窗中最多可同时展示8个角色
  • 若您更换了橱窗内的角色或角色内的配置，需等待游戏内的数据同步至服务器
    • 开启功能和更换角色后需要最多5分钟同步数据
  • 进入胡桃工具箱的我的角色功能页面，在界面右上角点击同步角色信息
  • 点击从Enka API 同步

从 米游社我的角色 同步

同步特征

  • 米游社我的角色 同步的数据来源于米游社数据
    • 该同步方式不包含圣遗物信息
    • 该同步方式一次可同步全部角色信息
  • 在胡桃工具箱的我的角色功能页面，在界面右上角点击同步角色信息
  • 点击从米游社我的角色同步

从 米游社养成计算 同步

同步特征

  • 米游社养成计算 同步的数据来源于米游社养成计算数据
    • 该同步方式包含角色天赋等级信息
    • 该同步方式一次可同步全部角色信息
  • 在胡桃工具箱的我的角色功能页面，在界面右上角点击同步角色信息
  • 点击从米游社养成计算同步

将当前选定角色加入养成计算

  • 在胡桃工具箱的我的角色功能页面，点击切换至需要加入养成计算的角色的资料页面
  • 点击界面右上方的"养成计算"按钮，输入目标等级
    • 已同步数据的角色的当前角色等级、天赋等级会预填入其中，目标等级可自由更改

rolescal

  • 添加完毕后，您可在"养成计划"功能中查看"已添加的养成目标"

image

  • 关于养成计划功能的详细说明，请见养成计划文档

导出图片

  • 在我的角色页面中，你可以在选择一个角色的情况下点击右上角的导出图片按钮以将角色数据转化为图片形式，这将有助于你分享你的角色信息
  • 导出的图片储存在系统剪贴板中，你可以在合适的地方直接粘贴以获得该图片
  • 导出图片样式如下图所示

sample-output-image

]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2022-11-10T03:38:32.000Z Copyright by DGP-Studio 角色资料 https://hut.ao/features/character-wiki.html 2023-01-12T13:18:04.000Z 角色资料

characters-wiki

角色资料是胡桃工具箱中内置的用于查询各个角色的基础信息、天赋数值、命之座、培养材料等数据的 wiki

已包含的数据

  • 角色列表
    • 使用列表左上角的按钮，可切换列表显示的方式：即"缩略图与名称"或"仅缩略图"
    • 单击列表中的缩略图或名称，即可跳转到相应的介绍页面
  • 数据内容
    • 角色基本信息
      • 介绍
      • 各等级下的数值
      • 属性
  • 天赋
    • 基本介绍
    • 可切换至对应等级天赋的各项数值
  • 命之座
  • 根据"胡桃数据库"的统计信息而展示的角色队伍搭配、武器搭配以及圣遗物搭配的相关推荐
  • 其他信息
    • 角色立绘
    • 特色料理
    • 衣装信息
    • 角色资料
    • 角色故事
]]> 角色资料

characters-wiki

角色资料是胡桃工具箱中内置的用于查询各个角色的基础信息、天赋数值、命之座、培养材料等数据的 wiki

已包含的数据

  • 角色列表
    • 使用列表左上角的按钮，可切换列表显示的方式：即"缩略图与名称"或"仅缩略图"
    • 单击列表中的缩略图或名称，即可跳转到相应的介绍页面
  • 数据内容
    • 角色基本信息
      • 介绍
      • 各等级下的数值
      • 属性
  • 天赋
    • 基本介绍
    • 可切换至对应等级天赋的各项数值
  • 命之座
  • 根据"胡桃数据库"的统计信息而展示的角色队伍搭配、武器搭配以及圣遗物搭配的相关推荐
  • 其他信息
    • 角色立绘
    • 特色料理
    • 衣装信息
    • 角色资料
    • 角色故事

添加至养成计划

  • 在角色资料页面，你可以在选定角色后，点击右上角的养成计算按钮来将该角色添加至你的养成计划中
    • 该养成计划将默认从角色1级开始培养
    • 如果你需要基于当前已有的角色创建养成计划，可以使用我的角色功能
]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2022-11-10T03:38:17.000Z Copyright by DGP-Studio 高级启动器 https://hut.ao/features/game-launcher.html 2023-01-29T11:05:32.000Z 高级启动器
  • 胡桃工具箱提供的高级启动器功能中通过多样的设置选项来允许用户以自定义设置启动游戏
  • 你可以通过点击左侧菜单栏中的启动游戏进入高级启动器功能
    • 第一次使用时你会被跳转到设置页面以设置你的游戏路径
    • 选择游戏路径时，请注意此处选择的应是游戏本身
      • 形如：$\Genshin Impact\Genshin Impact Game\YuanShen.exe
      • 而官方启动器的目录一般是$\Genshin Impact\launcher.exe
  • 在设置完毕启动游戏所需的附加选项后，点击右下角的启动游戏按钮即可
    • 附加选项请看本页下方的功能文档
]]> 高级启动器
  • 胡桃工具箱提供的高级启动器功能中通过多样的设置选项来允许用户以自定义设置启动游戏
  • 你可以通过点击左侧菜单栏中的启动游戏进入高级启动器功能
    • 第一次使用时你会被跳转到设置页面以设置你的游戏路径
    • 选择游戏路径时，请注意此处选择的应是游戏本身
      • 形如：$\Genshin Impact\Genshin Impact Game\YuanShen.exe
      • 而官方启动器的目录一般是$\Genshin Impact\launcher.exe
  • 在设置完毕启动游戏所需的附加选项后，点击右下角的启动游戏按钮即可
    • 附加选项请看本页下方的功能文档

视频指南

对于大多数人而言，遵循本页文档会有更高的效率。

但如果你对其中包含的操作不熟悉，也可以回到这里来跟着视频指南操作。

胡桃工具箱指南 4 - 高级启动器（切换帐号/切换服务器/帧率解锁）

切换服务器

权限提示

  1. 使用该功能时需要以管理员权限启动胡桃工具
  2. 胡桃工具箱会在游戏截图目录下创建一个名为 HutaoCache 的文件夹并储存转换服务器所需要的文件
  • 在主界面点击左侧菜单栏进入启动游戏页面
  • 点击右侧选项中的服务器名称，选择要进入的服务器
    • 目前可选的服务器为官方服|天空岛、渠道服|世界树和国际服
  • 点击右下角的启动游戏按钮，胡桃会自动下载并应用对应服务器的文件并启动游戏

账号保存

提示

  1. 本功能所描述的帐号，特指当前原神所登录游戏账号的登录状态
  2. 获取当前原神的登录状态通常需要管理员权限，建议使用管理员模式启动胡桃
  3. 目前仅支持切换官方服（不含渠道服）帐号
官方服 渠道服 国际服
保存登录状态 支持 支持 支持
切换账号 支持 不支持 理论支持
我们期待更多的社区开发者帮助
  1. 在主界面点击左侧菜单栏进入启动游戏标签
  2. 点击账号功能中的检测按钮，胡桃工具箱会保存当前原神游戏的登录状态
  3. 在弹出的为账号命名界面中，输入您要为此账号设置的名称，点击确认
  4. 在游戏中，注销当前登录并登录你另一个帐号。重复执行上述的第2步和第三步直至你将全部的帐号添加进胡桃工具箱中。
  5. 此时即可在账号功能下方自由选择您要切换的账号
    • 每个已保存的账号均为可点击选择的按钮
    • 在其右侧有三个按钮，分别为：
      • 绑定当前用户角色，即将您当前选择的米游社登录状态绑定至该账号中，点击该按钮后，对应的UID将出现在该账号自定义名称的下方
      • 重命名，即修改当前选择账号的自定义名称
      • 删除，即删除当前选择的账号

外观选项

注意

  • 在当前的游戏版本中，有案例表明部分用户使用胡桃工具箱，选择全屏模式启动原神游戏，出现游戏无响应或卡顿的情况
    • 建议此部分用户使用无边框选项进行启动游戏
  • 在主界面点击左侧菜单栏进入启动游戏标签
  • 在右侧的外观功能中，有四个选项：
    • 全屏，即选择启动游戏后的游戏界面是否设置为全屏
    • 无边框，即选择启动游戏后的游戏界面是否设置为无边框窗口
    • 宽度，即选择启动游戏后的游戏界面的宽度，例如1920
    • 高度，即选择启动游戏后的游戏界面的高度，例如1080

解锁帧率上限

警告

  • 请注意：此功能已明确标注为 Dangerous Feature，即危险功能，选择启用即代表您选择自行承担任意风险
  • 目前的版本，设置中无论是否超过60帧率的原神(含移动端)均会偶尔出现掉帧、卡顿甚至无响应、闪退等情况，这是原神在本版本中出现的普遍问题，并不是Unlocker项目的问题
  • Unlocker项目仅作用于 UnityPlayer 本身，即直接作用于 Unity3D 引擎，与游戏本体不发生直接关系，本质上与移动端中120帧率等设置无异，但您仍应谨慎使用并自行阅读用户协议

  • 使用管理员模式启动胡桃

  • 在主界面点击左侧菜单栏进入启动游戏标签

  • 在最下方可见 Unlock frame rate limit 选项

    • 在右侧点击开启或关闭按钮，所显示的 Disable 或 Enable 分别代表已禁用或已启用该功能
    • 在下方的 Set frame rate 选项中，可自由拖动拉杆，调整到您需要设置的最高帧率上限

  • 会导致解锁帧率上限失败的因素：

    • 解锁帧率上限，需要保持胡桃工具箱在开启状态
    • 游戏内未关闭垂直同步选项
    • 在显卡驱动中存在最大帧速率的设置
    • 在显卡驱动软件内存在未关闭的类似于节能模式的选项
]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2022-11-10T01:14:39.000Z Copyright by DGP-Studio 胡桃数据库/深渊统计 https://hut.ao/features/hutao-API.html 2023-01-12T13:18:04.000Z 胡桃数据库/深渊统计

胡桃工具箱提供两个主要的深境螺旋挑战统计的功能

  • 侧栏中的深渊统计是一个旨在通过统计并展示广大玩家深境螺旋挑战数据，来帮助对原神对战系统不熟悉玩家组建队伍、通关深渊、获取奖励的功能
  • 侧栏中的深渊记录是一个通过保存玩家每一期深境螺旋挑战数据来帮助个人玩家回顾游戏经历及个人数据收集的统计功能
    • 众多的玩家通过上传个人的深渊记录来形成胡桃数据库的深渊统计数据集
]]> 胡桃数据库/深渊统计

胡桃工具箱提供两个主要的深境螺旋挑战统计的功能

  • 侧栏中的深渊统计是一个旨在通过统计并展示广大玩家深境螺旋挑战数据，来帮助对原神对战系统不熟悉玩家组建队伍、通关深渊、获取奖励的功能
  • 侧栏中的深渊记录是一个通过保存玩家每一期深境螺旋挑战数据来帮助个人玩家回顾游戏经历及个人数据收集的统计功能
    • 众多的玩家通过上传个人的深渊记录来形成胡桃数据库的深渊统计数据集

查看深渊数据

注意

所有计算数据都基于已上传至胡桃数据库中的玩家数据，无法代表全部原神玩家的平均数据，数据仅做参考用途

数据刷新周期

  1. 深境螺旋统计数据（角色使用率、角色出场率、队伍出场）在北京时间每月1日和16日的4点自动清理。
    • 点击界面右上角的信息按钮你可以查看当前实时已上传的总数据
  2. 同时，若用户在30天内没有重新上传记录以更新数据，则其的角色持有数据将被清理

上传深境螺旋数据

  • 在主界面点击左侧菜单栏进入深渊记录功能页面
  • 点击右上角的刷新数据以确保胡桃工具箱客户端已经获取到最新的个人深境螺旋数据
  • 点击右上角的上传数据以上传你的深境螺旋数据
    • 这可能需要花费数秒，上传成功后你将会看到如下图的成功提示 upload-hutaoapi

  1. 角色持有数据与深境螺旋记录独立 ↩︎

  2. 只要拥有该角色，即使没有在深境螺旋中登场，也会被计入拥有的状态； 只要上传过深境螺旋记录，即会被计入全部玩家的数据中。 ↩︎

]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2022-10-25T09:46:00.000Z Copyright by DGP-Studio 米游社多帐号切换 https://hut.ao/features/mhy-account-switch.html 2023-01-27T08:00:30.000Z 米游社多帐号切换

提示

  • 本文档所描述的帐号切换指的是用于获取游戏数据的米游社帐号，不是原神游戏内的帐号
  • 在使用本功能前，你需要使用官方的米游社 App 登录你的帐号以初始化你的米游社功能
    • 如果在胡桃中登录的帐号名称格式为 user_123456789 则其有可能没有被初始化
]]> 米游社多帐号切换

提示

  • 本文档所描述的帐号切换指的是用于获取游戏数据的米游社帐号，不是原神游戏内的帐号
  • 在使用本功能前，你需要使用官方的米游社 App 登录你的帐号以初始化你的米游社功能
    • 如果在胡桃中登录的帐号名称格式为 user_123456789 则其有可能没有被初始化

多帐号管理样图

胡桃工具箱视频指南 - 米游社帐号登录

对于大多数人而言，遵循本页文档会有更高的效率。

但如果你对其中包含的操作不熟悉，也可以回到这里来跟着视频指南操作。

  • 你可以在程序主界面的左下角，设置按钮的上方找到帐号菜单，以管理你在胡桃工具箱中登录的米游社帐号。在弹出的面板中你可以：
    • 点击登录米哈游通行证按钮
    • 在弹出的内置浏览器中登录"米哈游通行证"账号
      • 您也可以通过点击手动输入按钮，直接输入米游社通行证 cookie 来添加您的帐号
      • 若您选择手动输入米游社 cookie，则该 cookie 必须包含 Stoken 字段
    • 在弹出的内置浏览器登陆成功后，点击右上角的"我已登陆"按钮
    • 完成后，您就可以在帐号管理面板切换已登录的米游社帐号了
      • 新添加米游社账号后，需在主界面左下角切换账号的功能中，手动点击一次新登录的账号，以将其设置为使用状态
      • 你可以在帐号管理菜单中复制对应帐号的 cookie 或从胡桃工具箱中删除该帐号

安全提示

  • Stoken 是一个安全敏感的 cookie 字段，你不应该在任何云端或其它无法保证数据安全的设备上储存含有 Stoken 字段的 cookie。
  • 从胡桃工具箱中复制获得的 cookie 中包含该字段，请慎重考虑是否为接受 cookie 的一方提供 Stoken 字段。
  • 在胡桃工具箱中通过密码或 cookie 登录米游社的过程中，你的数据只经米游社服务器和本地胡桃工具箱处理，不经过包括胡桃服务器在内的任何第三方服务。
]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2022-10-18T04:51:59.000Z Copyright by DGP-Studio 祈愿系统与导出原理 https://hut.ao/FAQ/Gacha-system-and-export-principal.html 2023-02-14T08:01:50.000Z 祈愿系统与导出原理

Gacha System and Principal

胡桃的祈愿系统相较 Snap Genshin 进行了整体架构上的重新设计。

本文将解释原神的祈愿记录机制和胡桃工具箱中祈愿导出功能的技术原理。

祈愿的获取

获取祈愿记录需要请求米哈游的API

关于此API, 有下列几个注意点

  • 通过米哈游服务器的API，只能查询到过去6个月内的祈愿记录
    • 这也是原神客户端中祈愿记录的来源
  • API存在请求速率限制，过快的请求会导致后续的请求失败，无法正常获取数据
]]> 祈愿系统与导出原理

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

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

祈愿的导出

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

]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2022-09-29T02:37:43.000Z Copyright by DGP-Studio 成就管理 https://hut.ao/features/achievements.html 2023-01-12T13:18:04.000Z 成就管理

胡桃工具箱提供成就管理功能，用户可以通过它浏览并管理所有的成就状态

  • 在第一次使用时，你需要根据提示点击创建新存档按钮以创造一个成就存档并为其命名
  • 创建第一个资料页后，你可以点击右上角的创建新存档来继续为更多的帐号创建成就记录档案
]]> 成就管理

胡桃工具箱提供成就管理功能，用户可以通过它浏览并管理所有的成就状态

  • 在第一次使用时，你需要根据提示点击创建新存档按钮以创造一个成就存档并为其命名
  • 创建第一个资料页后，你可以点击右上角的创建新存档来继续为更多的帐号创建成就记录档案

成就导入

  • 胡桃工具箱使用统一可交换成就标准数据标准来储存用户的成就数据
    • 该标准允许用户从其它成就导出工具中通过 Url 协议和剪贴板将数据导入到胡桃工具箱中
  • 你可以点击成就页面右上角隐藏菜单中的导入按钮，并选择从 UIAF 文件导入以加载以 UIAF 数据格式储存的第三方成就数据

推荐使用的成就识别工具

]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2022-09-29T02:37:43.000Z Copyright by DGP-Studio 祈愿记录 https://hut.ao/features/wish-export.html 2023-02-06T11:30:48.000Z 祈愿记录

抽卡是原神的核心玩法之一，无论是出于纪念、炫耀的目的还是认真规划抽取计划，对历史抽卡进行统计分析都是非常重要的。 但是原神官方只为玩家提供了半年的抽卡记录，这是很不友好的（但是他们还是统计了你一整年杀了多少提米的鸽子）。

因此，我们需要利用这半年的抽卡记录调取窗口，将抽卡记录转移到我们自己手中，这就是胡桃工具箱中祈愿记录导出功能的目的所在。

有关原神祈愿记录导出的技术原理，你可以参阅我们的祈愿系统与导出原理一文。

]]> 祈愿记录

抽卡是原神的核心玩法之一，无论是出于纪念、炫耀的目的还是认真规划抽取计划，对历史抽卡进行统计分析都是非常重要的。 但是原神官方只为玩家提供了半年的抽卡记录，这是很不友好的（但是他们还是统计了你一整年杀了多少提米的鸽子）。

因此，我们需要利用这半年的抽卡记录调取窗口，将抽卡记录转移到我们自己手中，这就是胡桃工具箱中祈愿记录导出功能的目的所在。

有关原神祈愿记录导出的技术原理，你可以参阅我们的祈愿系统与导出原理一文。

祈愿导出

原神抽卡记录的延迟性

胡桃工具箱获取抽卡记录的来源也为米哈游服务器，因此短时间内刚刚结束的抽卡无法被获取。 当你在游戏内抽卡历史记录中看到了最新的一批抽卡记录，则可以在胡桃中获取统计数据。

视频指南

对于大多数人而言，遵循本页文档会有更高的效率。

但如果你对其中包含的操作不熟悉，也可以回到这里来跟着视频指南操作。

胡桃工具箱指南 5 - 祈愿记录导出篇

获取祈愿数据

利用 Stoken 从服务器获取最新的祈愿记录

提示

  • 已登录的米游社帐号是使用 Stoken 刷新方法的前提，你可以参考米游社多帐号切换一文在胡桃工具箱中登录你的帐号
  • Stoken 刷新方法暂不支持国际服
  • 在胡桃工具箱中确保你需要获取记录的米游社帐号已登录
  • 从左侧菜单栏进入祈愿记录
  • 点击右上角的刷新，并点击Stoken刷新
  • 等待读取完毕，即可查看最新的祈愿记录

从网页缓存获取最新的祈愿记录

  • 从左侧菜单栏进入祈愿记录
  • 启动游戏并登入游戏，打开游戏内的祈愿历史记录
  • 回到胡桃工具箱，点击刷新按钮，在刷新菜单中点击网页缓存刷新

提示

若出现网页缓存刷新功能异常的情况：

  • 从胡桃工具箱的设置
  • 在删除游戏内网页缓存功能中执行删除操作

通过输入 Url 获取祈愿记录

  • 如果你通过其它工具获取到了你祈愿历史记录的 Url，可以选择手动输入Url并根据提示操作
  • 但应注意此类 Url 具有时效性

对于全量刷新选项的补充说明

在默认情况下，胡桃工具箱会在匹配到本地已有记录的祈愿ID后停止导入。 但如果你希望完整地获取原神服务器中所有的历史记录（即使它已经存在于你的本地祈愿记录中），你可以勾选全量刷新。

不勾选全量刷新不会使你丢失祈愿数据，勾选全量刷新也不会让你的本地记录错误地额外记录一次相同的祈愿数据。

从其它祈愿导出程序导入祈愿数据

胡桃工具箱支持导入 UIGF 数据格式 的祈愿记录数据[1]

如果你希望导入这一类数据，可以：

  • 启动胡桃工具箱，从左侧菜单栏进入祈愿记录
  • 点击右上角的导入
  • 选择你的 UIGF Json 数据文件
  • 根据界面确认导入数据

从 Snap Genshin 转移祈愿记录数据

如果你希望从 Snap Genshin 中转移祈愿数据至胡桃工具箱，你可以：

  • 升级 Snap Genshin 到最新版本
  • 进入祈愿记录功能
    • 如果你由于无法登录米游社而无法进入 Snap Genshin，可以在胡桃工具箱中登录米游社帐号并复制 Cookie 到 Snap Genshin
  • 点击右上角的功能菜单
  • 通过导出 UIGF Json 文件导出 Json 格式的祈愿记录
  • 在胡桃工具箱中导入该文件

导出祈愿数据

胡桃工具箱支持导出 UIGF数据格式 的 Json 文件格式的祈愿记录数据

如果你希望导出祈愿数据，可以：

  • 启动胡桃工具箱，从左侧菜单栏进入祈愿记录
  • 选择您要导出的祈愿记录存档
  • 点击导出按钮
    • 在弹出的界面选择您需要将此导出的祈愿记录数据文件存放的位置，并点击导出
  • 导出完成

  1. 统一标准化的原神数据格式由 UIGF-Org 提供 ↩︎

]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2022-09-29T02:37:43.000Z Copyright by DGP-Studio 提交BUG报告 https://hut.ao/statements/bug-report.html 2023-02-04T05:41:27.000Z 提交BUG报告

opened-issue closed-issue

推荐方法

]]> 提交BUG报告

opened-issue closed-issue

推荐方法

  • 在你使用 Snap Hutao 时如果发现了可复现或不可自行修复的问题，可以通过提交问题反馈来告知开发者。
  • 在提交问题时，您应当尽可能地详细描述问题。如果有错误的截图，也应该提供。这有利于问题排查并加速问题修复。
  • 如果你有能力在代码层面修复该问题，也欢迎您直接在对应的项目中发起 PR。 suggestion 如果你是诚心希望解决问题，则应该在 Issue 中包含尽可能多的信息，比如说：你做了什么；看到了什么结果；程序有什么提示； 你查阅了哪篇文档；尝试了什么解决方案，结果是什么；你的设备ID是什么…… 当你愿意付出更多的时间在提供信息上，更大的可能获得一个准确的解决方案。 一两句话就结束的问题报告大多数不是有效的问题，只会被无视。

客户端问题

请求增加或更新文档

]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2022-09-29T02:37:43.000Z Copyright by DGP-Studio 项目说明 https://hut.ao/project.html 2023-02-03T02:35:02.000Z 项目说明

胡桃工具箱是一个 Windows 平台的开源的原神工具箱，旨在帮助玩家获得更好的游戏体验； 它是对官方移动端工具的一种非破坏性功能扩展，为不习惯在移动端进行原神游戏的 PC 玩家提供一个在 Windows 平台下获得接近移动端功能权利的途径。

功能迁移

胡桃正在迁移原 Snap Genshin 客户端中的功能

已经完成迁移的功能将会在本站文档中提供指导说明，功能迁移和开发进度可以参阅下方

    • 将整合进养成计划
    • 将整合进养成计划
]]> 项目说明

胡桃工具箱是一个 Windows 平台的开源的原神工具箱，旨在帮助玩家获得更好的游戏体验； 它是对官方移动端工具的一种非破坏性功能扩展，为不习惯在移动端进行原神游戏的 PC 玩家提供一个在 Windows 平台下获得接近移动端功能权利的途径。

功能迁移

胡桃正在迁移原 Snap Genshin 客户端中的功能

已经完成迁移的功能将会在本站文档中提供指导说明，功能迁移和开发进度可以参阅下方

    • 将整合进养成计划
    • 将整合进养成计划

新增功能

以下新功能计划被增加到胡桃工具箱中

    • 等待微软修复上游问题
]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2022-09-28T01:46:44.000Z Copyright by DGP-Studio 快速开始 https://hut.ao/quick-start.html 2023-02-14T08:01:36.000Z 快速开始

提示

若您已下载或使用胡桃工具箱，即表示你已阅读并完全同意用户使用协议与法律声明

如果你认为胡桃工具箱是一个好的项目或者有帮助到你，你可以通过以下方式支持我们

]]> 快速开始

提示

若您已下载或使用胡桃工具箱，即表示你已阅读并完全同意用户使用协议与法律声明

如果你认为胡桃工具箱是一个好的项目或者有帮助到你，你可以通过以下方式支持我们

commit_activity hutao-last-commit

视频指南

对于大多数人而言，遵循本页文档会有更高的效率。

但如果你对其中包含的操作不熟悉，也可以回到这里来跟着视频指南操作。

胡桃工具箱视频指南 - 下载/安装/卸载篇

最低系统要求

要求 规格
最低可运行系统版本 Windows 10 Build 19041 (20H1) [1]
推荐系统版本 Windows 11 Build 22621 (22H2)
可选组件 WebView2 Runtime

下载胡桃工具箱

微软商店链接：Snap Hutao

在 Windows 10 和 Windows 11 下你可以直接点击上面的按钮来下载胡桃工具箱

卸载胡桃工具箱

  • 清除有关的任务计划
    • 1.4.15 版本前，若不执行该步骤，胡桃用于获取实时便笺数据的计划任务将不会被删除，会出现这个问题
    • 方法1：
      • 打开胡桃，选择 设置 页签
      • 找到 删除所有计划任务 一栏中，点击右侧的 执行 按钮
    • 方法2：
      • 执行下方的脚本
    • 方法3：
      • 打开 Windows 计划任务程序
      • 找到 SnapHutaoDailyNoteRefreshTask 任务并删除
  • 卸载软件
    • 打开开始菜单
    • 找到或搜索到胡桃
    • 右键点击胡桃，并选择卸载
  • 清除数据文件夹（如需完全卸载）
    • 打开并删除该文件夹 %userprofile%/Documents/Hutao

  1. LTSC 和 LTSB 版本系统由于不包含微软商店，不在支持列表中。 ↩︎

]]> DGP-Studio https://github.com/DGP-Studio DGP-Studio https://github.com/DGP-Studio 2022-09-28T01:46:44.000Z Copyright by DGP-Studio