docs: sync architecture with industrial+ security features

这个提交包含在:
2026-01-21 14:50:43 +08:00
父节点 b69c47975a
当前提交 7477acbdfa
+2 -2
查看文件
@@ -44,14 +44,14 @@ graph TD
1. **字段存在度**:校验 `input_mapping` 中的字段是否在 `WaterSoundData` 中。 1. **字段存在度**:校验 `input_mapping` 中的字段是否在 `WaterSoundData` 中。
2. **数据类型**:校验输入输出是否匹配(NDArray vs Float 等)。 2. **数据类型**:校验输入输出是否匹配(NDArray vs Float 等)。
3. **空间一致性**:校验数组维度是否满足算法数学要求。 3. **空间一致性**:校验数组维度是否满足算法数学要求。
4. **路径完整性**:校验动态库 (`.so`) 或脚本 (`.m`) 路径是否存在。 4. **完整性(路径+哈希)**:校验动态库 (`.so`) 或脚本 (`.m`) 路径是否存在,并可选启用 SHA256 完整性校验(`src/integrity.py`)。
5. **跨环境兼容性**:结合 `env_detect` 判断当前机器是否具备执行该类型算法的能力。 5. **跨环境兼容性**:结合 `env_detect` 判断当前机器是否具备执行该类型算法的能力。
### C. 全协议桥接层 (src/bridges.py) ### C. 全协议桥接层 (src/bridges.py)
| 桥接器 | 实现机制 | 优势 | | 桥接器 | 实现机制 | 优势 |
| :--- | :--- | :--- | | :--- | :--- | :--- |
| **PythonBridge** | 动态 `importlib` 加载 | 原生性能,易于调试 | | **PythonBridge** | 动态 `importlib` 加载 | 原生性能,易于调试 |
| **CppBridge** | `ctypes` 指针深度透传 | 计算密集型算子首选,零拷贝 | | **CppBridge** | `ctypes` 指针深度透传 / 可选子进程隔离(`src/cpp_isolated_runner.py`) | 计算密集型算子首选,零拷贝;隔离模式可避免段错误拖垮主进程 |
| **MatlabBridge** | 三级降级 (Engine/Oct2py/CLI) | 跨平台及离线环境的最大兼容 | | **MatlabBridge** | 三级降级 (Engine/Oct2py/CLI) | 跨平台及离线环境的最大兼容 |
### D. 数据模型层 (src/models.py) ### D. 数据模型层 (src/models.py)