feat: phase 5 industrial grade hardening (ABI safety, security whitelisting, V2 metadata)

src/env_detect.py

@@ -84,3 +84,41 @@ def get_available_algo_types() -> List[str]:
         types.append("cpp")
     
     return types
+
+
+def get_actionable_suggestions() -> List[Dict[str, str]]:
+    """针对故障环境提供具体的修复指令建议"""
+    env = collect_env_info()
+    suggestions = []
+    
+    # MATLAB/Octave 建议
+    if not (env["matlab"]["engine_available"] or env["matlab"]["oct2py_available"] or env["matlab"]["octave_cli"]):
+        suggestions.append({
+            "target": "MATLAB/Octave",
+            "reason": "未检测到 MATLAB 引擎或 Octave 环境",
+            "fix": "建议安装 Octave: `sudo apt install octave` 或安装相关 Python 库: `pip install oct2py`"
+        })
+    elif not env["matlab"]["engine_available"] and env["matlab"]["octave_cli"]:
+        suggestions.append({
+            "target": "MATLAB Engine",
+            "reason": "当前使用 Octave 降级执行，性能可能受限",
+            "fix": "若需原生性能，请安装 MATLAB 并运行 `cd \"$(matlabroot)/extern/engines/python\" && python setup.py install`"
+        })
+
+    # C++ 建议
+    if not env["cpp"]["any_available"]:
+        suggestions.append({
+            "target": "C++ Compiler",
+            "reason": "未检测到 gcc/g++/clang 等编译器",
+            "fix": "建议安装基础构建工具: `sudo apt install build-essential`"
+        })
+
+    # 核心库建议
+    if not env["scipy_available"]:
+        suggestions.append({
+            "target": "SciPy",
+            "reason": "缺少 scipy 库，影响 MATLAB 兜底执行",
+            "fix": "运行 `pip install scipy`"
+        })
+
+    return suggestions