SSG 静态站点（千语衍码文档站）
一、定位与价值
| 视角 | 说明 |
|---|---|
| 产品 | 技术品牌与知识资产载体：笔记、知识梳理、运维手册对内对外可读可检索 |
| 工程 | SSG（Static Site Generation）：构建期生成 HTML，托管成本低、抗并发强 |
| SEO / 传播 | 纯静态页易于被搜索引擎抓取（可按页配置 meta、结构化数据） |
本项目即当前站点源码目录 vitepress-site：Markdown 驱动，无独立业务后端运行时。
二、技术架构（简述）
text
Markdown / 主题组件
↓
VitePress（Vite）
↓
dist 静态资源（HTML/CSS/JS）
↓
Nginx 挂载（可与业务子路径同域共存）与同仓库其它「动态站点」共用网关时，一般为 根路径 / 或固定前缀，由 Nginx location 与 vitepress.base 保持一致。
三、能力要点（工程侧）
- 构建：
pnpm build，产物目录由.vitepress/config/outDir决定（常见为dist或.vitepress/dist）。 - 缓存策略：静态 JS/CSS 文件名带 hash，适合 长缓存；HTML 建议 协商缓存，避免文档更新后读者长期命中旧壳层。
- 扩展：
theme/下自定义布局、markdown-it插件、侧边栏可由插件自动生成。
四、适用场景复盘
产品文档、开源说明、团队 Wiki、结构化知识库——与「大屏 / 微前端」等运行时系统互补，组成完整门户矩阵。