企业官网建设流程全解析

Maka Agent卸载与数据清理完全指南：如何彻底删除或迁移AI工作区

【免费下载链接】makaApache Maka (Incubating) is a local-first AI agent workspace. Model messages, tool calls, tool results, permission decisions, and termination events are recorded as an append-only log.项目地址: https://gitcode.com/GitHub_Trending/mak/maka

Maka（Apache 孵化项目）是一个本地优先的 AI Agent 工作区：会话消息、工具调用、权限决策和终止事件都会以追加日志的形式保存在本机。如果你准备不再使用它，或者要换一台电脑继续用，本文就是 Maka Agent 卸载与数据清理的完整指南——带你在几分钟内彻底删除桌面应用与 CLI，安全清理 AI 工作区数据，或在迁移时把会话原封不动带走。

🧭 卸载前先搞清楚：Maka 的数据都放在哪里？

Maka 是本地优先设计，不依赖任何云端托管。模型连接、API Key 凭证、会话记录和生成的 Artifact 全部存放在本机的Profile 目录中：

这些路径的解析逻辑可以在源码 packages/storage/src/workspace-root.ts 中找到。每个 AI 工作区位于 Profile 下的workspaces/<工作区名>子目录，卸载程序本身不会删除这些数据——这正是"彻底删除"和"保留数据换机"两条路线分叉的地方。

💡 上面这张是 Maka 的配置界面：工作区级的 MCP 配置同样保存在 Profile 中，删除 Profile 即一并清除。

🧹 彻底删除：Maka 完整卸载三步走

第 1 步：关闭所有 Maka 程序

先完全退出 Desktop 应用和终端里的makaCLI，避免写入中的日志文件被占用。

第 2 步：移除托管 Runtime Host 服务与 CLI

如果在 Linux 上安装过托管的 Runtime Host 服务，必须先删服务，再卸 npm 包，否则 systemd 会留下一个指向已删除 CLI 的 unit：

# 仅当安装过 managed Runtime Host service（Linux） npx --yes maka-agent@next runtime-host service uninstall # 如果曾全局安装 Maka CLI npm uninstall --global maka-agent

这两条命令都不会删除模型连接、凭证、会话或 Artifact。命令说明见 packages/cli/README.zh-CN.md 的"卸载"章节。

第 3 步：删除桌面应用本体

• macOS：将"应用程序"文件夹中的 Maka 拖入废纸篓，再清空废纸篓；
• Windows：通过系统"应用和功能"卸载，或删除安装目录中的 Maka 程序文件。

至此程序本体已经清除，但你的 AI 工作区数据仍在。

🗑️ 数据清理：备份后彻底删除本地数据

只有在确实要删除全部本地 Maka 数据时才做这一步，顺序是"先备份、再删除"：

# 1. 备份（以 Linux 为例，替换为你平台的 Profile 路径） cp -r ~/.config/Maka ~/maka-backup # 2. 确认备份无误后，将备份目录移出，然后删除 Profile 目录 # macOS: ~/Library/Application Support/Maka # Linux: ~/.config/Maka # Windows: %APPDATA%\Maka

⚠️ 删除前再次确认已关闭 CLI 和 Desktop 应用。删除该目录后，模型连接、API Key、所有会话与 Artifact 将不可恢复。

只想删某个工作区？只删除workspaces/<工作区名>这一个子目录即可，其余设置和其他会话不受影响。

📦 数据迁移：换电脑时如何带走 AI 工作区

Maka 的数据都是本地文件，迁移非常直接：

1. 旧机器：关闭应用，把整个 Profile 目录压缩打包（重点包含workspaces子目录）；
2. 新机器：安装对应平台的 Maka（桌面版可从发布渠道获取，CLI 则执行npm install --global maka-agent@next）；
3. 恢复：先启动一次应用生成目录结构，然后退出，把打包的 Profile 内容复制回新机器的对应路径；
4. 重新启动 Maka，模型连接、会话历史与 Artifact 都会原样回来。

会话数据本身采用打包机制存储，相关实现见 packages/storage/src/session-bundle-file-service.ts；架构细节可参考 docs/architecture/runtime-resume-architecture.zh-CN.md。

❓ 常见问题速查

按以上步骤操作，你就能在"彻底删除"和"无损迁移"之间从容选择——你的工作，始终在你的数据里。

【免费下载链接】makaApache Maka (Incubating) is a local-first AI agent workspace. Model messages, tool calls, tool results, permission decisions, and termination events are recorded as an append-only log.项目地址: https://gitcode.com/GitHub_Trending/mak/maka