【免费下载链接】LycheeMemLightweight Long-Term Memory for LLM Agents.项目地址https://gitcode.com/gh_mirrors/ly/LycheeMem点击查看免费下载LycheeMem 是一个面向 LLM Agent 的轻量级长期记忆框架通过 Claude Code 插件与 Hermes 插件可以为 Agent 提供自动召回、会话镜像与记忆固化consolidation的完整工作流让 AI 助手真正记住你的偏好、项目决策与历史对话而无需你手动粘贴上下文。本文带你从零完成安装并深入解析这两条插件链路的召回与固化机制。一、为什么 Agent 需要长期记忆插件大语言模型本身是无状态的会话一结束上下文就全部丢失。你在上一周告诉 Agent我喜欢简洁的回答风格它在新会话里会一无所知。LycheeMem 把记忆拆分为三类互补存储记忆层职责插件中的角色工作记忆Working Memory会话轮次、摘要、Token 预算管理接收插件镜像进来的对话轮次语义记忆Semantic Memory事实、偏好、事件等类型化 MemoryRecordsmart_search召回的核心来源程序性记忆Skills可复用工作流与技能条目召回时一并检索提升答案质量而插件要解决的核心问题只有三个什么时候自动召回、什么时候自动写入、什么时候把临时对话固化为长期记忆。二、准备工作启动 LycheeMem 记忆服务两条插件链路都依赖同一个后端服务先把它跑起来。git clone https://gitcode.com/gh_mirrors/ly/LycheeMem cd LycheeMem pip install lycheemem python main.py服务默认监听8000端口。也可以直接用官方 CLI 一键启动lycheemem-cli。确认服务健康curl http://127.0.0.1:8000/health 若.env中使用了其他端口如API_PORT8100后续所有LYCHEEMEM_BASE_URL都要保持一致。三、Claude Code 插件实战三步接入1. 校验并加载插件Claude Code 插件通过MCP hooks两种机制接入完整安装指南见 INSTALL_CLAUDE.md。export LYCHEEMEM_REPO/path/to/LycheeMem export LYCHEEMEM_BASE_URLhttp://127.0.0.1:8000 claude plugin validate $LYCHEEMEM_REPO/claude-plugin/lycheemem claude --plugin-dir $LYCHEEMEM_REPO/claude-plugin/lycheemem2. 在会话内验证进入 Claude Code 后运行/plugin和/mcp确认插件与 MCP server 已加载然后做端到端测试Please remember that my favorite fruit is lychee. What is my favorite fruit? Use LycheeMem to recall my favorite fruit.如果自动召回生效Claude 会基于 LycheeMem 返回的background_context作答而不是凭空猜测。3. 插件内部三个 Hook 串起完整工作流Claude Code 插件的自动化逻辑全部由 hook 驱动配置在 hooks.json 中Hook 事件触发时机动作UserPromptSubmit每次提交用户消息前自动从 LycheeMem 召回相关记忆注入上下文Stop每轮回答结束镜像助手回复到 LycheeMemSessionEnd会话结束异步执行触发记忆固化沉淀为长期记忆除了 hook插件还注册了一个 memory skill教会 Claude 在哪些场景下应主动调用lychee_memory_smart_search例如询问历史对话、偏好、项目规范时并规定了召回优先、证据不足时明确说明而非编造的回答原则。四、Hermes 插件实战运行时级自动记忆Hermes 插件以 Python runtime 的形式接入插件清单见 plugin.yaml完整指南见 INSTALL_HERMES.md。1. 安装并启用插件mkdir -p ~/.hermes/plugins ln -sfn $LYCHEEMEM_REPO/hermes-plugin/lycheemem ~/.hermes/plugins/lycheemem hermes plugins enable lycheemem hermes plugins list2. 配置连接环境变量export LYCHEEMEM_BASE_URLhttp://127.0.0.1:8000 export LYCHEEMEM_TRANSPORThttp export LYCHEEMEM_ENABLE_PRE_LLM_CONTEXTtrue export LYCHEEMEM_ENABLE_AUTO_APPENDtrue export LYCHEEMEM_ENABLE_AUTO_CONSOLIDATEtrue export LYCHEEMEM_SMART_SEARCH_TOP_K5 export LYCHEEMEM_RESPONSE_LEVELminimal3. 启动 Hermes 并做端到端验证hermes在 Hermes 内依次执行/plugins /lycheemem status /lycheemem health Please remember that my favorite fruit is lychee. What is my favorite fruit? /lycheemem recall favorite fruit如果链路正常/lycheemem recall会返回包含lychee的background_context。4. 核心机制pre_llm_call 到 on_session_end 的生命周期Hermes 插件的工作流实现在 runtime.py 中按会话生命周期划分为四个阶段pre_llm_call自动召回每次模型调用前插件用用户消息调用smart_search把召回结果以Relevant memory from LycheeMem:前缀注入为background_context。由于发生在模型调用之前通常不会显示为可见的工具调用——这是无感召回的关键。post_llm_call会话镜像每轮结束后把 user / assistant 两条消息镜像写入 LycheeMem。内部用 SHA1 指纹去重同一轮次不会重复写入。on_session_end/on_session_finalize记忆固化会话收尾时触发 consolidation由 LLM 从对话中提取事实、偏好等类型化记忆写入语义记忆支持后台异步执行并带 60 秒冷却LYCHEEMEM_AUTO_CONSOLIDATE_COOLDOWN_SECONDS避免频繁打扰。手动调试通道/lycheemem recall query用于检查检索质量lycheemem_smart_search工具留给显式召回场景。HTTP/MCP 双通道的客户端封装见 client.py所有开关与默认值集中定义在 config.py。五、调参速查让召回与固化符合你的场景环境变量默认值作用LYCHEEMEM_BASE_URLhttp://127.0.0.1:8000记忆服务地址LYCHEEMEM_ENABLE_PRE_LLM_CONTEXTtrue自动召回开关关掉可强制模型显式调用检索工具LYCHEEMEM_ENABLE_AUTO_APPENDtrue自动镜像轮次开关LYCHEEMEM_AUTO_CONSOLIDATE_BACKGROUNDtrue固化是否后台执行调试时设为falseLYCHEEMEM_AUTO_CONSOLIDATE_COOLDOWN_SECONDS60固化冷却时间调试时设为0LYCHEEMEM_SMART_SEARCH_TOP_K5每次召回的记忆条数上限LYCHEEMEM_RESPONSE_LEVELminimal召回详略级别minimal / compact / full⚙️ 调试记忆流水线时推荐组合LYCHEEMEM_AUTO_CONSOLIDATE_BACKGROUNDfalseLYCHEEMEM_AUTO_CONSOLIDATE_COOLDOWN_SECONDS0让固化同步执行、立即生效再观察服务端日志中的/memory/append-turn、/memory/consolidate、/memory/smart-search调用。六、常见问题排查/plugins中看不到lycheemem确认软链接存在ls -la ~/.hermes/plugins/lycheemem重新执行hermes plugins enable lycheemem后重启 Hermes。/lycheemem health失败先用curl $LYCHEEMEM_BASE_URL/health验证服务通常是端口或LYCHEEMEM_BASE_URL不一致。recall返回空回忆需要先固化。改用同步固化参数重跑测试并检查.env中的EMBEDDING_API_BASE历史数据较多时首次启动会回填向量属于正常现象。修改 Claude Code 插件或 MCP 配置后不生效必须重启 Claude Code。七、总结LycheeMem 的 Claude Code 与 Hermes 插件展示了一套通用的记忆接入范式用生命周期 hook 实现无感自动召回与会话镜像用异步 consolidation 完成记忆固化再用 slash 命令 / MCP 工具保留手动调试通道。接入后Agent 无需依赖模型想起来调用工具记忆召回变成确定性的基础设施行为。如果你正在构建跨会话的 AI 助手这套工作流值得直接复用先pip install lycheemem跑起服务再按本文第三节或第四节接入你的 Agent 运行时十分钟即可验证完整的记住 → 召回 → 固化闭环。赞分享【免费下载链接】LycheeMemLightweight Long-Term Memory for LLM Agents.项目地址https://gitcode.com/gh_mirrors/ly/LycheeMem点击查看免费下载相关推荐Loop 快速上手macOS 窗口管理免费工具完整指南Loop 快速上手macOS 窗口管理免费工具完整指南 Loop 是一款 macOS 窗口管理工具它用一个触发键加环形菜单把窗口分屏、对齐、换屏这些操作压桌面应用OpenViking × OpenCode 记忆插件接入指南安装、配置与自动召回实战OpenViking × OpenCode 记忆插件接入指南安装、配置与自动召回实战 OpenViking 为 OpenCode 提供了官方维护的统一记忆插件人工智能AI AgentAgent 记忆RAG后端数据库Isaac Lab 基准测试框架实战5 个关键机制让性能回归无所遁形Isaac Lab 基准测试框架实战5 个关键机制让性能回归无所遁形 如果你的仿真环境最近被改过几次你是否遇到过这样的场景某个 PR 合并后训练感觉变慢人工智能强化学习机器人具身智能深度学习创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考