docs(readme): 优化文档结构和部署说明

- 重新组织README核心特性为多个细分部分，突出零配置部署和内容管理能力
- 增加详细的自动文件夹扫描及文档中心功能介绍
- 明确部署方式，支持任意路径自动适配和一键部署
- 添加代码质量工具使用指南及开发文档
- 更新本地开发和项目结构说明
- 美化文档排版，增加表情图标，提升阅读体验
- 修改部署脚本调用方式，简化使用流程

Author: wsqstar

readme.md

@@ -2,15 +2,38 @@
 
 一个纯前端部署的个人主页生成系统。
 
-## 特性
+## ✨ 核心特性
 
-- ✅ 纯前端部署，无需服务器和数据库
-- ✅ 通过 YAML 配置文件一站式管理站点内容
-- ✅ 支持 Markdown 内容创作，自动渲染为响应式网页
-- ✅ 内置多种主题（明亮、暗黑、学术），支持运行时切换
-- ✅ 响应式设计，完美适配各种设备
-- ✅ 支持 PDF 在线预览和文件下载
-- ✅ 可部署到 GitHub Pages，零成本托管
+### 🎯 零配置部署
+
+- ✅ **纯前端部署**，无需服务器和数据库
+- ✅ **通用路径适配**，支持子目录和根域名部署
+- ✅ **一键部署**到 GitHub Pages，零成本托管
+- ✅ **自动化脚本**，清理、构建、部署一步完成
+
+### 📝 强大的内容管理
+
+- ✅ **YAML 配置文件**一站式管理站点内容
+- ✅ **Markdown 创作**，自动渲染为响应式网页
+- ✅ **自动文件夹扫描**，在 `content/` 下创建文件夹即可自动生成页面
+- ✅ **文档中心**，支持层级结构、面包屑导航、双向链接
+- ✅ **自动文件扫描**，引用文件自动在文件页面展示
+- ✅ **新闻时间轴**，支持多种事件类型和论文状态
+
+### 🎨 丰富的展示功能
+
+- ✅ **多主题支持**（明亮、暗黑、学术、玻璃），支持运行时切换
+- ✅ **国际化（i18n）**，支持中英文切换
+- ✅ **响应式设计**，完美适配各种设备
+- ✅ **汉堡菜单**，移动端自动收纳次要导航
+- ✅ **PDF 在线预览**和文件下载
+
+### 🔧 开发者友好
+
+- ✅ **配置驱动**，通过 `collections` 控制文档集合
+- ✅ **安全更新机制**，fork 后可安全获取上游更新
+- ✅ **Git merge strategy**，自动保护用户内容
+- ✅ **代码质量工具**（ESLint、Stylelint、Prettier）
 
 ## 快速开始
 
@@ -33,12 +56,8 @@ npm run init
 # 本地开发
 npm run dev
 
-# 构建和部署
-# 子目录部署 (yourusername.github.io/ppage)
-./scripts/deploy.sh
-
-# 根域名部署 (yourusername.github.io 或自定义域名)
-./scripts/deploy.sh root
+# 构建和部署（自动适配任意路径）
+npm run deploy
 ```
 
 ### 方式二：直接使用示例模板
@@ -58,55 +77,103 @@ npm install
 # 本地开发
 npm run dev
 
-# 构建和部署
-# 子目录部署 (yourusername.github.io/ppage)
-./scripts/deploy.sh
-
-# 根域名部署 (yourusername.github.io 或自定义域名)
-./scripts/deploy.sh root
+# 构建和部署（自动适配任意路径）
+npm run deploy
 ```
 
-## 文档
+## 📚 文档
 
 - [USER_GUIDE.md](./USER_GUIDE.md) - 详细使用文档
 - [INIT_GUIDE.md](./INIT_GUIDE.md) - `ppage init` 命令使用指南
 - [UPDATE_GUIDE.md](./UPDATE_GUIDE.md) - 如何安全地更新 fork 的代码
+- [LINT.md](./LINT.md) - 代码质量工具使用指南
 
-## 🚢 部署
+## 💡 主要功能
 
-PPage 支持两种部署方式，自动适配不同的访问路径：
+### 自动文件夹扫描
 
-### 子目录部署（默认）
+在 `content/` 目录下创建任何文件夹，系统会自动：
 
-适用场景：`yourusername.github.io/ppage` 或 `domain.com/ppage`
+- 扫描并识别文件夹
+- 生成导航菜单项
+- 创建对应的路由和页面
 
