PlugHub 是面向建模用户的 Revit 2020 插件管理框架。它把多个插件集中到一个 PlugHub Ribbon 页签里，让用户可以在 PlugHub Manager 中管理功能按钮、插件包、仓库源、框架更新和卸载。Revit 中只保留「设置」轻入口和插件命令入口。
PlugHub 的作用不是提供某一个固定建模命令，而是提供一个统一入口：
- 把已安装插件显示在
PlugHub页签中。 - 允许用户调整 Ribbon 分组、按钮顺序、按钮大小和按钮图标。
- 从仓库源同步插件列表，并选择需要的插件安装到本机。
- 在「关于」页签查看当前框架版本并检查更新。
- 记录诊断信息，方便定位插件加载或仓库同步问题。
能做什么：
- 给不同项目或团队整理一套稳定的插件工具栏。
- 只安装当前需要的插件，减少 Ribbon 上的无关按钮。
- 把插件来源集中到仓库源，避免手工到处复制 DLL。
- 在更新框架时尽量只替换框架 DLL 和 PlugHub Manager，不覆盖本地插件和配置。
推荐使用发布页中的安装程序：
PlugHub-Setup-<版本号>.exe
安装程序会复制 PlugHub 文件，写入 addin，并把 Revit 2020 的插件入口注册到：
C:\ProgramData\Autodesk\Revit\Addins\2020\PlugHub.addin
默认安装目录是：
D:\Program Files\PlugHub
安装完成后，目录中会包含 PlugHub.Manager.exe。它用于在 Windows 下打开 PlugHub Manager，也负责「关于」页签里的更新和卸载维护流程。
如果安装或更新时遇到文件夹权限问题，优先按下面方式处理：
- 右键安装程序，选择「以管理员身份运行」。
- 如果公司电脑不允许写入
D:\Program Files\PlugHub，在安装器中选择一个你有写入权限的目录，例如D:\PlugHub或 IT 已授权的共享软件目录。 - 不要把 PlugHub 安装到会被自动清理、同步冲突或权限收回的目录，例如临时目录、桌面同步目录、网盘缓存目录。
- 如果无法写入
C:\ProgramData\Autodesk\Revit\Addins\2020，需要管理员或 IT 帮你完成一次 addin 注册。注册成功后，日常使用 Revit 不需要管理员权限。 - 安装后不要手动移动 PlugHub 文件夹；如果必须换目录，请重新运行安装程序，让 addin 路径同步更新。
打开 Revit 后，进入 PlugHub 页签，点击「设置」。PlugHub 会启动 PlugHub Manager。进入「关于」页签后：
- 左上角会显示
PlugHub和当前框架版本。 - 版本后方有一个检查更新小图标。
- 检查更新小图标后方有一个卸载小图标，用于启动 Manager 卸载维护流程。
- 点击后，如果已是最新版本，只在窗口左下角提示结果。
- 如果发现新版本，会自动弹出目标版本号和 release 更新信息。
- 点击确认后，PlugHub 会下载更新包并启动 Manager 维护流程；关闭弹窗则退出更新。
框架更新只覆盖框架 DLL 和 PlugHub Manager，不覆盖这些内容：
PlugHub.addinpackagesconfig- 仓库缓存
- 日志
当前 Revit 会话不会热替换已加载 DLL。确认更新后，Manager 会关闭并启动临时维护进程；关闭并重新打开 Revit 后，新框架 DLL 和 PlugHub.Manager.exe 才会生效。
布局设置用于调整 PlugHub Ribbon 页签中的按钮位置和显示方式。
常见操作：
- 点击
PlugHub页签中的「设置」，在 PlugHub Manager 中进入「布局」页签。 - 在可用功能列表中选择插件功能。
- 将功能拖拽到目标分组或面板中。
- 选中已有按钮后，可以修改显示名、分组、按钮大小和图标。
- 常规按钮被选中时会高亮；下拉按钮、拆分按钮等控件也会显示选中状态。
- 保存配置后，涉及 Ribbon 结构的变化需要重启 Revit 后生效。
布局建议：
- 高频命令放在靠左或靠前的位置。
- 同一专业或同一流程的功能放在同一分组。
- 小按钮适合辅助命令，大按钮适合主流程命令。
- 不确定的功能先放到临时分组，确认稳定后再整理到正式布局。
仓库源用于告诉 PlugHub 从哪里同步可安装插件。默认公开仓库源使用 Gitee：
https://gitee.com/GaoMengGu/PlugHub_Packages
设置方法：
- 打开 PlugHub Manager，进入「仓库源」或「仓库」相关页面。
- 新增或编辑仓库源，填写名称、地址和分支。
- 私有仓库需要填写 Token；公开仓库通常不需要。
- 保存后点击「同步仓库源」。
- 同步完成后，在插件列表中筛选、搜索并安装插件。
PlugHub 通过 HTTP archive 同步仓库源，普通建模用户不需要安装 Git。同步失败时，优先检查网络、仓库地址、分支名称和 Token 权限。
插件安装有两种常见方式。
推荐方式：
- 先同步仓库源。
- 在插件列表中搜索插件名称、分类或标签。
- 点击插件卡片或行内按钮中的「安装插件」。
- 安装后保存配置。
- 如果提示需要重启 Revit，关闭并重新打开 Revit。
安装后的插件会进入本机 packages 目录。后续更新或卸载也在同一设置窗口中操作。
如果插件包由团队内部直接提供，也可以手动放入安装目录下的 packages 文件夹。手动安装后需要重新打开 Revit，或在 PlugHub Manager 中重新加载配置。
注意：
- 不要在 Revit 正在运行时强行替换已加载 DLL。
- 如果更新或卸载提示需要重启，先关闭 Revit，再重新打开。
- 不要删除
config，它保存了你的布局、仓库源和启用状态。
检查 C:\ProgramData\Autodesk\Revit\Addins\2020\PlugHub.addin 是否存在。不存在时，重新以管理员身份运行安装程序，或让 IT 帮你写入该文件。
确认 Revit 已完全关闭后再重新打开。框架 DLL 只有在 Revit 退出后才能被静默更新程序覆盖。
检查仓库地址、分支名称、网络访问和 Token。公司电脑无法访问 GitHub 时，优先使用 Gitee 仓库源。
检查插件是否已启用、功能是否被加入布局、配置是否已保存。涉及 Ribbon 结构的变化需要重启 Revit。
选择一个你有写入权限的安装目录，例如 D:\PlugHub。如果 addin 注册目录也没有权限，需要管理员完成 C:\ProgramData\Autodesk\Revit\Addins\2020\PlugHub.addin 的写入。
当前说明面向 Revit 2020 用户。非 Revit 环境只能做本地静态验证，不代表已经完成 Revit 现场验收。
PlugHub 源码公开供个人使用、学习和非商业研究。未经作者书面许可，不得商用，不得将本项目或其衍生版本用于销售、集成收费交付或闭源再分发。