Feat/yaml dsl

.github/workflows/target-emulator-ci.yml

@@ -0,0 +1,58 @@
+name: Target Emulator CI
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+  schedule:
+    - cron: "0 2 * * *"
+  workflow_dispatch:
+
+jobs:
+  mock-regression:
+    name: Mock Regression (Python 3.11)
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install minimal dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install pyyaml
+
+      - name: Run target emulator regressions
+        run: |
+          python scripts/target_emulator_regression.py
+          python scripts/target_emulator_fault_regression.py
+
+  nightly-virtual-serial:
+    name: Nightly Virtual Serial (Windows)
+    runs-on: windows-latest
+    if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -r requirements.txt
+
+      - name: Run nightly virtual-serial regression
+        shell: powershell
+        env:
+          TARGET_HOST_PORT: ${{ vars.TARGET_HOST_PORT }}
+          TARGET_DEVICE_PORT: ${{ vars.TARGET_DEVICE_PORT }}
+        run: |
+          .\scripts\nightly_virtual_serial_regression.ps1

.github/workflows/yaml-dsl-regression.yml

@@ -0,0 +1,93 @@
+name: YAML DSL Regression
+
+on:
+  pull_request:
+  push:
+    branches: ["main"]
+  schedule:
+    - cron: "20 2 * * *"
+    - cron: "40 3 * * 0"
+  workflow_dispatch:
+    inputs:
+      tier:
+        description: "Regression tier to run"
+        required: true
+        default: "full"
+        type: choice
+        options:
+          - fast
+          - full
+          - soak
+
+jobs:
+  pr-fast:
+    name: PR Fast Set
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request' || github.event_name == 'push' || (github.event_name == 'workflow_dispatch' && github.event.inputs.tier == 'fast')
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -r requirements.txt
+
+      - name: Run fast regression set
+        run: |
+          python scripts/v01_dsl_regression.py
+          python scripts/target_emulator_regression.py
+          python scripts/protocol_package_test_suite.py
+          python scripts/yaml_dsl_capability_suite.py
+          python scripts/yaml_dsl_combo_regression.py
+          python scripts/yaml_dsl_fault_injection_regression.py
+
+  nightly-full:
+    name: Nightly Full Set
+    runs-on: ubuntu-latest
+    if: (github.event_name == 'schedule' && github.event.schedule == '20 2 * * *') || (github.event_name == 'workflow_dispatch' && github.event.inputs.tier == 'full')
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -r requirements.txt
+
+      - name: Run full runtime regression
+        run: |
+          python scripts/runtime_regression_suite.py
+
+  weekly-soak:
+    name: Weekly Soak Set
+    runs-on: ubuntu-latest
+    if: (github.event_name == 'schedule' && github.event.schedule == '40 3 * * 0') || (github.event_name == 'workflow_dispatch' && github.event.inputs.tier == 'soak')
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -r requirements.txt
+
+      - name: Run soak + baseline
+        run: |
+          python scripts/yaml_dsl_stability_regression.py --iterations 80 --mem-delta-kb-max 12288
+          python scripts/yaml_dsl_performance_baseline.py --basic-iters 30 --retry-iters 20

.gitignore

@@ -10,8 +10,12 @@ Thumbs.db
 /.vscode/
 /.idea/
 /logs/
+/runs/
+/tmp/
+/docs/target-emulator-baseline/
 /web-ui/node_modules/
 /web-ui/dist/
 build/
 dist/
 ProtoFlow.spec
+AGENTS.md

.gitmessage-bilingual.txt

@@ -0,0 +1,22 @@
+# Conventional Commit Subject
+# format: type(scope): summary
+
+[中文]
+- 变更内容：
+  - <请填写本次核心改动>
+- 影响范围：
+  - <请填写受影响模块/页面>
+- 兼容性/行为变化：
+  - <请填写是否有行为变化>
+- 依赖/环境：
+  - <请填写依赖、配置或环境要求>
+
+[English]
+- Changes:
+  - <Describe core changes>
+- Impact:
+  - <Describe affected modules/pages>
+- Compatibility / Behavior Changes:
+  - <Describe behavior changes>
+- Dependencies / Environment:
+  - <Describe dependency/config/env requirements>

.where-agent-progress.md

