ProtoForge

🔧 设备管理 — 所有仿真设备集中管控

支持按协议筛选、批量启停、快速创建。每台设备显示协议类型、在线状态、测点数量，支持测点读写、链路追踪、编辑配置。

🌐 协议服务 — 28 种从站仿真 + 3 种主站模式

Modbus TCP/RTU、OPC-UA、MQTT、HTTP、GB28181、BACnet、Siemens S7、Mitsubishi MC、Omron FINS、Rockwell AB、OPC-DA、FANUC FOCAS、MTConnect、Mettler-Toledo、PROFINET IO、EtherCAT、IEC 60870-5-104、IEC 61850、CoAP、DDS，全部支持独立配置端口和高级参数。

🔗 主站模式（v1.9.0 新增）— 不只有仿真，还能连真实设备

除了模拟从站，ProtoForge 现在可以主动拨出连接现场真实设备——Modbus Master（TCP/RTU-over-TCP/串口）、S7 Master（DB/M/I/Q 全地址）、IEC 104 Master（总召遥测遥信 + 遥控遥调）。远端数据进入本地点位存储：

• 协议转换免费获得 — SCADA 走 Modbus 采、上位机走 S7 读、调度走 104 遥信，同一个真实设备的数据随取随用
• 测试引擎直接断言 — "读真实从站 → 断言响应值 → 记录报告"自动回归，无需新增任何测试步骤类型
• 工程排障可靠 — 断线指数退避重连、点位质量标记（good/bad）、轮询统计与最后错误可查

另配套报文字段级解析器：粘贴一帧报文 hex，按协议逐字段展开（Wireshark 式），CRC/CS/BCC 自动校验，9 种协议覆盖——联调排障、驱动开发、教学演示一步到位。

🏭 仿真场景 — 组合多设备定义联动规则

创建场景、批量管理设备集合，支持导入导出，快速复现工厂环境。

🎨 场景编排器 — 可视化拖拽设备拓扑

自由拖拽布局设备节点，直观展示设备间关系，支持保存布局、添加设备、一键启停整个场景。

📦 模板市场 — 133 设备模板开箱即用

PLC、传感器、数控机床、IoT 设备、摄像头、楼宇设备、电力保护装置、IED、环境传感器等分类筛选，选择模板一键创建仿真设备。

🧪 仿真测试 — 自动生成测试用例

系统根据当前设备和场景自动生成测试任务，一键验证测点读写、场景启停、规则触发等功能。

📋 测试计划 — 版本化测试用例管理

创建测试计划，定义测试套件和故障场景，一键执行并生成 JUnit XML / JSON / HTML 报告。支持克隆、版本管理、执行历史追踪，CI/CD 集成一行命令搞定。

🛡️ 合规检测 — 协议标准合规性验证

内置 Modbus TCP、S7、OPC-UA、IEC 104、MQTT 五大协议合规检测器，一键检测通信报文是否符合协议标准，生成合规评分和违规详情报告。

🐛 调试日志 — 实时协议报文追踪

WebSocket 零延迟推送，按协议/方向筛选，关键词搜索，支持暂停、导出 JSON，快速定位开发问题。

🔗 联调集成 — EdgeLite 网关无缝对接

对接 EdgeLite 网关，完成设备注册→连接→采集→验证→监控的完整联调链路，5 步可视化流程一目了然。

⚙️ 系统设置 — 可视化配置无需改代码

服务器端口、数据库路径、日志级别、CORS 源、InfluxDB 转发、协议端口等全部可在前端直接修改。

🛡️ 审计日志 — 全操作留痕

用户操作、资源变更全程记录，支持按用户名、操作类型、资源类型筛选审计。

💾 备份恢复 — 一键导出导入全库数据

将设备、场景、模板和审计日志导出为 JSON 备份文件，跨环境迁移、版本控制、灾难恢复轻松搞定。

开机自启动与数据保存（Windows）

