如何快速上手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/makaMaka 是一个本地优先local-first的 AI Agent 工作台而它的本地长期记忆功能可以真正解决AI 每次对话都失忆的痛点你的偏好、项目事实和个人习惯会保存在本机的透明 Markdown 文件MEMORY.md里而不是上传到某个云端记忆服务。只要打开模型上下文可读取开关Maka 在每次发送消息时都会把生效的记忆一并提供给模型AI 助手从此记得住你。本文带你 5 分钟完成从零到AI 记住你的完整上手流程。为什么选择本地记忆透明、可控、隐私优先很多 AI 助手的记忆是黑盒——你不知道它记了什么、存在哪。Maka 走的是白盒记忆路线透明文件记忆就是一个普通的MEMORY.md文件保存在本机工作区你可以随时用任何编辑器打开、修改、删除默认保守文件存在 ≠ 模型可读模型上下文可读取开关默认关闭只有你明确开启后记忆才会进入模型上下文隐身模式兜底开启隐身模式的会话中本地记忆永远不会被提供给模型敏感字段自动遮蔽写入前会先遮蔽疑似 token、API key 或密码避免密钥被记住。核心契约定义在 packages/core/src/local-memory.ts产品行为文档见 docs/archive/maka-memory-whitebox-contract.md。快速开启步骤设置里的两个开关打开 Maka 桌面端进入设置 → 记忆你会看到两个核心开关开关默认值作用启用本地 MEMORY.md开创建并维护工作区内的记忆文件允许模型上下文读取本地记忆关开启后发送消息时记忆才一并提供给模型 想立刻体验只需两步保持第一个开关为开 → 打开第二个开关。之后的每条消息模型都会自动携带你的生效记忆。设置界面代码位于 apps/desktop/src/renderer/settings/memory-settings-page.tsx文案定义在 apps/desktop/src/renderer/locales/settings-memory-copy.ts想深入了解界面行为可以顺着这里读。手动添加记忆标题、标签、内容三要素在记忆设置页点击右上角添加记忆填写三部分内容记忆标题一句话概括比如偏好中文回复记忆标签可选逗号分隔如偏好,沟通便于筛选记忆内容要保留的偏好或事实比如用户是一名前端工程师惯用 TypeScript React代码注释请用中文。保存后这条记忆立即写入本机的 MEMORY.md。每条记忆都有生命周期状态生效active发送消息时会提供给模型已归档archived保留在文件中但不再进入模型上下文随时可恢复。页面还提供模型上下文预览面板让你逐字确认下次发送时模型到底能看到什么——这种所见即所得的透明度是本地记忆功能最实用的安全特性之一。自动提取让 AI 从对话中主动记住你除了手动添加Maka 还内置了长期记忆自动提取0.1.7 版本起提供有界提取能力Agent 在对话过程中识别出值得长期保留的偏好、身份、上下文、知识等条目提取结果会先作为待确认提案展示由你确认后才会正式写入而不是悄悄入库确认后的条目进入 SQLite 长期记忆存储支持创建、更新、归档、恢复等原子变更并能追溯到来源会话与回合。相关实现分布在三个模块方便你按图索骥提取逻辑packages/runtime/src/memory-extraction.ts条目契约类型、作用域、生命周期packages/core/src/long-term-memory.tsSQLite 存储packages/storage/src/sqlite-long-term-memory-store.ts 建议用法先手动写几条核心偏好语言、技术栈、工作习惯再开启自动提取让对话中产生的新事实逐步沉淀成确认提取来源的记忆条目。安全与容量边界这些细节值得知道容量上限MEMORY.md 超过 128 KB 会进入安全模式——文件仍可编辑但暂停注入模型上下文提示你删减旧内容文件权限目录 0700、文件 0600只有当前系统账号可访问备份与恢复每次保存或重置前都会自动生成上一版备份支持一键恢复到任意备份候选恢复前还会再留一份restore.bak隐私红线隐身模式incognito下记忆读取一律失败关闭fail closed即使两个开关都开着也不例外。上手检查清单设置 → 记忆中启用本地 MEMORY.md已开启允许模型上下文读取本地记忆已打开手动添加了 2~3 条最关键的偏好记忆在模型上下文预览里确认了注入内容验证隐身模式下记忆不会被注入完成以上 5 步你的 Maka 就完成了一个从每次从零开始到越用越懂你的转变。想从源码层面理解整个记忆链路建议从 packages/core/src/local-memory.ts 的解析器读起再延伸到 packages/runtime/src/memory-extraction-proposal.ts 的提案确认流程这正是 Maka白盒记忆哲学的完整体现。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考