@@ -0,0 +1,26 @@
+# Plan: YAML-DSL + 通讯包全量测试计划（全面覆盖）
+- [x] 阶段 0：建立测试覆盖矩阵（DSL 功能点 × 协议包 × 场景类型 × 通过准则）
+- [x] 阶段 0：统一测试目录与命名规范（cases/scenarios/reports）
+- [x] 阶段 0：定义统一结果模型（PASS/FAIL、错误码、重试命中、耗时、日志链接）
+- [x] 阶段 1：DSL 基础能力用例（session/send/expect/sleep/capture/assert）全覆盖
+- [x] 阶段 1：DSL 控制流用例（if/loop/retry/on_fail/switch_session）全覆盖
+- [x] 阶段 1：DSL 数据能力用例（parse json|kv|csv/path/measure/assert_range）全覆盖
+- [x] 阶段 1：DSL 安全能力用例（exec/file allowlist、拒绝路径、越权拦截）全覆盖
+- [x] 阶段 1：DSL 产物能力用例（raw_log/summary_json/report_csv）全覆盖
+- [x] 阶段 2：协议包 API 合规测试框架（send/recv/rpc 统一契约、入参校验、错误语义）
+- [x] 阶段 2：AT 包测试（正常/ERROR/超时/多行回显/capture 兼容）
+- [x] 阶段 2：SCPI 包测试（query/write/错误帧/csv 解析/超时）
+- [x] 阶段 2：YMODEM 包测试（握手/分包/重传/EOT/失败中断）
+- [x] 阶段 2：XMODEM 包测试（握手/块序/重传/结束）
+- [x] 阶段 2：Modbus RTU 包测试（读写寄存器、异常码、CRC 错误）
+- [x] 阶段 2：Modbus ASCII 包测试（LRC、帧边界、异常码）
+- [x] 阶段 2：Modbus TCP 包测试（MBAP、并发请求、异常码）
+- [x] 阶段 2：协议 vectors.yaml 全量回归（每包正常+异常+边界）
+- [x] 阶段 3：靶机故障注入矩阵（超时/抖动/分片/丢包/断连/乱序）与 DSL 联动验证
+- [x] 阶段 3：多场景组合测试（升级 + 参数写入 + 版本校验 + 报告导出）
+- [x] 阶段 3：长稳测试（循环运行、资源泄漏、错误恢复、重复执行一致性）
+- [x] 阶段 3：性能基线（平均耗时、P95、重试成本、日志吞吐）
+- [x] 阶段 4：一键总入口（full regression suite）整合 DSL + 协议包 + 靶机测试
+- [x] 阶段 4：CI 分层执行（PR 快速集、Nightly 全量集、周全稳集）
+- [x] 阶段 4：发布门禁（全量通过率 100%、关键路径零回归、基线报告归档）
+- [x] 阶段 4：测试文档冻结（测试矩阵、故障注入指南、排障手册、已知限制）

app/main_web.py

@@ -11,13 +11,15 @@
 import time
 from pathlib import Path
 from typing import Optional
+import yaml
 
 try:
     from PySide6.QtWidgets import QApplication
 except ImportError:  # pragma: no cover
     from PyQt6.QtWidgets import QApplication  # type: ignore
 
 from infra.comm.communication_manager import CommunicationManager
+from infra.comm.proxy_forward_manager import ProxyForwardManager
 from infra.common.event_bus import EventBus
 from app.packet_engine import PacketAnalysisEngine
 from app.plugin_manager import PluginManager
@@ -162,6 +164,35 @@ def _select_webengine_flags() -> Optional[str]:
     return "--disable-features=DirectComposition"
 
 
+def _parse_bool(value: object, default: bool = False) -> bool:
+    if isinstance(value, bool):
+        return value
+    if value is None:
+        return default
+    text = str(value).strip().lower()
+    if text in {"1", "true", "yes", "on"}:
+        return True
+    if text in {"0", "false", "no", "off"}:
+        return False
+    return default
+
+
+def _proxy_monitor_enabled() -> bool:
+    env = os.environ.get("PROTOFLOW_ENABLE_PROXY_MONITOR")
+    if env is not None:
+        return _parse_bool(env, default=False)
+    cfg_path = Path.cwd() / "config" / "app.yaml"
+    if cfg_path.exists():
+        try:
+            raw = yaml.safe_load(cfg_path.read_text(encoding="utf-8")) or {}
+            app_cfg = raw.get("app", {}) if isinstance(raw, dict) else {}
+            if isinstance(app_cfg, dict) and "proxy_monitor_enabled" in app_cfg:
+                return _parse_bool(app_cfg.get("proxy_monitor_enabled"), default=False)
+        except Exception:
+            pass
+    return False
+
+
 def main() -> None:
     _ensure_repo_cwd()
     _setup_run_logging()
@@ -170,13 +201,36 @@ def main() -> None:
         os.environ.setdefault("QTWEBENGINE_CHROMIUM_FLAGS", flags)
     bus = EventBus()
     comm = CommunicationManager(bus)
+    proxy_enabled = _proxy_monitor_enabled()
+    proxy_manager = ProxyForwardManager(bus) if proxy_enabled else None
+    logging.getLogger("main_web").info("Proxy monitor enabled: %s", proxy_enabled)
     protocol = ProtocolLoader(bus)
     packet_engine = PacketAnalysisEngine(bus)
     plugins = PluginManager(bus, protocol=protocol)
     plugins.load_all()
 
     app = QApplication.instance() or QApplication(sys.argv)
-    window = WebWindow(bus=bus, comm=comm)
+    _shutdown_done = {"value": False}
+
+    def _shutdown_proxy() -> None:
+        if _shutdown_done["value"]:
+            return
+        _shutdown_done["value"] = True
+        if proxy_manager is None:
+            return
+        try:
+            proxy_manager.stop_all()
+        except Exception:
+            logging.getLogger("main_web").exception("Failed to stop proxy sessions on shutdown")
+
+    app.aboutToQuit.connect(_shutdown_proxy)
+    atexit.register(_shutdown_proxy)
+    window = WebWindow(
+        bus=bus,
+        comm=comm,
+        proxy_manager=proxy_manager,
+        proxy_monitor_enabled=proxy_enabled,
+    )
     window.show()
     print("ProtoFlow Web UI started")
     app.exec()