ActiveProtect/docs/articles/jammer-spec.md

# 干扰机技术说明书

## 1. 概述

### 1.1 文档目的

本文档旨在详细描述主动防护系统中干扰机子系统的设计实现，包括：

1. 各型干扰机的工作原理和关键算法
2. 系统组件的交互机制和接口定义
3. 关键参数的配置和验证方法
4. 测试用例和验证流程

本文档可用于：

- 系统设计和实现的参考依据
- 测试验证的指导文档
- 系统维护和升级的技术支持
- 新功能开发的基础文档

### 1.2 适用范围

本文档适用于以下人员和场景：

1. 开发人员
   - 系统功能实现
   - 接口开发和维护
   - 算法优化和改进
   - 新功能扩展开发

2. 测试人员
   - 功能测试设计
   - 性能测试验证
   - 系统集成测试
   - 回归测试执行

3. 维护人员
   - 系统问题诊断
   - 参数配置调整
   - 性能监控分析
   - 系统升级维护

### 1.3 系统功能

1. 干扰机类型支持
   - 激光干扰器
   - 红外干扰器
   - 毫米波干扰器

2. 核心功能
   - 干扰功率控制
   - 冷却时间管理
   - 目标跟踪
   - 事件响应
   - 数据记录

3. 验证功能
   - 单元测试验证
   - 系统集成验证
   - 性能指标验证
   - 数据分析验证

### 1.4 参考文献

1. 干扰技术参考
   - 《电子对抗原理》，国防工业出版社
   - 《激光对抗技术》，国防工业出版社
   - 《红外对抗技术》，国防工业出版社

2. 系统设计参考
   - 《软件工程：实践者的研究方法》
   - 《面向对象分析与设计》
   - 《设计模式：可复用面向对象软件的基础》

## 2. 系统架构

### 2.1 总体架构

#### 2.1.1 核心组件

1. 基础干扰器类 (JammerBase)
   - 干扰状态管理
   - 干扰功率控制
   - 冷却时间管理
   - 位置跟随功能

2. 具体干扰器实现
   - 激光干扰器 (LaserJammer)
   - 红外干扰器 (InfraredJammer)
   - 毫米波干扰器 (MillimeterWaveJammer)

3. 干扰器接口 (IJammer)
   - 干扰控制接口
   - 状态查询接口
   - 事件处理接口

#### 2.1.2 事件系统

1. 告警响应事件
   - 激光告警事件
   - 红外告警事件
   - 毫米波告警事件

2. 干扰控制事件
   - 干扰开始事件
   - 干扰停止事件
   - 干扰状态更新事件

### 2.2 接口定义

#### 2.2.1 IJammer 接口

```csharp
public interface IJammer
{
    bool IsJamming { get; }
    double CurrentJammingPower { get; }
    void StartJamming();
    void StopJamming();
    string GetJammingStatus();
}
```

#### 2.2.2 事件接口

1. 干扰事件基类
   - SenderId：事件发送者ID
   - Timestamp：事件时间戳
   - TargetId：目标ID

2. 具体事件类型
   - LaserJammingEvent
   - InfraredJammingEvent
   - MillimeterWaveJammingEvent

### 2.3 数据流

#### 2.3.1 干扰控制流程

```mermaid
graph LR
    A[告警器] --> B[告警事件]
    B --> C[干扰器]
    C --> D[干扰控制]
    D --> E[干扰事件]
```

#### 2.3.2 状态更新流程

```mermaid
graph LR
    A[干扰器] --> B[状态更新]
    B --> C[功率控制]
    C --> D[冷却管理]
    D --> E[事件发布]
```

## 3. 具体实现

### 3.1 激光干扰器

#### 3.1.1 工作原理

激光干扰器通过发射高功率激光来干扰敌方的激光制导系统。其基本工作过程如下：

1. 干扰启动
   - 接收激光告警信号
   - 启动干扰器
   - 设置初始功率（最大功率的40%）
   - 开始功率增长

2. 干扰过程
   - 逐步增加干扰功率
   - 监控目标位置
   - 维持干扰输出
   - 发布干扰事件

3. 冷却管理
   - 停止干扰时进入冷却
   - 冷却时间为5秒
   - 冷却完成后可重新启动
   - 重置干扰功率

#### 3.1.2 关键参数

1. 功率参数
   - 最大功率：10kW
   - 初始功率：4kW
   - 功率增长率：2kW/s

2. 时间参数
   - 冷却时间：5秒
   - 更新周期：与仿真步长一致

### 3.2 红外干扰器

#### 3.2.1 工作原理

红外干扰器通过发射调制的红外辐射来干扰敌方的红外制导系统。其基本工作过程如下：

1. 干扰启动
   - 接收红外告警信号
   - 启动干扰器
   - 设置初始功率
   - 开始功率增长

2. 干扰过程
   - 动态调整干扰功率
   - 跟踪目标位置
   - 维持干扰输出
   - 发布干扰事件

3. 冷却管理
   - 停止干扰时进入冷却
   - 监控冷却时间
   - 管理功率重置
   - 准备下次启动

#### 3.2.2 关键参数