protoforge install-service        ← v1.6.0 起 CLI 直接安装（管理员终端）
scripts\install_service.bat       ← 仓库脚本方式

scripts\install_autostart.bat   ← 双击，一键安装开机自启

git clone https://github.com/suoten/ProtoForge.git
cd ProtoForge
python -m venv venv
.\venv\Scripts\activate
pip install -e ".[all]"
cd web && npm install && npm run build && cd ..
protoforge demo
# 浏览器打开 http://localhost:8000，用 admin / admin 登录（demo 模式默认密码，旧数据也会自动同步）
# 可用环境变量 PROTOFORGE_ADMIN_PASSWORD 覆盖；正式模式（protoforge run）密码随机生成，见启动横幅

git clone https://github.com/suoten/ProtoForge.git
cd ProtoForge
python3 -m venv venv
source venv/bin/activate
pip install -e ".[all]"
cd web && npm install && npm run build && cd ..
protoforge demo
# 或后台运行：protoforge demo -d
# 停止后台服务：protoforge stop
# 浏览器打开 http://localhost:8000，用 admin / admin 登录（demo 模式默认密码，旧数据也会自动同步）
# 可用环境变量 PROTOFORGE_ADMIN_PASSWORD 覆盖；正式模式（protoforge run）密码随机生成，见启动横幅

📋 前置条件速查

¹ 没装 Node.js 的话，脚本会自动使用仓库中已构建好的前端文件
² 需要从 GitHub 下载项目代码（可以 git clone，也可以网页下载 ZIP）

各软件下载地址：

📦 可选：安装更多协议

pip install -e . 只安装核心协议（Modbus TCP/RTU、HTTP、GB28181、MC、FINS、AB、OPC-DA、FANUC、MTConnect、Toledo、PROFINET、EtherCAT、IEC 104、IEC 61850、CoAP、DDS、松下 MEWTOCOL 共 17 种，开箱即用）。以下 4 种协议需要额外依赖：

pip install -e ".[all]"        # 安装全部 31 种协议
pip install -e ".[opcua]"     # OPC-UA
pip install -e ".[mqtt]"      # MQTT
pip install -e ".[bacnet]"    # BACnet
pip install -e ".[s7]"        # Siemens S7

🔗 与第三方系统对接

ProtoForge 是什么？—— 一句话搞懂

ProtoForge 是一台「虚拟设备工厂」。它启动标准协议服务端（Modbus TCP Server、OPC-UA Server、S7 Server……），任何能连接这些协议的软件都能直接对接，不需要任何适配层或特殊 SDK。

对接架构图

                    ┌─────────────────────────────────┐
                    │        ProtoForge（仿真端）         │
                    │                                   │
                    │  Modbus TCP Server  ←─ 端口 5020  │
                    │  OPC-UA Server      ←─ 端口 4840  │
                    │  S7 Server          ←─ 端口 102   │
                    │  MQTT Broker        ←─ 端口 1883  │
                    │  HTTP Server        ←─ 端口 8080  │
                    │  GB28181 SIP        ←─ 端口 5060  │
                    │  ...（28 种协议服务端 + 3 主站）      │
                    └──────────┬──────────────────────┘
                               │ 标准 TCP/UDP 协议通信
                               │（和真实设备一模一样）
          ┌──────────┬─────────┼─────────┬──────────┐
          ▼          ▼         ▼         ▼          ▼
     ┌─────────┐ ┌────────┐ ┌───────┐ ┌───────┐ ┌─────────┐
     │ EdgeLite│ │Kepware │ │Node-RED│ │Ignition│ │ 你的程序 │
     │  网关   │ │  网关  │ │       │ │ SCADA │ │(pymodbus│
     │         │ │        │ │       │ │       │ │  等)   │
     └─────────┘ └────────┘ └───────┘ └───────┘ └─────────┘
       自动注册      手动配置    手动配置   手动配置    直接连接

三种对接方式

方式 ①：直接连接（最通用）

