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

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

• 解决方式

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

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

#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：
    • 使用北美地区的网络代理
    • 如果使用加速器或网络代理，你需要解除微软商店的 Windows App Container Loopback 限制

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

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

• 使用高级启动器中的服务器切换功能时，可能会出现31-4302相关错误
• 目前的临时解决方案：
  • 将原神截图目录中的服务器切换缓存目录删除

#3 任务栏右键菜单中没有快速启动游戏的入口

• 胡桃使用 Windows 提供的 JumpPath 接口来提供快速启动游戏菜单
  • 该接口需要用户在系统设置 -> 个性化 -> 开始 中启用在“开始”菜单或任务栏的跳转列表中以及资源管理器的“快速使用”中显示最近打开的项 （该设置系统默认开启）
• 在下一版本，我们会使用 JumpTask 接口来代替 JumpPath 接口，用户将不再需要上述设置选项开启

#4 无法使用管理员模式启动胡桃工具箱

该问题来源并非胡桃工具箱，属于外部问题 该问题仅存在于 Windows 10 低于22H2的版本中

• 当用户系统版本低于 Windows Build 19045（即 Windows 10 22H2 版本）时，可能无法通过管理员模式启动胡桃工具箱
  • 该问题属于 Windows 内核级别问题，难以判断具体来源，故建议用户升级至 Windows 10 最新版本

Android

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

• 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 输入，此时即可完成登录

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

RuntimeEnvironmentException

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

Return Code: -10001

• 该异常实际上来源于米游社的返回信息，包括：
  • Return Code: -10001
  • Return Code: -100
• 问题来源：
  1. Cookie 过期或网络异常
  2. 系统时间错误
• 解决方案：
  1. 在帐号面板中，点击刷新 Cookie
  2. 删除帐号后重新添加米游社帐号
  3. 在系统设置中启用自动同步时间并立刻同步时间

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

403 (Forbidden)

解决方案：更新胡桃工具箱至最新版本

502 (Bad Gateway)

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

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

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

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

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

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

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

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

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

祈愿的导出

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

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

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

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

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

• 保存胡桃工具箱的 Logo 资源
  • 你可以点击这里下载
• 在桌面点击右键，选择新建 -> 快捷方式
• 在请键入对象的位置中直接输入:

• 将快捷方式命名为你需要的名称，比如Snap Hutao
• 确认创建，此时你会在桌面得到一个有 PowerShell 图标的快捷方式
• 右键该快捷方式，点击属性
  • 将运行方式修改为最小化
  • 点击更改图标，选择浏览，并选中刚刚下载的图标
• 这样你就获得了胡桃工具箱的桌面快捷方式，并且运行它将直接以管理员模式运行
  • 你也可以将固定到任务栏或磁贴区

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

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

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

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

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

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

  

• 选择启动游戏即可

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

参考 HttpRequestException 错误 文档

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

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

相关的 Github Issue

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

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

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

原神的BUG，和我们没关系

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

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

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

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

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

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

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

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

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

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

参考 HttpRequestException 错误 文档

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

• 商店版本和侧载版本有不同的软件 ID，所以会被系统识别为不同的程序
• 商店版的更新只会覆盖商店版应用；侧载版更新包只会更新侧载版应用
• 在你的系统中，商店版的胡桃工具箱名称为 Snap Hutao，侧载版的名称为 胡桃

国际化进度

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

• Snap Hutao 主项目
  • 语言本土化技术框架
  • 客户端翻译
    • 进度：
    • 英语
    • 繁体中文
    • 韩语
    • 日语
    • 俄语
  • 国际服/国服客户端转换
  • 国际服游戏帐号切换
  • 国际服祈愿记录导出
  • 国际服角色属性统计
  • HoYoLAB 登录支持
    • 国际服深渊记录获取
    • 实时便笺
    • 多语言游戏公告
• Snap Hutao 文档
  • 语言本土化技术框架
  • 网页翻译
  • 进度：
    • 英语
      • 主页
      • 用户文档
    • 韩语
      • 主页
      • 用户文档

