配置 GitHub Pages 部署：添加 GitHub Actions 工作流和文档说明

Author: lizhogn

.github/workflows/deploy.yml

@@ -0,0 +1,37 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches: [ main ]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+        
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: './docs'
+          
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4 

docs/README.md

@@ -1,105 +1,82 @@
-# Python Web AI 开发教程
+# Python Web AI 开发教程文档
 
-> 📚 从零开始的 Python Web AI 开发完整教程
+## 📚 文档访问
 
-[![GitHub stars](https://img.shields.io/github/stars/lizhogn/python-webAI-tutorial.svg?style=social&label=Star)](https://github.com/lizhogn/python-webAI-tutorial)
-[![GitHub forks](https://img.shields.io/github/forks/lizhogn/python-webAI-tutorial.svg?style=social&label=Fork)](https://github.com/lizhogn/python-webAI-tutorial)
-[![GitHub issues](https://img.shields.io/github/issues/lizhogn/python-webAI-tutorial.svg)](https://github.com/lizhogn/python-webAI-tutorial/issues)
-[![GitHub license](https://img.shields.io/github/license/lizhogn/python-webAI-tutorial.svg)](https://github.com/lizhogn/python-webAI-tutorial/blob/main/LICENSE)
+### 在线访问
+- **GitHub Pages**: https://lizhogn.github.io/python-webAI-tutorial/
+- **本地预览**: 运行 `docsify serve docs` 后访问 http://localhost:3000
 
-## 🎯 项目简介
-
-本项目是一个完整的 Python Web AI 开发教程，从基础概念到实战应用，帮助学习者掌握现代 Web 开发与 AI 集成的全栈技能。
-
-### ✨ 特色亮点
-
-* 🚀 **循序渐进** 从 Web 基础到 AI 集成的完整学习路径
-* 💻 **实战导向** 每个阶段都有完整的项目实践
-* 🔧 **技术栈全面** 涵盖 Flask、FastAPI、Vue.js、Docker 等主流技术
-* 🤖 **AI 集成** 从模型训练到 Web 部署的全流程
-* 📚 **开源免费** 完全开源，持续更新维护
-
-## 📖 内容导航
-
-| 章节 | 关键内容 | 状态 |
-|------|----------|------|
-| [前言](preface.md) | 项目介绍、学习建议、技术栈概览 | ✅ |
-| [第一章 Web 开发基础](chapter1/README.md) | HTTP 协议、Web 框架、前后端基础 | ✅ |
-| [第二章 后端开发进阶](chapter2/README.md) | FastAPI、数据库、API 设计 | ✅ |
-| [第三章 前端开发](chapter3/README.md) | Vue.js、组件化、状态管理 | ✅ |
-| [第四章 AI 模型集成](chapter4/README.md) | 模型服务化、异步处理、性能优化 | ✅ |
-| [第五章 部署与运维](chapter5/README.md) | Docker、Nginx、监控日志 | ✅ |
-| [第六章 实战项目](chapter6/README.md) | 完整项目开发、最佳实践 | ✅ |
-
-## 🚀 快速开始
-
-### 环境要求
-
-- Python 3.8+
-- Node.js 16+
-- Docker (可选)
+### 文档结构
+```
+docs/
+├── index.html          # 文档首页
+├── _coverpage.md       # 封面页
+├── _sidebar.md         # 侧边栏导航
+├── README.md           # 本文件
+├── preface.md          # 前言
+├── chapter1/           # 第一章：Web 开发基础
+├── chapter2/           # 第二章：后端开发进阶
+├── chapter3/           # 第三章：前端开发
+├── chapter4/           # 第四章：AI 模型集成
+├── chapter5/           # 第五章：部署与运维
+├── chapter6/           # 第六章：实战项目
+├── tools.md            # 常用开发工具
+├── plugins.md          # 生产力提升插件
+├── ai-tools.md         # AI 相关工具
+├── open-source.md      # 开源项目推荐
+├── others.md           # 其他实用资源
+├── learning-progress.md # 学习进度
+├── roadmap.md          # 学习路线图
+├── quick-start.md      # 快速开始
+├── resources.md        # 学习资源
+├── faq.md              # 常见问题
+└── star-history.md     # Star History
+```
 
-### 快速体验
+## 🚀 本地开发
 
+### 安装 docsify
 ```bash
-# 克隆项目
-git clone https://github.com/lizhogn/python-webAI-tutorial.git
-cd python-webAI-tutorial
-
-# 运行快速开始项目
-cd quick_start_project
-pip install -r requirements.txt
-python main.py
+npm install -g docsify-cli
 ```
 
-访问 http://localhost:8000 即可体验第一个 AI Web 应用！
-
-## 💡 如何学习
-
-本项目适合有一定 Python 基础的开发者，建议按以下顺序学习：
-
-1. **基础知识** (第1-3章)：掌握 Web 开发基础概念
-2. **进阶技能** (第4-5章)：学习 AI 集成和部署技术
-3. **实战应用** (第6章)：完成完整项目开发
-
-每个章节都包含：
-- 📖 理论讲解
-- 💻 代码示例
-- 🎯 实践项目
-- 📝 学习总结
-
-## 🤝 如何贡献
-
-我们欢迎任何形式的贡献！
-
-* 🐛 **报告 Bug** - 发现问题请提交 Issue
-* 💡 **功能建议** - 有好想法就告诉我们
-* 📝 **内容完善** - 帮助改进教程内容
-* 🔧 **代码优化** - 提交 Pull Request
+### 启动本地服务器
+```bash
+docsify serve docs
+```
 
-## 📚 学习资源
+### 访问本地文档
+打开浏览器访问 http://localhost:3000
 
-### 官方文档
-- [FastAPI 官方文档](https://fastapi.tiangolo.com/)
-- [Vue.js 官方文档](https://vuejs.org/)
-- [Docker 官方文档](https://docs.docker.com/)
+## 📖 文档特色
 
-### 推荐阅读
-- [Python Web 开发最佳实践](https://realpython.com/)
-- [AI 模型部署指南](https://huggingface.co/docs)
+- **完整的教程体系**: 从基础到高级的完整学习路径
+- **丰富的代码示例**: 每个章节都包含详细的代码示例
+- **实用的工具推荐**: 推荐各种开发工具和学习资源
+- **中文友好**: 全中文内容，适合中文用户学习
+- **响应式设计**: 支持各种设备访问
 
-## 🙏 致谢
+## 🔧 技术栈
 
-感谢所有为本项目做出贡献的开发者们 ❤️
+- **文档框架**: docsify
+- **主题**: Vue 主题
+- **语法高亮**: Prism.js
+- **搜索功能**: docsify 内置搜索
+- **部署**: GitHub Pages
 
-## 📄 开源协议
+## 📝 贡献指南
 
-本作品采用 [MIT License](LICENSE) 进行许可。
+1. Fork 项目仓库
+2. 创建功能分支
+3. 修改文档内容
+4. 提交 Pull Request
+5. 等待审核合并
 
-## Star History
+## 📞 联系方式
 
-[![Star History Chart](https://api.star-history.com/svg?repos=lizhogn/python-webAI-tutorial&type=Date)](https://star-history.com/#lizhogn/python-webAI-tutorial&Date)
+- **GitHub**: https://github.com/lizhogn/python-webAI-tutorial
+- **Issues**: https://github.com/lizhogn/python-webAI-tutorial/issues
 
 ---
 
-⭐ 如果这个项目对你有帮助，请给我们一个 Star！ 
+**开始你的学习之旅吧！** 🚀