style: format zh docs

This commit is contained in:
Mr.Hope
2023-04-26 13:03:02 +08:00
parent a02b8f8cfe
commit 0ef4e93324
34 changed files with 598 additions and 412 deletions

View File

@@ -4,6 +4,7 @@ comment: false
index: false
redirectFrom: /features/
---
# 功能指南
<AutoCatalog />
<AutoCatalog />

View File

@@ -1,20 +1,21 @@
---
headerDepth: 0
category: [功能,教程]
category: [功能, 教程]
order: 3
redirectFrom: /features/achievements.html
---
# 成就管理
# 成就管理
![](https://img.alicdn.com/imgextra/i1/1797064093/O1CN01eddfVC1g6du4Xdd9P_!!1797064093.png_.webp)
胡桃工具箱提供成就管理功能,用户可以通过它浏览并管理所有的成就状态
- 在第一次使用时,你需要根据提示点击`创建新存档`按钮以创造一个成就存档并为其命名
- 创建第一个资料页后,你可以点击右上角的`创建新存档`来继续为更多的帐号创建成就记录档案
- 创建第一个资料页后,你可以点击右上角的`创建新存档`来继续为更多的帐号创建成就记录档案
## 视频指南
对于大多数人而言,遵循本页文档会有更高的效率。
但如果你对其中包含的操作不熟悉,也可以回到这里来跟着视频指南操作。
@@ -25,12 +26,11 @@ redirectFrom: /features/achievements.html
## 成就导入
- 胡桃工具箱使用[统一可交换成就标准](https://uigf.org/zh/standards/UIAF.html)数据标准来储存用户的成就数据
- 该标准允许用户从其它**成就导出工具**中通过 Url 协议和剪贴板将数据导入到胡桃工具箱中
- 该标准允许用户从其它**成就导出工具**中通过 Url 协议和剪贴板将数据导入到胡桃工具箱中
- 你可以点击成就页面右上角隐藏菜单中的`导入`按钮,并选择`从 UIAF 文件导入`以加载以 UIAF 数据格式储存的第三方成就数据
## 推荐使用的成就识别工具
- [YaeAchievement](https://github.com/HolographicHat/YaeAchievement) <Badge text="成就识别" type="tip" />
- [椰羊cocogoat](https://cocogoat.work/) <Badge text="成就攻略" type="tip" />
- [椰羊 cocogoat](https://cocogoat.work/) <Badge text="成就攻略" type="tip" />

View File

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

View File

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

View File

@@ -1,47 +1,44 @@
---
headerDepth: 0
category: [功能,教程]
category: [功能, 教程]
order: 7
redirectFrom: /features/developer-plan.html
---
# 养成计划
# 养成计划
![dev-plan](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01huh2t51g6du5DUiGt_!!1797064093.png_.webp)
## 添加养成目标进入材料清单
## 添加养成目标进入材料清单
### 基于 WIKI 资料添加
- 在胡桃工具箱的左侧栏目中,点击`角色资料``武器资料`功能
- 在"胡桃工具箱"的整体界面右上部分,点击`养成计算`按钮
- 在弹出的"添加到当前养成计划"的窗口中,填写角色需要计算的各项属性的起始等级以及目标等级
- 基于 WIKI 资料添加的养成目标,默认初始值为1
- 基于 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)直接向我们反馈,感谢您的贡献!
- 在"胡桃工具箱"的整体界面右上部分,可点击"删除计划"按钮,将当前的养成计划删除
- 在删除当前养成计划后,处于切换至该养成计划时,输入的背包物品信息将一同删除
## 功能说明
此功能尚在完善阶段,若您有建设性的建议,或发现了显著的问题,请按[此页面](../statements/bug-report.md)直接向我们反馈,感谢您的贡献!

View File

@@ -1,6 +1,6 @@
---
headerDepth: 0
category: [功能,教程]
category: [功能, 教程]
order: 1
redirectFrom: /features/game-launcher.html
---
@@ -11,12 +11,13 @@ redirectFrom: /features/game-launcher.html
- 你可以通过点击左侧菜单栏中的`启动游戏`进入高级启动器功能
- 第一次使用时你会被跳转到设置页面以设置你的游戏路径
- 选择游戏路径时,请注意此处选择的应是游戏本身
- 形如:`$\Genshin Impact\Genshin Impact Game\YuanShen.exe`
- 而官方启动器的目录一般是`$\Genshin Impact\launcher.exe`
- 形如:`$\Genshin Impact\Genshin Impact Game\YuanShen.exe`
- 而官方启动器的目录一般是`$\Genshin Impact\launcher.exe`
- 在设置完毕启动游戏所需的附加选项后,点击右上角的`启动游戏`按钮即可
- 附加选项请看本页下方的功能文档
## 视频指南
对于大多数人而言,遵循本页文档会有更高的效率。
但如果你对其中包含的操作不熟悉,也可以回到这里来跟着视频指南操作。
@@ -25,97 +26,115 @@ redirectFrom: /features/game-launcher.html
:::
## 切换服务器
::: tip 权限提示
1. 使用该功能时需要以管理员权限启动胡桃工具
2. 胡桃工具箱会在数据目录下创建一个名为 `ServerCache` 的文件夹并储存转换服务器所需要的文件
:::
- 在主界面点击左侧菜单栏进入`启动游戏`页面
- 找到`常规`分类中的`服务器`一栏
- 点击右侧选项中的服务器名称,选择要进入的服务器
- 目前可选的服务器包括:
| 选项 | 服务器 |
|----------------|---------------------------------------------------|
| 官方服 | 中国大陆服务器 |
| 渠道服 | 使用 BiliBili 帐号登录的中国大陆服务器 |
| 国际服 Default | HoYoVerse 国际服服务器 |
| 国际服 Epic | 使用 Epic 商城支付网关的 HoYoVerse 国际服服务器 |
| 国际服 Google | 使用 Google Pay 支付网关的 HoYoVerse 国际服服务器 |
- 目前可选的服务器包括:
| 选项 | 服务器 |
|----------------|---------------------------------------------------|
| 官方服 | 中国大陆服务器 |
| 渠道服 | 使用 BiliBili 帐号登录的中国大陆服务器 |
| 国际服 Default | HoYoVerse 国际服服务器 |
| 国际服 Epic | 使用 Epic 商城支付网关的 HoYoVerse 国际服服务器 |
| 国际服 Google | 使用 Google Pay 支付网关的 HoYoVerse 国际服服务器 |
- 点击右上角的`启动游戏`按钮,胡桃会自动下载并应用对应服务器的文件并启动游戏
## 账号保存
::: tip
1. 本功能所描述的帐号,特指当前原神所登录游戏账号的登录状态
2. **目前仅支持切换官方服(不含渠道服)帐号**
:::
| | 官方服 | 渠道服 | 国际服 |
|--------|-----|-----|--------------------------------------------------------------------------------|
| 保存登录状态 | 支持 | 支持 | 支持 |
| 切换账号 | 支持 | 不支持 | 理论支持<br/>[我们期待更多的社区开发者帮助](https://github.com/DGP-Studio/Snap.Hutao/issues/638) |
| | 官方服 | 渠道服 | 国际服 |
| ------------ | ------ | ------ | ------------------------------------------------------------------------------------------------ |
| 保存登录状态 | 支持 | 支持 | 支持 |
| 切换账号 | 支持 | 不支持 | 理论支持<br/>[我们期待更多的社区开发者帮助](https://github.com/DGP-Studio/Snap.Hutao/issues/638) |
1. 在主界面点击左侧菜单栏进入`启动游戏`标签
2. 点击`常规`分类中的`检测账号`一栏,胡桃工具箱会保存当前原神游戏的登录状态
3. 在弹出的`为账号命名`界面中,输入您要为此账号设置的名称,点击确认
4. 在游戏中,注销当前登录并登录你另一个帐号。重复执行上述的第2步和第三步直至你将全部的帐号添加进胡桃工具箱中。
4. 在游戏中,注销当前登录并登录你另一个帐号。重复执行上述的第 2 步和第三步直至你将全部的帐号添加进胡桃工具箱中。
5. 此时即可在`账号`功能下方自由选择您要切换的账号
- 每个已保存的账号均为可点击选择的按钮
- 在其右侧有三个按钮,分别为:
- `绑定当前用户角色`即将您当前选择的米游社登录状态绑定至该账号中点击该按钮后对应的UID将出现在该账号自定义名称的下方
- `重命名`,即修改当前选择账号的自定义名称
- `删除`,即删除当前选择的账号
- 每个已保存的账号均为可点击选择的按钮
- 在其右侧有三个按钮,分别为:
- `绑定当前用户角色`,即将您当前选择的米游社登录状态绑定至该账号中,点击该按钮后,对应的 UID 将出现在该账号自定义名称的下方
- `重命名`,即修改当前选择账号的自定义名称
- `删除`,即删除当前选择的账号
## 外观选项
## 外观选项
::: warning
- 在当前的游戏版本中,有案例表明部分用户使用胡桃工具箱,选择**独占全屏**模式启动原神游戏,出现游戏无响应或卡顿的情况
- 建议此部分用户使用无边框选项进行启动游戏
- 问题的来源是游戏内置浏览器无法运行
:::
:::
- 在主界面点击左侧菜单栏进入`启动游戏`标签
-`外观`功能中,有六个选项:
- **独占全屏**,即选择游戏进程以独占全屏模式运行
- **全屏**,即选择启动游戏后的游戏界面是否设置为全屏
- **无边框**,即选择启动游戏后的游戏界面是否设置为无边框窗口
- **宽度**,即选择启动游戏后的游戏界面的宽度,例如`1920`
- **高度**,即选择启动游戏后的游戏界面的高度,例如`1080`
- **显示器**,允许多显示器用户选择指定的显示器来运行游戏
- **独占全屏**,即选择游戏进程以独占全屏模式运行
- **全屏**,即选择启动游戏后的游戏界面是否设置为全屏
- **无边框**,即选择启动游戏后的游戏界面是否设置为无边框窗口
- **宽度**,即选择启动游戏后的游戏界面的宽度,例如`1920`
- **高度**,即选择启动游戏后的游戏界面的高度,例如`1080`
- **显示器**,允许多显示器用户选择指定的显示器来运行游戏
## 高级功能
::: danger
- 请注意:高级功能已明确标注为 `Dangerous Feature`,即**危险功能**,选择启用即代表您选择自行承担任意风险
- 你需要首先在胡桃设置页面中启用高级功能
:::
### 解锁帧率上限
::: danger
- [Unlocker项目](https://github.com/DGP-Studio/Unlocker)仅作用于 UnityPlayer 本身,即直接作用于 Unity3D 引擎,与游戏本体不发生直接关系,本质上与移动端中`120帧率`等设置无异,但您仍应谨慎使用并自行阅读[用户协议](../statements/tos.md)
- [Unlocker 项目](https://github.com/DGP-Studio/Unlocker)仅作用于 UnityPlayer 本身,即直接作用于 Unity3D 引擎,与游戏本体不发生直接关系,本质上与移动端中`120帧率`等设置无异,但您仍应谨慎使用并自行阅读[用户协议](../statements/tos.md)
:::
- 使用`管理员模式`启动胡桃
- 在主界面点击左侧菜单栏进入`启动游戏`标签
- 在最下方可见 `解锁帧率限制` 选项
- 在右侧点击`开启或关闭`按钮,所显示的 `禁用``启用` 分别代表`已禁用``已启用`该功能
-下方的 `设置帧率上限` 选项中,可自由拖动拉杆,调整到您需要设置的最高帧率上限
-右侧点击`开启或关闭`按钮,所显示的 `禁用``启用` 分别代表`已禁用``已启用`该功能
- 在下方的 `设置帧率上限` 选项中,可自由拖动拉杆,调整到您需要设置的最高帧率上限
- 会导致**解锁帧率上限失败**的因素:
- 胡桃工具箱没有保持在后台运行
- 游戏内未关闭**垂直同步**选项
- 在显卡驱动中存在`最大帧速率`的设置
- 在显卡驱动软件内存在未关闭的类似于`节能模式`的选项
- 在显卡驱动软件内存在未关闭的类似于`节能模式`的选项
- 显卡性能不足
### 游戏客户端多开
::: danger
游戏客户端多开是一个远比解锁帧率上限还危险的功能,你应当在亲自或邀请有技术知识的专业人士审阅代码后自行判断是否使用该功能。
**使用该功能会导致原神反作弊功能加载失败,原神客户端会向米哈游服务器汇报该现实情况。**
:::
1. 使用`管理员模式`启动胡桃
2. 在主界面点击左侧菜单栏进入`启动游戏`标签
3. 在最下方启用 `多客户端` 选项
4. 点击右上角的`启动游戏`
5. 等待12秒后再进门
6. 重复步骤4和步骤5以开启下一个客户端
5. 等待 12 秒后再进门
6. 重复步骤 4 和步骤 5 以开启下一个客户端

View File

@@ -1,6 +1,6 @@
---
headerDepth: 0
category: [功能,教程]
category: [功能, 教程]
order: 6
redirectFrom: /features/hutao-API.html
---
@@ -8,11 +8,13 @@ redirectFrom: /features/hutao-API.html
# 胡桃数据库/深渊统计
胡桃工具箱提供两个主要的深境螺旋挑战统计的功能
- 侧栏中的`深渊统计`是一个旨在通过统计并展示广大玩家深境螺旋挑战数据,来帮助对原神对战系统不熟悉玩家组建队伍、通关深渊、获取奖励的功能
- 侧栏中的`深渊记录`是一个通过保存玩家每一期深境螺旋挑战数据来帮助个人玩家回顾游戏经历及个人数据收集的统计功能
- 众多的玩家通过上传个人的`深渊记录`来形成胡桃数据库的`深渊统计`数据集
::: tabs
@tab 角色使用率
![character-usage-rate](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01VNtgaU1g6du5Mh1Oo_!!1797064093.png_.webp)
@tab 角色出场率
@@ -25,19 +27,23 @@ redirectFrom: /features/hutao-API.html
![personal-record-stat](https://img.alicdn.com/imgextra/i2/1797064093/O1CN01xMLXhn1g6du6lPUDD_!!1797064093.png_.webp)
@tab 个人数据详情
![personal-record-details](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01xtWJfr1g6dtvjZLWZ_!!1797064093.png_.webp)
:::
## 查看深渊数据
## 查看深渊数据
::: warning 数据范围局限性
所有计算数据都基于**已上传至胡桃数据库中的玩家数据**,无法代表全部原神玩家的平均数据,数据仅做参考用途
:::
:::
::: info 数据刷新周期
1. 深境螺旋统计数据角色使用率、角色出场率、队伍出场在帐号所属游戏服务器时区每月1日和16日的4点自动清理。
1. 深境螺旋统计数据(角色使用率、角色出场率、队伍出场)在帐号所属游戏服务器时区每月 1 日和 16 日的 4 点自动清理。
- 点击界面右上角的信息按钮你可以查看当前实时已上传的总数据
2. 同时若用户在30天内没有重新上传记录以更新数据则其的角色持有数据将被清理
:::
2. 同时,若用户在 30 天内没有重新上传记录以更新数据,则其的角色持有数据将被清理
:::
- 在主界面点击左侧菜单栏进入`深渊统计`页面
- 点击`角色使用`以查看角色使用率数据
- 角色使用率 = 角色在当前层数出场次数[^first] / 持有该角色的玩家在该层数的总记录数
@@ -51,31 +57,33 @@ redirectFrom: /features/hutao-API.html
## 上传深境螺旋数据
### 使用胡桃客户端
- 在主界面点击左侧菜单栏进入`深渊记录`功能页面
- 点击右上角的`刷新数据`以确保胡桃工具箱客户端已经获取到最新的个人深境螺旋数据
- 点击右上角的`上传数据`以上传你的深境螺旋数据
- 这可能需要花费数秒,上传成功后你将会看到如下图的成功提示
![upload-hutaoapi](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01Zt7yQp1g6duBDALeX_!!1797064093.png_.webp)
![upload-hutaoapi](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01Zt7yQp1g6duBDALeX_!!1797064093.png_.webp)
### 使用浏览器
::: info
该方法不适用于 HoYoLab
:::
- 打开我们的 [JavaScript 脚本](/upload-abyss-data.js),复制全部内容
- 在浏览器中创建一个新的书签
- 在名称中填写一个合适的名称
- 在 URL 中粘贴你刚刚复制的全部代码
![add-bookmark](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01p0KOqU1g6dvfDQO6e_!!1797064093.png_.webp)
- 访问米游社,在页面加载完成后点击你刚刚创建的书签
- 稍等片刻,你应该能看到请求上传的确认窗口
- 在确认后,浏览器将上传你的深渊数据,请勿关闭米游社页面
- 在上传完成后,浏览器会有确认完成的提示窗口
[^first]: 在当前层中不同间内多次出现的同一个角色仅记1次出场次数
[^first-2]: 在当前层中不同间内多次出现的同一个角色仅记1次出场次数
[^first]: 在当前层中不同间内多次出现的同一个角色仅记 1 次出场次数
[^first-2]: 在当前层中不同间内多次出现的同一个角色仅记 1 次出场次数
[^second]: 角色持有数据与深境螺旋记录独立
[^third]: 只要拥有该角色,即使没有在深境螺旋中登场,也会被计入拥有的状态;只要上传过深境螺旋记录,即会被计入全部玩家的数据中。

View File

@@ -1,6 +1,6 @@
---
headerDepth: 0
category: [功能,教程]
category: [功能, 教程]
order: 11
redirectFrom: /features/hutao-settings.html
---
@@ -8,87 +8,101 @@ redirectFrom: /features/hutao-settings.html
# 软件设置
::: info
- 以下内容将以胡桃工具箱内的设置功能的条目排列顺序为介绍顺序
:::
:::
## 关于 胡桃
该部分包含以下信息:
- 胡桃工具箱的图标:您可以在胡桃的[首页](/)查看它的原图
- 该图像作品的作者为[画画的芦苇](https://space.bilibili.com/274422134)
::: details 图标的绘制过程
<BiliBili bvid="BV1UL411d7Py" />
:::
- [DGP-Studio](https://github.com/DGP-Studio)已被所有者授权使用
- 该图像作品的作者为[画画的芦苇](https://space.bilibili.com/274422134)
::: details 图标的绘制过程
<BiliBili bvid="BV1UL411d7Py" />
:::
- [DGP-Studio](https://github.com/DGP-Studio)已被所有者授权使用
- 胡桃的版本号
- 设备ID
- 设备 ID
## 胡桃帐号 <Badge text="测试功能" type="info" />
![Hutao-account](https://img.alicdn.com/imgextra/i1/1797064093/O1CN01TUwTiE1g6dvNZZWy9_!!1797064093.png_.webp)
胡桃帐号是由 DGP-Studio 团队创建的为胡桃工具箱服务的帐号系统,以使用在会在未来提供的包括祈愿云同步在内的涉及云端服务的功能。
目前胡桃帐号已支持注册和登录,你可以在设置中点击这一选项以注册并登录你的帐号。
## 外观
- 语言
- 默认情况下胡桃会跟随系统设置来显示对应的语言
- 使用该功能你可以强制将胡桃的显示语言设置为指定的语言
- 背景材质
- 在此选项中,您可以更改背景的材质为:
- 亚克力
- 云母 Windows 11 特性)
- 变种云母Windows 11 特性)
- 每个背景材质被选中后,您可以即时查看更改后的效果
- 在此选项中,您可以更改背景的材质为:
- 亚克力
- 云母 Windows 11 特性)
- 变种云母Windows 11 特性)
- 每个背景材质被选中后,您可以即时查看更改后的效果
@slidestart auto
## Windows 10 亚克力
![win10-亚克力](https://img.alicdn.com/imgextra/i1/1797064093/O1CN01B7nKOj1g6du9bj3Nw_!!1797064093.png_.webp)
---
## Windows 11 亚克力
![win11-亚克力](https://img.alicdn.com/imgextra/i1/1797064093/O1CN01MXJZE61g6dtvtITxC_!!1797064093.jpg_.webp)
---
## Windows 11 云母
![win11-云母](https://img.alicdn.com/imgextra/i4/1797064093/O1CN01aW0iV71g6du5WAz9w_!!1797064093.jpg_.webp)
---
## Windows 11 变种云母
![win11-变种云母](https://img.alicdn.com/imgextra/i3/1797064093/O1CN010BwmBI1g6du9bi7C0_!!1797064093.jpg_.webp)
@slideend
## 祈愿记录
- 在此条目中,您可以选择是否隐藏无记录的历史祈愿活动,即"没有祈愿记录的卡池"
## 游戏
- 游戏路径
- 在此条目中,可以修改或设置您的游戏路径
- 选择游戏路径时,请注意此处选择的应是游戏本身
- 形如:`$\Genshin Impact\Genshin Impact Game\YuanShen.exe`
- 在此条目中,可以修改或设置您的游戏路径
- 选择游戏路径时,请注意此处选择的应是游戏本身
- 形如:`$\Genshin Impact\Genshin Impact Game\YuanShen.exe`
- 删除游戏内网页缓存
- 若您在使用**祈愿记录功能**时,选择**使用"从缓存刷新"**,但**频繁提示**验证密钥过期,可以尝试此操作
- 点击此选项即可执行操作
- 若您在使用**祈愿记录功能**时,选择**使用"从缓存刷新"**,但**频繁提示**验证密钥过期,可以尝试此操作
- 点击此选项即可执行操作
## 储存空间
- 打开`数据`文件夹
- 点击此选项,即可打开包含"用户数据/日志/元数据"的文件夹
- 打开`数据`文件夹
- 点击此选项,即可打开包含"用户数据/日志/元数据"的文件夹
- 更换数据目录
- 此选项将允许用户将数据文件夹设置到其它目录
- 打开`缓存`文件夹
- 点击此选项即可打开包含"图片缓存"的文件夹
- 在此文件夹内,存储了`胡桃工具箱`在运行期间产生的`图片缓存`
- 此选项将允许用户将数据文件夹设置到其它目录
- 打开`缓存`文件夹
- 点击此选项即可打开包含"图片缓存"的文件夹
- 在此文件夹内,存储了`胡桃工具箱`在运行期间产生的`图片缓存`
- 重置图片资源
- 此选项允许用户在有大量图片下载失败的情况下重置缓存记录,执行该操作后软件会重启并重新下载图片缓存资源
### 米游社每日签到
::: tip
@@ -96,24 +110,24 @@ redirectFrom: /features/hutao-settings.html
:::
- 如何使用
- 首先需要您在`米游社多账号切换`功能中,选中当前需要进行签到的米游社账号
- 点击"打开签到对话框"按钮
- 胡桃工具箱会打开签到页面,随后你即可手动签到
- 该功能的正常使用界面:
- 首先需要您在`米游社多账号切换`功能中,选中当前需要进行签到的米游社账号
- 点击"打开签到对话框"按钮
- 胡桃工具箱会打开签到页面,随后你即可手动签到
- 该功能的正常使用界面:
![米游社每日签到](https://img.alicdn.com/imgextra/i4/1797064093/O1CN01WCLbxe1g6duCXB6tc_!!1797064093.png_.webp)
## 危险功能
- 启用高级功能
- 在管理员模式下,你可以通过启用这一栏设置以启用游戏启动器中的高级功能
- 在管理员模式下,你可以通过启用这一栏设置以启用游戏启动器中的高级功能
> 参考阅读:
>
>
> [胡桃工具箱用户协议](../statements/tos.html)
>
>
> [原神用户协议(国服)](https://ys.mihoyo.com/main/company/agreement)
>
>
> [原神用户协议(国际服)](https://genshin.hoyoverse.com/en/company/terms)
- 删除所有用户
- 此功能的作用是删除用户表的所有记录
- 点击`执行`按钮即可完成删除
- 通常情况下,用户不需要使用此功能来删除用户表的信息
- 此功能的作用是删除用户表的所有记录
- 点击`执行`按钮即可完成删除
- 通常情况下,用户不需要使用此功能来删除用户表的信息

View File

@@ -1,6 +1,6 @@
---
headerDepth: 0
category: [功能,教程]
category: [功能, 教程]
order: 10
redirectFrom: /features/mhy-account-switch.html
---
@@ -9,12 +9,14 @@ redirectFrom: /features/mhy-account-switch.html
::: tip
胡桃工具箱支持中国大陆版米哈游论坛**米游社**和国际版论坛 **HoYoLab**的帐号。HoYoLab 默认阻拦来自中国大陆的网络连接Snap Hutao 软件无法自行绕开该限制。
- 本文档所描述的帐号切换指的是用于获取游戏数据的**米游社/ HoYoLab 帐号**,不是原神**游戏内的帐号**
- 在使用本功能前,你需要使用官方的米游社 App 登录你的帐号以初始化你的米游社功能
- 如果在胡桃中登录的帐号名称格式为 `user_123456789` 则其有可能没有被初始化
:::
![多帐号管理样图](https://img.alicdn.com/imgextra/i4/1797064093/O1CN01E3ojiY1g6dvI9mG8y_!!1797064093.png_.webp)
![多帐号管理样图](https://img.alicdn.com/imgextra/i4/1797064093/O1CN01E3ojiY1g6dvI9mG8y_!!1797064093.png_.webp)
::: details 胡桃工具箱视频指南 - 米游社帐号登录
对于大多数人而言,遵循本页文档会有更高的效率。
@@ -25,7 +27,7 @@ redirectFrom: /features/mhy-account-switch.html
:::
- 你可以在程序主界面的左下角,设置按钮的上方找到帐号菜单,以管理你在胡桃工具箱中登录的米游社帐号。在弹出的面板中你可以添加米游社或 HoYoLab 帐号
,登录它们的方法是一样的:
,登录它们的方法是一样的:
- 在对应的帐号种类中点击`网页登录`按钮
- 您也可以通过点击`手动输入`按钮,直接输入米游社通行证 cookie 来添加您的帐号
- 若您选择`手动输入`米游社 cookie则该 cookie **必须包含 `Stoken` 字段**
@@ -36,7 +38,9 @@ redirectFrom: /features/mhy-account-switch.html
- 你可以在帐号管理菜单中复制对应帐号的 cookie 或从胡桃工具箱中删除该帐号
::: info 安全提示
- `Stoken` 是一个安全敏感的 cookie 字段,你**不应该**在任何云端或其它无法保证数据安全的设备上储存含有 `Stoken` 字段的 cookie。
- 从胡桃工具箱中复制获得的 cookie 中包含该字段,请慎重考虑是否为接受 cookie 的一方提供 `Stoken` 字段。
- **在胡桃工具箱中通过密码或 cookie 登录米游社的过程中,你的数据只经米游社服务器和本地胡桃工具箱处理,不经过包括胡桃服务器在内的任何第三方服务。**
:::

View File

@@ -1,6 +1,6 @@
---
headerDepth: 0
category: [功能,教程]
category: [功能, 教程]
order: 4
redirectFrom: /features/daily-notes.html
---
@@ -13,16 +13,18 @@ redirectFrom: /features/daily-notes.html
![live-data-tracking](https://img.alicdn.com/imgextra/i1/1797064093/O1CN01mzYqiM1g6dvE0z3nZ_!!1797064093.png_.webp)
## 添加角色
- 点击`添加角色`按钮
- 在弹出的`添加角色`浮窗中,找到你要添加的游戏角色 UID并单击其右侧的加号按钮
- 此时您添加的游戏角色即可显示在实时便笺页面中
- 实时便笺是间隔固定时间自动刷新的
- 你可以点击窗口右上角的`通知设置`来设置查询的间隔时间
- 如您需要立即刷新以获取实时的最新数值,请单击`立即刷新`按钮
- 如出现"账号有风险,请前往米游社查看"字样的提示
- 请参考[账号风险提示](../advanced/mihoyo-risk-tip.md)文档
- 实时便笺是间隔固定时间自动刷新的
- 你可以点击窗口右上角的`通知设置`来设置查询的间隔时间
- 如您需要立即刷新以获取实时的最新数值,请单击`立即刷新`按钮
- 如出现"账号有风险,请前往米游社查看"字样的提示
- 请参考[账号风险提示](../advanced/mihoyo-risk-tip.md)文档
## 全局通知设置
- 在窗口右上角点击`通知设置`可以修改实时便笺的全局设置,包括:
- 数据刷新间隔时间
- 通知免打扰
@@ -44,5 +46,6 @@ redirectFrom: /features/daily-notes.html
- 点击`保存`,即可保存您当前所设置的通知选项
## 删除角色
- 将鼠标停留在需要被设置的角色实时便笺的窗体上
- 点击其窗体右上角出现的移除标志按钮,即可移除该角色对应的实时便笺

View File

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

View File

@@ -1,6 +1,6 @@
---
headerDepth: 0
category: [功能,教程]
category: [功能, 教程]
order: 2
redirectFrom: /features/wish-export.html
---
@@ -26,6 +26,7 @@ redirectFrom: /features/wish-export.html
:::
## 视频指南
对于大多数人而言,遵循本页文档会有更高的效率。
但如果你对其中包含的操作不熟悉,也可以回到这里来跟着视频指南操作。
@@ -34,95 +35,111 @@ redirectFrom: /features/wish-export.html
:::
## 获取祈愿数据
### 利用 Stoken 从服务器获取最新的祈愿记录 <Badge text="推荐" type="tip" />
### 利用 Stoken 从服务器获取最新的祈愿记录 <Badge text="推荐" type="tip" />
::: info 提示
- 已登录的米游社帐号是使用 Stoken 刷新方法的前提,你可以参考[米游社多帐号切换](mhy-account-switch.md)一文在胡桃工具箱中登录你的帐号
- Stoken 刷新方法暂不支持国际服
:::
:::
- 在胡桃工具箱中确保你需要获取记录的米游社帐号已登录
- 从左侧菜单栏进入`祈愿记录`
- 点击右上角的`刷新`,并点击`Stoken刷新`
- 等待读取完毕,即可查看最新的祈愿记录
### 从网页缓存获取最新的祈愿记录 <Badge text="支持国际服" type="tip" />
- 从左侧菜单栏进入`祈愿记录`
- 启动游戏并登入游戏,打开游戏内的祈愿历史记录
- 从左侧菜单栏进入`祈愿记录`
- 启动游戏并登入游戏,打开游戏内的祈愿历史记录
- 回到胡桃工具箱,点击`刷新`按钮,在刷新菜单中点击`网页缓存刷新`
::: tip
若出现`网页缓存刷新`功能异常的情况:
- 从胡桃工具箱的`设置`
-`删除游戏内网页缓存`功能中执行删除操作
:::
:::
### 通过输入 Url 获取祈愿记录 <Badge text="支持国际服" type="tip" />
- 如果你通过其它工具获取到了你祈愿历史记录的 Url可以选择`手动输入Url`并根据提示操作
- 但应注意此类 Url **具有时效性**
### 对于全量刷新选项的补充说明
在默认情况下胡桃工具箱会在匹配到本地已有记录的祈愿ID后停止导入。
但如果你希望完整地获取原神服务器中所有的历史记录(即使它已经存在于你的本地祈愿记录中),你可以勾选`全量刷新`
**不勾选`全量刷新`不会使你丢失祈愿数据,勾选`全量刷新`也不会让你的本地记录错误地额外记录一次相同的祈愿数据。**
### 对于全量刷新选项的补充说明
在默认情况下,胡桃工具箱会在匹配到本地已有记录的祈愿 ID 后停止导入。
但如果你希望完整地获取原神服务器中所有的历史记录(即使它已经存在于你的本地祈愿记录中),你可以勾选`全量刷新`
**不勾选`全量刷新`不会使你丢失祈愿数据,勾选`全量刷新`也不会让你的本地记录错误地额外记录一次相同的祈愿数据。**
### 从其它祈愿导出程序导入祈愿数据 <Badge text="UIGF" type="info" />
胡桃工具箱支持导入 `UIGF 数据格式` 的祈愿记录数据[^UIGF-Org]
如果你希望导入这一类数据,可以:
- 启动胡桃工具箱,从左侧菜单栏进入`祈愿记录`
- 点击右上角的`导入`
- 选择你的 UIGF Json 数据文件
- 根据界面确认导入数据
### 从 Snap Genshin 转移祈愿记录数据
如果你希望从 Snap Genshin 中转移祈愿数据至胡桃工具箱,你可以:
- 升级 Snap Genshin 到最新版本
- 进入`祈愿记录`功能
- 如果你由于无法登录米游社而无法进入 Snap Genshin可以在胡桃工具箱中登录米游社帐号并复制 Cookie 到 Snap Genshin
- 点击右上角的功能菜单
- 通过`导出 UIGF Json 文件`导出 Json 格式的祈愿记录
- 在胡桃工具箱中导入该文件
## 导出祈愿数据 <Badge text="UIGF" type="info" />
胡桃工具箱支持导出 `UIGF数据格式` 的 Json 文件格式的祈愿记录数据
如果你希望导出祈愿数据,可以:
- 启动胡桃工具箱,从左侧菜单栏进入`祈愿记录`
- 选择您要导出的祈愿记录存档
- 点击`导出`按钮
- 在弹出的界面选择您需要将此导出的祈愿记录数据文件存放的位置,并点击`导出`
- 导出完成
- 导出完成
## 祈愿记录云同步 <Badge text="测试功能" type="info" />
> 祈愿记录云同步功能基于胡桃云帐号,你需要[在设置中注册并登录胡桃帐号](hutao-settings#胡桃帐号)以使用该功能
在胡桃工具箱 1.6.1 版本中,我们推出了祈愿云同步功能。用户可以使用该功能,将本地的祈愿记录上传到胡桃云,避免珍贵的祈愿记录丢失,方便数据在多设备之间转移。
### 云同步权限
### 云同步权限
由于云同步是一个消耗胡桃服务器资源的功能,故该功能不向全部用户开放。目前,胡桃提供以下几种启用云同步功能的方法:
1. 在爱发电上打赏胡桃的用户,我们会向与爱发电邮箱帐号相匹配的胡桃帐号自动增加使用时间
2. 对于所有注册用户,在每一期深渊第一次成功向胡桃数据库上传深境螺旋挑战记录后,会获得5天的同步功能使用时间
2. 对于所有注册用户,在每一期深渊第一次成功向胡桃数据库上传深境螺旋挑战记录后,会获得 5 天的同步功能使用时间
3. 为胡桃工具箱开源社区贡献(包括但不限于代码开发、程序设计、本地化翻译)的用户,可以直接联系开发团队添加时长
- 我们目前正在设计一个完善而自动化的开发者许可证颁发流程,它将会随着胡桃帐号系统的完善而推出
当你的胡桃帐号云同步权限过期后,你将无法上传或下载数据,但你的数据不会被删除。你可以在恢复权限后重新操作你的云备份数据。
当你的胡桃帐号云同步权限过期后,你将无法上传或下载数据,但你的数据不会被删除。你可以在恢复权限后重新操作你的云备份数据。
在权限过期时,你仍然可以手动删除你的云端数据。
### 上传
- 在祈愿导出界面,选择你需要同步的祈愿存档
- 点击右上角的`胡桃云`按钮
- 点击`上传当前的祈愿存档`即可备份当前的存档数据至云端
### 下载
- 在祈愿导出界面,点击右上角的`胡桃云`按钮
- 在对应 UID 的帐号右侧点击下载按钮即可下载目标存档的云端数据
### 删除
- 在祈愿导出界面,点击右上角的`胡桃云`按钮
- 在对应 UID 的帐号右侧点击删除按钮即可删除目标存档的云端数据
[^UIGF-Org]: 统一标准化的原神数据格式由 [UIGF-Org](https://uigf.org/) 提供
[^UIGF-Org]: 统一标准化的原神数据格式由 [UIGF-Org](https://uigf.org/) 提供