MBE 文档统一站点覆盖检查报告
检查日期: 2026-02-10
目的: 排查 MBE 系统所有文档是否已纳入统一站点
一、统一站点现状
1.1 主统一站点：docs-site/（Mises 根目录）✅
构建命令: 在 Mises 根目录执行 npm run docs:build 或 docs-build.bat / docs-build.ps1
构建脚本: scripts/build-unified-docs-site.js
定位: 全 MBE 生态文档统一入口
当前扫描范围：
| 目录 | 分类 | 排除 | 说明 |
|---|---|---|---|
docs/ |
root | archive, meeting_minutes_* | 仓库文档 |
mbe-desktop/docs/ |
desktop | archive | Desktop 应用 |
mises-behavior-engine/docs/ |
engine | archive, checklists | MBE 引擎 |
mbe-monorepo/docs/ |
monorepo | - | Monorepo |
总览页: 使用 docs/README.md 生成 overview.html
入口: overview.html（总览）| index.html（文档索引）
当前已纳入文档数: 约 551 个（排除 archive 后）
二、未纳入统一站点的文档
2.1 docs/（Mises 根目录，仓库级文档）
仅 README.md 用于总览，其余文档均未纳入：
| 文档 | 说明 |
|---|---|
| DOCS_GOVERNANCE_AND_STRUCTURE.md | 文档治理与结构说明 |
| DOCUMENTATION_ORGANIZATION_PLAN.md | 文档整理与归档方案 |
| MBE_GRAPH_MIGRATION_GUIDE.md | 图谱迁移指南 |
| MBE_CLI_PHASE6_OPTIMIZATION_PLAN.md | CLI 优化计划 |
| MBE_CLI_OPTIMIZATION_ANALYSIS.md | CLI 优化分析 |
| MBE_SYSTEM_UPDATE_SUMMARY_20260209.md | 系统更新摘要 |
| MBE_GRAPH_IMPLEMENTATION_STATUS.md | 图谱实现状态 |
| MBE_GRAPH_FEATURE_FLAGS.md | 图谱功能开关 |
| MBE_GRAPH_UNIMPLEMENTED_FEATURES.md | 图谱未实现功能 |
| MBE_UNIFIED_KNOWLEDGE_GRAPH_IMPLEMENTATION.md | 统一知识图谱实现 |
| MBE_POSITIONING_AND_EVALUATION.md | 定位与评估 |
| MBE_CORE_LOOP_OPTIMIZATION_PLAN.md | 核心闭环优化 |
| MBE_SPLIT_* (多个) | 拆分相关文档 |
| MBE_DESKTOP_* | Desktop 相关文档 |
| MBE_CLIENT_* | 客户端规划文档 |
| MBE_DEPENDENCY_ANALYSIS.md | 依赖分析 |
| TROUBLESHOOTING_CLOUDFLARE_TUNNEL.md | 故障排除 |
| DOCKER_LOCAL.md | 本地 Docker |
| features/*.md | 功能文档 |
| archive/ | 归档文档 |
| 等约 50+ 个文档 | - |
2.2 mises-behavior-engine/docs/（引擎文档）
已纳入: 仅 product/industry/ 和 product/business/ 下的非 README 文档
未纳入（大量核心文档）:
| 目录/文档 | 说明 |
|---|---|
| architecture/ | 架构设计（约 51 个文档） |
| deployment/ | 部署指南（约 44 个） |
| developer/ | 开发者文档（约 11 个） |
| guides/ | 使用指南（约 30 个） |
| product/ | 产品根目录（MBE_PRODUCT_INTRO、MBE_ROADMAP、MBE_CAPABILITIES 等） |
| workflows/ | 工作流文档 |
| xiaozhi/ | 小智集成文档 |
| API_GUIDE.md, INDEX.md | 引擎文档入口 |
| 等 400+ 文档 | - |
2.3 mbe-desktop/docs/（Desktop 文档）
已纳入: domain-applications 下非 README + 根目录 MBE_*.md 工作流
未纳入（非 MBE_ 前缀）:
| 文档 | 说明 |
|---|---|
| KB_* | 知识库相关流程、指南 |
| CHUNK_SIZE_GUIDE.md | 分块指南 |
| AUTO_TEST_GUIDE.md | 自动测试 |
| MBE_KNOWLEDGE_BASE_COMPLETE_WORKFLOW.md | 已纳入 |
| 其他非 MBE_ 前缀文档 | 开发、配置、测试等 |
2.4 mbe-monorepo/docs/（Monorepo 文档）
完全未纳入：CI/CD、部署、测试、API、安全等约 90+ 文档
三、其他文档站点（非统一入口）
| 站点/脚本 | 路径 | 扫描范围 | 说明 |
|---|---|---|---|
| docs_html | docs_html/ |
仅 docs/（根） |
scripts/generate_docs_html.py |
| engine docs_site | mises-behavior-engine/docs_site/ |
仅 mises-behavior-engine/docs/ |
scripts/generate_docs_site.py |
| docs-site | mbe-desktop/docs-site/ |
领域应用+行业+业务+MBE_工作流 | 主统一站点 |
结论: 存在 3 套 文档生成体系，各自扫描不同目录，无单一统一入口。
四、建议
4.1 短期（维持现状）
- 当前
mbe-desktop/docs-site定位为「领域应用文档中心」，已覆盖领域应用、行业方案、业务方案、MBE_ 工作流。 - 如需查阅其他文档，需分别访问：
- 根
docs/：本地浏览或docs_html/ - 引擎文档：
mises-behavior-engine/docs_site/或docs/目录 - Monorepo：
mbe-monorepo/docs/目录
- 根
4.2 中期（扩展统一站点）
在 build-docs-site.js 的 SCAN_DIRS 中新增：
- docs/（根）: 增加
docs/下 MBE_ 和 DOCS_ 等核心文档 - 引擎核心: 增加
mises-behavior-engine/docs/architecture、deployment、guides、product根目录 - 可选: 增加
mbe-monorepo/docs/中对外文档（如 DEPLOYMENT、API 等）
4.3 长期（全仓库统一入口）✅ 已实现
- 构建脚本已移至
scripts/build-unified-docs-site.js，统一扫描docs/、mbe-desktop/docs/、mises-behavior-engine/docs/、mbe-monorepo/docs/。 - 产出单一
docs-site/（Mises 根目录），提供分类导航与搜索，作为全 MBE 生态文档入口。 - 构建：在 Mises 根目录执行
npm run docs:build或docs-build.bat/docs-build.ps1。 - 排除：
archive/、node_modules、meeting_minutes_*等。
报告版本: v1.1
更新日期: 2026-02-10