acoustic-calculation-engine

name	acoustic-calculation-engine
description	装配式装修通用隔声计算引擎。提供空气声隔声和撞击声隔声的专业估算，含吻合效应分析、MSM模型、声桥/缝隙风险评估。供隔墙、楼地面、吊顶技能调用，不独立面向用户。
version	1.0.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	关键参数变化对结果的影响趋势

ACE 不做以下事情

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

三、接口契约摘要

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	撞击声估算，受垫层参数离散性影响较大

降级规则

场景	ACE 输出行为
参数不足	返回"参数不足，无法执行有效计算"，列出缺失字段
构造超出适用边界	返回"超出模型适用范围"，列出不可建模因素和人工评估建议
计算类型不支持	返回"当前计算类型 [XX] 不在 ACE 支持范围内"
材料参数缺失	使用标准参数表中的典型值推算，假设说明中标注"使用典型值推算"

调用方降级策略

当 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
Step 3: 执行分步计算 → 组装 ACE-OUT

ACE 不自行判断适用标准——标准识别由 SRE 完成。ACE 仅在接收到评价量后执行对应的计算模型。