跳到主要内容
项目档案插件 / 扩展

Hermes-LCM:专为Hermes Agent打造的无损上下文管理插件,解决对话信息丢失问题,安装配置指南

Hermes-LCM 是专为 Hermes Agent 设计的无损上下文管理插件,基于分层 DAG 结构与不可变存储解决传统上下文压缩导致的信息丢失问题,本文档涵盖项目介绍、安装方式、使用配置等核心信息。

1,135PythonStar 于 2026年4月16日2026年9月19日 更新

AI 总结

Hermes-LCM 是专为 Hermes Agent 打造的无损上下文管理插件,基于分层 DAG 结构与不可变 SQLite 存储持久化所有对话消息,解决传统上下文压缩导致的信息丢失问题,实现有界存储、无界记忆。

中文项目介绍

Hermes-LCM 是专为 Hermes Agent 设计的无损上下文管理插件,基于 Ehrlich & Blackman 发布的 LCM 论文开发,参考 lossless-claw 的设计思路,作为 Hermes 的可插拔上下文引擎使用。 传统 AI 代理在上下文容量耗尽时,会用有损扁平摘要替换完整对话历史,导致细节丢失、模型自信错记、无法回溯历史消息。Hermes-LCM 通过持久化所有消息、分层 DAG 摘要结构解决该问题,保证没有任何消息被丢失。 插件核心特性包括不可变 SQLite 存储(所有消息写入后永不修改)、分层 DAG 摘要结构(按分钟级到天级层级压缩)、三级升级压缩策略(L1 详细摘要→L2 要点摘要→L3 确定性截断,保证压缩必然收敛)、代理检索工具集、会话过滤能力、按 Hermes profile 隔离数据库。技术层面零外部依赖,仅约 3800 行 Python 代码,包含 130 个可独立运行的测试用例,无构建步骤与额外运行时开销,仅需配置 context.engine 为 lcm 即可完成集成。

详细信息与使用说明

1. 项目定位与用途

Hermes-LCM 是专为 Hermes Agent 打造的无损上下文管理插件,基于 Ehrlich & Blackman 发布的 LCM 论文开发,参考 lossless-claw 的设计思路,作为 Hermes 的可插拔上下文引擎,实现对话消息的完整持久化与分层压缩,避免上下文压缩导致的信息丢失,为 Hermes Agent 提供有界存储、无界记忆的能力。

2. 解决的问题

传统 AI 代理上下文容量耗尽时,会用有损扁平摘要替换完整对话历史,导致细节丢失、模型出现自信型错误记忆、无法回溯历史消息内容。Hermes-LCM 通过不可变存储持久化所有消息、分层 DAG 摘要结构彻底解决该问题,保证没有任何消息在压缩过程中丢失。

3. 适用场景

仓库中未明确给出具体适用场景列表,根据其核心能力推断适用于对上下文完整性要求高的 Hermes Agent 长对话场景,如复杂多轮对话、需要回溯历史细节的代理任务、对上下文准确性要求高的专业领域代理应用等。

4. 安装方式

仓库明确给出的安装方式为将项目克隆到 Hermes 的上下文引擎插件目录:全局安装需克隆到 ~/.hermes/hermes-agent/plugins/context_engine/lcm 路径;为指定 profile 安装则需克隆到 ~/.hermes/profiles/<profile 名称>/hermes-agent/plugins/context_engine/lcm 路径。更新时进入对应目录执行 git pull 后重启 Hermes 即可。

5. 使用方式

安装完成后重启 Hermes,可通过两种方式激活插件:一是通过 hermes plugins 交互式 UI 选择 Context Engine 分类下的 lcm 引擎;二是在 Hermes 的 config.yaml 中配置 context.engine 为 lcm。激活后代理可使用 lcm_grep、lcm_describe、lcm_expand、lcm_expand_query 四个内置检索工具对已压缩的上下文进行结构化回溯查询。

6. 实现特点

插件核心实现包括:不可变 SQLite 存储(所有消息写入后永不修改)、分层 DAG 摘要结构(按 D0 分钟→D1 小时→D2 天层级压缩)、三级升级压缩策略(L1 详细摘要→L2 要点摘要→L3 确定性截断,保证压缩必然收敛)、会话过滤能力(支持排除特定会话或标记为只读)、按 Hermes profile 隔离数据库。技术优势为零外部依赖、约 3800 行 Python 代码、130 个独立测试用例、无构建步骤、无额外运行时开销。仓库中仅展示了部分可选环境变量,完整配置项未明确给出。

思维导图

hermes-lcm
核心特性
不可变SQLite存储
分层DAG摘要
三级升级压缩
会话过滤
Profile隔离数据库
代理工具集
lcm_grep
lcm_describe
lcm_expand
lcm_expand_query
集成要求
Hermes可插拔上下文引擎
Python 3.11+
零外部依赖
安装配置
克隆到context_engine插件目录
配置context.engine: lcm

常见问题

Hermes-LCM 是什么?

是专为 Hermes Agent 打造的无损上下文管理插件,基于分层 DAG 结构与不可变 SQLite 存储持久化所有对话消息,避免传统上下文压缩导致的信息丢失,实现有界存储、无界记忆。

安装 Hermes-LCM 需要什么依赖?

仅需要 Hermes Agent 支持可插拔上下文引擎槽(对应 PR #7464)、Python 3.11+ 环境,插件本身零外部依赖,无需额外安装其他库。

如何激活 Hermes-LCM 插件?

安装后重启 Hermes,可通过交互式 hermes plugins UI 选择 Context Engine 分类下的 lcm 引擎,或在 Hermes 的 config.yaml 中配置 context.engine 为 lcm 即可激活。

Hermes-LCM 如何保证上下文信息不丢失?

插件通过不可变 SQLite 存储持久化所有消息,结合分层 DAG 摘要结构与三级升级压缩策略(L1 详细摘要→L2 要点摘要→L3 确定性截断),在压缩过程中保证没有任何消息被丢失,同时支持对已压缩内容的结构化回溯查询。

Hermes-LCM 的存储占用会很高吗?

插件采用不可变 SQLite 存储所有消息,同时通过分层 DAG 摘要与三级升级压缩策略对历史消息进行分层压缩,在保证信息无损的前提下控制存储占用,仓库中未明确给出具体存储占用的量化指标。