ProtoForge 启动协议服务后，任何协议客户端都能直接连接。不需要在 ProtoForge 做任何额外配置。

# Python — 用 pymodbus 连接 ProtoForge 的 Modbus TCP 仿真设备
from pymodbus.client import ModbusTcpClient

client = ModbusTcpClient("127.0.0.1", port=5020)
client.connect()
result = client.read_holding_registers(address=100, count=2, device_id=1)
print(f"温度: {result.registers}")

// Node.js — 用 mqtt 库连接 ProtoForge 的 MQTT 仿真设备
import mqtt from 'mqtt'
const client = mqtt.connect('mqtt://127.0.0.1:1883')
client.on('message', (topic, message) => {
  console.log(`${topic}: ${message.toString()}`)
})
client.subscribe('sensor/temperature')

⚠️ MQTT 连接注意事项

• 角色先分清：ProtoForge 的 MQTT 协议服务是一个仿真 Broker（服务器），不是连接外部服务器的客户端。高级配置里的 host/port 是 ProtoForge 自己监听的地址和端口（host 填 0.0.0.0 监听全部网卡），不是 EMQX 的地址——填了外部服务器 IP 会导致绑定失败、服务起不来。
• 想把设备数据上报到你自己的 EMQX/Mosquitto/阿里云 IoT？ 不需要动协议服务的 host/port——在设备协议配置中填写「自定义 MQTT 服务器」（server_host / server_port，可选认证用户名密码），设备将以 MQTT 客户端身份连接并上报数据。
• 内置 MQTT Broker 仅支持 MQTT 3.1.1 协议，不支持 MQTT 5.0。MQTTX 等客户端连接时，请在连接设置中手动将 Protocol Version 选为 3.1.1（默认 5.0 会连接失败，这是最常踩的坑）。
• 开启认证后客户端必须携带用户名密码；auth_users 支持多账号，格式为 JSON：{"user1":"pass1"}，留空则使用单账号配置。
• 其他协议的角色：Modbus / S7 / OPC-UA / IEC104 等协议中，仿真设备同样是"被访问的服务端"（由你的主站/网关连接设备），不存在"设备外连上报"的语义；若需把这些设备的数据推送到你自己的 HTTP 服务器，请使用平台的数据转发功能。GB28181 仿真设备则会主动向你配置的 SIP 平台注册。

📍 PLC 地址映射 — 精确到每个测点

ProtoForge 的每个测点都绑定了具体的 PLC 协议地址，你的上位机/网关按这个地址去读，和读真实 PLC 一模一样。

各协议地址格式

完整示例：智能水表模板（Modbus TCP）

设备模板中的测点定义：

{
  "name": "total_flow",
  "address": "0",           // ← Modbus 寄存器 40001
  "data_type": "float32",
  "unit": "m³",
  "generator_type": "increment",
  "min_value": 0,
  "max_value": 999999
}

你的采集程序这样读：

from pymodbus.client import ModbusTcpClient

client = ModbusTcpClient("127.0.0.1", port=5020)
client.connect()

# 读 total_flow（address=0 → 寄存器 40001，float32 占 2 个寄存器）
result = client.read_holding_registers(address=0, count=2, slave_id=1)
# 解析 float32
value = struct.unpack('>f', struct.pack('>HH', *result.registers))[0]
print(f"累计流量: {value} m³")

# 读 instant_flow（address=2 → 寄存器 40003）
result = client.read_holding_registers(address=2, count=2, slave_id=1)
# 同样解析 float32

完整示例：西门子 S7-1200 模板

{
  "name": "temperature",
  "address": "DB1.DBD2",     // ← DB块1，双字，偏移2
  "data_type": "real",
  "unit": "°C"
}

用 snap7 读取：

import snap7

client = snap7.client.Client()
client.connect("127.0.0.1", 0, 1)  # rack=0, slot=1

