这是一个本地优先的 AI 智能体（Agent）工作区，旨在让用户在本地机器上安全地运行 AI 工具、检查项目，并完整记录执行过程，从而解决 AI 运行时的数据隐私、上下文丢失和崩溃恢复等核心问题。

主要功能与特性

• 本地优先与数据安全：会话、设置和运行记录默认保留在本地，用户可自由接入云端 API、本地模型或兼容网关，数据不依赖外部服务。
• 执行记录与崩溃恢复：完整记录模型消息、工具调用和结果。这些记录作为可恢复的执行事实，支持任务中断后的恢复与续跑。
• 智能上下文管理：在缩短上下文窗口时，系统可以省略旧的工具输出以节省 Token，但不会删除底层已保存的执行证据。
• 统一运行时（Runtime Host）：桌面端、命令行和评估模块均通过统一的运行时主机执行，确保不同入口的行为高度一致。
• 沙箱安全控制：内置文件读写、代码编辑、Bash 执行等基础工具。任何试图离开沙箱边界的工具调用都必须经过用户明确批准，且支持随时中止运行。
• 多端交互支持：
• 桌面端：提供流式会话、工具时间线、分支管理、搜索及 Artifact 预览等丰富的图形化交互。
• 命令行/TUI：支持在当前项目目录下进行非交互式运行，并支持基于图（Graph）的复杂任务执行。
• 评估模块：支持声明式的多臂实验，用于可重复的基准测试。

安装与使用

由于项目目前尚未发布正式的 Apache 构建版本，官方推荐从源码构建运行。在开始之前，请确保你的环境已安装 Node.js 22.19 或更高版本、npm、Git 以及 ripgrep。

启动桌面端开发环境：

git clone https://github.com/apache/maka.git
cd maka
npm ci
npm run dev

(注：桌面端目前主要针对 Apple Silicon Mac 优化，其他平台支持仍在完善中。)

构建并运行命令行工具：

npm run build
npm run cli:dev

首次启动桌面端时，系统不会内置共享的模型账号。你需要进入 Settings → Models，手动添加你的 API 或本地模型连接，测试成功后即可开始任务。

适用场景与目标用户

• 适用场景：需要处理敏感代码或私有数据的 AI 辅助编程；需要完整追溯 AI 决策过程、方便 Debug 的自动化任务；以及 AI 智能体的基准测试与评估实验。
• 目标用户：注重数据隐私与安全的开发者、需要本地化 AI 工作流的技术人员，以及进行 AI Agent 行为研究与评估的科研人员。

总结

总体而言，该项目在本地化运行、沙箱安全控制和执行可追溯性方面提供了非常扎实且严谨的解决方案，让 AI 智能体的落地变得更加可控。由于项目目前仍处于 Apache 孵化阶段且正在积极开发中，部分实验性功能和平台支持还在持续演进，建议访问其主页获取更详细信息。