MACAI v0.1.9

VERSION

MEPbridge ACAIstr v0.1.9

Portable, zero-setup delivery (headline change). One bilingual Windows x64 Workbench package with a bundled, provenance-checked portable Node runtime: extract it to a writable folder and run Install-MEPBridge.cmd. No separate Node.js or npm installation is required.

This release adds the single bilingual Windows Workbench package for Archicad 28/29/30, with a bundled portable Node runtime, current native Add-Ons, production dependencies, and consistent multi-instance targeting across the Workbench execution chain.

Highlights

Fixed

• Archicad instance selection no longer falls back to a stale fixed endpoint; Copilot and PlanChain keep the selected host identity throughout an active task.
• Curtain-wall grid input accepts mixed integer and floating-point spacing arrays, and in-place grid edits preserve the parent GUID.
• Extruded morph creation uses outward-facing topology and isolated memo storage; custom-height walls detach the top-story link.

Added

• One bilingual Windows x64 complete package for Archicad 28, 29 and 30, including production dependencies and a provenance-checked portable Node runtime. No separate Node.js or npm installation is required.
• Atomic mixed wall/curtain-wall editing, expanded batch creation for slabs, roofs and extruded morphs, slab thickness/elevation editing, and relationship-verified solid operations and roof/wall trimming.
• Explicit target-port support for the optional MCP path and consistent live-instance switching in the Workbench UI.

Iteration-scope source/offline work (outside the v0.1.9 acceptance claims)

These changes landed in the v0.1.9 iteration at the source/offline layer only. They are disabled or partially integrated by default, have not completed browser or live-model verification, and are not part of the limited-scope acceptance.

• Central extension bar: nine peer navigation entries (capability panorama, knowledge standards, model review, templates, commands, instances, Building JSON, CAD layers, settings); settings pinned last with four sub-panels consolidated; lazy-loaded panels with visited-tab keep-alive; preview tabs disabled with zero navigation or requests. Navigation never changes execution permissions.
• Knowledge standards: bilingual KB contract with a declarative library — source text is never translated, values and units stay language-independent, 2 MB / 500 entries / 8 libraries quotas, cross-process lock with disk-hash CAS, monotonic revision with expectedRevision on every write, and a separate ui-preferences.json with GET/PUT endpoints. Deletion becomes a recoverable disable; failed saves no longer report success.
• Model review infrastructure: settings and run-history persistence (per-project fingerprint partitions, default OFF, wx lock, revision CAS, fsync + rename, independent historyStored:false warnings) and controlled locate/recheck limited to a saved runId with evidence/result hashes and read-only session binding. Approved check definitions remain 0. This does not provide automatic professional model auditing or compliance certification.

NEW CONTRIBUTORS

• @bleufeng

Upgrade

Full package update required — do not upgrade by replacing the APX alone.

This release updates the native Add-Ons, Workbench Server, MCP Server, descriptor registry, compiled UI, runtime and installation layout together. First installations and upgrades from v0.1.8 or earlier must use the complete Workbench ZIP.

Safety

Use a test or backed-up PLN before write, delete, batch, or geometry-changing operations. Review the selected Archicad instance, target GUIDs, units and story context. Dry-run validates the request but does not prove that a model change occurred.

---

版本

MEPbridge ACAIstr v0.1.9

便携交付，免安装前置环境（本版首要变化）。 单一双语 Windows x64 Workbench 完整包内置经过来源校验的 Node 便携运行时；解压到可写目录后运行 Install-MEPBridge.cmd 即可，无需另行安装 Node.js 或 npm。

本版本面向 Archicad 28／29／30 提供单一双语 Windows Workbench 完整包，内置 Node 便携运行时、当前原生 Add-On 与生产依赖，并统一 Workbench 执行链中的多实例目标选择。

更新要点

修复

• Archicad 实例选择不再回退到过期的固定端点；Copilot 与 PlanChain 在任务执行期间持续绑定用户选择的宿主身份。
• 幕墙分格支持整数与浮点数混排，原位分格编辑保持父 GUID 不变。
• 拉伸 Morph 使用外向法向拓扑与独立 memo；自定义高度墙体解除顶部楼层关联。

新增

• 面向 Archicad 28、29、30 的单一双语 Windows x64 完整包，包含生产依赖与经过来源校验的 Node 便携运行时，无需另装 Node.js 或 npm。
• 墙体／幕墙混合原子编辑、楼板／屋顶／拉伸 Morph 批量创建、楼板厚度／标高编辑，以及带关联读回的实体运算和屋顶／墙体修剪。
• 可选 MCP 路径支持显式目标端口，Workbench UI 可在多个在线实例间一致切换。

迭代期源码／离线层改动（不计入 v0.1.9 限定范围验收）

以下为 v0.1.9 迭代期的源码／离线层工作，默认关闭或仅部分集成，浏览器与实机验证均未执行，不属于本版限定范围验收内容。

• 中央扩展条：九项平级导航（功能全景、知识规范、模型审查、模板、命令、实例、Building JSON、CAD 图层、设置），设置固定末位并收纳四个子面板；面板按需加载、访问过的页签保活，预告项禁用且点击零导航零请求。导航不改变执行权限。
• 知识规范：KB 双语契约与声明式规范库（规范原文不翻译、数值与单位不随语言变化、2 MB／500 条／8 库配额、跨进程锁 + 磁盘 hash CAS、revision 单调递增且所有写入带 expectedRevision、独立 ui-preferences.json 与 GET/PUT 接口）。删除改为可恢复禁用，保存失败不再返回成功。
• 模型审核相关基础设施：设置与运行历史持久化（按工程指纹分区、默认关闭、wx 锁、revision CAS、fsync + rename、historyStored:false 独立告警），以及受控定位／复检（仅限已保存 runId 内的 GUID 与规则、校验证据／结果 hash、会话只读绑定、配额 4 MB／100 项／100 次运行）。已批准检查定义数为 0；本项不提供自动专业模型审核或合规认证能力，也不作此声明。

新贡献者

• @bleufeng

升级

必须重装完整包——不能只替换 APX 文件。

本版本同时更新原生 Add-On、Workbench Server、MCP Server、descriptor 注册表、编译 UI、运行时与安装结构。首次安装以及从 v0.1.8 或更早版本升级都必须使用完整 Workbench ZIP。

