r-y-t-o/RevitActiveQualityMonitor
GitHub: r-y-t-o/RevitActiveQualityMonitor
Revit 2026 可停靠面板插件，提供实时模型质量监控、碰撞检测、规则检查和数据分析功能。
Stars: 1 | Forks: 0
# Revit Active Quality Monitor
一款 Revit 2026 可停靠面板插件，为您的当前 Revit 模型提供实时质量监控、碰撞检测、基于规则的检查和分析功能。
## 功能特性
- **模型概览** — 关于警告、视图、工作集、链接模型等的实时统计信息
- **碰撞检测** — 在宿主和链接模型类别之间运行可自定义的碰撞测试，可视化结果，并在碰撞位置创建剖面框
- **规则检查** — 定义基于参数的规则集（例如“所有门必须具有防火等级”）并按需评估；导入/导出规则配置
- **分析** — 使用条形图、饼图和树状图可视化，按类别统计图元数量和参数分布
- **浅色 / 深色主题** — 可切换，并在会话间保持状态
## 系统要求
| 需求 | 版本 |
|---|---|
| Autodesk Revit | 2026 |
| Windows | 10 或更高版本 (64-bit) |
| WebView2 Runtime | Evergreen (随 Edge / Windows 11 附带) |
## 安装说明
### 选项 A — PowerShell 安装程序（推荐）
1. 从 [Releases](../../releases) 页面下载最新的 `RevitActiveQualityMonitor-v*.zip`。
2. 解压 ZIP 文件。
3. 右键点击 `Install.ps1` → **使用 PowerShell 运行**。
4. 重启 Revit 2026。
5. **Quality Monitor** 面板将出现在 **Add-ins → Quality Monitor → Open Panel** 下。
### 选项 B — 手动安装
1. 按上述步骤下载并解压 ZIP 文件。
2. 将 `RevitActiveQualityMonitor\` 文件夹复制到：
%AppData%\Autodesk\Revit\Addins\2026\
最终路径应为 `%AppData%\Autodesk\Revit\Addins\2026\RevitActiveQualityMonitor\`。
3. 将 `RevitActiveQualityMonitor.addin` 复制到：
%AppData%\Autodesk\Revit\Addins\2026\
4. 重启 Revit 2026。
## 卸载说明
运行解压 ZIP 包中的 `Uninstall.ps1`，或手动删除以下内容：
- `%AppData%\Autodesk\Revit\Addins\2026\RevitActiveQualityMonitor\`
- `%AppData%\Autodesk\Revit\Addins\2026\RevitActiveQualityMonitor.addin`
## 从源码构建
**前置条件：** .NET 8 SDK，Revit 2026 安装在默认路径。
```
git clone https://github.com//RevitActiveQualityMonitor.git
cd RevitActiveQualityMonitor
dotnet build -c Release
```
输出文件位于 `bin\Release\`。
要构建并直接部署到您的本地 Revit 2026 插件文件夹：
```
deploy.bat
```
## 项目结构
```
RevitActiveQualityMonitor/
├── App.cs # IExternalApplication entry point
├── Command.cs # Ribbon button command
├── MainWindow.xaml(.cs) # Dockable pane host + JS bridge
├── AnalysisRequestHandler.cs # IExternalEventHandler (Revit thread work)
├── ModelAnalytics.cs # Overview stats collector
├── ClashEngine.cs # Clash detection logic
├── RuleEngine.cs # Rule evaluation engine
├── AnalyticsEngine.cs # Parameter analytics
├── SettingsManager.cs # Rule persistence (rulesets.json)
├── Logger.cs # File logger
├── ui/
│ ├── index.html # Single-page app shell
│ ├── script.js # All UI logic
│ └── style.css # Theming (CSS variables)
├── Resources/ # Icons / images
└── RevitActiveQualityMonitor.addin
```
## 发布工作流
发布通过 GitHub Actions 自动化。推送格式为 `v*`（例如 `v1.3.8`）的标签将触发：
1. `dotnet build -c Release`
2. 打包为 `RevitActiveQualityMonitor-v.zip`
3. 创建附带 ZIP 文件的 GitHub Release 草稿
## 许可证
MIT — 详情见 [LICENSE](LICENSE)。
标签：AI合规, Autodesk Revit, BIM, Dockable Pane, IPv6, Light/Dark主题, .NET 8, PowerShell, Revit 2026, Revit插件, TCP/UDP协议, WebView2, Windows软件, 参数校验, 可停靠面板, 安装脚本, 工程质检, 建筑信息模型, 插件开发, 数字建造, 楼宇建造, 模型分析, 碰撞检测, 自定义脚本, 规则检查, 质量控制