| 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 不做以下事情
- 不做"是否满足标准限值"的合规判断——该判断由调用方基于各自 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 | 撞击声估算，受垫层参数离散性影响较大 |
降级规则
| 场景 | 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 仅在接收到评价量后执行对应的计算模型。
