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,3 @@
# 功能列表
<Catalog base='/features' />

View File

@@ -4,22 +4,22 @@ headerDepth: 0
# 成就管理
![](https://image.snapgenshin.com/imgs/2022/05/02/21047ff544f318fa.png)
![](https://img.alicdn.com/imgextra/i1/1797064093/O1CN01eddfVC1g6du4Xdd9P_!!1797064093.png)
Snap Genshin 提供成就管理功能,用户可以通过它浏览并管理所有的成就状态
胡桃工具箱提供成就管理功能,用户可以通过它浏览并管理所有的成就状态
## 成就阶段拆分
::: tip 友情提示
成就阶段拆分数据来源于玩家的数据贡献,我们需要有玩家不断地维护这一类数据。如果你是一个热衷于收集原神成就的玩家并且愿意贡献新的数据,可以在 [Masterain98/Genshin-Impact-Decomposed-Achievements](https://github.com/Masterain98/Genshin-Impact-Decomposed-Achievements) 中创建新的 Issue 或 PR 以分享你的数据。
:::
Snap Genshin 对日常委托中包含的隐藏成就进行了阶段性的划分,用户可以通过勾选已完成的阶段性目标来记录相关成就的完成进度
![](https://image.snapgenshin.com/imgs/2022/05/02/b6a6cf470d79668e.png)
以日常委托`岩游记`中隐藏的`帝君故事`成就为例。为获取该成就,你需要在璃月每日委托任务岩游记中分别提供不同物品以获取到不同的岩王帝君的故事。玩家在获取到`["开拓之神","历史之神","炉灶之神","财神"]`全部四个故事后方可解锁该成就。使用 Snap Genshin 的成就管理功能,你将可以记录已完成的剧情故事。
- 在第一次使用时,你需要根据提示点击`创建新存档`按钮以创造一个成就存档并为其命名
- 创建第一个资料页后,你可以点击右上角的`创建新存档`来继续为更多的帐号创建成就记录档案
## 成就导入
Snap Genshin 使用[统一可交换成就标准](https://www.snapgenshin.com/development/UIAF.html)数据标准来储存用户的成就数据。该标准允许用户从其它成就管理程序或成就导出工具中通过 [Url 协议](https://www.snapgenshin.com/development/ThirdPartyAccess.html#url-%E5%8D%8F%E8%AE%AE)和剪贴板将数据导入到 Snap Genshin 中。
- 胡桃工具箱使用[统一可交换成就标准](https://www.snapgenshin.com/development/UIAF.html)数据标准来储存用户的成就数据
- 该标准允许用户从其它**成就导出工具**中通过 [Url 协议](https://www.snapgenshin.com/development/ThirdPartyAccess.html#url-%E5%8D%8F%E8%AE%AE)和剪贴板将数据导入到胡桃工具箱中
- 你可以点击成就页面右上角隐藏菜单中的`导入`按钮,并选择`从 UIAF 文件导入`以加载以 UIAF 数据格式储存的第三方成就数据
## 推荐使用的成就识别工具
- [YaeAchievement](https://github.com/HolographicHat/YaeAchievement) <Badge text="成就识别" type="tip" />
- [椰羊cocogoat](https://cocogoat.work/) <Badge text="成就攻略" type="tip" />

View File

@@ -0,0 +1,70 @@
---
headerDepth: 0
---
# 属性统计
::: info
该功能需要你在胡桃工具箱中登录米游社帐号,登录方法可见[米游社多帐号切换](mhy-account-switch.md)文档
:::
属性统计,即主程序侧栏中的`我的角色`功能,可读取当前账号所拥有角色的具体数据,包括等级、命之座、武器、天赋、圣遗物等;并自动计算圣遗物评分和双爆评分
![属性统计示例图](https://img.alicdn.com/imgextra/i3/1797064093/O1CN016ZFB021g6du6Xvrbv_!!1797064093.png)
## 同步角色信息
### 从 Enka API 同步
::: info 同步特征
- Enka API 同步游戏内角色橱窗中公开展示的角色的信息
- 该同步方式包括圣遗物具体数据
- 该同步方式一次最多包含8个角色
:::
- 在游戏中将角色橱窗设置为公开并添加**需要获取详细资料的角色**进入橱窗展示
- 角色橱窗中最多可同时展示8个角色
- 若您更换了橱窗内的角色或角色内的配置,需等待游戏内的数据同步至服务器
- 开启功能和更换角色后需要最多5分钟同步数据
- 进入胡桃工具箱的`我的角色`功能页面,在界面右上角点击`同步角色信息`
- 点击`从Enka API 同步`
### 从 米游社我的角色 同步
::: info 同步特征
- 米游社我的角色 同步的数据来源于米游社数据
- 该同步方式不包含圣遗物信息
- 该同步方式一次可同步全部角色信息
:::
- 在胡桃工具箱的`我的角色`功能页面,在界面右上角点击`同步角色信息`
- 点击`从米游社我的角色同步`
### 从 米游社养成计算 同步
::: info 同步特征
- 米游社养成计算 同步的数据来源于米游社养成计算数据
- 该同步方式包含角色天赋等级信息
- 该同步方式一次可同步全部角色信息
:::
- 在胡桃工具箱的`我的角色`功能页面,在界面右上角点击`同步角色信息`
- 点击`从米游社养成计算同步`
## 将当前选定角色加入养成计算
- 在胡桃工具箱的`我的角色`功能页面,点击切换至需要加入养成计算的角色的资料页面
- 点击界面右上方的"养成计算"按钮,输入目标等级
- **已同步数据的角色**的当前角色等级、天赋等级会预填入其中,目标等级可自由更改
![rolescal](https://img.alicdn.com/imgextra/i2/1797064093/O1CN01Ju0wyK1g6du2L9Kw0_!!1797064093.png)
- 添加完毕后,您可在"养成计划"功能中查看"已添加的养成目标"
![image](https://img.alicdn.com/imgextra/i4/1797064093/O1CN01DgRS5n1g6du0Do41z_!!1797064093.png)
- 关于养成计划功能的详细说明,请见[养成计划](develop-plan.md)文档
## 导出图片
- 在我的角色页面中,你可以在选择一个角色的情况下点击右上角的`导出图片`按钮以将角色数据转化为图片形式,这将有助于你分享你的角色信息
- 导出的图片储存在系统剪贴板中,你可以在合适的地方直接粘贴以获得该图片
- 导出图片样式如下图所示
![sample-output-image](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01ah7JlQ1g6du4WrI0A_!!1797064093.png)

View File

@@ -0,0 +1,35 @@
---
headerDepth: 0
---
# 角色资料
![characters-wiki](https://img.alicdn.com/imgextra/i3/1797064093/O1CN017m1hd11g6dtvZP5UA_!!1797064093.png)
角色资料是胡桃工具箱中内置的用于查询各个角色的基础信息、天赋数值、命之座、培养材料等数据的 wiki
## 已包含的数据
- 角色列表
- 使用列表左上角的按钮,可切换列表显示的方式:即"缩略图与名称"或"仅缩略图"
- 单击列表中的缩略图或名称,即可跳转到相应的介绍页面
- 数据内容
- 角色基本信息
- 介绍
- 各等级下的数值
- 属性
- 天赋
- 基本介绍
- 可切换至对应等级天赋的各项数值
- 命之座
- 根据"胡桃数据库"的统计信息而展示的**角色队伍搭配、武器搭配以及圣遗物搭配**的相关推荐
- 其他信息
- 角色立绘
- 特色料理
- 衣装信息
- 角色资料
- 角色故事
## 添加至养成计划
- 在角色资料页面,你可以在选定角色后,点击右上角的`养成计算`按钮来将该角色添加至你的养成计划中
- 该养成计划将默认从角色1级开始培养
- 如果你需要基于当前已有的角色创建养成计划,可以使用[我的角色](character-data.md)功能

View File

@@ -0,0 +1,45 @@
---
headerDepth: 0
---
# 实时便笺
::: info
该功能需要你在胡桃工具箱中登录米游社帐号,登录方法可见[米游社多帐号切换](mhy-account-switch.md)文档
:::
![live-data-tracking](https://img.alicdn.com/imgextra/i2/1797064093/O1CN01tiu6aD1g6duB3mtYQ_!!1797064093.png)
## 添加角色
- 点击`添加角色`按钮
- 在弹出的`添加角色`浮窗中,选择您要添加的游戏角色,并单击其右侧的加号按钮
- 此时您添加的游戏角色即可显示在实时便笺页面中
- 实时便笺是间隔固定时间自动刷新的
- 你可以点击窗口右上角的`通知设置`来设置查询的间隔时间
- 如您需要立即刷新以获取实时的最新数值,请单击`立即刷新`按钮
- 如出现"账号有风险,请前往米游社查看"字样的提示
- 请参考[账号风险提示](../FAQ/mihoyo-risk-tip.md)文档
## 全局通知设置
- 在窗口右上角点击`通知设置`可以修改实时便笺的全局设置,包括:
- 数据刷新间隔时间
- 通知免打扰
- 高优先度通知
- 这将避免胡桃工具箱的通知被自动收入操作中心
- 请注意,开启此设置可能会让您在日常使用电脑期间受到打扰
## 帐号独立设置
- 胡桃工具箱的实时便笺功能允许用户对每一个被监控的帐号给予不同的设置
- 将鼠标停留在**需要被设置的**角色实时便笺的窗体上
- 点击其窗体右上角出现的设置图案按钮,即可修改如下参数
- 原粹树脂提醒阈值
- 洞天宝钱提醒阈值
- 启用参量质变仪提醒
- 启用每日委托上限提醒
- 启用探索派遣完成提醒
- 启用在主页显示卡片 (未上线的新功能)
- 点击`保存`,即可保存您当前所设置的通知选项
## 删除角色
- 将鼠标停留在需要被设置的角色实时便笺的窗体上
- 点击其窗体右上角出现的移除标志按钮,即可移除该角色对应的实时便笺

View File

@@ -0,0 +1,44 @@
---
headerDepth: 0
---
# 养成计划
![dev-plan](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01huh2t51g6du5DUiGt_!!1797064093.png)
## 添加养成目标进入材料清单
### 基于 WIKI 资料添加
- 在胡桃工具箱的左侧栏目中,点击`角色资料``武器资料`功能
- 在"胡桃工具箱"的整体界面右上部分,点击`养成计算`按钮
- 在弹出的"添加到当前养成计划"的窗口中,填写角色需要计算的各项属性的起始等级以及目标等级
- 基于 WIKI 资料添加的养成目标默认初始值为1级
### 基于玩家数据添加
- 在"胡桃工具箱"的左侧栏目中,点击`我的角色`功能
- 在选中角色后,点击右上角的`养成计算`按钮
- 在弹出的"添加到当前养成计划"的窗口中,填写角色需要计算的各项属性的"起始等级"以及"目标等级"
- 基于玩家数据添加的养成目标,默认初始等级为玩家当前的角色等级
- 请参考[属性统计](character-data#%E5%B0%86%E5%BD%93%E5%89%8D%E9%80%89%E5%AE%9A%E8%A7%92%E8%89%B2%E5%8A%A0%E5%85%A5%E5%85%BB%E6%88%90%E8%AE%A1%E7%AE%97)文档以获取更多信息
## 背包物品
- 在"胡桃工具箱"的左侧栏目中,点击"养成计划"功能
- 点击"背包物品"功能栏
- 在"胡桃工具箱"的整体界面右上部分,点击"新建计划"按钮
- 在弹出的"创建新的养成计划"的窗口中,填写需要创建的养成计划名称
- 此处可勾选"绑定当前选中的账号角色"
- "新建计划"按钮左侧的下拉选项框,可**自行切换不同的养成计划**
- 点击下方的任意物品图标或数字区域,即可手动编辑该种材料的数目
- 背包物品的具体材料信息,**对应于**其修改时,所切换至的养成计划
- 在"胡桃工具箱"的整体界面右上部分,可点击"删除计划"按钮,将当前的养成计划删除
- 在删除当前养成计划后,处于切换至该养成计划时,输入的背包物品信息将一同删除
## 功能说明
此功能尚在完善阶段,若您有建设性的建议,或发现了显著的问题,请按[此页面](../statements/bug-report.md)直接向我们反馈,感谢您的贡献!

View File

@@ -0,0 +1,79 @@
---
headerDepth: 0
---
# 高级启动器
- 胡桃工具箱提供的高级启动器功能中通过多样的设置选项来允许用户以自定义设置启动游戏
- 在设置完毕启动游戏所需的附加选项后,点击右下角的`启动游戏`按钮即可
- 选择游戏路径时,请注意此处选择的应是游戏本身
- 形如:`$\Genshin Impact\Genshin Impact Game\YuanShen.exe`
::: tip 国际服支持
高级启动器中除`切换服务器`以外的功能均支持国际服客户端
:::
## 切换服务器
::: warning
当前版本由于原神的部分更新导致本功能可能无法成功从官服转换为B服请等待进一步的更新
:::
- 在主界面点击左侧菜单栏进入`启动游戏`页面
- 点击右侧选项中的服务器名称,选择要进入的服务器
- 目前可选的服务器为`官方服|天空岛``渠道服|世界树`
- 若需切换至世界树服务器,则应将 [PCGameSDK.dll 文件](https://cloud.06dn.com/api/v3/file/source/179514/PCGameSDK.dll?sign=dbF4NoPqrSemUlbugtU71iYk1IZaW7JHQK9TbHMBTNg%3D%3A0)放入 Plugins 文件夹中
- 该目录的路径形如"$:\Genshin Impact\Genshin Impact Game\YuanShen_Data\Plugins"
- 若下载到的`PCGameSDK.dll 文件`的文件名中有其他字符,建议将其重命名为 `PCGameSDK.dll`,以防止读取错误
- 若需要切换不同的服务器,须确保`以管理员模式启动`胡桃工具箱
## 账号保存
::: tip
1. 本功能所描述的帐号,特指当前原神所登录游戏账号的登录状态
2. 获取当前原神的登录状态通常需要管理员权限,建议`使用管理员模式启动胡桃`
:::
- 在主界面点击左侧菜单栏进入`启动游戏`标签
- 点击`账号`功能中的`检测`按钮
- 在弹出的`为账号命名`界面中,输入您要为此账号设置的名称,点击确认
- 此时即可在`账号`功能下方自由选择您要切换的账号
- 每个已保存的账号均为可点击选择的按钮
- 在其右侧有三个按钮,分别为:
- `绑定当前用户角色`即将您当前选择的米游社登录状态绑定至该账号中点击该按钮后对应的UID将出现在该账号自定义名称的下方
- `重命名`,即修改当前选择账号的自定义名称
- `删除`,即删除当前选择的账号
## 外观选项
::: warning
- 在当前的游戏版本中,有案例表明部分用户使用胡桃工具箱,选择**全屏模式**启动原神游戏,出现游戏无响应或卡顿的情况
- 建议此部分用户使用无边框选项进行启动游戏
:::
- 在主界面点击左侧菜单栏进入`启动游戏`标签
- 在右侧的`外观`功能中,有四个选项:
- **全屏**,即选择启动游戏后的游戏界面是否设置为全屏
- **无边框**,即选择启动游戏后的游戏界面是否设置为无边框窗口
- **宽度**,即选择启动游戏后的游戏界面的宽度,例如`1920`
- **高度**,即选择启动游戏后的游戏界面的高度,例如`1080`
## 解锁帧率上限
::: danger
- 请注意:此功能已明确标注为 `Dangerous Feature`,即**危险功能**,选择启用即代表您选择自行承担任意风险
- 目前的版本设置中无论是否超过60帧率的原神(含移动端)均会偶尔出现掉帧、卡顿甚至无响应、闪退等情况,这是原神在本版本中出现的普遍问题,并不是[Unlocker项目](https://github.com/DGP-Studio/Unlocker)的问题
- [Unlocker项目](https://github.com/DGP-Studio/Unlocker)仅作用于 UnityPlayer 本身,即直接作用于 Unity3D 引擎,与游戏本体不发生直接关系,本质上与移动端中`120帧率`等设置无异,但您仍应谨慎使用并自行阅读[用户协议](https://docs.qq.com/doc/p/223a4e1f7241891e1208476a11927397549e9ea8)
:::
- 使用`管理员模式`启动胡桃
- 在主界面点击左侧菜单栏进入`启动游戏`标签
- 在最下方可见 `Unlock frame rate limit` 选项
- 在右侧点击`开启或关闭`按钮,所显示的 `Disable``Enable` 分别代表`已禁用``已启用`该功能
- 在下方的 `Set frame rate` 选项中,可自由拖动拉杆,调整到您需要设置的最高帧率上限
- 会导致**解锁帧率上限失败**的因素:
- 解锁帧率上限,需要保持**胡桃工具箱**在开启状态
- 游戏内未关闭**垂直同步**选项
- 在显卡驱动中存在`最大帧速率`的设置
- 在显卡驱动软件内存在未关闭的类似于`节能模式`的选项

View File

@@ -0,0 +1,58 @@
---
headerDepth: 0
---
# 胡桃数据库/深渊统计
胡桃工具箱提供两个主要的深境螺旋挑战统计的功能
- 侧栏中的`深渊统计`是一个旨在通过统计并展示广大玩家深境螺旋挑战数据,来帮助对原神对战系统不熟悉玩家组建队伍、通关深渊、获取奖励的功能
- 侧栏中的`深渊记录`是一个通过保存玩家每一期深境螺旋挑战数据来帮助个人玩家回顾游戏经历及个人数据收集的统计功能
- 众多的玩家通过上传个人的`深渊记录`来形成胡桃数据库的`深渊统计`数据集
::: tabs
@tab 角色使用率
![character-usage-rate](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01VNtgaU1g6du5Mh1Oo_!!1797064093.png)
@tab 角色出场率
![character-held-n-usage-rate](https://img.alicdn.com/imgextra/i1/1797064093/O1CN01AKGIZn1g6du8k0Rhb_!!1797064093.png)
@tab 队伍出场次数
![hutaoapi](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01ZRakBS1g6duBCh0c1_!!1797064093.png)
@tab 角色持有率
![character-held-rate](https://img.alicdn.com/imgextra/i4/1797064093/O1CN01EUjFsJ1g6du8k0NYy_!!1797064093.png)
@tab 个人数据统计
![personal-record-stat](https://img.alicdn.com/imgextra/i2/1797064093/O1CN01xMLXhn1g6du6lPUDD_!!1797064093.png)
@tab 个人数据详情
![personal-record-details](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01xtWJfr1g6dtvjZLWZ_!!1797064093.png)
:::
## 查看深渊数据
::: warning
所有计算数据都基于**已上传至胡桃数据库中的玩家数据**,无法代表全部原神玩家的平均数据,数据仅做参考用途
:::
::: info 数据刷新周期
1. 深境螺旋统计数据角色使用率、角色出场率、队伍出场在北京时间每月1日和16日的4点自动清理。
- 点击界面右上角的信息按钮你可以查看当前实时已上传的总数据
2. 同时若用户在30天内没有重新上传记录以更新数据则其的角色持有数据将被清理
:::
- 在主界面点击左侧菜单栏进入`深渊统计`页面
- 点击`角色使用`以查看角色使用率数据
- 角色使用率 = 角色在当前层数出场次数 / 持有该角色的玩家在该层数的总记录数
- 点击`角色出场`以查看角色出场率数据
- 角色出场率 = 角色在当前层数出场次数 / 当前层数总记录数
- 点击`角色持有`以查看角色持有率数据[^first]
- 角色持有率[^second] = 所有拥有该角色的玩家数量 / 全部玩家数量
- 点击`队伍出场`以查看队伍组合出场次数数据
- 各种角色组队情况下出场次数的排名
## 上传深境螺旋数据
- 在主界面点击左侧菜单栏进入`深渊记录`功能页面
- 点击右上角的`刷新数据`以确保胡桃工具箱客户端已经获取到最新的个人深境螺旋数据
- 点击右上角的`上传数据`以上传你的深境螺旋数据
- 这可能需要花费数秒,上传成功后你将会看到如下图的成功提示
![upload-hutaoapi](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01Zt7yQp1g6duBDALeX_!!1797064093.png)
[^first]: 角色持有数据与深境螺旋记录独立
[^second]: 只要拥有该角色,即使没有在深境螺旋中登场,也会被计入拥有的状态;
只要上传过深境螺旋记录,即会被计入全部玩家的数据中。

View File

@@ -0,0 +1,99 @@
---
headerDepth: 0
---
# 软件设置
::: info
- 以下内容将以胡桃工具箱内的设置功能的条目排列顺序为介绍顺序
:::
## 关于 胡桃
- 胡桃工具箱的图标:您可以在胡桃的[首页](https://hut.ao/)查看它的原图
- 该图像作品的作者为[LOFTER@夙夜](https://dieqi32894.lofter.com/post/4b58ce16_2b6b2d365)并由[DGP-Studio](https://github.com/DGP-Studio)后期处理后,授权使用
- 胡桃的版本号
- 设备ID
- 反馈
- 点击`前往反馈`的按钮,即可跳转至相关页面
## 外观
- 背景材质
- 在此选项中,您可以更改背景的材质为:
- 亚克力
- 云母
- 变种云母
- 每个背景材质被选中后,您可以即时查看更改后的效果
@slidestart auto
## Windows 10 亚克力
![win10-亚克力](https://img.alicdn.com/imgextra/i1/1797064093/O1CN01B7nKOj1g6du9bj3Nw_!!1797064093.png)
---
## Windows 11 亚克力
![win11-亚克力](https://img.alicdn.com/imgextra/i1/1797064093/O1CN01MXJZE61g6dtvtITxC_!!1797064093.jpg)
---
## Windows 11 云母
![win11-云母](https://img.alicdn.com/imgextra/i4/1797064093/O1CN01aW0iV71g6du5WAz9w_!!1797064093.jpg)
---
## Windows 11 变种云母
![win11-变种云母](https://img.alicdn.com/imgextra/i3/1797064093/O1CN010BwmBI1g6du9bi7C0_!!1797064093.jpg)
@slideend
## 祈愿记录
- 在此条目中,您可以选择是否隐藏无记录的历史祈愿活动,即"没有祈愿记录的卡池"
## 游戏
- 游戏路径
- 在此条目中,可以修改或设置您的游戏路径
- 选择游戏路径时,请注意此处选择的应是游戏本身
- 形如:"$\Genshin Impact\Genshin Impact Game\YuanShen.exe"
- 删除游戏内网页缓存
- 若您在使用**祈愿记录功能**时,选择**使用"从缓存刷新"**,但**频繁提示**验证密钥过期,可以尝试此操作
- 点击此选项内的`删除`按钮即可
## 测试功能
- 打开`数据`文件夹
- 在此选项中点击"打开"按钮,即可打开包含"用户数据/日志/元数据"的文件夹
- 尤其在您需要[反馈](https://hut.ao/statements/bug-report.html)或需要以[通用方式](https://hut.ao/FAQ/most-frequent-questions.html#%E5%85%B6%E4%BB%96%E9%97%AE%E9%A2%98%E7%9A%84%E9%80%9A%E7%94%A8%E6%8E%92%E6%9F%A5%E6%96%B9%E5%BC%8F)排查问题时,可以在此处快捷打开此文件夹,并进行进一步操作
- 打开`缓存`文件夹
- 在此选项中点击"打开"按钮,即可打开包含"图片缓存"的文件夹
- 在此文件夹内,存储了`胡桃工具箱`在运行期间产生的`图片缓存`
- 米游社每日签到
- 如何使用
- 首先需要您在`米游社多账号切换`功能中,选中当前需要进行签到的米游社账号
- 点击"打开签到对话框"按钮
- 在每次需要对其他账号(若存在)进行米游社签到前,可能需要重新打开胡桃工具箱
- 出现"签到对话框"长时间无反应,可尝试将当前米游社账号的登陆状态删除后重新在胡桃工具箱内登录,并将胡桃工具箱重启
- 出现"签到对话框"内显示的内容出现异常,请将胡桃工具箱重启(此过程可多次进行)
- 若多次尝试依然失败,请按下述步骤进行反馈,以便于开发者对此功能尽快完善!
- 由于此功能为测试功能,对于可能发生的签到失败情形,您可以按如下步骤进行反馈,以便于我们进行改进
- 在"文件资源管理器"中,打开`%userprofile%/documents/hutao`目录
- 保持该"文件资源管理器"处于打开状态
- 重新启动"胡桃工具箱"
- 进入`设置`
- 点击`打开签到对话框`按钮
- 弹出对话框后等待约5秒
- 回到"文件资源管理器"
- 将此时的`log.db`文件复制到其他位置,并[随issue一同提交](https://github.com/DGP-Studio/Snap.Hutao/issues/new/choose)
- 该功能的正常使用界面:
![米游社每日签到](https://img.alicdn.com/imgextra/i4/1797064093/O1CN01WCLbxe1g6duCXB6tc_!!1797064093.png)
## 危险功能
- 删除所有计划任务
- 当你需要卸载胡桃工具箱时,可以使用此功能以删除胡桃工具箱的定时数据拉取任务
- 删除所有用户
- 此功能的作用是删除用户表的所有记录,用户修复特定的账号冲突问题
- 点击`执行`按钮即可完成删除
- 通常情况下,用户不需要使用此功能来删除用户表的信息

View File

@@ -0,0 +1,27 @@
---
headerDepth: 0
---
# 米游社多帐号切换
::: tip
本文档所描述的帐号切换指的是用于获取游戏数据的米游社帐号,不是原神游戏内的帐号
:::
![多帐号管理样图](https://img.alicdn.com/imgextra/i4/1797064093/O1CN01tRs9NH1g6du1XgyDZ_!!1797064093.png)
- 你可以在程序主界面的左下角,设置按钮的上方找到帐号菜单,以管理你在胡桃工具箱中登录的米游社帐号。在弹出的面板中你可以:
- 点击`登录米哈游通行证`按钮
- 在弹出的内置浏览器中登录"米哈游通行证"账号
- 您也可以通过点击`手动输入`按钮,直接输入米游社通行证 cookie 来添加您的帐号
- 若您选择`手动输入`米游社 cookie则该 cookie **必须包含 `Stoken` 字段**
- 手动获取含 `Stoken` 字段的 cookie 的方式可参考[使用第三方工具获取有 Stoken 的 cookie](../FAQ/get-Stoken-cookie-from-the-third-party.md)文档
- 在弹出的内置浏览器登陆成功后,点击右上角的"我已登陆"按钮
- 完成后,您就可以在帐号管理面板切换已登录的米游社帐号了
- 新添加米游社账号后,需在主界面左下角切换账号的功能中,手动点击一次新登录的账号,以将其设置为使用状态
- 你可以在帐号管理菜单中复制对应帐号的 cookie 或从胡桃工具箱中删除该帐号
::: danger 安全提示
- `Stoken` 是一个安全敏感的 cookie 字段,你不应该在任何云端或其它无法保证数据安全的设备上储存含有 `Stoken` 字段的 cookie。
- 从胡桃工具箱中复制获得的 cookie 中包含该字段,请慎重考虑是否为接受 cookie 的一方提供 `Stoken` 字段。
:::

View File

@@ -0,0 +1,25 @@
---
headerDepth: 0
---
# 武器资料
![weapon-wiki](https://img.alicdn.com/imgextra/i1/1797064093/O1CN01jbzlTH1g6du6KfSmF_!!1797064093.png)
武器资料是胡桃工具箱中内置的用于查询各个武器的**外观、参数、精炼效果、推荐搭配**等数据的 Wiki
## 已包含的数据
- 武器列表
- 使用列表左上角的按钮,可切换列表显示的方式:即"缩略图与名称"或"仅缩略图"
- 单击列表中的缩略图或名称,即可跳转到相应的介绍页面
- 数据内容
- 武器基本信息
- 突破前后的武器图标对比
- 对应武器的立绘展示
- 武器的简介内容
- **可切换**至对应等级的武器各项数值
- 武器精炼信息
- 对应精炼阶数的精炼属性
- 根据胡桃数据库的统计信息而展示的**武器使用**的相关推荐

View File

@@ -2,32 +2,78 @@
headerDepth: 0
---
# 原神祈愿记录导出
# 祈愿记录
![wish-export-sample](/images/202209/wish-export.png)
有关原神祈愿记录导出的技术原理,你可以参阅我们的[**祈愿系统与导出原理**](/FAQ/Gacha-system-and-export-principal.md)一文
抽卡是原神的核心玩法之一,无论是出于纪念、炫耀的目的还是认真规划抽取计划,对历史抽卡进行统计分析都是非常重要的。
但是原神官方只为玩家提供了半年的抽卡记录,这是很不友好的(~~但是他们还是统计了你一整年杀了多少提米的鸽子~~)。
## 从原神服务器获取最新的祈愿记录
- 打开原神游戏本体,进入祈愿界面,点击 `历史记录`
- 启动胡桃工具箱,从左侧菜单栏进入 `祈愿记录`
- 点击右上角的 `刷新` 按钮
- 在大多数情况下,点击`从缓存刷新`后胡桃工具箱即可开始获取你的祈愿记录
- 点击`Stoken刷新`胡桃工具箱会通过当前登录的米游社帐号推算出帐号的祈愿记录Url并自动获取祈愿记录
- 如果你通过其它工具获取到了你祈愿历史记录的Url可以选择`手动输入Url`并根据提示操作
- 等待祈愿记录获取完成
因此,我们需要利用这半年的抽卡记录调取窗口,将抽卡记录转移到我们自己手中,这就是胡桃工具箱中祈愿记录导出功能的目的所在。
有关原神祈愿记录导出的技术原理,你可以参阅我们的[**祈愿系统与导出原理**](/FAQ/Gacha-system-and-export-principal.md)一文。
![祈愿导出](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01B2DDii1g6du87XIIG_!!1797064093.png)
::: note 原神抽卡记录的延迟性
胡桃工具箱获取抽卡记录的来源也为米哈游服务器,因此短时间内刚刚结束的抽卡无法被获取。
当你在游戏内抽卡历史记录中看到了最新的一批抽卡记录,则可以在胡桃中获取统计数据。
:::
## 获取祈愿数据
### 利用 Stoken 从服务器获取最新的祈愿记录 <Badge text="推荐" type="tip" />
::: info 提示
- 已登录的米游社帐号是使用 Stoken 刷新方法的前提,你可以参考[米游社多帐号切换](mhy-account-switch.md)一文在胡桃工具箱中登录你的帐号
- Stoken 刷新方法暂不支持国际服
:::
- 在胡桃工具箱中确保你需要获取记录的米游社帐号已登录
- 从左侧菜单栏进入`祈愿记录`
- 点击右上角的`刷新`,并点击`Stoken刷新`
- 等待读取完毕,即可查看最新的祈愿记录
### 从网页缓存获取最新的祈愿记录 <Badge text="支持国际服" type="tip" />
- 从左侧菜单栏进入`祈愿记录`
- 启动游戏并登入游戏,打开游戏内的祈愿历史记录
- 回到胡桃工具箱,点击`刷新`按钮,在刷新菜单中点击`网页缓存刷新`
::: tip
若出现`网页缓存刷新`功能异常的情况:
- 从胡桃工具箱的`设置`中进入`缓存文件夹`
- 删除 `ImageCache` 文件夹
:::
### 通过输入 Url 获取祈愿记录 <Badge text="支持国际服" type="tip" />
- 如果你通过其它工具获取到了你祈愿历史记录的 Url可以选择`手动输入Url`并根据提示操作
- 但应注意此类 Url **具有时效性**
### 对于全量刷新选项的补充说明
在默认情况下胡桃工具箱会在匹配到本地已有记录的祈愿ID后停止导入。
但如果你希望完整地获取原神服务器中所有的历史记录(即使它已经存在于你的本地祈愿记录中),你可以勾选`全量新`
**不勾选`全量新`不会使你丢失祈愿数据,勾选`全量新`也不会让你的本地记录错误地额外记录一次相同的祈愿数据。**
## 从其它祈愿导出程序导入祈愿数据
胡桃工具箱支持导入 `UIGF数据格式` 的祈愿记录数据
但如果你希望完整地获取原神服务器中所有的历史记录(即使它已经存在于你的本地祈愿记录中),你可以勾选`全量新`
**不勾选`全量新`不会使你丢失祈愿数据,勾选`全量新`也不会让你的本地记录错误地额外记录一次相同的祈愿数据。**
### 从其它祈愿导出程序导入祈愿数据 <Badge text="UIGF" type="info" />
胡桃工具箱支持导入 `UIGF 数据格式` 的祈愿记录数据[^UIGF-Org]
如果你希望导入这一类数据,可以:
- 启动胡桃工具箱,从左侧菜单栏进入`祈愿记录`
- 点击右上角的`导入`
- 选择`从 UIGF Json 文件导入`
- 选择你的 UIGF 数据文件
- 根据界面确认导入数据
- 选择你的 UIGF Json 数据文件
- 根据界面确认导入数据
## 导出祈愿数据 <Badge text="UIGF" type="info" />
胡桃工具箱支持导出 `UIGF数据格式` 的 Json 文件格式的祈愿记录数据
如果你希望导出祈愿数据,可以:
- 启动胡桃工具箱,从左侧菜单栏进入`祈愿记录`
- 选择您要导出的祈愿记录存档
- 点击`导出`按钮
- 在弹出的界面选择您需要将此导出的祈愿记录数据文件存放的位置,并点击`导出`
- 导出完成
[^UIGF-Org]: 统一标准化的原神数据格式由 [UIGF-Org](https://uigf.org/) 提供