cortexkit/magic-context

Magic Context – 编码代理的海马体

它是什么 – Magic Context 是位于 CortexKit 生态系统内的插件。它为大型语言模型编码代理提供自我管理的长期记忆，使单个会话可持续运行数周或数月，而无需常见的“压缩暂停”迫使代理遗忘部分对话。

运作方式

• 捕获 – 代理工作时，后台 历史记录器 读取完整聊天日志，提取持久知识（设计决策、约束、命名约定等），并存储在 项目记忆 数据库中。
• 整合 – 可选的 梦境器 在空闲时间（夜间）运行，根据当前代码库验证这些记忆，合并重复项，更新文档，并将有用的观察提升到用户配置文件。
• 回忆 – 每次轮询时，代理自动接收最相关的记忆和对话的压缩视图。它也可以调用工具，如 ctx_search、ctx_expand、ctx_memory 和 ctx_note，按需检索或编辑信息。

主要功能

• 自我管理上下文 – 无需外部压缩插件；Magic Context 停用任何竞争的上下文管理钩子，并执行缓存稳定的缩减。
• 分层历史记录器分区 – 较旧的消息被摘要为加权摘要，保持实时提示窗口小，同时保留线程。
• 跨框架支持 – 适用于 OpenCode、Pi 和 Oh‑My‑Pi (OMP)；记忆在这些环境之间共享。
• 可配置模型 – 您为历史记录器选择便宜模型，并为梦境器选择可选模型；嵌入默认为本地 MiniLM 模型。
• CLI 向导 – npx @cortexkit/magic-context@latest setup 检测您的环境，安装正确的插件（@cortexkit/opencode-magic-context、@cortexkit/pi-magic-context 等），并停用冲突的压缩设置。
• 诊断 – npx @cortexkit/magic-context@latest doctor 检查冲突，验证数据库，并可自动修复常见问题。

典型工作流程

1. 运行设置向导（或手动将插件添加到 opencode.jsonc）。
2. 为历史记录器提供模型 ID（例如，provider/model-id）。
3. 开始编码；历史记录器静默建立记忆存储。
4. 可选启用梦境器以执行夜间维护。
5. 在会话期间使用 /ctx‑search、/ctx‑note 等查询或编辑记忆。

为何重要 – 没有 Magic Context，每个编码代理会话从空白开始，并定期暂停以压缩上下文，失去连续性。Magic Context 将一次性代理转变为长期队友，记住决策、代码约定和过去的讨论，减少重复提示并提高生产力。

---

快速开始摘要

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/cortexkit/magic-context/master/scripts/install.sh | bash
# Windows PowerShell
irm https://raw.githubusercontent.com/cortexkit/magic-context/master/scripts/install.ps1 | iex
# 或任何操作系统通过 npx
npx @cortexkit/magic-context@latest setup

将插件添加到您的框架配置，创建包含历史记录器模型的 magic-context.jsonc，即可开始使用。

---

CortexKit 的一部分 – Magic Context 是“海马体”部分；与 AFT（感觉运动皮层）和即将推出的 Alfonso（前额叶皮层）一起，形成自主编码代理的全脑套件。