安全提示

执行写入、删除、批量或几何修改前，请使用测试或已备份的 PLN，并核对当前选择的 Archicad 实例、目标 GUID、单位与楼层。Dry-run 仅校验请求，不证明模型已实际修改。

MACAI v0.1.8

VERSION

MEPbridge ACAIstr v0.1.8

Trusted-native-construction release: every write path now runs inside a single undoable transaction with in-transaction readback and kernel-level rollback, so an over-tolerance result leaves no residue in the model. Four complex construction families (curtain wall with grid patterns, extruded shell, railing, skylight) enter the release boundary, and a read-only drawing-view reader is added.

Highlights

Added

• A unified command foundation: one base execution envelope, an undoable transaction guard with in-transaction readback, an RAII memo-handle guard, and shared validation helpers. All creation commands now share the same transaction, exception, and resource-safety baseline.
• Atomic creation: geometry readback and over-tolerance rollback happen inside the same transaction as creation, so a failed result is rolled back by the model kernel instead of being cleaned up afterwards.
• Native complex construction: curtain walls with grid patterns, extruded shells, railings, and skylights are now natively buildable and part of the release boundary. They are real parametric elements, not geometric approximations.
• Drawing-view awareness: a read-only reader extracts lines, arcs, polylines, and text from the current drawing view without modifying the model.
• Single-pitch roof editing: slope, elevation, and pivot-line editing are now supported.

Fixed

• Skylights hosted by a shell passed pre-creation validation but always failed the post-creation readback; roof and shell hosts are now handled consistently.
• Element editing previously validated only the home story, so out-of-tolerance geometry changes could be reported as success; all editable geometry is now read back with a 1 mm tolerance and rolled back on deviation.
• Response-contract governance across the whole command surface: the root required field is now the status field, and every response path — including preview and empty-input branches — carries a status, so error responses can no longer be masked by contract rejection.

NEW CONTRIBUTORS

• @bleufeng

Upgrade

Full package update required — do not upgrade by replacing the native add-on binary alone.

This release updates the native add-on, Workbench Server, MCP Server, descriptor registry, and compiled UI together.

After installation, Ping should report version 0.1.8, 91 registered native commands, 91 descriptor/MCP tools, and 4 local server tools.

Known limitations

• Editing existing complex components (for example changing curtain-wall grid patterns after creation) is scheduled for the next release.
• Controlled creation of materials and attributes is scheduled for a later release; cross-project material binding currently works by name matching only.
• Native add-on binaries are released for Archicad 28 and Archicad 29 on Windows x64 only.

Safety

Use a test or backed-up PLN before write, delete, batch, or geometry-changing operations. Dry-run validates the request but does not prove that a model change occurred.

---

版本

MEPbridge ACAIstr v0.1.8

原生构建可信基座版：所有写入路径统一进入单一可撤销事务，几何读回与内核级回滚在同一事务内完成，超差结果不会在模型中留下任何残留。幕墙（含网格分格）、拉伸壳体、栏杆、采光顶四类复杂构件进入正式发布边界，并新增只读绘图视图读取能力。

更新要点

新增

• 统一命令基座：统一的执行信封、带同事务读回的可撤销事务守卫、内存句柄自动释放守卫与共享校验工具。所有创建类命令现在共享同一套事务、异常与资源安全基线。
• 原子创建：几何读回与超差回滚和创建发生在同一事务内，失败结果由模型内核回滚，而不是事后清理。
• 原生复杂构件：幕墙（含网格分格）、拉伸壳体、栏杆、采光顶均可原生构建并进入发布边界，是真正的参数化构件而非几何近似。
• 图纸视图感知：只读提取当前绘图视图中的线、弧、多段线与文字，不修改模型。
• 单坡屋顶编辑：支持坡度、标高与枢轴线编辑。

修复

• 壳体宿主的采光顶此前能通过创建前校验，却必然在创建后读回失败；现统一处理屋顶与壳体两类宿主。
• 构件编辑此前只校验楼层归属，几何超差修改可能被报告为成功；现对全部可编辑几何执行 1 mm 容差读回，超差即回滚。
• 全命令面响应契约治理：根级必填字段统一为状态字段，包括预演与空输入分支在内的所有响应出口均携带状态，错误响应不再被契约拦截掩盖。

新贡献者

• @bleufeng

升级

必须重装完整包——不能只替换原生插件二进制文件。

本版本同时更新原生 Add-On、Workbench Server、MCP Server、descriptor 注册表与编译 UI。

安装完成后，Ping 应回报版本 0.1.8、91 个注册原生命令、91 个 descriptor/MCP 工具与 4 个本地服务工具。

已知限制

• 既有复杂构件的编辑（例如创建后再修改幕墙网格分格）安排在下一版本。
• 材质与属性的受控创建安排在后续版本；跨工程材质目前仅按名称匹配绑定。
• 原生插件仅提供 Windows x64 的 Archicad 28 与 Archicad 29 版本。

安全提示

执行写入、删除、批量或改变几何的操作前，请先使用测试或已备份的 PLN。Dry-run 仅校验请求有效性，不证明模型已发生改变。

MACAI v0.1.7

VERSION

MEPbridge ACAIstr v0.1.7

Reliability, precision-placement, and architecture-alignment release: rebuilt AC28/AC29 Add-Ons with atomic in-transaction readback gates (CreateObject floor assignment, CreateBeam top-offset tolerance, CreateLamp angle normalization), calibrated CreateStair effective tread-depth calculations for symmetric switchback stairs, introduced individual-fallback degraded property reading, exposed Beam topOffset in MCP, and added Google Antigravity (including Antigravity CLI) host detection.

Highlights

Fixed

