尧图网页设计 
如何让AI记住你的项目Magic Context记忆系统完全教程5大记忆分类详解【免费下载链接】magic-contextUnbounded context. Memory that manages itself. One session, for life. The hippocampus for coding agents, part of CortexKit.项目地址: https://gitcode.com/gh_mirrors/mag/magic-context你是否经历过每次新开一个 AI 编程会话都要重新解释项目结构、反复叮嘱同样的规范AI 却失忆得干干净净Magic Context是一个给编程 Agent 装上海马体的记忆系统插件——它让你的 AI 跨会话记住项目规则、架构决策、配置值与命名约定一个会话可以用上几个月甚至几年。本教程面向新手带你看懂它的安装方法、工作流程以及核心的5 大记忆分类项目规则、架构、约束、配置值、命名。为什么 AI 总是金鱼记忆普通的 AI 编程会话就像一次性雇佣的临时工会话一结束记忆清零上次调过的参数、踩过的坑下次全要重新说一遍长对话会压缩失忆上下文满了触发 compaction压缩AI 冷不丁停住、丢信息、打断你的节奏知识无法沉淀花了 20 轮才弄清的一条约束换个会话又得再花 20 轮。Magic Context 的解法分三步捕获Capture→ 巩固Consolidate→ 回忆Recall。后台的历史学家Historian在你正常干活的同时自动把值得保留的知识提炼成项目记忆夜间的做梦者Dreamer负责查重、校验、归档每一轮对话开始时相关记忆自动注入给 AI。一键安装最省心的上手步骤不需要写任何代码一条命令启动交互式安装向导它会自动检测你使用的宿主OpenCode、Pi、OMP、配置模型、处理与其他插件的冲突npx cortexkit/magic-contextlatest setup指定宿主可以用--harness opencode、--harness pi或--harness omp。安装完成后重启宿主即可。遇到问题时运行诊断修复命令npx cortexkit/magic-contextlatest doctor配置只需一个文件magic-context.jsonc项目级放在.cortexkit/magic-context.jsonc用户级放在~/.config/cortexkit/magic-context.jsonc。其中必填项只有历史学家模型例如{ historian: { opencode: { model: provider/model-id } } }完整的配置项记忆开关、注入预算、向量嵌入、自动搜索等详见 CONFIGURATION.md。5 大记忆分类详解AI 如何给知识归档Magic Context 的每条记忆都是一句简短、可独立成立的项目级事实写入时必须归入以下 5 个分类之一源码定义见 constants.ts完整类型定义见 types.ts。这套分类学就是让 AI记得清楚的关键——不同性质的知识分开存放回忆时才能精准命中。分类一PROJECT_RULES项目规则在这个项目里必须怎么做的行为准则。例如所有数据库写入必须使用单个 BEGIN IMMEDIATE 事务、提交信息必须以模块名开头特点是项目里的硬性规定AI 在动手前会优先参考系统还会保护这类记忆不被随意改写——做梦者在校验时若发现它想删除一条规则会直接拒绝该操作见 memory-claim-safety分类二ARCHITECTURE架构事实这个项目是怎么搭起来的。例如订单模块采用事件溯源Event Sourcing、记忆存储在 SQLite 的 context.db 中特点描述系统级的结构性事实帮助 AI 在改代码时不破坏整体设计新会话开始时AI 靠这类记忆快速建立对项目的空间感分类三CONSTRAINTS约束有什么坑不能踩、什么限制必须知道。例如bun:sqlite 不能加载扩展向量只能用 Float32Array 余弦相似度比较特点往往是花了很多轮才挖出来的血泪经验最值得永久记住在跨项目协作workspace场景下CONSTRAINTS是默认唯一会跨仓库只读共享的分类见 memory-and-search.md分类四CONFIG_VALUES配置值关键配置的当前取值。例如默认嵌入模型是 Xenova/all-MiniLM-L6-v2、注入预算默认 4000 token特点配置值最容易过期改口因此当事实变化时系统会用更新旧记忆而不是新增一条来处理避免新旧值打架分类五NAMING命名约定东西该怎么命名才符合项目习惯。例如记忆分类名使用全大写下划线格式、隐藏子会话统一用 magic-context- 前缀特点AI 写新文件、新函数时直接沿用你的命名风格输出更像团队写的新手建议你不需要手动记这 5 个分类的名字。历史学家会自动把提炼出的事实分到对应类别如果你想手动补一条只要让 AI 调用ctx_memory工具并指定category即可非法分类会在写入校验时直接被拦下。记忆是如何产生的三条写入通道Magic Context 的记忆不靠你手动维护它有三个写入者见 memory-and-search.md历史学家自动晋升默认开启后台历史学家压缩旧对话时顺手把其中的持久性知识决策、约束、约定、配置值提炼成facts并晋升为项目记忆机制见 historian.md。你正常干活记忆免费生成。Agent 主动写入AI 通过ctx_memory工具执行write/update/archive/merge/get操作工具实现位于 ctx-memory 目录。做梦者维护写入Dreamer 在夜间整理、合并、修复记忆。写入时会做精确哈希去重同一事实再次出现时只累加seen_count被看见次数不会插入重复行被检索 3 次以上的记忆会自动晋升为permanent永久状态。记忆如何被维护Dreamer 的夜间睡眠就像人类睡眠巩固记忆Dreamer 定时默认夜间运行一组后台任务保证记忆池不腐化任务列表见 dreamer.md任务作用map-memories把每条记忆映射到支撑它的代码文件verify/verify-broad对照当前代码重新校验记忆修正或删除过时事实curate逐个分类清理合并重复、精简措辞、归档低价值条目classify-memories给记忆打重要性、作用域和可共享性评分手动触发一次维护在会话中输入/ctx-dream。你完全不用盯着它——它只在空闲时运行配本地慢速模型也很合适。记忆如何被想起来注入与搜索自动注入每轮对话活跃的项目记忆会以project-memory区块的形式出现在 AI 的提示里形如#id: 事实的紧凑行。会话中新产生的记忆通过增量方式补齐不会破坏提示缓存。主动搜索AI 随时可以用ctx_search一把梭检索 5 类来源——项目记忆、原始对话历史、git 提交、笔记notes和预置问题primers语义向量 全文双路召回。例如ctx_search(query为什么订单模块选了事件溯源)还有个贴心功能默认开启的auto_search会在你发出新消息时后台先搜一把命中相关记忆就给 AI 追加一句模糊回忆提示像人脑里突然闪过这事我好像记过。常见配置速查新手最关心的 4 项配置默认说明memory.enabledtrue总开关。关闭后ctx_memory隐藏、记忆不再注入memory.auto_promotetrue历史学家自动晋升事实。关闭后记忆只能靠 AI 手动写memory.injection_budget_tokens4000每轮注入记忆的 token 预算500–20000embedding.providerlocal语义搜索的向量来源off可退回纯关键词搜索写在最后把 AI 当长期队友而不是临时工Magic Context 的核心承诺只有一句话你的 Agent 永不因管理上下文而停摆也永不遗忘。装好之后对一个项目保持同一个会话运行几周、几个月它会带着全部积累的记忆继续工作——项目规则、架构决策、配置值、约束、命名约定五大分类各归其位夜间自动体检更新。想深入细节推荐阅读 记忆与搜索架构文档、历史学家文档、做梦者文档 和 完整配置参考。现在就装上它让下一次会话的 AI 记得你上一次会话教过它的一切。【免费下载链接】magic-contextUnbounded context. Memory that manages itself. One session, for life. The hippocampus for coding agents, part of CortexKit.项目地址: https://gitcode.com/gh_mirrors/mag/magic-context创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何让AI记住你的项目：Magic Context记忆系统完全教程（5大记忆分类详解）
如何让AI记住你的项目Magic Context记忆系统完全教程5大记忆分类详解【免费下载链接】magic-contextUnbounded context. Memory that manages itself. One session, for life. The hippocampus for coding agents, part of CortexKit.项目地址: https://gitcode.com/gh_mirrors/mag/magic-context你是否经历过每次新开一个 AI 编程会话都要重新解释项目结构、反复叮嘱同样的规范AI 却失忆得干干净净Magic Context是一个给编程 Agent 装上海马体的记忆系统插件——它让你的 AI 跨会话记住项目规则、架构决策、配置值与命名约定一个会话可以用上几个月甚至几年。本教程面向新手带你看懂它的安装方法、工作流程以及核心的5 大记忆分类项目规则、架构、约束、配置值、命名。为什么 AI 总是金鱼记忆普通的 AI 编程会话就像一次性雇佣的临时工会话一结束记忆清零上次调过的参数、踩过的坑下次全要重新说一遍长对话会压缩失忆上下文满了触发 compaction压缩AI 冷不丁停住、丢信息、打断你的节奏知识无法沉淀花了 20 轮才弄清的一条约束换个会话又得再花 20 轮。Magic Context 的解法分三步捕获Capture→ 巩固Consolidate→ 回忆Recall。后台的历史学家Historian在你正常干活的同时自动把值得保留的知识提炼成项目记忆夜间的做梦者Dreamer负责查重、校验、归档每一轮对话开始时相关记忆自动注入给 AI。一键安装最省心的上手步骤不需要写任何代码一条命令启动交互式安装向导它会自动检测你使用的宿主OpenCode、Pi、OMP、配置模型、处理与其他插件的冲突npx cortexkit/magic-contextlatest setup指定宿主可以用--harness opencode、--harness pi或--harness omp。安装完成后重启宿主即可。遇到问题时运行诊断修复命令npx cortexkit/magic-contextlatest doctor配置只需一个文件magic-context.jsonc项目级放在.cortexkit/magic-context.jsonc用户级放在~/.config/cortexkit/magic-context.jsonc。其中必填项只有历史学家模型例如{ historian: { opencode: { model: provider/model-id } } }完整的配置项记忆开关、注入预算、向量嵌入、自动搜索等详见 CONFIGURATION.md。5 大记忆分类详解AI 如何给知识归档Magic Context 的每条记忆都是一句简短、可独立成立的项目级事实写入时必须归入以下 5 个分类之一源码定义见 constants.ts完整类型定义见 types.ts。这套分类学就是让 AI记得清楚的关键——不同性质的知识分开存放回忆时才能精准命中。分类一PROJECT_RULES项目规则在这个项目里必须怎么做的行为准则。例如所有数据库写入必须使用单个 BEGIN IMMEDIATE 事务、提交信息必须以模块名开头特点是项目里的硬性规定AI 在动手前会优先参考系统还会保护这类记忆不被随意改写——做梦者在校验时若发现它想删除一条规则会直接拒绝该操作见 memory-claim-safety分类二ARCHITECTURE架构事实这个项目是怎么搭起来的。例如订单模块采用事件溯源Event Sourcing、记忆存储在 SQLite 的 context.db 中特点描述系统级的结构性事实帮助 AI 在改代码时不破坏整体设计新会话开始时AI 靠这类记忆快速建立对项目的空间感分类三CONSTRAINTS约束有什么坑不能踩、什么限制必须知道。例如bun:sqlite 不能加载扩展向量只能用 Float32Array 余弦相似度比较特点往往是花了很多轮才挖出来的血泪经验最值得永久记住在跨项目协作workspace场景下CONSTRAINTS是默认唯一会跨仓库只读共享的分类见 memory-and-search.md分类四CONFIG_VALUES配置值关键配置的当前取值。例如默认嵌入模型是 Xenova/all-MiniLM-L6-v2、注入预算默认 4000 token特点配置值最容易过期改口因此当事实变化时系统会用更新旧记忆而不是新增一条来处理避免新旧值打架分类五NAMING命名约定东西该怎么命名才符合项目习惯。例如记忆分类名使用全大写下划线格式、隐藏子会话统一用 magic-context- 前缀特点AI 写新文件、新函数时直接沿用你的命名风格输出更像团队写的新手建议你不需要手动记这 5 个分类的名字。历史学家会自动把提炼出的事实分到对应类别如果你想手动补一条只要让 AI 调用ctx_memory工具并指定category即可非法分类会在写入校验时直接被拦下。记忆是如何产生的三条写入通道Magic Context 的记忆不靠你手动维护它有三个写入者见 memory-and-search.md历史学家自动晋升默认开启后台历史学家压缩旧对话时顺手把其中的持久性知识决策、约束、约定、配置值提炼成facts并晋升为项目记忆机制见 historian.md。你正常干活记忆免费生成。Agent 主动写入AI 通过ctx_memory工具执行write/update/archive/merge/get操作工具实现位于 ctx-memory 目录。做梦者维护写入Dreamer 在夜间整理、合并、修复记忆。写入时会做精确哈希去重同一事实再次出现时只累加seen_count被看见次数不会插入重复行被检索 3 次以上的记忆会自动晋升为permanent永久状态。记忆如何被维护Dreamer 的夜间睡眠就像人类睡眠巩固记忆Dreamer 定时默认夜间运行一组后台任务保证记忆池不腐化任务列表见 dreamer.md任务作用map-memories把每条记忆映射到支撑它的代码文件verify/verify-broad对照当前代码重新校验记忆修正或删除过时事实curate逐个分类清理合并重复、精简措辞、归档低价值条目classify-memories给记忆打重要性、作用域和可共享性评分手动触发一次维护在会话中输入/ctx-dream。你完全不用盯着它——它只在空闲时运行配本地慢速模型也很合适。记忆如何被想起来注入与搜索自动注入每轮对话活跃的项目记忆会以project-memory区块的形式出现在 AI 的提示里形如#id: 事实的紧凑行。会话中新产生的记忆通过增量方式补齐不会破坏提示缓存。主动搜索AI 随时可以用ctx_search一把梭检索 5 类来源——项目记忆、原始对话历史、git 提交、笔记notes和预置问题primers语义向量 全文双路召回。例如ctx_search(query为什么订单模块选了事件溯源)还有个贴心功能默认开启的auto_search会在你发出新消息时后台先搜一把命中相关记忆就给 AI 追加一句模糊回忆提示像人脑里突然闪过这事我好像记过。常见配置速查新手最关心的 4 项配置默认说明memory.enabledtrue总开关。关闭后ctx_memory隐藏、记忆不再注入memory.auto_promotetrue历史学家自动晋升事实。关闭后记忆只能靠 AI 手动写memory.injection_budget_tokens4000每轮注入记忆的 token 预算500–20000embedding.providerlocal语义搜索的向量来源off可退回纯关键词搜索写在最后把 AI 当长期队友而不是临时工Magic Context 的核心承诺只有一句话你的 Agent 永不因管理上下文而停摆也永不遗忘。装好之后对一个项目保持同一个会话运行几周、几个月它会带着全部积累的记忆继续工作——项目规则、架构决策、配置值、约束、命名约定五大分类各归其位夜间自动体检更新。想深入细节推荐阅读 记忆与搜索架构文档、历史学家文档、做梦者文档 和 完整配置参考。现在就装上它让下一次会话的 AI 记得你上一次会话教过它的一切。【免费下载链接】magic-contextUnbounded context. Memory that manages itself. One session, for life. The hippocampus for coding agents, part of CortexKit.项目地址: https://gitcode.com/gh_mirrors/mag/magic-context创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考