acoustic-calculation-engine

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 不做以下事情

1. 不做"是否满足标准限值"的合规判断——该判断由调用方基于各自 A1 性能指标表完成
2. 不替代实验室检测报告或现场实测——输出始终标注"专业估算"
3. 不处理超出适用边界的构造——返回"超出模型适用范围"
4. 不覆盖现场侧向传声、门窗薄弱构件、施工质量离散等不可建模因素
5. 不包含任何标准限值，保持纯技术计算定位
6. 不将基准校准结果视为变体构造的检测值——即使基准来自标准图集或检测报告，变体构造的输出仍属"专业估算"（见 §七）

三、接口契约摘要

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 三层架构）

1. 调用方标识层：技能标识 + 计算类型 + 评价量
2. 构造描述层：构造类型 + 板材层 + 空腔层 + 支撑/连接系统 + 密封方式
3. 计算选项层：输出详细度 + 频率范围

各调用方的最小参数集详见 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 检测报告编号）；③ 变体构造描述。

适用前提（三条须同时满足）

1. 基准来源可信：标准设计图集或 CMA/CNAS 检测报告，来源信息可记录；来源不明或无法溯源的不予校准。
2. 构造同族：基准与变体的结构形式（单叶 / 双叶+空腔等）与支撑体系类型相同，差异限于板材面密度（板型/厚度/层数）、空腔填充等参数。
3. 无机理级变化：连接方式未改变（如共用龙骨→独立双排龙骨）、叶片数量未增减。机理级变化使面密度比对失效，须回退 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 评价量标注）
• 变体构造的确定性数值仍须以同构造检测报告为准，校准结果不得表述为变体构造的检测值