# Acoustic Calculation Engine

> 装配式装修通用隔声计算引擎。提供空气声隔声和撞击声隔声的专业估算，含吻合效应分析、MSM模型、声桥/缝隙风险评估。供隔墙、楼地面、吊顶技能调用，不独立面向用户。

- Skill: `eiway112/acoustic-calculation-engine` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add eiway112/acoustic-calculation-engine`
- Raw SKILL.md: https://api.skillmd.com/api/skills/eiway112/acoustic-calculation-engine/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: eiway112 (https://skillmd.com/u/eiway112)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/eiway112/acoustic-calculation-engine

---


# 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 仅在接收到评价量后执行对应的计算模型。