用途:比较两份带来源标识的数量快照,按明确的建筑、楼层、阶段或修订范围进行对量,给出只读的比较结果,并解释匹配、缺失、冲突与未知项。适合核对图纸、报告或清单中的数量差异;不用于从源数据中提取数量,图纸提取属于 /as:drawing-quantity-extract。
主要能力:读取两份实际输入并保留哈希与定位信息;按标签、范围、单位等键做比较;区分匹配、冲突、缺失和未知;对每个差异给出双方定位与来源覆盖;只保存获得授权的衍生报告并回读验证。产品标识或规格差异交由 /as:product-audit 处理。
使用方式:需提供两份来源明确的数量快照,以及具体的建筑、楼层、阶段和修订范围。执行前先阅读宿主契约与声明。使用宿主适配器和可用的原生工具或任务专用代码;操作名表示语义流程,不是已安装函数,无需 Arch Studio 运行器、包安装或可执行重建。已有准确授权持续有效,仅在缺少关键信息或权限时询问。应用 schedule_reconcile.compare 进行原生计算。
限制:结果为只读比较,不是权威的合并清单。缺少范围或单位证据时保持未解决。比较键重复时必须先显式聚合或解决冲突。未知为 null 而非零,缺失行不视为零;匹配只能证明双方数值一致,不代表正确或完整。不得用模糊匹配或自动同义词,别名或单位换算必须依据来源证据显式解决。不得把整个校园清单与单个楼层直接比较。不得把重复房间清单相加来消除重复键;照明报告应先经 /as:lighting-report-extract 区分清单与计算面。不得把未解决或冲突的身份压平为权威数量。修订说明可解释拆分,但不授权更改标签或记录;保留竞争值,并区分拟议更正与已批准更正。采用变更须经 /as:master-schedule 并明确选中变更与预期修订。缺少宿主能力时输出有界移交,不得伪造匹配或静默回退。重试前需重读输入哈希。注册项目报告需按原生文档解析/注册语义解析坐标,并用 documents.query 查找现有记录,不得猜测文件夹。