diff --git a/docs/en/advanced/FAQ.md.md b/docs/en/advanced/FAQ.md.md new file mode 100644 index 000000000..caabacd10 --- /dev/null +++ b/docs/en/advanced/FAQ.md.md @@ -0,0 +1,113 @@ +--- +headerDepth: 2 +icon: ask +category: + - FAQ +--- + +# 常见问题 + +## 如何创建胡桃的桌面快捷方式 +::: tip 社区力量 +感谢 [CzHUV 提供的解决方案](https://github.com/DGP-Studio/Snap.Hutao.Docs/issues/12) +::: +- `Win+R` 呼出运行窗口，在窗口中输入`shell:AppsFolder` ![Run](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01Jj8c6i1g6du728e5A_!!1797064093.png) +- Windows 会弹出应用程序目录，找到胡桃工具箱 +- 右键，点击`创建快捷方式` +- 根据提示操作你就可以获得一个桌面快捷方式了 + +## 如何添加一个默认以管理员方式运行的快捷方式 +::: tip 社区力量 +感谢 [Parsifa1 提供的解决方案](https://github.com/DGP-Studio/Snap.Hutao.Docs/issues/17) +::: +基本原理：使用下方的 PowerShell 脚本可以以管理员方式运行胡桃 +```PowerShell ts:no-line-numbers +Start-Process shell:AppsFolder\60568DGPStudio.SnapHutao_ebfp3nyc27j86!App -verb runas +``` +- 保存胡桃工具箱的 Logo 资源 + - 你可以点击[这里](https://github.com/DGP-Studio/Snap.Hutao/raw/main/src/Snap.Hutao/Snap.Hutao/Assets/Logo.ico)下载 +- 在桌面点击右键，选择`新建` -> `快捷方式` +- 在`请键入对象的位置`中直接输入: +```PowerShell ts:no-line-numbers + powershell -WindowStyle Hidden -Command "Start-Process shell:AppsFolder\60568DGPStudio.SnapHutao_ebfp3nyc27j86!App -verb runas +``` +- 将快捷方式命名为你需要的名称，比如`Snap Hutao` +- 确认创建，此时你会在桌面得到一个有 PowerShell 图标的快捷方式 +- 右键该快捷方式，点击属性 + - 将`运行方式`修改为`最小化` + - 点击更改图标，选择`浏览`，并选中刚刚下载的图标 +- 这样你就获得了胡桃工具箱的桌面快捷方式，并且运行它将直接以管理员模式运行 + - 你也可以将固定到任务栏或磁贴区 + +## 如何让胡桃工具箱开机自动启动 + +- 请参考如下思路 + - 可以自行创建一个批处理文件，内容参考[此issue](https://github.com/DGP-Studio/Snap.Hutao/issues/184)中，令胡桃以管理员模式直接运行的命令。 + - 设置一个**计划任务程序**令上述批处理文件开机自启，或将上述批处理文件加入**启动项**中 +- 或有其他令胡桃工具箱可开机自启的思路，可自行探索 + +## 如何通过胡桃工具箱快速地启动游戏 + +- 在主程序中正确设置高级启动器功能 +- 将胡桃工具箱在系统中固定在快速启动栏中 +- 在快速启动栏中右键胡桃应用程序 + + ![quick-start](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01Uu8QzN1g6du6MRp8h_!!1797064093.png) +- 选择`启动游戏`即可 + +## 如何通过网络代理使用胡桃工具箱 + +参考 [HttpRequestException 错误](exceptions.html#httprequestexception) 文档 + +## 为什么在设置中点击修改游戏路径无效 + +特定系统版本的用户，由于微软对文件选择对话框的COM实现的差异，会存在点击按钮后无响应的问题。 + +相关的 [Github Issue](https://github.com/microsoft/WindowsAppSDK/issues/2931) + +## 为什么程序会出现乱码现象 + +- 当用户在 Windows 10 下使用胡桃且发现有乱码情况时： + - 可以下载 `Segoe Fluent Icons`字体 + - 安装时选择`为系统所有用户安装`，即可解决问题 +- 您可以从 [微软官方](https://aka.ms/SegoeFluentIcons)下载到该字体文件 + +## 为什么解锁帧率后使用心海时出现掉帧 +原神的BUG，和我们没关系 + +## 为什么会弹出需要使用新应用以打开的对话框 +![uninstall-error](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01b3j0eY1g6duBXLJXg_!!1797064093.jpg) + +如在卸载胡桃工具箱后出现如上图所示的`需要使用新应用以打开此 hutao 链接`，说明没有按文档要求在卸载前清除实时便笺定时任务。 请根据文档在设置中清除定时任务后再卸载胡桃工具箱。 +- 如果你在系统定时任务中找不到胡桃的定时任务，但问题仍然出现，请参考[这份文档](https://github.com/DGP-Studio/Snap.Hutao.Docs/issues/18)来解决 + +## 为什么米游社帐号登录状态经常失效，添加的帐号消失 + +* 我们通过储存帐号的米游社 Cookie 来维持登录状态。 +* 但是当用户在浏览器或其它设备上**注销帐号**后， 维持登录状态的 Cookie 将**失效**。 +* 这会导致胡桃工具箱上的米游社帐号在启动后被自动移除。 +* 此情况也可能因为网络连接问题导致无法检查Cookie有效性，故出现此情况后请优先重启胡桃工具箱。 +* 自2022年10月起，米游社极大地提高了账号被判定为有风险的概率，[账号有风险](mihoyo-risk-tip.md)时亦会令Cookie无法被识别为有效状态 +* 自 1.4.15 版本起，你可以通过在帐号面板中刷新 Cookie 来刷新登录状态 + +## 为什么游戏登录状态会失效，导致切换帐号功能无效 +- 保存游戏登录状态的要素有两个：网络环境和设备 ID +- 导致该问题的常见原因是： + - 网络环境频繁变换，如公网 IP 更换 + - 操作失误，导致实际上根本没有保存登录状态（空的登录状态无法避免被胡桃识别） + - 确认你的帐号已登录后，进入游戏 + - 关闭游戏后，确定游戏进程已关闭 + - 再次进行帐号检测，来添加登录状态 + +## 为什么程序会提示注册计划任务失败 +使用管理员模式使用一次实时便笺后，胡桃的任务计划会被以管理员权限创建。当再次以非管理员模式启动胡桃时，程序在修改计划任务时会缺少权限。 继续使用管理员模式即可解决该问题。 + +## 为什么在开启代理后胡桃工具箱会没有网络连接 + +参考 [HttpRequestException 错误](exceptions.html#httprequestexception) 文档 + +## 为什么商店版本和侧载版本不会相互覆盖升级 + +- 商店版本和侧载版本有不同的软件 ID，所以会被系统识别为不同的程序 +- 商店版的更新只会覆盖商店版应用；侧载版更新包只会更新侧载版应用 +- 在你的系统中，商店版的胡桃工具箱名称为 `Snap Hutao`，侧载版的名称为 `胡桃` diff --git a/docs/en/advanced/Gacha-system-and-export-principal.md.md b/docs/en/advanced/Gacha-system-and-export-principal.md.md new file mode 100644 index 000000000..513fec965 --- /dev/null +++ b/docs/en/advanced/Gacha-system-and-export-principal.md.md @@ -0,0 +1,63 @@ +--- +headerDepth: 0 +category: + - FAQ +icon: read +--- + +# 祈愿系统与导出原理 +> 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）并仅导入较老的数据 + +（因为始终可以从米哈游的服务器获取较新的数据，这种原始数据有更高的精确度） + +### 祈愿的导出 + +~~尚未实现，正在设计~~ 已实装 \ No newline at end of file diff --git a/docs/en/advanced/README.md.md b/docs/en/advanced/README.md.md new file mode 100644 index 000000000..3ae07bd40 --- /dev/null +++ b/docs/en/advanced/README.md.md @@ -0,0 +1,8 @@ +--- +comment: false +index: false +--- + +# 高级 + + \ No newline at end of file diff --git a/docs/en/advanced/artifact-rating-rules.md.md b/docs/en/advanced/artifact-rating-rules.md.md new file mode 100644 index 000000000..8100e8599 --- /dev/null +++ b/docs/en/advanced/artifact-rating-rules.md.md @@ -0,0 +1,13 @@ +--- +category: + - FAQ +icon: read +--- + +# 圣遗物评分机制 + +因角色设定差异，圣遗物评分机制也必须随角色所需属性而确定。 + +如果你有兴趣探索我们的评分机制， 可以审阅[胡桃工具箱代码](https://github.com/DGP-Studio/Snap.Hutao/tree/main/src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/Factory) 来了解评分计算方法。 + +如果你对当前的圣遗物评分机制有新的建议，可以[在 GitHub 上开启 Issue 为圣遗物评分提供新的依据](https://github.com/DGP-Studio/Snap.Hutao/issues/new/choose) \ No newline at end of file diff --git a/docs/en/advanced/exceptions.md.md b/docs/en/advanced/exceptions.md.md new file mode 100644 index 000000000..9164c6192 --- /dev/null +++ b/docs/en/advanced/exceptions.md.md @@ -0,0 +1,42 @@ +--- +headerDepth: 2 +icon: debug +category: + - FAQ +--- + +# 常见的程序异常 +该文档包含由**用户端错误**造成的问题 + +## RuntimeEnvironmentException +- 异常：`RuntimeEnvironmentException` + - 提示：`未开启长路径功能，无法设置注册表键值` +- 问题来源：没有解除 Windows 目录长度限制 +- 解决方案：下载 [EnableLongPaths.zip](https://d.hut.ao/d/tools/EnableLongPaths.zip) 后解压，以管理员身份运行解压后的 `.reg` 文件 + +## Return Code: -10001 +- 该异常实际上来源于米游社的返回信息，包括： + - `Return Code: -10001` + - `Return Code: -100` +- 问题来源： + 1. Cookie 过期或网络异常 + 2. 系统时间错误 +- 解决方案： + 1. 在帐号面板中，点击`刷新 Cookie` + 2. 删除帐号后重新添加米游社帐号 + 3. 在系统设置中启用自动同步时间并立刻同步时间 + +## HttpRequestException 元数据校验文件下载失败 +### 403 (Forbidden) +解决方案：更新胡桃工具箱至[最新版本](https://apps.microsoft.com/store/detail/snap-hutao/9PH4NXJ2JN52) + +### 502 (Bad Gateway) +> 相关 Issue: [https://github.com/DGP-Studio/Snap.Hutao/issues/100](https://github.com/DGP-Studio/Snap.Hutao/issues/100) + +当胡桃工具箱无法从远程服务器获取到必要资源时（通常是配置文件和图片缓存），会在用户界面抛出如下图所示的 `HttpRequestException` 错误。 + +![HttpRequestException](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01Tb2RUm1g6du5YeNuy_!!1797064093.jpg) + +当你遇到该情况，且已经确定本地网络没有互联网连接问题时，请检查是否启用了系统代理程序。如果是，请关闭。胡桃工具箱的远程服务器在全世界范围内都有类似的体验效果， 你无需为了胡桃工具箱的网络连接而使用代理网络。 + +如果系统代理是你的网络必须选项，请关闭系统代理而使用 TUN 模式代理；或者也可以通过 [Windows 8 AppContainer Loopback Utility](https://www.telerik.com/fiddler/add-ons) 解除 [Windows APP Container Loopback 的限制](https://learn.microsoft.com/zh-CN/windows/iot-core/develop-your-app/loopback) 。 \ No newline at end of file diff --git a/docs/en/advanced/get-stoken-cookie-from-the-third-party.md.md b/docs/en/advanced/get-stoken-cookie-from-the-third-party.md.md new file mode 100644 index 000000000..de1e54bda --- /dev/null +++ b/docs/en/advanced/get-stoken-cookie-from-the-third-party.md.md @@ -0,0 +1,44 @@ +--- +category: + - FAQ + - 第三方工具 +icon: read +--- + +# 使用第三方工具获取有 Stoken 的 cookie + +::: warning +- 以下步骤中涉及的软件、开源项目等资源均来源于互联网，与 DGP-Studio 无关 +- 本说明文档仅提供有关的解决思路，仅供学习使用，具体操作与操作后果与本项目无关 +::: + +## Android + +Android 用户可以使用开源项目 GetToken 来获取包含 Stoken 字段的 cookie + +::: tip GetToken 开源项目 +- GitHub：[HolographicHat/GetToken](https://github.com/HolographicHat/GetToken) +::: + +- GetToken 项目的发布会包含两个 apk 文件，两者最终效果相同。根据你的设备情况选择适合你的版本即可 + - `app-release.apk` 为一个 LSPosed 插件允许用户在官方米游社中使用 GetToken 功能 + - 名称以`lspatched`结尾的 apk 文件是一个已包含 GetToken 功能的修改版米游社程序 + - 你需要卸载官方版米游社以安装该版本的米游社 +- 启用插件或安装修改版米游社后打开米游社，在底栏点击"我的"，然后登录您的通行证 +- 在右上角点击形如🔑形状的按钮 +- 点击勾选 `Stoken` 选项 +- 点击`复制登录信息` +- 将复制到的 Stoken 发送到已经安装了胡桃工具箱的电脑 +- 在`胡桃工具箱`中的账号登录位置，点击`手动输入` +- 将之前获取到的 cookie 输入，此时即可完成登录 + +## iOS + +iOS 用户可以在 App Store 下载抓包软件 Stream 来获取包含 Stoken 字段的 cookie +- 从 App Store 下载 [Stream](https://apps.apple.com/cn/app/stream/id1312141691) +- 对域名 `api-takumi.mihoyo.com` 进行抓包分析 +- 找到并复制带有 `Stoken` 的数据 + - 形如`stuid=****;stoken=v2****;mid=****;` +- 将复制到的 Stoken 发送到已经安装了胡桃工具箱的电脑 +- 在`胡桃工具箱`中的账号登录位置，点击`手动输入` +- 将之前获取到的 cookie 输入，此时即可完成登录 diff --git a/docs/en/advanced/known-issue.md.md b/docs/en/advanced/known-issue.md.md new file mode 100644 index 000000000..ee318134c --- /dev/null +++ b/docs/en/advanced/known-issue.md.md @@ -0,0 +1,53 @@ +--- +headerDepth: 2 +icon: tool +category: + - FAQ +--- + +# 已知问题 +该文档包含由**程序错误**造成的问题 + +## #1 微软商店下载应用程序 +> 该问题来源并非胡桃工具箱，属于外部问题 该问题通常仅出现在东亚地区的网络环境下 + +- 发现于 2023/02/07 +- 无法从微软商店下载的原因在于微软在东亚的授权服务器 `licensing.mp.microsoft.com` 掉线。当你在商店上下载一个新应用时，这实际上是一个授权/购买的过程。 当授权服务出现问题时，自然不会再进入到下一步下载环节，这就导致了用户无法安装 + - 目前仅发现于微软商店新加坡授权服务器 `52.137.108.250` 出现了问题，所以你可以使用代理，切换到其它授权服务器，来实现下载。 +- 授权服务器问题 DGP-Studio已反馈给微软，等待解决。 +- 临时的解决方案： + - **方法1**： + - 使用[UsbEAm Hosts Editor](https://www.dogfight360.com/blog/475/) + - 在该工具箱内选择 `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 限制](exceptions.html#_502-bad-gateway) + + +## #2 服务器切换导致31-4302报错 +> 该问题已于 [1.4.15](/statements/update-log.html#1-4-15) 版本修复，请及时更新 +- 使用高级启动器中的服务器切换功能时，可能会出现`31-4302`相关错误 +- 目前的临时解决方案： + - 将原神截图目录中的服务器切换缓存目录删除 + +## #3 任务栏右键菜单中没有快速启动游戏的入口 +- 胡桃使用 Windows 提供的 `JumpPath` 接口来提供快速启动游戏菜单 + - 该接口需要用户在`系统设置 -> 个性化 -> 开始` 中启用`在“开始”菜单或任务栏的跳转列表中以及资源管理器的“快速使用”中显示最近打开的项` （该设置系统默认开启） +- 在下一版本，我们会使用 `JumpTask` 接口来代替 `JumpPath` 接口，用户将不再需要上述设置选项开启 + +## #4 无法使用管理员模式启动胡桃工具箱 +> 该问题来源并非胡桃工具箱，属于外部问题 该问题仅存在于 Windows 10 低于22H2的版本中 + +- 当用户系统版本低于 `Windows Build 19045`（即 Windows 10 22H2 版本）时，可能无法通过管理员模式启动胡桃工具箱 + - 该问题属于 Windows 内核级别问题，难以判断具体来源，故建议用户升级至 Windows 10 最新版本 diff --git a/docs/en/advanced/mihoyo-risk-tip.md.md b/docs/en/advanced/mihoyo-risk-tip.md.md new file mode 100644 index 000000000..fc173577a --- /dev/null +++ b/docs/en/advanced/mihoyo-risk-tip.md.md @@ -0,0 +1,36 @@ +--- +headerDepth: 0 +icon: warn +category: + - FAQ +--- + +# 账号风险及异常提示 + +![image](https://user-images.githubusercontent.com/96916320/201329765-531d6eb6-2ec4-4022-9049-bcba3b4bf9cf.png) ![image](https://user-images.githubusercontent.com/96916320/204005371-ced5213b-a7af-4cba-baa3-818f9b7ade35.png) + + +- 当胡桃工具箱返回"账号有风险，请前往米游社查看"、"请求异常，请前往米游社对应功能页面查看"、"无感验证失败，请前往「米游社我的角色实时便笺」页面查看 "等错误提示时，代表当前的操作被米游社的验证系统所阻挡 + +- 解决方式 + - 方法1 ： + - 自 1.4.15 版本起，在帐号面板内点击 `刷新 Cookie` 即可 + - 方法2： + - 使用手机打开米游社App + - 点击`我的` + - 点击`个人主页` + - 点击`我的角色`下方的角色标签 + - 点击`全部角色` + - 或可以点击`实时便笺`窗体 + - 完成**在此期间可能随机触发的验证流程**（例如验证码），即可解决本问题。 + - 若此操作未触发验证流程，可重复进行多次，直到触发验证为止 + - 若始终无法触发验证，可修改密码 + +::: tip +- 若风险提示过于频繁，或始终无法触发验证，代表您的账号风险已过高，请修改密码，使多个设备同时登录的状态被重置 +::: + +::: warning +- 若您**已绑定并使用可提供原神查询的Bot**或**同时有多个设备使用同一个米哈游通行证**，则本条目所示的情况，尤其**无感验证**将基本无法成功，这是米游社后端的**安全性**设计，不可避免，无法绕过 +- 若您本地有多个**米哈游通行证**同时频繁与**米游社**进行数据交互，则可能会被米游社在一定时间内封禁IP地址，这是米游社后端的**安全性**设计，不可避免，无法绕过 +::: diff --git a/docs/en/advanced/uninstall.md.md b/docs/en/advanced/uninstall.md.md new file mode 100644 index 000000000..ad0dac246 --- /dev/null +++ b/docs/en/advanced/uninstall.md.md @@ -0,0 +1,27 @@ +--- +category: + - FAQ +icon: delete +--- + +# 卸载胡桃工具箱 + +- 清除有关的任务计划 + - 1.4.15 版本前，若不执行该步骤，胡桃用于获取实时便笺数据的计划任务将不会被删除，会出现[这个问题](FAQ.md#为什么会弹出需要使用新应用以打开的对话框) + - **方法1** ： + - 打开胡桃，选择 **设置** 页签 + - 找到 **删除所有计划任务** 一栏中，点击右侧的 **执行** 按钮 + - **方法2**： + - 执行下方的脚本 + ``` PowerShell + schtasks /delete /tn SnapHutaoDailyNoteRefreshTask + ``` + - **方法3**： + - 打开 Windows 计划任务程序 + - 找到 `SnapHutaoDailyNoteRefreshTask` 任务并删除 +- 卸载软件 + - 打开`开始菜单` + - 找到或搜索到`胡桃` + - 右键点击`胡桃`，并选择`卸载` +- 清除数据文件夹（如需完全卸载） + - 打开并删除该文件夹 `%userprofile%/Documents/Hutao` \ No newline at end of file diff --git a/docs/en/community.md.md b/docs/en/community.md.md new file mode 100644 index 000000000..3fca175d3 --- /dev/null +++ b/docs/en/community.md.md @@ -0,0 +1,26 @@ +--- +headerDepth: 0 +category: + - Announcement +--- + +# Join Community + +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. + +@include(star-request.md) +## GitHub Discussion +[Snap.Hutao Discussion](https://github.com/DGP-Studio/Snap.Hutao/discussions) + +## QQ Group (CN) +- [Snap Group #1](https://go.hut.ao/qun1) +- [Snap Group #2](https://go.hut.ao/qun2) +- [Snap Group #3](https://go.hut.ao/qun3) +- [Snap Group #4](https://go.hut.ao/qun4) +- [Snap 开发交流群] + - 广泛的技术交流群，并非胡桃工具箱开发群 + - 开发群对申请者的技术水平有一定要求 + - 如果你有兴趣可以从[https://dev-group.hut.ao](https://dev-group.hut.ao)加入开发者交流群 + +## Discord +Invite link：[https://discord.gg/Yb8bykUKp](https://discord.gg/Yb8bykaUKp) \ No newline at end of file diff --git a/docs/en/features/README.md.md b/docs/en/features/README.md.md new file mode 100644 index 000000000..3e8ccd34b --- /dev/null +++ b/docs/en/features/README.md.md @@ -0,0 +1,9 @@ +--- +headerDepth: 0 +comment: false +index: false +--- + +# 功能指南 + + \ No newline at end of file diff --git a/docs/en/features/achievements.md.md b/docs/en/features/achievements.md.md new file mode 100644 index 000000000..cb70ced27 --- /dev/null +++ b/docs/en/features/achievements.md.md @@ -0,0 +1,28 @@ +--- +headerDepth: 0 +category: + - 功能 + - 教程 +--- + +# 成就管理 + +![](https://img.alicdn.com/imgextra/i1/1797064093/O1CN01eddfVC1g6du4Xdd9P_!!1797064093.png) + +胡桃工具箱提供成就管理功能，用户可以通过它浏览并管理所有的成就状态 + +- 在第一次使用时，你需要根据提示点击`创建新存档`按钮以创造一个成就存档并为其命名 +- 创建第一个资料页后，你可以点击右上角的`创建新存档`来继续为更多的帐号创建成就记录档案 + +## 成就导入 + +- 胡桃工具箱使用[统一可交换成就标准](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) + +- [椰羊cocogoat](https://cocogoat.work/) + diff --git a/docs/en/features/character-data.md.md b/docs/en/features/character-data.md.md new file mode 100644 index 000000000..9b41abc19 --- /dev/null +++ b/docs/en/features/character-data.md.md @@ -0,0 +1,75 @@ +--- +headerDepth: 0 +category: + - 功能 + - 教程 +--- + +# 属性统计 + +::: 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) diff --git a/docs/en/features/character-wiki.md.md b/docs/en/features/character-wiki.md.md new file mode 100644 index 000000000..4ed55be56 --- /dev/null +++ b/docs/en/features/character-wiki.md.md @@ -0,0 +1,38 @@ +--- +headerDepth: 0 +category: + - 功能 + - 教程 +--- + +# 角色资料 + +![characters-wiki](https://img.alicdn.com/imgextra/i3/1797064093/O1CN017m1hd11g6dtvZP5UA_!!1797064093.png) + +角色资料是胡桃工具箱中内置的用于查询各个角色的基础信息、天赋数值、命之座、培养材料等数据的 wiki + +## 已包含的数据 +- 角色列表 + - 使用列表左上角的按钮，可切换列表显示的方式：即"缩略图与名称"或"仅缩略图" + - 单击列表中的缩略图或名称，即可跳转到相应的介绍页面 +- 数据内容 + - 角色基本信息 + - 介绍 + - 各等级下的数值 + - 属性 +- 天赋 + - 基本介绍 + - 可切换至对应等级天赋的各项数值 +- 命之座 +- 根据"胡桃数据库"的统计信息而展示的**角色队伍搭配、武器搭配以及圣遗物搭配**的相关推荐 +- 其他信息 + - 角色立绘 + - 特色料理 + - 衣装信息 + - 角色资料 + - 角色故事 + +## 添加至养成计划 +- 在角色资料页面，你可以在选定角色后，点击右上角的`养成计算`按钮来将该角色添加至你的养成计划中 + - 该养成计划将默认从角色1级开始培养 + - 如果你需要基于当前已有的角色创建养成计划，可以使用[我的角色](character-data.md)功能 \ No newline at end of file diff --git a/docs/en/features/daily-notes.md.md b/docs/en/features/daily-notes.md.md new file mode 100644 index 000000000..397771005 --- /dev/null +++ b/docs/en/features/daily-notes.md.md @@ -0,0 +1,48 @@ +--- +headerDepth: 0 +category: + - 功能 + - 教程 +--- + +# 实时便笺 + +::: info +该功能需要你在胡桃工具箱中登录米游社帐号，登录方法可见[米游社多帐号切换](mhy-account-switch.md)文档 +::: +![live-data-tracking](https://img.alicdn.com/imgextra/i2/1797064093/O1CN01tiu6aD1g6duB3mtYQ_!!1797064093.png) + +## 添加角色 +- 点击`添加角色`按钮 +- 在弹出的`添加角色`浮窗中，选择您要添加的游戏角色，并单击其右侧的加号按钮 +- 此时您添加的游戏角色即可显示在实时便笺页面中 + - 实时便笺是间隔固定时间自动刷新的 + - 你可以点击窗口右上角的`通知设置`来设置查询的间隔时间 + - 如您需要立即刷新以获取实时的最新数值，请单击`立即刷新`按钮 + - 如出现"账号有风险，请前往米游社查看"字样的提示 + - 请参考[账号风险提示](../advanced/mihoyo-risk-tip.md)文档 + +## 全局通知设置 +- 在窗口右上角点击`通知设置`可以修改实时便笺的全局设置，包括： + - 数据刷新间隔时间 + - 通知免打扰 + - 高优先度通知 + - 这将避免胡桃工具箱的通知被自动收入操作中心 + - 请注意，开启此设置可能会让您在日常使用电脑期间受到打扰 + +## 帐号独立设置 + +- 胡桃工具箱的实时便笺功能允许用户对每一个被监控的帐号给予不同的设置 +- 将鼠标停留在**需要被设置的**角色实时便笺的窗体上 +- 点击其窗体右上角出现的设置图案按钮，即可修改如下参数 + - 原粹树脂提醒阈值 + - 洞天宝钱提醒阈值 + - 启用参量质变仪提醒 + - 启用每日委托上限提醒 + - 启用探索派遣完成提醒 + - 启用在主页显示卡片 (未上线的新功能) +- 点击`保存`，即可保存您当前所设置的通知选项 + +## 删除角色 +- 将鼠标停留在需要被设置的角色实时便笺的窗体上 +- 点击其窗体右上角出现的移除标志按钮，即可移除该角色对应的实时便笺 diff --git a/docs/en/features/develop-plan.md.md b/docs/en/features/develop-plan.md.md new file mode 100644 index 000000000..9d0e578ad --- /dev/null +++ b/docs/en/features/develop-plan.md.md @@ -0,0 +1,47 @@ +--- +headerDepth: 0 +category: + - 功能 + - 教程 +--- + +# 养成计划 + +![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)直接向我们反馈，感谢您的贡献！ + + diff --git a/docs/en/features/game-launcher.md.md b/docs/en/features/game-launcher.md.md new file mode 100644 index 000000000..afc698cc3 --- /dev/null +++ b/docs/en/features/game-launcher.md.md @@ -0,0 +1,94 @@ +--- +headerDepth: 0 +category: + - 功能 + - 教程 +--- + +# 高级启动器 + +- 胡桃工具箱提供的高级启动器功能中通过多样的设置选项来允许用户以自定义设置启动游戏 +- 你可以通过点击左侧菜单栏中的`启动游戏`进入高级启动器功能 + - 第一次使用时你会被跳转到设置页面以设置你的游戏路径 + - 选择游戏路径时，请注意此处选择的应是游戏本身 + - 形如：`$\Genshin Impact\Genshin Impact Game\YuanShen.exe` + - 而官方启动器的目录一般是`$\Genshin Impact\launcher.exe` +- 在设置完毕启动游戏所需的附加选项后，点击右下角的`启动游戏`按钮即可 + - 附加选项请看本页下方的功能文档 + +## 视频指南 +对于大多数人而言，遵循本页文档会有更高的效率。 + +但如果你对其中包含的操作不熟悉，也可以回到这里来跟着视频指南操作。 ::: details 胡桃工具箱指南 4 - 高级启动器（切换帐号/切换服务器/帧率解锁） + +::: + +## 切换服务器 +::: tip 权限提示 +1. 使用该功能时需要以管理员权限启动胡桃工具 +2. 胡桃工具箱会在游戏截图目录下创建一个名为 `HutaoCache` 的文件夹并储存转换服务器所需要的文件 +::: + +- 在主界面点击左侧菜单栏进入`启动游戏`页面 +- 点击右侧选项中的服务器名称，选择要进入的服务器 + - 目前可选的服务器为`官方服|天空岛`、`渠道服|世界树`和`国际服` +- 点击右下角的`启动游戏`按钮，胡桃会自动下载并应用对应服务器的文件并启动游戏 + + +## 账号保存 +::: tip +1. 本功能所描述的帐号，特指当前原神所登录游戏账号的登录状态 +2. 获取当前原神的登录状态通常需要管理员权限，建议`使用管理员模式启动胡桃` +3. **目前仅支持切换官方服（不含渠道服）帐号** +::: + +| | 官方服 | 渠道服 | 国际服 | +| ------ | --- | --- | ------------------------------------------------------------------------------- | +| 保存登录状态 | 支持 | 支持 | 支持 | +| 切换账号 | 支持 | 不支持 | 理论支持
[我们期待更多的社区开发者帮助](https://github.com/DGP-Studio/Snap.Hutao/pulls) | + +1. 在主界面点击左侧菜单栏进入`启动游戏`标签 +2. 点击`账号`功能中的`检测`按钮，胡桃工具箱会保存当前原神游戏的登录状态 +3. 在弹出的`为账号命名`界面中，输入您要为此账号设置的名称，点击确认 +4. 在游戏中，注销当前登录并登录你另一个帐号。重复执行上述的第2步和第三步直至你将全部的帐号添加进胡桃工具箱中。 +5. 此时即可在`账号`功能下方自由选择您要切换的账号 + - 每个已保存的账号均为可点击选择的按钮 + - 在其右侧有三个按钮，分别为： + - `绑定当前用户角色`，即将您当前选择的米游社登录状态绑定至该账号中，点击该按钮后，对应的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` 选项中，可自由拖动拉杆，调整到您需要设置的最高帧率上限 + +- 会导致**解锁帧率上限失败**的因素： + - 解锁帧率上限，需要保持**胡桃工具箱**在开启状态 + - 游戏内未关闭**垂直同步**选项 + - 在显卡驱动中存在`最大帧速率`的设置 + - 在显卡驱动软件内存在未关闭的类似于`节能模式`的选项 + diff --git a/docs/en/features/hutao-API.md.md b/docs/en/features/hutao-API.md.md new file mode 100644 index 000000000..183efb348 --- /dev/null +++ b/docs/en/features/hutao-API.md.md @@ -0,0 +1,48 @@ +--- +headerDepth: 0 +category: + - 功能 + - 教程 +--- + +# 胡桃数据库/深渊统计 + +胡桃工具箱提供两个主要的深境螺旋挑战统计的功能 +- 侧栏中的`深渊统计`是一个旨在通过统计并展示广大玩家深境螺旋挑战数据，来帮助对原神对战系统不熟悉玩家组建队伍、通关深渊、获取奖励的功能 +- 侧栏中的`深渊记录`是一个通过保存玩家每一期深境螺旋挑战数据来帮助个人玩家回顾游戏经历及个人数据收集的统计功能 + - 众多的玩家通过上传个人的`深渊记录`来形成胡桃数据库的`深渊统计`数据集 + +::: 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]: 只要拥有该角色，即使没有在深境螺旋中登场，也会被计入拥有的状态； 只要上传过深境螺旋记录，即会被计入全部玩家的数据中。 diff --git a/docs/en/features/hutao-settings.md.md b/docs/en/features/hutao-settings.md.md new file mode 100644 index 000000000..1580a5726 --- /dev/null +++ b/docs/en/features/hutao-settings.md.md @@ -0,0 +1,94 @@ +--- +headerDepth: 0 +category: + - 功能 + - 教程 +--- + +# 软件设置 + +::: 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" + +- 删除游戏内网页缓存 + - 若您在使用**祈愿记录功能**时，选择**使用"从缓存刷新"**，但**频繁提示**验证密钥过期，可以尝试此操作 + - 点击此选项内的`删除`按钮即可 + +## 测试功能 + +- 打开`数据`文件夹 + - 在此选项中点击"打开"按钮，即可打开包含"用户数据/日志/元数据"的文件夹 + +- 打开`缓存`文件夹 + - 在此选项中点击"打开"按钮，即可打开包含"图片缓存"的文件夹 + - 在此文件夹内，存储了`胡桃工具箱`在运行期间产生的`图片缓存` + +### 米游社每日签到 + +::: tip +米游社签到功能主要用于米游社帐号登录状态监测 +::: + +- 如何使用 + - 首先需要您在`米游社多账号切换`功能中，选中当前需要进行签到的米游社账号 + - 点击"打开签到对话框"按钮 + - 胡桃工具箱会打开签到页面，随后你即可手动签到 +- 该功能的正常使用界面： + ![米游社每日签到](https://img.alicdn.com/imgextra/i4/1797064093/O1CN01WCLbxe1g6duCXB6tc_!!1797064093.png) + +## 危险功能 +- 删除所有计划任务 + - 当你需要卸载胡桃工具箱时，可以使用此功能以删除胡桃工具箱的定时数据拉取任务 +- 删除所有用户 + - 此功能的作用是删除用户表的所有记录 + - 点击`执行`按钮即可完成删除 + - 通常情况下，用户不需要使用此功能来删除用户表的信息 + diff --git a/docs/en/features/mhy-account-switch.md.md b/docs/en/features/mhy-account-switch.md.md new file mode 100644 index 000000000..098324263 --- /dev/null +++ b/docs/en/features/mhy-account-switch.md.md @@ -0,0 +1,41 @@ +--- +headerDepth: 0 +category: + - 功能 + - 教程 +--- + +# 米游社多帐号切换 + +::: tip +- 本文档所描述的帐号切换指的是用于获取游戏数据的**米游社帐号**，不是原神**游戏内的帐号** +- 在使用本功能前，你需要使用官方的米游社 App 登录你的帐号以初始化你的米游社功能 + - 如果在胡桃中登录的帐号名称格式为 `user_123456789` 则其有可能没有被初始化 +::: + +![多帐号管理样图](https://img.alicdn.com/imgextra/i4/1797064093/O1CN01tRs9NH1g6du1XgyDZ_!!1797064093.png) + +::: details 胡桃工具箱视频指南 - 米游社帐号登录 +对于大多数人而言，遵循本页文档会有更高的效率。 + +但如果你对其中包含的操作不熟悉，也可以回到这里来跟着视频指南操作。 + + +::: + +- 你可以在程序主界面的左下角，设置按钮的上方找到帐号菜单，以管理你在胡桃工具箱中登录的米游社帐号。在弹出的面板中你可以： + - 点击`登录米哈游通行证`按钮 + - 在弹出的内置浏览器中登录"米哈游通行证"账号 + - 您也可以通过点击`手动输入`按钮，直接输入米游社通行证 cookie 来添加您的帐号 + - 若您选择`手动输入`米游社 cookie，则该 cookie **必须包含 `Stoken` 字段** + - 手动获取含 `Stoken` 字段的 cookie 的方式可参考[使用第三方工具获取有 Stoken 的 cookie](/advanced/get-stoken-cookie-from-the-third-party.md) 文档 + - 在弹出的内置浏览器登陆成功后，点击右上角的"我已登陆"按钮 + - 完成后，您就可以在帐号管理面板切换已登录的米游社帐号了 + - 新添加米游社账号后，需在主界面左下角切换账号的功能中，手动点击一次新登录的账号，以将其设置为使用状态 + - 你可以在帐号管理菜单中复制对应帐号的 cookie 或从胡桃工具箱中删除该帐号 + +::: info 安全提示 +- `Stoken` 是一个安全敏感的 cookie 字段，你**不应该**在任何云端或其它无法保证数据安全的设备上储存含有 `Stoken` 字段的 cookie。 +- 从胡桃工具箱中复制获得的 cookie 中包含该字段，请慎重考虑是否为接受 cookie 的一方提供 `Stoken` 字段。 +- **在胡桃工具箱中通过密码或 cookie 登录米游社的过程中，你的数据只经米游社服务器和本地胡桃工具箱处理，不经过包括胡桃服务器在内的任何第三方服务。** +::: diff --git a/docs/en/features/weapon-wiki.md.md b/docs/en/features/weapon-wiki.md.md new file mode 100644 index 000000000..14a325b18 --- /dev/null +++ b/docs/en/features/weapon-wiki.md.md @@ -0,0 +1,28 @@ +--- +headerDepth: 0 +category: + - 功能 + - 教程 +--- + +# 武器资料 + +![weapon-wiki](https://img.alicdn.com/imgextra/i1/1797064093/O1CN01jbzlTH1g6du6KfSmF_!!1797064093.png) + +武器资料是胡桃工具箱中内置的用于查询各个武器的**外观、参数、精炼效果、推荐搭配**等数据的 Wiki + + +## 已包含的数据 + +- 武器列表 + - 使用列表左上角的按钮，可切换列表显示的方式：即"缩略图与名称"或"仅缩略图" + - 单击列表中的缩略图或名称，即可跳转到相应的介绍页面 +- 数据内容 + - 武器基本信息 + - 突破前后的武器图标对比 + - 对应武器的立绘展示 + - 武器的简介内容 + - **可切换**至对应等级的武器各项数值 + - 武器精炼信息 + - 对应精炼阶数的精炼属性 + - 根据胡桃数据库的统计信息而展示的**武器使用**的相关推荐 diff --git a/docs/en/features/wish-export.md.md b/docs/en/features/wish-export.md.md new file mode 100644 index 000000000..a71a05692 --- /dev/null +++ b/docs/en/features/wish-export.md.md @@ -0,0 +1,94 @@ +--- +headerDepth: 0 +category: + - 功能 + - 教程 +--- + +# 祈愿记录 + +抽卡是原神的核心玩法之一，无论是出于纪念、炫耀的目的还是认真规划抽取计划，对历史抽卡进行统计分析都是非常重要的。 但是原神官方只为玩家提供了半年的抽卡记录，这是很不友好的（~~但是他们还是统计了你一整年杀了多少提米的鸽子~~）。 + +因此，我们需要利用这半年的抽卡记录调取窗口，将抽卡记录转移到我们自己手中，这就是胡桃工具箱中祈愿记录导出功能的目的所在。 + +有关原神祈愿记录导出的技术原理，你可以参阅我们的[**祈愿系统与导出原理**](/advanced/Gacha-system-and-export-principal.md)一文。 + +![祈愿导出](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01B2DDii1g6du87XIIG_!!1797064093.png) + +::: note 原神抽卡记录的延迟性 +胡桃工具箱获取抽卡记录的来源也为米哈游服务器，因此短时间内刚刚结束的抽卡无法被获取。 当你在游戏内抽卡历史记录中看到了最新的一批抽卡记录，则可以在胡桃中获取统计数据。 + +::: + +## 视频指南 +对于大多数人而言，遵循本页文档会有更高的效率。 + +但如果你对其中包含的操作不熟悉，也可以回到这里来跟着视频指南操作。 ::: details 胡桃工具箱指南 5 - 祈愿记录导出篇 + +::: + +## 获取祈愿数据 +### 利用 Stoken 从服务器获取最新的祈愿记录 + +::: info 提示 +- 已登录的米游社帐号是使用 Stoken 刷新方法的前提，你可以参考[米游社多帐号切换](mhy-account-switch.md)一文在胡桃工具箱中登录你的帐号 +- Stoken 刷新方法暂不支持国际服 +::: + +- 在胡桃工具箱中确保你需要获取记录的米游社帐号已登录 +- 从左侧菜单栏进入`祈愿记录` +- 点击右上角的`刷新`，并点击`Stoken刷新` +- 等待读取完毕，即可查看最新的祈愿记录 + +### 从网页缓存获取最新的祈愿记录 + +- 从左侧菜单栏进入`祈愿记录` +- 启动游戏并登入游戏，打开游戏内的祈愿历史记录 +- 回到胡桃工具箱，点击`刷新`按钮，在刷新菜单中点击`网页缓存刷新` + +::: tip +若出现`网页缓存刷新`功能异常的情况： +- 从胡桃工具箱的`设置` +- 在`删除游戏内网页缓存`功能中执行删除操作 +::: + +### 通过输入 Url 获取祈愿记录 +- 如果你通过其它工具获取到了你祈愿历史记录的 Url，可以选择`手动输入Url`并根据提示操作 +- 但应注意此类 Url **具有时效性** + +### 对于全量刷新选项的补充说明 + +在默认情况下，胡桃工具箱会在匹配到本地已有记录的祈愿ID后停止导入。 但如果你希望完整地获取原神服务器中所有的历史记录（即使它已经存在于你的本地祈愿记录中），你可以勾选`全量刷新`。 + +**不勾选`全量刷新`不会使你丢失祈愿数据，勾选`全量刷新`也不会让你的本地记录错误地额外记录一次相同的祈愿数据。** + +### 从其它祈愿导出程序导入祈愿数据 +胡桃工具箱支持导入 `UIGF 数据格式` 的祈愿记录数据[^UIGF-Org] + +如果你希望导入这一类数据，可以： +- 启动胡桃工具箱，从左侧菜单栏进入`祈愿记录` +- 点击右上角的`导入` +- 选择你的 UIGF Json 数据文件 +- 根据界面确认导入数据 + +### 从 Snap Genshin 转移祈愿记录数据 +如果你希望从 Snap Genshin 中转移祈愿数据至胡桃工具箱，你可以： +- 升级 Snap Genshin 到最新版本 +- 进入`祈愿记录`功能 + - 如果你由于无法登录米游社而无法进入 Snap Genshin，可以在胡桃工具箱中登录米游社帐号并复制 Cookie 到 Snap Genshin +- 点击右上角的功能菜单 +- 通过`导出 UIGF Json 文件`导出 Json 格式的祈愿记录 +- 在胡桃工具箱中导入该文件 + +## 导出祈愿数据 + +胡桃工具箱支持导出 `UIGF数据格式` 的 Json 文件格式的祈愿记录数据 + +如果你希望导出祈愿数据，可以： +- 启动胡桃工具箱，从左侧菜单栏进入`祈愿记录` +- 选择您要导出的祈愿记录存档 +- 点击`导出`按钮 + - 在弹出的界面选择您需要将此导出的祈愿记录数据文件存放的位置，并点击`导出` +- 导出完成 + +[^UIGF-Org]: 统一标准化的原神数据格式由 [UIGF-Org](https://uigf.org/) 提供 \ No newline at end of file diff --git a/docs/en/i18n.md.md b/docs/en/i18n.md.md new file mode 100644 index 000000000..3562d14ba --- /dev/null +++ b/docs/en/i18n.md.md @@ -0,0 +1,43 @@ +# 国际化支持 +## 国际化进度 +Snap Hutao 虽然基于原神国服提供功能，但项目也有意提升国际化支持，包括语言本土化和功能国际化。目前国际化进度如下： + +- Snap Hutao 主项目 + - [x] 语言本土化技术框架 + - [ ] 客户端翻译 + - 进度：![Crowdin](https://badges.crowdin.net/snap-hutao/localized.svg) + - [x] 英语 + - [x] 繁体中文 + - [x] 韩语 + - [ ] 日语 + - [ ] 俄语 + - [x] 国际服/国服客户端转换 + - [ ] 国际服游戏帐号切换 + - [x] 国际服祈愿记录导出 + - [x] 国际服角色属性统计 + - [ ] HoYoLAB 登录支持 + - [ ] 国际服深渊记录获取 + - [ ] 实时便笺 + - [ ] 多语言游戏公告 +- Snap Hutao 文档 + - [x] 语言本土化技术框架 + - [ ] 网页翻译 + - 进度：![Crowdin](https://badges.crowdin.net/snap-hutao-docs/localized.svg) + - [ ] 英语 + - [x] 主页 + - [ ] 用户文档 + - [ ] 韩语 + - [ ] 主页 + - [ ] 用户文档 + +## 参与国际化 + +- Snap Hutao 主项目 + - 我们在 GitHub 上创建了一个名为 `[Hoyolab]: Globalization support` 的 [Issue](https://github.com/DGP-Studio/Snap.Hutao/issues/144) + - 我们会在该 Issue 中更新当前主程序国际化进度 + - 你可以在这里宣布参与主程序某一部分的国际化支持，我们会为此提供支持 + - 我们也欢迎直接通过分支发起 Pull Request + - **你可以在 [translate.hut.ao](https://translate.hut.ao) 参与客户端的翻译工作** +- Snap Hutao 文档 + - **你可以在 [translate-docs.hut.ao](https://translate-docs.hut.ao) 参与文档的翻译工作** + \ No newline at end of file diff --git a/docs/en/markmap.md.md b/docs/en/markmap.md.md new file mode 100644 index 000000000..8114ae10a --- /dev/null +++ b/docs/en/markmap.md.md @@ -0,0 +1,23 @@ +# 胡桃工具箱 + +## 米游社功能 + +- 活动公告 +- 帐号登录 +- 实时便笺 +- 深境螺旋 + - 我的深渊记录 + - 胡桃数据库 - 深渊数据 + +## 游戏性增强 + +- 高级启动器 +- 祈愿记录 +- 成就管理 + +## 养成计划 + +- 养成计算器 + - 属性统计 + - 角色 Wiki + - 武器 Wiki diff --git a/docs/en/project.md.md b/docs/en/project.md.md new file mode 100644 index 000000000..53b980b84 --- /dev/null +++ b/docs/en/project.md.md @@ -0,0 +1,42 @@ +--- +headerDepth: 0 +category: + - 公告 +--- + +# 项目说明 + +胡桃工具箱是一个 Windows 平台的开源的原神工具箱，旨在帮助玩家获得更好的游戏体验； 它是对官方移动端工具的一种非破坏性功能扩展，为不习惯在移动端进行原神游戏的 PC 玩家提供一个在 Windows 平台下获得接近移动端功能权利的途径。 + +## 功能迁移 +胡桃正在迁移原 Snap Genshin 客户端中的功能 + +已经完成迁移的功能将会在本站文档中提供指导说明，功能迁移和开发进度可以参阅下方 + +- [x] 米游社公告首页 +- [x] 米游社帐号管理 +- [x] 游戏启动器 +- [x] 祈愿记录 +- [ ] WIKI - 日常材料 + - 将整合进养成计划 +- [ ] WIKI - 周常材料 + - 将整合进养成计划 +- [x] WIKI - 角色资料 +- [x] WIKI - 武器资料 +- [x] 成就统计 +- [x] 胡桃数据库 +- [x] 养成计算器 +- [x] 角色橱窗 +- [ ] 玩家查询 +- [ ] 自定义网页 + +## 新增功能 + +以下新功能计划被增加到胡桃工具箱中 +- [ ] 祈愿云端同步 +- [ ] 国际化支持 + - 等待微软修复上游问题 +- [ ] 国际服支持 + - [x] 游戏启动器 + - [x] 服务器切换 + - [x] 祈愿记录 \ No newline at end of file diff --git a/docs/en/quick-start.md.md b/docs/en/quick-start.md.md new file mode 100644 index 000000000..f3d72cb16 --- /dev/null +++ b/docs/en/quick-start.md.md @@ -0,0 +1,48 @@ +--- +pageClass: link-box +externalLinkIcon: false +category: + - Feature + - Tutorial +--- + +# Quick Start + +::: tip +If you download and use **Snap Hutao**，you are agree to our[ terms of service](/statements/tos.md) +::: +@include(star-request.md) + +## 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 + +::: + +## Minimum System Requirements +| Requirement | Attribute | +| ----------------------- | -------------------------------------- | +| **Minimum Required OS** | Windows 10 Build 19045 (22H2) [^first] | +| **Recommended OS** | Windows 11 Build 22621 (22H2) | +| Optional Components | WebView2 Runtime | + + +## Installation + + + + +Microsoft Store Link：[Snap Hutao](https://apps.microsoft.com/store/detail/snap-hutao/9PH4NXJ2JN52) + +On Windows 10 and Windows 11, you can click directly on the button above to download the Snap Hutao + +## 安装 WebView2 运行时 + +WebView2 运行时由微软提供，其允许胡桃在程序内低开销地启用一个内置的浏览器。作为可选组件，WebView2 运行时不是强制组件，但安装后你会更容易地使用部分功能。 + +在[微软官网](https://developer.microsoft.com/zh-cn/microsoft-edge/webview2/)的底部，你可以找到`常青独立安装程序`，选择`x64`下载并根据提示安装即可 + +[^first]: The LTSC and LTSB systems are not in the support list because they do not contain Microsoft Store.Windows 10 Build 19041 亦可以安装，但部分功能会因内核问题无法使用，故该版本下的胡桃工具箱问题将不会被处理 \ No newline at end of file diff --git a/docs/en/side-load.md.md b/docs/en/side-load.md.md new file mode 100644 index 000000000..f3ed391f0 --- /dev/null +++ b/docs/en/side-load.md.md @@ -0,0 +1,19 @@ +## 侧载安装 +### 通用安装方式 +- 在系统设置中打开`开发者设置`界面，勾选 `开发人员模式` 和 `允许 PowerShell 脚本` （自行百度） +- 解压已下载的压缩包，找到`Install.ps1`文件，右键选择`使用PowerShell运行`，按照提示允许PowerShell执行操作即可 +- 安装完毕，`胡桃`将出现在您的`开始菜单`中 + +### 小白级安装方式 +- 解压已下载的安装包 +- 运行 `Snap.Hutao.Installer.exe` + - 该程序将执行上述通用安装方式的命令 +- 安装完毕，`胡桃`将出现在您的`开始菜单`中 + +## 升级胡桃工具箱 + +- 解压你下载的最新版本压缩包 +- 重复 `安装胡桃工具箱` 的步骤 +- 若您安装失败或出现异常情况，可参考如下步骤 + - 先卸载已经安装的`胡桃工具箱` + - 重复 `安装胡桃工具箱` 的步骤 \ No newline at end of file diff --git a/docs/en/star-request.md.md b/docs/en/star-request.md.md new file mode 100644 index 000000000..6bf6663a3 --- /dev/null +++ b/docs/en/star-request.md.md @@ -0,0 +1,8 @@ +**If you believe Snap Hutao is a good project and helps you, you can support us by the following ways** +- Star our project on GitHub ⭐ + - [Snap.Hutao](https://github.com/DGP-Studio/Snap.Hutao) ![hutao.stars](https://img.shields.io/github/stars/DGP-Studio/Snap.Hutao?style=plastic&color=red) + - [Snap.Hutao.Docs](https://github.com/DGP-Studio/Snap.Hutao.Docs) ![hutao.docs.stars](https://img.shields.io/github/stars/DGP-Studio/Snap.Hutao.Docs?style=plastic&color=red) +- Rate our App on [Microsoft Store](ms-windows-store://review/?ProductId=9PH4NXJ2JN52) +- Promote our project in communities + +![commit_activity](https://img.shields.io/github/commit-activity/y/DGP-Studio/Snap.Hutao?style=for-the-badge) ![hutao-last-commit](https://img.shields.io/github/last-commit/DGP-Studio/Snap.Hutao?label=Hutao%20Last%20Commit&style=for-the-badge) \ No newline at end of file diff --git a/docs/en/statements/README.md.md b/docs/en/statements/README.md.md new file mode 100644 index 000000000..9b155ee8c --- /dev/null +++ b/docs/en/statements/README.md.md @@ -0,0 +1,9 @@ +--- +headerDepth: 0 +comment: false +index: false +--- + +# 声明和公告 + + \ No newline at end of file diff --git a/docs/en/statements/bug-report.md.md b/docs/en/statements/bug-report.md.md new file mode 100644 index 000000000..7525c176e --- /dev/null +++ b/docs/en/statements/bug-report.md.md @@ -0,0 +1,31 @@ +--- +headerDepth: 0 +category: + - 公告 +icon: debug +--- + +# 提交BUG报告 + +![opened-issue](https://img.shields.io/github/issues/DGP-Studio/Snap.Hutao?style=for-the-badge) ![closed-issue](https://img.shields.io/github/issues-closed/DGP-Studio/Snap.Hutao?style=for-the-badge&color=blue) + +## 推荐方法 + +- 在你使用 Snap Hutao 时如果发现了可复现或不可自行修复的问题，可以通过提交问题反馈来告知开发者。 +- 在提交问题时，您应当尽可能地详细描述问题。如果有错误的截图，也应该提供。这有利于问题排查并加速问题修复。 + - 一个可以参考的非常正面的例子是 [DGP-Studio/Snap.Hutao/issues/100](https://github.com/DGP-Studio/Snap.Hutao/issues/100) +- 如果你有能力在代码层面修复该问题，也欢迎您直接在对应的项目中发起 PR。 ![suggestion](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01jXBMbe1g6du15k9kx_!!1797064093.jpg) **如果你是诚心希望解决问题，则应该在 Issue 中包含尽可能多的信息，比如说：你做了什么；看到了什么结果；程序有什么提示； 你查阅了哪篇文档；尝试了什么解决方案，结果是什么；你的设备ID是什么…… 当你愿意付出更多的时间在提供信息上，更大的可能获得一个准确的解决方案。 一两句话就结束的问题报告大多数不是有效的问题，只会被无视。** + +### 客户端问题 + - 在提交问题前，请务必检查文档内是否已包含了你的问题 + - 首先需要确认您使用的版本是否为最新版本 + - 您可以通过菜单栏中的“常见问题”分类找到这些文档 + - [快速解答](/advanced/FAQ.md) + + - 通过 GitHub 提交问题 + - [github.com/DGP-Studio/Snap.Hutao/issues/new/choose](https://github.com/DGP-Studio/Snap.Hutao/issues/new/choose) + - 通过 兔小巢 提交问题 + - [support.qq.com/products/451231](https://support.qq.com/products/451231) + +### 请求增加或更新文档 + - 通过 GitHub 提交问题：[DGP-Studio/Snap.Hutao.Docs](https://github.com/DGP-Studio/Snap.Hutao.Docs/issues/new/choose) \ No newline at end of file diff --git a/docs/en/statements/privacy-notice.md.md b/docs/en/statements/privacy-notice.md.md new file mode 100644 index 000000000..0eb64f51d --- /dev/null +++ b/docs/en/statements/privacy-notice.md.md @@ -0,0 +1,32 @@ +--- +headerDepth: 0 +category: + - 公告 +icon: license +--- + +# 用户数据和隐私权益 +胡桃工具箱充分尊重用户的隐私，目前我们会按下方的说明使用用户的数据： + +- 使用胡桃后，在 **数据目录** 中以数据库文件的形式 + - **储存** + - 米游社 Cookie + - 胡桃的软件设置信息 + - 全部的用户数据 + +- 使用胡桃主程序时，胡桃会因开发和统计为目的**匿名化地**收集程序意外停止或出错时抛出的日志，包括： + - 用户设备 ID + - 错误与崩溃日志 + - 用户活跃数据统计信息 + +- 使用 `胡桃数据库` (`深渊记录`/`深渊统计`) 功能并选择`上传数据`时， + - 向 胡桃 API **上传** + - 用户的游戏 UID + - 用户的深境螺旋记录 + - 用户的角色信息及其装备的武器和圣遗物信息 + +- 使用`实时便笺`功能后 + - 在 Windows 定时任务中**创建**一个用于获取数据的定时任务 + +- 使用`高级启动器`中的`服务器切换`功能后，在原神截图目录中 + - **储存**服务器转换所需要的文件 \ No newline at end of file diff --git a/docs/en/statements/tos.md.md b/docs/en/statements/tos.md.md new file mode 100644 index 000000000..273f43450 --- /dev/null +++ b/docs/en/statements/tos.md.md @@ -0,0 +1,79 @@ +--- +headerDepth: 0 +category: + - 公告 +comment: false +editLink: false +icon: license +--- + +# 用户使用协议和法律声明 + +## 总则 + - 本"用户使用协议和法律声明"（以下简称"条款"或"使用协议"）适用于[DGP-Studio开发团队](https://github.com/DGP-Studio)（以下简称"本团队"或"我方"）开发的全部软件作品、各开发项目的官方网站、附属的自媒体账号等。 + - 请您仔细阅读本用户使用协议的**全部内容**，在您阅读"使用协议"后，若对此用户使用协议中的**任何条款**有异议，请立刻停止使用本团队所开发的任意项目。 + - 如您未满18周岁，请在法定监护人陪同下仔细阅读并充分理解本协议，并征得法定监护人的同意后使用本团队所开发的任意项目。 + - 若您已安装、使用或在开发时引用本团队所开发的任意项目，表示您已主动阅读(已阅读完毕)并完全同意本使用协议所列明的条款，即已充分理解本协议并承诺作为本协议的一方当事人接受协议、法律声明、隐私政策以及与本团队所开发的任意项目相关的规则、规范、声明、公告、通知等内容的约束。 + - 此《用户使用协议》是由用户(以下或称"您")与本团队所开发的任意项目所订立的用户使用协议和法律声明，本协议对用户和本团队均具有法律效力。 + +## 项目性质、服务以及有关责任与义务的界定 + + - 一、由于本团队所开发的任意项目，均"开源"、"非经营性质"，故本团队可随时执行全权决定：包括但不限于更改"使用协议"，修改本团队所开发的任意项目内的任何内容。如"条款"及"作品的内容"有任何变更，我方将在相关的项目展示网站上刊载公告作为通知。经修订的"条款"一经在官方网站上公布后，即自动生效。 + + + - 二、本软件以"学习开发知识"、"积累开发经验"为目的进行开发，所有项目所提供的功能，均"开源"、"非经营性质"，如用户对本团队所开发的任意项目的安全性表示不满，请立即卸载/删除/停用，如您仍在正常使用，则表示您认可本团队所开发的任意项目的安全性。 + + + - 三、一切因使用本团队所开发的任意项目的内容而导致的"任何意外损失(包括但不限于：软件、硬件、财产以及虚拟物品等)"、"合约毁坏"、"诽谤"、"版权或知识产权侵犯"及其所造成的损失与责任，均为使用者自身对于网络公开的开源软件的使用过程中自身发生的使用行为所引致的"损失与责任",基于全部作品在其开放源代码的位置(即[Github](https://github.com/DGP-Studio))中所声明的[MIT license](https://github.com/DGP-Studio/Snap.Hutao/blob/main/LICENSE)以及本声明所约定的内容，应当认定前述的"损失与责任"与全部项目的有关开发者无责任关联。 + + + - 四、用户使用本团队所开发的任意项目期间，本团队**不做**任何不发生如下情况的保证： + - 因网络状况、通讯线路等任何技术原因而导致用户不能正常使用或更新； + - 因使用"第三方开发的本软件内插件"、"第三方进行二次编译的本软件的修改版"、"复用本开发团队所创作的项目代码而编译成的软件"造成负面结果。 + + + - 五、用户认可本团队所开发的任意项目，除被动接收软件或其他相关项目中的必要的上传报告或有关信息外，所有信息的上传均需要用户的主动触发； + - 用户认可本团队所开发的任意项目，均完全尊重并保护所有用户的"个人隐私权"，项目代码亦完全公开，用户不具有"因隐私权收到侵犯"而对开发团队或团队成员发起控诉的主观理由。 + - 本团队所开发的任意项目不会向第三方共享、转让您的个人信息，除非经过您本人事先授权同意，或者共享、转让的个人信息是去标识化处理后的信息，且共享第三方无法重新识别此类信息的自然人主体。 + - 本团队所开发的任意项目包含到其他站点的链接，当您访问第三方链接时，请认真阅读第三方站点的用户协议和声明，本团队对于第三方站点的内容、隐私条款、使用协议等不负任何责任。 + - 在使用本团队所开发的任意项目时，提交任意资料的过程中，本团队不保证提交的信息保存成功，您需要对您提交的资料做好存储保管。本团队所开发的部分项目为"被授权数据"提供存储，但在存储过程中存在各种不可抗力的因素，本团队无法承诺对用户的存储信息无限期保留，您的重要信息请自行备份。 + +## 权利和义务 + + - 六、我方允许任何单位或个人在没有本开发团队授权的情况下,对本团队所开发的任意项目进行的二次开发、功能修改以及复用我方创作的代码进行其他项目的开发，但对其所侵犯我方计算机软件著作权的行为，我方保留追责的权利。 + - 我开发团队不对任何单位或个人在使用本团队所开发的任意项目的内容进行的公开发布行为（包括但不限于制作视频、发布带有本软件内容的文章、上传至非我开发团队指定的下载网站提供下载等）的内容所致的任意结果进行负责。 + - 我开发团队不对使用"第三方开发的可用于本团队所开发的任意项目的附属程序或额外代码"、"第三方进行二次编译的本团队所开发的任意项目的修改版"、"复用本开发团队所创作的项目代码而编译成的软件"造成的任意结果负责。 + - 在此基础上，根据《计算机软件保护条例》第二条与第三条对于"计算机软件"和"文档"的法律定义，本软件开发团队（DGP Studio）保留全部我方开发项目的计算机软件著作权，其包括但不限于项目构建所需的全部信息、全部项目有关的所有文档资料（即用来描述程序的内容、组成、设计、功能规格、开发情况的程序设计说明书、流程图、用户手册等），具体内容以各项目《计算机软件著作权登记证书》的实际内容为准。 + + + - 七、本团队所开发的任意项目仅作用于合法、合规范围内的学习及研究所用，不得利用本软件系统从事违法活动。 + - 本团队仅作为项目的开发团队（非法人性质，为自然人组成的团体），对任何使用结果不负任何连带责任，软件以及我方开发的任意项目的使用过程中产生的任何法律后果我们概不负责、不承担任何法律责任。 + - 若用户已开始使用本团队所开发的任意项目，即已同意"使用协议"，表明本团队已履行完毕"本使用协议第十款"的告知情形。 + + + - 八、所开发项目的著作权。 + - 本软件开发团队对所开发的"Snap.Genshin软件"、"Snap.Hutao软件"等作品的软件本身（不包括软件内除功能模块外的显示内容）、上述作品的全部历史版本以及周边网站，以及本团队所开发的任意其他作品，拥有软件内的"各商标的所有权"（引用于网络的图片除外），"著作权"等有关的应有权益。 + - 本团队所开发的任意项目的统计数据全部来源于软件用户主动提交，经过对数据简单地筛选后进行展示，因此本团队所开发的任意项目不对数据的准确性负责，该数据也与我方无关。 + - 使用本团队所开发的任意项目的过程中可能会产生拥有原有版权的数据，对于这些数据，本团队所开发的任意项目不拥有它们的所有权，为了避免造成侵权，使用者有义务完全阅读并履行"本使用协议第十条"的内容。本软件内使用的资源（包括但不限于字体、图片、文字等）均来源于互联网的公开信息，如果出现侵权可立即联系[我方](https://github.com/DGP-Studio)移除。 + +## 其他条款 + + - 九、对于团队所开发项目的"非经营性质"的确定。 + + - 本团队所开发的任意项目，均无任何经营性质。 + + - 若开发团队的个别或部分成员，在参与开发本团队所开发的任意项目期间，与本团队所开发的任意项目的第三方用户间产生了包括但不限于：赠与、交换、买卖等关系，其所产生的关系与本开发团队无关，此种情形的发生不基于团队开发有关项目这一事实，而是基于其与第三方用户，在发生上述关系的互联网交互位置或现实地点所产生的独立事件，应当以发生上述关系的互联网交互位置的用户使用条款或结合其在现实地点所发生的具体行为来判定此行为的性质。 + + + - 十、本团队所开发的任意项目（含网站），均以"学习开发知识"、"积累开发经验"为目的进行开发，仅供学习交流，严禁用于商业用途，请您在下载或进行查看学习后的24小时内自行删除全部相关信息，若您无视本条要求，本软件开发团队不对"可能产生的版权纠纷、著作权侵权以及民事纠纷等问题"负责。 + + - 十一、本协议的成立、生效、履行、解释及争议的解决均应适用中华人民共和国大陆地区法律。倘本协议之任何规定因与中华人民共和国的法律抵触而无效，则这些条款将尽可能接近本协议原条文意旨重新解析，且本协议其它规定仍应具有完整的效力及效果。 + + - 十二、本协议签订地点为辽宁省盘锦市辽河油田矿区，在履行本协议中发生纠纷，由双方协商解决，如协商不成，由辽河人民法院管辖，所产生的每阶段费用均由上诉人即时承担。 + + - 十三、本协议中的标题（包括副标题）仅为方便及阅读而设，并不影响本协议中任何规定的含义或解释。 + + - 十四、您和本开发团队均是独立的主体，在任何情况下本协议不构成本开发团队对用户的任何形式的明示或暗示担保或条件，双方之间亦不构成代理、合伙、合营或雇佣关系。 + + - 十五、本"用户使用协议和法律声明"中，"我方"或称"本开发团队"(区别于"用户"或"您")的实际主体为[DGP-Studio开发团队](https://github.com/DGP-Studio)的团队整体及每个成员个人，即包含前述网站中，[DGP-Studio开发团队](https://github.com/DGP-Studio)的全部成员。 + diff --git a/docs/en/statements/update-log.md.md b/docs/en/statements/update-log.md.md new file mode 100644 index 000000000..31e0c6041 --- /dev/null +++ b/docs/en/statements/update-log.md.md @@ -0,0 +1,28 @@ +- - - +category: [公告] icon: update +- - - +# 更新日志 +## 1.4.16 +- 优化 + - 将`JumpList`菜单更换为`JumpTask`，即使用户关闭最近文件功能也可以使用快速启动菜单了 + +## 1.4.15 +- 新增 + - 重置图片资源的入口 + - 刷新 Cookie 方法 +- 修复 + - 修复了[#2 服务器切换导致31-4302报错](/advanced/known-issue.html#_2-%E6%9C%8D%E5%8A%A1%E5%99%A8%E5%88%87%E6%8D%A2%E5%AF%BC%E8%87%B431-4302%E6%8A%A5%E9%94%99) + - 修复了部分情况下程序内清除定时任务计划失败的情况 +- 优化 + - 优化了养成计划界面 [#486](https://github.com/DGP-Studio/Snap.Hutao/issues/486) + - 完善英语和繁体中文翻译 + - 在触发 Windows 长路径限制时增加提示 + - 优化了定时任务的唤醒方式 + +## 1.4.14 +- 修复了养成计划无法添加的问题 +- 支持英语界面 +- 其他的问题修复 + +## 1.4.11 +- 商店初版 \ No newline at end of file diff --git a/docs/ko/advanced/FAQ.md.md b/docs/ko/advanced/FAQ.md.md new file mode 100644 index 000000000..caabacd10 --- /dev/null +++ b/docs/ko/advanced/FAQ.md.md @@ -0,0 +1,113 @@ +--- +headerDepth: 2 +icon: ask +category: + - FAQ +--- + +# 常见问题 + +## 如何创建胡桃的桌面快捷方式 +::: tip 社区力量 +感谢 [CzHUV 提供的解决方案](https://github.com/DGP-Studio/Snap.Hutao.Docs/issues/12) +::: +- `Win+R` 呼出运行窗口，在窗口中输入`shell:AppsFolder` ![Run](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01Jj8c6i1g6du728e5A_!!1797064093.png) +- Windows 会弹出应用程序目录，找到胡桃工具箱 +- 右键，点击`创建快捷方式` +- 根据提示操作你就可以获得一个桌面快捷方式了 + +## 如何添加一个默认以管理员方式运行的快捷方式 +::: tip 社区力量 +感谢 [Parsifa1 提供的解决方案](https://github.com/DGP-Studio/Snap.Hutao.Docs/issues/17) +::: +基本原理：使用下方的 PowerShell 脚本可以以管理员方式运行胡桃 +```PowerShell ts:no-line-numbers +Start-Process shell:AppsFolder\60568DGPStudio.SnapHutao_ebfp3nyc27j86!App -verb runas +``` +- 保存胡桃工具箱的 Logo 资源 + - 你可以点击[这里](https://github.com/DGP-Studio/Snap.Hutao/raw/main/src/Snap.Hutao/Snap.Hutao/Assets/Logo.ico)下载 +- 在桌面点击右键，选择`新建` -> `快捷方式` +- 在`请键入对象的位置`中直接输入: +```PowerShell ts:no-line-numbers + powershell -WindowStyle Hidden -Command "Start-Process shell:AppsFolder\60568DGPStudio.SnapHutao_ebfp3nyc27j86!App -verb runas +``` +- 将快捷方式命名为你需要的名称，比如`Snap Hutao` +- 确认创建，此时你会在桌面得到一个有 PowerShell 图标的快捷方式 +- 右键该快捷方式，点击属性 + - 将`运行方式`修改为`最小化` + - 点击更改图标，选择`浏览`，并选中刚刚下载的图标 +- 这样你就获得了胡桃工具箱的桌面快捷方式，并且运行它将直接以管理员模式运行 + - 你也可以将固定到任务栏或磁贴区 + +## 如何让胡桃工具箱开机自动启动 + +- 请参考如下思路 + - 可以自行创建一个批处理文件，内容参考[此issue](https://github.com/DGP-Studio/Snap.Hutao/issues/184)中，令胡桃以管理员模式直接运行的命令。 + - 设置一个**计划任务程序**令上述批处理文件开机自启，或将上述批处理文件加入**启动项**中 +- 或有其他令胡桃工具箱可开机自启的思路，可自行探索 + +## 如何通过胡桃工具箱快速地启动游戏 + +- 在主程序中正确设置高级启动器功能 +- 将胡桃工具箱在系统中固定在快速启动栏中 +- 在快速启动栏中右键胡桃应用程序 + + ![quick-start](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01Uu8QzN1g6du6MRp8h_!!1797064093.png) +- 选择`启动游戏`即可 + +## 如何通过网络代理使用胡桃工具箱 + +参考 [HttpRequestException 错误](exceptions.html#httprequestexception) 文档 + +## 为什么在设置中点击修改游戏路径无效 + +特定系统版本的用户，由于微软对文件选择对话框的COM实现的差异，会存在点击按钮后无响应的问题。 + +相关的 [Github Issue](https://github.com/microsoft/WindowsAppSDK/issues/2931) + +## 为什么程序会出现乱码现象 + +- 当用户在 Windows 10 下使用胡桃且发现有乱码情况时： + - 可以下载 `Segoe Fluent Icons`字体 + - 安装时选择`为系统所有用户安装`，即可解决问题 +- 您可以从 [微软官方](https://aka.ms/SegoeFluentIcons)下载到该字体文件 + +## 为什么解锁帧率后使用心海时出现掉帧 +原神的BUG，和我们没关系 + +## 为什么会弹出需要使用新应用以打开的对话框 +![uninstall-error](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01b3j0eY1g6duBXLJXg_!!1797064093.jpg) + +如在卸载胡桃工具箱后出现如上图所示的`需要使用新应用以打开此 hutao 链接`，说明没有按文档要求在卸载前清除实时便笺定时任务。 请根据文档在设置中清除定时任务后再卸载胡桃工具箱。 +- 如果你在系统定时任务中找不到胡桃的定时任务，但问题仍然出现，请参考[这份文档](https://github.com/DGP-Studio/Snap.Hutao.Docs/issues/18)来解决 + +## 为什么米游社帐号登录状态经常失效，添加的帐号消失 + +* 我们通过储存帐号的米游社 Cookie 来维持登录状态。 +* 但是当用户在浏览器或其它设备上**注销帐号**后， 维持登录状态的 Cookie 将**失效**。 +* 这会导致胡桃工具箱上的米游社帐号在启动后被自动移除。 +* 此情况也可能因为网络连接问题导致无法检查Cookie有效性，故出现此情况后请优先重启胡桃工具箱。 +* 自2022年10月起，米游社极大地提高了账号被判定为有风险的概率，[账号有风险](mihoyo-risk-tip.md)时亦会令Cookie无法被识别为有效状态 +* 自 1.4.15 版本起，你可以通过在帐号面板中刷新 Cookie 来刷新登录状态 + +## 为什么游戏登录状态会失效，导致切换帐号功能无效 +- 保存游戏登录状态的要素有两个：网络环境和设备 ID +- 导致该问题的常见原因是： + - 网络环境频繁变换，如公网 IP 更换 + - 操作失误，导致实际上根本没有保存登录状态（空的登录状态无法避免被胡桃识别） + - 确认你的帐号已登录后，进入游戏 + - 关闭游戏后，确定游戏进程已关闭 + - 再次进行帐号检测，来添加登录状态 + +## 为什么程序会提示注册计划任务失败 +使用管理员模式使用一次实时便笺后，胡桃的任务计划会被以管理员权限创建。当再次以非管理员模式启动胡桃时，程序在修改计划任务时会缺少权限。 继续使用管理员模式即可解决该问题。 + +## 为什么在开启代理后胡桃工具箱会没有网络连接 + +参考 [HttpRequestException 错误](exceptions.html#httprequestexception) 文档 + +## 为什么商店版本和侧载版本不会相互覆盖升级 + +- 商店版本和侧载版本有不同的软件 ID，所以会被系统识别为不同的程序 +- 商店版的更新只会覆盖商店版应用；侧载版更新包只会更新侧载版应用 +- 在你的系统中，商店版的胡桃工具箱名称为 `Snap Hutao`，侧载版的名称为 `胡桃` diff --git a/docs/ko/advanced/Gacha-system-and-export-principal.md.md b/docs/ko/advanced/Gacha-system-and-export-principal.md.md new file mode 100644 index 000000000..513fec965 --- /dev/null +++ b/docs/ko/advanced/Gacha-system-and-export-principal.md.md @@ -0,0 +1,63 @@ +--- +headerDepth: 0 +category: + - FAQ +icon: read +--- + +# 祈愿系统与导出原理 +> 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）并仅导入较老的数据 + +（因为始终可以从米哈游的服务器获取较新的数据，这种原始数据有更高的精确度） + +### 祈愿的导出 + +~~尚未实现，正在设计~~ 已实装 \ No newline at end of file diff --git a/docs/ko/advanced/README.md.md b/docs/ko/advanced/README.md.md new file mode 100644 index 000000000..3ae07bd40 --- /dev/null +++ b/docs/ko/advanced/README.md.md @@ -0,0 +1,8 @@ +--- +comment: false +index: false +--- + +# 高级 + + \ No newline at end of file diff --git a/docs/ko/advanced/artifact-rating-rules.md.md b/docs/ko/advanced/artifact-rating-rules.md.md new file mode 100644 index 000000000..8100e8599 --- /dev/null +++ b/docs/ko/advanced/artifact-rating-rules.md.md @@ -0,0 +1,13 @@ +--- +category: + - FAQ +icon: read +--- + +# 圣遗物评分机制 + +因角色设定差异，圣遗物评分机制也必须随角色所需属性而确定。 + +如果你有兴趣探索我们的评分机制， 可以审阅[胡桃工具箱代码](https://github.com/DGP-Studio/Snap.Hutao/tree/main/src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/Factory) 来了解评分计算方法。 + +如果你对当前的圣遗物评分机制有新的建议，可以[在 GitHub 上开启 Issue 为圣遗物评分提供新的依据](https://github.com/DGP-Studio/Snap.Hutao/issues/new/choose) \ No newline at end of file diff --git a/docs/ko/advanced/exceptions.md.md b/docs/ko/advanced/exceptions.md.md new file mode 100644 index 000000000..9164c6192 --- /dev/null +++ b/docs/ko/advanced/exceptions.md.md @@ -0,0 +1,42 @@ +--- +headerDepth: 2 +icon: debug +category: + - FAQ +--- + +# 常见的程序异常 +该文档包含由**用户端错误**造成的问题 + +## RuntimeEnvironmentException +- 异常：`RuntimeEnvironmentException` + - 提示：`未开启长路径功能，无法设置注册表键值` +- 问题来源：没有解除 Windows 目录长度限制 +- 解决方案：下载 [EnableLongPaths.zip](https://d.hut.ao/d/tools/EnableLongPaths.zip) 后解压，以管理员身份运行解压后的 `.reg` 文件 + +## Return Code: -10001 +- 该异常实际上来源于米游社的返回信息，包括： + - `Return Code: -10001` + - `Return Code: -100` +- 问题来源： + 1. Cookie 过期或网络异常 + 2. 系统时间错误 +- 解决方案： + 1. 在帐号面板中，点击`刷新 Cookie` + 2. 删除帐号后重新添加米游社帐号 + 3. 在系统设置中启用自动同步时间并立刻同步时间 + +## HttpRequestException 元数据校验文件下载失败 +### 403 (Forbidden) +解决方案：更新胡桃工具箱至[最新版本](https://apps.microsoft.com/store/detail/snap-hutao/9PH4NXJ2JN52) + +### 502 (Bad Gateway) +> 相关 Issue: [https://github.com/DGP-Studio/Snap.Hutao/issues/100](https://github.com/DGP-Studio/Snap.Hutao/issues/100) + +当胡桃工具箱无法从远程服务器获取到必要资源时（通常是配置文件和图片缓存），会在用户界面抛出如下图所示的 `HttpRequestException` 错误。 + +![HttpRequestException](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01Tb2RUm1g6du5YeNuy_!!1797064093.jpg) + +当你遇到该情况，且已经确定本地网络没有互联网连接问题时，请检查是否启用了系统代理程序。如果是，请关闭。胡桃工具箱的远程服务器在全世界范围内都有类似的体验效果， 你无需为了胡桃工具箱的网络连接而使用代理网络。 + +如果系统代理是你的网络必须选项，请关闭系统代理而使用 TUN 模式代理；或者也可以通过 [Windows 8 AppContainer Loopback Utility](https://www.telerik.com/fiddler/add-ons) 解除 [Windows APP Container Loopback 的限制](https://learn.microsoft.com/zh-CN/windows/iot-core/develop-your-app/loopback) 。 \ No newline at end of file diff --git a/docs/ko/advanced/get-stoken-cookie-from-the-third-party.md.md b/docs/ko/advanced/get-stoken-cookie-from-the-third-party.md.md new file mode 100644 index 000000000..de1e54bda --- /dev/null +++ b/docs/ko/advanced/get-stoken-cookie-from-the-third-party.md.md @@ -0,0 +1,44 @@ +--- +category: + - FAQ + - 第三方工具 +icon: read +--- + +# 使用第三方工具获取有 Stoken 的 cookie + +::: warning +- 以下步骤中涉及的软件、开源项目等资源均来源于互联网，与 DGP-Studio 无关 +- 本说明文档仅提供有关的解决思路，仅供学习使用，具体操作与操作后果与本项目无关 +::: + +## Android + +Android 用户可以使用开源项目 GetToken 来获取包含 Stoken 字段的 cookie + +::: tip GetToken 开源项目 +- GitHub：[HolographicHat/GetToken](https://github.com/HolographicHat/GetToken) +::: + +- GetToken 项目的发布会包含两个 apk 文件，两者最终效果相同。根据你的设备情况选择适合你的版本即可 + - `app-release.apk` 为一个 LSPosed 插件允许用户在官方米游社中使用 GetToken 功能 + - 名称以`lspatched`结尾的 apk 文件是一个已包含 GetToken 功能的修改版米游社程序 + - 你需要卸载官方版米游社以安装该版本的米游社 +- 启用插件或安装修改版米游社后打开米游社，在底栏点击"我的"，然后登录您的通行证 +- 在右上角点击形如🔑形状的按钮 +- 点击勾选 `Stoken` 选项 +- 点击`复制登录信息` +- 将复制到的 Stoken 发送到已经安装了胡桃工具箱的电脑 +- 在`胡桃工具箱`中的账号登录位置，点击`手动输入` +- 将之前获取到的 cookie 输入，此时即可完成登录 + +## iOS + +iOS 用户可以在 App Store 下载抓包软件 Stream 来获取包含 Stoken 字段的 cookie +- 从 App Store 下载 [Stream](https://apps.apple.com/cn/app/stream/id1312141691) +- 对域名 `api-takumi.mihoyo.com` 进行抓包分析 +- 找到并复制带有 `Stoken` 的数据 + - 形如`stuid=****;stoken=v2****;mid=****;` +- 将复制到的 Stoken 发送到已经安装了胡桃工具箱的电脑 +- 在`胡桃工具箱`中的账号登录位置，点击`手动输入` +- 将之前获取到的 cookie 输入，此时即可完成登录 diff --git a/docs/ko/advanced/known-issue.md.md b/docs/ko/advanced/known-issue.md.md new file mode 100644 index 000000000..ee318134c --- /dev/null +++ b/docs/ko/advanced/known-issue.md.md @@ -0,0 +1,53 @@ +--- +headerDepth: 2 +icon: tool +category: + - FAQ +--- + +# 已知问题 +该文档包含由**程序错误**造成的问题 + +## #1 微软商店下载应用程序 +> 该问题来源并非胡桃工具箱，属于外部问题 该问题通常仅出现在东亚地区的网络环境下 + +- 发现于 2023/02/07 +- 无法从微软商店下载的原因在于微软在东亚的授权服务器 `licensing.mp.microsoft.com` 掉线。当你在商店上下载一个新应用时，这实际上是一个授权/购买的过程。 当授权服务出现问题时，自然不会再进入到下一步下载环节，这就导致了用户无法安装 + - 目前仅发现于微软商店新加坡授权服务器 `52.137.108.250` 出现了问题，所以你可以使用代理，切换到其它授权服务器，来实现下载。 +- 授权服务器问题 DGP-Studio已反馈给微软，等待解决。 +- 临时的解决方案： + - **方法1**： + - 使用[UsbEAm Hosts Editor](https://www.dogfight360.com/blog/475/) + - 在该工具箱内选择 `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 限制](exceptions.html#_502-bad-gateway) + + +## #2 服务器切换导致31-4302报错 +> 该问题已于 [1.4.15](/statements/update-log.html#1-4-15) 版本修复，请及时更新 +- 使用高级启动器中的服务器切换功能时，可能会出现`31-4302`相关错误 +- 目前的临时解决方案： + - 将原神截图目录中的服务器切换缓存目录删除 + +## #3 任务栏右键菜单中没有快速启动游戏的入口 +- 胡桃使用 Windows 提供的 `JumpPath` 接口来提供快速启动游戏菜单 + - 该接口需要用户在`系统设置 -> 个性化 -> 开始` 中启用`在“开始”菜单或任务栏的跳转列表中以及资源管理器的“快速使用”中显示最近打开的项` （该设置系统默认开启） +- 在下一版本，我们会使用 `JumpTask` 接口来代替 `JumpPath` 接口，用户将不再需要上述设置选项开启 + +## #4 无法使用管理员模式启动胡桃工具箱 +> 该问题来源并非胡桃工具箱，属于外部问题 该问题仅存在于 Windows 10 低于22H2的版本中 + +- 当用户系统版本低于 `Windows Build 19045`（即 Windows 10 22H2 版本）时，可能无法通过管理员模式启动胡桃工具箱 + - 该问题属于 Windows 内核级别问题，难以判断具体来源，故建议用户升级至 Windows 10 最新版本 diff --git a/docs/ko/advanced/mihoyo-risk-tip.md.md b/docs/ko/advanced/mihoyo-risk-tip.md.md new file mode 100644 index 000000000..fc173577a --- /dev/null +++ b/docs/ko/advanced/mihoyo-risk-tip.md.md @@ -0,0 +1,36 @@ +--- +headerDepth: 0 +icon: warn +category: + - FAQ +--- + +# 账号风险及异常提示 + +![image](https://user-images.githubusercontent.com/96916320/201329765-531d6eb6-2ec4-4022-9049-bcba3b4bf9cf.png) ![image](https://user-images.githubusercontent.com/96916320/204005371-ced5213b-a7af-4cba-baa3-818f9b7ade35.png) + + +- 当胡桃工具箱返回"账号有风险，请前往米游社查看"、"请求异常，请前往米游社对应功能页面查看"、"无感验证失败，请前往「米游社我的角色实时便笺」页面查看 "等错误提示时，代表当前的操作被米游社的验证系统所阻挡 + +- 解决方式 + - 方法1 ： + - 自 1.4.15 版本起，在帐号面板内点击 `刷新 Cookie` 即可 + - 方法2： + - 使用手机打开米游社App + - 点击`我的` + - 点击`个人主页` + - 点击`我的角色`下方的角色标签 + - 点击`全部角色` + - 或可以点击`实时便笺`窗体 + - 完成**在此期间可能随机触发的验证流程**（例如验证码），即可解决本问题。 + - 若此操作未触发验证流程，可重复进行多次，直到触发验证为止 + - 若始终无法触发验证，可修改密码 + +::: tip +- 若风险提示过于频繁，或始终无法触发验证，代表您的账号风险已过高，请修改密码，使多个设备同时登录的状态被重置 +::: + +::: warning +- 若您**已绑定并使用可提供原神查询的Bot**或**同时有多个设备使用同一个米哈游通行证**，则本条目所示的情况，尤其**无感验证**将基本无法成功，这是米游社后端的**安全性**设计，不可避免，无法绕过 +- 若您本地有多个**米哈游通行证**同时频繁与**米游社**进行数据交互，则可能会被米游社在一定时间内封禁IP地址，这是米游社后端的**安全性**设计，不可避免，无法绕过 +::: diff --git a/docs/ko/advanced/uninstall.md.md b/docs/ko/advanced/uninstall.md.md new file mode 100644 index 000000000..ad0dac246 --- /dev/null +++ b/docs/ko/advanced/uninstall.md.md @@ -0,0 +1,27 @@ +--- +category: + - FAQ +icon: delete +--- + +# 卸载胡桃工具箱 + +- 清除有关的任务计划 + - 1.4.15 版本前，若不执行该步骤，胡桃用于获取实时便笺数据的计划任务将不会被删除，会出现[这个问题](FAQ.md#为什么会弹出需要使用新应用以打开的对话框) + - **方法1** ： + - 打开胡桃，选择 **设置** 页签 + - 找到 **删除所有计划任务** 一栏中，点击右侧的 **执行** 按钮 + - **方法2**： + - 执行下方的脚本 + ``` PowerShell + schtasks /delete /tn SnapHutaoDailyNoteRefreshTask + ``` + - **方法3**： + - 打开 Windows 计划任务程序 + - 找到 `SnapHutaoDailyNoteRefreshTask` 任务并删除 +- 卸载软件 + - 打开`开始菜单` + - 找到或搜索到`胡桃` + - 右键点击`胡桃`，并选择`卸载` +- 清除数据文件夹（如需完全卸载） + - 打开并删除该文件夹 `%userprofile%/Documents/Hutao` \ No newline at end of file diff --git a/docs/ko/community.md.md b/docs/ko/community.md.md new file mode 100644 index 000000000..5c442c667 --- /dev/null +++ b/docs/ko/community.md.md @@ -0,0 +1,26 @@ +--- +headerDepth: 0 +category: + - 公告 +--- + +# 加入用户社区 + +作为开源软件，社区动力是胡桃工具箱生态的重要组成部分，你可以在通过下面的方式加入到胡桃的用户社区中。 + +@include(star-request.md) +## GitHub 讨论 +[Snap.Hutao Discussion](https://github.com/DGP-Studio/Snap.Hutao/discussions) + +## QQ 群 +- [Snap 一群](https://go.hut.ao/qun1) +- [Snap 二群](https://go.hut.ao/qun2) +- [Snap 三群](https://go.hut.ao/qun3) +- [Snap 四群](https://go.hut.ao/qun4) +- [Snap 开发交流群] + - 广泛的技术交流群，并非胡桃工具箱开发群 + - 开发群对申请者的技术水平有一定要求 + - 如果你有兴趣可以从[https://dev-group.hut.ao](https://dev-group.hut.ao)加入开发者交流群 + +## Discord +邀请链接：[https://discord.gg/Yb8bykaUKp](https://discord.gg/Yb8bykaUKp) \ No newline at end of file diff --git a/docs/ko/features/README.md.md b/docs/ko/features/README.md.md new file mode 100644 index 000000000..3e8ccd34b --- /dev/null +++ b/docs/ko/features/README.md.md @@ -0,0 +1,9 @@ +--- +headerDepth: 0 +comment: false +index: false +--- + +# 功能指南 + + \ No newline at end of file diff --git a/docs/ko/features/achievements.md.md b/docs/ko/features/achievements.md.md new file mode 100644 index 000000000..cb70ced27 --- /dev/null +++ b/docs/ko/features/achievements.md.md @@ -0,0 +1,28 @@ +--- +headerDepth: 0 +category: + - 功能 + - 教程 +--- + +# 成就管理 + +![](https://img.alicdn.com/imgextra/i1/1797064093/O1CN01eddfVC1g6du4Xdd9P_!!1797064093.png) + +胡桃工具箱提供成就管理功能，用户可以通过它浏览并管理所有的成就状态 + +- 在第一次使用时，你需要根据提示点击`创建新存档`按钮以创造一个成就存档并为其命名 +- 创建第一个资料页后，你可以点击右上角的`创建新存档`来继续为更多的帐号创建成就记录档案 + +## 成就导入 + +- 胡桃工具箱使用[统一可交换成就标准](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) + +- [椰羊cocogoat](https://cocogoat.work/) + diff --git a/docs/ko/features/character-data.md.md b/docs/ko/features/character-data.md.md new file mode 100644 index 000000000..9b41abc19 --- /dev/null +++ b/docs/ko/features/character-data.md.md @@ -0,0 +1,75 @@ +--- +headerDepth: 0 +category: + - 功能 + - 教程 +--- + +# 属性统计 + +::: 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) diff --git a/docs/ko/features/character-wiki.md.md b/docs/ko/features/character-wiki.md.md new file mode 100644 index 000000000..4ed55be56 --- /dev/null +++ b/docs/ko/features/character-wiki.md.md @@ -0,0 +1,38 @@ +--- +headerDepth: 0 +category: + - 功能 + - 教程 +--- + +# 角色资料 + +![characters-wiki](https://img.alicdn.com/imgextra/i3/1797064093/O1CN017m1hd11g6dtvZP5UA_!!1797064093.png) + +角色资料是胡桃工具箱中内置的用于查询各个角色的基础信息、天赋数值、命之座、培养材料等数据的 wiki + +## 已包含的数据 +- 角色列表 + - 使用列表左上角的按钮，可切换列表显示的方式：即"缩略图与名称"或"仅缩略图" + - 单击列表中的缩略图或名称，即可跳转到相应的介绍页面 +- 数据内容 + - 角色基本信息 + - 介绍 + - 各等级下的数值 + - 属性 +- 天赋 + - 基本介绍 + - 可切换至对应等级天赋的各项数值 +- 命之座 +- 根据"胡桃数据库"的统计信息而展示的**角色队伍搭配、武器搭配以及圣遗物搭配**的相关推荐 +- 其他信息 + - 角色立绘 + - 特色料理 + - 衣装信息 + - 角色资料 + - 角色故事 + +## 添加至养成计划 +- 在角色资料页面，你可以在选定角色后，点击右上角的`养成计算`按钮来将该角色添加至你的养成计划中 + - 该养成计划将默认从角色1级开始培养 + - 如果你需要基于当前已有的角色创建养成计划，可以使用[我的角色](character-data.md)功能 \ No newline at end of file diff --git a/docs/ko/features/daily-notes.md.md b/docs/ko/features/daily-notes.md.md new file mode 100644 index 000000000..397771005 --- /dev/null +++ b/docs/ko/features/daily-notes.md.md @@ -0,0 +1,48 @@ +--- +headerDepth: 0 +category: + - 功能 + - 教程 +--- + +# 实时便笺 + +::: info +该功能需要你在胡桃工具箱中登录米游社帐号，登录方法可见[米游社多帐号切换](mhy-account-switch.md)文档 +::: +![live-data-tracking](https://img.alicdn.com/imgextra/i2/1797064093/O1CN01tiu6aD1g6duB3mtYQ_!!1797064093.png) + +## 添加角色 +- 点击`添加角色`按钮 +- 在弹出的`添加角色`浮窗中，选择您要添加的游戏角色，并单击其右侧的加号按钮 +- 此时您添加的游戏角色即可显示在实时便笺页面中 + - 实时便笺是间隔固定时间自动刷新的 + - 你可以点击窗口右上角的`通知设置`来设置查询的间隔时间 + - 如您需要立即刷新以获取实时的最新数值，请单击`立即刷新`按钮 + - 如出现"账号有风险，请前往米游社查看"字样的提示 + - 请参考[账号风险提示](../advanced/mihoyo-risk-tip.md)文档 + +## 全局通知设置 +- 在窗口右上角点击`通知设置`可以修改实时便笺的全局设置，包括： + - 数据刷新间隔时间 + - 通知免打扰 + - 高优先度通知 + - 这将避免胡桃工具箱的通知被自动收入操作中心 + - 请注意，开启此设置可能会让您在日常使用电脑期间受到打扰 + +## 帐号独立设置 + +- 胡桃工具箱的实时便笺功能允许用户对每一个被监控的帐号给予不同的设置 +- 将鼠标停留在**需要被设置的**角色实时便笺的窗体上 +- 点击其窗体右上角出现的设置图案按钮，即可修改如下参数 + - 原粹树脂提醒阈值 + - 洞天宝钱提醒阈值 + - 启用参量质变仪提醒 + - 启用每日委托上限提醒 + - 启用探索派遣完成提醒 + - 启用在主页显示卡片 (未上线的新功能) +- 点击`保存`，即可保存您当前所设置的通知选项 + +## 删除角色 +- 将鼠标停留在需要被设置的角色实时便笺的窗体上 +- 点击其窗体右上角出现的移除标志按钮，即可移除该角色对应的实时便笺 diff --git a/docs/ko/features/develop-plan.md.md b/docs/ko/features/develop-plan.md.md new file mode 100644 index 000000000..9d0e578ad --- /dev/null +++ b/docs/ko/features/develop-plan.md.md @@ -0,0 +1,47 @@ +--- +headerDepth: 0 +category: + - 功能 + - 教程 +--- + +# 养成计划 + +![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)直接向我们反馈，感谢您的贡献！ + + diff --git a/docs/ko/features/game-launcher.md.md b/docs/ko/features/game-launcher.md.md new file mode 100644 index 000000000..afc698cc3 --- /dev/null +++ b/docs/ko/features/game-launcher.md.md @@ -0,0 +1,94 @@ +--- +headerDepth: 0 +category: + - 功能 + - 教程 +--- + +# 高级启动器 + +- 胡桃工具箱提供的高级启动器功能中通过多样的设置选项来允许用户以自定义设置启动游戏 +- 你可以通过点击左侧菜单栏中的`启动游戏`进入高级启动器功能 + - 第一次使用时你会被跳转到设置页面以设置你的游戏路径 + - 选择游戏路径时，请注意此处选择的应是游戏本身 + - 形如：`$\Genshin Impact\Genshin Impact Game\YuanShen.exe` + - 而官方启动器的目录一般是`$\Genshin Impact\launcher.exe` +- 在设置完毕启动游戏所需的附加选项后，点击右下角的`启动游戏`按钮即可 + - 附加选项请看本页下方的功能文档 + +## 视频指南 +对于大多数人而言，遵循本页文档会有更高的效率。 + +但如果你对其中包含的操作不熟悉，也可以回到这里来跟着视频指南操作。 ::: details 胡桃工具箱指南 4 - 高级启动器（切换帐号/切换服务器/帧率解锁） + +::: + +## 切换服务器 +::: tip 权限提示 +1. 使用该功能时需要以管理员权限启动胡桃工具 +2. 胡桃工具箱会在游戏截图目录下创建一个名为 `HutaoCache` 的文件夹并储存转换服务器所需要的文件 +::: + +- 在主界面点击左侧菜单栏进入`启动游戏`页面 +- 点击右侧选项中的服务器名称，选择要进入的服务器 + - 目前可选的服务器为`官方服|天空岛`、`渠道服|世界树`和`国际服` +- 点击右下角的`启动游戏`按钮，胡桃会自动下载并应用对应服务器的文件并启动游戏 + + +## 账号保存 +::: tip +1. 本功能所描述的帐号，特指当前原神所登录游戏账号的登录状态 +2. 获取当前原神的登录状态通常需要管理员权限，建议`使用管理员模式启动胡桃` +3. **目前仅支持切换官方服（不含渠道服）帐号** +::: + +| | 官方服 | 渠道服 | 国际服 | +| ------ | --- | --- | ------------------------------------------------------------------------------- | +| 保存登录状态 | 支持 | 支持 | 支持 | +| 切换账号 | 支持 | 不支持 | 理论支持
[我们期待更多的社区开发者帮助](https://github.com/DGP-Studio/Snap.Hutao/pulls) | + +1. 在主界面点击左侧菜单栏进入`启动游戏`标签 +2. 点击`账号`功能中的`检测`按钮，胡桃工具箱会保存当前原神游戏的登录状态 +3. 在弹出的`为账号命名`界面中，输入您要为此账号设置的名称，点击确认 +4. 在游戏中，注销当前登录并登录你另一个帐号。重复执行上述的第2步和第三步直至你将全部的帐号添加进胡桃工具箱中。 +5. 此时即可在`账号`功能下方自由选择您要切换的账号 + - 每个已保存的账号均为可点击选择的按钮 + - 在其右侧有三个按钮，分别为： + - `绑定当前用户角色`，即将您当前选择的米游社登录状态绑定至该账号中，点击该按钮后，对应的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` 选项中，可自由拖动拉杆，调整到您需要设置的最高帧率上限 + +- 会导致**解锁帧率上限失败**的因素： + - 解锁帧率上限，需要保持**胡桃工具箱**在开启状态 + - 游戏内未关闭**垂直同步**选项 + - 在显卡驱动中存在`最大帧速率`的设置 + - 在显卡驱动软件内存在未关闭的类似于`节能模式`的选项 + diff --git a/docs/ko/features/hutao-API.md.md b/docs/ko/features/hutao-API.md.md new file mode 100644 index 000000000..183efb348 --- /dev/null +++ b/docs/ko/features/hutao-API.md.md @@ -0,0 +1,48 @@ +--- +headerDepth: 0 +category: + - 功能 + - 教程 +--- + +# 胡桃数据库/深渊统计 + +胡桃工具箱提供两个主要的深境螺旋挑战统计的功能 +- 侧栏中的`深渊统计`是一个旨在通过统计并展示广大玩家深境螺旋挑战数据，来帮助对原神对战系统不熟悉玩家组建队伍、通关深渊、获取奖励的功能 +- 侧栏中的`深渊记录`是一个通过保存玩家每一期深境螺旋挑战数据来帮助个人玩家回顾游戏经历及个人数据收集的统计功能 + - 众多的玩家通过上传个人的`深渊记录`来形成胡桃数据库的`深渊统计`数据集 + +::: 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]: 只要拥有该角色，即使没有在深境螺旋中登场，也会被计入拥有的状态； 只要上传过深境螺旋记录，即会被计入全部玩家的数据中。 diff --git a/docs/ko/features/hutao-settings.md.md b/docs/ko/features/hutao-settings.md.md new file mode 100644 index 000000000..1580a5726 --- /dev/null +++ b/docs/ko/features/hutao-settings.md.md @@ -0,0 +1,94 @@ +--- +headerDepth: 0 +category: + - 功能 + - 教程 +--- + +# 软件设置 + +::: 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" + +- 删除游戏内网页缓存 + - 若您在使用**祈愿记录功能**时，选择**使用"从缓存刷新"**，但**频繁提示**验证密钥过期，可以尝试此操作 + - 点击此选项内的`删除`按钮即可 + +## 测试功能 + +- 打开`数据`文件夹 + - 在此选项中点击"打开"按钮，即可打开包含"用户数据/日志/元数据"的文件夹 + +- 打开`缓存`文件夹 + - 在此选项中点击"打开"按钮，即可打开包含"图片缓存"的文件夹 + - 在此文件夹内，存储了`胡桃工具箱`在运行期间产生的`图片缓存` + +### 米游社每日签到 + +::: tip +米游社签到功能主要用于米游社帐号登录状态监测 +::: + +- 如何使用 + - 首先需要您在`米游社多账号切换`功能中，选中当前需要进行签到的米游社账号 + - 点击"打开签到对话框"按钮 + - 胡桃工具箱会打开签到页面，随后你即可手动签到 +- 该功能的正常使用界面： + ![米游社每日签到](https://img.alicdn.com/imgextra/i4/1797064093/O1CN01WCLbxe1g6duCXB6tc_!!1797064093.png) + +## 危险功能 +- 删除所有计划任务 + - 当你需要卸载胡桃工具箱时，可以使用此功能以删除胡桃工具箱的定时数据拉取任务 +- 删除所有用户 + - 此功能的作用是删除用户表的所有记录 + - 点击`执行`按钮即可完成删除 + - 通常情况下，用户不需要使用此功能来删除用户表的信息 + diff --git a/docs/ko/features/mhy-account-switch.md.md b/docs/ko/features/mhy-account-switch.md.md new file mode 100644 index 000000000..098324263 --- /dev/null +++ b/docs/ko/features/mhy-account-switch.md.md @@ -0,0 +1,41 @@ +--- +headerDepth: 0 +category: + - 功能 + - 教程 +--- + +# 米游社多帐号切换 + +::: tip +- 本文档所描述的帐号切换指的是用于获取游戏数据的**米游社帐号**，不是原神**游戏内的帐号** +- 在使用本功能前，你需要使用官方的米游社 App 登录你的帐号以初始化你的米游社功能 + - 如果在胡桃中登录的帐号名称格式为 `user_123456789` 则其有可能没有被初始化 +::: + +![多帐号管理样图](https://img.alicdn.com/imgextra/i4/1797064093/O1CN01tRs9NH1g6du1XgyDZ_!!1797064093.png) + +::: details 胡桃工具箱视频指南 - 米游社帐号登录 +对于大多数人而言，遵循本页文档会有更高的效率。 + +但如果你对其中包含的操作不熟悉，也可以回到这里来跟着视频指南操作。 + + +::: + +- 你可以在程序主界面的左下角，设置按钮的上方找到帐号菜单，以管理你在胡桃工具箱中登录的米游社帐号。在弹出的面板中你可以： + - 点击`登录米哈游通行证`按钮 + - 在弹出的内置浏览器中登录"米哈游通行证"账号 + - 您也可以通过点击`手动输入`按钮，直接输入米游社通行证 cookie 来添加您的帐号 + - 若您选择`手动输入`米游社 cookie，则该 cookie **必须包含 `Stoken` 字段** + - 手动获取含 `Stoken` 字段的 cookie 的方式可参考[使用第三方工具获取有 Stoken 的 cookie](/advanced/get-stoken-cookie-from-the-third-party.md) 文档 + - 在弹出的内置浏览器登陆成功后，点击右上角的"我已登陆"按钮 + - 完成后，您就可以在帐号管理面板切换已登录的米游社帐号了 + - 新添加米游社账号后，需在主界面左下角切换账号的功能中，手动点击一次新登录的账号，以将其设置为使用状态 + - 你可以在帐号管理菜单中复制对应帐号的 cookie 或从胡桃工具箱中删除该帐号 + +::: info 安全提示 +- `Stoken` 是一个安全敏感的 cookie 字段，你**不应该**在任何云端或其它无法保证数据安全的设备上储存含有 `Stoken` 字段的 cookie。 +- 从胡桃工具箱中复制获得的 cookie 中包含该字段，请慎重考虑是否为接受 cookie 的一方提供 `Stoken` 字段。 +- **在胡桃工具箱中通过密码或 cookie 登录米游社的过程中，你的数据只经米游社服务器和本地胡桃工具箱处理，不经过包括胡桃服务器在内的任何第三方服务。** +::: diff --git a/docs/ko/features/weapon-wiki.md.md b/docs/ko/features/weapon-wiki.md.md new file mode 100644 index 000000000..14a325b18 --- /dev/null +++ b/docs/ko/features/weapon-wiki.md.md @@ -0,0 +1,28 @@ +--- +headerDepth: 0 +category: + - 功能 + - 教程 +--- + +# 武器资料 + +![weapon-wiki](https://img.alicdn.com/imgextra/i1/1797064093/O1CN01jbzlTH1g6du6KfSmF_!!1797064093.png) + +武器资料是胡桃工具箱中内置的用于查询各个武器的**外观、参数、精炼效果、推荐搭配**等数据的 Wiki + + +## 已包含的数据 + +- 武器列表 + - 使用列表左上角的按钮，可切换列表显示的方式：即"缩略图与名称"或"仅缩略图" + - 单击列表中的缩略图或名称，即可跳转到相应的介绍页面 +- 数据内容 + - 武器基本信息 + - 突破前后的武器图标对比 + - 对应武器的立绘展示 + - 武器的简介内容 + - **可切换**至对应等级的武器各项数值 + - 武器精炼信息 + - 对应精炼阶数的精炼属性 + - 根据胡桃数据库的统计信息而展示的**武器使用**的相关推荐 diff --git a/docs/ko/features/wish-export.md.md b/docs/ko/features/wish-export.md.md new file mode 100644 index 000000000..a71a05692 --- /dev/null +++ b/docs/ko/features/wish-export.md.md @@ -0,0 +1,94 @@ +--- +headerDepth: 0 +category: + - 功能 + - 教程 +--- + +# 祈愿记录 + +抽卡是原神的核心玩法之一，无论是出于纪念、炫耀的目的还是认真规划抽取计划，对历史抽卡进行统计分析都是非常重要的。 但是原神官方只为玩家提供了半年的抽卡记录，这是很不友好的（~~但是他们还是统计了你一整年杀了多少提米的鸽子~~）。 + +因此，我们需要利用这半年的抽卡记录调取窗口，将抽卡记录转移到我们自己手中，这就是胡桃工具箱中祈愿记录导出功能的目的所在。 + +有关原神祈愿记录导出的技术原理，你可以参阅我们的[**祈愿系统与导出原理**](/advanced/Gacha-system-and-export-principal.md)一文。 + +![祈愿导出](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01B2DDii1g6du87XIIG_!!1797064093.png) + +::: note 原神抽卡记录的延迟性 +胡桃工具箱获取抽卡记录的来源也为米哈游服务器，因此短时间内刚刚结束的抽卡无法被获取。 当你在游戏内抽卡历史记录中看到了最新的一批抽卡记录，则可以在胡桃中获取统计数据。 + +::: + +## 视频指南 +对于大多数人而言，遵循本页文档会有更高的效率。 + +但如果你对其中包含的操作不熟悉，也可以回到这里来跟着视频指南操作。 ::: details 胡桃工具箱指南 5 - 祈愿记录导出篇 + +::: + +## 获取祈愿数据 +### 利用 Stoken 从服务器获取最新的祈愿记录 + +::: info 提示 +- 已登录的米游社帐号是使用 Stoken 刷新方法的前提，你可以参考[米游社多帐号切换](mhy-account-switch.md)一文在胡桃工具箱中登录你的帐号 +- Stoken 刷新方法暂不支持国际服 +::: + +- 在胡桃工具箱中确保你需要获取记录的米游社帐号已登录 +- 从左侧菜单栏进入`祈愿记录` +- 点击右上角的`刷新`，并点击`Stoken刷新` +- 等待读取完毕，即可查看最新的祈愿记录 + +### 从网页缓存获取最新的祈愿记录 + +- 从左侧菜单栏进入`祈愿记录` +- 启动游戏并登入游戏，打开游戏内的祈愿历史记录 +- 回到胡桃工具箱，点击`刷新`按钮，在刷新菜单中点击`网页缓存刷新` + +::: tip +若出现`网页缓存刷新`功能异常的情况： +- 从胡桃工具箱的`设置` +- 在`删除游戏内网页缓存`功能中执行删除操作 +::: + +### 通过输入 Url 获取祈愿记录 +- 如果你通过其它工具获取到了你祈愿历史记录的 Url，可以选择`手动输入Url`并根据提示操作 +- 但应注意此类 Url **具有时效性** + +### 对于全量刷新选项的补充说明 + +在默认情况下，胡桃工具箱会在匹配到本地已有记录的祈愿ID后停止导入。 但如果你希望完整地获取原神服务器中所有的历史记录（即使它已经存在于你的本地祈愿记录中），你可以勾选`全量刷新`。 + +**不勾选`全量刷新`不会使你丢失祈愿数据，勾选`全量刷新`也不会让你的本地记录错误地额外记录一次相同的祈愿数据。** + +### 从其它祈愿导出程序导入祈愿数据 +胡桃工具箱支持导入 `UIGF 数据格式` 的祈愿记录数据[^UIGF-Org] + +如果你希望导入这一类数据，可以： +- 启动胡桃工具箱，从左侧菜单栏进入`祈愿记录` +- 点击右上角的`导入` +- 选择你的 UIGF Json 数据文件 +- 根据界面确认导入数据 + +### 从 Snap Genshin 转移祈愿记录数据 +如果你希望从 Snap Genshin 中转移祈愿数据至胡桃工具箱，你可以： +- 升级 Snap Genshin 到最新版本 +- 进入`祈愿记录`功能 + - 如果你由于无法登录米游社而无法进入 Snap Genshin，可以在胡桃工具箱中登录米游社帐号并复制 Cookie 到 Snap Genshin +- 点击右上角的功能菜单 +- 通过`导出 UIGF Json 文件`导出 Json 格式的祈愿记录 +- 在胡桃工具箱中导入该文件 + +## 导出祈愿数据 + +胡桃工具箱支持导出 `UIGF数据格式` 的 Json 文件格式的祈愿记录数据 + +如果你希望导出祈愿数据，可以： +- 启动胡桃工具箱，从左侧菜单栏进入`祈愿记录` +- 选择您要导出的祈愿记录存档 +- 点击`导出`按钮 + - 在弹出的界面选择您需要将此导出的祈愿记录数据文件存放的位置，并点击`导出` +- 导出完成 + +[^UIGF-Org]: 统一标准化的原神数据格式由 [UIGF-Org](https://uigf.org/) 提供 \ No newline at end of file diff --git a/docs/ko/i18n.md.md b/docs/ko/i18n.md.md new file mode 100644 index 000000000..3562d14ba --- /dev/null +++ b/docs/ko/i18n.md.md @@ -0,0 +1,43 @@ +# 国际化支持 +## 国际化进度 +Snap Hutao 虽然基于原神国服提供功能，但项目也有意提升国际化支持，包括语言本土化和功能国际化。目前国际化进度如下： + +- Snap Hutao 主项目 + - [x] 语言本土化技术框架 + - [ ] 客户端翻译 + - 进度：![Crowdin](https://badges.crowdin.net/snap-hutao/localized.svg) + - [x] 英语 + - [x] 繁体中文 + - [x] 韩语 + - [ ] 日语 + - [ ] 俄语 + - [x] 国际服/国服客户端转换 + - [ ] 国际服游戏帐号切换 + - [x] 国际服祈愿记录导出 + - [x] 国际服角色属性统计 + - [ ] HoYoLAB 登录支持 + - [ ] 国际服深渊记录获取 + - [ ] 实时便笺 + - [ ] 多语言游戏公告 +- Snap Hutao 文档 + - [x] 语言本土化技术框架 + - [ ] 网页翻译 + - 进度：![Crowdin](https://badges.crowdin.net/snap-hutao-docs/localized.svg) + - [ ] 英语 + - [x] 主页 + - [ ] 用户文档 + - [ ] 韩语 + - [ ] 主页 + - [ ] 用户文档 + +## 参与国际化 + +- Snap Hutao 主项目 + - 我们在 GitHub 上创建了一个名为 `[Hoyolab]: Globalization support` 的 [Issue](https://github.com/DGP-Studio/Snap.Hutao/issues/144) + - 我们会在该 Issue 中更新当前主程序国际化进度 + - 你可以在这里宣布参与主程序某一部分的国际化支持，我们会为此提供支持 + - 我们也欢迎直接通过分支发起 Pull Request + - **你可以在 [translate.hut.ao](https://translate.hut.ao) 参与客户端的翻译工作** +- Snap Hutao 文档 + - **你可以在 [translate-docs.hut.ao](https://translate-docs.hut.ao) 参与文档的翻译工作** + \ No newline at end of file diff --git a/docs/ko/markmap.md.md b/docs/ko/markmap.md.md new file mode 100644 index 000000000..8114ae10a --- /dev/null +++ b/docs/ko/markmap.md.md @@ -0,0 +1,23 @@ +# 胡桃工具箱 + +## 米游社功能 + +- 活动公告 +- 帐号登录 +- 实时便笺 +- 深境螺旋 + - 我的深渊记录 + - 胡桃数据库 - 深渊数据 + +## 游戏性增强 + +- 高级启动器 +- 祈愿记录 +- 成就管理 + +## 养成计划 + +- 养成计算器 + - 属性统计 + - 角色 Wiki + - 武器 Wiki diff --git a/docs/ko/project.md.md b/docs/ko/project.md.md new file mode 100644 index 000000000..53b980b84 --- /dev/null +++ b/docs/ko/project.md.md @@ -0,0 +1,42 @@ +--- +headerDepth: 0 +category: + - 公告 +--- + +# 项目说明 + +胡桃工具箱是一个 Windows 平台的开源的原神工具箱，旨在帮助玩家获得更好的游戏体验； 它是对官方移动端工具的一种非破坏性功能扩展，为不习惯在移动端进行原神游戏的 PC 玩家提供一个在 Windows 平台下获得接近移动端功能权利的途径。 + +## 功能迁移 +胡桃正在迁移原 Snap Genshin 客户端中的功能 + +已经完成迁移的功能将会在本站文档中提供指导说明，功能迁移和开发进度可以参阅下方 + +- [x] 米游社公告首页 +- [x] 米游社帐号管理 +- [x] 游戏启动器 +- [x] 祈愿记录 +- [ ] WIKI - 日常材料 + - 将整合进养成计划 +- [ ] WIKI - 周常材料 + - 将整合进养成计划 +- [x] WIKI - 角色资料 +- [x] WIKI - 武器资料 +- [x] 成就统计 +- [x] 胡桃数据库 +- [x] 养成计算器 +- [x] 角色橱窗 +- [ ] 玩家查询 +- [ ] 自定义网页 + +## 新增功能 + +以下新功能计划被增加到胡桃工具箱中 +- [ ] 祈愿云端同步 +- [ ] 国际化支持 + - 等待微软修复上游问题 +- [ ] 国际服支持 + - [x] 游戏启动器 + - [x] 服务器切换 + - [x] 祈愿记录 \ No newline at end of file diff --git a/docs/ko/quick-start.md.md b/docs/ko/quick-start.md.md new file mode 100644 index 000000000..12712afe8 --- /dev/null +++ b/docs/ko/quick-start.md.md @@ -0,0 +1,48 @@ +--- +pageClass: link-box +externalLinkIcon: false +category: + - 功能 + - 教程 +--- + +# 快速开始 + +::: tip +若您已下载或使用**胡桃工具箱**，即表示你已阅读并完全同意[用户使用协议与法律声明](/statements/tos.md) +::: +@include(star-request.md) + +## 视频指南 +对于大多数人而言，遵循本页文档会有更高的效率。 + +但如果你对其中包含的操作不熟悉，也可以回到这里来跟着视频指南操作。 ::: details 胡桃工具箱视频指南 - 下载/安装/卸载篇 + +::: + +## 最低系统要求 +| 要求 | 规格 | +| ------------- | -------------------------------------- | +| **最低可运行系统版本** | Windows 10 Build 19045 (22H2) [^first] | +| **推荐系统版本** | Windows 11 Build 22621 (22H2) | +| 可选组件 | WebView2 Runtime | + + +## 下载胡桃工具箱 + + + + +微软商店链接：[Snap Hutao](https://apps.microsoft.com/store/detail/snap-hutao/9PH4NXJ2JN52) + +在 Windows 10 和 Windows 11 下你可以直接点击上面的按钮来下载胡桃工具箱 + +## 安装 WebView2 运行时 + +WebView2 运行时由微软提供，其允许胡桃在程序内低开销地启用一个内置的浏览器。作为可选组件，WebView2 运行时不是强制组件，但安装后你会更容易地使用部分功能。 + +在[微软官网](https://developer.microsoft.com/zh-cn/microsoft-edge/webview2/)的底部，你可以找到`常青独立安装程序`，选择`x64`下载并根据提示安装即可 + +[^first]: LTSC 和 LTSB 版本系统由于不包含微软商店，不在支持列表中。Windows 10 Build 19041 亦可以安装，但部分功能会因内核问题无法使用，故该版本下的胡桃工具箱问题将不会被处理 \ No newline at end of file diff --git a/docs/ko/side-load.md.md b/docs/ko/side-load.md.md new file mode 100644 index 000000000..f3ed391f0 --- /dev/null +++ b/docs/ko/side-load.md.md @@ -0,0 +1,19 @@ +## 侧载安装 +### 通用安装方式 +- 在系统设置中打开`开发者设置`界面，勾选 `开发人员模式` 和 `允许 PowerShell 脚本` （自行百度） +- 解压已下载的压缩包，找到`Install.ps1`文件，右键选择`使用PowerShell运行`，按照提示允许PowerShell执行操作即可 +- 安装完毕，`胡桃`将出现在您的`开始菜单`中 + +### 小白级安装方式 +- 解压已下载的安装包 +- 运行 `Snap.Hutao.Installer.exe` + - 该程序将执行上述通用安装方式的命令 +- 安装完毕，`胡桃`将出现在您的`开始菜单`中 + +## 升级胡桃工具箱 + +- 解压你下载的最新版本压缩包 +- 重复 `安装胡桃工具箱` 的步骤 +- 若您安装失败或出现异常情况，可参考如下步骤 + - 先卸载已经安装的`胡桃工具箱` + - 重复 `安装胡桃工具箱` 的步骤 \ No newline at end of file diff --git a/docs/ko/star-request.md.md b/docs/ko/star-request.md.md new file mode 100644 index 000000000..cf4b53bfe --- /dev/null +++ b/docs/ko/star-request.md.md @@ -0,0 +1,8 @@ +**如果你认为胡桃工具箱是一个好的项目或者有帮助到你，你可以通过以下方式支持我们** +- 为我们在 GitHub 上的项目加星点赞 ⭐ + - [Snap.Hutao](https://github.com/DGP-Studio/Snap.Hutao) ![hutao.stars](https://img.shields.io/github/stars/DGP-Studio/Snap.Hutao?style=plastic&color=red) + - [Snap.Hutao.Docs](https://github.com/DGP-Studio/Snap.Hutao.Docs) ![hutao.docs.stars](https://img.shields.io/github/stars/DGP-Studio/Snap.Hutao.Docs?style=plastic&color=red) +- 在[微软商店](ms-windows-store://review/?ProductId=9PH4NXJ2JN52)上给出好评 +- 在更多的地方帮助我们宣传 + +![commit_activity](https://img.shields.io/github/commit-activity/y/DGP-Studio/Snap.Hutao?style=for-the-badge) ![hutao-last-commit](https://img.shields.io/github/last-commit/DGP-Studio/Snap.Hutao?label=Hutao%20Last%20Commit&style=for-the-badge) \ No newline at end of file diff --git a/docs/ko/statements/README.md.md b/docs/ko/statements/README.md.md new file mode 100644 index 000000000..9b155ee8c --- /dev/null +++ b/docs/ko/statements/README.md.md @@ -0,0 +1,9 @@ +--- +headerDepth: 0 +comment: false +index: false +--- + +# 声明和公告 + + \ No newline at end of file diff --git a/docs/ko/statements/bug-report.md.md b/docs/ko/statements/bug-report.md.md new file mode 100644 index 000000000..7525c176e --- /dev/null +++ b/docs/ko/statements/bug-report.md.md @@ -0,0 +1,31 @@ +--- +headerDepth: 0 +category: + - 公告 +icon: debug +--- + +# 提交BUG报告 + +![opened-issue](https://img.shields.io/github/issues/DGP-Studio/Snap.Hutao?style=for-the-badge) ![closed-issue](https://img.shields.io/github/issues-closed/DGP-Studio/Snap.Hutao?style=for-the-badge&color=blue) + +## 推荐方法 + +- 在你使用 Snap Hutao 时如果发现了可复现或不可自行修复的问题，可以通过提交问题反馈来告知开发者。 +- 在提交问题时，您应当尽可能地详细描述问题。如果有错误的截图，也应该提供。这有利于问题排查并加速问题修复。 + - 一个可以参考的非常正面的例子是 [DGP-Studio/Snap.Hutao/issues/100](https://github.com/DGP-Studio/Snap.Hutao/issues/100) +- 如果你有能力在代码层面修复该问题，也欢迎您直接在对应的项目中发起 PR。 ![suggestion](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01jXBMbe1g6du15k9kx_!!1797064093.jpg) **如果你是诚心希望解决问题，则应该在 Issue 中包含尽可能多的信息，比如说：你做了什么；看到了什么结果；程序有什么提示； 你查阅了哪篇文档；尝试了什么解决方案，结果是什么；你的设备ID是什么…… 当你愿意付出更多的时间在提供信息上，更大的可能获得一个准确的解决方案。 一两句话就结束的问题报告大多数不是有效的问题，只会被无视。** + +### 客户端问题 + - 在提交问题前，请务必检查文档内是否已包含了你的问题 + - 首先需要确认您使用的版本是否为最新版本 + - 您可以通过菜单栏中的“常见问题”分类找到这些文档 + - [快速解答](/advanced/FAQ.md) + + - 通过 GitHub 提交问题 + - [github.com/DGP-Studio/Snap.Hutao/issues/new/choose](https://github.com/DGP-Studio/Snap.Hutao/issues/new/choose) + - 通过 兔小巢 提交问题 + - [support.qq.com/products/451231](https://support.qq.com/products/451231) + +### 请求增加或更新文档 + - 通过 GitHub 提交问题：[DGP-Studio/Snap.Hutao.Docs](https://github.com/DGP-Studio/Snap.Hutao.Docs/issues/new/choose) \ No newline at end of file diff --git a/docs/ko/statements/privacy-notice.md.md b/docs/ko/statements/privacy-notice.md.md new file mode 100644 index 000000000..0eb64f51d --- /dev/null +++ b/docs/ko/statements/privacy-notice.md.md @@ -0,0 +1,32 @@ +--- +headerDepth: 0 +category: + - 公告 +icon: license +--- + +# 用户数据和隐私权益 +胡桃工具箱充分尊重用户的隐私，目前我们会按下方的说明使用用户的数据： + +- 使用胡桃后，在 **数据目录** 中以数据库文件的形式 + - **储存** + - 米游社 Cookie + - 胡桃的软件设置信息 + - 全部的用户数据 + +- 使用胡桃主程序时，胡桃会因开发和统计为目的**匿名化地**收集程序意外停止或出错时抛出的日志，包括： + - 用户设备 ID + - 错误与崩溃日志 + - 用户活跃数据统计信息 + +- 使用 `胡桃数据库` (`深渊记录`/`深渊统计`) 功能并选择`上传数据`时， + - 向 胡桃 API **上传** + - 用户的游戏 UID + - 用户的深境螺旋记录 + - 用户的角色信息及其装备的武器和圣遗物信息 + +- 使用`实时便笺`功能后 + - 在 Windows 定时任务中**创建**一个用于获取数据的定时任务 + +- 使用`高级启动器`中的`服务器切换`功能后，在原神截图目录中 + - **储存**服务器转换所需要的文件 \ No newline at end of file diff --git a/docs/ko/statements/tos.md.md b/docs/ko/statements/tos.md.md new file mode 100644 index 000000000..273f43450 --- /dev/null +++ b/docs/ko/statements/tos.md.md @@ -0,0 +1,79 @@ +--- +headerDepth: 0 +category: + - 公告 +comment: false +editLink: false +icon: license +--- + +# 用户使用协议和法律声明 + +## 总则 + - 本"用户使用协议和法律声明"（以下简称"条款"或"使用协议"）适用于[DGP-Studio开发团队](https://github.com/DGP-Studio)（以下简称"本团队"或"我方"）开发的全部软件作品、各开发项目的官方网站、附属的自媒体账号等。 + - 请您仔细阅读本用户使用协议的**全部内容**，在您阅读"使用协议"后，若对此用户使用协议中的**任何条款**有异议，请立刻停止使用本团队所开发的任意项目。 + - 如您未满18周岁，请在法定监护人陪同下仔细阅读并充分理解本协议，并征得法定监护人的同意后使用本团队所开发的任意项目。 + - 若您已安装、使用或在开发时引用本团队所开发的任意项目，表示您已主动阅读(已阅读完毕)并完全同意本使用协议所列明的条款，即已充分理解本协议并承诺作为本协议的一方当事人接受协议、法律声明、隐私政策以及与本团队所开发的任意项目相关的规则、规范、声明、公告、通知等内容的约束。 + - 此《用户使用协议》是由用户(以下或称"您")与本团队所开发的任意项目所订立的用户使用协议和法律声明，本协议对用户和本团队均具有法律效力。 + +## 项目性质、服务以及有关责任与义务的界定 + + - 一、由于本团队所开发的任意项目，均"开源"、"非经营性质"，故本团队可随时执行全权决定：包括但不限于更改"使用协议"，修改本团队所开发的任意项目内的任何内容。如"条款"及"作品的内容"有任何变更，我方将在相关的项目展示网站上刊载公告作为通知。经修订的"条款"一经在官方网站上公布后，即自动生效。 + + + - 二、本软件以"学习开发知识"、"积累开发经验"为目的进行开发，所有项目所提供的功能，均"开源"、"非经营性质"，如用户对本团队所开发的任意项目的安全性表示不满，请立即卸载/删除/停用，如您仍在正常使用，则表示您认可本团队所开发的任意项目的安全性。 + + + - 三、一切因使用本团队所开发的任意项目的内容而导致的"任何意外损失(包括但不限于：软件、硬件、财产以及虚拟物品等)"、"合约毁坏"、"诽谤"、"版权或知识产权侵犯"及其所造成的损失与责任，均为使用者自身对于网络公开的开源软件的使用过程中自身发生的使用行为所引致的"损失与责任",基于全部作品在其开放源代码的位置(即[Github](https://github.com/DGP-Studio))中所声明的[MIT license](https://github.com/DGP-Studio/Snap.Hutao/blob/main/LICENSE)以及本声明所约定的内容，应当认定前述的"损失与责任"与全部项目的有关开发者无责任关联。 + + + - 四、用户使用本团队所开发的任意项目期间，本团队**不做**任何不发生如下情况的保证： + - 因网络状况、通讯线路等任何技术原因而导致用户不能正常使用或更新； + - 因使用"第三方开发的本软件内插件"、"第三方进行二次编译的本软件的修改版"、"复用本开发团队所创作的项目代码而编译成的软件"造成负面结果。 + + + - 五、用户认可本团队所开发的任意项目，除被动接收软件或其他相关项目中的必要的上传报告或有关信息外，所有信息的上传均需要用户的主动触发； + - 用户认可本团队所开发的任意项目，均完全尊重并保护所有用户的"个人隐私权"，项目代码亦完全公开，用户不具有"因隐私权收到侵犯"而对开发团队或团队成员发起控诉的主观理由。 + - 本团队所开发的任意项目不会向第三方共享、转让您的个人信息，除非经过您本人事先授权同意，或者共享、转让的个人信息是去标识化处理后的信息，且共享第三方无法重新识别此类信息的自然人主体。 + - 本团队所开发的任意项目包含到其他站点的链接，当您访问第三方链接时，请认真阅读第三方站点的用户协议和声明，本团队对于第三方站点的内容、隐私条款、使用协议等不负任何责任。 + - 在使用本团队所开发的任意项目时，提交任意资料的过程中，本团队不保证提交的信息保存成功，您需要对您提交的资料做好存储保管。本团队所开发的部分项目为"被授权数据"提供存储，但在存储过程中存在各种不可抗力的因素，本团队无法承诺对用户的存储信息无限期保留，您的重要信息请自行备份。 + +## 权利和义务 + + - 六、我方允许任何单位或个人在没有本开发团队授权的情况下,对本团队所开发的任意项目进行的二次开发、功能修改以及复用我方创作的代码进行其他项目的开发，但对其所侵犯我方计算机软件著作权的行为，我方保留追责的权利。 + - 我开发团队不对任何单位或个人在使用本团队所开发的任意项目的内容进行的公开发布行为（包括但不限于制作视频、发布带有本软件内容的文章、上传至非我开发团队指定的下载网站提供下载等）的内容所致的任意结果进行负责。 + - 我开发团队不对使用"第三方开发的可用于本团队所开发的任意项目的附属程序或额外代码"、"第三方进行二次编译的本团队所开发的任意项目的修改版"、"复用本开发团队所创作的项目代码而编译成的软件"造成的任意结果负责。 + - 在此基础上，根据《计算机软件保护条例》第二条与第三条对于"计算机软件"和"文档"的法律定义，本软件开发团队（DGP Studio）保留全部我方开发项目的计算机软件著作权，其包括但不限于项目构建所需的全部信息、全部项目有关的所有文档资料（即用来描述程序的内容、组成、设计、功能规格、开发情况的程序设计说明书、流程图、用户手册等），具体内容以各项目《计算机软件著作权登记证书》的实际内容为准。 + + + - 七、本团队所开发的任意项目仅作用于合法、合规范围内的学习及研究所用，不得利用本软件系统从事违法活动。 + - 本团队仅作为项目的开发团队（非法人性质，为自然人组成的团体），对任何使用结果不负任何连带责任，软件以及我方开发的任意项目的使用过程中产生的任何法律后果我们概不负责、不承担任何法律责任。 + - 若用户已开始使用本团队所开发的任意项目，即已同意"使用协议"，表明本团队已履行完毕"本使用协议第十款"的告知情形。 + + + - 八、所开发项目的著作权。 + - 本软件开发团队对所开发的"Snap.Genshin软件"、"Snap.Hutao软件"等作品的软件本身（不包括软件内除功能模块外的显示内容）、上述作品的全部历史版本以及周边网站，以及本团队所开发的任意其他作品，拥有软件内的"各商标的所有权"（引用于网络的图片除外），"著作权"等有关的应有权益。 + - 本团队所开发的任意项目的统计数据全部来源于软件用户主动提交，经过对数据简单地筛选后进行展示，因此本团队所开发的任意项目不对数据的准确性负责，该数据也与我方无关。 + - 使用本团队所开发的任意项目的过程中可能会产生拥有原有版权的数据，对于这些数据，本团队所开发的任意项目不拥有它们的所有权，为了避免造成侵权，使用者有义务完全阅读并履行"本使用协议第十条"的内容。本软件内使用的资源（包括但不限于字体、图片、文字等）均来源于互联网的公开信息，如果出现侵权可立即联系[我方](https://github.com/DGP-Studio)移除。 + +## 其他条款 + + - 九、对于团队所开发项目的"非经营性质"的确定。 + + - 本团队所开发的任意项目，均无任何经营性质。 + + - 若开发团队的个别或部分成员，在参与开发本团队所开发的任意项目期间，与本团队所开发的任意项目的第三方用户间产生了包括但不限于：赠与、交换、买卖等关系，其所产生的关系与本开发团队无关，此种情形的发生不基于团队开发有关项目这一事实，而是基于其与第三方用户，在发生上述关系的互联网交互位置或现实地点所产生的独立事件，应当以发生上述关系的互联网交互位置的用户使用条款或结合其在现实地点所发生的具体行为来判定此行为的性质。 + + + - 十、本团队所开发的任意项目（含网站），均以"学习开发知识"、"积累开发经验"为目的进行开发，仅供学习交流，严禁用于商业用途，请您在下载或进行查看学习后的24小时内自行删除全部相关信息，若您无视本条要求，本软件开发团队不对"可能产生的版权纠纷、著作权侵权以及民事纠纷等问题"负责。 + + - 十一、本协议的成立、生效、履行、解释及争议的解决均应适用中华人民共和国大陆地区法律。倘本协议之任何规定因与中华人民共和国的法律抵触而无效，则这些条款将尽可能接近本协议原条文意旨重新解析，且本协议其它规定仍应具有完整的效力及效果。 + + - 十二、本协议签订地点为辽宁省盘锦市辽河油田矿区，在履行本协议中发生纠纷，由双方协商解决，如协商不成，由辽河人民法院管辖，所产生的每阶段费用均由上诉人即时承担。 + + - 十三、本协议中的标题（包括副标题）仅为方便及阅读而设，并不影响本协议中任何规定的含义或解释。 + + - 十四、您和本开发团队均是独立的主体，在任何情况下本协议不构成本开发团队对用户的任何形式的明示或暗示担保或条件，双方之间亦不构成代理、合伙、合营或雇佣关系。 + + - 十五、本"用户使用协议和法律声明"中，"我方"或称"本开发团队"(区别于"用户"或"您")的实际主体为[DGP-Studio开发团队](https://github.com/DGP-Studio)的团队整体及每个成员个人，即包含前述网站中，[DGP-Studio开发团队](https://github.com/DGP-Studio)的全部成员。 + diff --git a/docs/ko/statements/update-log.md.md b/docs/ko/statements/update-log.md.md new file mode 100644 index 000000000..31e0c6041 --- /dev/null +++ b/docs/ko/statements/update-log.md.md @@ -0,0 +1,28 @@ +- - - +category: [公告] icon: update +- - - +# 更新日志 +## 1.4.16 +- 优化 + - 将`JumpList`菜单更换为`JumpTask`，即使用户关闭最近文件功能也可以使用快速启动菜单了 + +## 1.4.15 +- 新增 + - 重置图片资源的入口 + - 刷新 Cookie 方法 +- 修复 + - 修复了[#2 服务器切换导致31-4302报错](/advanced/known-issue.html#_2-%E6%9C%8D%E5%8A%A1%E5%99%A8%E5%88%87%E6%8D%A2%E5%AF%BC%E8%87%B431-4302%E6%8A%A5%E9%94%99) + - 修复了部分情况下程序内清除定时任务计划失败的情况 +- 优化 + - 优化了养成计划界面 [#486](https://github.com/DGP-Studio/Snap.Hutao/issues/486) + - 完善英语和繁体中文翻译 + - 在触发 Windows 长路径限制时增加提示 + - 优化了定时任务的唤醒方式 + +## 1.4.14 +- 修复了养成计划无法添加的问题 +- 支持英语界面 +- 其他的问题修复 + +## 1.4.11 +- 商店初版 \ No newline at end of file