关于本站
本站是一个专门用于展示、归档和复盘课程设计项目的静态文档站点。本站主要呈现课程设计项目从需求定义、AI 协作、重构优化，到最终打包部署的完整开发路径，供学习与技术交流。
- 过程可追溯：不仅展示最终代码，更完整保留了开发阶段的重构计划、AI 提示词演进以及具体的工作日志，使项目生命周期中的关键决策有迹可循。
- 规范化文档：整理出详实的文档结构体系，规范代码注释、系统架构设计和测试验证流程。
- 技术实践落地方案：记录项目在打包分发、移动端适配（如状态栏遮挡、同步构建工具等）以及自动化发布过程中遇到的实际问题和应对策略。
本站基于现代前端技术栈构建，确保极速的加载速度和流畅的阅读体验：
- 基础框架：Astro 5 静态站点引擎，采用组件级海岛架构，实现高性能的静态资源渲染。
- 页面主题：Starlight 文档套件，提供标准的响应式布局、完善的无障碍支持（A11y）与暗色/亮色模式自适应。
- 检索系统：内置 Pagefind 极速静态全文检索，支持毫秒级本地关键字搜索。
- 托管服务：使用 Cloudflare Pages 进行全球边缘网络分发与持续集成（CI/CD）自动化构建部署。
项目结构与组织原则
Section titled “项目结构与组织原则”为了保证课程设计文档的清晰和层次感，本站的目录结构设计遵循以下原则：
- 结构扁平化：侧边栏聚焦于具体项目大类，将原始庞杂的系统日志和引用的环境配置放入“引用文件”和“Gemini 日志”子目录中，突出核心成果。
- 路径自解释：每个项目由“基础项目说明”、“关键阶段计划”、“大模型执行指令”和“详细工作日志”四部分构成，方便查阅。
- 资源相对化：文档中的图片及引用附件均采用相对路径引用，确保站点在不同平台或本地预览下路径的一致性与正确性。
感谢 Astro 团队、Starlight 和 Cloudflare 提供的优秀开源工具与托管服务支持。