参与国际化

• Snap Hutao 主项目
  • 我们在 GitHub 上创建了一个名为 [Hoyolab]: Globalization support 的 Issue
    • 我们会在该 Issue 中更新当前主程序国际化进度
    • 你可以在这里宣布参与主程序某一部分的国际化支持，我们会为此提供支持
      • 我们也欢迎直接通过分支发起 Pull Request
  • 你可以在 translate.hut.ao 参与客户端的翻译工作
• Snap Hutao 文档
  • 你可以在 translate-docs.hut.ao 参与文档的翻译工作

category: [公告] icon: update

更新日志

1.4.16

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

1.4.15

• 新增
  • 重置图片资源的入口
  • 刷新 Cookie 方法
• 修复
  • 修复了#2 服务器切换导致31-4302报错
  • 修复了部分情况下程序内清除定时任务计划失败的情况
• 优化
  • 优化了养成计划界面 #486
  • 完善英语和繁体中文翻译
  • 在触发 Windows 长路径限制时增加提示
  • 优化了定时任务的唤醒方式

1.4.14

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

1.4.11

• 商店初版

总则

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

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

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

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

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

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

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

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

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

权利和义务

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

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

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

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

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

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

其他条款

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• 使用实时便笺功能后

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

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

  • 储存服务器转换所需要的文件

推荐方法

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

客户端问题

• 在提交问题前，请务必检查文档内是否已包含了你的问题

  • 首先需要确认您使用的版本是否为最新版本
  • 您可以通过菜单栏中的“常见问题”分类找到这些文档
    • 快速解答

• 通过 GitHub 提交问题

  • github.com/DGP-Studio/Snap.Hutao/issues/new/choose

• 通过 兔小巢 提交问题

  • support.qq.com/products/451231

请求增加或更新文档

• 通过 GitHub 提交问题：DGP-Studio/Snap.Hutao.Docs

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

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

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

视频指南

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

但如果你对其中包含的操作不熟悉，也可以回到这里来跟着视频指南操作。 ::: details 胡桃工具箱指南 5 - 祈愿记录导出篇

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

已包含的数据

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

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

关于 胡桃

• 胡桃工具箱的图标：您可以在胡桃的首页查看它的原图
  • 该图像作品的作者为LOFTER@夙夜并由DGP-Studio后期处理后，授权使用
• 胡桃的版本号
• 设备ID
• 反馈
  • 点击前往反馈的按钮，即可跳转至相关页面

外观

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

祈愿记录

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

游戏

• 游戏路径

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

• 删除游戏内网页缓存

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

测试功能

• 打开数据文件夹

  • 在此选项中点击"打开"按钮，即可打开包含"用户数据/日志/元数据"的文件夹

• 打开缓存文件夹

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

米游社每日签到

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

危险功能

• 删除所有计划任务
  • 当你需要卸载胡桃工具箱时，可以使用此功能以删除胡桃工具箱的定时数据拉取任务
• 删除所有用户
  • 此功能的作用是删除用户表的所有记录
  • 点击执行按钮即可完成删除
  • 通常情况下，用户不需要使用此功能来删除用户表的信息

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

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

查看深渊数据

• 在主界面点击左侧菜单栏进入深渊统计页面
• 点击角色使用以查看角色使用率数据
  • 角色使用率 = 角色在当前层数出场次数 / 持有该角色的玩家在该层数的总记录数
• 点击角色出场以查看角色出场率数据
  • 角色出场率 = 角色在当前层数出场次数 / 当前层数总记录数
• 点击角色持有以查看角色持有率数据^[1]
  • 角色持有率[2] = 所有拥有该角色的玩家数量 / 全部玩家数量
• 点击队伍出场以查看队伍组合出场次数数据
  • 各种角色组队情况下出场次数的排名

上传深境螺旋数据

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

