技术知识库重构（Demo）

真实性声明：这是内容结构 Demo，不是用户完成过的真实项目，也不应作为履历材料使用。

背景

假设团队的技术笔记散落在多个文档中，格式不统一，链接容易失效，也缺少稳定的分类方式。项目希望建立一套低维护成本的知识沉淀流程。

目标

• 作者只需要提交 Markdown 或 MDX
• 元数据在构建阶段完成校验
• 页面尽可能输出静态 HTML
• 新内容合并到主分支后自动发布

技术选型

选择 Astro 作为静态站点框架，用 Content Collections 管理内容 schema。页面默认不发送 JavaScript，只在主题切换与移动菜单等必要交互中加入少量脚本。

const notes = defineCollection({
  loader: glob({ pattern: '**/*.{md,mdx}', base: './src/content/notes' }),
  schema: z.object({
    title: z.string(),
    publishedAt: z.coerce.date(),
  }),
});

架构

内容文件由构建时 loader 读取，经 schema 验证后生成类型安全的数据。列表页只查询已发布内容，详情页通过 getStaticPaths() 预生成固定路由。

核心实现

1. 集中定义内容字段和默认值。
2. 复用卡片与文章布局，避免页面间样式漂移。
3. 将个人资料和站点文案收敛到单一配置文件。
4. 在 CI 中执行类型检查和静态构建。

难点与权衡

纯静态方案的部署和访问成本较低，但不适合实时搜索或需要登录的内容。本项目优先保证长期维护简单，因此将复杂检索留作后续增强。

结果与复盘

这是演示内容，因此没有虚构访问量、性能分数或业务成果。替换为真实项目时，应补充可验证的结果、个人贡献边界，以及哪些方案最终没有采用。