Maka Agent计划模式是什么让AI助手先规划再执行的完全指南【免费下载链接】makaApache Maka (Incubating) is a local-first AI agent workspace. Model messages, tool calls, tool results, permission decisions, and termination events are recorded as an append-only log.项目地址: https://gitcode.com/GitHub_Trending/mak/makaMaka Agent 计划模式Plan Mode是 Apache Maka 这款本地优先local-firstAI Agent 工作区里的核心协作能力开启后AI 助手先只读地勘察代码库、讨论方案输出一份带步骤和风险的结构化计划经你批准后才开始执行全程进度可追踪、可中断、可恢复。本文将带你快速理解计划模式的工作原理、完整流程与最佳实践。为什么需要计划模式先规划再执行更安全在默认的 Agent 模式下AI 拿到任务就会边想边改读文件、写文件、跑命令一气呵成。这对小任务很爽但面对重构、迁移这类大改动想到哪做到哪风险极高。计划模式用一句系统提示词概括了 AI 的行为约束见packages/runtime/src/plan-mode.tsYou are planning only. Inspect the repository and discuss tradeoffs, but do not modify files or perform side effects.也就是说在计划阶段AI只能读、不能写从根本上杜绝了没经过你同意就动手的问题。计划模式如何限制AI的操作权限Maka 通过工具白名单机制实现只读规划。计划模式下AI 可用的工具被严格筛选源码packages/runtime/src/plan-mode.ts✅保留所有只读类工具读文件、检索、联网搜索等✅保留SubmitPlan提交计划和AskUserQuestion向你提问确认细节❌禁用文件修改、子代理Subagents、定时任务等会产生副作用的工具这种设计让 AI 可以充分调研却没有任何机会提前动手。计划模式完整流程从提交到执行 4 步走整个计划生命周期在packages/core/src/plan.ts中定义流程清晰可控第1步AI勘察仓库并提交计划方案开启计划模式后下达任务AI 会先浏览代码、分析影响面然后调用SubmitPlan工具提交一份结构化的计划提案。提案包含见packages/runtime/src/plan-tools.ts字段说明标题title简短的计划名称概述overview整体思路说明步骤steps最多 50 步每步含标题≤30字符、详细描述、涉及文件、复杂度风险risks最多 20 条关键风险提示第2步你审批——批准、要求修改或放弃桌面上会弹出计划方案卡片界面组件apps/desktop/src/renderer/plan-mode-panel.tsx显示等待确认的提案你可以三选一执行计划批准后立即进入执行阶段继续修改要求 AI 修订方案提交新的修订版新提案会取代旧提案放弃计划退出计划模式不做任何改动第3步逐步执行进度实时可见批准后AI 按步骤推进并通过update_plan工具实时更新每个步骤的状态未开始 → 正在执行 → 已完成或已跳过。界面会显示3/5 步这样的进度计数每一步改了什么文件、进展如何一目了然。第4步完成、取消或中断恢复✅完成全部步骤执行完毕生成完整的执行记录取消你明确放弃时AI 调用cancel_plan终止执行⏸️中断任务被打断如切换窗口、进程重启后执行记录会保留中断进度快照。再次进入计划模式时AI 拿到的是renderInterruptedPlanContext生成的上下文含中断原因和已完成步骤会重新规划剩余工作新计划批准后才继续——不会自动接着跑这种中断-重规划机制是计划模式最实用的安全特性之一即使中途有变已批准的执行轨迹也全程留痕、可追溯。3个实用技巧把计划模式用出最高效1️⃣大任务必开计划模式。重构模块、跨文件迁移、引入新依赖这类任务先让 AI 交一份带风险清单的计划审阅风险点后再批准返工率显著降低。2️⃣善用继续修改迭代方案。第一版计划不完美很正常——指出第 3 步拆得太粗或漏了数据库迁移AI 会提交修订版Revision 2、3……修订历史全部保留在追加式事件日志中。3️⃣中断不等于丢失。如果任务执行到一半你改变了需求直接重新进入计划模式即可AI 会基于中断快照重排剩余步骤而不是从头再来。计划模式相关源码位置速查想了解或二次开发计划模式可以从这些入口入手核心数据模型与状态机packages/core/src/plan.ts计划工具定义SubmitPlan / update_plan / cancel_planpackages/runtime/src/plan-tools.ts模式行为约束与提示词packages/runtime/src/plan-mode.ts桌面端计划面板 UIapps/desktop/src/renderer/plan-mode-panel.tsx中英文界面文案apps/desktop/src/renderer/locales/plan-mode-copy.ts常见问题FAQ问计划模式和 Agent 模式怎么切换Maka 提供agent默认和plan两种协作模式在会话中切换即可。计划模式下 AI 只读Agent 模式下全功能放开。问计划模式下 AI 还能联网搜索吗可以。只读类工具含 web 搜索都在白名单内只有会产生副作用的操作被禁用。问批准的执行被中断后会自动恢复吗不会。出于安全考虑Maka 要求你重新规划并再次批准后才继续避免 AI 在你不知情的情况下恢复执行。问计划步骤有数量限制吗单计划最多 50 步、每步最多关联 50 个文件、风险项最多 20 条防止计划本身失控膨胀。总结Maka Agent 计划模式用先规划、后批准、再执行的流程把 AI 助手从埋头干活变成先交方案再动手的可靠协作者规划阶段只读安全、执行阶段进度透明、中断后可重规划恢复。如果你希望 AI 在重要任务上更可控、更可审计计划模式值得第一时间开启。【免费下载链接】makaApache Maka (Incubating) is a local-first AI agent workspace. Model messages, tool calls, tool results, permission decisions, and termination events are recorded as an append-only log.项目地址: https://gitcode.com/GitHub_Trending/mak/maka创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考