Apache Maka (Incubating) 介绍与选型指南

Apache Maka（Incubating）官方资料介绍与选型指南：本地优先 AI 代理运行时的追加式日志架构、四种运行界面、孵化状态说明，及与 LangChain、AutoGen、OpenHands 的量化对比。

Apache MakaMaka2026/10/18

Apache Maka (Incubating) 介绍与选型指南

一、信息基准

  • 查询日期：2026-10-18。
  • 版本依据：截至查询日期，Apache Maka 处于 Apache 孵化器（Incubator）阶段，官方渠道尚未发布任何发行版本（孵化提案将「产出符合 Apache 规范的源码发行并建立可重复的发布流程」列为初始目标之一；官方发行目录与包管理仓库中均未检索到 Maka 发行物）。因此本文标题以 (Incubating) 标注状态而非版本号，正文不给出任何版本数字。
项目内容
孵化提案（2026-08-04 更新）https://cwiki.apache.org/confluence/spaces/INCUBATOR/pages/446070971/Maka+Proposal
孵化状态页https://incubator.apache.org/projects/maka.html
源码仓库（提案所载）https://github.com/maka-agent/maka-agent （提案注明将迁移至 github.com/apache/incubator-maka）
规划官网https://maka.apache.org （提案原文：未来项目网站将使用该域名）
开源许可Apache License 2.0（提案注明源码以 Apache-2.0 授权）

信息基准说明：本文所有事实性描述均取自 Apache 孵化器提案（cwiki，最后更新 2026-08-04）与孵化器公开页面；提案之外的社区数据本文不作引用。

二、软件概述

本文介绍 Apache Maka（孵化中，尚无发行版）。孵化提案对项目的定义原文为：Maka 是一个本地优先（local-first）的 AI 代理运行时与工作区（workspace）。它把模型消息、工具调用、工具结果、权限决策与终止事件记录进追加式日志（append-only logs），会话、模型上下文、持久任务与恢复机制均从这些日志派生，使被打断或长时间运行的代理工作可以被检查、回放、续跑与评估。

工程形态上，Maka 主要以 TypeScript 编写并运行在 Node.js 之上（提案原文：Node.js 目前要求 22.19 或更高版本），提供桌面应用、终端 TUI、非交互 CLI 与无界面任务运行器（headless runner）共享的单一执行运行时；会话、设置、凭据与运行记录默认保留在用户本机。提案由 Zili Chen（tison）创建，最后更新于 2026-08-04；公开 GitHub 仓库创建于 2026-05-27。

三、核心架构

孵化提案列出的五项核心能力（原文要点转述）：

  • 追加式执行记录：模型消息、工具调用、工具结果、权限决策与终止事件在投影为用户可见状态之前先行持久化。
  • 可重建状态：会话、活动上下文、界面状态与恢复决策均从事件日志派生，而非维护独立的真相源。
  • 不删除历史的上下文管理：工具结果修剪（tool-result pruning）与 LLM 压缩（compaction）只为降低下一次推理的上下文占用，原始执行记录完整保留。
  • 超越单轮的持久工作：headless runner 为任务赋予独立身份、事件日志、预算（budgets）、权限暂停、继续与恢复行为。
  • 证据化完成判定：运行时将模型的「已完成」声明与经核验的进程、工具结果分开记录。

提案在架构定位中说明：AI 代理 = LLM + 工具 + 权限 + 持久状态 + 控制循环；随着任务变长，运行时层必须处理部分完成的工具执行、上下文限制、进程打断、权限边界与恢复，Maka 专注的正是这一运行时层。

