2026-01-23 16:27:04 +08:00
|
|
|
|
# iflow-engine SDK 文档索引
|
|
|
|
|
|
|
|
|
|
|
|
> 🤖 **AI 代码助手入口文件** - 请从此文件开始了解项目结构
|
|
|
|
|
|
|
|
|
|
|
|
## 项目概述
|
|
|
|
|
|
|
|
|
|
|
|
| 项目 | 内容 |
|
|
|
|
|
|
|------|------|
|
|
|
|
|
|
| **名称** | iflow-engine |
|
|
|
|
|
|
| **版本** | 1.0.1 |
|
|
|
|
|
|
| **描述** | BIM 3D 引擎 SDK，支持 Vue2、Vue3、React 和原生 HTML |
|
|
|
|
|
|
| **类型** | 技术项目 / SDK |
|
|
|
|
|
|
| **语言** | TypeScript |
|
|
|
|
|
|
| **构建工具** | Vite |
|
|
|
|
|
|
| **核心依赖** | Three.js, iflow-engine-base |
|
|
|
|
|
|
|
|
|
|
|
|
## 快速导航
|
|
|
|
|
|
|
|
|
|
|
|
| 文档 | 说明 | 适合人群 |
|
|
|
|
|
|
|------|------|---------|
|
2026-01-28 17:19:36 +08:00
|
|
|
|
| [架构设计.md](架构设计.md) | 架构设计、设计模式、模块依赖 | 架构师、核心开发 |
|
|
|
|
|
|
| [快速开始.md](快速开始.md) | 快速开始、安装、基础用法 | 新用户、集成开发 |
|
|
|
|
|
|
| [MODULES/模块索引.md](MODULES/模块索引.md) | 所有模块的详细文档索引 | 所有开发者 |
|
|
|
|
|
|
| [贡献指南.md](贡献指南.md) | 开发协作、脚本说明、最小验证集 | 项目贡献者 |
|
|
|
|
|
|
| [运维手册.md](运维手册.md) | 构建/发布/回滚流程与常见问题 | 维护者 |
|
|
|
|
|
|
| [API调用链.md](API调用链.md) | API 调用链（用户交互 → Manager → Engine → 底层引擎） | SDK 维护者 |
|
2026-01-23 16:27:04 +08:00
|
|
|
|
|
|
|
|
|
|
## 模块概览
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
src/
|
|
|
|
|
|
├── bim-engine.ts # 主入口类 BimEngine
|
|
|
|
|
|
├── index.ts # 导出文件
|
|
|
|
|
|
├── core/ # 核心基础设施
|
|
|
|
|
|
├── managers/ # 管理器层（业务逻辑）
|
|
|
|
|
|
├── components/ # UI 组件层
|
|
|
|
|
|
├── services/ # 全局服务（主题、国际化）
|
|
|
|
|
|
├── themes/ # 主题预设和类型
|
|
|
|
|
|
├── locales/ # 国际化文案
|
|
|
|
|
|
├── types/ # 公共类型定义
|
|
|
|
|
|
└── utils/ # 工具函数
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 核心模块
|
|
|
|
|
|
|
|
|
|
|
|
| 模块 | 路径 | 职责 | 文档 |
|
|
|
|
|
|
|------|------|------|------|
|
2026-01-28 17:19:36 +08:00
|
|
|
|
| **BimEngine** | `src/bim-engine.ts` | 主入口类，整合所有功能 | 暂无独立文档 |
|
|
|
|
|
|
| **core** | `src/core/` | 事件系统、管理器基类、注册表 | [详情](MODULES/核心模块.md) |
|
|
|
|
|
|
| **managers** | `src/managers/` | 15 个管理器，处理业务逻辑 | [详情](MODULES/管理器模块.md) |
|
|
|
|
|
|
| **components** | `src/components/` | 20+ 个 UI 组件 | [详情](MODULES/组件模块.md) |
|
|
|
|
|
|
| **services** | `src/services/` | 主题管理、国际化服务 | [详情](MODULES/服务模块.md) |
|
2026-01-23 16:27:04 +08:00
|
|
|
|
|
|
|
|
|
|
## 架构分层
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
┌─────────────────────────────────────┐
|
|
|
|
|
|
│ BimEngine (主引擎) │ ← 用户 API 入口
|
|
|
|
|
|
├─────────────────────────────────────┤
|
|
|
|
|
|
│ ManagerRegistry (单例注册表) │ ← 全局状态管理
|
|
|
|
|
|
├─────────────────────────────────────┤
|
|
|
|
|
|
│ 管理器层 (15个Manager类) │ ← 业务逻辑
|
|
|
|
|
|
├─────────────────────────────────────┤
|
|
|
|
|
|
│ 组件层 (20+ UI组件) │ ← 视图渲染
|
|
|
|
|
|
├─────────────────────────────────────┤
|
|
|
|
|
|
│ 服务层 (LocaleManager, ThemeManager) │ ← 横切关注点
|
|
|
|
|
|
├─────────────────────────────────────┤
|
|
|
|
|
|
│ 核心基础设施 │ ← 事件、基类
|
|
|
|
|
|
│ (EventEmitter, BaseManager) │
|
|
|
|
|
|
└─────────────────────────────────────┘
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 关键设计模式
|
|
|
|
|
|
|
|
|
|
|
|
| 模式 | 应用位置 | 说明 |
|
|
|
|
|
|
|------|---------|------|
|
|
|
|
|
|
| **单例模式** | ManagerRegistry, LocaleManager, ThemeManager | 全局唯一实例 |
|
|
|
|
|
|
| **观察者模式** | EventEmitter, 服务订阅 | 事件驱动通信 |
|
|
|
|
|
|
| **模板方法** | BaseManager, BaseDialogManager | 统一生命周期 |
|
|
|
|
|
|
| **工厂模式** | BimEngine 初始化 | 创建管理器实例 |
|
|
|
|
|
|
|
|
|
|
|
|
## 公开 API 统计
|
|
|
|
|
|
|
|
|
|
|
|
| 类别 | 数量 |
|
|
|
|
|
|
|------|------|
|
|
|
|
|
|
| 管理器类 | 15 个 |
|
|
|
|
|
|
| UI 组件 | 20+ 个 |
|
|
|
|
|
|
| 事件类型 | 30+ 个 |
|
|
|
|
|
|
| 主题属性 | 70+ 个 |
|
|
|
|
|
|
| 国际化键 | 200+ 个 |
|
|
|
|
|
|
|
|
|
|
|
|
## 技术栈
|
|
|
|
|
|
|
|
|
|
|
|
- **语言**: TypeScript 5.x
|
|
|
|
|
|
- **构建**: Vite 7.x
|
|
|
|
|
|
- **3D 引擎**: Three.js 0.182.x
|
|
|
|
|
|
- **核心 SDK**: iflow-engine-base 1.0.x
|
|
|
|
|
|
|
|
|
|
|
|
## 相关链接
|
|
|
|
|
|
|
|
|
|
|
|
- **仓库**: http://123.60.156.158:13000/bim_engine/bimEngine
|
|
|
|
|
|
- **问题反馈**: http://123.60.156.158:13000/bim_engine/bimEngine/issues
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
**文档生成时间**: 2026-01-23
|
|
|
|
|
|
**文档版本**: 1.0.0
|
