📃 docs(模组包): 新增报错排查手册

_docs/about-questions.md

@@ -54,7 +54,7 @@ __想必你注意到我了，记住上面讲的话__
 ## 关于游戏的资源包
 下载完了，也玩了会  
 
-总有人讲啥 “啥啥啥 `材质包` 很好看”  
+总有人讲啥 “什么 `材质包` 很好看”  
 
 `材质包` 一般是单指修改了游戏材质的 `资源包` ，正式译名为 `纹理包`
 
@@ -76,7 +76,7 @@ mods 是基于 mod_loader 的一个从文件上更改游戏的内容的外置组
 
 在 [此文](/launcher/auto-installing.html#%E5%AE%89%E8%A3%85-mod-%E5%90%8E%E6%B8%B8%E6%88%8F%E6%8A%A5%E9%94%99%E6%97%A0%E6%B3%95%E5%90%AF%E5%8A%A8) 末尾中的确讲到了一定的解决方法
 
-但是还是建议看看更为详细的内容 [注：目前未写该教程，请等待]()
+请前往错误手册中查看 [跳转](/modpack/error-handbook.html)
 
 ## 关于游戏的 Java 选择
 

_launcher/global-version-isolation.md

@@ -15,11 +15,11 @@ toc: true
 
 ## 使用方式
 进入 hmcl 的`设置`
-![](\assets\img\docs\Global-version-isolation\img.png)
+![](\assets\img\docs\Global-version-isolation\img.webp)
 在全局设置中找到 `版本隔离`
 改为 `各版本独立`
-![](\assets\img\docs\Global-version-isolation\img1.png)
-这时候 minecraft 的文件结构就会有所改变
+![](\assets\img\docs\Global-version-isolation\img2.webp)
+这时候 minecraft 的文件结构就会有所改变，如下方
 ```
 .minecraft
 |*asstes
@@ -32,15 +32,15 @@ toc: true
         |*logs
         |*mods
         |*config
-        ......
+        ...
 ```
 并非在 .minecraft 文件夹中存储一切的 mod 和 资源包**而是各版本的资源互相独立**
 
 这样你就可以在一个目录下，安装多个客户端
 
 ## 往后的使用
-在做完版本隔离的设置后，hmcl 的快速打开各个游戏文件夹的功能就会显得十分重要。
-![](/assets/img/docs/Global-version-isolation/img2.png)
+在做完版本隔离的设置后，hmcl 的快速打开各个游戏文件夹的功能就会显得十分好用。
+![](/assets/img/docs/Global-version-isolation/img1.png)
 
-善用该功能也可为你的磁盘剩下不少的空间
+~~善用该功能也可为你的磁盘剩下不少的空间~~，现在反思过来其实都差不多
 

_modpack/error-handbook.md

@@ -0,0 +1,78 @@
+---
+title:  "模组包报错排查手册"
+permalink: /modpack/error-handbook.html
+date:   2025-05-24 13:39:36 +0800
+categories: 整合包
+toc: true
+---
+
+> 本文由 LIiston 编写。
+
+# 模组包报错排查手册  
+
+## 文件夹结构
+
+首先我们需要先认识Minecraft的文件夹结构  
+如果你开启了 [版本隔离](launcher/global-version-isolation.html) 那么你的文件夹结构如下  
+
+```text
+.minecraft
+|*asstes
+|*libraries
+|*versions
+    \1.16.5-optifine
+        |1.16.5-optifine.jar
+        |*saves
+        |*resourcepacks
+        |*logs
+        |*mods
+        |*config
+        |*saves
+        |*crash-reports
+        ...
+```
+
+如果你没有开启则是这样  
+```text
+.minecraft
+|*asstes
+|*libraries
+|*saves
+|*resourcepacks
+|*logs
+|*mods
+|*config
+|*saves
+|*crash-reports
+|*versions
+    \1.16.5-optifine
+        |1.16.5-optifine.jar
+        ...
+```
+
+我们极力推荐您打开版本隔离，因为这样能避免模组之间的一部分冲突 [跳转](/launcher/global-version-isolation.html)
+
+## 简单排查
+
+在遇到报错时，您可以通过以下两种方式进行初步分析：
+
+1. **使用社区分析工具**  
+    访问 [CrashMC 报错分析器](https://www.crashmc.com/analyzer)，将崩溃报告内容粘贴进去，工具会自动分析常见问题并给出建议。
+
+2. **借助 AI 辅助分析**  
+    可以将崩溃日志粘贴到 [DeepSeek Chat](https://chat.deepseek.com/)，让 AI 帮助你解读报错内容和可能的解决方法。
+
+3. **进入 HMCL 汉医堂**
+    可以在 HMCL 急诊群中向群友们寻求帮助，他们通常有丰富的经验，能够协助你分析报错并提供解决方案。  
+
+    > qq : 666546887
+
+这三种方式都能帮助您快速定位问题，提高排查效率。 
+
+## 求助他人
+
+*游戏崩的时候会有个窗口，里面可以导出一个压缩包，可以发给别人让别人帮你看，你千万别截图那个窗口 *磕头*
+
+![报错示例截图](/assets/img/docs/error-handbook/image.png)
+在向他人求助时，建议将 `.minecraft` 文件夹下的 `crash-reports` 文件夹和 `logs` 文件夹中的相关文件（如最新的崩溃报告和日志文件）一并打包发送。  
+这样可以让对方更全面地了解你的运行环境和报错详情，从而更高效地帮助你分析和解决问题。请注意，发送前可先检查日志内容，避免泄露个人隐私信息。