• Object vertical placement (CreateObject) now properly sets the floor index guard when resolving absoluteZ; element GUID, element type, library part index, and verified home story level are validated within the creation transaction, guaranteeing readback consistency.
• Beam placement (CreateBeam) unifies element identity, home story, and topOffset gates into the creation and properties transaction with strict 1 mm tolerance; readback mismatches trigger BEAM_READBACK_FAILED, BEAM_FLOOR_INDEX_MISMATCH, or BEAM_TOP_OFFSET_MISMATCH with atomic rollback.
• Stair geometry and assembly (CreateStair): tread depth is calibrated to effective treads to eliminate false rule conflicts, "starts with riser, ends with riser" is explicitly supported for symmetric switchback stairs, and baseline limits are removed to support multi-segment polyline and arc paths.
• Lamp geometry verification (CreateLamp) undergoes finite coordinate/angle checks and in-transaction geometry readback; normalized angles and coordinates are validated within 1 mm / 0.001 rad tolerances, rolling back on deviations.
• Batch property reading (GetElementProperties) gracefully handles inaccessible or internal properties (such as internal parent IDs) with an individual-fallback degraded mode: all valid readable properties are returned alongside detailed errors and PROPERTY_VALUES_INCOMPLETE, rather than failing the entire batch.
• Element mirroring (MirrorSelectedElements) resolves GUID-mode accessibility through MCP and enforces identity-only mutation gates.
• Internal property definition command (EnsurePropertyDefinitions) is strictly isolated from external MCP tools to prevent unauthorized metadata mutation.

Added

• Beam top offset (CreateBeam.topOffset) is explicitly exposed in tool descriptors and MCP tools for millimeter-level elevation and offset control under slabs, interlayers, and slopes.
• MCP client status in Workbench left sidebar supports automatic detection and connection status display for Google Antigravity and Antigravity CLI.

NEW CONTRIBUTORS

• @bleufeng

Upgrade

Full package update required — do not upgrade by replacing the APX alone.

This release updates the native Add-On, Workbench Server, MCP Server, descriptor registry, and compiled UI together.

After installation, Ping should report version 0.1.7, 89 registered C++ commands, 89 descriptor/MCP tools, and 4 local server tools.

Safety

Use a test or backed-up PLN before write, delete, batch, or geometry-changing operations. Dry-run validates the request but does not prove that a model change occurred.

---

版本

MEPbridge ACAIstr v0.1.7

模型可靠性、精确标高与基础架构对齐版：重编 AC28/AC29 Add-On，建立同事务原子回读门禁（修复对象归属层守卫、梁顶偏移 1mm 容差门禁、灯具归一化角度回读），校准楼梯有效踏面算法以原生支持标准双折楼梯对称平整装配，引入属性批量读取逐项优雅降级，在 MCP 中开放梁顶偏移距参数，并新增 Google Antigravity（含 Antigravity CLI）宿主自动识别。

更新要点

修复

• 对象垂直定位：彻底修复绝对标高（absoluteZ）解析后因缺少楼层标志置位导致真实归属层未赋值的底层缺陷；在单事务内增加真实 GUID、构件类型、图库项索引与真实归属层校验，确保归属楼层真实来自模型回读。
• 梁定位与回读：将梁构件身份、归属层及顶偏移校验统一纳入创建与属性的同一事务闭环；引入 1mm 标高容差回读门禁，读写不一致时触发报错并原子回滚。
• 楼梯几何与装配校准：踏面进深改按有效踏面数计算以消除假性规则冲突，显式支持“以踢面起步、以踢面结束”以实现标准双折对称平整装配，并解除基线段数限制以支持多段折线与圆弧段。
• 灯具几何回读：补齐输入坐标与旋转角的有限性检查与同事务几何回读；归一化角度与位置在 1 mm / 0.001 rad 容差范围内校验，超差原子回滚。
• 批量属性优雅降级：解决批量读取内部只读或未暴露属性（如对象“上层ID”）时抛错导致整批失败的问题；引入逐项优雅降级，返回全部有效可读属性（实测 224/226 项成功）并回报逐项明细。
• 镜像命令可达性：修复按 GUID 镜像构件在 MCP 调用的连通性，补齐构件身份校验门禁。
• 内部元数据隔离：内部属性定义命令完成隔离拦截，防止非受控元数据污染模型。

新增

• 梁顶偏移距参数：在描述符与 MCP 工具中正式开放梁顶偏移距（topOffset）参数，支持降板、设备夹层与找坡梁的毫米级精确标高设定。
• MCP 接入状态扩展：工作台左侧列表支持 Google Antigravity（含 Antigravity CLI）的自动检测与连接状态展示。

新贡献者

• @bleufeng

升级

必须重装完整包——不能只替换 APX 文件。

本版本同时更新原生 Add-On、Workbench Server、MCP Server、descriptor 注册表和编译 UI。

安装完成后，Ping 应回报版本 0.1.7、89 个注册 C++ 命令、89 个 descriptor/MCP 工具和 4 个本地 server 工具。

安全提示

执行写入、删除、批量或改变几何的操作前，请先使用测试或已备份的 PLN。Dry-run 仅校验请求有效性，不证明模型已发生改变。

MACAI v0.1.6

VERSION

MEPbridge ACAIstr v0.1.6

fix and capability release: rebuilt AC28/AC29 Add-Ons, corrected element move and roof geometry handling, and added create-with-properties, beam vertical placement, wall constraint and reference-line control, movable roofs, and clearer readback diagnostics across the Workbench Server and MCP tools.

Highlights

Fixed

• Moving building elements now really moves them: the original element identities are preserved and the result is verified against world-coordinate bounds and element counts. It no longer silently duplicates elements or reports a false success.
• Roof read and write share one model-coordinate frame, so a roof can be placed at the requested location and read back consistently.
• Batch column and beam creation no longer fails wholesale.
• Stair bounding boxes report the full stair height instead of zero.
• Element deletion verifies the removed elements, and an environment-blocked delete no longer reports success.
• Pipe creation matches diameters exactly and lists the available sizes instead of silently approximating.
• The MEP system inventory reports the system domain correctly.
• Top-story elevation overflow is diagnosed before the change, with a suggested operation order, instead of a silent rollback.
• Column geometry readback includes rotation and vertical placement values, so rotated columns can be verified.

Added

• Create-with-properties: building element creation accepts a property list, writing geometry and semantics in one atomic call; if any property fails, the whole creation is rolled back.
• Optional vertical placement for beams, with post-create readback.
• Wall constraint editing: story-top height, top offset, and bottom offset.
• Wall reference-line position and offset control.
• Roof is now supported by element move.
• Meter-based move vectors.
• Snapshot replay restores the wall bottom offset.
• An official PowerShell call example for the local HTTP API.