# 读 DB1.DBD2（Real/Float，4字节）
data = client.db_read(1, 2, 4)       # db_number=1, start=2, size=4
temperature = snap7.util.get_real(data, 0)
print(f"温度: {temperature} °C")

完整示例：欧姆龙 FINS 模板

{
  "name": "motor_speed",
  "address": "DM100",       // ← DM区域地址100
  "data_type": "int16"
}

💡 在 Web 界面查看地址：设备管理 → 点击「数据测点」→ 可以看到每个测点的名称、当前值、时间、质量。点击「编辑」设备可以查看和修改每个测点的协议地址、数据类型、生成器参数。

💡 自定义地址：创建设备时可以自由指定每个测点的 PLC 地址，完全匹配你真实设备的地址表。

Modbus 寄存器类型与功能码映射

ProtoForge 支持完整的 Modbus 四种寄存器区域，通过地址格式自动识别：

💡 纯数字地址的自动判断规则：bool 类型 → 线圈 (Coil)；其他类型 → 保持寄存器 (Holding Register)。如果你想使用输入寄存器或离散输入，请使用 30001、10001 等 5 位 PLC 地址格式，或 IR0、DI0 等前缀格式。

数据类型与寄存器占用

不同数据类型占用的寄存器数量和字节序：

⚠️ 字节序说明：ProtoForge 所有协议统一使用大端序 (Big-Endian)，这是工业设备最常用的字节序。如果你的上位机使用小端序，需要在采集端做字节翻转。

例如：float32 值 1.0 在 ProtoForge 中存储为 0x3F800000，拆分为两个寄存器 → HR[n]=0x3F80, HR[n+1]=0x0000。用 pymodbus 读取后：struct.unpack('>f', struct.pack('>HH', 0x3F80, 0x0000)) → 1.0。

📋 从真实地址表创建设备教程

假设你有一份设备说明书上的 Modbus 地址表：

第 1 步：转换为 ProtoForge 地址格式

💡 5 位 PLC 地址自动转换：你也可以直接填 40001、30001、10001、00001，ProtoForge 会自动减去基地址（40001→偏移 0，30001→偏移 0）。

第 2 步：在 Web 界面创建设备

1. 进入「设备管理」→ 点击「创建设备」
2. 选择协议 modbus_tcp，填写设备名称
3. 在测点配置中，逐条添加上表中的参数
4. 设置 slave_id（如 1）
5. 保存并启动设备

第 3 步：用你的采集程序验证

from pymodbus.client import ModbusTcpClient
import struct

client = ModbusTcpClient("127.0.0.1", port=5020)
client.connect()

# 读 A相电压 (address=0, float32, 占2个寄存器)
result = client.read_holding_registers(address=0, count=2, slave_id=1)
voltage_a = struct.unpack('>f', struct.pack('>HH', *result.registers))[0]

# 读 B相电压 (address=2)
result = client.read_holding_registers(address=2, count=2, slave_id=1)
voltage_b = struct.unpack('>f', struct.pack('>HH', *result.registers))[0]

# 读开关状态 (address=00001 → coil 0)
result = client.read_coils(address=0, count=1, slave_id=1)
switch_status = result.bits[0]

print(f"A相电压: {voltage_a}V, B相电压: {voltage_b}V, 开关: {'ON' if switch_status else 'OFF'}")

就是这么简单——ProtoForge 的地址和真实设备完全一致，你的采集代码不需要改一行。

Modbus RTU 串口配置

Modbus RTU 模板支持完整的串口参数配置：

{
  "protocol": "modbus_rtu",
  "protocol_config": {
    "slave_id": 2,
    "serial_port": "COM3",
    "baudrate": 9600,
    "databits": 8,
    "parity": "even",
    "stopbits": 1
  }
}

💡 无串口硬件也能用：ProtoForge 的 Modbus RTU 模式在没有物理串口时也可以启动（使用虚拟串口或 TCP-over-RTU 桥接）。在 Linux 上可以用 socat 创建虚拟串口：socat -d -d PTY,raw,echo=0 PTY,raw,echo=0。

