docs: 支持 DOCS_OUT 自定义输出目录（环境禁止清空 dist 时可输出到新目录）

.gitignore

@@ -8,6 +8,7 @@ vendor/
 
 # VitePress 文档站构建产物与缓存
 docs/.vitepress/dist/
+docs/.vitepress/dist*/
 docs/.vitepress/cache/
 docs/.vitepress/config.mjs.timestamp-*.mjs
 .DS_Store

docs/.vitepress/config.mjs

@@ -3,9 +3,13 @@ import { defineConfig } from 'vitepress'
 // 部署到子路径时，构建前设置环境变量即可：
 //   DOCS_BASE=/ny-exam-docs/ npm run docs:build
 const base = process.env.DOCS_BASE || '/'
+// 输出目录。默认 .vitepress/dist；若需要保留旧产物（或环境禁止删除目录），
+// 可用 DOCS_OUT=.vitepress/dist2 npm run docs:build 输出到新目录。
+const outDir = process.env.DOCS_OUT || '.vitepress/dist'
 
 export default defineConfig({
   base,
+  outDir,
   lang: 'zh-CN',
   title: 'NY 问卷考试系统数据平台',
   description: '基于 PHP 8 + 卷王（SurveyKing）社区版开放 API 的零依赖考试数据统计平台',