如何快速上手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 是 Apache 软件基金会孵化中的本地优先 AI Agent 工作空间Apache Maka, Incubating。它的**目标模式Goal Mode**允许你给 AI Agent 设定一个可验证的达成条件Agent 便会逐轮自主执行、自我评估进度直到目标达成、被判定不可行或触及预算上限——无需你一句句追问。本指南将带你 10 分钟上手这套目标驱动型 AI 任务机制。为什么需要目标驱动型 AI Agent传统用法是你说一步、AI 走一步。对于让所有测试通过重构整个模块这类长任务你需要不断催促、检查、再催促。Maka 的目标模式换了一种思路你说终点例如packages/runtime 下所有测试通过Agent 自己跑全程每轮结束后由评估器判断进度未达标就自动进入下一轮预算兜底最多轮数、连续无进展熔断、Token 预算三重保护防止 Agent 无限烧钱全程留痕模型消息、工具调用、工具结果、权限决策都写入只追加日志可审计、可恢复 核心理念把持续追问变成设定终点AI Agent 自主驱动你只盯结果。第一步安装并启动 Maka从仓库获取项目并安装git clone https://gitcode.com/GitHub_Trending/mak/maka cd maka npm installMaka 提供桌面端macOS Apple Silicon 首发Windows 预览版和终端 TUI/CLI 两种入口。目标模式在桌面端体验最完整。核心代码可参考 packages/core/ 与 packages/runtime/。第二步通过菜单设定 Goal在任意已有会话的输入框中点击输入框左侧的添加上下文按钮选择菜单中的设定 Goal…在弹出的对话框中填写三项内容点击开始即可武装arm目标对话框三个关键字段字段说明取值规则达成条件目标描述要求可观察、可验证最多 500 字符最多轮数总轮次上限触顶即停max_iterations状态默认 50上限 200Token 预算可选。为这个目标花费的 Token 上限超支即停budget_limited状态最小 1000不设则不限 除了轮数与预算系统还有卡死检测stall detection默认连续 8 轮无进展会自动判定为stalled停止上限可配到 50。界面对这些边界做严格校验——比如 Token 预算填 500 会直接提示请填不小于 1000 的整数并禁用开始按钮预算只会被拒绝不会被悄悄改写。这套校验逻辑在测试中有完整覆盖可看 goal-dialog-budget.spec.ts。写好达成条件后点击开始Agent 就会从当前会话继续自主工作每轮结束自动评估一次。第三步看懂目标状态掌控执行过程目标在会话中实时显示状态指示器。Maka 定义了 8 种状态定义见 goal.ts状态含义active/waiting正在自主执行中achieved 条件已满足目标达成impossible评估器判定条件不可达成paused你手动暂停状态保留可随时恢复stalled连续无进展触发熔断budget_limitedToken 预算耗尽max_iterations轮数上限触顶cleared被手动清除目标管理五件套Agent 自己也可以通过内置工具管理目标五个工具一一对应你需要的操作GoalSet—— 设定自主执行目标Agent 可为自己武装停止条件GoalStatus—— 查询状态条件、已用轮次、无进展连击数、Token 消耗、最后原因GoalPause / GoalResume—— 暂停与恢复状态完整保留GoalClear—— 清除目标当前轮结束后停止自主执行工具实现见 goal-tools.ts。每条约束都有明确语义每个会话同时只有一个活动目标旧目标必须先清除或完成才能设定新目标一次轮次只能绑定一个目标防止竞态下重复武装。实战建议写出好的达成条件✅可验证packages/runtime 下所有测试通过PR 评论全部处理完毕❌太模糊把代码写得好一点无法判断达成与否长任务记得设Token 预算比如 500020000避免目标失控燃烧探索型任务可适当调高最多轮数上限 200中断后不要慌暂停的目标状态完整保留随时 GoalResume 继续目标模式适合哪些场景最适合跑通全部测试、修复 CI 失败、批量重构、把 TODO 清单执行完、补齐文档这类有明确终点的任务。不太适合开放式创作、需求未定型的研究类对话——此时普通多轮对话更合适。延伸阅读桌面端目标功能模块说明features/goals/README.md后端架构总览ARCHITECTURE.md会话任务台账生命周期session-task-ledger-lifecycle.md项目主文档README.zh-CN.md目标模式把追着 AI 干活变成设定终点后看结果。配合只追加的持久日志和三重预算保护Maka 的目标驱动型 AI 任务执行既自主又可控——现在就去你的第一个会话里点击 → 设定 Goal…试试吧。【免费下载链接】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），仅供参考