多设备共存仿真

ProtoForge 支持在同一协议端口下同时仿真多台设备，就像一条 RS-485 总线上挂多个从站：

Modbus 多 Slave 共存：

设备A: slave_id=1, 协议=modbus_tcp, 端口=5020
设备B: slave_id=2, 协议=modbus_tcp, 端口=5020  ← 同端口不同 slave_id
设备C: slave_id=3, 协议=modbus_tcp, 端口=5020

采集程序通过 slave_id 区分不同设备：

# 读设备A的数据
result = client.read_holding_registers(address=0, count=2, slave_id=1)
# 读设备B的数据
result = client.read_holding_registers(address=0, count=2, slave_id=2)

💡 每个 Modbus 设备在创建时可以指定不同的 slave_id，它们共享同一协议端口但拥有独立的数据空间。

S7/OPC-UA/MQTT 等协议多设备：每种协议都支持在同端口下创建多台虚拟设备，通过设备名/节点空间区分。

写入行为说明

当你的采集程序向 ProtoForge 写入数据时，行为与真实 PLC 完全一致：

⚠️ 写入与生成器的关系：如果测点配置了 generator_type（如 random、sine），生成器会在每次更新周期覆盖写入的值。要保留写入值，请将 generator_type 设为 fixed。

数据更新频率与生成器

每个测点可以配置数据生成器来模拟真实设备的变化行为：

{
  "name": "temperature",
  "address": "0",
  "data_type": "float32",
  "generator_type": "sine",
  "min_value": 20.0,
  "max_value": 80.0,
  "period": 60,
  "update_frequency": 1.0
}

💡 update_frequency 决定了数据多久变化一次。设为 0.5 表示每 0.5 秒更新一次（2Hz），设为 5 表示每 5 秒更新一次。这与真实设备的采样周期类似。

方式 ②：EdgeLite 自动注册（便捷）

如果你用 EdgeLite 做网关，ProtoForge 可以自动把设备配置推送过去，免去手动在 EdgeLite 中添加设备的步骤。详见下方 EdgeLite 网关对接 章节。

方式 ③：标准网关手动配置（Kepware / Node-RED / Ignition 等）

以 Kepware 为例：

1. ProtoForge 中启动 Modbus TCP 协议服务（默认端口 5020）
2. ProtoForge 中创建一台 Modbus 设备（记住 slave_id 和测点地址）
3. Kepware 中新建一个 Modbus TCP 驱动，IP 填 ProtoForge 所在机器 IP，端口填 5020
4. Kepware 中新建设备，slave_id 与 ProtoForge 中一致
5. Kepware 中添加点位，地址与 ProtoForge 中一致

就是这么简单——ProtoForge 对你的网关来说，和一台真实 PLC 没有任何区别。

💡 核心理解：ProtoForge 不是网关，不采集数据，不转发数据。它是「被采集的对象」——一台虚拟设备。你的网关/SCADA/采集程序去连它，就像连真实设备一样。

🔗 EdgeLite 网关对接

ProtoForge 支持将模拟设备自动注册到 EdgeLite 物联网网关，和 GB28181 填「上级SIP服务器地址」一样的体验：

GB28181：设备 protocol_config 填 sip_server_addr → 自动注册到国标平台
EdgeLite：设备 protocol_config 填 edgelite_url → 自动注册到 EdgeLite 网关

使用方式：创建设备时，在协议配置中填写 EdgeLite 网关地址即可：

不填就不推送，不影响 ProtoForge 正常使用。详见 INTEGRATION.md。

🔌 EdgeLite 联合一键部署（推荐）

不想手动配置两套系统？ProtoForge 提供 docker-compose.joint.yml，一条命令同时启动 ProtoForge + EdgeLite + MQTT + InfluxDB，开箱即用联调。

第 1 步：准备配置文件

# 复制环境变量模板
cp .env.joint.example .env.joint

