技能介绍

解决上下文割裂问题

在使用 Claude Code、Cursor 或 Codex 等 MCP 客户端时，若涉及多智能体或跨会话协作，往往会遇到严重的上下文割裂。每个客户端通常只保留自身会话的历史记录，导致在不同工具间切换时，必须反复交代项目结构、API 约定或特定的业务逻辑。这种重复不仅消耗大量 token，还容易因上下文缺失引发难以排查的逻辑错误。

核心能力与实现机制

该技能通过 MARM 提供一个本地优先的共享内存服务器，作为统一的知识枢纽。

统一存储与语义检索：基于 SQLite 进行本地持久化，内置的语义召回机制允许客户端通过含义而非精确关键词查找历史片段。
自动化生命周期管理：服务端内部处理会话状态的初始化，无需人工干预。
文档索引与追踪：首次调用工具时，系统会自动将打包文档索引至 marm_system 命名空间，并通过 source-file hash 追踪变更，确保多客户端读取到的上下文保持同步。
结构化信息管理：支持会话记录、笔记摘要以及代码图谱上下文，帮助智能体构建对代码库的全局认知。

适用边界与注意点

存储局限：依赖 SQLite 意味着该方案更适合中小规模的本地项目。若涉及海量数据或高频并发写入，需评估 SQLite 的性能瓶颈。
索引预热：文档索引在首次实际工具调用时触发。建议在正式运行复杂任务前先进行简单的预热操作，以避免首项任务因初始化导致延迟。
部署一致性：无论是通过 pip 还是 Docker 部署，MCP 接口保持一致。但在多智能体 --swarm 模式下，需确保所有实例均指向同一内存服务器以避免状态不一致。