acoustic_algo_scheduler/docs/walkthrough_final.md

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) 验证方式

运行测试：

python tests/test_core.py

启动界面：

streamlit run main.py