# 用编辑器打开 .env.joint，把所有 change_me_* 改成你自己的密码
# 重点修改这几项：
#   PROTOFORGE_ADMIN_PASSWORD=你的强密码
#   PROTOFORGE_JWT_SECRET=至少32位随机字符串
#   EDGELITE_ADMIN_PASSWORD=你的强密码
#   SECRET_KEY=至少32位随机字符串

💡 JWT 密钥可以用这个命令生成：python -c "import secrets; print(secrets.token_urlsafe(32))"

第 2 步：一键启动

docker compose -f docker-compose.joint.yml --env-file .env.joint up -d

等待 30 秒让所有服务就绪，然后：

• ProtoForge 界面：http://localhost:8000 （用 .env.joint 里的 PROTOFORGE_ADMIN_PASSWORD 登录）
• EdgeLite 界面：http://localhost:8081 （用 .env.joint 里的 EDGELITE_ADMIN_PASSWORD 登录）

第 3 步：验证联调

1. 打开 ProtoForge（http://localhost:8000），创建一台 Modbus 设备，在协议配置中填写：

   edgelite_url: http://edgelite:8100
   edgelite_username: admin
   edgelite_password: （你在 .env.joint 里设的 EDGELITE_ADMIN_PASSWORD）
   

2. 启动设备的 Modbus 协议，ProtoForge 会自动把设备推送到 EdgeLite
3. 打开 EdgeLite（http://localhost:8081），在设备列表中能看到刚推送的设备，数据实时采集

🔍 也可以调用 ProtoForge 的 API 一键验证全链路：

curl -X POST http://localhost:8000/api/v1/edgelite/verify-pipeline \
  -H "Authorization: Bearer <你的token>" \
  -H "Content-Type: application/json" \
  -d '{"device_id": "你的设备ID", "auto_fix": true}'

返回 {"ok": true} 说明认证→注册→连接→采集四步全通。

📋 端口映射表

联合部署后，以下端口被占用（如需修改请在 .env.joint 中调整）：

🛠 故障排查 FAQ

Q: 启动报错 / 连不上协议端口，先做什么？ A: 先跑自检命令 protoforge doctor（或 python -m protoforge doctor）——它会逐项检查端口占用、特权端口、依赖完整性、数据目录可写、容器网络拓扑，并给出修复建议。报 issue 时附上 protoforge doctor --json 的输出能大幅加快定位。

Q: 启动时报端口占用？ A: 检查本机是否已有其他服务占用上述端口。Windows 用 netstat -ano | findstr :8000，Linux 用 lsof -i:8000。可在 .env.joint 中修改端口映射。

Q: EdgeLite 设备列表里看不到推送的设备？ A: ① 确认设备协议配置里的 edgelite_url 填的是 http://edgelite:8100（容器内网名），不是 localhost；② 在 ProtoForge 调用 verify-pipeline API 看具体哪一步失败；③ 查看 EdgeLite 日志 docker compose -f docker-compose.joint.yml logs edgelite。

Q: 联调 API 返回 401？ A: EdgeLite 密码不匹配。确认设备配置里的 edgelite_password 与 .env.joint 中的 EDGELITE_ADMIN_PASSWORD 一致。首次登录 EdgeLite 可能要求改密码，改完后同步更新 ProtoForge 设备配置。

Q: 停止联合部署？ A: docker compose -f docker-compose.joint.yml down（加 -v 会同时删除数据卷，谨慎使用）。

⚙️ 配置说明

所有配置项均可在 .env 文件中修改，也可登录后台在「系统设置」页面直接修改。

