- 版本
- 1.0.30
- 发布日期
- Windows 签名
- 未签名
Windows 默认会拦截从互联网下载的文件——这是 Windows 自带的安全机制,不是安装程序的问题。本版本尚未数字签名,首次运行时会请你确认;下载页说明你会看到什么以及如何通过。
新增
- file_save_document 保存当前文档,连接器现在会跟踪哪些文档里还有尚未保存的连接器写入。file_save_document、file_save_as_document、worksharing_synchronize_with_central 和 document_close_non_active(discard_modified)会清除该记录;把工作共享模型保存到中央、保存未命名文档、保存链接文档,或关闭仍含未保存连接器写入的文档,都会以具名代码被拒绝,而不是事后失败。
- view_temporary_mode_set 可在视图中启用或停用临时隐藏/隔离和显示隐藏元素,可重置临时隐藏/隔离,并可将临时覆盖转为永久。
- code_value_resolve 在中心按具名指标返回类型化的数值、区间、集合或禁止结果;当配置文件中该指标只有其他标准或版本的条目时,会指明所固定的标准(CODE_VALUE_STANDARD_NOT_PINNED),并拒绝超出已声明覆盖范围的输入(CODE_VALUE_OUTSIDE_COVERED_DOMAIN)。
- 中心现在会用 flow_tools 返回与查询或一批名称匹配的工具,用 flow_get 返回名称解析出的引用,并在工具或组名未知时返回排序后的候选,让调用方无需猜测即可从错误名称中恢复。
- batch_execute_safe 在预检拒绝时遵循 on_step_failure continue(每个被拒绝的步骤报告自己的状态码、诊断和字段错误),并且现在接受在批次内调用 family_load_safe。
- 钢筋创作能力扩展:钢筋笼工具支持横向分区布置和每端弯钩方向(含方向回读),rebar_get_context_bundle 与 rebar_create_foundation_cage_safe 支持墙基础和独立基础宿主,各钢筋工具增加写入后与重放的宿主包络检查及类型化回读,并对不受支持的弯钩方向给出具名拒绝。
- model_query 返回视图专属的标注包围盒,支持在 elementId 和整型参数上使用 gt/ge/lt/le 过滤,不带 select_parameter_names 时最多接受 32 个参数名,返回未解析的图元 id,并对含未知嵌套字段或缺失必填字段的负载按名拒绝。
- 在中心,mep_inspect_connectivity 的 epanet_sprinkler、equal_friction 和 hazen_williams 模式会对求解管径与输入管径不同的管道或风管返回 size_changes({ element_id, shape, size_meter, expected_current_size_meter }),省略未使用的 ops 字段,并在 epanet_sprinkler 模式下要求每根管道提供正整数 element_id(缺省时返回 HYD_PIPE_ELEMENT_ID_ABSENT)。
- penetration_crossings_read 读取机电管线与墙、楼板及结构框架宿主的穿跨越配对,对被拒绝的配对以 pair_status refused 报告,当斜墙、变截面墙或弧形墙上的洞口无法落在轴线上时返回 not_determined(PENETRATION_WALL_CROSSING_NOT_DETERMINED),并仅在既有洞口与穿越线段相交时列出 existing_opening。
- 1.0.30 的变更在发布前未在真实 Revit 会话中演练,也未在干净机器上运行;所有者将在发布后在自己的机器上测试。
变更
- 对外提供的工具数据面迁移到国际单位制:数值架构字段带 x-units 标注,连接器与中心架构中的英尺制负载成员统一改名为 *_meter / *_millimeter / *_cubic_meter,放置图纸与移动视口接受 x_mm/y_mm 和 target_x_mm/target_y_mm(裸 x/y 键按名拒绝),document_get_project_units 报告 PipeSize,明细表单元格与筛选值按明细表列自身单位写入,data_import_safe 新增列键、明细表字段、规格类型、单位类型和明细表格式覆盖等类型化成员。旧字段名会以 PAYLOAD_FIELD_RENAMED 被拒绝并给出替代名,中心在分派前会按所绑定连接器的目录检查传入负载。
- mep_inspect_connectivity 的 subnetwork_cut 方法现在以 BboxMeter(MinXMeter..MaxZMeter,单位为米)返回每个节点的包围盒,替代旧的 bounding_box 键;model_compare(geometric_compare)只读取 BboxMeter,比较行若仍携带旧键(bounding_box、BoundingBox、bbox、BBox 或扁平的 MinXMeter..MaxZMeter)会以 MODEL_COMPARE_BBOX_KEY_LEGACY 按名拒绝并指明图元。
- mep_inspect_connectivity 的 epanet_sprinkler 方法要求每个喷头节点提供 coverage_area_m2;缺失时以 HYD_HEAD_COVERAGE_AREA_ABSENT 拒绝,不再按危险类别假定覆盖面积。
- 中心规划器与契约面收紧:四个 E3 批处理入口(route_read、project_inspect_foundation、project_inspect_structural_framing、audit_compliance_report)要求每个用例有唯一 case_id,并按名拒绝未知负载键;MEP 与框架规划器暴露真实的方法与截面目录成员,边界点命名为 boundary_points_m,拒绝详情使用一组封闭的字段标识符,FieldGroup 备选在架构上显式声明而非推断。
- 中心按调用方所绑定的连接器版本提供知识卡片、工具摘要与代码取值应答;仍绑定旧版连接器的调用方继续收到旧版卡片与指引集合。
- 中心在记录、存储或提供工具结果前会剥离连接器上报的文件系统路径;执行前以 NOT_EXECUTED 被拒绝的调用,用同一幂等键重试时会正确重放,而不是返回已存储的拒绝。
- Control Center 与更新运行器改用 .NET 10 运行时随包发布,应用内更新只停止映像路径位于安装根目录之下的进程,且该路径由内核解析而非猜测。
- 对外提供的知识卡片、操作手册、代码取值表与行内工具摘要已针对新工具、拒绝代码和区域配置文件更新。
修复
- parameter_set_safe、batch_set_parameters、parameter_batch_fill_safe 与 data_import_safe 在提交前按存储语义校验写入值的回读,当回读不匹配或所有条目都被跳过时回滚,无法解析的双精度值仅跳过该条目而不回滚同批其他写入,并在报告 applied 前检查事务提交状态;parameter_add_shared_safe 在既有绑定上合并类别而不丢失已绑定类别,通过回读与提交状态校验绑定(SHARED_PARAM_BINDING_READBACK_MISMATCH、SHARED_PARAM_TRANSACTION_NOT_COMMITTED),并在既有绑定种类冲突或不可读时按名拒绝(SHARED_PARAM_BINDING_KIND_MISMATCH、SHARED_PARAM_BINDING_KIND_UNREAD)。
- rebar_create_wall_cage_safe、rebar_create_slab_mesh_safe 与 rebar_create_foundation_cage_safe 强制执行具名的 0.05 m 最小层间距(REBAR_SPACING_BELOW_MINIMUM)与 bar_count >= 2 下限(REBAR_BAR_COUNT_BELOW_MINIMUM),对洞口裁剪后变为零组钢筋的请求层以具名代码拒绝(REBAR_LAYER_NO_BARS),按名写入或拒绝显式的逐层弯钩 id 与方向,并在提交前按冻结方案逐层核对已放置钢筋。
- document_activate_view_safe 在钢筋显示覆盖写入失败时将整组回滚(ACTIVATE_VIEW_REBAR_DISPLAY_OVERRIDE_FAILED、ACTIVATE_VIEW_REBAR_DISPLAY_TEMPLATE_LOCKED);spatial_clash_detect 对自比较集合按无序配对只评估一次,并在实体体积读取抛出异常时安全失败。
- 连接器读取现在会明确报错而不是返回空答案:实体体积读取报告具名失败,检查器轨迹统计不可读参数,空间分区摘要报告真实包围盒,图纸质检快照与标注布置会指明跳过的范围和不可读的引出线,板形编辑在提交前校验回读。
- 复制、图纸、视图、明细表、导入、链接、类别和楼梯工具对含糊目标一律按名拒绝;路径状态无法读取的中央模型会安全失败;管道坡度修复会指明未覆盖的管径和含糊锚点;QC 对比、PDF 回执、体量、审计与表格导入路径均已加固。
- 此前忽略事务提交失败的变更类工具现在会返回具名的提交或回滚失败,而不是报告成功;覆盖标注、项目设置、视图自动化、图纸视图/基准与变换各组工具,grid_update_safe 也不再把仅改名的调用误拒为 ELEMENT_UPDATE_NO_FIELDS。
- project_create_wall_safe、project_create_floor_safe、project_create_sloped_floor_safe、view_set_crop_safe 与 view_set_view_range_safe 通过回读校验已提交结果,并对提交状态、类型解析、边界与工作共享拒绝给出具名失败,而不是凭假设校验。
- 几何创作工具通过回读校验并按名拒绝:curtain_grid_create_safe 报告类型化的网格方向、间距与偏移拒绝,sweep_create_project_safe 拒绝含糊的族匹配并回显其默认角度,MATERIAL_NAME_TAKEN 携带已存在材质的 id,wall_create_arc_safe 与 reference_plane_create_safe 在提交前把结果与请求比对。
- element_move_safe 回读被移动的图元,并以具名代码拒绝被固定的图元、不可用的中心点和回滚失败;link_revit_model_safe 拒绝未生效的放置坐标系、不可用的宿主中心和回滚失败。
- 变换类工具按内置类别连接类型、出错后绝不提交、拒绝少于两个图元的数组、在指定源文档中解析 SetId、拒绝未覆盖的类型映射复制,并返回带 SourceTraceId 的回读。
- 视图图形工具拒绝无效视图 id,为未解析的覆盖与筛选器复制目标给出类型化结果,指明不可读的样板控制项,通过回读校验类别可见性,汇总未解析的 OST 标记,并报告不可读的链接文档。
- sheet_print_pdf_safe 按名拒绝含糊或缺失的 PDF 打印样式并给出可选值,拒绝无效的颜色深度与纸张放置选项,并在 FILE_EXISTS 时指明输出文件或拆分目录;schedule_create 拒绝含糊类别并报告总计与提交状态;族加载拒绝二选一负载与含糊名称;IFC、DWG 与 gbXML 导出按名拒绝含糊的样式与视图。
- Revit API 失败现在以 REVIT_API_EXCEPTION 返回并附异常类型与回滚提示,而不是笼统的未处理错误;原先笼统的 REVIT_FAILURE 与参数错误坍缩已替换为带恢复提示的具名拒绝代码;geometry_join_apply 为每个被拒绝的配对报告各自的状态码,而不是单一的校验失败。
- sketch_edit_profile_safe 在提交前校验草图环,以具名代码拒绝退化、自相交和收拢几何;annotation_create_spot_elevation 可在坡道楼板、板和屋面上放置标高点。
- 分页读取与结果通道已加固:游标生成与校验会写入文档纪元,CURSOR_EXPIRED_SNAPSHOT 携带恢复提示,flow_read_result 与 flow_call 共用同一套已结算信封投影,大结果改走上传而不阻塞通道,中断的读取会报告具名结果。