PlugHub Packages

PlugHub Packages 是 PlugHub 的外部插件包仓库，用于独立开发、构建和分发 Revit 业务功能。PlugHub 主框架负责模块发现、启用状态、Ribbon 组合和 Revit 入口适配，本仓库只保存可被 PlugHub 加载的功能模块。

仓库中的 packages.json 是插件包清单，dist/*.dll 是 PlugHub 运行时加载的程序集。GitHub Actions 会在 main 分支构建插件 DLL，并发布 Release ZIP，便于本地安装。

版本分为两层：根 indexVersion 表示仓库索引和 Release 快照版本，modules[].version 表示单个模块的用户可见版本和更新判断来源。普通发布仍然是单 ZIP；只有实际变更的模块需要递增自己的 version。修 bug、改 Ribbon 名称或调整模块元数据递增 patch；新增兼容功能递增 minor；不兼容改动才递增 major。

功能列表

插件包	功能	说明
PlugHub.GridVisibility	轴网显隐	在当前视图中切换轴网类别的可见性。
PlugHub.LevelVisibility	标高显隐	在当前视图中切换标高类别的可见性。
PlugHub.ReferencePlaneVisibility	参照平面显隐	在当前视图中切换参照平面类别的可见性。
PlugHub.DuctPreferredJunction	风管接头切换	在已选或点选风管的类型上切换风管首选连接类型。
PlugHub.FamilyMaterialParameters	批量材质	批量打开族文件，添加材质参数并关联实体材质参数。
PlugHub.FamilyFileSaver	批量保存	筛选当前项目中的可保存族，并批量保存到指定文件夹。
PlugHub.MepTypeFilterVisibility	机电过滤	框选风管、管道或桥架后，按系统类型或设备类型创建并切换当前视图过滤器。

安装方式

方式一：下载 Release ZIP

这是面向普通用户的推荐方式。

1. 打开 Releases。
2. 下载 Release Assets 中的 PlugHub-Packages-V*.zip。
3. 解压后得到 PlugHub_Packages 文件夹。
4. 将该文件夹复制到 PlugHub 的投放目录：

<PlugHub 安装目录>/packages/dropins/PlugHub_Packages/

5. 确认目录结构如下：

packages/dropins/PlugHub_Packages/
  packages.json
  dist/
    PlugHub.DuctPreferredJunction.dll
    PlugHub.FamilyFileSaver.dll
    PlugHub.FamilyMaterialParameters.dll
    PlugHub.GridVisibility.dll
    PlugHub.LevelVisibility.dll
    PlugHub.MepTypeFilterVisibility.dll
    PlugHub.ReferencePlaneVisibility.dll
  icons/
    duct-preferred-junction.png
    family-file-saver.png
    family-material-parameters.png
    grid-visibility.png
    level-visibility.png
    mep-type-filter-visibility.png
    reference-plane-visibility.png

6. 重启 Revit，或在 PlugHub 中重新加载插件来源。

方式二：配置仓库来源

PlugHub 默认公开仓库源使用 Gitee，普通用户优先配置：

{
  "id": "plughub-public-packages",
  "provider": "gitee",
  "visibility": "public",
  "repository": "https://gitee.com/GaoMengGu/PlugHub_Packages",
  "ref": "main",
  "manifestPath": "packages.json",
  "enabled": true
}

如果团队环境优先访问 GitHub，也可以把 provider 改为 github，并把 repository 写成 GaoMengGu/PlugHub_Packages。PlugHub 会通过 HTTP archive 缓存仓库归档，并读取仓库中的 packages.json 和 dist/*.dll。因此本仓库保留 dist DLL，bin/obj 和 PDB 文件不进入版本库。

开发说明

新增插件包时，通常需要：

1. 新建 .NET Framework 4.8 类库项目。
2. 引用 PlugHub 主框架的 PlugHub.Contracts.csproj。
3. 创建模块描述类，实现 IPlugHubModule。
4. 创建命令类，实现 Revit 的 IExternalCommand。
5. 在 packages.json 中新增模块和功能记录，并设置模块 version 和 author。

如果使用 AI agent 辅助编写插件，推荐尝试安装并使用 GaoMengGu/PlugHub_Packages_skill，让 agent 按本仓库约定生成模块代码、清单记录和验证步骤。

更多目录约定和清单字段说明见 DEVELOPMENT.md。