1. 功率参数
   - 最大功率：由配置指定
   - 初始功率：最大功率的40%
   - 功率增长率：由配置指定

2. 波长参数
   - 工作波长范围：由配置指定
   - 调制频率：由配置指定

### 3.3 毫米波干扰器

#### 3.3.1 工作原理

毫米波干扰器通过发射干扰信号来干扰敌方的毫米波制导系统。其基本工作过程如下：

1. 干扰启动
   - 接收毫米波告警信号
   - 启动干扰器
   - 设置初始功率（400W）
   - 开始功率增长

2. 干扰过程
   - 增加干扰功率（最大1kW）
   - 功率增长率200W/s
   - 维持干扰输出
   - 发布干扰事件

3. 冷却管理
   - 冷却时间5秒
   - 监控冷却状态
   - 管理功率重置
   - 准备下次启动

#### 3.3.2 关键参数

1. 功率参数
   - 最大功率：1kW
   - 初始功率：400W
   - 功率增长率：200W/s

2. 时间参数
   - 冷却时间：5秒
   - 更新周期：与仿真步长一致

### 3.4 烟幕弹

#### 3.4.1 工作原理

烟幕弹通过发射烟幕弹并形成烟幕云来实现多谱段干扰。其基本工作过程如下：

1. 发射阶段
   - 设置发射角度（默认45度）
   - 选择烟幕类型
   - 确定发射数量
   - 执行发射动作

2. 扩散阶段
   - 达到预定高度爆炸
   - 形成初始烟幕云
   - 逐步扩散到预定直径
   - 维持预定浓度

3. 干扰阶段
   - 监控烟幕状态
   - 计算干扰效果
   - 考虑风场影响
   - 更新烟幕参数

4. 衰减阶段
   - 浓度逐渐降低
   - 体积缓慢增大
   - 干扰效果减弱
   - 最终消散

#### 3.4.2 关键参数

1. 发射参数
   - 发射角度：45度（π/4弧度）
   - 烟幕种类：红外/毫米波/多谱段
   - 发射数量：默认1发

2. 性能参数
   - 爆炸高度：10米
   - 烟幕直径：20米
   - 辐射吸收率：0.8
   - 初始浓度：0.5kg/m³

3. 时间参数
   - 扩散时间：3秒
   - 响应时间：1秒
   - 有效时间：60秒
   - 冷却时间：5秒


#### 3.4.3 状态参数

1. 空间参数
   - 烟幕位置：三维坐标
   - 烟幕高度：米
   - 烟幕宽度：米
   - 烟幕厚度：米

2. 物理参数
   - 当前浓度：kg/m³
   - 当前距离：米
   - 持续时间：秒
   - 剩余时间：秒

### 3.5 末敏弹毫米波干扰器

#### 3.5.1 工作原理

末敏弹毫米波干扰器通过毫米波干扰方式来对抗末制导阶段的毫米波制导武器。其基本工作过程如下：

1. 威胁探测
   - 监测毫米波辐射
   - 判断威胁类型
   - 确定目标距离
   - 选择干扰方式

2. 干扰准备
   - 设置干扰参数
   - 调整波长范围
   - 计算角度范围
   - 准备干扰信号

3. 干扰执行
   - 发射干扰信号
   - 调整干扰功率
   - 监控干扰效果
   - 维持干扰输出

#### 3.5.2 干扰方式

1. 欺骗干扰
   - 产生虚假毫米波反射特性

#### 3.5.3 关键参数

1. 波长参数
   - 工作波长：2-4毫米
   - 角度范围：±30度

2. 距离参数
   - 探测距离：2000米
   - 有效距离：1000米
   - 干扰概率：80%
   - 响应时间：0.1秒

3. 功率参数
   - 最大功率：1000W

#### 3.5.4 性能特点

1. 探测能力
   - 远距离探测
   - 快速响应
   - 高精度测距
   - 目标识别

2. 干扰能力
   - 多种干扰方式
   - 高干扰概率
   - 快速功率调整
   - 动态策略选择

3. 生存能力
   - 合理冷却时间
   - 功率动态调整
   - 状态实时监控
   - 自动防护措施

## 4. 验证方法

### 4.1 单元测试

1. 基础功能测试
   - 干扰器初始化测试
   - 状态转换测试
   - 参数设置测试
   - 事件处理测试

2. 功率控制测试
   - 功率增长测试
   - 最大功率限制测试
   - 冷却重置测试
   - 功率计算精度测试

3. 冷却管理测试
   - 冷却时间计算测试
   - 状态转换测试
   - 重启条件测试
   - 异常处理测试

### 4.2 系统测试

1. 集成测试
   - 告警响应测试
   - 事件处理测试
   - 状态同步测试
   - 数据记录测试

2. 性能测试
   - 响应时间测试
   - 资源占用测试
   - 并发处理测试
   - 稳定性测试

### 4.3 验证要点

1. 功能验证
   - 干扰启动可靠性
   - 功率控制准确性
   - 冷却管理有效性
   - 事件处理及时性

2. 性能验证
   - 响应延迟
   - 功率控制精度
   - 状态转换时间
   - 系统稳定性

## 5. 附录

