维护与发布

怎样修改内容？

直接编辑领域中的 Markdown 页面。每篇保留问题、完整标准回答、例子或追问，以及必要的适用边界。新增文章后，把链接加入领域目录与对应主题目录；新增导航分组时更新 docs/.vitepress/catalog.json。

怎样本地检查？

npm ci
npm run check
npm run docs:build
npm run docs:preview

内容检查覆盖原条目映射、页面标题、标准回答、内部链接和 Mermaid 语法。构建会进一步检查 Markdown 与 Vue 编译。Windows PowerShell 可以直接执行这些命令。

Cloudflare Pages 怎样自动发布？

创建 Pages 项目并连接 GitHub 仓库，生产分支 main，构建命令 npm run check && npm run docs:build，输出目录 docs/.vitepress/dist，环境变量 NODE_VERSION=22。保存后，后续更新主分支会触发构建发布。

配置需要在自己的 Cloudflare 账户完成授权。当前浏览器的阅读进度与源内容独立；部署新内容不会自动把另一台设备的进度同步过来。

官方参考：VitePress 部署 · Cloudflare 构建配置