refactor(build): 重构构建和部署流程以支持动态路径

- 移除 package.json 中的多环境构建和预览命令，统一为单一构建和部署命令
- 优化 deploy.sh 脚本，去除子目录与根路径参数，实现统一构建流程
- 取消使用环境变量配置基础路径，改为采用相对路径('./')满足任意部署路径需求
- 新增 pathUtils 工具模块，动态获取基础路径和资源完整路径，自动适配多层子目录
- 修改代码中所有静态资源路径，统一通过 getAssetPath 函数获取，支持部署路径自动适配
- App.jsx 中路由 basename 使用 getRouterBasename 动态计算，替代硬编码环境变量路径
- main.jsx 注销遗留 Service Worker，避免影响应用更新和部署
- Vite 配置文件中 base 设为相对路径 './'，简化部署环境要求和预览一致性维护

Author: wsqstar

package.json

@@ -7,8 +7,6 @@
     "dev": "vite",
     "build": "vite build",
     "clean": "rm -rf dist",
-    "build:root": "npm run clean && VITE_BASE_PATH=/ vite build",
-    "build:subdir": "npm run clean && vite build",
     "lint": "npm run lint:js && npm run lint:css",
     "lint:js": "eslint . --ext .js,.jsx",
     "lint:css": "stylelint \"**/*.css\"",
@@ -17,13 +15,10 @@
     "lint:css:fix": "stylelint \"**/*.css\" --fix",
     "format": "prettier --write \"**/*.{js,jsx,json,md,css}\"",
     "format:check": "prettier --check \"**/*.{js,jsx,json,md,css}\"",
-    "preview": "vite preview",
-    "preview:root": "npm run build:root && VITE_BASE_PATH=/ vite preview --port 4173",
-    "preview:subdir": "npm run build:subdir && vite preview --port 4173",
+    "preview": "vite preview --port 4173",
     "init": "node scripts/init.js",
     "update": "node scripts/update.js",
-    "deploy:root": "./scripts/deploy.sh root",
-    "deploy:subdir": "./scripts/deploy.sh",
+    "deploy": "./scripts/deploy.sh",
     "prepare": "husky"
   },
   "bin": {

scripts/deploy.sh

@@ -1,26 +1,15 @@
 #!/bin/bash
 
 # PPage 本地部署脚本
-# 用于将构建产出部署到 GitHub Pages
+# 用于将构建产出部署到 GitHub Pages（根路径部署）
 # 
 # 使用方法：
-#   子目录部署（domain.com/ppage）: ./scripts/deploy.sh
-#   根域名部署（domain.com）:        ./scripts/deploy.sh root
+#   ./scripts/deploy.sh 或 npm run deploy
 
 set -e
 
 echo "🚀 开始构建和部署..."
 
-# 检查部署类型参数
-DEPLOY_TYPE="${1:-subdir}"
-if [ "$DEPLOY_TYPE" = "root" ]; then
-  echo "📍 部署类型: 根域名部署（/）"
-  BUILD_COMMAND="npm run build:root"
-else
-  echo "📍 部署类型: 子目录部署（/ppage/）"
-  BUILD_COMMAND="npm run build:subdir"
-fi
-
 # 0. 从 public/config.yml 读取配置
 echo "🔍 读取配置文件..."
 
@@ -64,7 +53,7 @@ fi
 
 # 2. 构建项目
 echo "📦 构建项目..."
-$BUILD_COMMAND
+npm run build
 
 # 2.5. 生成 CNAME 文件（如果配置了自定义域名）
 if [ -n "$CUSTOM_DOMAIN" ]; then

src/App.jsx

@@ -13,6 +13,7 @@ import { Files } from './pages/Files'
 import { News } from './pages/News'
 import { DynamicDocumentPage } from './pages/DynamicDocumentPage'
 import { generateFolderConfigs } from './utils/folderScanner'
+import { getRouterBasename } from './utils/pathUtils'
 
 function AppContent() {
   const siteConfig = useSiteConfig()
@@ -53,8 +54,8 @@ function AppContent() {
     }
   }, [siteConfig])
 
