欢迎来到我的技术博客

引言

这是基于 Astro 构建的个人技术博客。系统设计充分考虑了 AI 协作创作的需求，让 AI 可以直接创建 Markdown 文件并自动生成静态页面。

系统特性

📝 简单的内容创作

AI 可以直接在 src/content/blog/ 目录下创建 .md 文件。系统会自动：

解析 frontmatter 元数据
生成静态页面
添加到博客列表

整个过程无需手动配置，AI 专注于创作即可。

📋 标准化的文章格式

每篇文章只需要包含基本的 frontmatter 信息：

---
title: "文章标题"
description: "文章简介"
pubDate: 2026-03-13
tags: ["标签1", "标签2"]
author: "杨正武"
---

✍️ 完整的 Markdown 支持

系统支持完整的 Markdown 语法：

代码块带语法高亮
表格用于数据展示
引用块突出重点内容
列表用于结构化信息
链接可以引用外部资源

技术栈

这个博客使用 Astro 作为静态站点生成器。

为什么选择 Astro？

性能优势：

零默认 JavaScript，页面加载速度快
静态 HTML，对搜索引擎友好
按需 hydration，只在需要时加载 JS

开发体验：

内容集合 API，类型安全
支持 MDX，可交互组件
丰富的集成生态

内容管理：

Markdown 或 MDX
前端框架无关
API 路由支持

架构设计

src/
├── content/
│   ├── blog/          # 博客文章（Markdown）
│   └── podcast/       # 播客内容（Markdown）
├── layouts/
│   └── Layout.astro   # 全局布局
└── pages/
    ├── index.astro    # 首页
    └── blog/
        ├── index.astro       # 博客列表
        └── [slug].astro      # 博客详情（动态路由）

内容使用 Markdown 格式存储：

方便版本控制和协作编辑
易于迁移和备份
AI 可直接读取和生成

TypeScript 提供类型安全：

frontmatter schema 验证
编译时错误检查
更好的 IDE 支持

视觉设计采用黑金配色方案：

主色调：金色 (#d4af37)
背景：深色系 (#0a0a0f, #141414)
保持整个站点的视觉一致性

开始使用

创建新文章只需要三个步骤：

1. 创建文件

在 src/content/blog/ 创建新的 .md 文件

2. 编写内容

按照模板格式编写 frontmatter 和正文

3. 生成站点

运行 npm run build 生成静态站点

快速参考

完整的写作指南和模板：

AI_WRITING_GUIDE.md - AI 写作标准和最佳实践
BLOG_TEMPLATE.md - 文章模板（可直接使用）
README.md - 项目说明和快速开始

项目特色

🤖 AI 友好设计

这是专门为 AI 协作创作的博客系统：

清晰的文件结构
标准化的内容格式
自动化的页面生成
类型安全的配置

⚡ 极致性能

静态站点，CDN 友好
零默认 JavaScript
优化的资源加载
优秀的 SEO 表现

🎨 精美设计

黑金配色主题
流畅的动画效果
响应式布局
良好的可读性

引言