必须选择manus 4.9或5.0版本，二者底层架构、工具链和调度策略完全不同，混用会导致任务中断、沙箱崩溃或规划器失效；需通过version命令、插件结构、tool-list输出、项目提交哈希及配置文件字段等多维度精准识别并锁定对应版本。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在Manus 4.9小版本和5.0大版本之间做明确选择，而不是模糊观望——因为两者底层架构、工具链兼容性、上下文调度策略完全不同，混用会导致任务中断、沙箱崩溃或规划器静默失效。
先确认你当前的部署形态
打开终端，执行：manus --version。如果返回结果含 【v4.9.x】（如 v4.9.7），说明你正在运行小版本线；若显示 【v5.0.0】 或更高（如 v5.0.2），则已升级至大版本。
注意：v4.9.x 与 v5.0.0 不共用 ~/.manus/cache 目录，强行复用旧缓存会触发沙箱层校验失败，导致所有 Shell 工具调用返回空响应。
如果你的任务依赖 plugging-in 工具链
方法一：检查 ~/.manus/plugins/ 下是否存在以 cli- 开头的可执行文件（如 cli-grep、cli-pdfcat）。若存在且文件时间戳早于 2026年6月1日，则必须选 4.9.x ——5.0 已废弃全部 cli-* 插件机制，改用 MCP CLI 统一接入。
方法二：运行 manus run --tool-list。若输出中包含 shell_exec、file_edit、web_crawl 三类原子函数，且无 mcp:// 协议前缀，说明环境适配 4.9；若列表含 mcp://shell、mcp://pdf、mcp://git，则为 5.0 专属动作空间。
如果你正在使用 planning-with-files 项目
第一步：进入项目根目录，执行 git log -n 1 --oneline。
这款全能AI助手融合了深度推理、多模态对话与图像生成等前沿技术，全面赋能职场、学习与生活。它支持多模态搜索，精准响应各类信息需求；内置AI文档助手，快速提炼要点并生成思维导图；更有智能创作功能，一键生成报告与文案。强大的AI能力助你高效处理复杂任务，让工作与生活更轻松便捷。
第二步：若最新提交哈希开头为 3a7f2e1（对应 v2.14.0 发布日：2026年2月4日），且 package.json 中 "planning-with-files" 版本号 ≤ 【v2.13.9】，请锁定使用 Manus 4.9.8 ——该版本是 planning-with-files v2.13.x 唯一通过全链路 CI 验证的运行时。
第三步：若项目已升级至 v2.14.0 或更高，且本地 manus config get runtime.version 返回值为 【5.0.0+】，则必须切换至 Manus 5.0 ——v2.14.0 引入的 /plan 快捷命令依赖 5.0 的分层动作空间调度器，4.9 调用时会直接跳过规划阶段，直奔执行导致步骤遗漏。
如果你的 workflow 涉及多子智能体协同
打开 ~/.manus/config.yaml，搜索 subagent 字段：
若配置中存在 knowledge_manager: 或 executor: 二级键，且顶层 runtime: 下无 isolation_mode: strict 字段，说明你跑的是 4.9 的宽松子智能体模式——此时切 5.0 会因规划器强制启用上下文隔离而卡死在「等待知识管理器响应」状态。
若配置中 isolation_mode: strict 已启用，且 subagent 下各角色均定义了 context_scope: minimal，那只能用 5.0 ——4.9 根本不识别这个字段，加载配置时会报 【YAML parse error: unknown key 'context_scope'】 并退出。