NEW CONTRIBUTORS

• @bleufeng

Upgrade

Full package update required — do not upgrade by replacing the APX alone.

This release updates the native Add-On, Workbench Server, MCP Server, descriptor registry, and compiled UI together.

After installation, Ping should report version 0.1.6, 89 registered C++ commands, 88 descriptor/MCP tools, and 4 local server tools.

Known limitations

• Complex-component creation is compiled but not runtime-validated, is planned for v0.1.7.
• The mutation-command acceptance gate still has coverage gaps (move, mirror, rotate, multiply, and several geometry and property edits); they converge in later versions.
• The pipe reference identifier is declared as a string in the MCP schema while the native command expects an integer; the diameter parameter is the documented workaround until v0.1.7.

Safety

Use a test or backed-up PLN before write, delete, batch, or geometry-changing operations. Dry-run validates the request but does not prove that a model change occurred.

---

版本

MEPbridge ACAIstr v0.1.6

修复与能力增强版：重编 AC28/AC29 Add-On，修正构件移动与屋顶几何处理，新增创建即设属性、梁垂直定位、墙约束与参照线控制、屋顶可移动，并在 Workbench Server 与 MCP 工具上提供更清晰的回读诊断。

更新要点

修复

• 移动建筑构件现在是真正的移动：构件身份保持，结果以世界坐标包围盒与元素计数校验；不再静默复制构件或回报假成功。
• 屋顶读写共用同一模型坐标框架，屋顶可放到指定位置并一致回读。
• 批量创建柱、梁不再整体失败。
• 楼梯包围盒返回踏步全高，而不是零。
• 删除构件时校验被移除的对象，被环境阻塞的删除不再报成功。
• 管道创建精确匹配管径，并列出可选直径，不再静默近似。
• MEP 系统清单正确返回系统 domain。
• 顶层标高越界在变更前前置诊断并给出建议操作顺序，不再静默回滚。
• 柱几何回读包含旋转与垂直定位值，带旋转柱可被校验。

新增

• 创建即设属性：建筑构件创建支持一次传入属性列表，原子写入几何与语义；任一属性失败则整体回滚。
• 梁支持可选垂直定位，并带建后回读。
• 墙约束编辑：楼层顶高、顶偏移、底偏移。
• 墙参照线位置与偏移控制。
• 构件移动支持屋顶。
• 米制移动向量。
• 快照复现恢复墙底偏移。
• 新增本地 HTTP API 的官方 PowerShell 调用示例。

新贡献者

• @bleufeng

升级

必须重装完整包——不能只替换 APX 文件。

本版本同时更新原生 Add-On、Workbench Server、MCP Server、descriptor 注册表和编译 UI。

安装完成后，Ping 应回报版本 0.1.6、89 个注册 C++ 命令、88 个 descriptor/MCP 工具和 4 个本地 server 工具。

已知限制

• 复杂构件创建已编译但未实机验证，计划在 v0.1.7 处理。
• 变更类操作的验收门禁仍有覆盖缺口（移动、镜像、旋转、阵列及若干几何与属性编辑），将随后续版本逐步收敛。
• 管道参照标识在 MCP 定义中为字符串，而原生命令需要整数；在 v0.1.7 修正前以管径参数为文档化绕过方式。

安全提示

执行写入、删除、批量或几何修改操作前，请使用测试或已备份的 PLN。Dry-run 只校验请求，不代表模型已经实际发生变化。

MACAI v0.1.5

VERSION

MEPbridge ACAIstr v0.1.5

Full package update: rebuilt AC28/AC29 Add-Ons, expanded native design and editing commands, story and documentation capabilities, controlled element multiplication, first trim and solid-operation support, hardened dual-instance targeting

Highlights

Fixed

• Roof geometry readback returns the full closed contour in model coordinates, fixing shifted or incomplete outlines in comparison and copy workflows.
• Stair rule prechecks use a 1 mm tolerance for riser height, going, and 2R+G, preventing valid native stairs from being rejected by rounding noise.

Added

• Field-level editing for Column, Beam, and Slab, with precise field masks and readback.
• Controlled vector and two-direction array multiplication for Wall, Column, Beam, Slab, Roof, Mesh, and Morph by explicit GUID.
• Read-only inventories for nine attribute families and native documentation element types.
• Minimal native Text, linear Dimension, and single-line Label creation.
• Story setting changes and guarded story deletion with full story snapshot verification.
• First supported trim round: one Wall with one Roof operator using KeepInside or KeepOutside.
• First supported solid-operation round: two Morph elements using Subtract or Add.
• Dual-instance targeting keeps reads and writes bound to the selected Archicad instance and fails closed on invalid or dead target ports.

NEW CONTRIBUTORS

• @bleufeng

Upgrade

Full package update required — do not upgrade by replacing the APX alone.

After installation, Ping should report version 0.1.5, 89 registered C++ commands, 88 descriptor/MCP tools, and 4 local server tools.

Known limitations

• Teamwork story operations are deferred; Teamwork projects are rejected.

Safety

Use a test or backed-up PLN before write, delete, batch, or geometry-changing operations. Dry-run validates the request but does not prove that a model change occurred.

---

版本

MEPbridge ACAIstr v0.1.5

完整包升级：重编 AC28/AC29 Add-On，扩展原生设计与编辑命令，新增楼层与文档能力、受控构件阵列、首轮修剪和实体运算，强化双实例寻址

更新要点

修复

• 屋顶几何读回返回模型坐标系中的完整闭合轮廓，修复比较与复制流程中的偏移或不完整轮廓。
• 楼梯规则预检对踢面高度、踏面宽度和 2R+G 使用 1 mm 容差，不再因舍入噪声拒绝有效原生楼梯。

新增

• 柱、梁、板支持字段级编辑，提供精确字段掩码和读回。
• 按显式 GUID 对墙、柱、梁、板、屋顶、网面、变形体执行受控向量和双向阵列复制。
• 新增九族属性与原生文档元素类型的只读盘点。
• 新增最小原生文本、线性尺寸和单行标签创建。
• 新增楼层设置修改与带身份保护的楼层删除，并校验完整楼层快照。
• 首轮原生修剪：一个墙目标与一个屋顶操作件，支持 KeepInside / KeepOutside。
• 首轮原生实体运算：两个变形体支持 Subtract / Add。
• 双实例寻址保持读写绑定到所选 Archicad 实例，无效或失活端口显式失败。

