diff --git a/docs/.vuepress/navbar/en.ts b/docs/.vuepress/navbar/en.ts index 4dabe4856..41a3de196 100644 --- a/docs/.vuepress/navbar/en.ts +++ b/docs/.vuepress/navbar/en.ts @@ -6,7 +6,7 @@ export const enNavbar = navbar([ { text: "Download", icon: "iconfont icon-install", - link: "https://apps.microsoft.com/store/detail/snap-hutao/9PH4NXJ2JN52", + link: "/en/quick-start.html", }, { text: "Community", @@ -14,18 +14,44 @@ export const enNavbar = navbar([ link: "/en/community", }, { - text: "Service Availability", + text: "Help & Support", icon: "iconfont icon-define", children: [ { - text: "UptimeRobot", - icon: "/images/202312/uptimerobot-logo.svg", - link: "https://status.hut.ao/", + text: "Update Log", + icon: "iconfont icon-update", + link: "/en/statements/update-log.html" }, { - text: "Uptime Kuma", - icon: "/images/202312/uptime-kuma.svg", - link: "https://status.snapgenshin.cn/status", + text: "Service Availability", + children: [ + { + text: "UptimeRobot", + icon: "/images/202312/uptimerobot-logo.svg", + link: "https://status.hut.ao/", + }, + { + text: "Uptime Kuma", + icon: "/images/202312/uptime-kuma.svg", + link: "https://status.snapgenshin.cn/status", + } + ] + }, + { + text: "Question & Feedback", + children:[ + { + text: "FAQ", + icon: "iconfont icon-ask", + link: "/en/advanced/FAQ.html" + }, + { + text: "Report Bug", + icon: "iconfont icon-debug", + link: "/en/statements/bug-report.html" + }, + + ] } ] }, diff --git a/docs/.vuepress/navbar/ru.ts b/docs/.vuepress/navbar/ru.ts index d1092fa5f..44019da65 100644 --- a/docs/.vuepress/navbar/ru.ts +++ b/docs/.vuepress/navbar/ru.ts @@ -6,7 +6,7 @@ export const ruNavbar = navbar([ { text: "Скачать", icon: "iconfont icon-install", - link: "https://apps.microsoft.com/store/detail/snap-hutao/9PH4NXJ2JN52", + link: "https://api.snapgenshin.com/patch/hutao/download", }, { text: "Сообщество", diff --git a/docs/.vuepress/navbar/zh.ts b/docs/.vuepress/navbar/zh.ts index 9d15170e3..9af601182 100644 --- a/docs/.vuepress/navbar/zh.ts +++ b/docs/.vuepress/navbar/zh.ts @@ -6,26 +6,52 @@ export const zhNavbar = navbar([ { text: "下载", icon: "iconfont icon-install", - link: "https://apps.microsoft.com/store/detail/snap-hutao/9PH4NXJ2JN52", + link: "/zh/quick-start.html", }, { - text: "加入用户社区", + text: "加入社区", icon: "iconfont icon-community", link: "/zh/community", }, { - text: "服务可用性", + text: "帮助与支持", icon: "iconfont icon-define", children: [ { - text: "UptimeRobot", - icon: "/images/202312/uptimerobot-logo.svg", - link: "https://status.hut.ao/", + text: "更新日志", + icon: "iconfont icon-update", + link: "/zh/statements/update-log.html" }, { - text: "Uptime Kuma", - icon: "/images/202312/uptime-kuma.svg", - link: "https://status.snapgenshin.cn/status", + text: "服务可用性", + children: [ + { + text: "UptimeRobot", + icon: "/images/202312/uptimerobot-logo.svg", + link: "https://status.hut.ao/", + }, + { + text: "Uptime Kuma", + icon: "/images/202312/uptime-kuma.svg", + link: "https://status.snapgenshin.cn/status", + } + ] + }, + { + text: "问题与反馈", + children:[ + { + text: "常见问题", + icon: "iconfont icon-ask", + link: "/zh/advanced/FAQ.html" + }, + { + text: "反馈问题", + icon: "iconfont icon-debug", + link: "/zh/statements/bug-report.html" + }, + + ] } ] }, diff --git a/docs/.vuepress/public/images/202312/C_sharp.svg b/docs/.vuepress/public/images/202312/C_sharp.svg new file mode 100644 index 000000000..c023aa9be --- /dev/null +++ b/docs/.vuepress/public/images/202312/C_sharp.svg @@ -0,0 +1,10 @@ + + + + + + + + + + \ No newline at end of file diff --git a/docs/.vuepress/public/images/202312/Vue.js.svg b/docs/.vuepress/public/images/202312/Vue.js.svg new file mode 100644 index 000000000..a1d285eb2 --- /dev/null +++ b/docs/.vuepress/public/images/202312/Vue.js.svg @@ -0,0 +1,2 @@ + + diff --git a/docs/.vuepress/public/images/202312/community.svg b/docs/.vuepress/public/images/202312/community.svg new file mode 100644 index 000000000..aa8f7f689 --- /dev/null +++ b/docs/.vuepress/public/images/202312/community.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/.vuepress/public/images/202312/discord.svg b/docs/.vuepress/public/images/202312/discord.svg new file mode 100644 index 000000000..22a2770c2 --- /dev/null +++ b/docs/.vuepress/public/images/202312/discord.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/.vuepress/public/images/202312/documents.svg b/docs/.vuepress/public/images/202312/documents.svg new file mode 100644 index 000000000..47c13c9c6 --- /dev/null +++ b/docs/.vuepress/public/images/202312/documents.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/.vuepress/public/images/202312/github-mark.svg b/docs/.vuepress/public/images/202312/github-mark.svg new file mode 100644 index 000000000..37fa923df --- /dev/null +++ b/docs/.vuepress/public/images/202312/github-mark.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/.vuepress/public/images/202312/jihulab.svg b/docs/.vuepress/public/images/202312/jihulab.svg new file mode 100644 index 000000000..064f186ea --- /dev/null +++ b/docs/.vuepress/public/images/202312/jihulab.svg @@ -0,0 +1,55 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/docs/.vuepress/public/images/202312/tencent.svg b/docs/.vuepress/public/images/202312/tencent.svg new file mode 100644 index 000000000..6fd800e57 --- /dev/null +++ b/docs/.vuepress/public/images/202312/tencent.svg @@ -0,0 +1,69 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/.vuepress/public/images/202312/video-editing.svg b/docs/.vuepress/public/images/202312/video-editing.svg new file mode 100644 index 000000000..1f69d37cd --- /dev/null +++ b/docs/.vuepress/public/images/202312/video-editing.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/.vuepress/theme.ts b/docs/.vuepress/theme.ts index a799efc74..1495d29c2 100644 --- a/docs/.vuepress/theme.ts +++ b/docs/.vuepress/theme.ts @@ -93,17 +93,9 @@ export default hopeTheme({ }, components: { - components: ["Badge", "BiliBili", "VPCard"], + components: ["Badge", "BiliBili", "VPCard", "VPBanner"], rootComponents: { notice: [ - { - path: "/zh/", - title: "加入我们", - content: - "如果你有软件开发，网页前端，文档管理或视频创作的经验，并希望将其施展于胡桃工具箱项目中，欢迎加入开发团队", - fullscreen: false, - showOnce: false, - }, ], }, }, diff --git a/docs/en/README.md b/docs/en/README.md index 5290ed4cc..bb5e45803 100644 --- a/docs/en/README.md +++ b/docs/en/README.md @@ -13,11 +13,9 @@ head: - name: twitter:image:src content: https://repository-images.githubusercontent.com/482734649/eb0f81d6-29a8-4d3c-8012-d85475cd89ee actions: - - text: Download - link: https://apps.microsoft.com/store/detail/snap-hutao/9PH4NXJ2JN52 - type: primary - text: Quick Start link: quick-start.html + type: primary - text: Document link: menu.html - text: Project diff --git a/docs/en/advanced/known-issue.md b/docs/en/advanced/known-issue.md index edcac1f7c..d094777bf 100644 --- a/docs/en/advanced/known-issue.md +++ b/docs/en/advanced/known-issue.md @@ -14,5 +14,5 @@ You can view all issues on [GitHub Issue page](https://github.com/DGP-Studio/Sna | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- | | [All Opened BUG Issues](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+label%3ABUG+is%3Aopen) | Labeled with `BUG` | | [All Opened Feature Request Issues](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aopen+is%3Aissue+label%3A%E5%8A%9F%E8%83%BD) | Labeled with `功能` (Feature) | -| [Fixed and Resolved Issues](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+label%3A%E5%B7%B2%E4%BF%AE%E5%A4%8D) | Labeled with `已修复` (Fixed) | +| [Fixed and Resolved Issues](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+label%3A%E5%B7%B2%E5%AE%8C%E6%88%90) | Labeled with `已完成` (Fixed) | | [Issues will be Fixed in Next Version](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+label%3A%E7%AD%89%E5%BE%85%E5%8F%91%E5%B8%83) | Labeled with `等待发布` (Ready for Publish) | diff --git a/docs/en/community.md b/docs/en/community.md index d4765c287..0114bbb38 100644 --- a/docs/en/community.md +++ b/docs/en/community.md @@ -10,19 +10,33 @@ order: 8 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. - - -## GitHub Discussion - -[Snap.Hutao Discussion](https://github.com/DGP-Studio/Snap.Hutao/discussions) - -## QQ Group (CN) - -- [Snap Hutao](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=DmW_LDX35YEr1CQZwjZ6x4JYP03soai2&authKey=z3PzXsuYlaPTm%2FW7TyE0o9KNz7H6LA%2BTEZ4mK2BE9%2Fcz0HhH3s1qgbydciAmrGeg&noverify=0&group_code=910780153) -- [_Snap Developer Open Discussion Group_](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=XJPjE6ffuYPkZmXvujdP1ZDY2BqL8RDg&authKey=YHBYvW4KmPUpPjGwYwGduG7ZELhFIkd9QxLHuwBFmm4UvQH1ThWiv%2FKPgeckiqt4&noverify=0&group_code=982424236) - - General tech talk, not Snap Hutao Project development group - - The Dev group requires some basic tech knowledge - -## Discord - -Invite link：[https://discord.gg/Yb8bykUKp](https://discord.gg/Yb8bykaUKp) +
+ + + + +
diff --git a/docs/en/development/contribute.md b/docs/en/development/contribute.md index fc6519726..6a83f2391 100644 --- a/docs/en/development/contribute.md +++ b/docs/en/development/contribute.md @@ -2,7 +2,7 @@ category: [open source, development] tag: ["development", "GitHub"] icon: iconfont icon-code -order: 2 +order: 3 --- # Contribute Your Code @@ -36,8 +36,6 @@ You can find all [unsolved opened issues](https://github.com/DGP-Studio/Snap.Hut ## Test Binary Package -Once the code in updated in `develop` and `main` branches, an Azure Pipeline CI script will build the latest code to `Snap Hutao Alpha` package. Once the package is built, it will be released on [GitHub Release page](https://github.com/DGP-Studio/Snap.Hutao/releases) as a pre-released package. +Once the code in updated in `develop` and `main` branches, a GitHub actions script will build the latest code to `Snap Hutao Alpha` package. You can find all build records in alpha actions pipeline. -You need to install [Snap.Hutao.CI.cer](https://github.com/DGP-Studio/Snap.Hutao/releases/download/2023.10.3.1/Snap.Hutao.CI.cer) certificate to your local machine, and then install the msix package in the release. - -\*If the latest release does not contain attached file, that means package is still in uploading process. +You need to install [Snap Hutao CA certificate](https://github.com/DGP-Automation/Hutao-Auto-Release/releases/download/certificate-ca/DGP_Studio_CA.crt) as `Trusted Root Certification Authorities` to allow Alpha versions be installed. diff --git a/docs/en/development/join.md b/docs/en/development/join.md new file mode 100644 index 000000000..566bc8847 --- /dev/null +++ b/docs/en/development/join.md @@ -0,0 +1,78 @@ +--- +category: [open source, development] +tag: ["develop", "collaborate", "community"] +icon: iconfont icon-group +order: 1 +--- + +# Join the Develop Team + +If you have one of the following experiences and are interested in joining the Snap Hutao development team to improve this project and get in touch with more Genshin Impact open source projects, welcome to join us! + + + + + + + + diff --git a/docs/en/development/platform.md b/docs/en/development/platform.md index 6823928b3..3a91f52b7 100644 --- a/docs/en/development/platform.md +++ b/docs/en/development/platform.md @@ -2,7 +2,7 @@ category: [open source, development] tag: [open source, Hutao Database, Spiral Abyss Database, Enka, UIGF, Open data] icon: iconfont icon-vscode -order: 1 +order: 2 --- # Hutao Open Platform diff --git a/docs/en/i18n.md b/docs/en/i18n.md index 2205e7354..b4b73e6bb 100644 --- a/docs/en/i18n.md +++ b/docs/en/i18n.md @@ -14,29 +14,28 @@ Snap Hutao Project features were originally based on the China server, but we ar - Snap Hutao - [x] Localization framework - - [ ] Client translation + - [x] Client translation - Process: ![Crowdin](https://badges.crowdin.net/snap-hutao/localized.svg) - [x] English - [x] Traditional Chinese - - [x] Korean + - [x] Korean (in progress) - [x] Japanese (in progress) - - [x] Indonesian (in progress by [NatsumeAoii](https://github.com/NatsumeAoii)) - - [ ] Russian - - [x] Internation/China server conversion - - [ ] International server account switch - - [x] International server wish history export - - [x] International server character stat - - [ ] HoYoLab login - - [ ] International server Abyss recrod - - [ ] Daily Notes - - [ ] Multilingual in-game announcements + - [x] Indonesian (in progress; contributed by [NatsumeAoii](https://github.com/NatsumeAoii)) + - [x] Russian (in progress; contributed by [QweRezOn](https://github.com/QweRezOn)) + - [x] Oversea/China server conversion + - [ ] Oversea server account switch + - [x] Oversea server wish history export + - [x] Oversea server character stat + - [x] HoYoLab login + - [x] International server Abyss recrod + - [x] Daily Notes + - [x] Multilingual in-game announcements - Snao Hutao Docs - [x] Localization framework - - [ ] Web translation - - Process: - - [ ] English - - [x] Home page - - [ ] User documentation + - [x] Web translation process: + - [x] English + - [x] Indonesian (in progress; contributed by [NatsumeAoii](https://github.com/NatsumeAoii)) + - [x] Russian (in progress; contributed by [QweRezOn](https://github.com/QweRezOn)) ## Engage our Localization diff --git a/docs/en/project.md b/docs/en/project.md index 01931b2c2..10daa11f0 100644 --- a/docs/en/project.md +++ b/docs/en/project.md @@ -13,13 +13,26 @@ the gaming experience for desktop players. By combining existing official resour development team, it provides a complete and useful set of tools without the need to rely on mobile devices. Snap Hutao does not take any destructive modification to the game client to ensure the security of the toolkit. +## Genshin Impact's Desktop Issues Snap Hutao Solved + +| Feature | Mobile | Desktop | Snap Hutao Solution | +| :--------------------------: | -------------------------------------- | ----------------------------------------------- | ------------------------------------------------------------------------ | +| **High Framerate Limit** | iOS/iPadOS supports 120FPS by official | Only up to 60FPS | [Advanced Game Launcher - Framerate unlocker](features/game-launcher.md) | +| **Game Account Switch** | All signed in account will be kept | Will not be recorded after sign out | [Advanced Game Launcher - Account switch](features/game-launcher.md) | +| **Daily Checkin** | MiHoYo BBS client | Web check-in only available for oversea servers | [Account Panel - check-in](features/mhy-account-switch.md) | +| **Realtime Notes** | MiHoYo BBS client | N/A | [Realtime Notes](features/real-time-notes.md) | +| **Expedition Notifications** | Pushed by game client | N/A | [Realtime Notes Notification](features/real-time-notes.md) | +| **Spiral Abyss data lookup** | MiHoYo BBS client | Web lookup only available for oversea servers | [Spiral Abyuss](features/hutao-API.md) | +| **Develop Plan** | MiHoYo BBS client | Only available for oversea servers | [Develop Plan](features/develop-plan.md) | +| **Discord Activity** | N/A | Only available for oversea servers | [Advanced Game Launcher - Discord Activity](features/game-launcher.md) | + ## Project Resource - [GitHub code repository](https://github.com/DGP-Studio/Snap.Hutao) - [Crowdin localization translation](https://translate.hut.ao/) - [Snap Hutao Community](community.md) -## Feature Overview +## Full Feature Overview - [In-game announcement & event countdown](features/dashboard.md) - [MiHoYo BBS multi account login](features/mhy-account-switch.md) diff --git a/docs/en/quick-start.md b/docs/en/quick-start.md index d54b1d712..c81ed5add 100644 --- a/docs/en/quick-start.md +++ b/docs/en/quick-start.md @@ -24,7 +24,7 @@ Follow this document's instruction, you can set up your Snap Hutao quickly. **Unsupported OS Versions**： -1. LTSC and LTSB versions does not include Microsoft Store, so they are not supported +1. LTSC and LTSB versions are using legacy version of MSIX Core, so they are not supported 2. Windows 10 Build 19041 supports installation, but some feature may have unexpected errors due to Windows kernel issues, so Snap Hutao cannot solve them 3. Issues happens in Windows Insider preview versions will not be solved @@ -33,70 +33,58 @@ Follow this document's instruction, you can set up your Snap Hutao quickly. ### New Installation -**Whatever installation method you used, package source and registration are always handled by Microsoft Store.** +You can use MSIX package to install Snap Hutao, you can find pakcage from the following source. -::: tabs -@tab Microsoft Store - - +
+ + + + +
-Microsoft Store Link：[Snap Hutao](https://apps.microsoft.com/store/detail/snap-hutao/9PH4NXJ2JN52) +--- -On Windows 10 and Windows 11 you can click the button above to download Snap Hutao. +If you are interested in making the Snap Hutao project better through your own efforts, consider [join us](development/join.md)! -@tab winget +### Upgrade to the Latest Version from MS Store Versions -- Launch PowerShell -- Execute command `winget install "Snap Hutao"` -- Follow the prompt to allow the installation - - If failed install, receive error of missing dependency or stuck at framework installation stage, please refer to - [Install Dependency Manually](advanced/dependency.md) document +If you installed a Microsoft Store version of Snap Hutao (version 1.4.11 to 1.8.4), you need to uninstall it before the new installation -@tab GitHub +> For details of this change, please refer to [Explanation of Breaking Changes in Version 1.9.0](blog/version-1-9-0-breaking-changes.md) -- Visit the [latest release page](https://github.com/DGP-Studio/Snap.Hutao/releases/latest/) of Snap Hutao -- Download MSIX Package -- Run the MSIX package directly to perform installation - - If failed install, receive error of missing dependency or stuck at framework installation stage, please refer to - [Install Dependency Manually](advanced/dependency.md) document - -::: - -### Upgrade to MS Store Version from Side-load Versions - -If you installed a side-load version of Snap Hutao (version 1.4.10 and older), you need to uninstall it before the new installation - -- Uninstall the side-load version with our [uninstallation instruction document](advanced/uninstall.html) +- Uninstall the Microsoft Store version with our [uninstallation instruction document](advanced/uninstall.html) - Your data will not lose as long as you don't delete data directory manually - Follow the method above to install the Microsoft Store version application ### Update Snap Hutao -**You can use any of the update methods, whatever method you used when you installed Snap Hutao. They don't need to be consistent, as Microsoft Store is the only source of packages.** -::: tabs -@tab Microsoft +If no special instruction is given, you can download and install latest MSIX package to update your Snap Hutao. -- Launch Microsoft Store -- Click on Library in the bottom left to see all apps you have installed -- Click `Get updates` on the top right and your application will be updated - -If you still don't receive the update, you may enter the Snap Hutao [detail page](<(https://apps.microsoft.com/store/detail/snap-hutao/9PH4NXJ2JN52)>) in Microsoft Store, to allow the store to fetch the latest metadata. - -@tab winget - -- Launch PowerShell -- Execute command `winget upgrade "Snap Hutao"` -- Follow the prompt to allow the upgrade - -@tab GitHub - -- Visit the [latest release page](https://github.com/DGP-Studio/Snap.Hutao/releases/latest/) of Snap Hutao -- Download MSIX Package -- Run the MSIX package directly to perform upgrade - -::: +Starting from 1.9.0 version, Snap Hutao has embedded update module to notify the updates. ## Install Optional Components diff --git a/docs/en/star-request.md b/docs/en/star-request.md index e5b17c6d8..6f3b45aa8 100644 --- a/docs/en/star-request.md +++ b/docs/en/star-request.md @@ -3,7 +3,6 @@ - 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 your network ![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) diff --git a/docs/en/statements/update-log.md b/docs/en/statements/update-log.md index 73cf1c6e5..12d24d447 100644 --- a/docs/en/statements/update-log.md +++ b/docs/en/statements/update-log.md @@ -4,6 +4,7 @@ category: icon: iconfont icon-update order: 1 comment: false +externalLinkIcon: false --- # Update Logs @@ -26,12 +27,15 @@ You can read the article [Explanation of Breaking Changes in Version 1.9.0](../b - Added QR code login method for miHoYo in the user panel [#870](https://github.com/DGP-Studio/Snap.Hutao/issues/870) - The client now automatically detects network status and displays the results in the settings page [#1116](https://github.com/DGP-Studio/Snap.Hutao/pull/1161) - Added an option in the game launcher to start Genshin Impact in touch mode [#1173](https://github.com/DGP-Studio/Snap.Hutao/issues/1173) + - Add option to change in-game announcement source in the settings page, now you may select oversea severs as the source and display announcements with same lanague of your Snap Hutao [#1112](https://github.com/DGP-Studio/Snap.Hutao/issues/1112) + - Only available when there is valid regular expression in Crowdin translation (Simplified Chinese, Traditional Chinese and English are supported now) - Added an option in the settings to enable the console. Users can now get more error prompts when troubleshooting by enabling this option. - Introduced a completely new logic for software updates. - **Bug Fixes 🔨** - Fixed an issue with miHoYo API returning a `5003` error when fetching character information [#1060](https://github.com/DGP-Studio/Snap.Hutao/issues/1060) + - Fixed the issue that Game Launcher cannot unlock framerate limit in Genshin Impact 4.3 version [#1190](https://github.com/DGP-Studio/Snap.Hutao/issues/1190) - Fixed an issue with incorrect countdown data for miHoYo announcements in specific situations. - Fixed incorrect PowerShell statements. @@ -44,7 +48,9 @@ You can read the article [Explanation of Breaking Changes in Version 1.9.0](../b - Optimized the settings page interface; users can now view the size of data and cache directories generated by Snap Hutao in the settings. - **Localization 🌏** - - Added Indonesian language option in the client, thanks to [@NatsumeAoii](https://github.com/NatsumeAoii) for providing the translation [#1188](https://github.com/DGP-Studio/Snap.Hutao/issues/1188) + - Added Indonesian language option in the client, thanks to contribution by [@NatsumeAoii](https://github.com/NatsumeAoii) [#1188](https://github.com/DGP-Studio/Snap.Hutao/issues/1188) + - Added Russian language option in the client, thanks to contribution by [@QweRezOn](https://github.com/QweRezOn) + - Improved client localization string character coverage [#1198](https://github.com/DGP-Studio/Snap.Hutao/issues/1198) - Updated translations for existing languages. ## 1.8.5 diff --git a/docs/zh/README.md b/docs/zh/README.md index 4f001c459..30b910add 100644 --- a/docs/zh/README.md +++ b/docs/zh/README.md @@ -13,11 +13,9 @@ head: - name: twitter:image:src content: https://repository-images.githubusercontent.com/482734649/eb0f81d6-29a8-4d3c-8012-d85475cd89ee actions: - - text: 下载 - link: https://apps.microsoft.com/store/detail/snap-hutao/9PH4NXJ2JN52 - type: primary - - text: 快速开始 + - text: 开始使用 link: quick-start.html + type: primary - text: 文档 link: menu.html - text: 项目介绍 diff --git a/docs/zh/advanced/known-issue.md b/docs/zh/advanced/known-issue.md index 27eadc429..cb5e54ffc 100644 --- a/docs/zh/advanced/known-issue.md +++ b/docs/zh/advanced/known-issue.md @@ -14,5 +14,5 @@ redirectFrom: /advanced/known-issue.html | ----------------------------------------------------------------------------------------------------------------------------------- | ------------------- | | [全部未关闭的 BUG 议题](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+label%3ABUG+is%3Aopen) | 包含标签 `BUG` | | [全部未关闭的功能提案](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aopen+is%3Aissue+label%3A%E5%8A%9F%E8%83%BD) | 包含标签 `功能` | -| [已修复或已实现的功能](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+label%3A%E5%B7%B2%E4%BF%AE%E5%A4%8D) | 包含标签 `已修复` | +| [已修复或已实现的功能](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+label%3A%E5%B7%B2%E5%AE%8C%E6%88%90) | 包含标签 `已完成` | | [将在下一版本修复的问题](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+label%3A%E7%AD%89%E5%BE%85%E5%8F%91%E5%B8%83) | 包含标签 `等待发布` | diff --git a/docs/zh/community.md b/docs/zh/community.md index 42eeb2e39..5b6e76423 100644 --- a/docs/zh/community.md +++ b/docs/zh/community.md @@ -11,24 +11,33 @@ order: 8 作为开源软件，社区动力是胡桃工具箱生态的重要组成部分，你可以在通过下面的方式加入到胡桃的用户社区中。 - - -## GitHub 讨论 - -[Snap.Hutao Discussion](https://github.com/DGP-Studio/Snap.Hutao/discussions) - -## QQ 群 - -- [Snap Hutao 用户群 910780153](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=DmW_LDX35YEr1CQZwjZ6x4JYP03soai2&authKey=z3PzXsuYlaPTm%2FW7TyE0o9KNz7H6LA%2BTEZ4mK2BE9%2Fcz0HhH3s1qgbydciAmrGeg&noverify=0&group_code=910780153) - - 胡桃一般用户群 - - 若入群问题为最新版本号则请输入三位版本号（如 `1.2.3`）而不是四位版本号（如 `1.2.3.0`） -- [Snap Hutao 公告群 531960040](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=uxqsxPJPB_jOVbMFOzZv5LcDyIF2HAiu&authKey=Deo2c2ZhmqSAQ%2BGUL0ItD7bYtYG5blYxQor25BXoCcaCGllZYtZ4eDNwZ3yZz8gH&noverify=0&group_code=531960040) - - 全体禁言，仅发送公告 -- [_Snap 开发交流群_](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=XJPjE6ffuYPkZmXvujdP1ZDY2BqL8RDg&authKey=YHBYvW4KmPUpPjGwYwGduG7ZELhFIkd9QxLHuwBFmm4UvQH1ThWiv%2FKPgeckiqt4&noverify=0&group_code=982424236) - - 广泛的技术交流群，并非胡桃工具箱开发群 - - 开发群对申请者的技术水平有一定要求 - - 如果你想要[加入开发团队](project.md)，请在入群验证时提及 - -## Discord - -邀请链接：[https://discord.gg/Yb8bykaUKp](https://discord.gg/Yb8bykaUKp) +
+ + + + +
diff --git a/docs/zh/development/contribute.md b/docs/zh/development/contribute.md index a91156f16..02ef4c7bd 100644 --- a/docs/zh/development/contribute.md +++ b/docs/zh/development/contribute.md @@ -2,7 +2,7 @@ category: [开源, 开发] tag: ["开发", "GitHub"] icon: iconfont icon-code -order: 2 +order: 3 --- # 贡献你的代码 @@ -36,10 +36,7 @@ order: 2 ## 测试打包程序 -一旦你的代码被合并进 `develop` 和 `main` 分支，一个 Azure Pipeline CI 流水线脚本将运行起来以构建所在分支的最新代码，并以 `Snap Hutao Alpha` 命名。 -当该测试包打包完成后，它将被以 `pre-release` 的形式发布在 [GitHub 发布页面](https://github.com/DGP-Studio/Snap.Hutao/releases)上。 +一旦你的代码被合并进 `develop` 和 `main` 分支，一个 GitHub Actions 脚本将运行起来以构建所在分支的最新代码，并以 `Snap Hutao Alpha` 命名。 +你可以在 alpha 流水线中找到全部的编译记录。 -你需要安装 [Snap.Hutao.CI.cer](https://github.com/DGP-Studio/Snap.Hutao/releases/download/2023.10.3.1/Snap.Hutao.CI.cer) -证书到你的本地设备上以允许你安装测试版安装包。 - -\*如果在最新的发布中没有包含程序安装包附件，则意味着它仍然处于上传过程中。 +你需要以`受信任的根证书颁发机构`添加[DGP Studio CA 证书](https://github.com/DGP-Automation/Hutao-Auto-Release/releases/download/certificate-ca/DGP_Studio_CA.crt)到你的本地设备上以允许操作系统安装测试版安装包。 diff --git a/docs/zh/development/join.md b/docs/zh/development/join.md new file mode 100644 index 000000000..dc1e9134e --- /dev/null +++ b/docs/zh/development/join.md @@ -0,0 +1,83 @@ +--- +category: [开源, 开发] +tag: ["开发", "团队协作", "社区"] +icon: iconfont icon-group +order: 1 +--- + +# 加入我们 + +如果你有以下经验之一且有兴趣加入 Snap Hutao 开发团队以完善这个项目，并接触到更多的原神开源项目，欢迎加入我们！ + + + + + + + + diff --git a/docs/zh/development/platform.md b/docs/zh/development/platform.md index 2854d1c3a..64656fe46 100644 --- a/docs/zh/development/platform.md +++ b/docs/zh/development/platform.md @@ -2,7 +2,7 @@ category: [开源, 开发] tag: [开源, 胡桃数据库, 深渊数据库, Enka, UIGF, 数据开放] icon: iconfont icon-vscode -order: 1 +order: 2 --- # 胡桃开放平台 diff --git a/docs/zh/i18n.md b/docs/zh/i18n.md index e5cfddd82..e23dcbdb5 100644 --- a/docs/zh/i18n.md +++ b/docs/zh/i18n.md @@ -15,29 +15,28 @@ Snap Hutao 虽然基于原神国服提供功能，但项目也有意提升国际 - Snap Hutao 主项目 - [x] 语言本土化技术框架 - - [ ] 客户端翻译 + - [x] 客户端翻译 - 进度：![Crowdin](https://badges.crowdin.net/snap-hutao/localized.svg) - [x] 英语 - [x] 繁体中文 - [x] 韩语 - [x] 日语 （进行中） - [x] 印尼语 (进行中 作者：[NatsumeAoii](https://github.com/NatsumeAoii)) - - [ ] 俄语 + - [x] 俄语 （进行中 作者：[QweRezOn](https://github.com/QweRezOn)） - [x] 国际服/国服客户端转换 - - [ ] 国际服游戏帐号切换 + - [ ] 国际服游戏账号切换 - [x] 国际服祈愿记录导出 - [x] 国际服角色属性统计 - [x] HoYoLAB 登录支持 - [x] 国际服深渊记录获取 - [x] 实时便笺 - - [ ] 多语言游戏公告 + - [x] 多语言游戏公告 - Snap Hutao 文档 - [x] 语言本土化技术框架 - - [ ] 网页翻译 - - 进度： - - [ ] 英语 - - [x] 主页 - - [ ] 用户文档 + - [x] 网页翻译进度： + - [x] 英语 + - [x] 印尼语 (进行中 作者：[NatsumeAoii](https://github.com/NatsumeAoii)) + - [x] 俄语 （进行中 作者：[QweRezOn](https://github.com/QweRezOn)） ## 参与国际化 diff --git a/docs/zh/project.md b/docs/zh/project.md index 743ac623b..ed6da8545 100644 --- a/docs/zh/project.md +++ b/docs/zh/project.md @@ -12,18 +12,18 @@ order: 6 胡桃工具箱是一款以 MIT 协议开源的原神工具箱，专为现代化 Windows 平台设计，旨在改善桌面端玩家的游戏体验。通过将既有的官方资源与开发团队设计的全新 功能相结合，它提供了一套完整且实用的工具集，且无需依赖任何移动设备。它不对游戏客户端进行任何破坏性修改以确保工具箱的安全性。 -## 加入我们 +## 胡桃能解决的原神桌面端缺陷 -如果你有以下经验之一且有兴趣加入 Snap Hutao 开发团队，并接触到更多的原神开源项目，你可以通过加入 QQ 群[_Snap 开发交流群_](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=XJPjE6ffuYPkZmXvujdP1ZDY2BqL8RDg&authKey=YHBYvW4KmPUpPjGwYwGduG7ZELhFIkd9QxLHuwBFmm4UvQH1ThWiv%2FKPgeckiqt4&noverify=0&group_code=982424236)来联系我们。 - -- [**C# .NET 开发**](./development/contribute.md) - - 包括服务端开发和桌面端开发 -- **网页前端** - - Snap Hutao 项目有意开发一个基于胡桃 API 的深渊数据库网页，并包含基础的胡桃账号管理功能 -- Python 开发 - - 服务端和自动化脚本 -- 文档编写 -- 视频制作和编辑 +| 功能 | 移动端 | 桌面端 | 胡桃的方案 | +| :------------------: | ------------------------ | ------------------------ | ---------------------------------------------------------- | +| **游戏高帧率** | iOS/iPadOS官方支持120FPS | 最高仅60FPS | [高级启动器 - 帧率解锁](features/game-launcher.md) | +| **游戏账号切换** | 已登录的账号会被记录 | 注销后账号不会被记录 | [高级启动器 - 账号切换](features/game-launcher.md) | +| **每日签到** | 米游社客户端 | 仅国际服用户可在网页签到 | [账号面板 - 签到](features/mhy-account-switch.md) | +| **实时便笺** | 米游社客户端 | 无 | [实时便笺](features/real-time-notes.md) | +| **派遣完成通知推送** | 通过移动端游戏推送通知 | 无 | [实时便笺推送消息](features/real-time-notes.md) | +| **深渊数据查询** | 米游社客户端 | 仅国际服用户可在网页查询 | [深境螺旋](features/hutao-API.md) | +| **养成计划** | 米游社客户端 | 仅国际服用户可在网页使用 | [养成计划](features/develop-plan.md) | +| **Discord 状态** | 无 | 国际服客户端可用 | [高级启动器 - Discord Activity](features/game-launcher.md) | ## 项目资源 @@ -31,7 +31,7 @@ order: 6 - [Crowdin 本地化翻译](https://translate.hut.ao/) - [Snap Hutao 用户社区](community.md) -## 功能一览 +## 完整功能一览 - [游戏内公告及倒计时](features/dashboard.md) - [米哈游论坛多账号登录支持](features/mhy-account-switch.md) diff --git a/docs/zh/quick-start.md b/docs/zh/quick-start.md index b0bf46b98..570334972 100644 --- a/docs/zh/quick-start.md +++ b/docs/zh/quick-start.md @@ -23,7 +23,7 @@ order: 5 **不支持的系统版本**： -1. LTSC 和 LTSB 版本系统由于不包含微软商店，不在支持列表中 +1. LTSC 和 LTSB 版本系统由于不包含足够新版本的 MSIX Core，故不支持安装 2. Windows 10 Build 19041 亦可以安装， 但部分功能会因内核问题无法使用，故该版本下的胡桃工具箱问题将不会被处理 3. Windows Insider 预览版本的问题不会被处理 @@ -31,38 +31,48 @@ order: 5 ### 全新安装 -**无论使用何种安装方式，应用包来源和注册授权都由微软商店管理** +使用 MSIX 安装包即可安装 Snap Hutao，你可以从以下源获取到安装包 -::: tabs -@tab 使用微软商店安装 - - +
+ + + + +
-微软商店链接：[Snap Hutao](https://apps.microsoft.com/store/detail/snap-hutao/9PH4NXJ2JN52) +--- -在 Windows 10 和 Windows 11 下你可以直接点击上面的按钮来下载胡桃工具箱 +如果你有兴趣通过你的力量让 Snap Hutao 项目变得更好，欢迎[加入我们](development/join.md)！ -@tab 使用 winget 安装 +### 从微软商店版升级至最新版 -- 启动 PowerShell -- 执行命令 `winget install "Snap Hutao"` -- 根据提示允许安装 - - 如果安装失败或显示缺少依赖包，或卡在安装框架阶段，请参考[手动安装依赖项](advanced/dependency.md)一文 +> 对于这项改变，你可以阅读 [1.9.0 版本重大改变详解](blog/version-1-9-0-breaking-changes.md) 来获得详细信息 -@tab 使用 MSIX 安装包安装 - -- 访问胡桃工具箱[最新发布页面](https://github.com/DGP-Studio/Snap.Hutao/releases/latest/) -- 下载 MSIX 应用包 -- 直接运行 MSIX 应用包以执行安装 - - 如果安装失败或显示缺少依赖包，或卡在安装框架阶段，请参考[手动安装依赖项](advanced/dependency.md)一文 - -::: - -### 从侧载版升级至商店版 - -如果你之前安装了 Snap Hutao 侧载版（1.4.10及更旧的版本）则需要先卸载旧版本再进行全新安装 +如果你已经安装了 Snap Hutao 微软商店版（版本号介于1.4.11和1.8.5之间）则需要先卸载旧版本再进行全新安装 - 按照文档提供的[卸载方法](advanced/uninstall.html)卸载侧载版应用 - 只要不手动删除数据目录，你的数据不会受到影响 @@ -70,29 +80,9 @@ theme="auto"> ### 更新胡桃工具箱 -**无论你使用何种方式安装了应用，你都可以选择任意的方式去更新它，不必选择和安装时一样的方法，因为微软商店是应用包唯一来源** -::: tabs -@tab 使用微软商店更新 +如没有特殊声明，则你可以通过安装最新版 MSIX 安装包来升级程序。 -- 启动微软商店 -- 点击左下角的库，查看到你目前已安装的全部应用 -- 点击界面右上角的获取更新，你的应用将会被更新 - -若点击获取更新后胡桃仍然没有获取到更新，则可以进入`Snap Hutao`的[商店详情页面](<(https://apps.microsoft.com/store/detail/snap-hutao/9PH4NXJ2JN52)>)，等待信息加载完成来获取更新 - -@tab 使用 winget 更新 - -- 启动 PowerShell -- 执行命令 `winget upgrade "Snap Hutao"` -- 根据提示允许安装 - -@tab 使用 MSIX 安装包更新 - -- 访问胡桃工具箱[最新发布页面](https://github.com/DGP-Studio/Snap.Hutao/releases/latest/) -- 下载 MSIX 应用包 -- 直接运行 MSIX 应用包以执行安装 - -::: +1.9.0版本起，Snap Hutao 将内置升级提示功能以提醒你获取更新包。 ## 安装可选组件 diff --git a/docs/zh/star-request.md b/docs/zh/star-request.md index 0ffaf3679..e52024a18 100644 --- a/docs/zh/star-request.md +++ b/docs/zh/star-request.md @@ -3,7 +3,6 @@ - 为我们在 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) diff --git a/docs/zh/statements/update-log.md b/docs/zh/statements/update-log.md index 9ed83770b..9cca08b52 100644 --- a/docs/zh/statements/update-log.md +++ b/docs/zh/statements/update-log.md @@ -4,11 +4,12 @@ icon: iconfont icon-update order: 1 redirectFrom: /statements/update-log.html comment: false +externalLinkIcon: false --- # 更新日志 -## 1.9.0 +## 1.9.0 ::: important 重大改变 @@ -25,10 +26,13 @@ Snap Hutao 在近期获得了 SignPath 基金会的赞助的代码签名证书 - 在用户面板中增加了米游社的扫码登录方法 [#870](https://github.com/DGP-Studio/Snap.Hutao/issues/870) - 客户端新增了自动检测网络状态，并将结果显示在设置页面中 [#1116](https://github.com/DGP-Studio/Snap.Hutao/pull/1161) - 在游戏启动器中新增了以触屏模式启动原神的选项 [#1173](https://github.com/DGP-Studio/Snap.Hutao/issues/1173) + - 在设置中增加了修改游戏公告源的选项，现在用户可以选择国际服公告并根据客户端语言显示对应语言的公告 [#1112](https://github.com/DGP-Studio/Snap.Hutao/issues/1112) + - 仅当 Crowdin 翻译库中有对应语言的正则表达式时才可以正确显示公告（目前已确认支持简体中文、繁体中文和英语） - 在设置中新增了启用控制台的选项，用户现在可以通过启用该选项在排查问题时获得更多的错误提示 - 添加了全新的软件更新处理逻辑 - 修复 🔨 - 修复了米游社接口获取角色信息产生`5003`错误的问题 [#1060](https://github.com/DGP-Studio/Snap.Hutao/issues/1060) + - 修复了游戏启动器中帧率解锁功能在游戏4.3版本下失效的问题 [#1190](https://github.com/DGP-Studio/Snap.Hutao/issues/1190) - 修复了特定情况下米游社公告倒计时数据错误的问题 - 修复了错误的 PowerShell 语句 - 优化 ✨ @@ -39,6 +43,8 @@ Snap Hutao 在近期获得了 SignPath 基金会的赞助的代码签名证书 - 优化了设置页界面，用户现在可以在设置中查看 Snap Hutao 产生的数据和缓存目录大小 - 本地化 🌏 - 客户端增加了印尼语选项，感谢 [@NatsumeAoii](https://github.com/NatsumeAoii)提供的翻译 [#1188](https://github.com/DGP-Studio/Snap.Hutao/issues/1188) + - 客户端增加了俄语翻译，感谢 [@QweRezOn](https://github.com/QweRezOn) 提供的翻译 + - 完善了客户端本地化字串符覆盖 [#1198](https://github.com/DGP-Studio/Snap.Hutao/issues/1198) - 更新了现有语言的翻译 ## 1.8.5