From 81a62402ef6f8900ff092366121a9b7a4263ba52 Mon Sep 17 00:00:00 2001
From: Natsuu <natsukawa247@outlook.com>
Date: Fri, 27 Feb 2026 17:18:25 +0800
Subject: Restructure docs into manual/development and add implementation docs
 (#94)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

## Summary by Sourcery

Restructure documentation into separate manual and development sections,
introduce detailed internal implementation docs for auth/Java/mod
loaders, and update site navigation, landing page links, and MDX tooling
(Mermaid, card styling) to match the new structure and tech stack.

Enhancements:
- Enable Mermaid rendering support in the docs app and add a reusable
Mermaid React component.
- Refine Docs page rendering by customizing Card styling and removing
redundant in-page titles/descriptions rendered by the layout.
- Align docs source configuration and routing comments with the new
manual-based default paths.

Documentation:
- Split user-facing docs under a new manual section and move contributor
content into a dedicated development section for both English and
Chinese.
- Add comprehensive internal implementation documentation covering
authentication, Java management, mod loader/version merging, event bus,
and architecture patterns in both English and Chinese.
- Update existing feature docs (mod loaders, Java, authentication) and
getting-started/troubleshooting pages to be more conceptual, pointing to
implementation docs for technical details.
- Refresh architecture docs to reflect the React/Zustand frontend stack
and add Mermaid-based architecture diagrams.
- Adjust navigation labels, home-page CTAs, and doc links to target the
new manual/development structure and routes.

---------

Co-authored-by: 简律纯 <i@jyunko.cn>
---
 packages/docs/content/zh/features/index.mdx | 176 ----------------------------
 1 file changed, 176 deletions(-)
 delete mode 100644 packages/docs/content/zh/features/index.mdx

(limited to 'packages/docs/content/zh/features/index.mdx')

diff --git a/packages/docs/content/zh/features/index.mdx b/packages/docs/content/zh/features/index.mdx
deleted file mode 100644
index bb53ce2..0000000
--- a/packages/docs/content/zh/features/index.mdx
+++ /dev/null
@@ -1,176 +0,0 @@
----
-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 导入
-- 从其他启动器导入
-- 保留设置和存档
-
-### 启动器自动更新
-- 后台更新检查
-- 一键更新
-- 版本历史
-- 回滚支持
-- 
cgit v1.2.3-70-g09d2