新贡献者

• @bleufeng

升级

必须重装完整包——不能只替换 APX 文件。

安装完成后，Ping 应回报版本 0.1.5、89 个注册 C++ 命令、88 个 descriptor/MCP 工具和 4 个本地 server 工具。

已知限制

• Teamwork 楼层操作暂缓，Teamwork 项目会被拒绝。

安全提示

执行写入、删除、批量或几何修改操作前，请使用测试或已备份的 PLN。Dry-run 只校验请求，不代表模型已经实际发生变化。

MACAI v0.1.4

VERSION

MEPbridge ACAIstr v0.1.4

Full bilingual package update: rebuilt AC28/AC29 Add-Ons, native building-element editing commands, hardened batch safety, and cross-project instance targeting, snapshot capture/compare/replay served by the local Workbench Server.

Highlights

Fixed

• Explicit wall heights are no longer clamped to the story height.
• Walls now use the center reference line; the body no longer shifts sideways.
• Window sill height is applied; openings above the host wall top are rejected.
• Windows and doors inherit the host wall's story.
• set_active_story previews by default and reports previousStoryIndex.
• Stair tread depth is reported as the effective resolvedGoing.
• Workbench template replay refreshes saved templates before execution.
• Fixed bug causing slow reproduction of user‑defined templates in Workbench.

Added

• Moving and editing building elements by GUID with per-field masks and readback.
• Optional absolute-Z placement for walls, columns, objects, and lamps.
• Mirror and rotate accept explicit GUID lists.
• Four local server tools: list Archicad instances, capture/compare/replay snapshots.
• Copy is all-or-nothing with a single undo; delete is capped at 200 per call with acknowledgeCount above 50.

Upgrade

Full package update required — do not upgrade by replacing the APX alone.

After installation, Ping should report version 0.1.4, 79 registered C++ commands, 78 descriptor/MCP tools, and 4 local server tools.

Do not use the auto-generated Source code.zip / Source code.tar.gz; they are not installation packages.

Known limitations

• Snapshot replay is geometry-only (Wall/Column/Beam/Slab/Zone); layer, classification, and element-property data are metadata only and never restored.
• POST /api/undo returns 501; Archicad exposes no undo command.

Safety

Use a test or backed-up PLN before write, delete, batch, or geometry-changing operations. Dry-run validates the request but does not prove that a model change occurred.

---

版本

MEPbridge ACAIstr v0.1.4

完整双语包升级：重编 AC28/AC29 Add-On，新增原生建筑构件编辑命令，强化批量安全，并交付由本地 Workbench Server 承载的跨工程实例寻址、快照采集/比较/回放工具。

更新要点

修复

• 显式指定的墙高不再被楼层高度钳制。
• 墙改用中心参考线，墙身不再横向偏移。
• 窗台高度生效；超出宿主墙顶的开洞被拒绝。
• 窗和门继承宿主墙所在楼层。
• set_active_story 默认预览并回报 previousStoryIndex。
• 楼梯踏面改为输出有效踏面 resolvedGoing。
• Workbench 模板重放前先从服务端刷新已保存模板。
• 已修复工作台用户模板复现缓慢bug。

新增

• 按 GUID 移动和编辑建筑构件，字段级 mask 与结果读回。
• 墙、柱、对象、灯具支持可选绝对标高 absoluteZ。
• 镜像与旋转支持显式 GUID 列表。
• 四个本地 server 工具：列出实例、采集/比较/回放快照。
• 复制全成或全不成、整批单步撤销；设定安全值删除每次限 200，超过 50 须回抄 acknowledgeCount。

升级

必须重装完整包——不能只替换 APX 文件。

安装完成后，Ping 应回报版本 0.1.4、79 个注册 C++ 命令、78 个 descriptor/MCP 工具和 4 个本地 server 工具。

不要使用 GitHub 自动生成的 Source code.zip / Source code.tar.gz，它们不是安装包。

已知限制

• 快照回放仅承诺几何（墙/柱/梁/板/区域）；图层、分类和构件属性只作为元数据保存，不会恢复。
• POST /api/undo 返回 501；Archicad 未公开撤销命令。

安全提示

执行写入、删除、批量或几何修改操作前，请使用测试或已备份的 PLN。Dry-run 只校验请求，不代表模型已经实际发生变化。

MACAI v0.1.3

VERSION

MEPbridge ACAIstr v0.1.3

UPGRADE TYPE

Full package update required.

This release updates the native Add-On, Server, MCP Server, and descriptor
registry. Do not update by replacing the APX files alone. Use the complete ZIP
package.

After installation, Ping should report version 0.1.3, 76 registered C++
commands, and 74 descriptor/MCP tools.

WHAT'S CHANGED

Fixed

• Slab, Roof, and Zone creation now accepts closed polygon contours.
• Zone creation now uses the supplied contour and correctly writes the zone name
  and category.
• Explicit slab thickness is now applied correctly.
• Degenerate polygon input now returns a clear validation error.
• Copying Mesh and Morph elements is now supported.
• MCP client status now uses the initialize handshake and distinguishes
  connected clients from configured clients.
• Public CI now exports only the approved command-safety test from the private
  test directory.

Added

• Added a read-only endpoint for listing running Archicad instances and their
  open projects.

Known limitations

The following capabilities are implemented but have not yet been verified on
Archicad. Do not rely on them in this release:

• GSM object selection and the objectRef creation path.
• ViewportCapture.targetViewName.
• Complete Door, Window, and Stair read/write regression coverage.

ASSETS

• MEPbridge-ACAIstr-v0.1.3-win64-zh-CN.zip — Chinese full package.
• MEPbridge-ACAIstr-v0.1.3-win64-en-US.zip — English full package.
• MEPbridge-ACAIstr-v0.1.3-AC28-win64.apx — AC28 APX update.
• MEPbridge-ACAIstr-v0.1.3-AC29-win64.apx — AC29 APX update.