四、功能特性

  • 多形态界面共享单一运行时：Electron 桌面应用、终端 TUI、非交互 CLI、headless runner（提案原文；CLI 与 headless 不依赖 Electron 与 React）。
  • 模型接入层：经 Apache-2.0 许可的 Vercel ai SDK 及其 Anthropic、Cohere、Google、OpenAI 与 OpenAI 兼容适配器归一多家模型协议；可配置远程供应商或本地兼容端点，凭据留在本地（提案原文）。
  • MCP 互操作：通过 @modelcontextprotocol/sdk 实现与 Model Context Protocol 生态的对接（提案 External Dependencies 一节）。
  • 本地执行与终端能力：node-pty 与 headless xterm 包提供交互式 shell 会话与终端仿真；fs-native-extensions 提供跨进程文件锁；@jackwener/opencli 提供基于 CDP 的浏览器自动化（提案原文）。
  • 可选集成：Slack、Lark/飞书、企业微信 SDK 仅在启用对应机器人通道时使用（提案原文）。
  • 依赖与许可盘点：TypeScript monorepo，33 个直接生产依赖；按 @maka/desktop 闭包生成的第三方清单为 239 个生产 npm 包（180 MIT、21 Apache-2.0、19 ISC、15 BSD-3-Clause、2 BSD-2-Clause、1 Python-2.0、1 BlueOak-1.0.0），记录无 Category X 依赖（提案 2026-08-03 复核数据）。
  • 社区规模（提案 2026-08-03 原始数据）：GitHub 1104 stars、123 forks、40 位贡献者，此前 30 天有 34 位作者提交。

五、快速上手

由于项目尚未发布任何 Apache 版本，当前唯一正式入口是源码仓库与其内置文档（孵化提案 Documentation 一节所列）：

  • 仓库与 README：https://github.com/maka-agent/maka-agent
  • 文档索引：仓库内 docs/README.md
  • 架构指南：仓库内 ARCHITECTURE.md，含八章索引，docs/architecture/ 目录提供英文/中文双语章节
  • 专题设计文档：计算机使用安全、执行证据、持久工作区、权限、技能与评估等主题均有独立文档（提案原文列举）

本文不编造安装命令与运行输出；待首个 Apache 源码发行发布后，应以发行公告与官方文档为准。提案预期孵化期约两年，期间接口与打包方式都可能调整。

六、适用场景与限制

适用场景：

  • 需要「可审计、可恢复、可评估」的 AI 代理执行环境的团队：完整执行记录使被中断的长任务可以回放与续跑。
  • 需要本地优先、凭据不出本机的代理工作区使用者。
  • 希望以厂商中立运行时对接多家模型供应商（含本地兼容端点）与 MCP 生态的集成方。

限制与注意点：

  • 无任何发行版本：不可用于对稳定性、可升级性与供应链审计有硬性要求的生产环境。
  • 项目名称尚未完成 ASF 商标审查（提案 Known Risks 原文：孵化期内将完成 PODLINGNAMESEARCH，如不符合政策将改名）。
  • 孵化早期社区规模小：提案自述长期延续性尚未经过验证，初始提交者之间存在社交与职业网络重叠，英文公开治理正在建设中。
  • 桌面形态依赖 Electron/Chromium，CLI 与 headless 形态则无此依赖，按部署面选择形态时可减小依赖面。

七、同类选型对比

对比对象：LangChain（LLM 应用与代理框架）、AutoGen（多代理对话框架）、OpenHands（自主软件工程代理平台）。GitHub stars 维度：Maka 的 1104 stars 来自孵化提案（2026-08-03 官方记录）；其余项目 GitHub 页面经本文取证通道未能取回可靠计数值，标注官方未公布。版本与时间来自 PyPI（2026-10-18 查询）。

维度Apache Maka (Incubating)LangChain 1.4.6AutoGen（autogen-agentchat 0.7.5）OpenHands 1.11.0
开源许可Apache-2.0MIT（仓库 LICENSE）以仓库 LICENSE 为准（含 CC-BY-4.0 许可文本）MIT（仓库 LICENSE）
GitHub stars + 最近发版1104（2026-08-03，孵化提案官方记录）；无发行版官方未公布；2026-10-14（PyPI）官方未公布；2025-09-30（PyPI）官方未公布；2026-07-09（PyPI）
版本节奏孵化中，未建立发布流程高频迭代版本更新相对平缓持续迭代
兼容矩阵Node.js 22.19+（提案原文），TypeScript monorepoPython >=3.10（PyPI 元数据）Python >=3.10（PyPI 元数据）Python >=3.12 且 <3.14（PyPI 元数据）

选型建议：生产环境与稳定性优先的团队应选择 LangChain、OpenHands 等已有成熟发行与生态的框架；只有在能够接受孵化期变动、且核心诉求是执行记录可审计与任务可恢复的厂商中立代理运行时时，才建议以试点方式跟踪与试用 Maka。

八、参考链接