Apache Maka ： 记录一切为追加式日志的本地优先 AI Agent 工作区
AI智库导航-aiguide.cc为您提供最新的AI新闻资讯和最新的AI工具推荐，在这里你可以获得用于营销的AI聊天机器人、AI在商业管理中的应用、用于数据分析的AI工具、机器学习模型、面向企业的AI解决方案、AI在商业客户服务中的应用、AI和自动化工具等。
主要介绍
Apache Maka（孵化中）是一个本地优先的 AI Agent 工作区，定位是「为真实工作而建（A local-first Agent workspace built for real work）」，由 Apache 软件基金会 Incubator PMC 赞助，2026 年 8 月 13 日被孵化器接受。它检查你的项目、在沙箱边界内运行工具，并把模型消息、工具调用、工具结果、权限决策与终止事件记录为可恢复的执行事实（append-only log）——UI 与下一次模型调用都只是这份记录的视图，而不是唯一副本。Maka 提供桌面端（Electron + React，含流式会话、工具时间线、分支与恢复）、TUI / CLI（maka、maka run）与 Eval（可复现的基准实验）三种入口，统一经由一个 Runtime Host 执行。内置 Read / Write / Edit / Bash / Glob / Grep 工具，离开沙箱的工具需审批，支持崩溃恢复与中断回合的续跑。当前 GitHub 约 2,381 颗星，采用 Apache-2.0 许可证，尚在孵化期、无 Apache 官方发布版本，需从源码构建。
Apache Maka 官方仓库首页
Apache Maka 官方 README 展示图
功能特点
-
本地优先：会话、设置与运行记录默认保留在本机，模型自带（云端 API / 本地模型 / 兼容网关）
-
追加式日志：模型消息、工具调用、工具结果、权限决策、终止事件全部落盘为可恢复执行记录
-
统一 Runtime Host：桌面、终端与 Eval 共用同一运行时，Eval 只拥有实验与分数
-
内置工具：Read、Write、Edit、Bash、Glob、Grep；Computer Use 与 catalog skills 可选、默认关闭
-
沙箱边界：离开沙箱的工具必须审批；运行可中止；失败会被分类
-
崩溃恢复与续跑：持久执行记录，支持中断回合的可选恢复（resume）
-
多模型连接：流式输出、思考、用量统计与更清晰的 provider 错误提示
-
桌面工作区：会话创建、归档、搜索、重命名、重试、再生成、分支；Artifact 列表与预览
-
本地记忆与 Web 搜索（配置后启用）；IM 机器人（聊天应用）为实验性功能
-
Eval 基准：声明式多臂实验（task × repetition × subject），输出分数、用量、成本、时长等结果内核
优缺点
-
优点1：Apache 基金会孵化背书，治理规范（ASF license header、协议 epoch 管理、安全边界文档），长期可信度高
-
优点2：「记录即真相」的追加式日志设计，执行过程可审计、可恢复、可续跑，与 DSH 的会话日志思路同属前沿方向
-
优点3：本地优先 + 沙箱 + 权限审批，数据与执行边界清晰，适合隐私敏感场景
-
优点4：三入口统一 Runtime Host（桌面 / TUI / Eval），开发与评测同一套运行时，结果可复现
-
优点5：Apache-2.0 许可证，TypeScript 全栈（Electron + React + AI SDK），生态友好
-
缺点1：尚在孵化期，无 Apache 官方发布版本，README 不推荐预构建下载，仅能从源码构建
-
缺点2：目前仅支持 macOS Apple Silicon（arm64）；Intel Mac 与 Linux 未支持，Windows 为未签名预览版
-
缺点3：桌面端是早期公开版本，数据格式、CLI 命令与实验性能力仍可能变更
-
缺点4：项目较新（2026 年 5 月创建，8 月入孵），生态、插件与第三方集成仍在积累
如何使用
-
前置要求：Node.js 22.19+（CI 用 Node 24）、npm 11、Git、ripgrep（Runtime 的 Grep 工具依赖）
-
从源码启动桌面端：git clone https://github.com/apache/maka.git 后 cd maka，执行 npm ci 与 npm run dev
-
完整构建：npm run dev:full（先构建所有 workspace 再启动 Electron）
-
首次运行：打开 Settings → Models，添加 API、本地模型或支持的账户连接，测试并选择默认模型
-
终端入口：npm run build 后，npm run cli:dev 启动 TUI；npm run cli:dev — run “任务描述” 执行单回合
-
Eval 基准：maka eval run <spec> –out <目录> 运行可复现实验
-
安全提示：离开沙箱的工具会请求审批；MCP 密钥保存在主进程侧，不跨 IPC 明文传输
框架技术原理
-
追加式日志模型：模型消息、工具调用、工具结果、权限决策、终止事件记录为 append-only log，UI 与模型调用只是记录的视图
-
Runtime Host 单一执行入口：Desktop、终端与 Eval 全部经同一运行时执行；Eval 只拥有实验与分数
-
Electron + React 桌面端（Astryx 设计系统），渲染进程为 semi-trusted（SECURITY.md §3），主进程负责敏感边界
-
IPC 安全设计：MCP 配置密钥保存在主进程侧，不跨 IPC 明文传输；@maka/core/mcp-secrets 是唯一权威密钥位置清单
-
持久化解码边界：核心层强制 persisted record decoders，存储层统一走持久化解码路径
-
协议版本管理：scripts/protocol-epoch-check.mjs 要求协议目录变更需 bump epoch，防止不兼容协议共用一个版本号
-
沙箱与权限：离开沙箱的工具需审批；支持中止运行、失败分类、崩溃恢复与中断回合续跑
-
多模型适配：基于 @ai-sdk/* 连接 Anthropic、OpenAI、Google、Cohere 等 provider，支持 opencode 作为 agent provider
创新点
-
把「记录即真相」落地为产品：追加式日志是唯一事实源，UI 与模型调用皆为视图，天然支持审计与恢复
-
统一 Runtime Host：桌面、CLI、Eval 共享一个运行时，评测结果可复现、实验与生产同一执行路径
-
「更短的上下文 ≠ 删除历史」：可省略旧工具输出而不丢弃已保存的证据
-
协议 epoch 强制管理：杜绝不同协议版本共用一个版本号的兼容性陷阱
-
主进程 / 渲染进程半信任模型 + 密钥权威清单：Agent 桌面应用的敏感边界设计可参考
评估标准
-
执行记录完整性：append-only log 是否覆盖全部消息、工具、权限与终止事件且可恢复
-
崩溃恢复可靠性：中断回合能否无丢失续跑（resume）
-
沙箱与审批正确性：越界工具是否全部拦截、审批流程是否无绕过
-
多模型兼容性：Anthropic / OpenAI / Google / Cohere 等 provider 的流式、思考与用量统计一致性
-
Eval 可复现性：多臂实验（task × repetition × subject）结果是否确定、成本是否可归因
-
平台覆盖与稳定度：macOS / Windows / Linux 支持进度、数据格式与 CLI 变更频率
应用领域
-
本地优先的日常 AI 编码与文件工作流（桌面 + 终端双入口）
-
隐私敏感场景：会话与运行记录默认留本机，自带模型连接
-
可审计的 Agent 执行：追加式日志支撑合规、复盘与安全审查
-
可复现的 Agent 评测：Eval 多臂实验用于框架 / 模型选型对比
-
需要沙箱边界的自动化：工具越界审批 + 崩溃恢复，适合无人值守任务
项目地址
Apache Maka（Incubating）由 Apache 软件基金会孵化器赞助，仓库托管于 GitHub（apache/maka），采用 Apache-2.0 许可证，GitHub 约 2,381 颗星、271 fork，主要语言 TypeScript，创建于 2026 年 5 月 27 日，2026 年 8 月 13 日被 Incubator 接受，当前仍在孵化期、活跃开发中（最近提交 2026-08-24）。
官方定位：本地优先 AI Agent 工作区，模型消息、工具调用、工具结果、权限决策与终止事件记录为追加式日志。提供 ARCHITECTURE.md（后端架构）、docs/ 目录与中文文档 README.zh-CN.md；桌面端当前面向 Apple Silicon Mac，Windows 为未签名预览，Linux 尚未支持。
注意：项目尚无 Apache 官方发布版本，当前 GitHub Releases 上的 v0.1.11（2026-08-18）未经 ASF 发布流程，README 不推荐预构建下载，请从源码构建。
-
项目官网：https://github.com/apache/maka
同类型工具比较
|
对比维度
|
Apache Maka
|
DeepSeek Harness
|
ai-memory
|
munder-difflin
|
LangGraph
|
|---|---|---|---|---|---|
|
核心定位
|
本地优先 Agent 工作区（记录即真相）
|
一切皆插件 Agent 运行框架
|
跨 Agent 供应商长期记忆
|
本地多 Agent 编排（办公室隐喻）
|
有状态 Agent 图编排
|
|
执行记录
|
append-only log（全部事件落盘）
|
append-only SessionEvent log
|
git 版 markdown wiki + SQLite FTS5
|
磁盘文件邮箱 + 事件日志
|
图状态持久化
|
|
运行形态
|
桌面 + TUI + Eval（统一 Runtime Host）
|
Web UI + headless
|
Electron 桌面应用
|
Python / TS 库
|
|
|
沙箱 / 权限
|
内置沙箱边界 + 越界审批
|
capability seams + sandbox provider
|
不涉及
|
人类门控 + 断路器
|
不内置
|
|
评测能力
|
内置 Eval（多臂实验可复现）
|
BENCHMARK.md
|
evals 目录
|
无内置
|
无内置
|
|
许可证 / 状态
|
Apache-2.0 / Incubating
|
MIT / Developer Preview
|
MIT / 活跃
|
MIT / prototype
|
MIT / 稳定
|
© 版权声明
文章版权归作者所有，未经允许请勿转载。
相关文章
暂无评论...
AI全网资源导航每日收集国内外热点AI/人工智能/工具/模型/框架以及最新的AI学习资料/课程等，在这个全新的AI时代，助力每一个人，赋能每一个具体业务场景，与所有人一起努力向前！