# .env 文件示例
PROTOFORGE_HOST=0.0.0.0          # Web 服务监听地址
PROTOFORGE_PORT=8000             # Web 服务端口
PROTOFORGE_DB_PATH=data/protoforge.db  # 数据库路径（SQLite 或 PostgreSQL）
PROTOFORGE_JWT_SECRET=           # JWT 密钥（留空自动生成，生产环境建议设置）
PROTOFORGE_ADMIN_PASSWORD=admin  # 管理员密码（不设置则自动生成随机密码，生产环境务必设置强密码！）
PROTOFORGE_DEMO_MODE=false       # 演示模式
PROTOFORGE_LOG_LEVEL=info        # 日志级别
PROTOFORGE_GRPC_PORT=0           # gRPC 端口（0=禁用，设为 50051 启用）

# 协议端口（修改后需重启对应协议生效）
PROTOFORGE_MODBUS_TCP_PORT=5020
PROTOFORGE_OPCUA_PORT=4840
PROTOFORGE_MQTT_PORT=1883
PROTOFORGE_HTTP_PORT=8080
PROTOFORGE_GB28181_PORT=5060

端口说明

数据库配置

SQLite（默认，适合开发和单机部署）：

PROTOFORGE_DB_PATH=data/protoforge.db

PostgreSQL（生产环境推荐）：

# 安装 PostgreSQL 支持
pip install -e ".[postgres]"

# 配置连接字符串
PROTOFORGE_DB_PATH=postgresql://user:password@localhost:5432/protoforge

🔔 Webhook 通知和告警规则

ProtoForge 内置 Webhook 通知和告警反应规则系统，支持事件驱动的自动化。

Webhook 通知系统：

# 创建 Webhook
POST /api/v1/webhooks
{
  "name": "告警通知",
  "url": "https://your-server.com/webhook",
  "events": ["rule_triggered", "device_error"],
  "secret": "your-hmac-secret"   # 可选，启用 HMAC-SHA256 签名
}

# 验证签名（接收端）
# 请求头 X-ProtoForge-Signature = HMAC-SHA256(secret, body)

告警反应规则：

# 创建告警规则
POST /api/v1/integration/alarm-rules
{
  "source_device_id": "device-001",
  "severity": "critical",
  "action": "stop_device"       # stop_device / inject_fault / adjust_generator
}

🧪 仿真测试框架

ProtoForge 内置完整的仿真测试框架，支持 14 种断言类型和 HTML 报告。

断言类型：

变量提取和钩子：

{
  "steps": [
    {
      "name": "创建设备",
      "action": "create_device",
      "extract": {"device_id": "$.id"},
      "post_hook": "log('设备创建成功')"
    },
    {
      "name": "读取测点",
      "action": "read_points",
      "params": {"device_id": "${device_id}"}
    }
  ]
}

测试报告：

• GET /tests/reports/{id}/html — 完整 HTML 报告（含步骤详情、断言结果、耗时统计）
• GET /tests/reports/trend — 历史测试趋势数据
• POST /tests/quick-test — 一键自动生成并运行测试
• GET /tests/suggestions — 根据当前状态推荐测试

🎬 场景规则引擎

5 种规则类型 × 5 种动作，支持冷却机制、多设备协同链式联动和时间序列回放。

规则类型：

规则动作：

协同联动示例（温度超 80°C → 启动风扇 → 注入传感器噪声）：

{
  "rule_type": "collaboration",
  "source_device_id": "temp-sensor",
  "source_point": "temperature",
  "condition": {"operator": ">", "value": 80},
  "actions": [
    {"target_device_id": "fan", "target_point": "speed", "action_type": "set", "value": 100},
    {"target_device_id": "temp-sensor", "target_point": "temperature", "action_type": "inject_fault", "value": {"fault_type": "sensor_noise", "parameters": {"noise_std": 2.0, "duration": 60}}}
  ],
  "cooldown": 5.0
}

时间序列回放：场景支持 replay_config，从历史数据（内联 JSON / CSV 文件）驱动仿真，支持加速回放（speed）和循环（loop）：

{
  "replay_config": {
    "source": [{"ts": 0, "d</details></http:></https:>

> README 内容过长，已截取前 64 KB。完整内容请前往 GitHub 仓库查看。