This release requires the complete ZIP package. The standalone APX files are
not sufficient for upgrading v0.1.3.

INSTALL

1. Extract the complete ZIP package.
2. Close Archicad.
3. Run Install-MEPBridge.cmd.
4. Select the Archicad installation when prompted.
5. Restart Archicad.
6. Open the MEPbridge ACAIstr Workbench.

Use the package matching your Archicad major version. Do not mix APX files and
installation packages from different releases.

SAFETY

Use a test or backed-up PLN before write, delete, batch, or geometry-changing
operations. Review target GUIDs, units, story context, and confirmation prompts.
Dry-run validates the request but does not prove that a model change occurred.

---

版本

MEPbridge ACAIstr v0.1.3

升级类型

必须重装完整包。

本版本同时更新了原生 Add-On、Server、MCP Server 和 descriptor 工具注册表，
不能只替换 APX 文件。请使用完整 ZIP 安装包。

安装完成后，Ping 应回报版本 0.1.3、76 个注册 C++ 命令和 74 个
descriptor/MCP 工具。

更新内容

修复

• 板、屋顶和区域创建现在支持闭环多边形轮廓。
• 区域创建现在使用调用方提供的轮廓，并正确写入名称和类别。
• 显式指定的板厚度现在可以正确生效。
• 退化多边形输入现在返回明确的校验错误。
• 复制元素现在支持网面和变形体。
• MCP 客户端状态现在依据 initialize 握手判断，并区分“已连接”和“仅已配置”。
• 公开仓 CI 现在只导出并运行获准的命令安全检查，不扩大私有测试目录边界。

新增

• 新增只读端点，用于列出正在运行的 Archicad 实例及其打开的工程。

已知限制

以下能力已经实现，但尚未在 Archicad 上完成实机验证，本版本请勿依赖：

• GSM 对象选择及对象创建的 objectRef 路径。
• ViewportCapture.targetViewName。
• 门、窗、楼梯的完整读写回归覆盖。

安装包

• MEPbridge-ACAIstr-v0.1.3-win64-zh-CN.zip：中文完整安装包。
• MEPbridge-ACAIstr-v0.1.3-win64-en-US.zip：英文完整安装包。
• MEPbridge-ACAIstr-v0.1.3-AC28-win64.apx：AC28 APX 更新包。
• MEPbridge-ACAIstr-v0.1.3-AC29-win64.apx：AC29 APX 更新包。

本版本必须使用完整 ZIP 安装包。独立 APX 不足以完成 v0.1.3 升级。

安装

1. 解压完整 ZIP 安装包。
2. 关闭 Archicad。
3. 运行 Install-MEPBridge.cmd。
4. 按提示选择 Archicad 安装目录。
5. 重启 Archicad。
6. 打开 MEPbridge ACAIstr Workbench。

请使用与 Archicad 主版本匹配的安装包。不要混用不同版本的 APX 和安装包。

安全提示

执行写入、删除、批量或几何修改操作前，请使用测试或已备份的 PLN。
核对目标 GUID、单位、楼层上下文和确认提示。Dry-run 只校验请求，
不代表模型已经实际发生变化。

MACAI v0.1.2

VERSION

MEPbridge ACAIstr v0.1.2

WHAT'S CHANGED

Fixed

• The installer now locates Archicad on any fixed drive instead of only C: and D:, and also searches the ProgramFiles(x86) and ProgramW6432 roots.
• The installer reuses an existing MEPBridge Add-On folder when one is already present, so a repeat install no longer leaves two copies under different Add-On directories.
• The installer detects Node.js and warns when it is missing. The Add-On itself still installs and Archicad commands still work; only the Workbench Server, UI, and MCP Server require Node.js 18 or later.
• Install-MEPBridge.cmd no longer hides the interactive Archicad-folder prompt, so users whose Archicad is installed outside the default location can still answer it.
• ApplyFavorite, AssignClassification, CreateFromFavorite, SaveFavorite, and SetLayerBatch had their dryRun and confirmRequired parameters stripped before reaching the Add-On, so the Add-On fell back to a dry run and the write silently never happened while still reporting success. All five now pass both parameters through.
• GetViewMap always returned an empty list because it enumerated Publisher Sets instead of requesting each Navigator view map directly. It now reads the Public and My view maps by map id, and reports any map it could not open under skippedMaps so an empty result can be told apart from a failed query.
• CreateWall now writes the user-supplied thickness and height to the element instead of silently dropping them. The element mask was not set after ACAPI_Element_GetDefaults, so Archicad reused the wall-tool default thickness (0.3 m) and height (3.0 m) and ignored the request. The command now sets API_BasicStructure so the thickness field is honoured, and sets the mask for the geometry fields it changes.
• ChangeElementGeometry, ChangeStairGeometry, and ChangeOpeningGeometry passed a null element mask to ACAPI_Element_Change, which Archicad treats as "change nothing", so Wall/Column/Beam/Stair/Door/Window geometry edits were silently ignored. They now mask only the fields explicitly requested instead of using SETFULL; wall thickness edits also switch composite/profile walls to API_BasicStructure and write back the current building material so the scalar thickness takes effect.
• ApplyFavorite and CreateFromFavorite dry-run responses now include an explicit applied: false field and a note explaining that confirmRequired=true is required to actually apply. Previously a dry run reported mode: "dry-run" but gave no boolean flag, so callers could mistake it for a successful write.

Changed

• Installation guides document the Node.js prerequisite, custom install paths, and a full step-by-step manual installation procedure covering administrator rights, locating the Archicad folder, choosing between Archicad 28 and 29, handling a previous build, and verifying the result.
• The registered command and descriptor counts now come from a single ai-adapter/command-boundary.json file that the release gate, the public repository validator, CI, and the packaging scripts all read, instead of each carrying its own copy.
• Command examples no longer contain hardcoded MEP system names or attribute indexes. Those identifiers are not stable across projects, locales, or Archicad versions, so omitting them lets the Add-On use the domain default. A static check keeps them out.
• The Archicad runtime regression now checks returned content rather than only that response fields exist, and covers the favourite, layer-batch and classification write commands end to end, each restoring what it changed.
• The internal command guide lists all 74 registered commands. It had 52, so the favourites, profile, view-map, classification and layer commands were absent along with the project and story queries. Command counts there now defer to ai-adapter/command-boundary.json.
• The public repository validator no longer aborts on a Markdown link containing a stray percent sign; such a link is reported as broken instead.