-  // 获取 Vite 配置的基础路径，支持子目录部署
-  const basename = import.meta.env.BASE_URL || '/'
+  // 使用自动计算的 basename，适配任意部署路径
+  const basename = getRouterBasename()
 
   return (
     <I18nProvider>

src/config/parser.js

@@ -1,4 +1,5 @@
 import yaml from 'js-yaml'
+import { getAssetPath } from '../utils/pathUtils'
 
 /**
  * 解析 YAML 配置文件
@@ -21,8 +22,9 @@ export function parseConfig(yamlContent) {
  */
 export async function loadConfig() {
   try {
-    // config.yml 是静态资源，始终从根路径访问，不需要 base 前缀
-    const configPath = '/config.yml'
+    // 使用 getAssetPath 获取正确的配置文件路径
+    // 自动适配任意部署路径
+    const configPath = getAssetPath('/config.yml')
     const response = await fetch(configPath)
     if (!response.ok) {
       throw new Error(`配置文件加载失败: ${response.statusText}`)

src/main.jsx

@@ -3,8 +3,18 @@ import { createRoot } from 'react-dom/client'
 import './index.css'
 import App from './App.jsx'
 
+// 注销所有 Service Worker（清理遗留的 SW）
+if ('serviceWorker' in navigator) {
+  navigator.serviceWorker.getRegistrations().then(registrations => {
+    registrations.forEach(registration => {
+      registration.unregister()
+      console.log('Service Worker unregistered:', registration.scope)
+    })
+  })
+}
+
 createRoot(document.getElementById('root')).render(
   <StrictMode>
     <App />
-  </StrictMode>,
+  </StrictMode>
 )

src/utils/folderScanner.js

@@ -4,8 +4,7 @@
  * 并为每个文件夹生成相应的文档中心配置
  */
 
-// 获取 base 路径（用于 fetch 请求）
-const base = import.meta.env.BASE_URL || '/'
+import { getAssetPath } from './pathUtils'
 
 /**
  * 获取所有 Markdown 文件的 glob 模块
@@ -101,8 +100,8 @@ export function hasIndexFile(folderName) {
  */
 export async function loadFolderIndex(folderName) {
   // 构建 index.md 路径
-  // 注意：content 目录是静态资源，始终从根路径访问，不需要 base 前缀
-  const indexPath = `/content/${folderName}/index.md`
+  // 使用 getAssetPath 自动适配部署路径
+  const indexPath = getAssetPath(`/content/${folderName}/index.md`)
 
   try {
     const response = await fetch(indexPath)

src/utils/i18nMarkdown.js

@@ -3,40 +3,48 @@
  * 支持根据语言代码加载对应的 Markdown 文件
  */
 
+import { getAssetPath } from './pathUtils'
+
 /**
  * 加载多语言 Markdown 文件
  * @param {string} basePath - 基础路径（不含语言后缀），如 '/content/pages/about-site'
  * @param {string} language - 语言代码，如 'zh' 或 'en'
  * @param {string} fallbackLanguage - 后备语言代码，默认 'zh'
  * @returns {Promise<string|null>} Markdown 内容，如果加载失败返回 null
  */
-export async function loadI18nMarkdown(basePath, language, fallbackLanguage = 'zh') {
+export async function loadI18nMarkdown(
+  basePath,
+  language,
+  fallbackLanguage = 'zh'
+) {
   // 尝试加载指定语言的文件
   const paths = [
-    `${basePath}.${language}.md`,  // 如: /content/pages/about-site.zh.md
-    `${basePath}.md`,                // 如: /content/pages/about-site.md (无语言后缀)
-  ];
+    `${basePath}.${language}.md`, // 如: /content/pages/about-site.zh.md
+    `${basePath}.md`, // 如: /content/pages/about-site.md (无语言后缀)
+  ]
 
   // 如果指定语言不是后备语言，也尝试后备语言
   if (language !== fallbackLanguage) {
-    paths.push(`${basePath}.${fallbackLanguage}.md`);
+    paths.push(`${basePath}.${fallbackLanguage}.md`)
   }
 
   for (const path of paths) {
     try {
-      const response = await fetch(path);
+      // 使用 getAssetPath 自动适配部署路径
+      const fullPath = getAssetPath(path)
+      const response = await fetch(fullPath)
       if (response.ok) {
-        const content = await response.text();
-        console.log(`成功加载 Markdown: ${path}`);
-        return content;
+        const content = await response.text()
+        console.log(`成功加载 Markdown: ${path}`)
+        return content
       }
     } catch (error) {
-      console.warn(`无法加载 ${path}:`, error.message);
+      console.warn(`无法加载 ${path}:`, error.message)
     }
   }
 
-  console.warn(`所有路径都加载失败: ${paths.join(', ')}`);
-  return null;
+  console.warn(`所有路径都加载失败: ${paths.join(', ')}`)
+  return null
 }
 
 /**
@@ -46,18 +54,18 @@ export async function loadI18nMarkdown(basePath, language, fallbackLanguage = 'z
  * @returns {Promise<Object>} 语言代码到内容的映射
  */
 export async function preloadI18nMarkdown(basePath, languages = ['zh', 'en']) {
-  const result = {};
-  
+  const result = {}
+
   await Promise.all(
-    languages.map(async (lang) => {
-      const content = await loadI18nMarkdown(basePath, lang);
+    languages.map(async lang => {
+      const content = await loadI18nMarkdown(basePath, lang)
       if (content) {
-        result[lang] = content;
+        result[lang] = content
       }
     })
-  );
-  
-  return result;
+  )
+
+  return result
 }
 
 /**
@@ -67,8 +75,8 @@ export async function preloadI18nMarkdown(basePath, languages = ['zh', 'en']) {
  */
 export function extractLanguageFromPath(path) {
   // 匹配 .zh.md, .en.md 等模式
-  const match = path.match(/\.(zh|en)\.md$/);
-  return match ? match[1] : null;
+  const match = path.match(/\.(zh|en)\.md$/)
+  return match ? match[1] : null
 }
 
 /**
@@ -78,7 +86,7 @@ export function extractLanguageFromPath(path) {
  */
 export function getBasePath(path) {
   // 移除语言后缀（如果存在）
-  return path.replace(/\.(zh|en)\.md$/, '');
+  return path.replace(/\.(zh|en)\.md$/, '')
 }
 
 /**
@@ -88,60 +96,64 @@ export function getBasePath(path) {
  * 2. 如果没有当前语言版本，选择无语言后缀的文件（如 about.md）
  * 3. 如果都没有，使用后备语言版本
  * 4. 确保每个基础文件名只出现一次
- * 
+ *
  * @param {Array} files - 文件列表，每个文件包含 path 属性
  * @param {string} currentLanguage - 当前语言代码
  * @param {string} fallbackLanguage - 后备语言代码
  * @returns {Array} 过滤后的文件列表
  */
-export function filterMarkdownByLanguage(files, currentLanguage = 'zh', fallbackLanguage = 'zh') {
+export function filterMarkdownByLanguage(
+  files,
+  currentLanguage = 'zh',
+  fallbackLanguage = 'zh'
+) {
   // 按基础路径分组
-  const fileGroups = new Map();
-  
+  const fileGroups = new Map()
+
   files.forEach(file => {
-    const basePath = getBasePath(file.path);
-    const lang = extractLanguageFromPath(file.path);
-    
+    const basePath = getBasePath(file.path)
+    const lang = extractLanguageFromPath(file.path)
+
     if (!fileGroups.has(basePath)) {
-      fileGroups.set(basePath, []);
+      fileGroups.set(basePath, [])
     }
-    
+
     fileGroups.get(basePath).push({
       ...file,
       language: lang,
-      basePath
-    });
-  });
-  
+      basePath,
+    })
+  })
+
   // 为每个基础路径选择最合适的版本
-  const result = [];
-  
+  const result = []
+
   fileGroups.forEach((group, basePath) => {
     // 优先级：当前语言 > 无语言后缀 > 后备语言 > 其他
-    let selected = null;
-    
+    let selected = null
+
     // 1. 尝试找到当前语言版本
-    selected = group.find(f => f.language === currentLanguage);
-    
+    selected = group.find(f => f.language === currentLanguage)
+
     // 2. 如果没有，尝试找到无语言后缀版本
     if (!selected) {
-      selected = group.find(f => f.language === null);
+      selected = group.find(f => f.language === null)
     }
-    
+
     // 3. 如果没有，尝试找到后备语言版本
     if (!selected && currentLanguage !== fallbackLanguage) {
-      selected = group.find(f => f.language === fallbackLanguage);
+      selected = group.find(f => f.language === fallbackLanguage)
     }
-    
+
     // 4. 如果都没有，使用第一个可用的文件
     if (!selected && group.length > 0) {
-      selected = group[0];
+      selected = group[0]
     }
-    
+
     if (selected) {
-      result.push(selected);
+      result.push(selected)
     }
-  });
-  
-  return result;
+  })
+
+  return result
 }

src/utils/markdownIndex.js

@@ -4,6 +4,7 @@
  */
 
 import { getAllMarkdownModules } from './folderScanner'
+import { getAssetPath } from './pathUtils'
 
 // 使用文件夹扫描器获取所有 Markdown 模块
 const allModules = getAllMarkdownModules()
@@ -63,9 +64,9 @@ export async function loadAllMarkdownFiles() {
   for (const path in allModules) {
     try {
       // 将相对路径转换为绝对路径
-      // 注意：content 目录是静态资源，始终从根路径访问，不需要 base 前缀
+      // 使用 getAssetPath 自动适配部署路径
       const relativePath = path.replace('../..', '')
-      const absolutePath = relativePath
+      const absolutePath = getAssetPath(relativePath)
       const filename = path.split('/').pop()
 
       // 提取文件夹名称
@@ -153,9 +154,9 @@ export async function loadFolderMarkdownFiles(folderName) {
 
     try {
       // 将相对路径转换为绝对路径
-      // 注意：content 目录是静态资源，始终从根路径访问，不需要 base 前缀
+      // 使用 getAssetPath 自动适配部署路径
       const relativePath = path.replace('../..', '')
-      const absolutePath = relativePath
+      const absolutePath = getAssetPath(relativePath)
       const filename = path.split('/').pop()
 
       const response = await fetch(absolutePath)