图标
使用方法
要使用插件，需要选择一个现有配置或创建一个新配置。要创建新配置，请点击 
。
可以通过在带有提示“输入配置名称”的文本字段中输入名称来重命名所选配置；也可以复制 
、导出 
、导入 
（以 XML 格式包含所有设置），或使用相应按钮删除 
：
配置复制功能仅在插件完整版中可用。
每个配置都包含一组策略。策略在元素处理算法上有所不同。点击 添加策略 按钮后，将打开一个对话框，其中包含可用策略列表及其简要说明：
在列表中，每个策略包含一个用于启用/禁用策略的复选框、策略的系统名称、用户名称，以及在鼠标悬停时显示的复制 
、更改列表中策略背景颜色 
和删除 .png)
按钮：
策略复制功能仅在插件完整版中可用。
当前配置中的策略可以通过点击 导出 按钮导出到 Excel，也可以通过点击 导入 按钮从 Excel 导入。
插件窗口左下角包含按钮，可用于选中当前配置中的所有策略 
、取消全部选中 
，以及删除当前配置中的所有策略 
。
当选中某个策略时，插件窗口右侧将显示其内容，包括用于输入用户名称的文本字段、策略描述、数据源、策略的 过滤器 以及规则表：
部分策略可能具有公共配置设置，这些设置位于设置面板中，可通过点击窗口右上角的相应按钮打开：
文档更改提交 —— 用于确定更改在文档中提交的时机：在为每个元素设置每个参数值之后、在处理每条规则的所有表达式之后，或在处理每个策略的所有规则之后。提交方式的选择会影响插件的运行时间：选择 设置参数值时 所需时间将多于 处理策略时。
每个策略由规则组成。规则定义了对处理元素的过滤方式以及应用于这些元素的公式。元素过滤使用 按类别和参数的元素过滤器。根据策略不同，规则可能包含条件源元素的过滤器（例如：InHost 策略中的宿主元素、InGroup 策略中的组、SolidTouch 策略中的接触元素等）。此外，根据策略不同，也可能不存在类别过滤器。
策略过滤器适用于所有未指定自身元素过滤器的规则。如果策略过滤器仅指定类别过滤器，而规则过滤器仅指定参数过滤器，则最终会得到包含指定类别和参数的组合过滤器。反之亦然。如果规则中同时指定了类别过滤器和参数过滤器，则策略过滤器将被忽略。
可以为策略连接一个数据源，该数据源为指定 Excel 文件中的工作表。可通过相应按钮在策略中连接 
或断开 
文件，并从所选文件的工作表下拉列表中选择工作表。
要在表格中添加规则，请使用 ；要删除所选规则，请使用 
；要复制所选规则，请使用 。
规则复制功能仅在插件完整版中可用。
当前策略的规则可以复制到剪贴板 
，并从剪贴板粘贴 
到当前策略或其他策略中。可使用 .png)
按钮展开规则列表：
当前策略的规则可以通过点击 导出，或通过点击 导入。支持两种导入/导出文件格式：XML 和 Excel。在将规则导入到空策略中，或在替换当前规则时导入，策略名称和描述也将一并导入。
可以使用 选中策略中的所有规则，或使用 取消选中所有规则。还可以使用 按钮更改所选规则第一列单元格的背景颜色。
规则可以通过鼠标在列表中移动，也可以拖拽到其他策略中。移动规则后，可点击 
按钮根据表格中的位置重新编号。
每条规则都可以通过取消对应表格单元格中的复选框而从执行中排除。
双击 公式 或 公式属性 单元格将打开公式编辑器：
在公式编辑器顶部有一个链接，点击后可打开公式编辑器的详细使用说明：
公式由多个表达式组成，这使得可以对符合父规则过滤条件的元素执行多次计算。除表达式外，公式还包含以下属性：
- 容差 —— 设置用于比较数值的容差。例如，当容差设置为 0.1 时，条件 “10.05 = 10.06” 将被视为成立。
- 区分大小写 —— 设置字符串值比较时是否区分大小写。
- 写入空值 —— 指定是否将表达式计算得到的空结果写入目标参数。对于字符串参数，空结果为空字符串；对于数值参数，空结果为 0。
- 取消关联 —— 在存在关联时，允许将目标参数与项目全局参数解除关联。
在公式编辑区域右侧提供了辅助按钮：
用于将目标元素的参数添加到公式中。参数列表在满足以下两个条件时可用：1）目标元素过滤器中至少指定了一个类别；2）模型中至少存在一个属于该类别的元素实例。若不满足条件，按钮将不可用。
用于将条件源元素的参数添加到公式中。参数列表在满足以下两个条件时可用：1）条件源元素过滤器中至少指定了一个类别；2）模型中至少存在一个属于该类别的元素实例。若不满足条件，按钮将不可用。如果父策略不包含条件源元素，则该按钮不会显示。
用于向公式中添加算术函数或条件函数。
在插件设置窗口中有一个 函数名称映射 按钮，点击后将打开一个窗口，可为公式编辑器中的函数自定义名称：
在公式编辑器窗口右侧是 字段 区域，可用于通过关键字替换公式的部分内容。字段可以相互嵌套。
要添加新字段，可以点击窗口右侧的 按钮，或在编辑区域中选中公式的一部分，右键选择 创建字段。
当鼠标悬停在字段上时，可使用以下命令：复制字段 、删除字段 、将字段添加到收藏 
或从收藏中移除 
。通过窗口右侧的 
按钮可打开编辑器，将选中的收藏字段（可使用 Ctrl 或 Shift 选择）插入到当前公式的字段列表中。该编辑器也可从插件设置窗口中打开，用于编辑或添加新的收藏字段。收藏字段可用于其他规则的公式，并可通过 
在所有配置的所有规则中更新字段值：
当鼠标悬停在 公式 单元格上时，会显示 
按钮，用于在规则列表中显示/隐藏公式，
以及 
按钮，用于打开 逐步计算：
逐步计算用于以单个元素为例检查公式的计算过程。为此，需要 选择 目标元素以及条件源元素（如需要），然后点击 执行。计算结果将显示在窗口中，但不会写入元素参数。
在根据当前配置启动参数化之前，需要指定元素的选择方式：
不同的选择方式在不同策略下具有各自的特点：
处理所选元素。如果存在 Types 策略，则只会处理选中元素的类型。如果存在处理元素内部元素的策略（如 InRoom、InSolid、InMass 等），则需要选择所有元素，而不仅是父元素。
处理当前视图中的元素。推荐选项！如果存在 Types 策略，则会处理当前视图中元素的类型。对于某些策略，当前视图非常重要。例如，InRoom 策略在 3D 视图中无法工作，因为房间在 3D 视图中没有几何体。此外，还需注意当前视图的细节级别可能会影响与几何相关的策略（如 InRoom、InSolid、SolidTouch 等）的结果。
处理选定视图中的元素。在弹出的窗口中，需要勾选包含待处理元素的视图。其行为类似于 处理当前视图中的元素。
处理文档中的元素。如果存在 Types 策略，则会处理文档中的所有类型。对于依赖元素几何体的策略（如 InRoom、InSolid、SolidTouch 等），不建议使用该选项，因为获取的几何体不会考虑与其他元素的相互作用，可能导致结果不正确。
处理链接文件中的元素 选项允许在某些策略（如 InRoom、InMass、OneToMany 等）中使用位于链接文件中的元素。启用 选择关联文件 选项后，需要在弹出的窗口中勾选要搜索元素的文档；若未启用，则会处理所有链接文件。
要启动参数化，请点击 执行 按钮并等待处理结果。
在结果窗口中，将显示已执行的策略和规则数量、耗时以及处理的元素数量。下方列出已执行的策略，并显示每个策略处理的元素数量和耗时。展开列表后，可查看每条规则表达式处理的元素数量。
对于列表中选中的表达式，窗口右侧会显示处理过的元素 ID 列表，并可通过相应按钮选择或隔离所有元素。如果处理了来自链接文件的元素，其 ID 也会显示在列表中，但无法选中这些元素。
检查 按钮用于检查公式计算结果是否与当前参数值一致，例如查找未填写值的参数。检查完成后，将显示一个与参数化结果窗口类似的检查结果窗口。
几何处理
对于 InRoom、InSpace、InMass、InSolid 策略，可以选择以下两种体积包含判定算法之一：
包含关系通过从目标元素体积形心在 XY 平面四个方向发射辅助射线来确定。如果四条射线全部与父元素的体积相交，则认为目标元素位于父元素内部：
对于 InRoom 策略，四条射线中有三条相交即视为正向结果。
该算法运行速度快，但只能确定目标体积是否位于单个父体积内，且对体积形心的位置较为敏感。
包含关系通过 Revit API 提供的布尔运算来确定，本质上是判断体积之间的相交情况。例如，该算法会认为一根梁同时位于两堵墙内：
该算法运行速度较慢，但可以确定目标体积是否位于多个相交的父体积内。
对于上述两种算法，都会检查体积大小——父体积必须大于目标体积。
在 SolidTouch 策略中，仅通过元素体积的平行平面来判断接触关系。
