Alex Ye Lab 个人网站
进行中一个用于沉淀 AI 学习、技术文章与项目实践的个人技术知识和项目展示平台。
项目概述
Alex Ye Lab 是我的个人技术知识与项目展示平台,用于记录 AI 学习、算法探索、工程实践和个人项目积累。
这个项目并不只是搭建一个博客页面。它包含内容系统、项目展示、阅读体验、SEO、服务器部署和自动更新流程,也记录了这些能力从简单实现逐步演进为可长期维护工程的过程。
项目的代码框架和基础设施是在 ChatGPT 辅助下,通过持续对话、实际操作、验证和排错逐步完成的。对我而言,它既是一个正在使用的网站,也是理解 Web 开发、内容工程和生产部署的实践载体。
背景与目标
建立这个网站的初衷,是拥有一个由自己维护的技术主页,不依赖第三方内容平台,并把分散的博客、项目和个人介绍组织在同一个地方。
网站主要服务于四个目标:
- 沉淀 AI、LLM、多模态和算法相关的学习笔记;
- 记录开发、部署与工程实践中的问题和解决过程;
- 展示持续推进的个人项目,而不只展示最终结果;
- 建立一套内容与代码分离、易于扩展和部署的长期维护方式。
架构与技术选型
为什么选择 Astro
网站以文章和项目内容为核心,大部分页面不需要复杂的客户端状态。当前 Astro 构建实际为 static,配置中没有显式设置 output,使用默认静态输出行为,在构建阶段生成 HTML、CSS 和少量必要的 JavaScript,适合由静态 Web 服务托管。
相比从 React SPA 或其他完整应用框架开始,Astro 对 Markdown、文件路由和内容集合提供了更直接的支持。它既能保持当前站点轻量,也保留了以后按需增加客户端交互的空间。
Tailwind CSS 与 TypeScript
Tailwind CSS 用于组织页面布局、响应式断点和组件状态。当前网站通过统一的颜色、字体、间距、圆角和动效 token 保持页面一致:首页保留深色太空视觉,内页提供亮色与暗色主题,文章正文则优先考虑长时间阅读的舒适度。
TypeScript 主要用于内容结构、工具函数和组件属性约束。随着博客、项目和动态路由增加,类型检查可以减少字段变更造成的不一致,也更适合后续持续扩展。
内容系统的演进
从静态数据到 Content Collections
项目早期使用 projects.js 保存项目数组。这种方式能够快速完成展示,但随着项目字段和详情页需求增加,数据文件与页面代码之间的耦合开始变得明显,也缺少统一的结构校验。
后来,博客和项目统一迁移到 src/content/:
src/content/
├─ blog/
└─ projects/
两类内容分别使用 Astro Content Collections 管理,schema 定义在 src/content.config.ts。Blog 校验标题、摘要、发布日期、分类、标签和草稿字段;Projects 校验标题、描述、标签、状态、精选、排序及可选链接等字段。页面再通过 getCollection() 查询非草稿内容并生成静态路由。
这种结构带来的直接变化是:新增文章或项目时,主要工作转移到编写 Markdown 内容,而不再需要修改列表页的数据代码。
Blog 内容系统
目前博客系统包括:
- Markdown 文章与 frontmatter 校验;
- 按发布日期排序的文章列表;
- 基于标题、摘要、分类和标签的本地实时搜索,多关键词采用 AND 匹配,查询同步到 URL;
- 标签目录与标签文章页,目前只聚合 Blog 标签;
- H2/H3 文章目录;
- 代码高亮、具体语言标识和复制按钮;
- 适合中英文混合内容的字数与阅读时间计算;
- 按发布日期确定的上一篇和下一篇导航;
- 草稿过滤与静态详情路由。
标签由文章 frontmatter 中填写的 tags 聚合生成,不会自动从正文推断。
其中,阅读时间会先去除 Markdown 标记和代码块,再分别按中文字符和英文单词估算。桌面端目录固定在正文右侧,移动端隐藏,以减少对正文阅读空间的影响。
Projects 内容系统
Projects 最初只有项目卡片,后来也迁移为独立的 Content Collection,并增加:
/projects项目列表;/projects/[slug]静态详情页;- 项目状态、技术标签和精选排序;
- 基于标题、描述、标签和中英文状态的本地实时搜索;
- Markdown 项目说明;
- 可选的网站与源码入口。
项目详情页沿用博客的排版和目录能力,但不显示文章字数、阅读时间或文章导航,避免混淆两类内容的用途。
首页“精选项目”按 order 从非草稿且 featured: true 的项目中选取一个,不表示最近创建或更新的项目。
个人主页
About 页面用于说明当前身份、关注方向、正在学习和构建的内容,并通过一条可继续追加的时间线记录阶段变化。它让网站从单纯的内容列表逐步接近一个完整的个人技术主页。
生产环境部署
服务器与静态文件
网站的构建产物是 dist/ 中的静态文件,生产托管不依赖常驻的 Astro 开发服务器或预览服务器。开发源码、依赖安装与构建过程、对外发布的静态资源各自承担不同职责。
生产托管与自动发布配置在仓库之外维护,本文只记录工程思路,不公开服务器目录、部署入口或内部服务连接方式;具体运行状态以生产环境复核结果为准。
HTTPS
网站的公开地址为 https://alexyelab.com。HTTPS、证书与缓存配置由托管环境维护;当前仓库不包含这些配置,不能仅根据早期部署记录判断现有的证书管理方式或访问链路。
部署方案的演进
第一版:手动部署
第一版生产流程需要手动完成:
本地修改
↓
上传或更新服务器代码
↓
安装依赖并构建
↓
替换线上静态文件
这种方式能够完成部署,但每次发布都需要重复操作,容易遗漏步骤,也不适合持续发布文章和项目内容。
第二版:GitHub Actions + SSH
第二版曾尝试使用 GitHub Actions 通过远程命令触发构建和发布。这段实践让我意识到:交互式终端与自动化进程的运行环境不一定相同,外部执行环境也需要与托管环境的访问策略协调。
这套方案并不是因为无法工作而被放弃,而是维护成本与当前个人网站的规模不匹配。当前仓库没有 GitHub Actions workflow,也没有已实现的 CI 流程;这里记录的是历史方案,不代表当前仓库能力。
第三版:GitHub Webhook
根据此前的部署记录,后续方案改为由 GitHub 变更通知触发外部发布流程,发布端完成构建并更新静态资源。从开发者的角度看,流程可以概括为:
本地开发
↓ git push
GitHub 仓库
↓ 变更通知
外部构建与发布流程
↓
更新静态站点
这一调整减少了发布操作与开发终端之间的耦合。通知接收服务、发布脚本及生产配置不在当前仓库中,是否仍按上述方式运行,需要在生产环境确认;本文不把历史记录中的安全能力视为本次已验证事实。
Webhook 自动部署的职责划分
变更通知
变更通知的作用是告诉发布端“有新的版本需要处理”,而不是直接托管网站内容。通知接收、发布条件与访问权限属于生产运维配置,不应混入文章或公开源码;相关配置需要独立维护和核验。
构建与站点运行
构建过程需要 Node.js、依赖安装和 Astro 构建命令,但网站访问只需要已经生成的静态文件。将构建工具与站点运行区分开,有助于理解为什么一个静态站点仍会涉及自动化进程,却不需要运行时 Astro 服务。
部署脚本
从职责上,发布过程可以拆成以下几个阶段。这是流程说明,不是当前仓库提供的可执行部署脚本:
确认待发布版本
↓
安装依赖并构建
↓
发布构建产物
↓
检查页面与资源
具体的运行时版本、目录、命令、失败处理和恢复方式由部署环境维护。公开项目说明保留阶段划分和设计经验,不替代生产操作手册。
SEO 与基础优化
网站目前已经实现:
- 页面级 title 和 description;
- Canonical URL;
- Open Graph 与基础 Twitter Card;
- 按页面类型生成的 JSON-LD;
- Astro 官方
@astrojs/sitemap; - 构建时生成的
robots.txt和 Blog RSS; - 静态页面与 Content Collection 动态路由自动加入 Sitemap。
这些能力集中在公共 Layout 和 Astro 配置中,不需要每个页面重复维护。博客文章和项目详情页会使用各自 Content Collection 中的标题与描述生成 metadata。
中文字体在 dev/build 前按源码内容生成子集,减少字体下载体积;搜索、主题、菜单和阅读辅助使用少量原生脚本,避免为当前规模引入完整客户端框架。页面切换采用轻量淡入淡出,并兼容减少动态效果的设置。
工程问题与取舍
Node.js 环境一致性
开发环境已经从 Windows 迁移到 Mac。当前 package.json 要求 Node.js >=22.12.0,但本地实际版本与生产构建环境可能不同,不能把满足版本要求等同于已经统一运行环境。
此前自动化排错的经验是:构建环境应显式管理运行时版本,而不是依赖交互式终端的默认状态。生产构建使用的版本仍需单独核验。
源码与发布产物分离
源码工作区负责安装依赖与构建,对外发布的是静态产物。把两者分离,使开发、构建和访问的职责更加明确,也避免把源码目录当作公开站点目录。
自动部署入口
GitHub Actions + SSH 在技术上可行,但并不一定是每个个人网站最合适的方式。对我而言,选择自动发布方案时更重要的是流程可理解、运行环境可确认,以及长期维护成本与项目规模匹配。
当前仍可改进的地方
- 持续复核生产配置,避免实践记录与实际运行状态漂移;
- 用真实长文章验证图片、表格、代码和移动端阅读体验;
- 完善发布后的页面与资源检查,持续改善维护效率;
- 补充真实内容和项目进展,保持说明与代码一致。
技术栈
| 范围 | 技术 |
|---|---|
| 网站与样式 | Astro 7、TypeScript 6、Tailwind CSS 4 |
| 内容 | Markdown、Astro Content Collections |
| 构建与字体 | Node.js、npm、subset-font |
| 发布 | Git 与仓库外维护的静态站点发布流程 |
| HTTPS | 由托管环境维护,具体配置待生产环境确认 |
| SEO | Sitemap、robots.txt、RSS、Canonical URL、Open Graph、JSON-LD |
当前状态与后续计划
Alex Ye Lab 已经在仓库中建立博客、项目、About、SEO 和静态构建的基本闭环,目前仍处于持续维护状态。自动部署属于此前生产实践的一部分,其运行情况与安全配置不由当前源码直接证明。
后续重点不是一次性加入大量功能,而是继续补充 AI 与算法学习内容、记录更多真实项目实践,并逐步改善内容组织、视觉体验和部署可靠性。