cortexkit/magic-context

解决的问题

编码代理经常遭受“前向性遗忘”的困扰，即每次新任务都在没有先前决策、约束或项目历史记忆的情况下从零开始。标准的上下文压缩也可能通过强制暂停以重新读取历史记录，从而中断代理的工作流。Magic Context 提供了一种持久的、自我管理的记忆，使代理能够成为长期的队友，而不是一次性的承包商。

工作原理

Magic Context 通过三个主要过程充当代理的“海马体”：

• Capture（捕获）： 后台的“historian”将原始对话历史压缩为分层、按时间顺序排列的摘要（隔间），并将持久知识（如架构决策或项目规则）提取到永久项目记忆中。
• Consolidate（整合）： 可选的“dreamer”代理在空闲时间运行，用于根据代码库验证记忆、删除重复项并更新文档。
• Recall（召回）： 系统会自动将相关的记忆和压缩后的历史记录注入到活动上下文窗口中。代理还可以显式地搜索记忆、对话历史和 git commits。

适用对象

专为使用编码代理框架（特别是 OpenCode 和 Pi）并希望在不丢失项目上下文或受上下文窗口限制影响的情况下，保持连续、长期会话的开发人员设计。

亮点

• 无限制会话： 在后台管理上下文，因此代理无需因压缩暂停而停止工作。
• 自我组织记忆： 自动将重要的决策和惯例提升到可搜索的项目记忆中。
• 跨会话持久性： 记忆和上下文在不同的会话和不同的代理框架之间保持持久。
• 缓存感知操作： 旨在保持提示词缓存稳定性，以降低成本和延迟。
• 桌面管理： 包括一个配套的桌面应用，通过 GUI 浏览和编辑记忆及会话历史。