信息卡

一句话定位

Apache 软件基金会孵化中的 local-first AI agent workspace：在本地机器上运行 agent、记录可恢复的执行事实，数据默认不出本机，模型由用户自选接入。

增速解读：为什么涨这么快

本月净增 2267 星，增速比高达 175%（2267/1296），相当于存量翻倍以上——这在进入 Apache 孵化器的项目身上极为罕见。"Apache 孵化"背书加上"local-first"叙事正踩中当下两大热点：一是开发者对数据隐私的焦虑（密钥明文仅存本地 credential-vault.json、无遥测），二是对 Claude Code 式编码代理的开源化期待。README 明确尚无正式发行版、需从源码构建，却仍能冲上 L3 第 6 名，说明流量主要来自"Apache 新项目"标签本身带来的关注与收藏，属于典型的孵化期抢跑行情，后续走势取决于首个正式发布能否兑现体验。

核心功能拆解

• Agent Runtime：多模型连接、流式输出、思考过程与用量统计；内置 Read/Write/Edit/Bash/Glob/Grep 六件套工具。
• 沙箱边界：越界工具调用需人工审批，运行可随时中止，失败自动分类。
• 可恢复执行：会话记录持久化进 SQLite（runtime.sqlite），支持崩溃恢复与回合级重试。
• Desktop 工作区：会话搜索、归档、从某个 Turn 分支、Artifact 预览、沙箱与模型设置。
• 三入口形态：Desktop（Electron）、TUI/CLI（maka、maka run）、Eval（maka eval run）。
• Evaluation 模块：声明式多臂实验，展开为 任务×重复×被测对象 单元格，输出分数/成本/时长等结果内核。
• 可选能力：本地记忆、网页搜索、IM 机器人（实验性）、Computer Use（默认关闭）。

架构与技术栈浅析

Node.js ≥ 22.19 全栈 TypeScript monorepo：apps/desktop 为 Electron 主进程 + React 渲染器；packages/core 定义 Sessions/Events/Permissions 契约，storage 落 SQLite，runtime 含 AgentRun 与模型适配器，eval/cli/ui 各自成包。执行链路为 Desktop/TUI/CLI → Runtime Host → SessionManager → AgentRun → Runtime Event Log，UI 只是事件投影，天然利于回放与审计。Graph 模式下操作符使用隔离 Git worktree 并行作业。

安装与环境要求

依赖 Node.js ≥ 22.19、npm 11、Git 与 ripgrep（Grep 工具必需）。目前 macOS Apple Silicon 为早期正式支持，Intel Mac/Linux 未支持，Windows 为未签名预览版。建议源码构建，暂不建议使用预编译下载。

快速上手示例

git clone https://github.com/apache/maka.git && cd maka
npm ci && npm run dev        # 启动 Desktop
# Settings → Models 中添加 API 或本地模型连接并设默认
npm run cli:dev -- run --graph "Implement two independent slices, integrate them"

进阶使用要点

• `maka run --graph` 非交互等待 Graph 完成，要求源项目为干净 Git 工作树。
• 中断恢复默认关闭，需设 `MAKA_RUNTIME_SAFE_BOUNDARY_RESUME=1` 启用 Safe resume（消耗 token）。
• 模型元数据经 models.dev 刷新，删除上游字段会 fail-closed，需显式确认。
• 按 workspace 测试：`npm --workspace @maka/runtime test`，桌面 e2e 用 `run e2e`。
• 开发版 CLI 与发布版二进制使用不同配置档，不会自动同步。

典型应用场景

• 隐私敏感团队的自托管编码代理工作台。
• 多供应商模型的 A/B 评估实验平台（Eval 单元格机制）。
• 会话级审计与成本核算：按归因成本、用量统计复盘 agent 支出。
• CI 外的可控自动化：Graph 操作符在隔离 worktree 内实现并行任务编排。

同类生态位对比

相比 Claude Code/Codex 等闭源编码代理，Maka 主打开源可审计与多模型自由接入；对比 Ollama 这类本地推理底座，它不做推理而是做工作区与评估层；和 LangChain 等框架相比又更偏终端产品。local-first + Apache 治理的组合在同类中独一份。

资源导航

仓库：https://github.com/apache/maka ；孵化期说明与 NOTICE 见仓库根目录；模型元数据来源 https://models.dev ；社区渠道以 Apache 官方 incubator 列表为准。