fix(utils): 修复路径处理以支持自定义 base 路径

- 在 about 页面加载 Markdown 内容时，修正路径拼接逻辑，支持 import.meta.env.BASE_URL
- folderScanner 工具中统一加入 base 路径处理，确保 fetch 请求地址正确
- markdownIndex 模块调整所有路径拼接，避免路径错误导致加载失败
- 保持向后兼容基础上增强了路径动态适配能力，支持部署在非根目录的场景
- 所有 fetch 请求均基于动态 base 路径生成，提高灵活性和可维护性

Author: wsqstar

src/pages/About.jsx

@@ -21,8 +21,12 @@ export function About() {
     async function loadSiteDescription() {
       setLoading(true);
       try {
+        // 获取 base 路径并构建正确的文件路径
+        const base = import.meta.env.BASE_URL || '/';
+        const relativePath = '/content/pages/about-site';
+        const basePath = base === '/' ? relativePath : base + relativePath.replace(/^\//, '');
         // 尝试从 Markdown 文件加载
-        const markdown = await loadI18nMarkdown('/content/pages/about-site', language);
+        const markdown = await loadI18nMarkdown(basePath, language);
         setSiteMarkdown(markdown);
       } catch (error) {
         console.error('加载关于本站内容失败:', error);

src/utils/folderScanner.js

@@ -4,6 +4,9 @@
  * 并为每个文件夹生成相应的文档中心配置
  */
 
+// 获取 base 路径（用于 fetch 请求）
+const base = import.meta.env.BASE_URL || '/';
+
 /**
  * 获取所有 Markdown 文件的 glob 模块
  * 排除 files 文件夹
@@ -67,8 +70,9 @@ export function getFolderFiles(folderName) {
   for (const path in allMarkdownModules) {
     const folder = extractFolderName(path);
     if (folder === folderName) {
-      // 转换为绝对路径
-      const absolutePath = path.replace('../..', '');
+      // 转换为绝对路径（考虑 base 路径）
+      const relativePath = path.replace('../..', '');
+      const absolutePath = base === '/' ? relativePath : base + relativePath.replace(/^\//, '');
       files.push(absolutePath);
     }
   }
@@ -92,7 +96,9 @@ export function hasIndexFile(folderName) {
  * @returns {Promise<Object|null>} index.md 的配置信息
  */
 export async function loadFolderIndex(folderName) {
-  const indexPath = `/content/${folderName}/index.md`;
+  // 构建 index.md 路径（考虑 base 路径）
+  const relativePath = `/content/${folderName}/index.md`;
+  const indexPath = base === '/' ? relativePath : base + relativePath.replace(/^\//, '');
 
   try {
     const response = await fetch(indexPath);

src/utils/markdownIndex.js

@@ -8,6 +8,9 @@ import { getAllMarkdownModules } from './folderScanner';
 // 使用文件夹扫描器获取所有 Markdown 模块
 const allModules = getAllMarkdownModules();
 
+// 获取 base 路径（用于 fetch 请求）
+const base = import.meta.env.BASE_URL || '/';
+
 // 为了向后兼容，保留原有的 posts 和 pages 模块导出
 const postsModules = {};
 const pagesModules = {};
@@ -59,8 +62,9 @@ export async function loadAllMarkdownFiles() {
   // 加载所有模块（包括 posts, pages, tutorials 等）
   for (const path in allModules) {
     try {
-      // 将相对路径转换为绝对路径
-      const absolutePath = path.replace('../..', '');
+      // 将相对路径转换为绝对路径（考虑 base 路径）
+      const relativePath = path.replace('../..', '');
+      const absolutePath = base === '/' ? relativePath : base + relativePath.replace(/^\//, '');
       const filename = path.split('/').pop();
 
       // 提取文件夹名称
@@ -147,7 +151,9 @@ export async function loadFolderMarkdownFiles(folderName) {
     if (folder !== folderName) continue;
 
     try {
-      const absolutePath = path.replace('../..', '');
+      // 将相对路径转换为绝对路径（考虑 base 路径）
+      const relativePath = path.replace('../..', '');
+      const absolutePath = base === '/' ? relativePath : base + relativePath.replace(/^\//, '');
       const filename = path.split('/').pop();
 
       const response = await fetch(absolutePath);