本地与部署
本地 Git
bash
cd D:\AI\Self-Mds
git status
git add .
git commit -m "docs: update notes"
git push构建
bash
npm run build产物目录：
text
docs/.vitepress/dist本地预览产物：
bash
npm run previewCloudflare Pages
- Cloudflare Dashboard → Workers & Pages → Create → Pages → Connect to Git
- 选择仓库
self-mds（或你推送的名字） - 构建设置：
| 项 | 值 |
|---|---|
| Framework preset | None / Vite |
| Build command | npm run build |
| Build output directory | docs/.vitepress/dist |
| Root directory | /（仓库根） |
| Node version | 20 或 22（环境变量 NODE_VERSION=20） |
- Save and Deploy
- 得到
https://xxx.pages.dev，可绑定自定义域名
每次 git push 到连接的分支会自动重新构建。
环境变量（Pages）
可选：
text
NODE_VERSION=20与「动态 Wiki」对比
| Self-Mds（本项目） | Wiki.js | |
|---|---|---|
| 运行 | 静态文件 CDN | Docker + DB |
| 公网 | Cloudflare Pages 即可 | Tunnel / VPS |
| 编辑 | 改 md + push | 网页编辑 |
| CLI 读内容 | 直接读 docs/**/*.md | 库或 API |
私有内容注意
Pages 站点默认 公网可读。敏感笔记不要放进该仓库，或使用 Cloudflare Access 做整站登录墙。