Maka：本地优先的 Agent 工作台，把每一次工具调用都变成可恢复的事实

它解决什么问题

Maka 要解决的是 AI 助手执行过程不可追溯的问题。大多数助手只保留对话文本，工具调用和结果散落在日志里，一旦中断很难恢复。Maka 把模型消息、工具调用、工具结果以及回合如何结束都写入持久化记录。这个记录是唯一的事实来源，UI 和下一次模型调用都只是它的视图。它面向的是需要在本地处理代码项目、并且希望每次操作都有据可查的开发者。

Runtime Host：一个入口驱动三种界面

Maka 的核心是 Runtime Host，它统一管理 Agent 的执行。桌面、终端和评估都通过这个 Host 运行。桌面是 Electron 加 React，提供流式会话、工具时间线、分支和恢复功能。CLI 用于在当前项目目录使用 Maka 或运行单个非交互回合。评估只负责实验和评分，不直接执行 Agent。这种设计让三种界面共享同一套工作区和模型连接，避免行为不一致。

执行记录与上下文压缩

Maka 的关键机制是把执行记录当作一等公民。每次工具调用和结果都被保存，即使后续提示词中省略了旧输出，证据也不会丢失。这解决了长会话中上下文窗口有限的问题。文档明确说“更短的上下文不是删除历史”。这意味着你可以压缩发送给模型的提示，同时保留完整的审计轨迹。对于需要调试 Agent 行为的场景，这个设计比单纯截断上下文更可靠。

沙箱边界与工具审批

内置工具包括 Read、Write、Edit、Bash、Glob、Grep。其中 Bash 可以执行命令，因此必须限制在沙箱内。文档说明“离开沙箱的工具必须经过批准”，并且运行可以被中止，失败会被分类。这意味着默认配置下，Maka 不会让 Agent 随意访问整个文件系统。你需要手动批准那些需要越界操作的工具。这是安全性和灵活性之间的权衡，适合需要精细控制权限的用户。

快速开始：从源码构建

目前没有 Apache 正式发布，README 明确建议不要下载预构建包，而是从源码构建。你需要 Node.js 22.19 或更新版本，npm 11，Git，以及 ripgrep（用于 Grep 工具）。克隆仓库后运行 npm ci，然后 npm run dev 启动桌面开发环境。如果要构建所有工作区，用 npm run dev:full。如果启用 Peer 功能，还需要 Rust 1.98 和平台链接器。这些命令都是文档中明确给出的。

评估系统：声明式多臂实验

Maka 的评估功能允许你运行可复现的基准实验。通过 maka eval run <spec> --out <directory> 启动。实验被展开成任务乘以重复次数乘以主体的单元格。每个单元格的尝试是不可变的，支持目标基础设施替换和最早有效选择。结果内核记录分数、归一化使用量、可归属成本、持续时间、状态、失败原因和产物。Maka 主体只通过 Runtime Host 执行，外部主体使用通用适配器。这让评估结果与执行环境解耦。

已知限制与替代方案

最明显的限制是平台支持。桌面版仅支持 Apple Silicon Mac，Intel Mac 和 Linux 不支持，Windows 只是未签名的预览版。另一个限制是项目仍处于孵化阶段，数据格式和 CLI 命令可能变化。如果你需要跨平台或稳定 API，可以考虑其他本地优先的 Agent 工具，比如 OpenHands 或 Aider，它们支持更多平台，但执行记录的持久化方式不同。Maka 的独特之处在于它把记录视为核心，而不是事后追加的日志。

维护成本与许可证

项目采用 Apache-2.0 许可证，这是宽松许可，允许商用和修改，但需要保留版权声明。维护成本较高，因为你需要从源码构建，并且要跟踪频繁的版本更新。最近发布频率大约每周一次，说明开发活跃，但也意味着接口可能不稳定。升级时需要重新构建并测试现有会话是否兼容。由于没有正式 Apache 发布，所有包都未经过 PMC 审查，使用时需要自己承担风险。

编辑结论

适合需要在本地保留完整执行记录、并且愿意从源码构建的 macOS Apple Silicon 用户。不适合需要稳定 API 或 Windows/Linux 支持的生产环境。采用前先验证：Node.js 22.19+、npm 11、ripgrep 是否就绪，并确认你能接受数据格式和 CLI 命令可能变化。Maka 尚未发布 Apache 正式版本，所有预构建包均未经过 PMC 审查。

官方来源

1. Official README
2. Project repository
3. Release notes