# MBE 文档中心

全 MBE 生态文档统一入口。由 `scripts/build-unified-docs-site.js` 生成。

## 使用方式

1. **本地构建**（在 Mises 根目录）：
   ```bash
   npm run docs:build
   ```
   或运行 `docs-build.bat` / `docs-build.ps1`

2. **公开构建**（排除核心文档，用于公网部署）：
   ```bash
   DOCS_SITE_PUBLIC_MODE=1 npm run docs:build
   ```

3. **访问**：
   - 直接打开 `overview.html` 或 `index.html`
   - 或使用静态文件服务：`npx serve docs-site`、`python -m http.server 8080` 等

## 页面说明

- **overview.html**：文档中心总览（来自 docs/README.md）
- **index.html**：按分类浏览全部文档
- **pages/**：各文档 HTML 页面

## 更新

- **手动**：新增或修改 Markdown 文档后，运行 `npm run docs:build` 即可更新。
- **自动**：运行 `npm run docs:watch`，监听文档变更并自动重建（Ctrl+C 退出）。

## 部署与访问控制

详见 [DOCS_SITE_DEPLOYMENT_AND_ACCESS.md](../docs/DOCS_SITE_DEPLOYMENT_AND_ACCESS.md)：

- **公网部署**：可部署至 Netlify、Vercel、Cloudflare Pages、GitHub Pages、Nginx 等
- **密码保护**：核心文档不得无密码公网暴露；推荐在托管层启用 Password protection
- **公开构建**：`DOCS_SITE_PUBLIC_MODE=1` 排除 business/、*IMPLEMENTATION_PLAN*、*_ANALYSIS* 等核心文档