Merge remote-tracking branch 'upstream/main'

9 files changed, 1624 insertions, 0 deletions

diff --git a/packages/docs/content/zh/manual/features/authentication.mdx b/packages/docs/content/zh/manual/features/authentication.mdx
new file mode 100644
index 0000000..cd5b622
--- /dev/null
+++ b/packages/docs/content/zh/manual/features/authentication.mdx
@@ -0,0 +1,131 @@
+---
+title: 身份验证
+description: DropOut 中的 Microsoft OAuth 和离线身份验证
+---
+
+# 身份验证
+
+DropOut 支持两种身份验证方法：Microsoft 账户（用于官方 Minecraft）和离线模式（用于测试和离线游玩）。
+
+## Microsoft 身份验证
+
+### 概述
+
+DropOut 使用 **Device Code Flow** 进行 Microsoft 身份验证，具有以下特点：
+- 无需重定向 URL（无需浏览器集成）
+- 适用于任何拥有浏览器的设备
+- 提供简单的基于代码的身份验证
+- 完全符合 Microsoft OAuth 2.0 标准
+
+### 身份验证流程
+
+身份验证链包含多个步骤。DropOut 自动处理这些复杂的交换过程，包括与 Microsoft、Xbox Live 和 Minecraft 服务的交互。如果您对详细的 API 实现感兴趣，请参阅[内部实现](/docs/development/implementation#1-身份验证系统-authentication)。
+
+### 令牌管理
+
+**访问令牌：**
+- 短期有效（通常为 1 小时）
+- 用于游戏身份验证
+- 过期时自动刷新
+
+**刷新令牌：**
+- 长期有效（通常为 90 天）
+- 安全存储在 `accounts.json` 中
+- 用于获取新的访问令牌
+
+**自动刷新：**
+令牌过期时，DropOut 会在您启动游戏时尝试使用刷新令牌自动更新您的登录状态，确保您可以无缝开始游玩。
+
+### 安全考虑
+
+- 令牌存储在平台特定的应用数据目录中
+- 所有 API 调用仅使用 HTTPS
+- 不存储凭据（仅存储令牌）
+- 需要 User-Agent 标头（绕过 MS WAF）
+
+### Microsoft 登录故障排除
+
+**"Device code expired"（设备代码已过期）**
+- 代码在 15 分钟后过期
+- 重新开始登录流程
+
+**"Authorization pending"（授权待处理）**
+- 在等待阶段很正常
+- 在浏览器中完成授权
+
+**"Invalid token"（无效令牌）**
+- 令牌可能已过期
+- 登出后重新登录
+
+**"You don't own Minecraft"（您不拥有 Minecraft）**
+- 验证您的 Microsoft 账户拥有 Minecraft Java Edition
+- 在 https://www.minecraft.net/profile 检查
+
+## 离线身份验证
+
+### 概述
+
+离线模式创建一个不需要互联网连接或 Microsoft 账户的本地账户。这对以下情况很有用：
+- 测试和开发
+- 无网络游玩
+- LAN 多人游戏
+- Mod 开发
+
+### 创建离线账户
+
+1. 在登录屏幕单击"离线模式"
+2. 输入用户名（3-16 个字符）
+3. 单击"创建账户"
+
+### 工作原理
+
+**UUID 生成：**
+离线模式使用基于用户名的确定性 UUID 生成算法（UUID v3）。这意味着在同一个启动器实例中，相同的用户名始终会获得相同的 UUID，从而保持单人游戏存档的一致性。
+
+- 确定性：相同的用户名 = 相同的 UUID
+- 无需网络请求
+
+**身份验证：**
+- 返回 `"null"` 作为访问令牌
+- Minecraft 在离线模式下接受空令牌
+- 用户名和 UUID 本地存储
+
+### 限制
+
+- 无法加入在线服务器
+- 不支持皮肤
+- 不支持披风
+- 无法使用 Microsoft 账户功能
+
+## 账户管理
+
+### 切换账户
+
+目前 DropOut 一次只支持一个活跃账户。多账户支持正在规划中。
+
+**切换账户的步骤：**
+1. 登出当前账户
+2. 使用新账户登录
+
+### 账户存储
+
+账户数据存储在应用文件夹的 `accounts.json` 中。该文件包含已登录账户的加密令牌、过期时间和基本的个人资料信息。
+
+### 删除账户
+
+删除账户的步骤：
+1. 打开设置
+2. 导航到账户
+3. 单击"登出"
+4. 或手动删除 `accounts.json`
+
+## API 参考
+
+关于身份验证的底层实现、OAuth 2.0 流程细节以及相关的 Tauri 命令接口，请参考开发文档：[实现细节：身份验证](../development/implementation.mdx#1-身份验证系统-authentication)。
+
+## 最佳实践
+
+1. **对官方服务器使用 Microsoft 账户**：为了能够加入官方服务器并使用正版皮肤，请务必使用 Microsoft 账户。
+2. **保护令牌安全**：不要向他人分享 `accounts.json` 文件或其内容，因为其中包含您的登录凭据。
+3. **定期刷新令牌**：长时间未使用的离线账户或过期的 Microsoft 令牌可以通过重新登录或启动游戏来刷新。
+4. **仅在测试时使用离线模式**：离线模式不支持皮肤和部分多人游戏功能。
diff --git a/packages/docs/content/zh/manual/features/index.mdx b/packages/docs/content/zh/manual/features/index.mdx
new file mode 100644
index 0000000..bb53ce2
--- /dev/null
+++ b/packages/docs/content/zh/manual/features/index.mdx
@@ -0,0 +1,176 @@
+---
+title: 功能概览
+description: DropOut 所有功能的综合指南
+---
+
+# 功能概览
+
+DropOut 功能丰富，既适合休闲玩家也适合高级用户。本指南涵盖所有主要功能。
+
+## 核心功能
+
+<Cards>
+  <Card 
+    title="身份验证" 
+    href="authentication"
+    description="Microsoft OAuth 和离线身份验证"
+  />
+  <Card 
+    title="Java 管理" 
+    href="java"
+    description="Java 运行时的自动检测和安装"
+  />
+  <Card 
+    title="模组加载器" 
+    href="mod-loaders"
+    description="Fabric 和 Forge 支持，轻松安装"
+  />
+  <Card 
+    title="实例" 
+    href="instances"
+    description="具有独立配置的隔离游戏环境"
+  />
+  <Card 
+    title="下载" 
+    href="downloads"
+    description="快速并发下载，支持断点续传"
+  />
+  <Card 
+    title="AI 助手" 
+    href="assistant"
+    description="内置 AI 助手用于故障排除和指导"
+  />
+</Cards>
+
+## 快速功能矩阵
+
+| 功能 | 状态 | 描述 |
+|---------|--------|-------------|
+| Microsoft 身份验证 | 完成 | 使用设备代码流的 OAuth 2.0 |
+| 离线身份验证 | 完成 | 用于离线游玩的本地账户 |
+| 令牌自动刷新 | 完成 | 自动刷新过期的令牌 |
+| Java 自动检测 | 完成 | 扫描系统中的 Java 安装 |
+| Java 下载 | 完成 | 下载 Adoptium JDK/JRE 版本 |
+| Fabric 支持 | 完成 | 安装和启动 Fabric 加载器 |
+| Forge 支持 | 完成 | 安装和启动 Forge 加载器 |
+| 实例系统 | 完成 | 隔离的游戏环境 |
+| GitHub 集成 | 完成 | 查看发布和更新日志 |
+| 并发下载 | 完成 | 多线程资源下载 |
+| 断点续传 | 完成 | 恢复中断的下载 |
+| AI 助手 | 完成 | 内置故障排除助手 |
+| 配置编辑器 | 完成 | JSON/TOML 配置编辑器 |
+| 自定义分辨率 | 完成 | 设置游戏窗口尺寸 |
+| 内存分配 | 完成 | 自定义 JVM 内存设置 |
+| 多账户 | 进行中 | 在多个账户之间切换 |
+| 模组管理器 | 计划中 | 在启动器中启用/禁用模组 |
+| 启动器自动更新 | 计划中 | 自我更新机制 |
+| 自定义游戏目录 | 计划中 | 选择游戏文件位置 |
+| 导入配置文件 | 计划中 | 从 MultiMC/Prism 导入 |
+
+## 性能功能
+
+### 并发下载
+- 可配置的线程数（默认：10）
+- 并行资源和库下载
+- 每个文件的进度跟踪
+- ETA 计算
+
+### 断点续传支持
+- 中断的下载自动恢复
+- `.part` 文件跟踪进度
+- 大文件的多段下载
+- 用于状态跟踪的元数据文件
+
+### 缓存
+- Java 目录缓存 24 小时
+- 本地缓存版本清单
+- 资源索引缓存
+- 库去重
+
+## 用户界面功能
+
+### 现代设计
+- 强制暗色模式保护眼睛
+- 粒子背景效果
+- 简洁、无干扰的布局
+- 响应式设计
+
+### 实时反馈
+- 实时下载进度
+- 游戏控制台输出
+- 日志流
+- Toast 通知
+
+### 设置管理
+- 内存分配滑块
+- 分辨率自定义
+- Java 路径选择
+- 线程数配置
+- 自定义 JVM 参数
+
+## 高级功能
+
+### 版本继承
+模组版本（Fabric/Forge）自动从父原版版本继承：
+- 从父版本 + 模组加载器合并库
+- 组合并去重参数
+- 从原版版本继承资源
+
+### 原生库提取
+- 特定平台的原生提取
+- 自动清理
+- 正确的库路径配置
+
+### 规则引擎
+- 特定操作系统的库过滤
+- 功能标志支持
+- 架构检测
+
+### 下载队列持久化
+- 保存未完成的下载
+- 启动器重启后恢复
+- 队列优先级管理
+
+## 开发者功能
+
+### 配置编辑器
+内置 JSON/TOML 编辑器，具有：
+- 语法高亮
+- 验证
+- 快速访问所有配置
+
+### 日志访问
+- 实时游戏日志
+- 启动器调试日志
+- 复制/导出功能
+
+### AI 助手
+- 故障排除指导
+- 错误分析
+- 配置帮助
+- 文档搜索
+
+## 即将推出
+
+### 多账户管理
+- 轻松切换账户
+- 账户配置文件
+- 快速切换
+
+### 模组管理器
+- 浏览和安装模组
+- 启用/禁用模组
+- 模组兼容性检查
+- 版本管理
+
+### 配置文件导入
+- 从 MultiMC 导入
+- 从 Prism Launcher 导入
+- 从其他启动器导入
+- 保留设置和存档
+
+### 启动器自动更新
+- 后台更新检查
+- 一键更新
+- 版本历史
+- 回滚支持
diff --git a/packages/docs/content/zh/manual/features/java.mdx b/packages/docs/content/zh/manual/features/java.mdx
new file mode 100644
index 0000000..6894ec1
--- /dev/null
+++ b/packages/docs/content/zh/manual/features/java.mdx
@@ -0,0 +1,286 @@
+---
+title: Java 管理
+description: 自动 Java 检测、下载和安装
+---
+
+# Java 管理
+
+DropOut 提供全面的 Java 管理，自动检测已安装的版本并根据需要下载新版本。
+
+## 自动检测
+
+### 系统扫描
+
+DropOut 扫描多个位置查找 Java 安装：
+
+**Linux:**
+- `/usr/lib/jvm/`
+- `/usr/java/`
+- `$JAVA_HOME`
+- `PATH` 环境变量
+
+**macOS:**
+- `/Library/Java/JavaVirtualMachines/`
+- `/System/Library/Java/JavaVirtualMachines/`
+- `$JAVA_HOME`
+- `PATH` 环境变量
+
+**Windows:**
+- `C:\Program Files\Java\`
+- `C:\Program Files (x86)\Java\`
+- `%JAVA_HOME%`
+- `PATH` 环境变量
+- Windows 注册表
+
+### 版本检测
+
+对于找到的每个 Java 安装，DropOut 会：
+1. 运行 `java -version` 获取版本信息
+2. 解析主要版本（8、11、17、21 等）
+3. 检测架构（x64、ARM64）
+4. 识别供应商（Oracle、Adoptium 等）
+
+### 结果
+
+所有检测到的 Java 安装都显示在设置 → Java 中：
+- 版本号
+- 安装路径
+- 架构
+- 当前选择状态
+
+## Java 下载
+
+### Adoptium 集成
+
+DropOut 集成了 Eclipse Adoptium API 以下载高质量的免费 JDK/JRE 构建版本。
+
+**支持的版本：**
+- Java 8（LTS）
+- Java 11（LTS）
+- Java 17（LTS）
+- Java 21（LTS）
+- Java 23+（最新版）
+
+**功能：**
+- 自动平台检测
+- 特定架构的构建版本
+- JDK 或 JRE 选择
+- 校验和验证
+
+### 下载过程
+
+1. 导航到设置 → Java
+2. 点击"下载 Java"
+3. 选择版本（例如 Java 17）
+4. 选择 JDK 或 JRE
+5. 点击下载
+6. 等待下载和解压
+
+**进度跟踪：**
+- 实时下载速度
+- ETA 计算
+- 解压进度
+- 安装确认
+
+### 目录管理
+
+DropOut 会缓存可用的 Java 版本列表，以加快加载速度，并自动处理不同步时的刷新工作。
+
+**刷新：**
+- 24 小时后自动刷新
+- 设置中手动刷新
+- 下载失败时强制刷新
+
+## 安装
+
+### 下载目录
+
+下载的 Java 运行时安装到：
+
+```
+~/.local/share/com.dropout.launcher/java/  (Linux)
+~/Library/Application Support/com.dropout.launcher/java/  (macOS)
+%APPDATA%/com.dropout.launcher/java/  (Windows)
+```
+
+### 目录结构
+
+```
+java/
+├── jdk-17.0.9+9/
+│   ├── bin/
+│   │   └── java (或 java.exe)
+│   └── lib/
+├── jdk-21.0.1+12/
+│   ├── bin/
+│   └── lib/
+└── download_queue.json
+```
+
+### 解压
+
+1. 下载到 `.part` 文件
+2. 验证校验和
+3. 解压存档：
+   - Linux/macOS 上的 `.tar.gz`
+   - Windows 上的 `.zip`
+4. 移动到 `java/<version>/` 目录
+5. 设置可执行权限（Unix）
+
+## 配置
+
+### 内存分配
+
+在设置中配置 JVM 内存：
+
+**最小内存：**
+- 默认：1024 MB
+- 推荐：原版 2048 MB
+- 推荐：模组 4096+ MB
+
+**最大内存：**
+- 默认：4096 MB
+- 根据系统 RAM 调整
+- 为操作系统和其他应用留出 4GB
+
+**格式：**
+```bash
+-Xms1024M -Xmx4096M
+```
+
+### 自定义 JVM 参数
+
+为高级配置添加自定义 JVM 参数。DropOut 为您提供了经过优化的默认配置，通常无需手动更改。
+
+**参数说明：**
+- **垃圾回收 (GC)**: 默认使用 G1GC，能够大幅减少大规模模组环境下的游戏卡顿。
+- **实验性选项**: 部分性能优化参数需要开启此开关才能生效。
+- **内存分块**: 优化大内存环境下的数据读写效率。
+
+关于每个参数的具体作用、推荐数值以及技术实现，请参考 [实现细节：JVM 参数优化](../development/implementation.mdx#参数优化与-jvm-配置)。
+
+### Java 路径选择
+
+**自动选择：**
+- DropOut 为每个 Minecraft 版本推荐最佳 Java 版本
+- Java 8 用于 Minecraft 1.12.2 及更早版本
+- Java 17 用于 Minecraft 1.18-1.20.4
+- Java 21 用于 Minecraft 1.20.5+
+
+**手动选择：**
+1. 前往设置 → Java
+2. 从检测到的安装中选择
+3. 或指定自定义路径
+
+## 版本推荐
+
+### Minecraft 版本 → Java 版本
+
+| Minecraft 版本 | 推荐 Java | 最低 Java |
+|-------------------|------------------|--------------|
+| 1.7.10 及更早  | Java 8           | Java 8       |
+| 1.8 - 1.12.2      | Java 8           | Java 8       |
+| 1.13 - 1.16.5     | Java 8 或 11     | Java 8       |
+| 1.17 - 1.17.1     | Java 16          | Java 16      |
+| 1.18 - 1.20.4     | Java 17          | Java 17      |
+| 1.20.5+           | Java 21          | Java 21      |
+
+### 模组 Minecraft
+
+**Fabric:**
+- 通常与原版要求匹配
+- 一些模组可能需要更新的 Java
+
+**Forge:**
+- 可能需要特定的 Java 版本
+- 检查模组加载器文档
+- 通常需要完全匹配版本
+
+## 故障排除
+
+### 未检测到 Java
+
+**问题：** 已安装的 Java 未显示
+
+**解决方案：**
+1. 验证 Java 在标准位置
+2. 检查 `JAVA_HOME` 环境变量
+3. 将 Java `bin` 目录添加到 `PATH`
+4. 重启 DropOut
+5. 手动选择路径
+
+### 下载失败
+
+**问题：** Java 下载未完成
+
+**解决方案：**
+1. 检查互联网连接
+2. 验证磁盘空间
+3. 尝试不同版本
+4. 清除下载队列
+5. 从 Adoptium 手动下载
+
+### Java 版本错误
+
+**问题：** 由于 Java 版本导致游戏崩溃
+
+**解决方案：**
+1. 检查 Minecraft 版本要求
+2. 下载正确的 Java 版本
+3. 在设置中选择适当的 Java
+4. 验证 Java 路径正确
+
+### 内存不足错误
+
+**问题：** 游戏因内存错误崩溃
+
+**解决方案：**
+1. 增加最大内存分配
+2. 关闭其他应用程序
+3. 升级系统 RAM
+4. 使用 64 位 Java
+5. 优化 JVM 参数
+
+### 性能问题
+
+**问题：** 低 FPS 或卡顿
+
+**解决方案：**
+1. 调整内存分配（不要太高！）
+2. 启用 G1GC 垃圾收集器
+3. 添加性能 JVM 参数
+4. 如兼容使用更新的 Java 版本
+5. 为整合包分配 4-8GB
+
+## 最佳实践
+
+### 对于玩家
+
+1. **使用 Adoptium 构建版本** - 免费、高质量、维护良好
+2. **Java 与 Minecraft 版本匹配** - 检查版本要求
+3. **不要过度分配内存** - 为操作系统留出 RAM
+4. **保持 Java 更新** - 安全性和性能
+5. **使用 64 位 Java** - 大内存所需
+
+## 高级主题
+
+### 自定义 Java 安装
+
+使用自定义 Java 安装：
+
+1. 手动安装 Java
+2. 记录安装路径
+3. 在 DropOut 设置 → Java 中
+4. 点击"自定义路径"
+5. 浏览到 Java 可执行文件
+6. 验证版本正确
+
+### GraalVM
+
+GraalVM 支持高级用户：
+
+1. 从 graalvm.org 下载 GraalVM
+2. 手动安装
+3. 作为自定义 Java 添加到 DropOut
+4. 可能提高性能
+5. 使用前彻底测试
diff --git a/packages/docs/content/zh/manual/features/meta.json b/packages/docs/content/zh/manual/features/meta.json
new file mode 100644
index 0000000..2fb2ded
--- /dev/null
+++ b/packages/docs/content/zh/manual/features/meta.json
@@ -0,0 +1,9 @@
+{
+  "title": "功能特性",
+  "pages": [
+    "index",
+    "authentication",
+    "java",
+    "mod-loaders"
+  ]
+}
diff --git a/packages/docs/content/zh/manual/features/mod-loaders.mdx b/packages/docs/content/zh/manual/features/mod-loaders.mdx
new file mode 100644
index 0000000..cbd8148
--- /dev/null
+++ b/packages/docs/content/zh/manual/features/mod-loaders.mdx
@@ -0,0 +1,242 @@
+---
+title: 模组加载器
+description: Fabric 和 Forge 安装和管理
+---
+
+# 模组加载器
+
+DropOut 支持两个最流行的 Minecraft 模组加载器：Fabric 和 Forge。两者都可以直接从启动器中轻松安装和管理。
+
+## Fabric 支持
+
+### 概述
+
+Fabric 是一个轻量级、模块化的模组工具链，专注于：
+- 快速更新至新的 Minecraft 版本
+- 干净、极简的 API
+- 强大的开发者社区
+- 优异的性能
+
+### 安装
+
+1. 导航至 **Versions** 选项卡
+2. 点击 **"Install Fabric"**
+3. 选择 Minecraft 版本
+4. 选择 Fabric 加载器版本
+5. 点击 **"Install"**
+6. 等待安装完成
+
+### 工作原理
+
+DropOut 集成了 Fabric 的 Meta API，能够自动获取兼容的加载器版本。在后台，它会生成版本 JSON，处理库依赖，并利用继承系统确保与原版 Minecraft 的完美兼容。详细的 JSON 结构可参阅[技术细节](/docs/development/implementation#fabric-集成)。
+
+### Fabric 版本
+
+**加载器版本：**
+- 最新稳定版（推荐）
+- 用于兼容性的特定版本
+- Beta/快照版本
+
+**游戏版本：**
+- 所有 1.14+ 的 Minecraft 版本
+- 支持快照版本
+- 支持战斗测试版本
+
+### 库管理
+
+Fabric 的依赖项通常托管在其官方 Maven 仓库中。DropOut 自动解析并下载所有必需的库文件。
+
+### Fabric API
+
+Fabric Loader ≠ Fabric API：
+- **Fabric Loader**: 模组加载器（由 DropOut 安装）
+- **Fabric API**: 库模组（单独下载）
+
+许多模组需要 Fabric API：
+1. 从 [Modrinth](https://modrinth.com/mod/fabric-api) 或 [CurseForge](https://www.curseforge.com/minecraft/mc-mods/fabric-api) 下载
+2. 放置在实例的 `mods/` 文件夹中
+
+## Forge 支持
+
+### 概述
+
+Forge 是原始的、最流行的 Minecraft 模组加载器：
+- 广泛的模组生态系统
+- 成熟的 API
+- 广泛的版本支持
+- 庞大的社区
+
+### 安装
+
+1. 导航至 **Versions** 选项卡
+2. 点击 **"Install Forge"**
+3. 选择 Minecraft 版本
+4. 选择 Forge 版本
+5. 点击 **"Install"**
+6. 等待安装程序运行
+7. 安装完成
+
+### 工作原理
+
+DropOut 会为您下载 Forge 安装程序。通过在后台以无头模式运行安装程序，我们能够生成所需的版本配置文件并处理复杂的补丁程序。详细实现请参考[技术实现](/docs/development/implementation#forge-支持)。
+
+### Forge 版本
+
+**发布类型：**
+- **Latest**: 最新的稳定版本
+- **Recommended**: 生产环境中最稳定的版本
+- **Specific**: 版本锁定以确保兼容性
+
+**Minecraft 版本支持：**
+- 旧版本 (1.6.4+)
+- 现代版本 (1.13+)
+- 最新版本 (1.20+)
+
+### 库管理
+
+Forge 的运行依赖于大量的库文件，包括底层的 `fmlloader` 和字节码操作库。DropOut 能够自动解析复杂的依赖树，并从 Forge 官方 Maven 仓库以及 Minecraft 官方库中获取这些文件。
+
+关于 Forge 库的详细解析逻辑，请参考[实现细节：Forge 核心库解析](../development/implementation.mdx#核心库解析)。
+
+### Forge 处理器
+
+某些 Forge 版本在安装期间运行"处理器"：
+- 字节码操纵
+- 库修补
+- 映射生成
+
+DropOut 自动处理这些操作。
+
+## 版本继承
+
+Fabric 和 Forge 都利用了 Minecraft 的版本继承机制。在这种模式下，模组加载器的版本 JSON 仅包含相对于原版版本的增量变化，通过 `inheritsFrom` 字段递归向上寻址。
+
+DropOut 的启动引擎能够自动处理这种复杂的合并：
+- **库 (Libraries)**：自动排重并确保加载顺序。
+- **参数 (Arguments)**：合并游戏参数与 JVM 参数。
+- **主类 (Main Class)**：自动切换至模组加载器的入口点。
+
+具体的合并逻辑和代码实现请查看[实现细节：版本合并](../development/implementation.mdx#版本合并机制)。
+
+## 对比
+
+| 功能 | Fabric | Forge |
+|---------|--------|-------|
+| **性能** | 优异 | 良好 |
+| **更新速度** | 非常快 | 中等 |
+| **模组选择** | 增长中 | 广泛 |
+| **API 简洁性** | 简洁 | 复杂 |
+| **版本支持** | 1.14+ | 1.6.4+ |
+| **开发者友好** | 非常友好 | 中等 |
+| **稳定性** | 优异 | 优异 |
+
+## 安装模组
+
+### Fabric 模组
+
+1. 创建/选择实例
+2. 确保 Fabric 已安装
+3. 从以下位置下载模组：
+   - [Modrinth](https://modrinth.com/)
+   - [CurseForge](https://www.curseforge.com/)
+   - [GitHub Releases](https://github.com/)
+4. 将 `.jar` 文件放置在 `instances/<name>/mods/`
+5. 启动游戏
+
+**兼容性：**
+- 检查 Minecraft 版本
+- 检查 Fabric Loader 版本
+- 检查 Fabric API 需求
+- 阅读模组依赖项
+
+### Forge 模组
+
+1. 创建/选择实例
+2. 确保 Forge 已安装
+3. 从以下位置下载模组：
+   - [CurseForge](https://www.curseforge.com/)
+   - [Modrinth](https://modrinth.com/)
+4. 将 `.jar` 文件放置在 `instances/<name>/mods/`
+5. 启动游戏
+
+**兼容性：**
+- 精确检查 Minecraft 版本
+- 检查 Forge 版本范围
+- 阅读模组依赖项
+- 检查冲突
+
+## 故障排除
+
+### Fabric 问题
+
+**"Fabric Loader not found"**
+- 重新安装 Fabric
+- 检查版本 JSON 是否存在
+- 验证库是否已下载
+
+**"Mixin apply failed"**
+- 模组不兼容
+- 删除冲突的模组
+- 更新 Fabric Loader
+
+**"Fabric API required"**
+- 下载 Fabric API
+- 匹配 Minecraft 版本
+- 放置在 mods 文件夹中
+
+### Forge 问题
+
+**"Forge installer failed"**
+- 验证 Java 安装
+- 检查磁盘空间
+- 尝试旧版本的 Forge
+- 检查日志获取详细信息
+
+**"Missing dependencies"**
+- 安装所需的模组
+- 检查模组版本兼容性
+- 仔细阅读错误消息
+
+**"Class not found"**
+- Forge 版本不匹配
+- 重新安装 Forge
+- 验证库是否已下载
+
+### 常见模组问题
+
+**启动时崩溃：**
+1. 检查崩溃报告
+2. 识别有问题的模组
+3. 删除或更新模组
+4. 使用最少的模组测试
+5. 逐步添加模组回来
+
+**性能问题：**
+1. 安装了太多模组
+2. 增加内存分配
+3. 安装性能模组：
+   - Fabric: Sodium, Lithium
+   - Forge: OptiFine, Magnesium
+4. 删除资源密集型模组
+
+## API 参考
+
+如果您正在为 DropOut 开发自定义主题或进行二次开发，可以使用我们提供的 Tauri 命令和事件接口。
+
+具体的命令接口、参数说明及进度推送事件详见开发文档：[实现细节：模组加载器 API](../development/implementation.mdx#api-参考)。
+
+## 最佳实践
+
+1. **每个实例选择一个模组加载器**：不要在同一个实例中混用 Fabric 和 Forge。
+2. **精确匹配版本**：确保 Minecraft 版本与模组加载器版本高度兼容。
+3. **安装前阅读要求**：许多模组需要额外的依赖库（如 Fabric API 或 Architectury）。
+4. **循序渐进**：首次构建模组包时，应分批添加模组以便于排查问题。
+5. **养成备份习惯**：在安装大型模组包或进行版本大更新前，请备份您的存档。
+
+更多面向开发者和模组包创作者的进阶指南，请参阅[开发文档：分发最佳实践](../development/implementation.mdx#对于模组包modpack创建者)。
+
+## 规划与展望
+
+我们致力于为 DropOut 打造最便捷的模组体验。未来，我们计划引入模组浏览器、自动更新监控以及智能冲突检测等功能。
+
+详见[开发路线图](../development/implementation.mdx#模组管理系统)。
diff --git a/packages/docs/content/zh/manual/getting-started.mdx b/packages/docs/content/zh/manual/getting-started.mdx
new file mode 100644
index 0000000..5d8c8c5
--- /dev/null
+++ b/packages/docs/content/zh/manual/getting-started.mdx
@@ -0,0 +1,152 @@
+---
+title: 快速开始
+description: 使用 DropOut Minecraft 启动器的快速入门指南
+---
+
+# 快速开始
+
+DropOut 是一个使用 Tauri v2 构建的现代化、可复现、开发者级别的 Minecraft 启动器。本指南将帮助你开始安装和使用 DropOut。
+
+## 安装
+
+### 下载预编译二进制文件
+
+从[发布页面](https://github.com/HsiangNianian/DropOut/releases)下载适合你平台的最新版本。
+
+| 平台           | 文件                |
+| -------------- | ------------------- |
+| Linux x86_64   | `.deb`, `.AppImage` |
+| Linux ARM64    | `.deb`, `.AppImage` |
+| macOS ARM64    | `.dmg`              |
+| Windows x86_64 | `.msi`, `.exe`      |
+| Windows ARM64  | `.msi`, `.exe`      |
+
+### Linux 安装
+
+#### 使用 .deb 包
+
+```bash
+sudo dpkg -i dropout_*.deb
+# 如果需要，修复依赖
+sudo apt-get install -f
+```
+
+#### 使用 AppImage
+
+```bash
+chmod +x dropout_*.AppImage
+./dropout_*.AppImage
+```
+
+### macOS 安装
+
+1. 打开下载的 `.dmg` 文件
+2. 将 DropOut 拖到应用程序文件夹
+3. 如果看到安全警告，转到系统偏好设置 → 安全性与隐私并允许该应用
+
+### Windows 安装
+
+#### 使用 .msi 安装程序
+
+1. 双击 `.msi` 文件
+2. 按照安装向导操作
+3. 从开始菜单启动 DropOut
+
+#### 使用 .exe 便携版
+
+1. 双击 `.exe` 文件
+2. DropOut 将直接运行，无需安装
+
+## 首次启动
+
+首次启动 DropOut 时，你需要：
+
+1. **选择认证方式**
+   - **微软账户**: 推荐用于官方 Minecraft
+   - **离线模式**: 用于测试或离线游戏
+
+2. **配置 Java 运行时**
+   - DropOut 将自动检测已安装的 Java 版本
+   - 如果需要，你可以直接从启动器下载 Java
+
+3. **选择 Minecraft 版本**
+   - 浏览可用的 Minecraft 版本
+   - 选择原版或模组版本（Fabric/Forge）
+
+## 快速入门教程
+
+### 1. 登录
+
+<Cards>
+  <Card title="微软账户" description="使用你的官方 Minecraft 账户登录" />
+  <Card title="离线模式" description="创建本地配置文件进行离线游戏" />
+</Cards>
+
+**微软登录：**
+
+1. 点击"使用微软登录"
+2. 将显示设备代码
+3. 访问显示的 URL 并输入代码
+4. 授权应用程序
+5. 返回 DropOut - 你将自动登录
+
+**离线登录：**
+
+1. 点击"离线模式"
+2. 输入用户名
+3. 点击"创建账户"
+
+### 2. 安装 Minecraft
+
+1. 导航到**版本**标签
+2. 浏览可用的 Minecraft 版本
+3. 点击一个版本进行安装
+4. 等待下载完成
+
+### 3. 启动游戏
+
+1. 转到**主页**标签
+2. 从下拉菜单中选择你想要的版本
+3. 如果需要，调整设置：
+   - 内存分配（RAM）
+   - 窗口分辨率
+   - Java 路径
+4. 点击**启动游戏**
+5. 在控制台中监视启动过程
+
+## 下一步
+
+<Cards>
+  <Card title="功能特性" href="/docs/manual/features" description="了解 DropOut 提供的所有功能" />
+  <Card title="实例管理" href="/docs/manual/features/instances" description="创建隔离的游戏环境" />
+  <Card
+    title="模组加载器"
+    href="/docs/manual/features/mod-loaders"
+    description="安装和管理 Fabric 和 Forge"
+  />
+  <Card title="故障排除" href="/docs/troubleshooting" description="常见问题和解决方案" />
+</Cards>
+
+## 系统要求
+
+### 最低要求
+
+- **操作系统**: Windows 10+、macOS 11+ 或 Linux（基于 Debian）
+- **内存**: 4GB（推荐 8GB 用于模组 Minecraft）
+- **存储**: 启动器 + 游戏文件需要 2GB
+- **Java**: 如果找不到，DropOut 会自动安装
+
+### 推荐配置
+
+- **操作系统**: 你操作系统的最新稳定版本
+- **内存**: 16GB 以获得带模组的最佳性能
+- **存储**: 10GB+ 用于多个版本和模组
+- **Java**: Java 17 或 21（由 DropOut 管理）
+
+## 获取帮助
+
+如果遇到问题：
+
+- 查看[故障排除指南](/docs/troubleshooting)
+- 在 [GitHub Issues](https://github.com/HsiangNianian/DropOut/issues) 上报告 bug
+- 加入我们的社区讨论
diff --git a/packages/docs/content/zh/manual/index.mdx b/packages/docs/content/zh/manual/index.mdx
new file mode 100644
index 0000000..1b74743
--- /dev/null
+++ b/packages/docs/content/zh/manual/index.mdx
@@ -0,0 +1,95 @@
+---
+title: 欢迎使用 DropOut
+description: 现代化、可复现、开发者级别的 Minecraft 启动器
+---
+
+# 欢迎使用 DropOut
+
+DropOut 是一个使用 Tauri v2 构建的现代 Minecraft 启动器，专为重视控制、透明度和长期稳定性的玩家设计。
+
+<div style={{ textAlign: 'center', margin: '2rem 0' }}>
+  <img src="/image.png" alt="DropOut 启动器" style={{ maxWidth: '700px', borderRadius: '8px' }} />
+</div>
+
+## 为什么选择 DropOut？
+
+大多数 Minecraft 启动器专注于让你进入游戏。DropOut 专注于保持你的游戏**稳定**、**可调试**和**可复现**。
+
+- 你的实例昨天还能用，今天就坏了？→ **DropOut 让它可追溯。**
+- 分享模组包意味着打包数GB的文件？→ **DropOut 分享精确的依赖清单。**
+- Java、加载器、模组、配置不同步？→ **DropOut 将它们锁定在一起。**
+
+这个启动器是为重视控制、透明度和长期稳定性的玩家构建的。
+
+## 快速链接
+
+<Cards>
+  <Card 
+    title="快速开始" 
+    href="getting-started"
+    description="在几分钟内安装和设置 DropOut"
+  />
+  <Card 
+    title="功能特性" 
+    href="features"
+    description="探索 DropOut 的所有功能"
+  />
+  <Card 
+    title="架构设计" 
+    href="architecture"
+    description="了解技术设计"
+  />
+  <Card 
+    title="开发指南" 
+    href="development"
+    description="构建和贡献代码"
+  />
+</Cards>
+
+## 核心特性
+
+### 高性能
+使用 Rust 和 Tauri 构建，资源占用最小，启动速度极快。
+
+### 现代化界面
+简洁、无干扰的界面，使用 Svelte 5、Tailwind CSS 4 和粒子效果。
+
+### 安全认证
+微软 OAuth 2.0 设备代码流和离线认证支持。
+
+### 模组加载器支持
+内置 Fabric 和 Forge 安装，自动版本管理。
+
+### Java 管理
+自动检测已安装的 Java 版本，集成 Adoptium JDK/JRE 下载器。
+
+### 实例系统
+独立的游戏环境，具有独立的配置、模组和存档。
+
+### AI 助手
+内置 AI 帮助，用于故障排除、配置和指导。
+
+### 快速下载
+并发资源和库下载，支持断点续传和进度跟踪。
+
+## 技术栈
+
+- **后端**: Rust + Tauri v2
+- **前端**: Svelte 5 with runes
+- **样式**: Tailwind CSS 4
+- **构建工具**: Vite with Rolldown
+- **文档**: Fumadocs with React Router
+
+## 社区
+
+- **GitHub**: [HydroRoll-Team/DropOut](https://github.com/HydroRoll-Team/DropOut)
+- **问题反馈**: [报告 bug](https://github.com/HydroRoll-Team/DropOut/issues)
+- **开发路线图**: [查看开发路线图](https://roadmap.sh/r/minecraft-launcher-dev)
+
+## 许可证
+
+DropOut 是在 MIT 许可证下的开源软件。
+
+---
+
+准备好开始了吗？查看[快速开始指南](getting-started)！
diff --git a/packages/docs/content/zh/manual/meta.json b/packages/docs/content/zh/manual/meta.json
new file mode 100644
index 0000000..cc3767a
--- /dev/null
+++ b/packages/docs/content/zh/manual/meta.json
@@ -0,0 +1,10 @@
+{
+  "title": "使用文档",
+  "pages": [
+    "index",
+    "getting-started",
+    "architecture",
+    "features",
+    "troubleshooting"
+  ]
+}
diff --git a/packages/docs/content/zh/manual/troubleshooting.mdx b/packages/docs/content/zh/manual/troubleshooting.mdx
new file mode 100644
index 0000000..ba0ec66
--- /dev/null
+++ b/packages/docs/content/zh/manual/troubleshooting.mdx
@@ -0,0 +1,523 @@
+---
+title: 故障排除
+description: DropOut 启动器常见问题和解决方案
+---
+
+# 故障排除
+
+本指南涵盖常见问题及其解决方案。如果在这里找不到你的问题，请在 GitHub 上[提交 issue](https://github.com/HydroRoll-Team/DropOut/issues)。
+
+## 安装问题
+
+### Linux：缺少依赖
+
+**问题：** 安装时提示缺少库
+
+**解决方案：**
+```bash
+# Ubuntu/Debian
+sudo apt update
+sudo apt install libwebkit2gtk-4.1-0 libgtk-3-0
+
+# Fedora
+sudo dnf install webkit2gtk4.1 gtk3
+
+# Arch
+sudo pacman -S webkit2gtk gtk3
+```
+
+### macOS："应用程序已损坏"
+
+**问题：** macOS 提示 DropOut 已损坏无法打开
+
+**解决方案：**
+1. 打开终端
+2. 运行：`xattr -cr /Applications/DropOut.app`
+3. 再次尝试打开
+4. 或者：系统偏好设置 → 安全性 → 仍要打开
+
+### Windows：SmartScreen 警告
+
+**问题：** Windows SmartScreen 阻止安装程序
+
+**解决方案：**
+1. 点击"更多信息"
+2. 点击"仍要运行"
+3. 这对于没有扩展验证证书的新应用是正常的
+
+## 身份验证问题
+
+### Microsoft 登录失败
+
+**问题：** 无法完成 Microsoft 登录
+
+**可能原因和解决方案：**
+
+**1. 设备代码过期：**
+- 代码在 15 分钟后过期
+- 重新开始登录过程
+- 更快地完成授权
+
+**2. 网络问题：**
+- 检查互联网连接
+- 暂时禁用 VPN
+- 检查防火墙设置
+- 尝试不同的网络
+
+**3. Microsoft 账户问题：**
+- 验证账户拥有 Minecraft Java 版
+- 在 https://www.minecraft.net/profile 检查
+- 确保账户未被封禁
+
+**4. 浏览器问题：**
+- 尝试不同的浏览器
+- 清除浏览器缓存
+- 禁用广告拦截器
+- 使用无痕/隐私模式
+
+### 令牌刷新失败
+
+**问题：** 令牌刷新失败，必须频繁重新登录
+
+**解决方案：**
+1. 完全退出登录
+2. 从应用数据目录删除 `accounts.json`
+3. 重新登录
+4. 如果持续存在，检查 Microsoft 账户状态
+
+### 离线登录不工作
+
+**问题：** 无法创建离线账户
+
+**解决方案：**
+- 用户名必须是 3-16 个字符
+- 仅使用字母、数字、下划线
+- 不使用特殊字符
+- 不使用空格
+
+## 游戏启动问题
+
+### 找不到 Java
+
+**问题：** "未找到 Java 安装"
+
+**解决方案：**
+
+**1. 自动检测现有 Java：**
+- 设置 → Java → 检测安装
+- 如果找到，选择它
+- 如果未找到，进行步骤 2
+
+**2. 通过 DropOut 下载 Java：**
+- 设置 → Java → 下载 Java
+- 选择适当的版本：
+  - Java 8 用于 Minecraft 1.12.2 及更早版本
+  - Java 17 用于 Minecraft 1.18-1.20.4
+  - Java 21 用于 Minecraft 1.20.5+
+
+**3. 手动安装 Java：**
+- 从 [Adoptium](https://adoptium.net/) 下载
+- 安装到系统
+- 重启 DropOut
+- 再次检测
+
+### Java 版本错误
+
+**问题：** 游戏崩溃并提示"不支持的类文件版本"
+
+**解决方案：**
+将 Java 版本与 Minecraft 版本匹配：
+
+| Minecraft 版本 | Java 版本 |
+|-------------------|--------------|
+| 1.7.10 及更早  | Java 8       |
+| 1.8 - 1.12.2      | Java 8       |
+| 1.13 - 1.16.5     | Java 8 或 11 |
+| 1.17 - 1.17.1     | Java 16      |
+| 1.18 - 1.20.4     | Java 17      |
+| 1.20.5+           | Java 21      |
+
+### 内存不足错误
+
+**问题：** 游戏崩溃并显示 `java.lang.OutOfMemoryError`
+
+**解决方案：**
+
+**1. 增加内存分配：**
+- 设置 → 内存
+- 增加最大内存：
+  - 原版：最少 4GB
+  - 轻度模组：6GB
+  - 重度整合包：8-12GB
+- 不要超过系统 RAM 的 80%
+
+**2. 使用 64 位 Java：**
+- 检查当前 Java 架构
+- 如需要下载 64 位 Java
+- 32 位 Java 限制在约 2GB
+
+**3. 降低渲染距离：**
+- 游戏内视频设置
+- 将渲染距离降低到 8-12 区块
+
+**4. 优化 JVM 参数：**
+```bash
+-Xms4G -Xmx8G -XX:+UseG1GC -XX:+UnlockExperimentalVMOptions
+```
+
+### 游戏无法启动
+
+**问题：** 游戏不启动，没有错误消息
+
+**检查：**
+
+**1. 日志输出：**
+- 检查 DropOut 中的游戏控制台
+- 查找错误消息
+- 常见问题：
+  - 文件缺失
+  - 下载损坏
+  - 模组冲突
+
+**2. 验证文件：**
+- 删除版本文件夹
+- 重新下载版本
+- 在模组版本之前先尝试原版
+
+**3. 检查权限：**
+- 确保 DropOut 可以写入游戏目录
+- 检查文件夹权限
+- 在 Linux 上：`chmod -R 700 ~/.local/share/com.dropout.launcher`（仅当前用户可访问）
+
+## 下载问题
+
+### 下载失败
+
+**问题：** 资源或库下载失败
+
+**解决方案：**
+
+**1. 网络问题：**
+- 检查互联网连接
+- 禁用 VPN
+- 尝试不同的网络
+- 检查防火墙/杀毒软件
+
+**2. 恢复下载：**
+- DropOut 自动恢复中断的下载
+- 关闭并重新打开 DropOut
+- 下载应该继续
+
+**3. 清除下载缓存：**
+- 删除 libraries/assets 中的 `.part` 文件
+- 重新开始下载
+
+**4. 手动下载：**
+- 检查日志中失败的 URL
+- 手动下载文件
+- 放置在正确位置
+
+### 下载缓慢
+
+**问题：** 下载非常慢
+
+**解决方案：**
+
+**1. 调整线程数：**
+- 设置 → 下载
+- 尝试不同的线程数：
+  - 太低：整体较慢
+  - 太高：连接限流
+  - 推荐：5-10 个线程
+
+**2. 网络优化：**
+- 关闭占用大量带宽的应用
+- 如可能使用有线连接
+- 检查 ISP 限速
+
+**3. 备用 CDN：**
+- Mojang 镜像可能很慢
+- 尝试在一天中的不同时间
+
+## 模组加载器问题
+
+### Fabric 安装失败
+
+**问题：** 无法安装 Fabric 加载器
+
+**解决方案：**
+
+**1. 检查 Minecraft 版本：**
+- Fabric 支持 1.14+
+- 不支持更早版本
+- 尝试更新的 Minecraft 版本
+
+**2. 网络问题：**
+- 检查互联网连接
+- Fabric Meta API 可能宕机
+- 稍后再试
+
+**3. 手动安装：**
+- 从 [fabricmc.net](https://fabricmc.net/) 下载 Fabric
+- 使用官方安装器
+- 将配置文件导入 DropOut
+
+### Forge 安装失败
+
+**问题：** Forge 安装器失败或挂起
+
+**解决方案：**
+
+**1. Java 版本：**
+- 确保 Java 版本正确
+- Forge 1.17+ 需要 Java 16+
+- 更早的 Forge 可能需要 Java 8
+
+**2. 安装器超时：**
+- Forge 安装器可能很慢
+- 等待最多 10 分钟
+- 检查日志查看进度
+
+**3. 磁盘空间：**
+- 确保有足够的可用空间
+- Forge 临时需要约 1GB
+- 检查 Linux 上的 `/tmp`
+
+**4. 手动安装：**
+- 从 [minecraftforge.net](https://files.minecraftforge.net/) 下载 Forge 安装器
+- 手动运行安装器
+- 选择安装客户端
+- 导入配置文件
+
+### 模组崩溃
+
+**问题：** 安装模组后游戏崩溃
+
+**解决方案：**
+
+**1. 检查兼容性：**
+- 验证模组适用于正确的 Minecraft 版本
+- 检查模组加载器版本要求
+- 阅读模组说明了解依赖项
+
+**2. 安装依赖项：**
+- Fabric 模组通常需要 Fabric API
+- 一些模组需要库
+- 检查崩溃日志中的"缺失"错误
+
+**3. 移除冲突的模组：**
+- 逐一禁用模组
+- 识别有问题的模组
+- 检查已知冲突
+- 更新或替换模组
+
+**4. 更新模组：**
+- 使用最新的模组版本
+- 检查模组更新说明
+- 一些更新修复崩溃
+
+## 性能问题
+
+### 低 FPS
+
+**问题：** 游戏运行缓慢或卡顿
+
+**解决方案：**
+
+**1. 分配更多内存：**
+- 将最大内存增加到 6-8GB
+- 不要过度分配（导致 GC 暂停）
+
+**2. 安装性能模组：**
+- **Fabric**: Sodium、Lithium、Phosphor
+- **Forge**: OptiFine、Magnesium、Rubidium
+
+**3. 优化设置：**
+- 降低渲染距离
+- 禁用精美图形
+- 关闭粒子
+- 如果 fps < 60 禁用垂直同步
+
+**4. 更新显卡驱动：**
+- 从制造商下载最新版本
+- NVIDIA: GeForce Experience
+- AMD: Adrenalin
+- Intel: Graphics Command Center
+
+**5. 关闭后台应用：**
+- 释放系统资源
+- 禁用覆盖层（Discord 等）
+- 检查任务管理器中的 CPU/RAM 占用
+
+### 启动器启动缓慢
+
+**问题：** DropOut 启动时间很长
+
+**解决方案：**
+
+**1. 检查系统资源：**
+- 关闭不必要的程序
+- 确保有足够的 RAM 可用
+- 检查 CPU 使用率
+
+**2. 杀毒软件干扰：**
+- 将 DropOut 添加到例外
+- 暂时禁用以测试
+- 一些杀毒软件会显著减慢速度
+
+**3. 损坏的数据：**
+- 删除应用数据中的 `cache` 文件夹
+- 重启 DropOut
+- 将重建缓存
+
+## UI 问题
+
+### 窗口不打开
+
+**问题：** DropOut 窗口不出现
+
+**解决方案：**
+
+**1. 检查是否在运行：**
+```bash
+# Linux/macOS
+ps aux | grep dropout
+
+# Windows
+tasklist | findstr dropout
+```
+
+**2. 终止并重启：**
+```bash
+# Linux/macOS
+pkill dropout
+
+# Windows
+taskkill /F /IM dropout.exe
+```
+
+**3. 重置窗口位置：**
+- 删除窗口状态配置
+- 重启 DropOut
+
+### 图形故障
+
+**问题：** UI 看起来不对或有视觉伪影
+
+**解决方案：**
+
+**1. 更新显卡驱动：**
+- 安装最新驱动
+- 重启系统
+
+**2. 禁用硬件加速：**
+- 检查设置中是否存在选项
+- 可能会降低性能但修复故障
+
+**3. 尝试不同的显示器：**
+- 多显示器设置可能导致问题
+- 在不同显示器上尝试
+
+## 文件系统问题
+
+### 无法访问游戏目录
+
+**问题：** 访问游戏文件时出错
+
+**解决方案：**
+
+**1. 检查权限：**
+```bash
+# Linux
+chmod -R 700 ~/.local/share/com.dropout.launcher
+
+# macOS
+chmod -R 700 ~/Library/Application\ Support/com.dropout.launcher
+```
+
+**2. 检查磁盘空间：**
+- 确保有足够的可用空间
+- Minecraft 需要 2-10GB，取决于模组
+- 清理旧版本
+
+**3. 杀毒软件阻止：**
+- 将游戏目录添加到例外
+- 一些杀毒软件会阻止文件访问
+
+### 文件损坏
+
+**问题：** 文件似乎损坏或无效
+
+**解决方案：**
+
+**1. 验证校验和：**
+- DropOut 验证 SHA1/SHA256
+- 验证失败会触发重新下载
+
+**2. 重新下载：**
+- 删除损坏的文件
+- 再次启动版本
+- DropOut 将重新下载
+
+**3. 清除缓存：**
+- 完全删除版本文件夹
+- 从头重新安装
+
+## 获取更多帮助
+
+### 收集调试信息
+
+报告问题时，包括：
+
+**1. 系统信息：**
+- 操作系统和版本
+- DropOut 版本
+- Java 版本
+
+**2. 日志：**
+- 控制台的启动器日志
+- 如适用的游戏日志
+- 错误消息（完整文本）
+
+**3. 重现步骤：**
+- 你做了什么
+- 你期望什么
+- 实际发生了什么
+
+**4. 截图：**
+- 错误消息
+- UI 问题
+- 设置屏幕
+
+### 报告问题
+
+1. 搜索[现有 issues](https://github.com/HydroRoll-Team/DropOut/issues)
+2. 如果未找到，[创建新 issue](https://github.com/HydroRoll-Team/DropOut/issues/new)
+3. 使用 issue 模板
+4. 提供所有要求的信息
+5. 保持耐心和响应
+
+### 社区支持
+
+- **GitHub 讨论**：提问
+- **Discord**：实时帮助（如果可用）
+- **文档**：查看所有指南
+
+## 已知问题
+
+### 目前正在处理
+
+- 多账户切换（进行中）
+- 选择自定义游戏目录（计划中）
+- 启动器自动更新（计划中）
+
+### 解决方案
+
+**问题**：无法轻松切换账户
+**解决方案**：退出登录并使用不同账户登录
+
+**问题**：没有内置模组管理器
+**解决方案**：在实例文件夹中手动管理模组
+
+**问题**：无法从其他启动器导入
+**解决方案**：手动复制实例文件