NEW CONTRIBUTORS

• @bleufeng

ASSETS

• MEPbridge-ACAIstr-v0.1.2-win64-zh-CN.zip: Chinese full package.
• MEPbridge-ACAIstr-v0.1.2-win64-en-US.zip: English full package.
• MEPbridge-ACAIstr-v0.1.2-AC28-win64.apx: AC28 APX update only.
• MEPbridge-ACAIstr-v0.1.2-AC29-win64.apx: AC29 APX update only.

Install

1. Extract the complete ZIP to a normal writable directory.
2. Save your work and close Archicad.
3. Double-click Install-MEPBridge.cmd.
4. Approve the administrator prompt and select the Archicad installation.
5. Restart Archicad.
6. Use the MEPbridge ACAIstr menu to open the Workbench.

Use only the APX matching the installed Archicad major version; the installer selects
it automatically. Download the full ZIP for a first install. The standalone APX files
are only for users who already have the full runtime and want to update the matching
Archicad Add-On.

Safety

Use a test or backed-up PLN before write, delete, batch, or geometry-changing operations.
Review target GUIDs, units, story context, and confirmation prompts. Dry-run validates
parameters and structure; it does not prove that a model change occurred.

---

版本

MEPbridge ACAIstr v0.1.2

更新内容

修复

• 安装程序现在会在所有本地固定磁盘上查找 Archicad，不再只查 C: 和 D:，并额外搜索 ProgramFiles(x86) 与 ProgramW6432 目录。
• 若机器上已有 MEPBridge Add-On 目录，安装程序会复用原位置，重复安装不再在不同 Add-On 目录下留下两份副本。
• 安装程序会检测 Node.js，缺失时给出警告。Add-On 本身仍会正常安装、Archicad 命令仍可使用；仅 Workbench Server、UI 和 MCP Server 需要 Node.js 18 或更高版本。
• Install-MEPBridge.cmd 不再隐藏交互式的 Archicad 目录询问，Archicad 装在非默认位置的用户可以正常回答该提问。
• ApplyFavorite、AssignClassification、CreateFromFavorite、SaveFavorite、SetLayerBatch 的 dryRun 与 confirmRequired 参数在到达 Add-On 之前被剥除，导致 Add-On 退回预演模式：写入实际未发生却仍报成功。现已修正，五个命令均正常传递这两个参数。
• GetViewMap 此前恒返回空列表，原因是它枚举的是发布集而非直接请求各个导航器视图图。现改为按 map id 读取公共视图图与我的视图图，并把打不开的视图图记入 skippedMaps，使「确实没有视图」与「查询失败」可以区分。
• CreateWall 现在会把用户传入的 thickness 与 height 写入元素，不再静默丢弃。此前 ACAPI_Element_GetDefaults 后未置位元素 mask，Archicad 沿用墙工具默认厚度（0.3 m）与高度（3.0 m），忽略请求值。命令现切换为 API_BasicStructure 使 thickness 字段生效，并对修改的几何字段置位 mask。
• ChangeElementGeometry、ChangeStairGeometry、ChangeOpeningGeometry 此前向 ACAPI_Element_Change 传入空元素 mask，Archicad 将其视为「不改动任何字段」，导致 Wall/Column/Beam/Stair/Door/Window 的几何修改被静默忽略。现改为仅对调用方明确请求的字段精确置位，不再使用 SETFULL；修改墙厚时还会把复合/截面墙切换为 API_BasicStructure，并同步写回当前建材，使标量厚度真正生效。
• ApplyFavorite 与 CreateFromFavorite 的 dry-run 响应现新增显式 applied: false 字段及 note 提示，说明需 confirmRequired=true 才会真正应用。此前 dry-run 仅返回 mode: "dry-run"，无布尔标志，调用方可能误判为已成功写入。

变更

• 安装指南补充 Node.js 前置要求、自定义安装路径，以及完整的手动安装分步说明，涵盖管理员权限、如何定位 Archicad 目录、如何区分 Archicad 28 与 29、旧版本处理和安装结果验证。
• 注册命令数与 descriptor 数改由单一的 ai-adapter/command-boundary.json 提供，发布门禁、公开仓校验、CI 与打包脚本统一使用，不再各自保存一份副本。
• 命令示例不再包含硬编码的 MEP 系统名称或属性索引。这些标识跨项目、跨语言、跨 Archicad 版本并不稳定，省略后由 Add-On 使用域默认系统；并新增静态检查防止回归。
• Archicad 实机回归改为校验返回内容而非仅校验字段存在，并新增收藏夹、批量图层、分类三类写入命令的端到端覆盖，每项测完都还原自身改动。
• 内部命令指南补齐全部 74 个已注册命令。此前只有 52 个，收藏夹、截面、视图列表、分类、图层命令与项目/楼层查询均缺失。该文档的命令计数改为以 ai-adapter/command-boundary.json 为准。
• 公开仓校验器遇到含孤立百分号的 Markdown 链接时不再中断整轮校验，而是将该链接报为失效链接。

新贡献者

• @bleufeng

安装包

• MEPbridge-ACAIstr-v0.1.2-win64-zh-CN.zip：中文完整安装包。
• MEPbridge-ACAIstr-v0.1.2-win64-en-US.zip：英文完整安装包。
• MEPbridge-ACAIstr-v0.1.2-AC28-win64.apx：仅 AC28 APX 更新。
• MEPbridge-ACAIstr-v0.1.2-AC29-win64.apx：仅 AC29 APX 更新。

安装

1. 将完整 ZIP 解压到普通可写目录。
2. 保存工作并关闭 Archicad。
3. 双击 Install-MEPBridge.cmd。
4. 授权管理员提示并选择 Archicad 安装位置。
5. 重启 Archicad。
6. 通过 MEPbridge ACAIstr 菜单打开 Workbench。

仅使用匹配 Archicad 大版本的 APX；安装程序会自动选择。首次安装请下载完整 ZIP；
独立 APX 仅用于已具备完整运行环境、需更新对应 Archicad Add-On 的用户。

