基于 VitePress 与 concise 主题的个人博客。
npm install
npm run dev # http://localhost:5173npm run build # 输出到 dist/
npm run preview # 本地预览构建产物在 docs/posts/ 下新建 Markdown 文件，直接写正文即可：
# 文章标题
正文……文中图片放 docs/img/，用相对路径引用（如 ../img/foo.png），构建时由 Vite 处理并加内容 hash。
标题、日期、tags、description、draft 等 frontmatter 字段全部可选，含义见主题 README。
git 首次提交时间不是真实发布日期时（如迁移来的旧文），才显式写 date。
上一篇/下一篇、归档、标签、Atom 订阅（/feed.xml）都由主题从文章列表生成。
评论用 giscus，存在本仓库 Discussions 的 Announcements 分类里，每篇文章第一条评论时自动建帖。
推送 docs 分支触发 .github/workflows/deploy.yml 自动构建发布
（需先在仓库 Settings → Pages 把 Source 切成 "GitHub Actions"）。
CNAME 和站点验证文件放在 docs/public/，构建时自动进入产物，不会因重新部署丢失。
发布日期依赖完整的 git 历史，CI 中需
fetch-depth: 0（workflow 里已设置）。
docs/
├── .vitepress/
│ ├── concise.mts # 主题配置：文章目录、每页数、站点地址、评论
│ ├── config.mts # 站点配置
│ └── theme/
│ ├── index.ts # 启用 concise 主题
│ └── posts.data.mts # 构建时收集文章列表
├── posts/ # 文章
├── page/[page]/ # 首页第 2 页起（/page/2/）
├── archive/ # 归档
├── tags/ # 标签索引与各标签页（/tags/<tag>/）
├── img/ # 文章配图
├── public/ # 原样拷贝到产物根目录（CNAME、favicon、站点验证文件）
├── about/
└── index.md # 首页
主题（版式、卡片、分页、配色）在独立仓库 vitepress-theme-concise 中维护。