### 5.1 关键参数表

#### 5.1.1 激光干扰器参数

| 参数       | 值    | 单位 | 说明             |
| ---------- | ----- | ---- | ---------------- |
| 最大功率   | 10000 | W    | 最大干扰输出功率 |
| 初始功率   | 4000  | W    | 启动时的功率     |
| 功率增长率 | 2000  | W/s  | 功率增长速度     |
| 冷却时间   | 5     | s    | 停止后的冷却时间 |

#### 5.1.2 红外干扰器参数

| 参数       | 值       | 单位 | 说明             |
| ---------- | -------- | ---- | ---------------- |
| 最大功率   | 配置指定 | W    | 最大干扰输出功率 |
| 初始功率   | 40%      | %    | 最大功率的百分比 |
| 功率增长率 | 配置指定 | W/s  | 功率增长速度     |
| 冷却时间   | 5        | s    | 停止后的冷却时间 |

#### 5.1.3 毫米波干扰器参数

| 参数       | 值   | 单位 | 说明             |
| ---------- | ---- | ---- | ---------------- |
| 最大功率   | 1000 | W    | 最大干扰输出功率 |
| 初始功率   | 400  | W    | 启动时的功率     |
| 功率增长率 | 200  | W/s  | 功率增长速度     |
| 冷却时间   | 5    | s    | 停止后的冷却时间 |

#### 5.1.4 烟幕弹参数

| 参数     | 值  | 单位  | 说明             |
| -------- | --- | ----- | ---------------- |
| 发射角度 | π/4 | rad   | 烟幕弹发射角度   |
| 爆炸高度 | 10  | m     | 烟幕弹爆炸高度   |
| 烟幕直径 | 20  | m     | 烟幕云最大直径   |
| 吸收率   | 0.8 | -     | 电磁波吸收率     |
| 初始浓度 | 0.5 | kg/m³ | 形成时的浓度     |
| 扩散时间 | 3   | s     | 达到预定直径时间 |
| 响应时间 | 1   | s     | 形成有效干扰时间 |
| 有效时间 | 60  | s     | 维持干扰效果时间 |

#### 5.1.5 末敏弹毫米波干扰器参数

| 参数     | 值   | 单位 | 说明             |
| -------- | ---- | ---- | ---------------- |
| 波长范围 | 2-4  | mm   | 干扰波长范围     |
| 角度范围 | ±30  | deg  | 工作角度范围     |
| 响应时间 | 0.1  | s    | 形成干扰所需时间 |
| 有效距离 | 1000 | m    | 有效干扰最大距离 |
| 探测距离 | 2000 | m    | 威胁探测最大距离 |
| 干扰概率 | 0.8  | -    | 有效干扰概率     |
| 最大功率 | 1000 | W    | 最大干扰输出功率 |

### 5.2 标准测试用例

#### 5.2.1 功能测试用例

1. 干扰器启动测试
   ```csharp
   [Test]
   public void TestJammerStart()
   {
       var jammer = new LaserJammer(/*参数*/);
       jammer.StartJamming();
       Assert.IsTrue(jammer.IsJamming);
       Assert.AreEqual(4000, jammer.CurrentJammingPower);
   }
   ```

2. 功率增长测试
   ```csharp
   [Test]
   public void TestPowerIncrease()
   {
       var jammer = new LaserJammer(/*参数*/);
       jammer.StartJamming();
       jammer.Update(1.0); // 更新1秒
       Assert.AreEqual(6000, jammer.CurrentJammingPower);
   }
   ```

3. 冷却管理测试
   ```csharp
   [Test]
   public void TestCooldown()
   {
       var jammer = new LaserJammer(/*参数*/);
       jammer.StartJamming();
       jammer.StopJamming();
       Assert.IsFalse(jammer.IsJamming);
       // 等待冷却
       jammer.Update(5.0);
       jammer.StartJamming();
       Assert.IsTrue(jammer.IsJamming);
   }
   ```

4. 末敏弹毫米波干扰器测试
   ```csharp
   [Test]
   public void TestTerminalJammer()
   {
       var jammer = new TerminalMillimeterWaveJammer(/*参数*/);
       
       // 测试威胁探测
       var evt = new TerminalThreatDetectionEvent 
       { 
           Distance = 1500,
           TargetId = "Tank001" 
       };
       jammer.OnThreatDetected(evt);
       Assert.IsTrue(jammer.IsJamming);
       
       // 测试干扰效果
       jammer.Update(1.0);
       Assert.AreEqual(0.8, jammer.JammingProbability);
       Assert.Less(jammer.CurrentTargetDistance, jammer.DetectionRange);
   }
   ```

### 5.3 数据格式说明

#### 5.3.1 配置数据格式

```json
{
    "jammerId": "string",
    "maxJammingPower": "double",
    "initialJammingPower": "double",
    "powerIncreaseRate": "double",
    "maxCooldownTime": "double"
}
```

#### 5.3.2 事件数据格式

```json
{
    "eventType": "JammingEvent",
    "senderId": "string",
    "timestamp": "long",
    "targetId": "string",
    "jammingPower": "double",
    "status": "string"
}
```