mirror of
https://jihulab.com/DGP-Studio/Snap.Hutao.Docs.git
synced 2025-11-19 21:16:31 +08:00
Merge pull request #57 from DGP-Studio/next-patch
Document Periodic Update
This commit is contained in:
Masterain
GitHub
5
.github/ISSUE_TEMPLATE/config.yml
vendored
Normal file
5
.github/ISSUE_TEMPLATE/config.yml
vendored
Normal file
@@ -0,0 +1,5 @@
|
||||
blank_issues_enabled: false
|
||||
contact_links:
|
||||
- name: 提交 Snap Hutao 客户端问题报告 / Submit Snap Hutao Client Issues
|
||||
url: https://github.com/DGP-Studio/Snap.Hutao/issues/new/choose
|
||||
about: 客户端问题请点击此处跳转至主库提交 / Please click here to redirect to main repository for client issues
|
||||
@@ -2,20 +2,20 @@ import { navbar } from "vuepress-theme-hope";
|
||||
|
||||
export const enNavbar = navbar([
|
||||
"/en/",
|
||||
{ text: "Document", icon: "article", link: "/en/menu.html" },
|
||||
{ text: "Document", icon: "iconfont icon-article", link: "/en/menu.html" },
|
||||
{
|
||||
text: "Download",
|
||||
icon: "install",
|
||||
icon: "iconfont icon-install",
|
||||
link: "https://apps.microsoft.com/store/detail/snap-hutao/9PH4NXJ2JN52",
|
||||
},
|
||||
{
|
||||
text: "Community",
|
||||
icon: "community",
|
||||
icon: "iconfont icon-community",
|
||||
link: "/en/community",
|
||||
},
|
||||
{
|
||||
text: "Service Availability",
|
||||
icon: "define",
|
||||
icon: "iconfont icon-define",
|
||||
link: "https://status.hut.ao/"
|
||||
}
|
||||
]);
|
||||
|
||||
@@ -2,20 +2,20 @@ import { navbar } from "vuepress-theme-hope";
|
||||
|
||||
export const zhNavbar = navbar([
|
||||
"/zh/",
|
||||
{ text: "文档", icon: "article", link: "/zh/menu.html" },
|
||||
{ text: "文档", icon: "iconfont icon-article", link: "/zh/menu.html" },
|
||||
{
|
||||
text: "下载",
|
||||
icon: "install",
|
||||
icon: "iconfont icon-install",
|
||||
link: "https://apps.microsoft.com/store/detail/snap-hutao/9PH4NXJ2JN52",
|
||||
},
|
||||
{
|
||||
text: "加入社区讨论",
|
||||
icon: "community",
|
||||
icon: "iconfont icon-community",
|
||||
link: "/zh/community",
|
||||
},
|
||||
{
|
||||
text: "服务可用性",
|
||||
icon: "define",
|
||||
icon: "iconfont icon-define",
|
||||
link: "https://status.hut.ao/"
|
||||
}
|
||||
]);
|
||||
|
||||
@@ -7,19 +7,25 @@ export const enSidebar = sidebar({
|
||||
"i18n",
|
||||
"quick-start",
|
||||
{
|
||||
icon: "read",
|
||||
icon: "iconfont icon-read",
|
||||
text: "Features",
|
||||
prefix: "features/",
|
||||
children: "structure",
|
||||
},
|
||||
{
|
||||
icon: "advance",
|
||||
icon: "iconfont icon-advance",
|
||||
text: "Advanced",
|
||||
prefix: "advanced/",
|
||||
children: "structure",
|
||||
},
|
||||
{
|
||||
icon: "article",
|
||||
icon: "iconfont icon-github",
|
||||
text: "Open Source Development",
|
||||
prefix: "development/",
|
||||
children: "structure"
|
||||
},
|
||||
{
|
||||
icon: "iconfont icon-article",
|
||||
text: "Statements",
|
||||
prefix: "statements/",
|
||||
children: "structure",
|
||||
|
||||
@@ -7,19 +7,25 @@ export const zhSidebar = sidebar({
|
||||
"i18n",
|
||||
"quick-start",
|
||||
{
|
||||
icon: "read",
|
||||
icon: "iconfont icon-read",
|
||||
text: "功能指南",
|
||||
prefix: "features/",
|
||||
children: "structure",
|
||||
},
|
||||
{
|
||||
icon: "advance",
|
||||
icon: "iconfont icon-advance",
|
||||
text: "高级",
|
||||
prefix: "advanced/",
|
||||
children: "structure",
|
||||
},
|
||||
{
|
||||
icon: "article",
|
||||
icon: "iconfont icon-github",
|
||||
text: "开源开发",
|
||||
prefix: "development/",
|
||||
children: "structure"
|
||||
},
|
||||
{
|
||||
icon: "iconfont icon-article",
|
||||
text: "声明和公告",
|
||||
prefix: "statements/",
|
||||
children: "structure",
|
||||
|
||||
@@ -10,7 +10,10 @@ export default hopeTheme({
|
||||
url: "https://github.com/DGP-Studio",
|
||||
},
|
||||
|
||||
iconAssets: "iconfont",
|
||||
iconAssets: [
|
||||
"iconfont",
|
||||
"https://at.alicdn.com/t/c/font_3861247_nm7gjy97qqd.css"
|
||||
],
|
||||
|
||||
logo: "https://img.alicdn.com/imgextra/i4/1797064093/O1CN01vK3m2w1g6duwt8quS_!!1797064093.png",
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
home: true
|
||||
icon: home
|
||||
icon: iconfont icon-home
|
||||
title: Home
|
||||
heroImage: https://img.alicdn.com/imgextra/i4/1797064093/O1CN01oaGvKE1g6dut0pICS_!!1797064093.png_.webp
|
||||
heroAlt: Snap Hutao
|
||||
@@ -26,13 +26,13 @@ highlights:
|
||||
bgImageDark: /images/202309/head-back2.png
|
||||
highlights:
|
||||
- title: You Control Your Data
|
||||
icon: computer
|
||||
icon: iconfont icon-computer
|
||||
details: Your data is stored in your local device, does not rely on any cloud service or third-party platform, you have freedom control your data
|
||||
- title: We Protect Your Data
|
||||
icon: lock
|
||||
icon: iconfont icon-lock
|
||||
details: Your data can be backed up to Snap Hutao Cloud, you never lose data when you are on a new device
|
||||
- title: Community Guards your Program
|
||||
icon: anonymous
|
||||
icon: iconfont icon-anonymous
|
||||
details: Snap Hutao is open-sourced on GitHub with MIT license, we welcome community members to review and contribute to our code. The software is listed in Microsoft Store, which passes Microsoft's security review
|
||||
|
||||
- header: All-in-one Toolbox
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
headerDepth: 2
|
||||
icon: ask
|
||||
icon: iconfont icon-ask
|
||||
category:
|
||||
- FAQ
|
||||
order: 1
|
||||
|
||||
@@ -2,8 +2,9 @@
|
||||
headerDepth: 0
|
||||
category:
|
||||
- FAQ
|
||||
icon: read
|
||||
icon: iconfont icon-read
|
||||
order: 8
|
||||
comment: false
|
||||
---
|
||||
|
||||
# 祈愿系统与导出原理
|
||||
|
||||
@@ -1,7 +1,8 @@
|
||||
---
|
||||
category: [FAQ, dependency, installation]
|
||||
icon: structure
|
||||
icon: iconfont icon-structure
|
||||
order: 6
|
||||
comment: false
|
||||
---
|
||||
|
||||
# Install Dependency Manually
|
||||
|
||||
@@ -1,9 +1,10 @@
|
||||
---
|
||||
headerDepth: 2
|
||||
icon: debug
|
||||
icon: iconfont icon-warn
|
||||
category: [FAQ]
|
||||
order: 2
|
||||
redirectFrom: /en/advanced/mihoyo-risk-tip.html
|
||||
comment: false
|
||||
---
|
||||
|
||||
# Common Program Exceptions
|
||||
@@ -16,7 +17,6 @@ This document covers solutions of **foreseeable client error**
|
||||
- Hint: `Unable to set registry key without enabling long path`
|
||||
- Issue source: Windows long path limit is set to be limited at 256 characters by default
|
||||
- Solution: Download [EnableLongPaths.zip](https://d.hut.ao/d/tools/EnableLongPaths.zip), unzip it and run `.reg` file
|
||||
as administrator
|
||||
|
||||
## Return Code: -10001
|
||||
|
||||
|
||||
@@ -2,8 +2,9 @@
|
||||
category:
|
||||
- FAQ
|
||||
- 第三方工具
|
||||
icon: read
|
||||
icon: iconfont icon-read
|
||||
order: 7
|
||||
comment: false
|
||||
---
|
||||
|
||||
# 使用第三方工具获取有 Stoken 的 cookie
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
headerDepth: 2
|
||||
icon: tool
|
||||
icon: iconfont icon-tool
|
||||
category:
|
||||
- FAQ
|
||||
order: 3
|
||||
@@ -10,4 +10,4 @@ order: 3
|
||||
|
||||
This document records known issues that **need to be fixed**.
|
||||
|
||||
You can view latest version of opened BUG report on [https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+is%3Aopen+label%3ABUG](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+is%3Aopen+label%3ABUG)
|
||||
You can view latest version of opened BUG report on [https://github.com/DGP-Studio/Snap.Hutao/issues](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+label%3ABUG+)
|
||||
|
||||
@@ -1,8 +1,9 @@
|
||||
---
|
||||
category:
|
||||
- FAQ
|
||||
icon: delete
|
||||
icon: iconfont icon-delete
|
||||
order: 9
|
||||
comment: false
|
||||
---
|
||||
|
||||
# Uninstall Snap Hutao
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
headerDepth: 0
|
||||
category: [Announcement]
|
||||
comment: false
|
||||
icon: community
|
||||
icon: iconfont icon-community
|
||||
order: 8
|
||||
---
|
||||
|
||||
@@ -12,18 +12,17 @@ As open-source software, community power is an important part of the ecology of
|
||||
|
||||
<!-- @include: star-request.md -->
|
||||
|
||||
## GitHub Discussion
|
||||
## <HopeIcon icon="iconfont icon-github" size="1.5rem" /> GitHub Discussion
|
||||
|
||||
[Snap.Hutao Discussion](https://github.com/DGP-Studio/Snap.Hutao/discussions)
|
||||
|
||||
## QQ Group (CN)
|
||||
## <HopeIcon icon="iconfont icon-qq" size="1.5rem" color="rgb(0,126,198)" /> 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_
|
||||
- [_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
|
||||
- You can join via [https://dev-group.hut.ao](https://dev-group.hut.ao) if you are interested to join
|
||||
|
||||
## Discord
|
||||
## <HopeIcon icon="iconfont icon-discord1" size="1.5rem" color="rgb(115,139,216)" /> Discord
|
||||
|
||||
Invite link：[https://discord.gg/Yb8bykUKp](https://discord.gg/Yb8bykaUKp)
|
||||
|
||||
@@ -3,8 +3,10 @@ headerDepth: 0
|
||||
comment: false
|
||||
index: false
|
||||
dir:
|
||||
text: Development
|
||||
text: Open Source Development
|
||||
order: 3
|
||||
---
|
||||
|
||||
# Development
|
||||
# Open Source Development
|
||||
|
||||
<AutoCatalog />
|
||||
|
||||
36
docs/en/development/contribute.md
Normal file
36
docs/en/development/contribute.md
Normal file
@@ -0,0 +1,36 @@
|
||||
---
|
||||
category: [open source, development]
|
||||
tag: ["development", "GitHub"]
|
||||
icon: iconfont icon-code
|
||||
order: 2
|
||||
---
|
||||
|
||||
# Contribute Your Code
|
||||
|
||||
Snap Hutao is using C# and .NET Framework to develop both client and server. If you are willing to contribute your code
|
||||
to the project, please read the following guidelines.
|
||||
|
||||
You can find all [unsolved opened issues](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+is%3Aopen+-label%3A%E5%B7%B2%E4%BF%AE%E5%A4%8D+) on GitHub
|
||||
|
||||
## <HopeIcon icon="iconfont icon-visual-studio" size="1.5rem" color="rgb(193,142,241)" /> Setup Snap.Hutao Project
|
||||
|
||||
1. Download and install [Visual Studio 2022 Community](https://visualstudio.microsoft.com/downloads/)
|
||||
2. Open Visual Studio Installer to complete Visual Studio installation
|
||||
- You need to install `.NET desktop development`, `Desktop development with C++` and `Universal Windows Platform development` components
|
||||
3. Install `Single-project MSIX Packaging Tools for VS 2022` provided by Microsoft in Visual Studio marketplace
|
||||
4. Use git to clone the project `https://github.com/DGP-Studio/Snap.Hutao.git` to your local device
|
||||
5. Switch git branch to `develop`
|
||||
6. Open project solution with your Visual Studio and then you are ready to go
|
||||
|
||||
## <HopeIcon icon="iconfont icon-pull-request" size="1.5rem" /> Start Pull Request
|
||||
|
||||
- All code-related changes from authors' own branches are only allowed be merged to `develop` branch
|
||||
- Please use [keywords](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/using-keywords-in-issues-and-pull-requests) to link your PR or commits with issues, so issues can be automatically closed once commits are merged into `main` branch.
|
||||
|
||||
## <HopeIcon icon="iconfont icon-build-package" size="1.5rem" /> 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.
|
||||
|
||||
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.
|
||||
@@ -1,6 +1,7 @@
|
||||
---
|
||||
category: [open source, development]
|
||||
icon: vscode
|
||||
tag: [open source, Hutao Database, Spiral Abyss Database, Enka, UIGF, Open data]
|
||||
icon: iconfont icon-vscode
|
||||
order: 1
|
||||
---
|
||||
|
||||
@@ -23,8 +24,8 @@ Open-source software authors can use the Hutao API to retrieve data from the Hut
|
||||
Developers who gain access to the Hutao API also receive full privileges to the Hutao Cloud feature
|
||||
within the Snap Hutao as a benefit.
|
||||
|
||||
Developers can apply for access by submitting their information through the Hutao API Open Platform at
|
||||
[https://homa.snapgenshin.com/](https://homa.snapgenshin.com/)
|
||||
Developers can apply for access by submitting their information through the Hutao API Open Platform
|
||||
at [homa.snapgenshin.com](https://homa.snapgenshin.com/)
|
||||
|
||||
## Enka API with China Acceleration
|
||||
|
||||
@@ -35,9 +36,7 @@ the stability of Enka Network's functionality in the region is compromised.
|
||||
To ensure a smooth user experience for Snap Hutao users in China, the development team has utilized Enka Network's data
|
||||
for the development of the [My Characters](../features/character-data.md) feature and established a proxy server.
|
||||
|
||||
If you are a developer of open-source Genshin Impact tools and require this functionality, you can fill out the
|
||||
[form](https://docs.google.com/forms/d/e/1FAIpQLSefnrYz41NZ2hSG0xC6OoBsIiM_mDdVLS7lsUg9thHmA1h8qw/viewform?usp=sf_link)
|
||||
to apply for the usage of our maintained proxy service.
|
||||
Developers can ask for access in Snap Hutao development group chat or discord group from administrator.
|
||||
|
||||
## UIGF Interchangeable Game Data Format
|
||||
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
headerDepth: 0
|
||||
category: [Announcement, i18n]
|
||||
comment: false
|
||||
icon: network
|
||||
icon: iconfont icon-network
|
||||
order: 7
|
||||
---
|
||||
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
headerDepth: 0
|
||||
category: [announcement, project, features]
|
||||
comment: false
|
||||
icon: workingDirectory
|
||||
icon: iconfont icon-workingDirectory
|
||||
order: 6
|
||||
---
|
||||
|
||||
|
||||
@@ -5,7 +5,7 @@ category:
|
||||
- Feature
|
||||
- Tutorial
|
||||
comment: false
|
||||
icon: play
|
||||
icon: iconfont icon-play
|
||||
order: 5
|
||||
---
|
||||
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
headerDepth: 0
|
||||
category:
|
||||
- Announcement
|
||||
icon: debug
|
||||
icon: iconfont icon-debug
|
||||
comment: false
|
||||
order: 2
|
||||
---
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
headerDepth: 0
|
||||
category:
|
||||
- Announcement
|
||||
icon: license
|
||||
icon: iconfont icon-license
|
||||
order: 3
|
||||
---
|
||||
|
||||
|
||||
@@ -4,7 +4,7 @@ category:
|
||||
- Announcement
|
||||
comment: false
|
||||
editLink: false
|
||||
icon: license
|
||||
icon: iconfont icon-license
|
||||
order: 4
|
||||
---
|
||||
|
||||
|
||||
@@ -1,13 +1,24 @@
|
||||
---
|
||||
category:
|
||||
- Announcement
|
||||
icon: update
|
||||
icon: iconfont icon-update
|
||||
order: 1
|
||||
comment: false
|
||||
---
|
||||
|
||||
# Update Logs
|
||||
|
||||
## 1.7.7 <Badge text="latest" type="tip" />
|
||||
## 1.7.9 <Badge text="latest" type="tip" />
|
||||
|
||||
- Fix
|
||||
- Fixed an issue that prevented the program from launching with the correct window size after the monitor
|
||||
resolution was changed after exiting the program
|
||||
- Fixed login issue of MiHoYo BBS [#1005](https://github.com/DGP-Studio/Snap.Hutao/issues/1005)
|
||||
- Fixed HoYoverse login issue [#1007](https://github.com/DGP-Studio/Snap.Hutao/issues/1007)
|
||||
- Fixed crash log upload issue in version 1.7.7
|
||||
- Fixed UI display issue on Team Lineup page in Spiral Abyss feature [#1008](https://github.com/DGP-Studio/Snap.Hutao/issues/1008)
|
||||
|
||||
## 1.7.7
|
||||
|
||||
- Added card shadow in the following elements to optimize visual effect
|
||||
- Dashboard and in-game announcements
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
home: true
|
||||
icon: home
|
||||
icon: iconfont icon-home
|
||||
title: 首页
|
||||
heroImage: https://img.alicdn.com/imgextra/i4/1797064093/O1CN01oaGvKE1g6dut0pICS_!!1797064093.png_.webp
|
||||
heroAlt: 胡桃工具箱
|
||||
@@ -26,13 +26,13 @@ highlights:
|
||||
bgImageDark: /images/202309/head-back2.png
|
||||
highlights:
|
||||
- title: 你的数据你掌握
|
||||
icon: computer
|
||||
icon: iconfont icon-computer
|
||||
details: 数据储存于你的本地设备中，不依赖任何云端服务或第三方平台，自由地访问你的数据
|
||||
- title: 你的数据我保护
|
||||
icon: lock
|
||||
icon: iconfont icon-lock
|
||||
details: 数据可通过胡桃云备份至胡桃服务器，丢失设备也绝不会丢失数据
|
||||
- title: 你的程序社区守望
|
||||
icon: anonymous
|
||||
icon: iconfont icon-anonymous
|
||||
details: 程序以 MIT 协议开源于 GitHub 并欢迎社区成员的代码审查和贡献；上架微软商店由微软进行安全审查
|
||||
|
||||
- header: 多合一的工具箱
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
headerDepth: 2
|
||||
icon: ask
|
||||
icon: iconfont icon-ask
|
||||
category: [FAQ]
|
||||
order: 1
|
||||
redirectFrom: /advanced/FAQ.html
|
||||
|
||||
@@ -1,9 +1,10 @@
|
||||
---
|
||||
headerDepth: 0
|
||||
category: [FAQ]
|
||||
icon: read
|
||||
icon: iconfont icon-read
|
||||
order: 8
|
||||
redirectFrom: /advanced/Gacha-system-and-export-principal.html
|
||||
comment: false
|
||||
---
|
||||
|
||||
# 祈愿系统与导出原理
|
||||
|
||||
@@ -1,7 +1,8 @@
|
||||
---
|
||||
category: [FAQ, 依赖项, 安装]
|
||||
icon: structure
|
||||
icon: iconfont icon-structure
|
||||
order: 6
|
||||
comment: false
|
||||
---
|
||||
|
||||
# 手动安装依赖项
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
headerDepth: 2
|
||||
icon: debug
|
||||
icon: iconfont icon-warn
|
||||
category: [FAQ]
|
||||
order: 2
|
||||
redirectFrom:
|
||||
@@ -9,6 +9,7 @@ redirectFrom:
|
||||
/advanced/mihoyo-risk-tip.html,
|
||||
/zh/advanced/mihoyo-risk-tip.html,
|
||||
]
|
||||
comment: false
|
||||
---
|
||||
|
||||
# 常见的程序异常
|
||||
@@ -20,7 +21,7 @@ redirectFrom:
|
||||
- 异常：`RuntimeEnvironmentException`
|
||||
- 提示：`未开启长路径功能，无法设置注册表键值`
|
||||
- 问题来源：没有解除 Windows 目录长度限制
|
||||
- 解决方案：下载 [EnableLongPaths.zip](https://d.hut.ao/d/tools/EnableLongPaths.zip) 后解压，以管理员身份运行解压后的 `.reg` 文件
|
||||
- 解决方案：下载 [EnableLongPaths.zip](https://d.hut.ao/d/tools/EnableLongPaths.zip) 后解压，运行解压后的 `.reg` 文件
|
||||
|
||||
## Return Code: -10001
|
||||
|
||||
|
||||
@@ -1,8 +1,9 @@
|
||||
---
|
||||
category: [FAQ, 第三方工具]
|
||||
icon: read
|
||||
icon: iconfont icon-read
|
||||
order: 7
|
||||
redirectFrom: /advanced/get-stoken-cookie-from-the-third-party.html
|
||||
comment: false
|
||||
---
|
||||
|
||||
# 使用第三方工具获取有 Stoken 的 cookie
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
headerDepth: 2
|
||||
icon: tool
|
||||
icon: iconfont icon-tool
|
||||
category: [FAQ]
|
||||
order: 3
|
||||
redirectFrom: /advanced/known-issue.html
|
||||
@@ -10,4 +10,4 @@ redirectFrom: /advanced/known-issue.html
|
||||
|
||||
该文档包含由所有已知问题和修复计划
|
||||
|
||||
你可以在 [https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+is%3Aopen+label%3ABUG](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+is%3Aopen+label%3ABUG]) 查看最新的来自社区的 BUG 报告
|
||||
你可以在 [https://github.com/DGP-Studio/Snap.Hutao/issues](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+label%3ABUG+) 查看最新的来自社区的 BUG 报告
|
||||
|
||||
@@ -1,8 +1,9 @@
|
||||
---
|
||||
category: [FAQ]
|
||||
icon: delete
|
||||
icon: iconfont icon-delete
|
||||
order: 9
|
||||
redirectFrom: /advanced/uninstall.html
|
||||
comment: false
|
||||
---
|
||||
|
||||
# 卸载胡桃工具箱
|
||||
|
||||
@@ -3,7 +3,7 @@ headerDepth: 0
|
||||
category: [公告]
|
||||
redirectFrom: /community.html
|
||||
comment: false
|
||||
icon: community
|
||||
icon: iconfont icon-community
|
||||
order: 8
|
||||
---
|
||||
|
||||
@@ -13,20 +13,19 @@ order: 8
|
||||
|
||||
<!-- @include: star-request.md -->
|
||||
|
||||
## GitHub 讨论
|
||||
## <HopeIcon icon="iconfont icon-github" size="1.5rem" /> GitHub 讨论
|
||||
|
||||
[Snap.Hutao Discussion](https://github.com/DGP-Studio/Snap.Hutao/discussions)
|
||||
|
||||
## QQ 群
|
||||
## <HopeIcon icon="iconfont icon-qq" size="1.5rem" color="rgb(0,126,198)" /> QQ 群
|
||||
|
||||
> 若入群问题为最新版本号则请输入三位版本号（如 `1.2.3`）而不是四位版本号（如 `1.2.3.0`）
|
||||
|
||||
- [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 开发交流群_
|
||||
- [_Snap 开发交流群_](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=XJPjE6ffuYPkZmXvujdP1ZDY2BqL8RDg&authKey=YHBYvW4KmPUpPjGwYwGduG7ZELhFIkd9QxLHuwBFmm4UvQH1ThWiv%2FKPgeckiqt4&noverify=0&group_code=982424236)
|
||||
- 广泛的技术交流群，并非胡桃工具箱开发群
|
||||
- 开发群对申请者的技术水平有一定要求
|
||||
- 如果你有兴趣可以从[dev-group.hut.ao](https://dev-group.hut.ao)加入开发者交流群
|
||||
|
||||
## Discord
|
||||
## <HopeIcon icon="iconfont icon-discord1" size="1.5rem" color="rgb(115,139,216)" /> Discord
|
||||
|
||||
邀请链接：[https://discord.gg/Yb8bykaUKp](https://discord.gg/Yb8bykaUKp)
|
||||
|
||||
@@ -4,8 +4,10 @@ comment: false
|
||||
index: false
|
||||
redirectFrom: /development/
|
||||
dir:
|
||||
text: 开发
|
||||
text: 开源开发
|
||||
order: 3
|
||||
---
|
||||
|
||||
# 开发
|
||||
# 开源开发
|
||||
|
||||
<AutoCatalog />
|
||||
|
||||
38
docs/zh/development/contribute.md
Normal file
38
docs/zh/development/contribute.md
Normal file
@@ -0,0 +1,38 @@
|
||||
---
|
||||
category: [open source, development]
|
||||
tag: ["开发", "GitHub"]
|
||||
icon: iconfont icon-code
|
||||
order: 2
|
||||
---
|
||||
|
||||
# 贡献你的代码
|
||||
|
||||
胡桃工具箱使用 C# 和 .NET 框架开发桌面客户端和服务端。如果你愿意贡献你的代码，请阅读以下指导文档。
|
||||
|
||||
你可以在 GitHub 上查看所有当前仍然[未解决的问题](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+is%3Aopen+-label%3A%E5%B7%B2%E4%BF%AE%E5%A4%8D+)
|
||||
|
||||
## <HopeIcon icon="iconfont icon-visual-studio" size="1.5rem" color="rgb(193,142,241)" /> 设置 Snap.Hutao 项目
|
||||
|
||||
1. 下载并安装 [Visual Studio 2022 Community](https://visualstudio.microsoft.com/downloads/)
|
||||
2. 启动 Visual Studio Installer 以完成 Visual Studio 的安装流程
|
||||
- 你需要安装 `.NET desktop development`、 `Desktop development with C++` 和 `Universal Windows Platform development` 组件
|
||||
3. 安装 Visual Studio 商店中由 Microsoft 提供的 `Single-project MSIX Packaging Tools for VS 2022` 插件
|
||||
4. 使用 Git clone `https://github.com/DGP-Studio/Snap.Hutao.git` 到你的本地设备
|
||||
5. 将分支切换为 `develop`
|
||||
6. 使用你的 Visual Studio 打开项目 solution，接下来你就可以开始编辑代码了
|
||||
|
||||
## <HopeIcon icon="iconfont icon-pull-request" size="1.5rem" /> 发起 Pull Request
|
||||
|
||||
- 所有不是从项目其它分支发起的 Pull Request 都只被允许合并进 `develop` 分支
|
||||
- 如果你提交的代码与已有的 issue 相关，请使用请使用[关键词](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/using-keywords-in-issues-and-pull-requests)
|
||||
将你的 PR 与相关的 issue 关联起来。这样当你的 PR 最终被合并进 `main` 主分支时，这些 issue 将被自动关闭。
|
||||
|
||||
## <HopeIcon icon="iconfont icon-build-package" size="1.5rem" /> 测试打包程序
|
||||
|
||||
一旦你的代码被合并进 `develop` 和 `main` 分支，一个 Azure Pipeline CI 流水线脚本将运行起来以构建所在分支的最新代码，并以 `Snap Hutao Alpha` 命名。
|
||||
当该测试包打包完成后，它将被以 `pre-release` 的形式发布在 [GitHub 发布页面](https://github.com/DGP-Studio/Snap.Hutao/releases)上。
|
||||
|
||||
你需要安装 [Snap.Hutao.CI.cer](https://github.com/DGP-Studio/Snap.Hutao/releases/download/2023.10.3.1/Snap.Hutao.CI.cer)
|
||||
证书到你的本地设备上以允许你安装测试版安装包。
|
||||
|
||||
\*如果在最新的发布中没有包含程序安装包附件，则意味着它仍然处于上传过程中。
|
||||
@@ -1,6 +1,7 @@
|
||||
---
|
||||
category: [开源, 开发]
|
||||
icon: vscode
|
||||
tag: [开源, 胡桃数据库, 深渊数据库, Enka, UIGF, 数据开放]
|
||||
icon: iconfont icon-vscode
|
||||
order: 1
|
||||
---
|
||||
|
||||
@@ -18,7 +19,7 @@ Snap Hutao 的中间组件。
|
||||
|
||||
获得胡桃 API 权限的开发者同时也获得胡桃工具箱内胡桃云功能的完整权限作为福利。
|
||||
|
||||
开发者可以通过 [胡桃 API 开放平台](https://homa.snapgenshin.com/)，提交信息申请权限。
|
||||
开发者可以通过[胡桃 API 开放平台](https://homa.snapgenshin.com/)，提交信息申请权限。
|
||||
|
||||
## Enka API 中国加速服务
|
||||
|
||||
@@ -28,7 +29,7 @@ Snap Hutao 的中间组件。
|
||||
胡桃工具箱在开发[我的角色](../features/character-data.md)功能时使用了 Enka Network 的数据，
|
||||
并搭建了中转服务器以保证胡桃工具箱中国用户的使用体验。
|
||||
|
||||
如果你是原神开源工具的开发者并且有该功能的需要可以填写[该表格](https://docs.google.com/forms/d/e/1FAIpQLSefnrYz41NZ2hSG0xC6OoBsIiM_mDdVLS7lsUg9thHmA1h8qw/viewform?usp=sf_link)以申请使用我们维护的中转服务。
|
||||
开发者可以在 Snap Hutao 开发者交流群或者 Discord 频道中向管理员提出申请
|
||||
|
||||
## UIGF 可交换数据记录
|
||||
|
||||
|
||||
@@ -3,7 +3,7 @@ headerDepth: 0
|
||||
category: [公告, i18n]
|
||||
redirectFrom: /i18n.html
|
||||
comment: false
|
||||
icon: network
|
||||
icon: iconfont icon-network
|
||||
order: 7
|
||||
---
|
||||
|
||||
|
||||
@@ -3,7 +3,7 @@ headerDepth: 0
|
||||
category: [公告, 项目, 功能]
|
||||
redirectFrom: /project.html
|
||||
comment: false
|
||||
icon: workingDirectory
|
||||
icon: iconfont icon-workingDirectory
|
||||
order: 6
|
||||
---
|
||||
|
||||
|
||||
@@ -4,7 +4,7 @@ externalLinkIcon: false
|
||||
category: [功能, 教程]
|
||||
redirectFrom: /quick-start.html
|
||||
comment: false
|
||||
icon: play
|
||||
icon: iconfont icon-play
|
||||
order: 5
|
||||
---
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
---
|
||||
headerDepth: 0
|
||||
category: [公告]
|
||||
icon: debug
|
||||
icon: iconfont icon-debug
|
||||
order: 2
|
||||
comment: false
|
||||
redirectFrom: /statements/bug-report.html
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
---
|
||||
headerDepth: 0
|
||||
category: [公告]
|
||||
icon: license
|
||||
icon: iconfont icon-license
|
||||
order: 3
|
||||
redirectFrom: /statements/privacy-notice.html
|
||||
comment: false
|
||||
|
||||
@@ -3,7 +3,7 @@ headerDepth: 0
|
||||
category: [公告]
|
||||
comment: false
|
||||
editLink: false
|
||||
icon: license
|
||||
icon: iconfont icon-license
|
||||
order: 4
|
||||
redirectFrom: /statements/toshtml
|
||||
---
|
||||
|
||||
@@ -1,13 +1,23 @@
|
||||
---
|
||||
category: [公告]
|
||||
icon: update
|
||||
icon: iconfont icon-update
|
||||
order: 1
|
||||
redirectFrom: /statements/update-log.html
|
||||
comment: false
|
||||
---
|
||||
|
||||
# 更新日志
|
||||
|
||||
## 1.7.7 <Badge text="最新版" type="tip" />
|
||||
## 1.7.9 <Badge text="最新版" type="tip" />
|
||||
|
||||
- 修复
|
||||
- 修复了退出程序后显示器分辨率更改后无法以正确窗口尺寸启动的问题
|
||||
- 修复了米哈游通行证页面无法正确登录的问题 [#1005](https://github.com/DGP-Studio/Snap.Hutao/issues/1005)
|
||||
- 修复了 HoYoverse 登录页面不正确的问题 [#1007](https://github.com/DGP-Studio/Snap.Hutao/issues/1007)
|
||||
- 修复了 1.7.7 版本无法正确上传崩溃日志的问题
|
||||
- 修复了深境螺旋页面本期页签上场队伍页签列表中的上场次数过长可能无法正常显示的问题 [#1008](https://github.com/DGP-Studio/Snap.Hutao/issues/1008)
|
||||
|
||||
## 1.7.7
|
||||
|
||||
- 在以下位置增加了卡片阴影以优化视觉效果
|
||||
- 仪表板与活动公告
|
||||
|
||||
Reference in New Issue
Block a user