memory-compression-system

🗜️ 智能上下文压缩与自动化内存管家

OpenClaw 智能上下文压缩与内存管理系统,支持85%极致压缩率与自动化调度,专为长对话上下文优化设计。

收藏
6.4k
安装
1.5k
版本
3.0.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Memory Compression System v3.0 是专为 OpenClaw 设计的集成化内存管理与上下文压缩解决方案。系统提供三级压缩格式(Base64/Binary/Ultra),支持每6小时自动调度压缩任务,并内置统一搜索与备份恢复机制。

主要操作路径

  • 启用自动化:scripts/enable.sh 启动6小时周期压缩
  • 手动压缩:scripts/compress.sh --format ultra 指定85%压缩率模式
  • 统一检索:scripts/search.sh "关键词" 跨格式实时搜索
  • 状态监控:scripts/status.sh / scripts/health.sh 查看系统健康

技术实现:采用分层压缩架构——B64C(~40%缩减,CRC32校验,人类可读)、CBIN(~70%缩减,Huffman编码+共享字典)、UCMP(~85%缩减,3字母缩写+位打包+增量编码,目标~150 tokens)。系统通过单一cron任务调度,避免重叠执行,内置事务日志与自动回滚机制。

显著优点

1. 极致压缩效率:UCMP模式实现85%上下文缩减,显著扩展模型有效上下文窗口
2. 零运维自动化:单一cron任务覆盖压缩、备份、索引更新、清理全流程

3. 跨格式检索:实时索引支持B64C/Binary/Ultra三种格式的统一搜索

4. 生产级可靠性:备份优先策略、CRC校验、自动回滚、详细日志分级

5. 资源友好:峰值内存<50MB,10KB数据Ultra压缩<200ms

潜在局限

  • 压缩损耗:极端压缩(UCMP)牺牲人类可读性,调试需解压缩
  • 调度固定性:6小时周期为预设值,动态负载适配能力未明确
  • 生态锁定:专为OpenClaw设计,跨平台移植性有限
  • 依赖风险:cron可靠性受宿主机时钟同步影响

适合人群

  • 长上下文对话开发者(需突破token限制)
  • OpenClaw 自动化运维用户
  • 嵌入式/边缘计算场景(存储敏感型应用)
  • 需要历史对话检索与归档的企业用户

常规风险

| 风险类型 | 具体表现 | 缓解措施 |
|---------|---------|---------|
| 数据完整性 | 压缩异常导致上下文损坏 | 自动备份+CRC校验+事务回滚 |
| 调度失效 | cron任务未触发或重叠 | 单一任务设计+状态检查脚本 |
| 性能衰减 | 索引膨胀导致搜索变慢 | 自动清理+索引优化(每日04:00) |
| 误操作恢复 | 人工误删或配置错误 | 保留30天备份+`scripts/restore.sh` |

建议:生产环境启用前运行scripts/test-compression.sh验证数据完整性,并配置外部备份存储。

memory-compression-system 内容

scripts文件夹
手动下载zip · 25.4 kB
cleanup.shtext/x-shellscript
请选择文件