• 胡桃工具箱提供的高级启动器功能中通过多样的设置选项来允许用户以自定义设置启动游戏
• 你可以通过点击左侧菜单栏中的启动游戏进入高级启动器功能
  • 第一次使用时你会被跳转到设置页面以设置你的游戏路径
  • 选择游戏路径时，请注意此处选择的应是游戏本身
    • 形如：$\Genshin Impact\Genshin Impact Game\YuanShen.exe
    • 而官方启动器的目录一般是$\Genshin Impact\launcher.exe
• 在设置完毕启动游戏所需的附加选项后，点击右下角的启动游戏按钮即可
  • 附加选项请看本页下方的功能文档

视频指南

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

但如果你对其中包含的操作不熟悉，也可以回到这里来跟着视频指南操作。 ::: details 胡桃工具箱指南 4 - 高级启动器（切换帐号/切换服务器/帧率解锁）

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

基于 WIKI 资料添加

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

基于玩家数据添加

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

背包物品

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

功能说明

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

添加角色

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

全局通知设置

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

帐号独立设置

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

删除角色

• 将鼠标停留在需要被设置的角色实时便笺的窗体上
• 点击其窗体右上角出现的移除标志按钮，即可移除该角色对应的实时便笺

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

已包含的数据

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

添加至养成计划

• 在角色资料页面，你可以在选定角色后，点击右上角的养成计算按钮来将该角色添加至你的养成计划中
  • 该养成计划将默认从角色1级开始培养
  • 如果你需要基于当前已有的角色创建养成计划，可以使用我的角色功能

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

同步角色信息

从 Enka API 同步

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

从 米游社我的角色 同步

• 在胡桃工具箱的我的角色功能页面，在界面右上角点击同步角色信息
• 点击从米游社我的角色同步

从 米游社养成计算 同步

• 在胡桃工具箱的我的角色功能页面，在界面右上角点击同步角色信息
• 点击从米游社养成计算同步

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

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

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

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

导出图片

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

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

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

成就导入

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

推荐使用的成就识别工具

• YaeAchievement

• 椰羊cocogoat

• Star our project on GitHub ⭐
  • Snap.Hutao
  • Snap.Hutao.Docs
• Rate our App on Microsoft Store
• Promote our project in communities

通用安装方式

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

小白级安装方式

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

升级胡桃工具箱

• 解压你下载的最新版本压缩包
• 重复 安装胡桃工具箱 的步骤
• 若您安装失败或出现异常情况，可参考如下步骤
  • 先卸载已经安装的胡桃工具箱
  • 重复 安装胡桃工具箱 的步骤

File not found

Video Tutorial

For most people, follow the instruction on this page is more effiency.

However, if you are not familiar with the operation mentioned below, you can come back the follow the video tutorial. ::: details Snap Hutao Tutorial - Microsoft Store Installation

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

功能迁移

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

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

• 米游社公告首页
• 米游社帐号管理
• 游戏启动器
• 祈愿记录
• WIKI - 日常材料
  • 将整合进养成计划
• WIKI - 周常材料
  • 将整合进养成计划
• WIKI - 角色资料
• WIKI - 武器资料
• 成就统计
• 胡桃数据库
• 养成计算器
• 角色橱窗
• 玩家查询
• 自定义网页

新增功能

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

• 祈愿云端同步
• 国际化支持
  • 等待微软修复上游问题
• 国际服支持
  • 游戏启动器
  • 服务器切换
  • 祈愿记录

米游社功能

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

游戏性增强

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

养成计划

• 养成计算器
  • 属性统计
  • 角色 Wiki
  • 武器 Wiki

As open-source software, community power is an important part of the ecology of Snap Hutao, and you can join our user community by following ways.

File not found

GitHub Discussion

Snap.Hutao Discussion

QQ Group (CN)

• Snap Group #1
• Snap Group #2
• Snap Group #3
• Snap Group #4
• [Snap 开发交流群]
  • 广泛的技术交流群，并非胡桃工具箱开发群
  • 开发群对申请者的技术水平有一定要求
  • 如果你有兴趣可以从https://dev-group.hut.ao加入开发者交流群

Discord

Invite link：https://discord.gg/Yb8bykUKp