Personal Tech Hub
中英双语个人技术品牌站,集成 Pagefind 搜索、Giscus 评论、暗色模式与 RSS,构建时自动拉取 GitHub Stars 数据
背景 (Situation)
需要一个能同时展示开源项目、深度技术文章与短笔记的个人技术品牌站,面向面试官、招聘者与同行快速了解技术方向。之前使用 Hugo,组件化迭代和 TypeScript 支持不足。
任务 (Task)
构建一个现代化、中英双语、性能优良的个人技术站点,具备:
- 项目展示、博客、笔记三大内容板块
- 中英双语路由与内容关联
- 静态搜索、暗色模式、RSS 订阅
- GitHub Actions 自动部署到 GitHub Pages
行动 (Action)
- 框架选型:从 Hugo 迁移至 Astro 6.x,利用其 Content Collections 管理多语言内容,Tailwind CSS 4.x 实现主题系统
- 内容架构:
translationKey关联中英对应内容;blog/projects/notes/pages四个集合 - 核心集成:Pagefind 静态搜索、Giscus 评论系统、GitHub API 拉取 Star 数与贡献热力图
- 构建流程:GitHub Actions 自动构建 + Pagefind 索引生成,推送至 GitHub Pages
- 关键决策:
- Astro 而非 Hugo → TypeScript 类型安全 + 组件化迭代效率显著提升
- CSS 变量主题方案 → 暗色模式零 JS 开销,WCAG AA 对比度合规
结果 (Result)
- ✅ 双语站点上线,Lighthouse 性能评分 95+,71 个页面被 Pagefind 索引
- ✅ 支持 RSS、全文搜索、暗色模式、GitHub 活跃度展示
- ✅ 构建时间 <30 秒(含 OG 图片生成),首次内容绘制 <1 秒
- 🔜 持续迭代:Plausible 分析、简历下载、邮件订阅
技术文档
技术难点 为什么做这个项目?解决了什么独特问题?
该项目的详细技术难点正在撰写中。以下为占位内容,展示此组件的交互形态。
在实际部署版本中,此处将展示:
- 具体的技术挑战描述与解决路径
- 关键架构决策的前因后果
- 系统数据流图与核心设计模式说明
此结构化文档直接面向技术面试官的评估维度,展示候选人在技术深度、工程判断力和系统思维方面的能力。
方案对比与决策 关键技术选型的权衡与理由
该项目的详细方案对比与决策正在撰写中。以下为占位内容,展示此组件的交互形态。
在实际部署版本中,此处将展示:
- 具体的技术挑战描述与解决路径
- 关键架构决策的前因后果
- 系统数据流图与核心设计模式说明
此结构化文档直接面向技术面试官的评估维度,展示候选人在技术深度、工程判断力和系统思维方面的能力。
架构设计 系统架构、数据流与核心设计模式
该项目的详细架构设计正在撰写中。以下为占位内容,展示此组件的交互形态。
在实际部署版本中,此处将展示:
- 具体的技术挑战描述与解决路径
- 关键架构决策的前因后果
- 系统数据流图与核心设计模式说明
此结构化文档直接面向技术面试官的评估维度,展示候选人在技术深度、工程判断力和系统思维方面的能力。
💡 提示:点击每个面板展开详细内容。此组件采用 HTML5 <details> 元素,无需 JavaScript,支持键盘导航与屏幕阅读器。