From 178e471272f1bcf1415e6b0f3f04cc6f4925517c Mon Sep 17 00:00:00 2001 From: Masterain Date: Mon, 23 Jan 2023 21:57:29 -0800 Subject: [PATCH] Remove untranslated docs --- .../FAQ/Gacha-system-and-export-principal.md | 60 ----------- docs/en/FAQ/HttpRequestException.md | 13 --- docs/en/FAQ/artifact-rating-rules.md | 9 -- .../get-stoken-cookie-from-the-third-party.md | 37 ------- docs/en/FAQ/how-to.md | 31 ------ docs/en/FAQ/mihoyo-risk-tip.md | 34 ------- docs/en/FAQ/why.md | 34 ------- docs/en/development-log/symposium1.md | 50 ---------- docs/en/development-log/symposium2.md | 29 ------ docs/en/features/README.md | 3 - docs/en/features/achievements.md | 25 ----- docs/en/features/character-data.md | 70 ------------- docs/en/features/character-wiki.md | 35 ------- docs/en/features/daily-notes.md | 45 --------- docs/en/features/develop-plan.md | 44 --------- docs/en/features/game-launcher.md | 79 --------------- docs/en/features/hutao-API.md | 58 ----------- docs/en/features/hutao-settings.md | 99 ------------------- docs/en/features/mhy-account-switch.md | 27 ----- docs/en/features/weapon-wiki.md | 25 ----- docs/en/features/wish-export.md | 79 --------------- docs/en/markmap.md | 23 ----- docs/en/project.md | 38 ------- docs/en/quick-start.md | 60 ----------- docs/en/statements/bug-report.md | 26 ----- docs/en/statements/privacy-notice.md | 19 ---- docs/en/statements/tos.md | 74 -------------- 27 files changed, 1126 deletions(-) delete mode 100644 docs/en/FAQ/Gacha-system-and-export-principal.md delete mode 100644 docs/en/FAQ/HttpRequestException.md delete mode 100644 docs/en/FAQ/artifact-rating-rules.md delete mode 100644 docs/en/FAQ/get-stoken-cookie-from-the-third-party.md delete mode 100644 docs/en/FAQ/how-to.md delete mode 100644 docs/en/FAQ/mihoyo-risk-tip.md delete mode 100644 docs/en/FAQ/why.md delete mode 100644 docs/en/development-log/symposium1.md delete mode 100644 docs/en/development-log/symposium2.md delete mode 100644 docs/en/features/README.md delete mode 100644 docs/en/features/achievements.md delete mode 100644 docs/en/features/character-data.md delete mode 100644 docs/en/features/character-wiki.md delete mode 100644 docs/en/features/daily-notes.md delete mode 100644 docs/en/features/develop-plan.md delete mode 100644 docs/en/features/game-launcher.md delete mode 100644 docs/en/features/hutao-API.md delete mode 100644 docs/en/features/hutao-settings.md delete mode 100644 docs/en/features/mhy-account-switch.md delete mode 100644 docs/en/features/weapon-wiki.md delete mode 100644 docs/en/features/wish-export.md delete mode 100644 docs/en/markmap.md delete mode 100644 docs/en/project.md delete mode 100644 docs/en/quick-start.md delete mode 100644 docs/en/statements/bug-report.md delete mode 100644 docs/en/statements/privacy-notice.md delete mode 100644 docs/en/statements/tos.md diff --git a/docs/en/FAQ/Gacha-system-and-export-principal.md b/docs/en/FAQ/Gacha-system-and-export-principal.md deleted file mode 100644 index c22903089..000000000 --- a/docs/en/FAQ/Gacha-system-and-export-principal.md +++ /dev/null @@ -1,60 +0,0 @@ ---- -headerDepth: 0 ---- - -# 祈愿系统与导出原理 -> 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/FAQ/HttpRequestException.md b/docs/en/FAQ/HttpRequestException.md deleted file mode 100644 index 0ec97fa0e..000000000 --- a/docs/en/FAQ/HttpRequestException.md +++ /dev/null @@ -1,13 +0,0 @@ -# `HttpRequestException`错误 -> 相关 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) 。 - diff --git a/docs/en/FAQ/artifact-rating-rules.md b/docs/en/FAQ/artifact-rating-rules.md deleted file mode 100644 index 184ec649f..000000000 --- a/docs/en/FAQ/artifact-rating-rules.md +++ /dev/null @@ -1,9 +0,0 @@ -# 圣遗物评分机制 - -因角色设定差异，圣遗物评分机制也必须随角色所需属性而确定。 - -如果你有兴趣探索我们的评分机制， -可以审阅[胡桃工具箱代码](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/FAQ/get-stoken-cookie-from-the-third-party.md b/docs/en/FAQ/get-stoken-cookie-from-the-third-party.md deleted file mode 100644 index b97caa522..000000000 --- a/docs/en/FAQ/get-stoken-cookie-from-the-third-party.md +++ /dev/null @@ -1,37 +0,0 @@ -# 使用第三方工具获取有 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/FAQ/how-to.md b/docs/en/FAQ/how-to.md deleted file mode 100644 index d0ff1e46b..000000000 --- a/docs/en/FAQ/how-to.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -headerDepth: 1 ---- - -# 如何... - -这篇文档将会列出一些最常见的以“如何”开头的问题 - -## 如何创建胡桃的桌面快捷方式 -::: 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 会弹出应用程序目录，找到胡桃工具箱 -- 右键，点击`创建快捷方式` -- 根据提示操作你就可以获得一个桌面快捷方式了 - -## 如何实现自动化管理员模式 - -请使用如下的 PowerShell 脚本启动胡桃 -```PowerShell -Start-Process shell:AppsFolder\7f0db578-026f-4e0b-a75b-d5d06bb0a74d_7jfyf5536hdrr!App -verb runas -``` - -## 如何让胡桃工具箱开机自动启动 - -- 请参考如下思路 - - 可以自行创建一个批处理文件，内容参考[此issue](https://github.com/DGP-Studio/Snap.Hutao/issues/184)中，令胡桃以管理员模式直接运行的命令。 - - 设置一个**计划任务程序**令上述批处理文件开机自启，或将上述批处理文件加入**启动项**中 -- 或有其他令胡桃工具箱可开机自启的思路，可自行探索 \ No newline at end of file diff --git a/docs/en/FAQ/mihoyo-risk-tip.md b/docs/en/FAQ/mihoyo-risk-tip.md deleted file mode 100644 index f83b89ef4..000000000 --- a/docs/en/FAQ/mihoyo-risk-tip.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -headerDepth: 0 ---- - -# 账号风险及异常提示 - -![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) - - -- 当胡桃工具箱返回"账号有风险，请前往米游社查看"、"请求异常，请前往米游社对应功能页面查看"、"无感验证失败，请前往「米游社我的角色实时便笺」页面查看 -"等错误提示时，代表当前的操作被米游社的验证系统所阻挡 - -- 解决方式 - - 使用手机打开米游社App - - 点击`我的` - - 点击`个人主页` - - 点击`我的角色`下方的角色标签 - - 点击`全部角色` - - 或可以点击`实时便笺`窗体 - - - 完成**在此期间可能随机触发的验证流程**（例如验证码），即可解决本问题。 - - - 若此操作未触发验证流程，可重复进行多次，直到触发验证为止 - - 若始终无法触发验证，可修改密码 - -::: tip -- 若风险提示过于频繁，或始终无法触发验证，代表您的账号风险已过高，请修改密码，使多个设备同时登录的状态被重置 -::: - -::: warning -- 若您**已绑定并使用可提供原神查询的Bot**或**同时有多个设备使用同一个米哈游通行证**，则本条目所示的情况，尤其**无感验证**将基本无法成功，这是米游社后端的**安全性**设计，不可避免，无法绕过 -- 若您本地有多个**米哈游通行证**同时频繁与**米游社**进行数据交互，则可能会被米游社在一定时间内封禁IP地址，这是米游社后端的**安全性**设计，不可避免，无法绕过 -::: diff --git a/docs/en/FAQ/why.md b/docs/en/FAQ/why.md deleted file mode 100644 index 8df844fd9..000000000 --- a/docs/en/FAQ/why.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -headerDepth: 1 ---- - -# 为什么... - -这篇文档将会列出一些最常见的以“为什么”开头的问题 - -## 为什么在设置中点击修改游戏路径无效 - -特定系统版本的用户，由于微软对文件选择对话框的COM实现的差异，会存在点击按钮后无响应的问题。 - -相关的 [Github Issue](https://github.com/microsoft/WindowsAppSDK/issues/2931) - -## 为什么程序会出现乱码现象 - -- 当用户在 Windows 10 下使用胡桃且发现有乱码情况时： - - 可以下载 `Segoe Fluent Icons`字体 - - 安装时选择`为系统所有用户安装`，即可解决问题 -- 您可以从 [微软官方](https://aka.ms/SegoeFluentIcons)下载到该字体文件 - -## 为什么解锁帧率后使用心海时出现掉帧 -原神的BUG，和我们没关系 - -## 为什么会弹出需要使用新应用以打开的对话框 -请根据文档在设置中清除定时任务后再卸载胡桃工具箱 - -## 为什么米游社帐号登录状态经常失效，添加的帐号消失 - -* 我们通过储存帐号的米游社 Cookie 来维持登录状态。 -* 但是当用户在浏览器或其它设备上**注销帐号**后， 维持登录状态的 Cookie 将**失效**。 -* 这会导致胡桃工具箱上的米游社帐号在启动后被自动移除。 -* 此情况也可能因为网络连接问题导致无法检查Cookie有效性，故出现此情况后请优先重启胡桃工具箱。 -* 自2022年10月起，米游社极大地提高了账号被判定为有风险的概率，[账号有风险](mihoyo-risk-tip.md)时亦会令Cookie无法被识别为有效状态 diff --git a/docs/en/development-log/symposium1.md b/docs/en/development-log/symposium1.md deleted file mode 100644 index c54edd11a..000000000 --- a/docs/en/development-log/symposium1.md +++ /dev/null @@ -1,50 +0,0 @@ -# 第一期开发组座谈会 -复制自 [GitHub 讨论帖](https://github.com/DGP-Studio/Snap.Hutao/discussions/46)，总结于群讨论 - -## 为啥胡桃在电脑上要做成类似uwp格式的应用？ -开发MSIX封装的应用是桌面端的开发趋势，开发体验更佳，用户体验也能提升。 - -## 胡桃的作用是啥，和SG有什么区别？ -胡桃是SG的次世代版本，更新/更快/更强。 - -## 胡桃会全面继承 SG 的功能吗？SG的一些功能会在hutao里被弃用吗？ -多数功能会完全继承与升级。少数功能会以整合功能的形式出现在胡桃中。 - -## 为啥不把胡桃和 SG 集合到一起，而是要分开呢？和sg有什么侧重上的不同？ -Snap Genshin 采用 WPF 技术开发，该技术基于 DirectX 9，而 胡桃 采用 WinUI 3 开发，该新技术基于DirectX 12与其他较新的显示技术，呈现的效果更好，同时也更易于开发，胡桃 与 Snap Genshin 类似，但侧重于流畅、简单的用户体验，同时也更注重程序架构的可维护性，更关注性能表现。 - -## 除了SG的旧功能迁移，还会有新功能开发吗？ -随着原神的发展，我们也会推出更多的功能。 - -## SG永远不会更新了吗？SG是快不能用了吗？ -没有严重的数据异常问题不会再更新。由于缺乏维护，不保证在何时由于某些不确定的原因会导致SG的部分功能失效（如先去的签到功能）。 - -## 胡桃的使用文档秋梨膏？ -~~使用文档 @Masterain98 正在制作中，很快就会和大家见面。~~ 你现在看到的就是 - -## 胡桃图标还会更新嘛？ -不会，我们持有胡桃图标的版权。 - -## 什么时候上微软商店？上微软商店是否不需要自己信任证书了？胡桃以后会在线更新嘛？ -会在所有功能完善后上架。不需要证书。上架后就可以支持在线更新了。 - -## 有考虑增加根据角色展示面板来计算伤害的功能吗？什么时候胡桃能当启动器，解锁帧率？这个无边框全屏的功能以后会不会支持？ -面板功能会在用户系统重构后进行开发，并且会在完成面板查询功能后实现启动游戏相关功能。启动参数包括在内。 - -## 胡桃数据库 和 Hutao 是否有关系？什么时候上胡桃数据库？ -~~胡桃数据库是 HutaoAPI 的一部分，包含了深渊相关的数据，HutaoAPI是胡桃使用的 RESTful API，同时面向其他应用的开发者开放，接入成本低，接入收益高。胡桃数据库将会在后续版本实装。~~ 已经实装 - -## 会把胡桃放到右下角任务栏吗？会考虑在角色里添加立绘吗？ -基本不会考虑。后续可能会考虑。 - -## 将来会有移动端吗？有考虑根据胡桃做个手机桌面小组件吗？胡桃以后支持插件吗？胡桃会有插件开发文档吗？ -短时间内不会考虑移动端。手机桌面小组件也基本不会考虑。不会再支持插件。同样也不会有插件文档。 - -## 离支持外服账号还有多远？会整合其他插件比如空荧酒馆这种嘛？ -Hoyolab 的相关支持需要其他开发者的帮助。由于技术栈的不同，很难整合。 - -## 有没有打算添加收费功能，还是说只靠捐助？ -~~由于服务器需要资费，与服务器存储相关的功能可能会进行收费。~~ Snap.Hutao等有关项目均为公益项目 - -## 是用爱发电吗？开发胡桃，是业余时间开发的吗？ -显然是。 diff --git a/docs/en/development-log/symposium2.md b/docs/en/development-log/symposium2.md deleted file mode 100644 index e45f755fb..000000000 --- a/docs/en/development-log/symposium2.md +++ /dev/null @@ -1,29 +0,0 @@ -# 第二期开发组座谈会 -复制自 [GitHub 讨论帖](https://github.com/DGP-Studio/Snap.Hutao/discussions/280)，总结于群讨论 - -## 现在成就导出的json格式也是UIGF的嘛 -A: UIAF - -## 能否适配祈愿系统数据UEFI旧版本的导入，和SG一样就可以 -A: 首先它叫 UIGF 格式，其次一直是适配的，只是SG的导入导出规则较为宽泛，如果您从始至终仅使用且正确使用了我们的产品，是不会出现导入导出异常的问题的 - -## 啥时候会有sg那种自动检查更新下载 -A: 自动更新不能在MSIX包上实现，检查更新会在后续版本推出。 - -## 我同一个设备上同时登陆SG，hutao会算作一个设备还是两个设备 -A: 两个设备,理论上每次重启胡桃后均相当于切换了设备 - -## 我感觉胡桃有些页面的加载需要很久，会影响使用体验，感觉胡桃的界面有点掉帧 -A: 深渊统计页面在1.2.6版本前确实存在加载慢的问题，已在新版本解决，如果有其他页面的卡顿问题，通常是因为你的显卡不够强劲，或者胡桃通过你的集显进行渲染。 - -## 属性统计经常加载不了 -A: 历史遗留问题，可以通过备份数据后删除 `userdata.db` 解决 - -## 自定义网页功能是否还有规划 -A: 别急 - -::: tip 微软方面的问题，我们无法解决 -* 有的时候使用管理员启动并不能获取到管理员权限，需要关掉后二次启动 -* 胡桃的图标尺寸可不可以改成像其他图标—样的小尺寸呀 -* 写入的注册表文件，在更新时遇安装问题，尝试所有修复无果，在卸载重装进行修复的过程中会否因卸载残留问题对重装造成影响 -::: \ No newline at end of file diff --git a/docs/en/features/README.md b/docs/en/features/README.md deleted file mode 100644 index a80aa0875..000000000 --- a/docs/en/features/README.md +++ /dev/null @@ -1,3 +0,0 @@ -# 功能列表 - - \ No newline at end of file diff --git a/docs/en/features/achievements.md b/docs/en/features/achievements.md deleted file mode 100644 index e2bc6dd5c..000000000 --- a/docs/en/features/achievements.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -headerDepth: 0 ---- - -# 成就管理 - -![](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 b/docs/en/features/character-data.md deleted file mode 100644 index fca8add4a..000000000 --- a/docs/en/features/character-data.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -headerDepth: 0 ---- - -# 属性统计 - -::: info -该功能需要你在胡桃工具箱中登录米游社帐号，登录方法可见[米游社多帐号切换](mhy-account-switch.md)文档 -::: - -属性统计，即主程序侧栏中的`我的角色`功能，可读取当前账号所拥有角色的具体数据，包括等级、命之座、武器、天赋、圣遗物等；并自动计算圣遗物评分和双爆评分 - -![属性统计示例图](https://img.alicdn.com/imgextra/i3/1797064093/O1CN016ZFB021g6du6Xvrbv_!!1797064093.png) - -## 同步角色信息 -### 从 Enka API 同步 - -::: info 同步特征 -- Enka API 同步游戏内角色橱窗中公开展示的角色的信息 - - 该同步方式包括圣遗物具体数据 - - 该同步方式一次最多包含8个角色 -::: - -- 在游戏中将角色橱窗设置为公开并添加**需要获取详细资料的角色**进入橱窗展示 - - 角色橱窗中最多可同时展示8个角色 -- 若您更换了橱窗内的角色或角色内的配置，需等待游戏内的数据同步至服务器 - - 开启功能和更换角色后需要最多5分钟同步数据 -- 进入胡桃工具箱的`我的角色`功能页面，在界面右上角点击`同步角色信息` -- 点击`从Enka API 同步` - -### 从 米游社我的角色 同步 -::: info 同步特征 -- 米游社我的角色 同步的数据来源于米游社数据 - - 该同步方式不包含圣遗物信息 - - 该同步方式一次可同步全部角色信息 -::: - -- 在胡桃工具箱的`我的角色`功能页面，在界面右上角点击`同步角色信息` -- 点击`从米游社我的角色同步` - - ### 从 米游社养成计算 同步 -::: info 同步特征 -- 米游社养成计算 同步的数据来源于米游社养成计算数据 - - 该同步方式包含角色天赋等级信息 - - 该同步方式一次可同步全部角色信息 - ::: - -- 在胡桃工具箱的`我的角色`功能页面，在界面右上角点击`同步角色信息` -- 点击`从米游社养成计算同步` - -## 将当前选定角色加入养成计算 - -- 在胡桃工具箱的`我的角色`功能页面，点击切换至需要加入养成计算的角色的资料页面 -- 点击界面右上方的"养成计算"按钮，输入目标等级 - - **已同步数据的角色**的当前角色等级、天赋等级会预填入其中，目标等级可自由更改 - -![rolescal](https://img.alicdn.com/imgextra/i2/1797064093/O1CN01Ju0wyK1g6du2L9Kw0_!!1797064093.png) - - - 添加完毕后，您可在"养成计划"功能中查看"已添加的养成目标" - -![image](https://img.alicdn.com/imgextra/i4/1797064093/O1CN01DgRS5n1g6du0Do41z_!!1797064093.png) - - - 关于养成计划功能的详细说明，请见[养成计划](develop-plan.md)文档 - -## 导出图片 -- 在我的角色页面中，你可以在选择一个角色的情况下点击右上角的`导出图片`按钮以将角色数据转化为图片形式，这将有助于你分享你的角色信息 -- 导出的图片储存在系统剪贴板中，你可以在合适的地方直接粘贴以获得该图片 -- 导出图片样式如下图所示 - -![sample-output-image](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01ah7JlQ1g6du4WrI0A_!!1797064093.png) diff --git a/docs/en/features/character-wiki.md b/docs/en/features/character-wiki.md deleted file mode 100644 index e1aeff453..000000000 --- a/docs/en/features/character-wiki.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -headerDepth: 0 ---- - -# 角色资料 - -![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 b/docs/en/features/daily-notes.md deleted file mode 100644 index 3ad9ac0c8..000000000 --- a/docs/en/features/daily-notes.md +++ /dev/null @@ -1,45 +0,0 @@ ---- -headerDepth: 0 ---- - -# 实时便笺 - -::: info -该功能需要你在胡桃工具箱中登录米游社帐号，登录方法可见[米游社多帐号切换](mhy-account-switch.md)文档 -::: -![live-data-tracking](https://img.alicdn.com/imgextra/i2/1797064093/O1CN01tiu6aD1g6duB3mtYQ_!!1797064093.png) - -## 添加角色 -- 点击`添加角色`按钮 -- 在弹出的`添加角色`浮窗中，选择您要添加的游戏角色，并单击其右侧的加号按钮 -- 此时您添加的游戏角色即可显示在实时便笺页面中 - - 实时便笺是间隔固定时间自动刷新的 - - 你可以点击窗口右上角的`通知设置`来设置查询的间隔时间 - - 如您需要立即刷新以获取实时的最新数值，请单击`立即刷新`按钮 - - 如出现"账号有风险，请前往米游社查看"字样的提示 - - 请参考[账号风险提示](../FAQ/mihoyo-risk-tip.md)文档 - -## 全局通知设置 -- 在窗口右上角点击`通知设置`可以修改实时便笺的全局设置，包括： - - 数据刷新间隔时间 - - 通知免打扰 - - 高优先度通知 - - 这将避免胡桃工具箱的通知被自动收入操作中心 - - 请注意，开启此设置可能会让您在日常使用电脑期间受到打扰 - -## 帐号独立设置 - -- 胡桃工具箱的实时便笺功能允许用户对每一个被监控的帐号给予不同的设置 -- 将鼠标停留在**需要被设置的**角色实时便笺的窗体上 -- 点击其窗体右上角出现的设置图案按钮，即可修改如下参数 - - 原粹树脂提醒阈值 - - 洞天宝钱提醒阈值 - - 启用参量质变仪提醒 - - 启用每日委托上限提醒 - - 启用探索派遣完成提醒 - - 启用在主页显示卡片 (未上线的新功能) -- 点击`保存`，即可保存您当前所设置的通知选项 - -## 删除角色 -- 将鼠标停留在需要被设置的角色实时便笺的窗体上 -- 点击其窗体右上角出现的移除标志按钮，即可移除该角色对应的实时便笺 diff --git a/docs/en/features/develop-plan.md b/docs/en/features/develop-plan.md deleted file mode 100644 index eaca54e12..000000000 --- a/docs/en/features/develop-plan.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -headerDepth: 0 ---- - -# 养成计划 - -![dev-plan](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01huh2t51g6du5DUiGt_!!1797064093.png) - -## 添加养成目标进入材料清单 - -### 基于 WIKI 资料添加 - -- 在胡桃工具箱的左侧栏目中，点击`角色资料`或`武器资料`功能 -- 在"胡桃工具箱"的整体界面右上部分，点击`养成计算`按钮 -- 在弹出的"添加到当前养成计划"的窗口中，填写角色需要计算的各项属性的起始等级以及目标等级 - - 基于 WIKI 资料添加的养成目标，默认初始值为1级 - -### 基于玩家数据添加 - -- 在"胡桃工具箱"的左侧栏目中，点击`我的角色`功能 -- 在选中角色后，点击右上角的`养成计算`按钮 -- 在弹出的"添加到当前养成计划"的窗口中，填写角色需要计算的各项属性的"起始等级"以及"目标等级" - - 基于玩家数据添加的养成目标，默认初始等级为玩家当前的角色等级 - - 请参考[属性统计](character-data#%E5%B0%86%E5%BD%93%E5%89%8D%E9%80%89%E5%AE%9A%E8%A7%92%E8%89%B2%E5%8A%A0%E5%85%A5%E5%85%BB%E6%88%90%E8%AE%A1%E7%AE%97)文档以获取更多信息 - - -## 背包物品 - -- 在"胡桃工具箱"的左侧栏目中，点击"养成计划"功能 -- 点击"背包物品"功能栏 -- 在"胡桃工具箱"的整体界面右上部分，点击"新建计划"按钮 -- 在弹出的"创建新的养成计划"的窗口中，填写需要创建的养成计划名称 - - 此处可勾选"绑定当前选中的账号角色" - - "新建计划"按钮左侧的下拉选项框，可**自行切换不同的养成计划** -- 点击下方的任意物品图标或数字区域，即可手动编辑该种材料的数目 - - 背包物品的具体材料信息，**对应于**其修改时，所切换至的养成计划 -- 在"胡桃工具箱"的整体界面右上部分，可点击"删除计划"按钮，将当前的养成计划删除 - - 在删除当前养成计划后，处于切换至该养成计划时，输入的背包物品信息将一同删除 - -## 功能说明 - -此功能尚在完善阶段，若您有建设性的建议，或发现了显著的问题，请按[此页面](../statements/bug-report.md)直接向我们反馈，感谢您的贡献！ - - diff --git a/docs/en/features/game-launcher.md b/docs/en/features/game-launcher.md deleted file mode 100644 index 7a9a70ff4..000000000 --- a/docs/en/features/game-launcher.md +++ /dev/null @@ -1,79 +0,0 @@ ---- -headerDepth: 0 ---- - -# 高级启动器 - -- 胡桃工具箱提供的高级启动器功能中通过多样的设置选项来允许用户以自定义设置启动游戏 -- 在设置完毕启动游戏所需的附加选项后，点击右下角的`启动游戏`按钮即可 -- 选择游戏路径时，请注意此处选择的应是游戏本身 - - 形如：`$\Genshin Impact\Genshin Impact Game\YuanShen.exe` - -::: tip 国际服支持 -高级启动器中除`切换服务器`以外的功能均支持国际服客户端 -::: - -## 切换服务器 - -::: warning -当前版本由于原神的部分更新，导致本功能可能无法成功从官服转换为B服，请等待进一步的更新 -::: - -- 在主界面点击左侧菜单栏进入`启动游戏`页面 -- 点击右侧选项中的服务器名称，选择要进入的服务器 - - 目前可选的服务器为`官方服|天空岛`与`渠道服|世界树` - - 若需切换至世界树服务器，则应将 [PCGameSDK.dll 文件](https://cloud.06dn.com/api/v3/file/source/179514/PCGameSDK.dll?sign=dbF4NoPqrSemUlbugtU71iYk1IZaW7JHQK9TbHMBTNg%3D%3A0)放入 Plugins 文件夹中 - - 该目录的路径形如"$:\Genshin Impact\Genshin Impact Game\YuanShen_Data\Plugins" - - 若下载到的`PCGameSDK.dll 文件`的文件名中有其他字符，建议将其重命名为 `PCGameSDK.dll`，以防止读取错误 - - 若需要切换不同的服务器，须确保`以管理员模式启动`胡桃工具箱 - -## 账号保存 -::: tip -1. 本功能所描述的帐号，特指当前原神所登录游戏账号的登录状态 -2. 获取当前原神的登录状态通常需要管理员权限，建议`使用管理员模式启动胡桃` -::: - -- 在主界面点击左侧菜单栏进入`启动游戏`标签 -- 点击`账号`功能中的`检测`按钮 -- 在弹出的`为账号命名`界面中，输入您要为此账号设置的名称，点击确认 -- 此时即可在`账号`功能下方自由选择您要切换的账号 - - 每个已保存的账号均为可点击选择的按钮 - - 在其右侧有三个按钮，分别为： - - `绑定当前用户角色`，即将您当前选择的米游社登录状态绑定至该账号中，点击该按钮后，对应的UID将出现在该账号自定义名称的下方 - - `重命名`，即修改当前选择账号的自定义名称 - - `删除`，即删除当前选择的账号 - -## 外观选项 - -::: warning -- 在当前的游戏版本中，有案例表明部分用户使用胡桃工具箱，选择**全屏模式**启动原神游戏，出现游戏无响应或卡顿的情况 - - 建议此部分用户使用无边框选项进行启动游戏 - ::: - -- 在主界面点击左侧菜单栏进入`启动游戏`标签 -- 在右侧的`外观`功能中，有四个选项： - - **全屏**，即选择启动游戏后的游戏界面是否设置为全屏 - - **无边框**，即选择启动游戏后的游戏界面是否设置为无边框窗口 - - **宽度**，即选择启动游戏后的游戏界面的宽度，例如`1920` - - **高度**，即选择启动游戏后的游戏界面的高度，例如`1080` - -## 解锁帧率上限 - -::: danger -- 请注意：此功能已明确标注为 `Dangerous Feature`，即**危险功能**，选择启用即代表您选择自行承担任意风险 -- 目前的版本，设置中无论是否超过60帧率的原神(含移动端)均会偶尔出现掉帧、卡顿甚至无响应、闪退等情况，这是原神在本版本中出现的普遍问题，并不是[Unlocker项目](https://github.com/DGP-Studio/Unlocker)的问题 -- [Unlocker项目](https://github.com/DGP-Studio/Unlocker)仅作用于 UnityPlayer 本身，即直接作用于 Unity3D 引擎，与游戏本体不发生直接关系，本质上与移动端中`120帧率`等设置无异，但您仍应谨慎使用并自行阅读[用户协议](https://docs.qq.com/doc/p/223a4e1f7241891e1208476a11927397549e9ea8) -::: - -- 使用`管理员模式`启动胡桃 -- 在主界面点击左侧菜单栏进入`启动游戏`标签 -- 在最下方可见 `Unlock frame rate limit` 选项 - - 在右侧点击`开启或关闭`按钮，所显示的 `Disable` 或 `Enable` 分别代表`已禁用`或`已启用`该功能 - - 在下方的 `Set frame rate` 选项中，可自由拖动拉杆，调整到您需要设置的最高帧率上限 - -- 会导致**解锁帧率上限失败**的因素： - - 解锁帧率上限，需要保持**胡桃工具箱**在开启状态 - - 游戏内未关闭**垂直同步**选项 - - 在显卡驱动中存在`最大帧速率`的设置 - - 在显卡驱动软件内存在未关闭的类似于`节能模式`的选项 - diff --git a/docs/en/features/hutao-API.md b/docs/en/features/hutao-API.md deleted file mode 100644 index 230ab9c06..000000000 --- a/docs/en/features/hutao-API.md +++ /dev/null @@ -1,58 +0,0 @@ ---- -headerDepth: 0 ---- - -# 胡桃数据库/深渊统计 - -胡桃工具箱提供两个主要的深境螺旋挑战统计的功能 -- 侧栏中的`深渊统计`是一个旨在通过统计并展示广大玩家深境螺旋挑战数据，来帮助对原神对战系统不熟悉玩家组建队伍、通关深渊、获取奖励的功能 -- 侧栏中的`深渊记录`是一个通过保存玩家每一期深境螺旋挑战数据来帮助个人玩家回顾游戏经历及个人数据收集的统计功能 - - 众多的玩家通过上传个人的`深渊记录`来形成胡桃数据库的`深渊统计`数据集 - -::: tabs -@tab 角色使用率 -![character-usage-rate](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01VNtgaU1g6du5Mh1Oo_!!1797064093.png) -@tab 角色出场率 -![character-held-n-usage-rate](https://img.alicdn.com/imgextra/i1/1797064093/O1CN01AKGIZn1g6du8k0Rhb_!!1797064093.png) -@tab 队伍出场次数 -![hutaoapi](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01ZRakBS1g6duBCh0c1_!!1797064093.png) -@tab 角色持有率 -![character-held-rate](https://img.alicdn.com/imgextra/i4/1797064093/O1CN01EUjFsJ1g6du8k0NYy_!!1797064093.png) -@tab 个人数据统计 -![personal-record-stat](https://img.alicdn.com/imgextra/i2/1797064093/O1CN01xMLXhn1g6du6lPUDD_!!1797064093.png) -@tab 个人数据详情 -![personal-record-details](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01xtWJfr1g6dtvjZLWZ_!!1797064093.png) -::: -## 查看深渊数据 - -::: warning -所有计算数据都基于**已上传至胡桃数据库中的玩家数据**，无法代表全部原神玩家的平均数据，数据仅做参考用途 -::: - -::: info 数据刷新周期 -1. 深境螺旋统计数据（角色使用率、角色出场率、队伍出场）在北京时间每月1日和16日的4点自动清理。 - - 点击界面右上角的信息按钮你可以查看当前实时已上传的总数据 -2. 同时，若用户在30天内没有重新上传记录以更新数据，则其的角色持有数据将被清理 -::: - -- 在主界面点击左侧菜单栏进入`深渊统计`页面 -- 点击`角色使用`以查看角色使用率数据 - - 角色使用率 = 角色在当前层数出场次数 / 持有该角色的玩家在该层数的总记录数 -- 点击`角色出场`以查看角色出场率数据 - - 角色出场率 = 角色在当前层数出场次数 / 当前层数总记录数 -- 点击`角色持有`以查看角色持有率数据[^first] - - 角色持有率[^second] = 所有拥有该角色的玩家数量 / 全部玩家数量 -- 点击`队伍出场`以查看队伍组合出场次数数据 - - 各种角色组队情况下出场次数的排名 - -## 上传深境螺旋数据 - -- 在主界面点击左侧菜单栏进入`深渊记录`功能页面 -- 点击右上角的`刷新数据`以确保胡桃工具箱客户端已经获取到最新的个人深境螺旋数据 -- 点击右上角的`上传数据`以上传你的深境螺旋数据 - - 这可能需要花费数秒，上传成功后你将会看到如下图的成功提示 - ![upload-hutaoapi](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01Zt7yQp1g6duBDALeX_!!1797064093.png) - -[^first]: 角色持有数据与深境螺旋记录独立 -[^second]: 只要拥有该角色，即使没有在深境螺旋中登场，也会被计入拥有的状态； -只要上传过深境螺旋记录，即会被计入全部玩家的数据中。 diff --git a/docs/en/features/hutao-settings.md b/docs/en/features/hutao-settings.md deleted file mode 100644 index dd3654482..000000000 --- a/docs/en/features/hutao-settings.md +++ /dev/null @@ -1,99 +0,0 @@ ---- -headerDepth: 0 ---- - -# 软件设置 - -::: info -- 以下内容将以胡桃工具箱内的设置功能的条目排列顺序为介绍顺序 -::: - -## 关于 胡桃 -- 胡桃工具箱的图标：您可以在胡桃的[首页](https://hut.ao/)查看它的原图 - - 该图像作品的作者为[LOFTER@夙夜](https://dieqi32894.lofter.com/post/4b58ce16_2b6b2d365)并由[DGP-Studio](https://github.com/DGP-Studio)后期处理后，授权使用 -- 胡桃的版本号 -- 设备ID -- 反馈 - - 点击`前往反馈`的按钮，即可跳转至相关页面 - -## 外观 -- 背景材质 - - 在此选项中，您可以更改背景的材质为： - - 亚克力 - - 云母 - - 变种云母 - - 每个背景材质被选中后，您可以即时查看更改后的效果 - -@slidestart auto - -## Windows 10 亚克力 -![win10-亚克力](https://img.alicdn.com/imgextra/i1/1797064093/O1CN01B7nKOj1g6du9bj3Nw_!!1797064093.png) - ---- - -## Windows 11 亚克力 -![win11-亚克力](https://img.alicdn.com/imgextra/i1/1797064093/O1CN01MXJZE61g6dtvtITxC_!!1797064093.jpg) - ---- - -## Windows 11 云母 -![win11-云母](https://img.alicdn.com/imgextra/i4/1797064093/O1CN01aW0iV71g6du5WAz9w_!!1797064093.jpg) - ---- - -## Windows 11 变种云母 -![win11-变种云母](https://img.alicdn.com/imgextra/i3/1797064093/O1CN010BwmBI1g6du9bi7C0_!!1797064093.jpg) - -@slideend - -## 祈愿记录 -- 在此条目中，您可以选择是否隐藏无记录的历史祈愿活动，即"没有祈愿记录的卡池" - -## 游戏 -- 游戏路径 - - 在此条目中，可以修改或设置您的游戏路径 - - 选择游戏路径时，请注意此处选择的应是游戏本身 - - 形如："$\Genshin Impact\Genshin Impact Game\YuanShen.exe" - -- 删除游戏内网页缓存 - - 若您在使用**祈愿记录功能**时，选择**使用"从缓存刷新"**，但**频繁提示**验证密钥过期，可以尝试此操作 - - 点击此选项内的`删除`按钮即可 - -## 测试功能 - -- 打开`数据`文件夹 - - 在此选项中点击"打开"按钮，即可打开包含"用户数据/日志/元数据"的文件夹 - - 尤其在您需要[反馈](https://hut.ao/statements/bug-report.html)或需要以[通用方式](https://hut.ao/FAQ/most-frequent-questions.html#%E5%85%B6%E4%BB%96%E9%97%AE%E9%A2%98%E7%9A%84%E9%80%9A%E7%94%A8%E6%8E%92%E6%9F%A5%E6%96%B9%E5%BC%8F)排查问题时，可以在此处快捷打开此文件夹，并进行进一步操作 - -- 打开`缓存`文件夹 - - 在此选项中点击"打开"按钮，即可打开包含"图片缓存"的文件夹 - - 在此文件夹内，存储了`胡桃工具箱`在运行期间产生的`图片缓存` - -- 米游社每日签到 - - 如何使用 - - 首先需要您在`米游社多账号切换`功能中，选中当前需要进行签到的米游社账号 - - 点击"打开签到对话框"按钮 - - 在每次需要对其他账号(若存在)进行米游社签到前，可能需要重新打开胡桃工具箱 - - 出现"签到对话框"长时间无反应，可尝试将当前米游社账号的登陆状态删除后重新在胡桃工具箱内登录，并将胡桃工具箱重启 - - 出现"签到对话框"内显示的内容出现异常，请将胡桃工具箱重启(此过程可多次进行) - - 若多次尝试依然失败，请按下述步骤进行反馈，以便于开发者对此功能尽快完善！ - - 由于此功能为测试功能，对于可能发生的签到失败情形，您可以按如下步骤进行反馈，以便于我们进行改进 - - 在"文件资源管理器"中，打开`%userprofile%/documents/hutao`目录 - - 保持该"文件资源管理器"处于打开状态 - - 重新启动"胡桃工具箱" - - 进入`设置` - - 点击`打开签到对话框`按钮 - - 弹出对话框后等待约5秒 - - 回到"文件资源管理器" - - 将此时的`log.db`文件复制到其他位置，并[随issue一同提交](https://github.com/DGP-Studio/Snap.Hutao/issues/new/choose) - - 该功能的正常使用界面： - ![米游社每日签到](https://img.alicdn.com/imgextra/i4/1797064093/O1CN01WCLbxe1g6duCXB6tc_!!1797064093.png) - -## 危险功能 -- 删除所有计划任务 - - 当你需要卸载胡桃工具箱时，可以使用此功能以删除胡桃工具箱的定时数据拉取任务 -- 删除所有用户 - - 此功能的作用是删除用户表的所有记录，用户修复特定的账号冲突问题 - - 点击`执行`按钮即可完成删除 - - 通常情况下，用户不需要使用此功能来删除用户表的信息 - diff --git a/docs/en/features/mhy-account-switch.md b/docs/en/features/mhy-account-switch.md deleted file mode 100644 index ffe26166b..000000000 --- a/docs/en/features/mhy-account-switch.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -headerDepth: 0 ---- - -# 米游社多帐号切换 - -::: tip -本文档所描述的帐号切换指的是用于获取游戏数据的米游社帐号，不是原神游戏内的帐号 -::: - -![多帐号管理样图](https://img.alicdn.com/imgextra/i4/1797064093/O1CN01tRs9NH1g6du1XgyDZ_!!1797064093.png) - -- 你可以在程序主界面的左下角，设置按钮的上方找到帐号菜单，以管理你在胡桃工具箱中登录的米游社帐号。在弹出的面板中你可以： - - 点击`登录米哈游通行证`按钮 - - 在弹出的内置浏览器中登录"米哈游通行证"账号 - - 您也可以通过点击`手动输入`按钮，直接输入米游社通行证 cookie 来添加您的帐号 - - 若您选择`手动输入`米游社 cookie，则该 cookie **必须包含 `Stoken` 字段** - - 手动获取含 `Stoken` 字段的 cookie 的方式可参考[使用第三方工具获取有 Stoken 的 cookie](/FAQ/get-stoken-cookie-from-the-third-party.md)文档 - - 在弹出的内置浏览器登陆成功后，点击右上角的"我已登陆"按钮 - - 完成后，您就可以在帐号管理面板切换已登录的米游社帐号了 - - 新添加米游社账号后，需在主界面左下角切换账号的功能中，手动点击一次新登录的账号，以将其设置为使用状态 - - 你可以在帐号管理菜单中复制对应帐号的 cookie 或从胡桃工具箱中删除该帐号 - -::: danger 安全提示 -- `Stoken` 是一个安全敏感的 cookie 字段，你不应该在任何云端或其它无法保证数据安全的设备上储存含有 `Stoken` 字段的 cookie。 -- 从胡桃工具箱中复制获得的 cookie 中包含该字段，请慎重考虑是否为接受 cookie 的一方提供 `Stoken` 字段。 -::: diff --git a/docs/en/features/weapon-wiki.md b/docs/en/features/weapon-wiki.md deleted file mode 100644 index a55929fc4..000000000 --- a/docs/en/features/weapon-wiki.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -headerDepth: 0 ---- - -# 武器资料 - -![weapon-wiki](https://img.alicdn.com/imgextra/i1/1797064093/O1CN01jbzlTH1g6du6KfSmF_!!1797064093.png) - -武器资料是胡桃工具箱中内置的用于查询各个武器的**外观、参数、精炼效果、推荐搭配**等数据的 Wiki - - -## 已包含的数据 - -- 武器列表 - - 使用列表左上角的按钮，可切换列表显示的方式：即"缩略图与名称"或"仅缩略图" - - 单击列表中的缩略图或名称，即可跳转到相应的介绍页面 -- 数据内容 - - 武器基本信息 - - 突破前后的武器图标对比 - - 对应武器的立绘展示 - - 武器的简介内容 - - **可切换**至对应等级的武器各项数值 - - 武器精炼信息 - - 对应精炼阶数的精炼属性 - - 根据胡桃数据库的统计信息而展示的**武器使用**的相关推荐 diff --git a/docs/en/features/wish-export.md b/docs/en/features/wish-export.md deleted file mode 100644 index a6c89014b..000000000 --- a/docs/en/features/wish-export.md +++ /dev/null @@ -1,79 +0,0 @@ ---- -headerDepth: 0 ---- - -# 祈愿记录 - -抽卡是原神的核心玩法之一，无论是出于纪念、炫耀的目的还是认真规划抽取计划，对历史抽卡进行统计分析都是非常重要的。 -但是原神官方只为玩家提供了半年的抽卡记录，这是很不友好的（~~但是他们还是统计了你一整年杀了多少提米的鸽子~~）。 - -因此，我们需要利用这半年的抽卡记录调取窗口，将抽卡记录转移到我们自己手中，这就是胡桃工具箱中祈愿记录导出功能的目的所在。 - -有关原神祈愿记录导出的技术原理，你可以参阅我们的[**祈愿系统与导出原理**](/FAQ/Gacha-system-and-export-principal.md)一文。 - -![祈愿导出](https://img.alicdn.com/imgextra/i3/1797064093/O1CN01B2DDii1g6du87XIIG_!!1797064093.png) - -::: note 原神抽卡记录的延迟性 -胡桃工具箱获取抽卡记录的来源也为米哈游服务器，因此短时间内刚刚结束的抽卡无法被获取。 -当你在游戏内抽卡历史记录中看到了最新的一批抽卡记录，则可以在胡桃中获取统计数据。 - -::: - -## 获取祈愿数据 -### 利用 Stoken 从服务器获取最新的祈愿记录 - -::: info 提示 -- 已登录的米游社帐号是使用 Stoken 刷新方法的前提，你可以参考[米游社多帐号切换](mhy-account-switch.md)一文在胡桃工具箱中登录你的帐号 -- Stoken 刷新方法暂不支持国际服 -::: - -- 在胡桃工具箱中确保你需要获取记录的米游社帐号已登录 -- 从左侧菜单栏进入`祈愿记录` -- 点击右上角的`刷新`，并点击`Stoken刷新` -- 等待读取完毕，即可查看最新的祈愿记录 - -### 从网页缓存获取最新的祈愿记录 - -- 从左侧菜单栏进入`祈愿记录` -- 启动游戏并登入游戏，打开游戏内的祈愿历史记录 -- 回到胡桃工具箱，点击`刷新`按钮，在刷新菜单中点击`网页缓存刷新` - -::: tip -若出现`网页缓存刷新`功能异常的情况： -- 从胡桃工具箱的`设置`中进入`缓存文件夹` -- 删除 `ImageCache` 文件夹 -::: - -### 通过输入 Url 获取祈愿记录 -- 如果你通过其它工具获取到了你祈愿历史记录的 Url，可以选择`手动输入Url`并根据提示操作 -- 但应注意此类 Url **具有时效性** - -### 对于全量刷新选项的补充说明 - -在默认情况下，胡桃工具箱会在匹配到本地已有记录的祈愿ID后停止导入。 -但如果你希望完整地获取原神服务器中所有的历史记录（即使它已经存在于你的本地祈愿记录中），你可以勾选`全量刷新`。 - -**不勾选`全量刷新`不会使你丢失祈愿数据，勾选`全量刷新`也不会让你的本地记录错误地额外记录一次相同的祈愿数据。** - -### 从其它祈愿导出程序导入祈愿数据 - -胡桃工具箱支持导入 `UIGF 数据格式` 的祈愿记录数据[^UIGF-Org] - -如果你希望导入这一类数据，可以： -- 启动胡桃工具箱，从左侧菜单栏进入`祈愿记录` -- 点击右上角的`导入` -- 选择你的 UIGF Json 数据文件 -- 根据界面确认导入数据 - -## 导出祈愿数据 - -胡桃工具箱支持导出 `UIGF数据格式` 的 Json 文件格式的祈愿记录数据 - -如果你希望导出祈愿数据，可以： -- 启动胡桃工具箱，从左侧菜单栏进入`祈愿记录` -- 选择您要导出的祈愿记录存档 -- 点击`导出`按钮 - - 在弹出的界面选择您需要将此导出的祈愿记录数据文件存放的位置，并点击`导出` -- 导出完成 - -[^UIGF-Org]: 统一标准化的原神数据格式由 [UIGF-Org](https://uigf.org/) 提供 \ No newline at end of file diff --git a/docs/en/markmap.md b/docs/en/markmap.md deleted file mode 100644 index 25f9b5048..000000000 --- a/docs/en/markmap.md +++ /dev/null @@ -1,23 +0,0 @@ -# 胡桃工具箱 - -## 米游社功能 - -- 活动公告 -- 帐号登录 -- 实时便笺 -- 深境螺旋 - - 我的深渊记录 - - 胡桃数据库 - 深渊数据 - -## 游戏性增强 - -- 高级启动器 -- 祈愿记录 -- 成就管理 - -## 养成计划 - -- 养成计算器 - - 属性统计 - - 角色 Wiki - - 武器 Wiki diff --git a/docs/en/project.md b/docs/en/project.md deleted file mode 100644 index 97c8918d3..000000000 --- a/docs/en/project.md +++ /dev/null @@ -1,38 +0,0 @@ -# 项目说明 - -胡桃工具箱是一个正在开发的程序，其将继承 Snap Genshin 中的功能，并添加更多的功能。 - -## 功能迁移 - -已经完成迁移的功能将会在本站文档中提供指导说明，功能迁移和开发进度可以参阅下方 - -- [x] 米游社公告首页 -- [x] 米游社帐号管理 -- [x] 游戏启动器 -- [x] 祈愿记录 -- [ ] WIKI - 日常材料 - - 将整合进养成计划 -- [ ] WIKI - 周常材料 - - 将整合进养成计划 -- [x] WIKI - 角色资料 -- [x] WIKI - 武器资料 -- [x] 成就统计 -- [x] 胡桃数据库 -- [x] 养成计算器 -- [x] 角色橱窗 -- [ ] 玩家查询 -- [ ] 自定义网页 - -## 新增功能 - -以下新功能计划被增加到胡桃工具箱中 -- [ ] 祈愿云端同步 -- [ ] 国际化支持 - - 等待微软修复上游问题 -- [ ] 国际服支持 - - [x] 游戏启动器 - - [ ] 服务器切换 - - [x] 祈愿记录 - -@include(../docs/development-log/symposium1.md) -@include(../docs/development-log/symposium2.md) \ No newline at end of file diff --git a/docs/en/quick-start.md b/docs/en/quick-start.md deleted file mode 100644 index 254235c7c..000000000 --- a/docs/en/quick-start.md +++ /dev/null @@ -1,60 +0,0 @@ ---- -pageClass: link-box -externalLinkIcon: false ---- -# 快速开始 - -::: tip -若您已下载或使用**胡桃工具箱**,即表示你已阅读并完全同意[用户使用协议与法律声明](/statements/privacy-notice.md) -::: - -## 最低系统要求 -|要求|规格| -|-|-| -|**最低可运行系统版本**|Windows 10.0.18362.0 [^first]| -|**推荐系统版本**|Windows 10.0.22621.0| -|可选组件|WebView2 Runtime| - - -## 下载胡桃工具箱 - -胡桃工具箱目前处于公开测试阶段。你可以 -- [从 GitHub 下载 ](https://github.com/DGP-Studio/Snap.Hutao/releases/) -- [从网盘下载](https://d.hut.ao) - -您下载的包含安装程序的压缩文件名称将与`Snap.Hutao_*_x64.zip`相似 - -## 安装胡桃工具箱 - -### 通用安装方式 -- 在系统设置中打开`开发者设置`界面，勾选 `开发人员模式` 和 `允许 PowerShell 脚本` （自行百度） -- 解压已下载的压缩包，找到`Install.ps1`文件，右键选择`使用PowerShell运行`，按照提示允许PowerShell执行操作即可 -- 安装完毕，`胡桃`将出现在您的`开始菜单`中 - -## 升级胡桃工具箱 - -- 解压你下载的最新版本压缩包 -- 重复 `安装胡桃工具箱` 的步骤 -- 若您安装失败或出现异常情况，可参考如下步骤 - - 先卸载已经安装的`胡桃工具箱` - - 重复 `安装胡桃工具箱` 的步骤 - -## 卸载胡桃工具箱 - -- 清除有关的任务计划 - - 打开胡桃，选择 **设置** 页签 - - 找到 **删除所有计划任务** 一栏中，点击右侧的 **执行** 按钮 - -- 卸载软件 - - 打开`开始菜单` - - 找到或搜索到`胡桃` - - 右键点击`胡桃`，并选择`卸载` - -- 清除有关的文件夹(若需完全卸载) - - 打开并删除该文件夹 `%userprofile%/Documents/Hutao` - -- 完全卸载完成 - -- **胡桃** 一直以尽可能快的速度 **逐步完善功能与用户体验** ，若您对胡桃工具箱有 **任何意见和建议**，都可以在[Github 的 Issues](https://github.com/DGP-Studio/Snap.Hutao/issues/new/choose)中向我们告知，开发者及团队将于**第一时间**回复，感谢您一直以来对原神开源工具的支持 - -[^first]: LTSC 和 LTSB 版本系统不在支持列表中，但它们可以在修改系统模块后使用胡桃工具箱。请联系你的 IT 管理员以获取支持。 \ No newline at end of file diff --git a/docs/en/statements/bug-report.md b/docs/en/statements/bug-report.md deleted file mode 100644 index 0f4e30492..000000000 --- a/docs/en/statements/bug-report.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -headerDepth: 0 ---- - -# 提交BUG报告 - -## 推荐方法 - -- 在你使用 Snap Hutao 时如果发现了可复现或不可自行修复的问题，可以通过提交问题反馈来告知开发者。 -- 在提交问题时，您应当尽可能地详细描述问题。如果有错误的截图，也应该提供。这有利于问题排查并加速问题修复。 - - 一个可以参考的非常正面的例子是 [DGP-Studio/Snap.Hutao/issues/100](https://github.com/DGP-Studio/Snap.Hutao/issues/100) -- 如果你有能力在代码层面修复该问题，也欢迎您直接在对应的项目中发起 PR。 - -### 客户端问题 - - 在提交问题前，请务必检查文档内是否已包含了你的问题 - - 首先需要确认您使用的版本是否为[最新版本](https://cloud.06dn.com/s/Ke6JhO) - - 您可以通过菜单栏中的“常见问题”分类找到这些文档 - - [快速解答](/FAQ/how-to.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) \ No newline at end of file diff --git a/docs/en/statements/privacy-notice.md b/docs/en/statements/privacy-notice.md deleted file mode 100644 index c6b3740da..000000000 --- a/docs/en/statements/privacy-notice.md +++ /dev/null @@ -1,19 +0,0 @@ -# 用户数据和隐私权益 -胡桃工具箱充分尊重用户的隐私，目前我们会按下方的说明使用用户的数据： - -- 使用胡桃后，在 **数据目录** 中以数据库文件的形式 - - **储存** - - 米游社 Cookie - - 胡桃的软件设置信息 - - 全部的用户数据 - -- 使用胡桃主程序时，胡桃会因开发和统计为目的**匿名化地**收集程序意外停止或出错时抛出的日志，包括： - - 用户设备 ID - - 错误与崩溃日志 - - 用户活跃数据统计信息 - -- 使用 `胡桃数据库` (`深渊记录`/`深渊统计`) 功能并选择`上传数据`时， - - 向 胡桃 API **上传** - - 用户的游戏 UID - - 用户的深境螺旋记录 - - 用户的角色信息及其装备的武器和圣遗物信息 diff --git a/docs/en/statements/tos.md b/docs/en/statements/tos.md deleted file mode 100644 index fce186f09..000000000 --- a/docs/en/statements/tos.md +++ /dev/null @@ -1,74 +0,0 @@ ---- -headerDepth: 0 ---- - -# 用户使用协议和法律声明 - -## 总则 - - 本"用户使用协议和法律声明"（以下简称"条款"或"使用协议"）适用于[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)"的团队整体及每个成员个人，即包含前述网站（https://github.com/DGP-Studio）中，[DGP-Studio开发团队](https://github.com/DGP-Studio)的全部成员。 -