web/src/
├── app/ # Next.js App Router
│ ├── (main)/ # 前台路由组
│ │ ├── page.tsx # 首页
│ │ ├── layout.tsx # 前台布局
│ │ ├── about/ # 关于我页面
│ │ ├── blog/ # 博客模块
│ │ │ ├── page.tsx # 博客列表
│ │ │ └── [id]/ # 博客详情
│ │ ├── docs/ # 文档中心
│ │ │ ├── page.tsx # 文档列表
│ │ │ └── [id]/ # 文档详情
│ │ ├── essays/ # 随笔页面
│ │ ├── links/ # 友情链接
│ │ ├── messages/ # 留言板
│ │ ├── projects/ # 项目展示
│ │ ├── privacy/ # 隐私政策
│ │ ├── terms/ # 用户协议
│ │ ├── error/ # 错误页面
│ │ ├── components/ # 前台专用组件
│ │ └── hooks/ # 前台专用 Hooks
│ │
│ ├── admin/ # 管理后台
│ │ ├── page.tsx # 管理后台首页
│ │ ├── layout.tsx # 后台布局
│ │ ├── blogs/ # 博客管理
│ │ ├── blog-input/ # 博客编辑/新建
│ │ ├── blog-files/ # 博客文件管理
│ │ ├── essays/ # 随笔管理
│ │ ├── links/ # 友情链接管理
│ │ ├── projects/ # 项目管理
│ │ ├── tags/ # 标签管理
│ │ ├── types/ # 分类管理
│ │ ├── users/ # 用户管理
│ │ ├── comments/ # 评论管理
│ │ └── personal/ # 个人资料管理
│ │
│ ├── api/ # API 路由 (文档相关)
│ ├── next-api/ # Next.js API 路由 (元数据)
│ ├── offline/ # PWA 离线页面
│ ├── layout.tsx # 根布局
│ ├── globals.css # 全局样式
│ ├── sw.ts # Service Worker
│ ├── manifest.ts # PWA Manifest
│ ├── sitemap.ts # 站点地图
│ └── robots.ts # 爬虫配置
│
├── components/ # 全局组件
│ ├── Header.tsx # 导航头部
│ ├── Footer.tsx # 页脚
│ ├── LoginForm.tsx # 登录表单
│ ├── RegisterForm.tsx # 注册表单
│ ├── UserInfoForm.tsx # 用户信息表单
│ ├── Live2DWidget.tsx # Live2D 看板娘
│ ├── JsonLd.tsx # JSON-LD SEO
│ ├── BackgroundImage.tsx # 背景图组件
│ ├── BackgroundSettings.tsx # 背景设置
│ ├── AdminHeader.tsx # 后台头部
│ ├── charts/ # 图表组件
│ └── shared/ # 共享 UI 组件
│
├── contexts/ # React Context
│ ├── ThemeProvider.tsx # 主题管理
│ └── UserContext.tsx # 用户状态管理
│
├── hooks/ # 自定义 Hooks
│ ├── useCachedData.ts # 数据缓存
│ ├── useDebounce.ts # 防抖
│ ├── useImageUpload.ts # 图片上传
│ ├── useInfiniteScroll.ts # 无限滚动
│ ├── useInlineEdit.ts # 行内编辑
│ ├── useLocalStorage.ts # LocalStorage
│ ├── usePagination.ts # 分页
│ └── usePersonalProfile.ts # 个人资料
│
├── lib/ # 工具库
│ ├── api.ts # API 请求封装
│ ├── constants.ts # 常量定义
│ ├── labels.ts # 文案标签
│ ├── location.ts # 地理位置
│ ├── personal-profile.ts # 个人资料配置
│ ├── seo-config.ts # SEO 配置
│ ├── slugify.ts # URL slug 生成
│ ├── utils.ts # 通用工具函数
│ └── Alert.tsx # 全局弹窗
│
├── types/ # TypeScript 类型
└── assets/ # 静态资源
| 路由 | 文件 | 说明 |
|---|---|---|
/ |
page.tsx | 首页 |
/about |
about/page.tsx | 关于我 |
/blog |
blog/page.tsx | 博客列表 |
/blog/[id] |
blog/[id]/page.tsx | 博客详情 |
/docs |
docs/page.tsx | 文档列表 |
/docs/[id] |
docs/[id]/page.tsx | 文档详情 |
/essays |
essays/page.tsx | 随笔 |
/links |
links/page.tsx | 友情链接 |
/rss |
rss/page.tsx | RSS 订阅 |
/messages |
messages/page.tsx | 留言板 |
/projects |
projects/page.tsx | 项目展示 |
/privacy |
privacy/page.tsx | 隐私政策 |
/terms |
terms/page.tsx | 用户协议 |
/error |
error/page.tsx | 错误页面 |
| 路由 | 文件 | 说明 |
|---|---|---|
/admin |
page.tsx | 后台首页/仪表盘 |
/admin/blogs |
blogs/page.tsx | 博客列表管理 |
/admin/blog-input |
blog-input/page.tsx | 博客编辑/新建 |
/admin/blog-files |
blog-files/page.tsx | 博客文件管理 |
/admin/docs |
docs/page.tsx | 文档管理 |
/admin/essays |
essays/page.tsx | 随笔管理 |
/admin/links |
links/page.tsx | 友情链接管理 |
/admin/projects |
projects/page.tsx | 项目管理 |
/admin/tags |
tags/page.tsx | 标签管理 |
/admin/types |
types/page.tsx | 分类管理 |
/admin/users |
users/page.tsx | 用户管理 |
/admin/comments |
comments/page.tsx | 评论管理 |
/admin/personal |
personal/page.tsx | 个人资料设置 |
| 组件 | 用途 |
|---|---|
| Header.tsx | 前台导航头部，包含登录状态 |
| Footer.tsx | 页脚 |
| LoginForm.tsx | 登录弹窗表单 |
| RegisterForm.tsx | 注册弹窗表单 |
| UserInfoForm.tsx | 用户信息编辑表单 |
| Live2DWidget.tsx | Live2D 看板娘挂件 |
| JsonLd.tsx | JSON-LD 结构化数据（SEO） |
| BackgroundImage.tsx | 背景图组件 |
| BackgroundSettings.tsx | 背景设置 |
| AdminHeader.tsx | 后台顶部导航 |
| charts/ | ECharts 数据可视化组件 |
| shared/ | 共享 UI 组件（Button, Modal 等） |
前台页面特定的组件，如博客卡片、评论列表等。
主题切换管理（亮色/暗色模式）。
用户登录状态全局管理。
| Hook | 用途 |
|---|---|
| useCachedData | 带缓存的数据获取 |
| useDebounce | 防抖处理 |
| useImageUpload | 图片上传逻辑 |
| useInfiniteScroll | 无限滚动加载 |
| useInlineEdit | 行内编辑功能 |
| useLocalStorage | LocalStorage 封装 |
| usePagination | 分页逻辑 |
| usePersonalProfile | 个人资料管理 |
统一封装后端 API 调用，包含：
配置位于 src-tauri/：
src/main.rs - Rust 主程序Cargo.toml - Rust 依赖构建命令：
npm run dev:tauri # 开发模式
npm run tauri:build # 生产构建