| name | acoustic-calculation-engine |
| description | 装配式装修通用隔声计算引擎。提供空气声隔声和撞击声隔声的专业估算，含吻合效应分析、MSM模型、声桥/缝隙风险评估，支持以标准图集/检测报告数据为基准的变体构造校准估算。供隔墙、楼地面、吊顶技能调用，不独立面向用户。 |
| version | 1.1.0 |
ACE — 装配式装修隔声计算引擎
一、技能标识与角色定位
| 项目 | 定义 |
|---|
| 技能标识 | ACE |
| 技能名称 | acoustic-calculation-engine |
| 定位 | 独立补充技能——通用隔声计算基础设施 |
| 核心原则 | 底层物理模型通用化，上层评价量和构造规则由各调用方技能注入 |
| 输出性质 | 专业估算，非实验室检测值、非现场实测值 |
ACE 不直接面向终端用户。它是被隔墙（PW）、楼地面（FL）、吊顶（CL）三个领域技能调用的计算后端，通过标准化接口（IC-03/IC-08/IC-09）接收构造参数、返回估算结果和风险识别。
二、能力边界
ACE 提供以下计算能力
| 编号 | 能力 | 物理模型 | 适用场景 |
|---|
| C1 | 质量定律估算 | M1 | 所有板材构造的空气声隔声基础估算 |
| C2 | 吻合效应分析 | M2 | 所有薄板构造的吻合谷风险识别 |
| C3 | MSM 共振频率与空腔增益 | M3 + M4 | 双层板+空腔构造（龙骨隔墙、隔声吊顶） |
| C4 | 撞击声改善量估算 | M5 | 浮筑地面、楼面垫层 |
| C5 | 声桥/缝隙风险评估 | M6 | 所有构造的节点风险识别 |
| C6 | 敏感性分析 | M1-M6 | 关键参数变化对结果的影响趋势 |
| C7 | 基准校准估算 | M7 | 有标准图集/检测报告基准数据的同族变体构造推算（详见 §七） |
ACE 不做以下事情
- 不做"是否满足标准限值"的合规判断——该判断由调用方基于各自 A1 性能指标表完成
- 不替代实验室检测报告或现场实测——输出始终标注"专业估算"
- 不处理超出适用边界的构造——返回"超出模型适用范围"
- 不覆盖现场侧向传声、门窗薄弱构件、施工质量离散等不可建模因素
- 不包含任何标准限值，保持纯技术计算定位
- 不将基准校准结果视为变体构造的检测值——即使基准来自标准图集或检测报告，变体构造的输出仍属"专业估算"（见 §七）
三、接口契约摘要
ACE 通过三组接口契约被调用，每组契约是通用 ACE-IN/ACE-OUT 在特定场景下的实例化：
| 契约 | 调用方向 | 场景 | 评价量 |
|---|
| IC-03 | PW → ACE | 隔墙空气声隔声 | Rw+C / Rw+Ctr / DnT,w+C |
| IC-08 | FL → ACE | 楼地面撞击声隔声 | Ln,w / ΔL |
| IC-09 | CL → ACE | 吊顶空气声隔声 | Rw+C / Rw+Ctr |
通用输入结构（ACE-IN 三层架构）
- 调用方标识层：技能标识 + 计算类型 + 评价量
- 构造描述层：构造类型 + 板材层 + 空腔层 + 支撑/连接系统 + 密封方式
- 计算选项层：输出详细度 + 频率范围
各调用方的最小参数集详见 interface-contracts.md 对应契约。参数不足时 ACE 返回"参数不足，无法执行有效计算"并列出缺失字段。
通用输出结构（ACE-OUT）
计算结果
├─ 隔声估算区间 {下限, 上限, 评价量, 置信度}
└─ 频段分析 [{中心频率, 估算隔声量, 吻合谷标记}]
风险识别
├─ 吻合效应风险 {等级, 风险频率范围, 说明}
├─ 声桥风险等级 {等级, 风险点, 说明}
├─ 密封评估 {结论, 依据, 改进建议}
└─ 构造合理性意见 {结论, 风险点, 优化方向}
敏感性分析（标准/详细模式）
关键假设说明
适用边界声明
超出范围提示（如有）
四、红线体系
完整注册信息见 redlines-registry.md §八。以下为行为指令摘要。
P0 计算安全红线（2 条，不可违反）
| 编号 | 行为指令 |
|---|
| ACE-R-P0-1 | 输出只能是"专业估算"。禁止表述为实验室检测值或现场实测值。触发后立即更正并提示需检测报告确认。 |
| ACE-R-P0-2 | 输入超出模型适用范围时，禁止继续给出确定数值。返回"超出适用范围"，列出缺失信息和人工评估建议。 |
P1 计算方法红线（3 条）
| 编号 | 行为指令 |
|---|
| ACE-R-P1-1 | 必须识别声桥风险：龙骨刚性连接、贯通构件、节点缺陷等须纳入风险提示，输出声桥风险等级和改进建议。 |
| ACE-R-P1-2 | 必须评估密封风险：隔声密封不足会显著削弱构造性能，须输出密封评估，不得只报理论隔声量。 |
| ACE-R-P1-3 | 禁止替代主技能做合规判断：不判断是否满足标准限值，只做估算结果和风险说明。合规判断由发起方基于 A1/B2 完成。 |
P2 参数记录红线（2 条）
| 编号 | 行为指令 |
|---|
| ACE-R-P2-1 | 必须记录关键假设：面密度、空腔深度、填充材料、连接方式、密封方式等假设均须列出。缺失则返回参数不足。 |
| ACE-R-P2-2 | 必须标注评价量：Rw+C、Rw+Ctr、DnT,w+C、Ln,w、ΔL 不得混用，须在输出中明确标注，并提示不可直接换算。 |
五、输出规范
精度声明
| 评价量 | 典型精度 | 说明 |
|---|
| Rw+C / Rw+Ctr | ±3-5 dB | 实验室条件估算，基于理想构造模型 |
| DnT,w+C | ±5-10 dB | 现场指标，额外计入现场离散因素 |
| Ln,w | ±4-6 dB | 撞击声估算，受垫层参数离散性影响较大 |
| Rw（基准校准模式） | ±2-3 dB | 同族构造锚定标准图集/检测报告基准，精度优于纯模型估算（见 §七） |
降级规则
| 场景 | ACE 输出行为 |
|---|
| 参数不足 | 返回"参数不足，无法执行有效计算"，列出缺失字段 |
| 构造超出适用边界 | 返回"超出模型适用范围"，列出不可建模因素和人工评估建议 |
| 计算类型不支持 | 返回"当前计算类型 [XX] 不在 ACE 支持范围内" |
| 材料参数缺失 | 使用标准参数表中的典型值推算，假设说明中标注"使用典型值推算" |
| 基准校准不适用（基准来源不明 / 构造族不同 / 面密度比超外推区） | 回退 M1-M6 模型估算，标注"基准校准不适用"及具体原因 |
调用方降级策略
当 ACE 调用失败时，调用方使用自身 reference.md 中保留的简化计算方法论执行基础估算，并在输出中标注"简化估算（隔声计算引擎暂不可用）"。
六、与 SRE 的集成
ACE 的计算流程以标准推理为前置步骤：
Step 0: 调用 IC-10（SRE 场景推理）
↓ 获取适用标准集
Step 1: 根据项目类型 + 空间类型确定评价量
空气声场景：
住宅分户墙 → DnT,w+C（GB 55038-2025 强制）
酒店/医院客房 → Rw+Ctr（低频敏感场景）
一般场景 → Rw+C
撞击声场景：
住宅分户楼板 → Ln,w（GB 55038-2025 强制）
面层改善评价 → ΔL
Step 2: 根据评价量选择计算模型组合
空气声隔声 → M1 + M2 + M3/M4 + M6
撞击声隔声 → M5 + M6
提供有效基准数据时 → M7 校准优先，M1-M6 交叉核对（见 §七）
Step 3: 执行分步计算 → 组装 ACE-OUT
ACE 不自行判断适用标准——标准识别由 SRE 完成。ACE 仅在接收到评价量后执行对应的计算模型。
七、基准校准模式（M7）
模式定位
当调用方提供已知构造的权威隔声基准数据时，ACE 以该数据为锚点，通过面密度比对与参数差异修正，反推同族变体构造的隔声量。该模式不做从零理论计算，而是「锚定 + 差分外推」，用于规避纯模型估算对特定构造族的系统性偏差（已知案例：简化 MSM 对双叶石膏板隔墙偏保守 4-6 dB）。
方法论依据：ISO 12354-1:2017 估算框架以构件实验室实测数据为输入估算建筑隔声性能；基准 Rw 须按 GB/T 45305.2-2025（现行，全部代替已废止的 GB/T 19889.3-2005）测量、GB/T 50121-2005 评价，或出自出版的标准设计图集；按 GB/T 19889.3-2005 测得的历史图集/检测报告基准仍可作为锚点，但须在假设说明中注明测量标准版本。
触发条件
调用方同时提供：① 基准构造描述 + 基准隔声量（Rw / Rw+C / Rw+Ctr 等，评价量须明确）；② 基准数据来源（标准图集名称/页码，或 CMA/CNAS 检测报告编号）；③ 变体构造描述。
适用前提（三条须同时满足）
- 基准来源可信：标准设计图集或 CMA/CNAS 检测报告，来源信息可记录；来源不明或无法溯源的不予校准。
- 构造同族：基准与变体的结构形式（单叶 / 双叶+空腔等）与支撑体系类型相同，差异限于板材面密度（板型/厚度/层数）、空腔填充等参数。
- 无机理级变化：连接方式未改变（如共用龙骨→独立双排龙骨）、叶片数量未增减。机理级变化使面密度比对失效，须回退 M1-M6 全模型计算。
方法概要
r = m_new / m_base （面密度比，宜按两侧面板层计）
单叶构造: ΔRw = 20·lg(r)
双叶构造下限: ΔRw_low = 20·lg(r) （质量定律主导）
双叶构造上限: ΔRw_high = 40·lg(r) （理想空腔区、对称双叶、无声桥）
对称变体取区间中值，输出区间；单侧变化按该侧比值取 20·lg
Rw_new = Rw_base + ΔRw + Σ（非面密度参数差异修正，查 M4 增益表差值）
物理依据：质量-空气-质量共振频率以上的质量控制区，解耦双叶构造隔声量近似两叶之和（R ≈ R₁+R₂），两侧面密度同步缩放系数 r 时增益上界为 40·lg(r)；轻钢龙骨等声桥使实际值落在 20·lg 与 40·lg 之间（工程取中值）。完整公式、参数表与算例见 reference.md M7。
交叉核对要求
M7 结果须与 M1-M6 全模型估算交叉核对。两者差 > 5 dB 时，优先报 M7 校准值（数据锚点可信度更高），同时保留 M1-M6 值并说明差异来源（通常为 M1-M6 低估空腔增益、声桥取值偏悲观）。
失效与降级
基准来源不明、构造族不同、或面密度比 r 超出 [0.5, 2] 外推区时，回退 M1-M6 模型估算，标注「基准校准不适用」及原因（见 §五 降级规则）。
输出要求与红线映射
- 输出须列明：基准来源、基准构造与变体构造对比、面密度计算、ΔRw 区间、校准结果区间（ACE-R-P2-1 关键假设记录）
- 校准结果标注「基于基准校准的专业估算」及对应评价量（ACE-R-P0-1 输出性质、ACE-R-P2-2 评价量标注）
- 变体构造的确定性数值仍须以同构造检测报告为准，校准结果不得表述为变体构造的检测值