-```bash
-# 1. 配置 public/config.yml 中的 deploy 信息
-# 2. 执行部署（自动清理、构建、部署）
-./scripts/deploy.sh
+通过 `public/config.yml` 中的 `collections` 配置控制：
+
+```yaml
+collections:
+  tutorials:
+    enabled: true # 是否启用
+    showInNavigation: true # 是否在导航栏显示
+    showInMobile: false # 移动端是否直接显示
+    order: 1 # 导航顺序
 ```
 
-### 根域名部署
+### 文档中心
+
+强大的文档管理系统，支持：
+
+- **层级结构**：通过 `parent` 字段建立父子关系
+- **智能排序**：支持置顶、优先级、order 多级排序
+- **面包屑导航**：自动生成文档路径
+- **双向链接**：自动识别文档间引用
+
+### 自动文件扫描
+
+在 Markdown 中引用文件，系统会自动：
+
+- 扫描所有 Markdown 中的文件链接
+- 在文件页面自动展示
+- 支持 PDF 预览和下载
+
+### 新闻时间轴
+
+展示学术动态和重要事件：
+
+- 支持多种事件类型（论文、获奖、会议等）
+- 论文状态追踪（已接收、在线、已发表）
+- 时间轴展示，直观易读
+
+## 🚢 部署
+
+PPage 使用**相对路径构建**，自动适配任何部署路径，无需手动配置 base path。
 
-适用场景：`yourusername.github.io` 或自定义域名 `yourdomain.com`
+### 一键部署
 
 ```bash
 # 1. 配置 public/config.yml 中的 deploy 信息
-# 2. 执行根域名部署（自动清理、构建、部署）
-./scripts/deploy.sh root
+deploy:
+  repository: "https://github.com/yourusername/yourrepo"
+  branch: "gh-pages"
+  customDomain: ""  # 可选，填写自定义域名
+
+# 2. 执行部署（自动清理、构建、部署）
+npm run deploy
 ```
 
+### 支持的部署场景
+
+✅ **子目录部署**：`yourusername.github.io/ppage`  
+✅ **根域名部署**：`yourusername.github.io`  
+✅ **自定义域名**：`yourdomain.com`
+
+**自动适配原理**：
+
+- 构建时使用 `base: './'` 相对路径
+- 运行时通过 `window.location.pathname` 动态检测部署路径
+- 无需手动配置，一次构建随处可用
+
 ### 手动构建
 
 ```bash
-# 子目录部署构建（base = /ppage/）
-npm run build:subdir
+# 清理旧文件
+npm run clean
 
-# 根域名部署构建（base = /）
-npm run build:root
+# 构建（自动使用相对路径）
+npm run build
 
-# 自定义 base path
-VITE_BASE_PATH=/custom/ npm run build
+# 预览构建结果
+npm run preview
 ```
 
 更多部署细节请查看 [USER_GUIDE.md 的部署指南](./USER_GUIDE.md#-部署指南)。
@@ -121,21 +188,74 @@ npm run update
 ```
 
 **受保护的文件**（更新时不会被覆盖）：
+
 - `public/config.yml` - 你的站点配置
 - `content/` - 你的所有内容
 - `public/assets/` - 你的资源文件
 - `scripts/deploy.sh` - 你的部署脚本
 
 详细更新流程请查看 [UPDATE_GUIDE.md](./UPDATE_GUIDE.md)。
 
-## 技术栈
+## 🔧 技术栈
+
+- **前端框架**：React 18 + Vite
+- **路由**：React Router 6
+- **Markdown 渲染**：markdown-it
+- **配置解析**：js-yaml
+- **样式**：CSS Modules + CSS Variables
+- **代码质量**：ESLint + Stylelint + Prettier
+- **国际化**：React Context 自定义 i18n
+
+## 🛠️ 开发指南
+
+### 本地开发
+
+```bash
+# 安装依赖
+npm install
+
+# 启动开发服务器
+npm run dev
+
+# 代码检查
+npm run lint
+
+# 代码格式化
+npm run format
+
+# 自动修复问题
+npm run lint:fix
+```
+
+### 项目结构
+
+```
+ppage/
+├── content/              # 内容目录
+│   ├── pages/          # 文档页面
+│   ├── posts/          # 博客文章
+│   ├── files/          # 文件资源
+│   └── tutorials/      # 自定义文档集合
+├── public/
+│   ├── config.yml      # 站点配置文件
+│   └── assets/         # 静态资源
+├── src/
+│   ├── components/     # React 组件
+│   ├── pages/          # 页面组件
+│   ├── utils/          # 工具函数
+│   ├── config/         # 配置解析
+│   ├── i18n/           # 国际化
+│   └── themes/         # 主题样式
+└── scripts/            # 工具脚本
+    ├── deploy.sh       # 部署脚本
+    ├── init.js         # 初始化脚本
+    └── update.js       # 更新脚本
+```
+
+## 🤝 贡献
 
-- React 18 + Vite
-- React Router
-- markdown-it
-- js-yaml
-- CSS Modules + CSS Variables
+欢迎提交 Issue 和 Pull Request！
 
-## License
+## 📝 License
 
-MIT
+MIT License - 详见 [LICENSE](LICENSE) 文件

src/App.jsx

@@ -32,8 +32,6 @@ function AppContent() {
   useEffect(() => {
     async function loadConfigs() {
       try {
-        console.log('[App] config:', config)
-        console.log('[App] config.collections:', config?.collections)
         // 传递完整的 config 给 folderScanner
         const configs = await generateFolderConfigs(config)
         // 过滤掉 posts 和 pages，它们已经有专门的页面