Manus系统兼容性日志是首次启动或环境变更后生成的诊断快照，记录工具链、内核模块等匹配状态；必须先完成初始化配置才能生成，路径为~/.manus/logs/compatibility/（Linux/macOS）或%APPDATA%\Manus\logs\compatibility\（Windows），可通过jq命令或/compat指令实时查看兼容性状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Manus系统兼容性日志不是常规运行日志，而是首次启动或环境变更后自动生成的诊断快照，专门记录工具链、内核模块、第三方服务授权等关键组件的匹配状态——不看这份日志，后续任务可能在DAG执行中途突然中断，且错误提示模糊难定位。
确认日志是否存在并定位路径
打开Manus控制台后，【必须先完成初始化配置】：点击右上角头像→「初始化配置」→勾选全部默认项→点击「提交」。若跳过此步，日志文件根本不会生成。
初始化完成后，日志自动写入本地目录：~/.manus/logs/compatibility/（Linux/macOS）或 %APPDATA%\Manus\logs\compatibility\（Windows）。
该目录下会生成以时间戳命名的JSON文件，如compat-20260806-152341.json，最新文件即为当前环境兼容性报告。
用命令行快速解析核心结论
进入日志所在目录，执行以下命令直接提取关键状态：
jq -r '.summary | select(.status == "FAILED") | .reason' compat-*.json 2>/dev/null || echo "全部通过"
这条命令只输出失败项的具体原因；若无输出，则说明基础兼容性达标。注意：jq工具需提前安装（macOS用brew install jq，Ubuntu用sudo apt install jq，Windows可用choco install jq）。
若看到类似"Missing required kernel module: mcp_bridge"，说明MCP协议桥接驱动未加载，需手动执行sudo modprobe mcp_bridge并检查dmesg | grep mcp是否有version magic报错。
在Manus界面内实时查看动态兼容性状态
方法一：聊天窗口输入指令
在右侧聊天输入框中，直接输入/compat并回车。Manus会立即调用本地诊断模块，返回结构化结果，包含三类状态：
✅ 已就绪（绿色）：如「Docker CLI v24.5.0 → 兼容」、「Python 3.11.9 → 兼容」；
⚠️ 待验证（黄色）：如「GitHub API Token → 已授权但未测试连通性」；
这款全能AI助手融合了深度推理、多模态对话与图像生成等前沿技术，全面赋能职场、学习与生活。它支持多模态搜索，精准响应各类信息需求；内置AI文档助手，快速提炼要点并生成思维导图；更有智能创作功能，一键生成报告与文案。强大的AI能力助你高效处理复杂任务，让工作与生活更轻松便捷。
❌ 不可用（红色）：如「NVIDIA GPU Driver → 版本470.182.03不支持CUDA 12.4」。
方法二：悬停工具栏图标
将鼠标移至右侧悬浮工具栏中的齿轮图标→出现「执行环境偏好」弹窗→点击右上角「兼容性详情」按钮。此处显示的不是静态快照，而是实时探测结果，比如当USB设备插入时，会动态刷新「USB Serial Bridge → 已识别，固件版本v2.1.7」。
【注意】此面板中所有标红条目均代表当前任务流无法调用对应工具，必须修复后才能启用相关DAG节点。
交叉验证驱动级兼容性（Linux/macOS专用）
第一步：提取Manus依赖的内核模块名
运行：grep -o 'module:[^[:space:]]*' ~/.manus/logs/compatibility/compat-*.json | cut -d: -f2 | sort -u
第二步：对每个模块执行双重校验
① 检查是否已加载：lsmod | awk '{print $1}' | grep -E '^(mcp_bridge|usbserial|hid_manus)$'
② 验证模块与当前内核精确匹配：modinfo $(modprobe -n -v mcp_bridge 2>/dev/null | awk '{print $NF}') 2>/dev/null | grep -E '^(vermagic|depends)'
若vermagic字段中的内核版本（如6.8.0-15-generic）与uname -r输出不完全一致，模块将被内核拒绝加载——此时必须重新编译模块或降级内核，不能仅靠重启解决。
第三步：确认硬件绑定无冲突
运行：lspci -k -s $(lspci | grep -i manus | head -1 | awk '{print $1}')，观察Kernel driver in use行是否指向manus_core；若显示vfio-pci或pci-stub，说明设备被虚拟机或安全模块独占，需修改/etc/default/grub中GRUB_CMDLINE_LINUX参数移除iommu=on或调整vfio绑定顺序。
