# GNovaLab

**Repository Path**: glodon/gnovalab

## Basic Information

- **Project Name**: GNovaLab
- **Description**: GNovaLab 是依托数维房建 API 搭建的官方示例与能力实验室，覆盖 SDK 示例、配套工具，以及后续 MCP / Agentic 智能能力（建设中），帮助开发者快速熟悉数维国产平台架构与全套二次开发开放能力，赋能业务创新。

- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 20
- **Forks**: 9
- **Created**: 2026-07-17
- **Last Updated**: 2026-10-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GNovaLab

> Open APIs lay the foundation, while AI fuels innovation.

**GNovaLab** 是依托数维房建 API 搭建的官方示例与能力实验室，覆盖 SDK 示例、配套工具，以及后续 MCP / Agentic 智能能力（建设中），帮助开发者快速熟悉数维国产平台架构与全套二次开发开放能力。

数维房建二次开发 API 为广联达数维国产房建平台开放的编程接口，包含通用底层基础 API 与建筑 GNA、结构 GNS、机电 GNMEP 专业 API，支持开发者自主扩展软件能力，完成自动建模、数据管控、第三方系统集成等定制开发，适配各类建筑设计、工程分析场景的个性化业务创新。

本项目采用 [MIT](./LICENSE) 开源许可协议，开发者可自由查阅、修改、复用示例源码，降低二次开发上手成本，快速落地自有业务拓展与数字化创新应用。

在线文档：[数维设计 API 文档](https://aecos.glodon.com/docs/designapi)

---

## 仓库结构

```text
gnovalab/
├── SDK/          # 数维房建二次开发 SDK（GNA / GNS / GNMEP）
├── MCP/          # 数维设计能力 MCP（Coming soon）
├── Agentic/      # 数维设计及创新智能体（Coming soon）
├── Tools/Migration/Revit2Nova # Revit插件移植助手智能体（Beta版，持续优化中）
├── LICENSE
└── README.md
```

| 目录 | 说明 |
| :--- | :--- |
| [SDK](./SDK) | 建筑（GNA）、结构（GNS）、机电（GNMEP）三专业 SDK：`.NET` / `Python`、示例代码、API 文档与配套工具 |
| [MCP](./MCP) | 数维设计能力 MCP，持续建设中 |
| [Agentic](./Agentic) | 数维设计及创新智能体，持续建设中 |
| [Revit2Nova](./Tools/Migration/Revit2Nova) | Revit插件移植助手智能体，持续优化中 |

---

## SDK 概览

`SDK` 下按专业划分：

| 专业 | 目录 | 产品 |
| :--- | :--- | :--- |
| 建筑 | [SDK/GNA](./SDK/GNA) | 数维建筑设计 |
| 结构 | [SDK/GNS](./SDK/GNS) | 数维结构设计 |
| 机电 | [SDK/GNMEP](./SDK/GNMEP) | 数维机电设计 |

每个专业目录大致包含：

| 内容 | 说明 |
| :--- | :--- |
| `使用声明.md` | SDK 使用声明与许可说明 |
| `.NET` / `.Net` | .NET API 入门指南、变更说明、CHM 帮助、Samples、Tools |
| `Python` | Python API 入门指南、变更说明、CHM 帮助、`PythonEngine.addin` |

详细目录说明见各专业 `readme.md`，总体说明见 [SDK/README.md](./SDK/README.md)。

### .NET 示例（节选）

需使用 **Visual Studio 2015 及以上** 打开对应解决方案。

**GNA（建筑）** — `SDK/GNA/.NET/Samples/source/GNA.Samples.sln`

| 示例 | 说明 |
| :--- | :--- |
| HelloWorld | 命令级插件入门 |
| RibbonToolbar | Ribbon 工具栏扩展 |
| FilterElement | 图元过滤 |
| ElementParameter | 图元参数读写 |
| ProjectInfo | 项目信息查询 |
| QueryGeometry / MeasureGeometry | 几何查询与测量 |
| LayoutColumn | 布置柱 |
| AutoDimensionGrid | 轴网自动标注 |
| CodeSnippets | 常见 FAQ 代码片段 |

**GNS（结构）** — `SDK/GNS/.Net/Samples/source/Samples.sln`

| 示例 | 说明 |
| :--- | :--- |
| DimensionLocation | 拾取墙体进行对齐标注 |

**GNMEP（机电）** — `SDK/GNMEP/.Net/Samples/source/Samples.sln`

| 示例 | 说明 |
| :--- | :--- |
| CreatDuct | 创建风管、风管连接、连接风口等 |
| CreatPipe | 创建横管、管道连接、连接喷头等 |
| LayEquipment | 布置喷头、创建喷头连接管道等 |
| CodeSnippets | 常见 FAQ 代码片段 |

### 配套工具 GLookup

各专业 `.NET/Tools`（或 `.Net/Tools`）提供 GLookup 插件配置。请按对应数维专业与发行版本从以下地址下载插件：

- 发布页：[gitee.com/glodon/glookup/releases](https://gitee.com/glodon/glookup/releases)
- 使用说明见文档站点「辅助工具 → GLookup」：[aecos.glodon.com/docs/designapi](https://aecos.glodon.com/docs/designapi)

### Python

各专业 `Python` 目录提供 API 文档与 `PythonEngine.addin`，可在对应数维软件中加载后执行 Python 脚本。使用前请阅读该专业下的「使用声明」与「入门指南」。

---

## 快速开始

1. **准备环境**  
   - 安装并取得合法授权的数维房建相关产品（建筑 / 结构 / 机电，按目标专业选择）  
   - 确认所用 SDK 版本与软件版本一致  

2. **获取本仓库**  
   ```bash
   git clone https://gitee.com/glodon/gnovalab.git
   ```

3. **运行 .NET 示例**  
   - 用 Visual Studio 打开对应专业的 `Samples` 解决方案  
   - 按入门指南配置对第三方程序集（`ThirdParty/Glodon`）与插件加载（`.addin`）  
   - 编译后在数维软件中加载并调试  

4. **使用 Python**  
   - 参考各专业 `Python` 目录下的入门指南  
   - 配置 `PythonEngine.addin`，在软件中执行脚本  

5. **查阅文档**  
   - 本地：各专业目录下的入门指南（`.docx`）、API 帮助（`.chm`）、变更说明（`.xlsx`）  
   - 在线：[数维设计 API 文档](https://aecos.glodon.com/docs/designapi)

---

## 使用须知

- 二次开发应基于广联达官方发布的数维房建相关产品，并取得合法使用授权。  
- 开发前请确认 SDK 与数维软件版本一致；产品升级后可能需要适配插件。  
- 完整条款见各专业目录下的 [使用声明.md](./SDK/GNA/使用声明.md)。  
- 用户协议与隐私政策：[用户协议](https://account.glodon.com/agreement) · [隐私政策](https://account.glodon.com/privacy)

---

## 分支说明
GNovaLab采用分支开发的方式进行迭代开发，根据需要按需clone相关分支： 
- Beginner分支：入门级的代码示例等，入门级配套的视频教程请参考：https://jzkt.fwxgx.com/courses/26234.html
- Master分支：最新的代码分支，含入门级示例代码，以及持续建设的开源内容。

---

## 参与贡献

1. Fork 本仓库  
2. 新建功能分支（如 `Feat_xxx`）  
3. 提交代码  
4. 发起 Pull Request  

---

## 联系与支持

- 技术支持邮箱：designapi@glodon.com  
- 在线文档：https://aecos.glodon.com/docs/designapi  

---

## 许可证

示例源代码遵循 [MIT License](./LICENSE)，Copyright (C) Glodon Company Limited。