Manus指令越详细越易失败，因过度约束破坏KV-Cache稳定性、引发工具幻觉或权限冲突；应删系统提示中动态内容、用状态机屏蔽工具而非删除、分步交付指令、使用绝对路径。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Manus指令越详细越容易失败，不是因为模型理解力差，而是因为过度约束会破坏KV-Cache稳定性、触发工具选择幻觉、或在沙箱中引发权限校验冲突。一个带时间戳、多层嵌套条件、精确到像素坐标的点击指令，可能让Manus在第三步就放弃调用browser_click而转向shell_exec。
避免在系统提示中插入动态内容
把当前时间、随机ID、用户IP或会话哈希值写进系统提示开头，是导致缓存命中率归零的最常见操作。LLM自回归生成机制决定了：只要前缀中有一个token不同，后续所有KV缓存都无法复用。
检查你的system prompt文件，删掉类似“【当前时间：2026-06-01 12:42】”或“session_id: abc123xyz”的行——它们看起来很专业，实则让每次推理都从零开始计算。
这一步操作起来很简单，直接用文本编辑器打开prompt.txt，Ctrl+F搜“time”“now”“id”“uuid”，删掉整行即可。
用状态机屏蔽工具，而不是删除工具定义
当任务只需调用file_read和browser_input时，别在history里把deploy_expose_port、shell_exec整个从工具列表中移除。物理删除工具定义会炸掉整个KV-Cache前缀，模型可能在下一步突然调用一个早已“消失”的函数名，导致解析错误或静默失败。
方法一：在解码阶段启用tool masking
确保Apollo或Manus Runtime配置中开启tool_masking_mode=stateful，并在每轮循环的observation末尾追加一行：【当前可用工具：file_read, browser_input】。模型会据此压制其他工具token的logits，但工具定义本身保留在上下文头部不变。
方法二：用自然语言显式约束动作空间
在用户指令末尾追加一句：“本次任务禁止执行任何shell命令、端口暴露或文件写入操作，仅允许读取网页内容与本地文本文件。”Manus对这类强约束语句响应稳定，且不扰动KV-Cache。
分步交付指令，拒绝长链原子化描述
第一步：告诉Manus你要做什么
这款全能AI助手融合了深度推理、多模态对话与图像生成等前沿技术，全面赋能职场、学习与生活。它支持多模态搜索，精准响应各类信息需求；内置AI文档助手，快速提炼要点并生成思维导图；更有智能创作功能，一键生成报告与文案。强大的AI能力助你高效处理复杂任务，让工作与生活更轻松便捷。
输入：“请分析https://example.com/report.pdf中的Q3营收数据，并对比上季度变化。”
第二步：等它返回已下载PDF并提取文字的结果后，再发新指令
输入：“从上一步提取的文字中，定位‘Q3营收’所在段落，提取数值及环比百分比。”
第三步：确认结构化结果正确后，再要求可视化
输入：“用matplotlib画柱状图，横轴为‘Q2’‘Q3’，纵轴为营收（万元），保存为q3_revenue_plot.png。”
这种分步法看似多打三次字，实则让每轮上下文增长可控、缓存断点清晰、观测结果可验证。而把三步合并成一句超长指令：“下载PDF→提取文字→找Q3营收→算环比→画图→保存”，会迫使模型在单次推理中完成全部规划，极易因中间某步失败（如PDF解析乱码）导致整条链崩溃，且无法回溯修正。
注意：Manus的todo.md机制只在自主任务中自动启用，手动输入的长指令不会触发该清单生成，也就失去分步勾选与状态回滚能力。
文件路径必须绝对且可访问
不要写“把桌面的data.xlsx发给我”，要写“读取/home/manus/workspace/data.xlsx”。Manus运行在Linux沙箱中，没有Windows-style桌面路径概念，“桌面”在Ubuntu下实际是/home/manus/Desktop/，但默认沙箱权限通常不开放该路径。
所有路径必须满足两个条件：一是以/home/manus/为根；二是该文件已在沙箱初始化时挂载或由上一步操作生成。若不确定，先发一条指令：“列出/home/manus/workspace/下的所有文件”，确认存在后再引用。
这一步出错会导致file_read直接返回空或权限拒绝，且不会报错提示路径问题，而是静默跳过——你看到的是“未找到数据”，实际是路径根本没进去。
