# Walkthrough - v3.5（最终交付）

本版本将平台推进为“可演示/可落地”的全协议集成与调度工具：支持 Python/C++/MATLAB(含降级) 三语言算法编排执行，具备五维校验、环境自检、海试一键巡检与异常中心排障闭环。

## 1) 设计与交互
- 深海风 UI：深蓝侧边栏、现代排版、卡片化布局（`main.py`）
- 可视化流水线：调度页提供“运行流水线预览”（`main.py`）
- 语言标识：Python/C++/MATLAB 徽标在算法库与流水线中可视化区分（`main.py`）

## 2) 多协议桥接
- Python：动态加载并执行（`src/algo_loader.py`、`src/bridges.py`）
- C++：`.so/.dll` 动态库加载 + `ctypes` 调用；可选 `isolate=true` 子进程隔离（`src/bridges.py`、`src/cpp_isolated_runner.py`、示例 `src/sample_algos_cpp/`）
- MATLAB/Octave：Engine → oct2py → CLI+matfile 三级降级（`src/bridges.py`、示例 `src/sample_algos_matlab/`）
- WebBridge：HTTP/HTTPS 远程服务桥接（`src/bridges.py`、`src/security.py`、`src/resource_slots.py`）

## 3) 工业级自检与五维校验
- 环境自检：区分 C++ 运行时能力与编译能力，并检测 MATLAB/Octave 能力（`src/env_detect.py`）
- 五维校验：字段/类型/维度/完整性/环境兼容（`src/validator.py`、调度前拦截 `src/scheduler.py`）
- 插件加固：动态 Python 模块与跨语言插件可启用 `src/data` 白名单 + SHA256 校验（`src/integrity.py`、`src/algo_loader.py`、`src/bridges.py`）

## 4) 海试专属与异常中心
- 海试一键巡检：内置链路 + CSV 报告导出（`main.py`）
- 异常中心：校验问题卡片、执行日志、环境快照、排障 JSON 包导出（`main.py`）

## 5) 验证方式
运行测试：
```bash
python tests/test_core.py
```

启动界面：
```bash
streamlit run main.py
```