【免费下载链接】loki-mode
Autonomous software factory. Give it a GitHub issue, a spec or a one-line task; get back a pull request with a signed receipt anyone can re-check offline. Runs on your machine with your own keys: Claude, Codex, OpenCode.
Loki Mode 是一款自治软件工厂(Autonomous software factory),它内置了一套三层记忆系统,让 AI Agent 能够跨会话、跨项目持续学习:每次任务结束后自动沉淀经验,下次遇到相似问题时直接调取已验证的模式,从源头避免重复踩坑。
为什么记忆是 AI Agent 的最大痛点?
大多数 AI Agent 的"失忆"问题,根源往往不在推理能力,而在上下文检索。官方在 references/memory-system.md 中引用了一个核心观点:
"Your Agent's Reasoning Is Fine - Its Memory Isn't"(你的 Agent 推理没问题——是记忆不行)
一个推理能力完美但记忆糟糕的 Agent 会:
- 🔁 反复重新发现相同的设计模式
- 👀 错过相关的历史经验
- 🚧 无法应用已学到的"反面模式"(anti-patterns)
- 📉 在会话边界处丢失上下文
而拥有良好记忆的 Agent,会在行动前检索相关模式、规避曾遇到的失败、复用成功做法。这正是 Loki Mode 把记忆架构作为核心竞争力的原因。
四层记忆架构:从"发生了什么"到"下次怎么做"
Loki Mode 借鉴了 MIRIX、MemGPT、AriGraph 等 2025 年研究,构建了分层记忆体系,所有数据落在本地.loki/memory/目录,由 git 版本化管理:
.loki/memory/ ├── episodic/ # 情景记忆:任务执行完整轨迹 │ └── 2026-01-06/task-001.json ├── semantic/ # 语义记忆:泛化出的模式与事实 │ ├── patterns.json │ ├── anti-patterns.json │ └── links.json # Zettelkasten 风格的知识链接 ├── skills/ # 程序记忆:可复用的技能模板 ├── handoffs/ # Agent 之间的交接记录 └── learnings/ # 从错误中提取的经验| 记忆层 | 回答的问题 | 存储位置 |
|---|---|---|
| 工作记忆 | "我现在正在做什么?" | CONTINUITY.md(每轮更新) |
| 情景记忆 | "上次我尝试 X 时发生了什么?" | .loki/memory/episodic/ |
| 语义记忆 | "X 这类事情一般怎么解决?" | .loki/memory/semantic/ |
| 程序记忆 | "如何成功地把 X 做出来?" | .loki/memory/skills/ |
编排整个体系的核心是 memory/engine.py 中的MemoryEngine类,它对外提供统一的记忆读写接口。
经验固化管道:自动把踩过的坑变成知识
记忆不是记完就完了,关键在于固化(consolidation)——把"某次具体经历"提炼成"通用知识"。这个过程由 memory/consolidation.py 的ConsolidationPipeline在任务完成后、空闲时或阶段边界自动执行:
- 聚相似:把 24 小时内的经历按相似度聚类
- 提模式:同一类经历出现 2 次以上,就提炼成一个语义模式,并记录置信度(
confidence) - 存反例:从错误中单独提取"反面模式"——什么做法会失败、为什么、如何预防
- 建链接:借鉴卡片盒笔记法(Zettelkasten),为每条知识建立
derived_from、contradicts、supersedes等关系链接
举个例子,一次任务中 Agent 在 TypeScript strict 模式下写 Express 路由漏掉返回类型、测试失败后补上: void。固化后,这条经历会变成一条带 0.95 置信度的语义模式,并关联回原始情景记录,下次写路由前就能直接命中。
任务感知检索:不同任务,调不同记忆
"什么都记"不等于"什么都用"。Loki Mode 的亮点是任务感知检索(Task-Aware Retrieval):先判断当前处于哪种工作阶段,再按不同权重组合各层记忆。权重配置在 memory/engine.py 的TASK_STRATEGIES中:
| 任务阶段 | 情景记忆 | 语义记忆 | 技能 | 反面模式 |
|---|---|---|---|---|
| 🔍 exploration(探索) | 0.60 | 0.30 | 0.10 | 0.00 |
| ⚙️ implementation(实现) | 0.15 | 0.50 | 0.35 | 0.00 |
| 🐛 debugging(调试) | 0.40 | 0.20 | 0.00 | 0.40 |
| 👀 review(评审) | 0.30 | 0.50 | 0.00 | 0.20 |
| ♻️ refactoring(重构) | 0.25 | 0.45 | 0.30 | 0.00 |
直觉很好懂:探索阶段靠"过往经历"找线索;调试阶段则重点翻"踩坑记录"(反面模式权重高达 0.4);实现阶段则依赖泛化模式 + 成熟技能。该策略基于 MemEvolve 研究,相比静态权重可带来约 17% 的效果提升。
跨项目学习:让经验在项目之间流动
单项目记忆只是开始。Loki Mode 通过两条路径实现跨项目学习:
- 本地项目索引:memory/cross_project.py 的
CrossProjectIndex会扫描~/git、~/projects、~/src等目录,找出所有带.loki/memory/的项目并建立统一索引,新会话可以检索其他项目的历史模式 - 全局经验库:每次会话结束时,系统分析
CONTINUITY.md提取三类经验——可复用模式(patterns)、要规避的错误(mistakes)、有效做法(successes),用 MD5 哈希去重(官方称可减少 71% 重复),存入~/.loki/learnings/。更进一步的"知识复利"机制还会把有价值的解法沉淀为带标签的结构化 solution 文档,按 security / performance / architecture 等 7 个类别组织,在 REASON 阶段自动匹配注入
此外,开启托管记忆(Managed Memory,LOKI_MANAGED_MEMORY=true,默认关闭)后,高重要度(importance ≥ 0.6)的经验会被影子写入云端存储,让新项目也能只读访问组织级沉淀的模式和技能,详见 skills/memory.md。
实操指南:5 步快速查看与管理 Agent 的记忆
无需阅读源码,用 CLI 就能直接检查记忆:
# 1. 查看所有跨项目经验 loki memory list # 2. 按类型查看(patterns / mistakes / successes) loki memory show patterns --limit 10 # 3. 按关键词搜索 loki memory search "authentication" # 4. 查看记忆统计(按类别、按项目) loki memory stats # 5. 备份导出 loki memory export ./learnings-backup.json几个新手建议:
- 📂 直接打开
.loki/memory/semantic/anti-patterns.json,看看 Agent 给自己记了哪些"不要做" - 🧠 用
loki memory stats观察经验是否随项目积累增长——这是"学习曲线"最直观的指标 - 🛡️ 注入提示词前,所有记忆字段都会经过 memory/rag_injector.py 的清洗(剥离控制字符、禁用结构标记),防止记忆条目伪装成指令,可放心把记忆接入工作流
总结
Loki Mode 记忆系统的设计可以浓缩成一张链路:
任务经历(episodic) → 固化提炼(consolidation) → 模式/技能/反例(semantic+skills) ↑ ↓ 任务感知检索 ←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←对新手来说,理解它只需抓住三点:分层存储(经历、知识、技能分开管)、自动固化(经验不靠手动总结,管道自己跑)、按任务取用(调试时多翻坑,实现时多看模式)。掌握了这套机制,你就能把 AI Agent 从"每次都从零开始的临时工",变成"越用越懂你项目的老员工"。
更多细节可参阅 references/memory-system.md、wiki/Cross-Project-Learning.md 与 wiki/Knowledge-Compounding.md。
【免费下载链接】loki-mode
Autonomous software factory. Give it a GitHub issue, a spec or a one-line task; get back a pull request with a signed receipt anyone can re-check offline. Runs on your machine with your own keys: Claude, Codex, OpenCode.
相关推荐
deepagentsjs记忆系统指南:memory与AGENTS.md如何让Agent跨会话记住偏好
deepagentsjs记忆系统指南:memory与AGENTS.md如何让Agent跨会话记住偏好 deepagentsjs 记忆系统 是这款"开箱即用"Ag
为什么每个AI Agent都在重复踩坑?agent-beacon跨平台记忆层终极解析
为什么每个AI Agent都在重复踩坑?agent beacon跨平台记忆层终极解析 agent beacon 是一个开源的 AI Agent 跨平台记忆层 ,
Prismer Cloud 记忆层完全指南:让 AI Agent 拥有跨会话的持久记忆
Prismer Cloud 记忆层完全指南:让 AI Agent 拥有跨会话的持久记忆 🧠 Prismer Cloud 记忆层(Memory Layer) 是
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考