astro-navfolio — Astro 作品集模板

Navfolio 是一个基于 Astro 的静态站点 starter，定位是个人发布系统而非单页简历或纯博客模板。它将主页、博客、项目文档、Vibe 短记录和关于页面整合在同一个可维护的站点里，强调内容优先、克制视觉和轻量交互。内容以 Markdown / MDX 管理，适合希望长期积累和展示个人内容的开发者。

模板内置了全文搜索（Pagefind）、可配置的评论系统（giscus、utterances、waline）、主题色盘、RSS 和站点地图。所有站点配置集中在 `src/config/site.toml`，内容模型有 Zod schema 校验，字段缺失时构建会直接报错。模块使用手册以真实博客文章形式提供，便于边用边查。

需要注意的是，生产构建硬依赖 Python 3、FontTools 和 Brotli，用于生成中日韩字体子集，缺少这些工具会导致构建失败。评论系统需要自行配置对应的第三方服务，搜索索引需在生产构建后生成。部署到 GitHub Pages 时可使用内置 workflow，但生产环境的具体表现需自行验证。