拓冰网站定制 
Maka为实际工作打造的本地优先代理工作区Maka 可不只是能回答问题它具备可控权限能检查项目、执行工具、生成工件还能将模型消息和工具调用保存为可恢复的执行事实。桌面端、终端 TUI、非交互式 CLI 以及 Maka 评估主体均通过 Runtime Host 执行。注意Maka 正在积极开发中。macOS Apple Silicon 桌面版是早期公开版本数据格式、CLI 命令和实验性功能可能仍会变动。为何选择本地优先而非托管优先默认情况下会话、设置和运行记录都保存在本地机器上。你可以自行选择模型连接方式云 API、本地模型或兼容网关。日志即运行时模型消息、工具调用、工具结果和终止事实都会记录到运行时事件日志中。会话、用户界面、模型上下文和恢复操作都是基于该日志的投影。上下文并非历史记录工具结果修剪和大语言模型LLM压缩会改变下一次推理时所看到的内容但不会将记录的证据视为一次性上下文。单一执行权限Runtime Host 负责会话、轮次、代理生命周期、延续性、工具和事件。评估模块仅负责实验语义和结果。如需了解完整设计请阅读《Maka 后端架构》。交互入口入口适用场景当前功能桌面端日常交互、文件和工件工作流、模型和权限设置基于 Electron React支持流式会话、工具时间线、分支、搜索和恢复功能TUI / CLI在当前项目目录中使用 Maka 或运行一次非交互式轮次命令如 maka、maka run与桌面端共享工作区和模型连接评估在 Maka 和外部主体间进行可重复的基准实验命令如 maka eval run --out当前功能代理运行时支持多种模型连接、流式输出、思考过程、使用情况统计和提供商错误规范化包含本地工具如读取、写入、编辑、Bash、全局搜索和 grep具备工具模式验证、动态可用性、权限策略、看门狗、中止和错误分类功能拥有运行时事件日志、代理运行账本、启动恢复、轮次证据、活动工具结果修剪和历史记录压缩功能。桌面工作区可从轮次创建、存档、搜索、重命名、重试、重新生成和分支会话提供工件列表和预览、工作区说明、模型设置和权限设置支持本地内存、网络搜索和机器人入口集成功能可独立配置并非所有实验入口默认可用。评估声明式多臂实验可扩展为任务×重复×主体单元格每个单元格的尝试不可变支持有针对性的基础设施替换和最早有效选择具备小型结果内核用于记录分数、规范化使用情况、可归因成本、持续时间、状态、失败原因和工件Maka 主体仅通过 Runtime Host 执行外部竞品使用通用外部主体适配器。快速开始下载 macOS 桌面版仅适用于 Apple Silicon Macarm64的签名和公证桌面应用程序可从 GitHub Releases 下载。下载 Maka--mac-arm64.dmg打开 DMG 文件并将 Maka 拖移到“应用程序”文件夹。使用 brew install ripgrep 安装 ripgrep 以启用运行时的 grep 工具。启动 Maka 并在“设置”→“模型”下配置自己的模型连接。此首个公开版本不包含计算机使用功能暂不支持 Intel Mac、Windows 和 Linux 软件包。Windows x64 预览版Windows 版本仍为未签名的预览版并非受支持的发布版本。当发布版本包含 Windows 资产时请在运行 Maka--win-x64.exe 之前遵循 Windows 预览版安装和验证指南。SmartScreen 会将安装程序识别为来自未知发布者除非下载的 SHA - 256 校验和与同一版本发布的校验和匹配否则请勿绕过该警告。系统要求Node.js 22.19 或更高版本持续集成使用 Node.js 24npm锁文件和脚本使用 npm当前包管理器为 npm 11Gitripgrep供运行时的 grep 工具使用启动桌面版git clone https://github.com/apache/maka.gitcd makanpm cinpm run devnpm run dev 会启动带有热模块替换HMR的桌面开发环境。若要在启动 Electron 之前构建所有工作区可使用 npm run dev:full。如果依赖项是使用 ELECTRON_SKIP_BINARY_DOWNLOAD1 安装的请在启动前安装 Electron 平台二进制文件node node_modules/electron/install.js。首次运行Maka 未捆绑共享模型账户。首次启动时打开“设置”→“模型”添加 API、本地模型或受支持的账户连接进行测试并选择默认模型然后返回工作区开始任务。应用会区分已配置、可发送和实验性连接状态。未接入运行时的账户流程不会被视为可用模型。终端入口有关公共 npm 包请参阅 CLI 安装和使用指南。以下命令可从源代码检出运行开发 CLI。首先构建工作区npm run build然后启动 TUI 或运行一次轮次npm run cli:devnpm run cli:dev -- run Summarize this repository and identify its most important risknpm run cli:dev -- run --graph Implement two independent slices, integrate them, then review the resultnpm run cli:dev -- --helpTUI 还支持 /graph on、/graph off 和 /graph 命令。非交互式 --graph 运行会等待持久图完成后再打印最终监督器输出。图实现操作符使用隔离的 Git 工作树因此源项目必须是干净的 Git 工作树。仓库 CLI 使用与开发桌面版相同的 Maka Dev 配置文件。发布的 maka 二进制文件继续使用 Maka 配置文件这两个配置文件不会自动复制或同步。评估规范和适配器位于 packages/eval 目录中。架构Desktop / TUI / CLI → Runtime Host → SessionManager → AgentRun↓Model Tool Runtime → Runtime Event Log↓Context / Session / UI projectionsExperiment → Cells → Attempts → Results↓Runtime Host 执行 Maka 主体从 ARCHITECTURE.md 开始了解它提供了系统地图、代码边界、面向问题的阅读路径和六个双语深度剖析。仓库布局apps/desktop/Electron 主程序/预加载脚本/React 渲染器packages/core/会话、事件、权限和连接的纯合约packages/storage/SQLite 操作状态、配置和有效负载存储packages/runtime/代理运行、模型适配器、工具、上下文和恢复packages/eval/实验单元格、尝试、结果和执行器/主体适配器packages/cli/TUI 和非交互式 CLIpackages/ui/共享对话、Markdown、工件和 UI 原语docs/架构、产品、安全、隐私和测试合约scripts/构建清理、视觉检查、冒烟测试和发布辅助工具本地数据和安全边界Maka 默认将工作区数据存储在 Electron 用户数据目录下/workspaces/default/包含 runtime.sqlite、connection-catalog.json、credential-vault.json、settings.json 和 artifacts/ 文件夹。当前连接目录为 connection-catalog.json。现有的 llm-connections.json 文件会保留在磁盘上不会被导入。会话、消息、执行账本、工作流、使用情况、自动化和每日回顾数据存储在 runtime.sqlite 中。运行时策略凭证包括连接 API/OAuth 材料、请求头、网络搜索密钥和代理密码以明文形式存储在本地的 credential-vault.json 中位于操作系统账户边界之后强制使用 POSIX 目录模式 0700 和文件模式 0600。Runtime Host 客户端配置文件访问凭证单独存储在 /runtime-host-client/credentials.json 中。现有的 Electron safeStorage 凭证/令牌文件不会被导入受影响的用户必须重新进行身份验证。渲染器不会接收明文凭证。文件写入、Shell 和危险工具调用会通过权限引擎进行处理评估模块不会构建运行时或读取运行时存储。Maka 主体连接到现有的 Runtime Host。有关安全报告和策略请阅读 SECURITY.md有关当前隐私和沙盒合约请阅读 docs/README.md。运行时存储和恢复runtime.sqlite 是唯一的操作权威它管理运行时事件、会话元数据和消息历史记录、代理图控制、核心执行状态、工作流状态、使用情况和定价、工件元数据、自动化、每日回顾和运行时延续记录。工件有效负载字节仍以常规文件形式存储在 artifacts/ 文件夹中连接、凭证、设置、MCP 配置、技能和设备标识仍以配置文件形式存在。此存储版本不会导入早期的文件/JSONL 权威数据。升级时旧版会话标题仍可通过当前元数据查找但仅存在于旧版转录文件中的对话历史记录不会复制到 session_messages 中会以空线程形式打开。同样旧版本或 safeStorage 加密的凭证/令牌文件不会迁移仅拥有这些副本的用户必须重新进行身份验证。此数据丢失边界是本次发布有意为之升级现有工作区前需谨慎考虑。完整的操作备份使用数据库所有者的在线 SQLite 备份 API并在工件写入器锁的保护下复制规范工件有效负载。其清单通过大小和 SHA - 256 绑定每个文件。验证过程会检查独立 SQLite 快照的完整性、外键、模式注册表和必需表解码规范会话消息和工件记录并在恢复前根据 SQLite 元数据验证工件有效负载大小。备份和恢复操作使用仅所有者可访问的文件模式、文件和目录同步、暂存和原子发布。运行时延续功能仍为可选设置 MAKA_RUNTIME_SAFE_BOUNDARY_RESUME1 可启用桌面端中断轮次的安全恢复操作、CLI/TUI 的 /resume 命令以及桌面端启动时的自动恢复功能。这些操作可能会调用已配置的模型提供商并消耗令牌仅在明确需要该行为时启用此标志。第二阶段将提供持久写入端边界和故障关闭安全边界延续功能。第三阶段的不确定工具副作用协调功能尚未实现模糊的工具结果将被搁置而非重试。开发和验证提交更改前请阅读 CONTRIBUTING.md。常见的仓库级命令如下npm run buildnpm run typechecknpm testnpm run check:release单独运行一个工作区的测试npm --workspace maka/runtime testnpm --workspace maka/eval testnpm --workspace maka/desktop test使用以下命令从 models.dev 更新 packages/core/src/model-metadata.generated.ts 并运行针对性测试。将特定访问路径的覆盖设置保留在 model-metadata.ts 中请勿手动编辑生成的文件。npm run sync:model-metadatanpm --workspace maka/core test桌面端真实窗口和视觉验证npm --workspace maka/desktop run e2enpm --workspace maka/desktop run smoke:real-window提交代码前运行类型检查、构建和与更改程度相称的针对性测试然后执行 git diff --check。文档文档索引和权限地图后端架构产品设计贡献指南安全策略许可证Maka 采用 Apache 许可证 2.0。有关归属信息请参阅 NOTICE。第三方组件仍受其各自的许可证和声明约束。对于 Maka 这款本地优先代理工作区工具你怎么看呢 Maka：本地优先代理工作区，多端交互与多样功能助力实际工作！
Maka为实际工作打造的本地优先代理工作区Maka 可不只是能回答问题它具备可控权限能检查项目、执行工具、生成工件还能将模型消息和工具调用保存为可恢复的执行事实。桌面端、终端 TUI、非交互式 CLI 以及 Maka 评估主体均通过 Runtime Host 执行。注意Maka 正在积极开发中。macOS Apple Silicon 桌面版是早期公开版本数据格式、CLI 命令和实验性功能可能仍会变动。为何选择本地优先而非托管优先默认情况下会话、设置和运行记录都保存在本地机器上。你可以自行选择模型连接方式云 API、本地模型或兼容网关。日志即运行时模型消息、工具调用、工具结果和终止事实都会记录到运行时事件日志中。会话、用户界面、模型上下文和恢复操作都是基于该日志的投影。上下文并非历史记录工具结果修剪和大语言模型LLM压缩会改变下一次推理时所看到的内容但不会将记录的证据视为一次性上下文。单一执行权限Runtime Host 负责会话、轮次、代理生命周期、延续性、工具和事件。评估模块仅负责实验语义和结果。如需了解完整设计请阅读《Maka 后端架构》。交互入口入口适用场景当前功能桌面端日常交互、文件和工件工作流、模型和权限设置基于 Electron React支持流式会话、工具时间线、分支、搜索和恢复功能TUI / CLI在当前项目目录中使用 Maka 或运行一次非交互式轮次命令如 maka、maka run与桌面端共享工作区和模型连接评估在 Maka 和外部主体间进行可重复的基准实验命令如 maka eval run --out当前功能代理运行时支持多种模型连接、流式输出、思考过程、使用情况统计和提供商错误规范化包含本地工具如读取、写入、编辑、Bash、全局搜索和 grep具备工具模式验证、动态可用性、权限策略、看门狗、中止和错误分类功能拥有运行时事件日志、代理运行账本、启动恢复、轮次证据、活动工具结果修剪和历史记录压缩功能。桌面工作区可从轮次创建、存档、搜索、重命名、重试、重新生成和分支会话提供工件列表和预览、工作区说明、模型设置和权限设置支持本地内存、网络搜索和机器人入口集成功能可独立配置并非所有实验入口默认可用。评估声明式多臂实验可扩展为任务×重复×主体单元格每个单元格的尝试不可变支持有针对性的基础设施替换和最早有效选择具备小型结果内核用于记录分数、规范化使用情况、可归因成本、持续时间、状态、失败原因和工件Maka 主体仅通过 Runtime Host 执行外部竞品使用通用外部主体适配器。快速开始下载 macOS 桌面版仅适用于 Apple Silicon Macarm64的签名和公证桌面应用程序可从 GitHub Releases 下载。下载 Maka--mac-arm64.dmg打开 DMG 文件并将 Maka 拖移到“应用程序”文件夹。使用 brew install ripgrep 安装 ripgrep 以启用运行时的 grep 工具。启动 Maka 并在“设置”→“模型”下配置自己的模型连接。此首个公开版本不包含计算机使用功能暂不支持 Intel Mac、Windows 和 Linux 软件包。Windows x64 预览版Windows 版本仍为未签名的预览版并非受支持的发布版本。当发布版本包含 Windows 资产时请在运行 Maka--win-x64.exe 之前遵循 Windows 预览版安装和验证指南。SmartScreen 会将安装程序识别为来自未知发布者除非下载的 SHA - 256 校验和与同一版本发布的校验和匹配否则请勿绕过该警告。系统要求Node.js 22.19 或更高版本持续集成使用 Node.js 24npm锁文件和脚本使用 npm当前包管理器为 npm 11Gitripgrep供运行时的 grep 工具使用启动桌面版git clone https://github.com/apache/maka.gitcd makanpm cinpm run devnpm run dev 会启动带有热模块替换HMR的桌面开发环境。若要在启动 Electron 之前构建所有工作区可使用 npm run dev:full。如果依赖项是使用 ELECTRON_SKIP_BINARY_DOWNLOAD1 安装的请在启动前安装 Electron 平台二进制文件node node_modules/electron/install.js。首次运行Maka 未捆绑共享模型账户。首次启动时打开“设置”→“模型”添加 API、本地模型或受支持的账户连接进行测试并选择默认模型然后返回工作区开始任务。应用会区分已配置、可发送和实验性连接状态。未接入运行时的账户流程不会被视为可用模型。终端入口有关公共 npm 包请参阅 CLI 安装和使用指南。以下命令可从源代码检出运行开发 CLI。首先构建工作区npm run build然后启动 TUI 或运行一次轮次npm run cli:devnpm run cli:dev -- run Summarize this repository and identify its most important risknpm run cli:dev -- run --graph Implement two independent slices, integrate them, then review the resultnpm run cli:dev -- --helpTUI 还支持 /graph on、/graph off 和 /graph 命令。非交互式 --graph 运行会等待持久图完成后再打印最终监督器输出。图实现操作符使用隔离的 Git 工作树因此源项目必须是干净的 Git 工作树。仓库 CLI 使用与开发桌面版相同的 Maka Dev 配置文件。发布的 maka 二进制文件继续使用 Maka 配置文件这两个配置文件不会自动复制或同步。评估规范和适配器位于 packages/eval 目录中。架构Desktop / TUI / CLI → Runtime Host → SessionManager → AgentRun↓Model Tool Runtime → Runtime Event Log↓Context / Session / UI projectionsExperiment → Cells → Attempts → Results↓Runtime Host 执行 Maka 主体从 ARCHITECTURE.md 开始了解它提供了系统地图、代码边界、面向问题的阅读路径和六个双语深度剖析。仓库布局apps/desktop/Electron 主程序/预加载脚本/React 渲染器packages/core/会话、事件、权限和连接的纯合约packages/storage/SQLite 操作状态、配置和有效负载存储packages/runtime/代理运行、模型适配器、工具、上下文和恢复packages/eval/实验单元格、尝试、结果和执行器/主体适配器packages/cli/TUI 和非交互式 CLIpackages/ui/共享对话、Markdown、工件和 UI 原语docs/架构、产品、安全、隐私和测试合约scripts/构建清理、视觉检查、冒烟测试和发布辅助工具本地数据和安全边界Maka 默认将工作区数据存储在 Electron 用户数据目录下/workspaces/default/包含 runtime.sqlite、connection-catalog.json、credential-vault.json、settings.json 和 artifacts/ 文件夹。当前连接目录为 connection-catalog.json。现有的 llm-connections.json 文件会保留在磁盘上不会被导入。会话、消息、执行账本、工作流、使用情况、自动化和每日回顾数据存储在 runtime.sqlite 中。运行时策略凭证包括连接 API/OAuth 材料、请求头、网络搜索密钥和代理密码以明文形式存储在本地的 credential-vault.json 中位于操作系统账户边界之后强制使用 POSIX 目录模式 0700 和文件模式 0600。Runtime Host 客户端配置文件访问凭证单独存储在 /runtime-host-client/credentials.json 中。现有的 Electron safeStorage 凭证/令牌文件不会被导入受影响的用户必须重新进行身份验证。渲染器不会接收明文凭证。文件写入、Shell 和危险工具调用会通过权限引擎进行处理评估模块不会构建运行时或读取运行时存储。Maka 主体连接到现有的 Runtime Host。有关安全报告和策略请阅读 SECURITY.md有关当前隐私和沙盒合约请阅读 docs/README.md。运行时存储和恢复runtime.sqlite 是唯一的操作权威它管理运行时事件、会话元数据和消息历史记录、代理图控制、核心执行状态、工作流状态、使用情况和定价、工件元数据、自动化、每日回顾和运行时延续记录。工件有效负载字节仍以常规文件形式存储在 artifacts/ 文件夹中连接、凭证、设置、MCP 配置、技能和设备标识仍以配置文件形式存在。此存储版本不会导入早期的文件/JSONL 权威数据。升级时旧版会话标题仍可通过当前元数据查找但仅存在于旧版转录文件中的对话历史记录不会复制到 session_messages 中会以空线程形式打开。同样旧版本或 safeStorage 加密的凭证/令牌文件不会迁移仅拥有这些副本的用户必须重新进行身份验证。此数据丢失边界是本次发布有意为之升级现有工作区前需谨慎考虑。完整的操作备份使用数据库所有者的在线 SQLite 备份 API并在工件写入器锁的保护下复制规范工件有效负载。其清单通过大小和 SHA - 256 绑定每个文件。验证过程会检查独立 SQLite 快照的完整性、外键、模式注册表和必需表解码规范会话消息和工件记录并在恢复前根据 SQLite 元数据验证工件有效负载大小。备份和恢复操作使用仅所有者可访问的文件模式、文件和目录同步、暂存和原子发布。运行时延续功能仍为可选设置 MAKA_RUNTIME_SAFE_BOUNDARY_RESUME1 可启用桌面端中断轮次的安全恢复操作、CLI/TUI 的 /resume 命令以及桌面端启动时的自动恢复功能。这些操作可能会调用已配置的模型提供商并消耗令牌仅在明确需要该行为时启用此标志。第二阶段将提供持久写入端边界和故障关闭安全边界延续功能。第三阶段的不确定工具副作用协调功能尚未实现模糊的工具结果将被搁置而非重试。开发和验证提交更改前请阅读 CONTRIBUTING.md。常见的仓库级命令如下npm run buildnpm run typechecknpm testnpm run check:release单独运行一个工作区的测试npm --workspace maka/runtime testnpm --workspace maka/eval testnpm --workspace maka/desktop test使用以下命令从 models.dev 更新 packages/core/src/model-metadata.generated.ts 并运行针对性测试。将特定访问路径的覆盖设置保留在 model-metadata.ts 中请勿手动编辑生成的文件。npm run sync:model-metadatanpm --workspace maka/core test桌面端真实窗口和视觉验证npm --workspace maka/desktop run e2enpm --workspace maka/desktop run smoke:real-window提交代码前运行类型检查、构建和与更改程度相称的针对性测试然后执行 git diff --check。文档文档索引和权限地图后端架构产品设计贡献指南安全策略许可证Maka 采用 Apache 许可证 2.0。有关归属信息请参阅 NOTICE。第三方组件仍受其各自的许可证和声明约束。对于 Maka 这款本地优先代理工作区工具你怎么看呢