Apache Maka（孵化中）是一款真正“以你为中心”的本地化 AI 代理工作空间——它不依赖云端服务器，所有对话、工具调用、执行结果和权限决策都默认保存在你的电脑上。它解决的是当前 AI 工具普遍存在的痛点：隐私不可控、执行过程黑箱化、历史无法追溯、结果难以复现。Maka 把 AI 协作变成一种可审计、可恢复、可编程的工作流，让你既能高效使用大模型能力，又始终掌握数据主权和运行主动权。
核心功能
- 本地优先架构：默认不上传任何数据，会话记录、配置、执行日志全部离线存储；支持灵活对接云 API、本地运行的 LLM（如 Ollama、LM Studio）或兼容网关，模型选择完全由你决定。
- 事件溯源式运行时：将模型消息、工具调用（如 git status、curl、代码分析）、工具返回结果、权限审批、任务终止等全部记录为不可篡改的追加日志（append-only log），整个 AI 执行过程变成一份清晰、可回放、可调试的“事实账本”。
- 多形态终端支持：提供 macOS 原生桌面应用（Apple Silicon 优化）、终端 TUI（类 VS Code 终端体验）、纯命令行 CLI，以及用于自动化测试与评估的 headless 模式，适配开发者从日常交互到批量脚本的不同场景。
- 智能上下文管理：不同于简单堆砌历史对话，Maka 主动进行“工具结果裁剪”与“LLM 上下文压缩”，动态优化传给模型的输入内容，在保障推理准确性的同时避免 token 浪费和信息过载。
- 细粒度权限控制：每个工具调用前需显式授权（如“允许读取当前目录”“允许执行 npm install”），支持一次性授权、会话级授权或永久白名单，杜绝 AI “越权乱动”，安全边界清晰可见。
- 可恢复的执行状态：因断电、崩溃或中断而暂停的任务，重启后能基于事件日志精准续跑，无需重头开始——对长时间运行的代码生成、文档整理、多步调研等场景尤为实用。
适合哪些人用
如果你是以下角色之一，Maka 值得立刻尝试：
• 注重隐私的开发者：处理敏感代码库、内部文档或客户数据，拒绝把上下文发往第三方 API；
• AI 工具链构建者：需要可审计、可集成、可自动化的 Agent 运行时，而非黑盒聊天界面；
• 本地模型实践者：正在用 Llama.cpp、Ollama 或 vLLM 运行私有模型，希望搭配一套成熟的工具调用与状态管理框架；
• 技术写作/知识工作者：常需 AI 协助查资料、整理笔记、生成报告，同时要求每一步操作可追溯、结果可验证。
快速上手
目前最便捷的方式是下载 macOS Apple Silicon 版桌面应用（官网未上线，直接访问 GitHub Releases 页面）：
→ 打开 GitHub Releases，下载最新 maka-*.dmg 文件并安装；
→ 首次启动后，按向导配置模型源（推荐先选 “OpenAI Compatible” 并填入本地 Ollama 的 http://localhost:11434）；
→ 在主界面输入任务，例如：“分析当前目录下的 package.json，并列出所有 devDependencies 的版本”——Maka 将自动调用文件读取工具、解析 JSON、格式化输出，并全程记录每一步。
命令行用户可全局安装：npm install -g @apache-maka/cli，然后运行 maka run --help 查看指令示例。
项目信息
apache/maka
GitHub
Apache Maka (Incubating) is a local-first AI agent workspace. Model messages, tool calls, tool results, permission decisions, and termination events a
编程语言：TypeScript｜Star 数：2010｜开源协议：Apache-2.0｜GitHub 项目地址
这是一款正在 Apache 孵化器中快速成长的严肃工程级 AI 运行时——它不追求花哨界面，而是用坚实的设计哲学（本地优先 + 事件溯源 + 显式权限）重新定义“人与 AI 如何真正协作”。