安全

在执行写入、删除、批量或改变几何的操作前，请使用测试或已备份的 PLN。
核对目标 GUID、单位、楼层上下文与确认提示。Dry-run 校验参数与结构，不代表模型已实际变更。

MACAI v0.1.1

Version

MEPbridge ACAIstr v0.1.1

WHAT'S CHANGED

• 74 C++ commands / 72 descriptor-MCP tools (was 61 / 59).
• 13 new commands: GetFavorites, GetFavorite, CreateFromFavorite, ApplyFavorite, SaveFavorite, GetProfiles, GetViewMap, GetSectionMarkers, GetClassifications, GetLayers, FindElementsByProperty, AssignClassification, SetLayerBatch.
• CreateWall / CreateColumn / CreateBeam now accept an optional profileGuid for cross-section selection.
• Semantic-index main chain integrated into the Workbench Server for natural-language command matching.
• MCP status now shows CodeBuddy, WorkBuddy, Codex, and Claude Code.
• Starter shell template switched to self-contained CreateWall x8 + CreateSlab x2 (cross-project, no GUID dependency).
• CopyElements empty sourceGuids fixed across three layers (resolver / schema / C++ Execute).

• 2026-08-01 asset refresh: fixed the installer (any-drive support, Node.js detection, visible interactive prompt) and the installation guide (step-by-step manual procedure), and corrected the Usage Guide menu target. The APX binaries are unchanged and the version remains v0.1.1.

NEW CONTRIBUTORS

• @bleufeng

ASSETS

• MEPbridge-ACAIstr-v0.1.1-win64-zh-CN.zip: Chinese full package.
• MEPbridge-ACAIstr-v0.1.1-win64-en-US.zip: English full package.
• MEPbridge-ACAIstr-v0.1.1-AC28-win64.apx: AC28 APX update only.
• MEPbridge-ACAIstr-v0.1.1-AC29-win64.apx: AC29 APX update only.

Install

1. Extract the complete ZIP to a normal writable directory.
2. Save your work and close Archicad.
3. Double-click Install-MEPBridge.cmd.
4. Approve the administrator prompt and select the Archicad installation.
5. Restart Archicad.
6. Use the MEPbridge ACAIstr menu to open the Workbench.

Use only the APX matching the installed Archicad major version; the installer selects it
automatically. Download the full ZIP for a first install. The standalone APX files are only
for users who already have the full runtime and want to update the matching Archicad Add-On.

---

版次

MEPbridge ACAIstr v0.1.1

更新内容

• 74 个 C++ 命令 / 72 个 descriptor-MCP 工具（原为 61 / 59）。
• 新增 13 个命令：GetFavorites、GetFavorite、CreateFromFavorite、ApplyFavorite、SaveFavorite、GetProfiles、GetViewMap、GetSectionMarkers、GetClassifications、GetLayers、FindElementsByProperty、AssignClassification、SetLayerBatch。
• CreateWall / CreateColumn / CreateBeam 新增可选 profileGuid 参数，支持截面轮廓选择。
• 语义索引主链接入 Workbench Server，用于自然语言命令匹配。
• MCP 状态现显示 CodeBuddy、WorkBuddy、Codex、Claude Code 四平台。
• 入门 shell 模板改为自包含 CreateWall×8 + CreateSlab×2（跨项目，不依赖 GUID）。
• CopyElements 空 sourceGuids 三层修复（resolver / schema / C++ Execute）。

• 2026-08-01 资产刷新：修复安装脚本（支持任意盘符、Node.js 缺失提示、交互提示可见性）与安装说明（新增分步手动安装指引），并修正「使用指南」菜单跳转。APX 二进制未变更，版本号仍为 v0.1.1。

新贡献者

• @bleufeng

安装包

• MEPbridge-ACAIstr-v0.1.1-win64-zh-CN.zip：中文完整安装包。
• MEPbridge-ACAIstr-v0.1.1-win64-en-US.zip：英文完整安装包。
• MEPbridge-ACAIstr-v0.1.1-AC28-win64.apx：仅 AC28 APX 更新。
• MEPbridge-ACAIstr-v0.1.1-AC29-win64.apx：仅 AC29 APX 更新。

安装

1. 将完整 ZIP 解压到普通可写目录。
2. 保存工作并关闭 Archicad。
3. 双击 Install-MEPBridge.cmd。
4. 授权管理员提示并选择 Archicad 安装位置。
5. 重启 Archicad。
6. 通过 MEPbridge ACAIstr 菜单打开 Workbench。

如自动安装脚本报错推荐按照说明手动安装。

仅使用匹配 Archicad 大版本的 APX；安装程序自动选择。首次安装请下载完整 ZIP；独立 APX 仅用于已具备完整运行环境、需更新对应 Archicad Add-On 的用户。

MACAI v0.1.0

VERSION

MEPbridge ACAIstr v0.1.0

WHAT'S CHANGED

• Initial Windows public preview.
• Supports Archicad 28 and 29.
• Provides Workbench, MCP Server, CollabAI smart mode, and Manual BASE manual mode.
• Ships standalone Chinese and English Windows full packages.

NEW CONTRIBUTORS

• @bleufeng

Known Boundaries

• This is the first public preview; natural-language matching used descriptor local matching only .
• CreateWall / CreateColumn / CreateBeam did not yet accept profileGuid .
• CopyElements empty sourceGuids was not handled across all layers in v0.1.0 .

---

版本

MEPbridge ACAIstr v0.1.0

更新内容

• 首个 Windows 公开体验版。
• 支持 Archicad 28 和 29。
• 提供 Workbench、MCP Server、CollabAI 智能模式与 Manual BASE 手动模式。
• 提供独立中文和英文 Windows 完整安装包。

新贡献者

• @bleufeng

已知边界

• 这是首个公开体验版，自然语言匹配仅用 descriptor 本地匹配。
• CreateWall / CreateColumn / CreateBeam 在 v0.1.0 尚不支持 profileGuid。
• CopyElements 空 sourceGuids 在 v0.1.0 未做全链路处理。

首次安装请下载完整 ZIP, 独立 APX 仅用于已经安装完整运行环境的用户更新对应 Archicad Add-On。