许汝林个人博客

项目目标

把项目、文章和公开交流放到一个可持续维护的个人工作台，让访客能从项目概览一路查看功能、截图、技术栈、源码和讨论记录。

解决方案

网站由 Astro 在构建阶段生成静态 HTML。文章和项目直接使用 Markdown 管理，Pagefind 在构建完成后生成中文搜索索引，评论和回复保存到 GitHub Discussions，并通过 Giscus 嵌入博客页面。

正文由 Cloudflare Pages 静态分发；访客登录 GitHub 后，可以直接在文章、项目和留言板页面发布评论或回复，评论和留言都在站内完成。

关键能力

• 类型安全的文章和项目内容模型；
• 项目分类、真实截图、详情页和 GitHub 源码入口；
• 文章、标签和中文全文搜索页面；
• 深色模式和移动端导航；
• 文章及项目评论；
• 固定全局留言板；
• RSS、站点地图和完整部署说明。

运行边界

评论依赖 GitHub 登录，减少匿名垃圾内容；讨论数据由 GitHub Discussions 保存，博客本身不维护用户密码、会话或评论数据库。项目详情页展示前台、后台和接口仓库的职责边界，演示账号与示例数据不代表真实客户数据。