更新：重构构建指南，新增Windows GNU和MSVC工具链文档，优化内容结构和格式，将静态库从仓库中移除

Author: NuanRMxi

src/SUMMARY.md

@@ -86,7 +86,9 @@
 
 - [Phira 构建指南](./phira_build_guide/README.md)
   - [cargo 安装教程](./phira_build_guide/cargo.md)
-  - [Windows](./phira_build_guide/Windows.md)
+  - [静态库（prpr-avc）](./phira_build_guide/StaticLib.md)
+  - [Windows GNU](./phira_build_guide/Windows_Gnu.md)
+  - [Windows MSVC](./phira_build_guide/Windows_Msvc.md)
   - [Linux](./phira_build_guide/Linux.md)
   - [macOS](./phira_build_guide/macOS.md)
   - [Android](./phira_build_guide/Android.md)

src/phira_build_guide/Linux.md

@@ -2,29 +2,33 @@
 
 ## 准备阶段
 
-1. 确保系统安装了 cargo，可以在终端使用 `cargo -V` 检查系统是否安装了 cargo，如果没有安装，请点击 [这里](./cargo.md)按步骤安装构建工具
+1. 确保系统安装了 cargo，可以在终端使用 `cargo -V` 检查系统是否安装了 cargo，如果没有安装，请点击 [这里](./cargo.md#linux)
+   按步骤安装构建工具
 2. 从 GitHub 下载源码到本地：
     - 若您是纯终端，建议使用 git 工具，请使用 `git clone https://github.com/TeamFlos/phira.git` 将仓库克隆到本地。
     - 若您使用了桌面环境，您也可以在 Phira 仓库页面点击 Code 按钮选择 `Download ZIP` 将代码下载到本地，随后将代码解压到本地任意目录。
     - __如果您无法连接到 GitHub，您也可以使用 git 加速网站提供的加速地址克隆与下载。__
-    - __若您要构建指定版本的 Phira，请前往 [release](https://github.com/TeamFlos/phira/releases) 页面在 Assets 中选择下载 `Source code (tar.gz)` 到本地，解压到任意路径即可。__
+    - __若您要构建指定版本的 Phira，请前往 [release](https://github.com/TeamFlos/phira/releases) 页面在 Assets
+      中选择下载 `Source code (tar.gz)` 到本地，解压到任意路径即可。__
     - __警告：为了防止玄学问题，我们不建议路径中包含除了 ASCII 编码包含字符以外的任何字符。__
-3. 静态库文件，您可以 [直接下载](./prpr-avc.zip) 静态库文件，下载完成后直接解压到代码根目录下，如果提示覆盖文件，请点击覆盖。
-4. 构建过程需要库文件补充，输入以下命令即可：
-
-    > sudo apt update
-    >
-    > sudo apt install libasound2-dev
-    >
-    > sudo apt install libgtk-3-dev
+3. 静态库文件，您可以 [直接下载](https://www.nuanr-mxi.com/prpr-avc.zip) 静态库文件，下载完成后直接解压到代码根目录下，如果提示覆盖文件，请点击覆盖。
+4. 构建过程需要库文件补充，输入以下命令即可（以Debian分支系统为例）：
+```shell
+sudo apt update
+sudo apt install libasound2-dev
+sudo apt install libgtk-3-dev
+```
 
 ## 开始构建
 
 1. 打开终端，切换到代码根目录
 2. 输入 `cargo build -r --bin phira-main` ，直到编译完成。
-3. 复制 `.\assets\` 目录中的所有文件到 `.\target\release\assets\` ，至此，构建流程全部完成，您可以在带有桌面环境的情况下直接运行 `phira-main` 检查资源文件是否完整，若您没有桌面环境，程序将会闪退（实测 WSL 无法兼容，如果在 WSL 下运行将会闪退），至此，构建流程结束。
+3. 复制 `.\assets\` 目录中的所有文件到 `.\target\release\assets\` ，至此，构建流程全部完成，您可以在带有桌面环境的情况下直接运行
+   `phira-main` 检查资源文件是否完整，若您没有桌面环境，程序将会闪退（实测 WSL 无法兼容，如果在 WSL 下运行将会闪退），至此，构建流程结束。
 
-- __注意：在此文档编写时，代码目录下的资源文件并不完整，如果您发现主程序闪退，您可以前往 [release](https://github.com/TeamFlos/phira/releases) 页面下载任意版本，获取缺失的资源文件__
+- _
+  _注意：在此文档编写时，代码目录下的资源文件并不完整，如果您发现主程序闪退，您可以前往 [release](https://github.com/TeamFlos/phira/releases)
+  页面下载任意版本，获取缺失的资源文件__
 
 ## 常见问题
 

src/phira_build_guide/README.md

@@ -1,5 +1,6 @@
 # 构建指南
-Windows：[here](./Windows.md)<br>
-Linux：[here](./Linux.md)<br>
-macOS：[here](./macOS.md)<br>
-Android：[here](./Android.md)<br>
+Windows GNU：[here](./Windows_Gnu.md)  
+Windows MSVC：[here](./Windows_Msvc.md)  
+Linux：[here](./Linux.md)  
+macOS：[here](./macOS.md)  
+Android：[here](./Android.md)

src/phira_build_guide/StaticLib.md

@@ -0,0 +1,45 @@
+# 静态库（prpr-avc）
+
+## 介绍
+- 此文件为 Phira 使用的用于解码视频的静态库，此静态库由 [FFmpeg commit hash 4a80db5fc2b1b134550ffbcb8fd3b7ce2ad734b3](https://github.com/FFmpeg/FFmpeg/commit/4a80db5fc2b1b134550ffbcb8fd3b7ce2ad734b3) 编译而来。
+- Phira 引用的静态库 FFmpeg 版本无需非常严格，使用什么版本由您决定，但是当您需要修改音视频解码相关功能并做出贡献时，请严格遵守这一版本，当前官方提供的[静态库](https://www.nuanr-mxi.com/prpr-avc.zip)都由此版本编译，由贡献者贡献的静态库可能版本不一致。
+- prpr-avc 仅包含最精简的 FFmpeg 组件，编译选项为：
+```shell
+--disable-everything \
+--enable-decoder=h264 \
+--enable-decoder=aac \
+--enable-decoder=aac_latm \
+--enable-decoder=flac \
+--enable-decoder=mp3 \
+--enable-decoder=vorbis
+```
+## 构建（以i686-pc-windows-gnu为例）
+
+1. 下载 [FFmpeg n5.1.8 源代码（GitHub）](https://github.com/FFmpeg/FFmpeg/archive/refs/tags/n5.1.8.tar.gz) 并解压到任意目录。
+   - _如介绍所述，FFmpeg 版本无需特别严格，您也可以选择其他版本的 FFmpeg 进行构建，但是当您需要修改音视频解码相关功能并做出贡献时，请严格遵守这一版本_
+2. 在 `sh` 上操作（此处使用msys2，注意要将ffmpeg源码复制到 `C:\msys64\home\您的用户名`，编译选项并不绝对，您可以自行查阅资料进行自定义）。
+
+```sh
+cd FFmpeg-n5.1.8 && mkdir build && cd build
+
+../configure \
+  --disable-programs \
+  --disable-doc \
+  --disable-everything \
+  --disable-debug \
+  --arch=i686 \
+  --target_os=mingw32 \
+  --cross-prefix=i686-w64-mingw32-
+  
+make
+```
+
+note:这里有个坑。。。如果报错的话尝试把 msys64\mingw32\bin 这个目录下的 i686-w64-mingw32-gcc-ar.exe , i686-w64-mingw32-gcc-nm.exe , i686-w64-mingw32-gcc-ranlib.exe 复制粘贴一份然后重命名成 i686-w64-mingw32-ar.exe , i686-w64-mingw32-nm.exe , i686-w64-mingw32-ranlib.exe
+
+接着把build文件夹下的所有形如 `*.a` 的文件复制到 `phira\prpr-avc\static-lib\i686-pc-windows-gnu` 就可以啦
+
+- __注意：以上操作仅能保证 cargo 正常编译并输出主程序，如需用于视频解码请自行在 configure 启用 protocol=file，decoders，parsers 等选项，如介绍所示__
+
+## MSVC 构建静态库
+- 由于 ffmpeg 的 configure 本身就不为 MSVC 服务，其构建极具挑战性，我们不建议您自行构建 MSVC 版本的静态库，如果您需要 MSVC 版本的静态库，请 [直接下载](https://www.nuanr-mxi.com/prpr-avc.zip)。
+- 如果您坚持挑战构建，请参考上述的 GNU 构建方法，配合 [这篇教程](https://github.com/ffiirree/ffmpeg-tutorials/blob/master/compile_on_windows.md) 进行构建操作。

src/phira_build_guide/Windows.md

@@ -1,93 +1 @@
 # Windows
-
-## 准备阶段
-
-1. 确保系统安装了 cargo，可以在命令提示符（cmd）或者 PowerShell 使用 `cargo -V` 检查系统是否安装了 cargo。如果提示以下信息：
-    - `'cargo' 不是内部或外部命令，也不是可运行的程序或批处理文件。`
-    - `cargo : 无法将“cargo”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写，如果包括路径，请确保路径正确，然后再试一次。`
-    - 请点击 [这里](./cargo.md) 按步骤安装构建工具
-2. 从 GitHub 下载源码到本地：
-    - 若您安装了 git 工具，请使用 `git clone https://github.com/TeamFlos/phira.git` 将仓库克隆到本地。
-    - 若您没有安装 git 工具，您也可以在 Phira 仓库页面点击 Code 按钮选择 `Download ZIP` 将代码下载到本地，随后将代码解压到本地任意目录。
-    - __如果您无法连接到 GitHub，您也可以使用 git 加速网站提供的加速地址克隆与下载。__
-    - __若您要构建指定版本的 Phira，请前往 release 页面在 Assets 中选择下载 `Source code(zip)` 到本地，解压到任意路径即可。__
-    - __警告：为了防止玄学问题，我们不建议路径中包含除了 ASCII 编码包含字符以外的任何字符。__
-3. perl，您可以在命令提示符（cmd）或者 PowerShell 使用 `perl -v` 检查系统是否安装了 perl，如果没有，请搜索并打开 `MSYS2 UCRT64` 输入 `pacman -S perl` 安装 perl
-4. 静态库文件，您可以 [直接下载](./prpr-avc.zip) 静态库文件，下载完成后直接解压到代码根目录下，如果提示覆盖文件，请点击覆盖。
-
-## 开始构建
-
-1. 在命令提示符（cmd）或者 PowerShell 切换到代码根目录（如 `D:\phira\` ）
-2. 在命令提示符（cmd）或者 PowerShell 使用 `cargo build -r --bin phira-main` ，如果不出意外，在 `openssl-sys(build)` 时，您将卡很久很久，请不要退出，这是正常的。
-3. 构建完成后，在 `.\target\release\` 目录下您可以找到编译完成的主程序
-4. 复制 `.\assets\` 目录中的所有文件到 `.\target\release\assets\` ，至此，构建流程全部完成，您可以直接运行 `phira-main.exe` 检查资源文件是否完整。
-
-- __注意：在此文档编写时，代码目录下的资源文件并不完整，如果您发现主程序闪退，您可以前往 [release](https://github.com/TeamFlos/phira/releases) 页面下载任意版本，获取缺失的资源文件__
-
-## 32位版本
-
-1. 在命令提示符（cmd）或者 PowerShell 切换到代码根目录（如 `D:\phira\` ）
-2. 下载上面的静态库文件解压到`phira\prpr-avc\static-lib`或自行构建
-3. 在命令提示符（cmd）或者 PowerShell 使用 `cargo build --target=i686-pc-windows-gnu --release --package phira-main` ，如果不出意外，在 `openssl-sys(build)` 时，您将卡很久很久，请不要退出，这是正常的。
-4. 构建完成后，在 `.\target\release\` 目录下您可以找到编译完成的主程序
-5. 复制 `.\assets\` 目录中的所有文件到 `.\target\release\assets\` ，至此，构建流程全部完成，您可以直接运行 `phira-main.exe` 检查资源文件是否完整。
-
-- __注意：在此文档编写时，代码目录下的资源文件并不完整，如果您发现主程序闪退，您可以前往 [release](https://github.com/TeamFlos/phira/releases) 页面下载任意版本，获取缺失的资源文件__
-
-## 有关静态库的构建（以i686-pc-windows-gnu为例）
-
-下载 [FFmpeg n5.1.8 源代码（GitHub）)](https://github.com/FFmpeg/FFmpeg/archive/refs/tags/n5.1.8.tar.gz) 并解压到任意目录
-
-在sh上操作（此处使用msys2，注意要将ffmpeg源码复制到 `C:\msys64\home\您的用户名`）
-
-```sh
-cd FFmpeg-n5.1.8 && mkdir build && cd build
-../configure --disable-programs --disable-doc --disable-everything --disable-debug --arch=i686 --target_os=mingw32 --cross-prefix=i686-w64-mingw32-
-make
-```
-
-note:这里有个坑。。。如果报错的话尝试把 msys64\mingw32\bin 这个目录下的 i686-w64-mingw32-gcc-ar.exe , i686-w64-mingw32-gcc-nm.exe , i686-w64-mingw32-gcc-ranlib.exe 复制粘贴一份然后重命名成 i686-w64-mingw32-ar.exe , i686-w64-mingw32-nm.exe , i686-w64-mingw32-ranlib.exe
-
-接着把build文件夹下的所有形如 `*.a` 的文件复制到 `phira\prpr-avc\static-lib\i686-pc-windows-gnu` 就可以啦
-
-- __注意：以上操作仅能保证 cargo 正常编译并输出主程序，如需用于视频解码请自行在 configure 启用 protocol=file，decoders，parsers 等选项__
-
-## 常见问题
-
-Q. 报错 `failed to send request: 操作超时`
-
-A. 请检查网络环境，确保您可以正常访问 GitHub
-
-Q. 报错 `failed to send request: 无法解析服务器的名称或地址`
-
-A. 检查 DNS 或更换 DNS，更换后请刷新 DNS 缓存
-
-Q. 构建过程中报错 `error: failed to run custom build command for openssl-sys v0.9.99`
-
-A. 缺失 perl，请检查是否正确安装 perl 后再试
-
-Q. 构建报错`error occurred: Failed to find tool. Is gcc.exe installed? (see https://github.com/rust-lang/cc-rs#compile-time-requirements for help)`
-
-A. 请检查是否安装了 `MSYS2` 以及检查是否配置了环境变量
-
-Q. 出现以下报错：
-
-> Error building OpenSSL dependencies:
->
-> Command: "make" "depend"
->
-> Failed to execute: program not found
-
-A. 缺失 `make` 指令，请前往 MSYS2 终端中使用 `pacman -S make` 安装此命令。
-
-Q. 报错包含 `This perl inplementation doesn't produce lnix like paths`
-
-A. 使用的 `perl` 不适用于 `gcc`，请删除原有 `perl` 的环境变量或者直接卸载原有的 `perl`。
-
-Q. 报错包含`undefined reference to libiconv`
-
-A. 使用的 `libiconv` 有问题，请在 MSYS2 终端中使用 `pacman -S libiconv`
-
-Q. 太麻烦了
-
-A. 这样，直接去 [release](https://github.com/TeamFlos/phira/releases/latest) 页面下吧~~微软我真谢谢你~~

src/phira_build_guide/Windows_Gnu.md

@@ -0,0 +1,87 @@
+# Windows GNU（依赖GCC）
+
+## 准备阶段
+
+1. 确保系统安装了 cargo，可以在命令提示符（cmd）或者 PowerShell 使用 `cargo -V` 检查系统是否安装了 cargo。如果提示以下信息：
+    - `'cargo' 不是内部或外部命令，也不是可运行的程序或批处理文件。`
+    - `cargo : 无法将“cargo”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写，如果包括路径，请确保路径正确，然后再试一次。`
+    - 请点击 [这里](./cargo.md#windows-gnu-工具链) 按步骤安装构建工具
+2. 从 GitHub 下载源码到本地：
+    - 若您安装了 git 工具，请使用 `git clone https://github.com/TeamFlos/phira.git` 将仓库克隆到本地。
+    - 若您没有安装 git 工具，您也可以在 Phira 仓库页面点击 Code 按钮选择 `Download ZIP` 将代码下载到本地，随后将代码解压到本地任意目录。
+    - __如果您无法连接到 GitHub，您也可以使用 git 加速网站提供的加速地址克隆与下载。__
+    - __若您要构建指定版本的 Phira，请前往 release 页面在 Assets 中选择下载 `Source code(zip)` 到本地，解压到任意路径即可。__
+    - __警告：为了防止玄学问题，我们不建议路径中包含除了 ASCII 编码包含字符以外的任何字符。__
+3. perl，您可以在命令提示符（cmd）或者 PowerShell 使用 `perl -v` 检查系统是否安装了 perl，如果没有，请搜索并打开
+   `MSYS2 UCRT64` 输入 `pacman -S perl` 安装 perl
+4. 静态库文件，您可以 [直接下载](https://www.nuanr-mxi.com/prpr-avc.zip) 静态库文件，下载完成后直接解压到代码根目录下，如果提示覆盖文件，请点击覆盖。
+
+## 开始构建
+
+1. 在命令提示符（cmd）或者 PowerShell 切换到代码根目录（如 `D:\phira\` ）
+2. 在命令提示符（cmd）或者 PowerShell 使用 `cargo build -r --bin phira-main` ，如果您在编译过去的版本，在
+   `openssl-sys(build)` 时，终端将会停滞很长一段时间，请不要退出，这是正常的。
+3. 构建完成后，在 `.\target\release\` 目录下您可以找到编译完成的主程序
+4. 复制 `.\assets\` 目录中的所有文件到 `.\target\release\assets\` ，至此，构建流程全部完成，您可以直接运行 `phira-main.exe`
+   检查资源文件是否完整。
+
+- __注意：在此文档编写时，代码目录下的资源文件并不完整，如果您发现主程序闪退，您可以前往 [release](https://github.com/TeamFlos/phira/releases)
+  页面下载任意版本，获取缺失的资源文件__
+
+## 32位版本
+
+1. 在命令提示符（cmd）或者 PowerShell 切换到代码根目录（如 `D:\phira\` ）
+2. 下载上面的静态库文件解压到`phira\prpr-avc\static-lib`或[自行构建](./StaticLib.md#构建以i686-pc-windows-gnu为例)
+3. 在命令提示符（cmd）或者 PowerShell 使用 `cargo build --target=i686-pc-windows-gnu --release --package phira-main`
+   ，如果不出意外，在 `openssl-sys(build)` 时，您将卡很久很久，请不要退出，这是正常的。
+4. 构建完成后，在 `.\target\release\` 目录下您可以找到编译完成的主程序
+5. 复制 `.\assets\` 目录中的所有文件到 `.\target\release\assets\` ，至此，构建流程全部完成，您可以直接运行 `phira-main.exe`
+   检查资源文件是否完整。
+
+- __注意：在此文档编写时，代码目录下的资源文件并不完整，如果您发现主程序闪退，您可以前往 [release](https://github.com/TeamFlos/phira/releases)
+  页面下载任意版本，获取缺失的资源文件__
+
+## 有关静态库的构建
+
+- 已移动到[静态库页](./StaticLib.md)
+
+## 常见问题
+
+Q. 报错 `failed to send request: 操作超时`
+
+A. 请检查网络环境，确保您可以正常访问 GitHub
+
+Q. 报错 `failed to send request: 无法解析服务器的名称或地址`
+
+A. 检查 DNS 或更换 DNS，更换后请刷新 DNS 缓存
+
+Q. 构建过程中报错 `error: failed to run custom build command for openssl-sys v0.9.99`
+
+A. 缺失 perl，请检查是否正确安装 perl 后再试
+
+Q. 构建报错
+`error occurred: Failed to find tool. Is gcc.exe installed? (see https://github.com/rust-lang/cc-rs#compile-time-requirements for help)`
+
+A. 请检查是否安装了 `MSYS2` 以及检查是否配置了环境变量
+
+Q. 出现以下报错：
+```shell
+Error building OpenSSL dependencies:
+
+Command: "make" "depend"
+
+Failed to execute: program not found
+```
+A. 缺失 `make` 指令，请前往 MSYS2 终端中使用 `pacman -S make` 安装此命令。
+
+Q. 报错包含 `This perl inplementation doesn't produce lnix like paths`
+
+A. 使用的 `perl` 不适用于 `gcc`，请删除原有 `perl` 的环境变量或者直接卸载原有的 `perl`。
+
+Q. 报错包含`undefined reference to libiconv`
+
+A. 使用的 `libiconv` 有问题，请在 MSYS2 终端中使用 `pacman -S libiconv`
+
+Q. 太麻烦了
+
+A. 这样，你去 [MSVC构建方式](./Windows_Msvc.md) 吧，稍微简单一点点。