阅微漫记

一个基于 Astro 构建的中文静态个人博客，包含普通文章、系列连载、站内搜索与多款写作工具，部署于 Vercel。

快速开始

# 安装依赖
npm install
# 启动开发服务器 (localhost:3000)
npm run dev
# 构建生产版本（含 Pagefind 搜索索引生成）
npm run build
# 预览生产构建
npm run preview

项目结构

src/
├── assets/ # 本地图片（经 astro:assets 优化为 WebP/AVIF）
├── components/ # Astro 组件
│ ├── DossierTopbar.astro
│ ├── AuthorProfileCard.astro
│ ├── AdUnit.astro
│ └── SocialShare.astro
├── content/ # 内容集合（Markdown）
│ ├── config.ts # Collection schema 定义
│ ├── posts/ # 普通文章
│ └── series-articles/ # 系列连载文章
├── layouts/ # 页面布局
│ └── BaseLayout.astro # 根布局 (SEO, JSON-LD, AdSense)
├── pages/ # 页面路由
│ ├── index.astro # 首页
│ ├── posts/ # 文章列表与详情
│ ├── series/ # 系列索引与连载详情
│ ├── tags/ # 标签索引与详情
│ ├── search.astro # Pagefind 站内搜索
│ ├── rss.xml.ts # RSS 订阅源
│ ├── og/ # OG 图片动态生成 (SVG)
│ └── tools/ # 工具页面 (md-to-wechat, md-to-x, qrcode, cover)
└── styles/ # 全局样式 (dossier 主题 tokens)

技术栈

• 框架: Astro 5.x (静态站点生成)
• 样式: Tailwind CSS 3.x + 自定义 dossier 主题变量
• 内容: Astro Content Collections（posts + seriesArticles 双集合）
• 图片: astro:assets 自动优化（WebP/AVIF）
• 搜索: Pagefind 静态站内搜索（构建时生成索引，零运行时成本）
• SEO: sitemap、RSS、JSON-LD 结构化数据、OG 图片
• 部署: Vercel Adapter + 安全响应头

内容管理

内容统一使用 Markdown + frontmatter 管理，由 Astro Content Collections 校验类型。

普通文章（src/content/posts/）

---title: 文章标题date: 2026-04-24excerpt: 文章摘要tags:
- 标签1
- 标签2readingTime: 5---
文章内容...

系列连载（src/content/series-articles/）

---title: 第 N 篇标题date: 2026.04.26no: "001"# 注意：零填充编号需加引号series: "life-debug"# 系列 slug，与首页/系列页对应seriesTitle: 人生 DebugseriesTab: SERIES 01seriesDesc: 系列介绍seriesStatus: 连载中---
正文 Markdown，特殊视觉块（日记格式、流程图、引用等）可内嵌 HTML。

部署

项目已配置 Vercel Adapter，推送到 GitHub 后自动构建部署。vercel.json 定义了安全响应头（X-Frame-Options、X-Content-Type-Options、Referrer-Policy、Permissions-Policy）。

License

MIT