---
slug: "memory-compress-free"
name: "memory-compress-free"
version: "1.0.0"
displayName: "日志压缩器免费版"
summary: "基础日志压缩工具，将日志压缩为结构化摘要，支持单文件处理。日志压缩器免费版提供基础日志压缩能力，将冗长日志压缩为结构化摘要. 核心能力包括：单文件日志压缩、古文压缩四原则、关键词匹配提取、基"
summary_zh: "基础日志压缩工具，将日志压缩为结构化摘要，支持单文件处理。日志压缩器免费版提供基础日志压缩能力，将冗长日志压缩为结构化摘要. 核心能力包括：单文件日志压缩、古文压缩四原则、关键词匹配提取、基"
license: "MIT"
description: |-
  日志压缩器免费版提供基础日志压缩能力，将冗长日志压缩为结构化摘要.
  核心能力包括：单文件日志压缩、古文压缩四原则、关键词匹配提取、基础边界处理.
  适用于 Agent 每日日志归档场景，压缩比约 4 倍.
  纯本地 Node.js 脚本运行，无外部依赖，无需 API Key.
  如需批量压缩、心跳集成、混合提取引擎等高级能力，请升级到付费版.
tools:
  - read
  - exec
  - write
homepage: ""
tags:
  - 智能助手
  - 记忆管理
  - 上下文
  - AI
  - node
  - memory
  - tmp
  - compressed
  - agent
category: "Agents"
---
# 日志压缩器免费版

基础日志压缩工具，将日志压缩为结构化摘要.
## 输入格式

| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | 日志压缩器免费版处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |

## 核心能力

### 1. 单文件日志压缩
将单日日志文件压缩为结构化摘要.
- **参数**：输入日志文件路径、输出文件路径（可选）
- **用法**：`node （请参考skill目录中的脚本文件） memory/2026-07-18.md /tmp/compressed.md`
- **输出**：结构化压缩摘要，包含关键事件与待办事项

压缩效果：

```text
压缩前：2,500 词原始日志
压缩后：约 600 词结构化摘要
压缩比：约 4 倍
```

**处理**: 解析单文件日志压缩的输入参数,执行核心处理逻辑,返回结构化结果和执行状态.
### 2. 古文压缩四原则
借鉴古典中文写作的压缩智慧进行结构化提炼.
- **参数**：无，内置于压缩逻辑
- **用法**：自动应用于所有压缩操作
- **输出**：遵循四原则的摘要

| 原则 | 含义 |
|:-----|:-----|
| 去重复 | 提过一次就够 |
| 留转折 | 只记变化点 |
| 去过程 | 结果优于过程 |
| 留白 | 让读者推断 |

**处理**: 解析古文压缩四原则的输入参数,执行核心处理逻辑,返回结构化结果和执行状态.
### 3. 关键词匹配提取

扫描日志标题识别中英文关键词模式.
- **参数**：无，自动扫描
- **用法**：自动识别重大进展、教训、待办等关键词
- **输出**：匹配的关键信息条目

- 参考`关键词匹配提取`的配置文档进行参数调优
#
## 快速开始

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

> 详细的输入输出格式请参考下方章节说明。

## 使用流程

### 第一步：准备日志文件

确保 Agent 每日日志以 Markdown 格式存储在 `memory/YYYY-MM-DD.md` 文件中.
### 第二步：执行压缩

运行压缩脚本处理目标日志文件.
```bash
node （请参考skill目录中的脚本文件） memory/2026-07-18.md /tmp/compressed.md
```

### 第三步：追加到精选记忆

审查压缩结果后追加到 MEMORY.md.
```bash
cat /tmp/compressed.md >> MEMORY.md
```

## 错误处理

| 错误类型 | 原因 | 处理方式 |
|---:|---:|---:|
| Node.js 运行时缺失 | 系统未安装 Node.js 或版本过低 | 安装 Node.js 16+ 后检查网络连接和配置后重试，通过 `node --version` 验证 |
| 输出目录不存在 | 指定的输出文件路径所在目录未创建 | 手动 `mkdir -p` 创建目录后检查网络连接和配置后重试 |
| 压缩比为 1（未压缩） | 日志本身已高度结构化 | 正常现象，无冗余可去除 |

## 示例

### 示例一：每日日志归档

用户当天产生了 2500 词的开发日志，需要压缩归档.
```text
用户："今天的日志太长了，帮我压缩"
# ...
输入文件：memory/2026-07-18.md（2,500 词）
# ...
执行：
1. 运行：node （请参考skill目录中的脚本文件） memory/2026-07-18.md /tmp/compressed.md
2. 脚本扫描标题，识别关键词：重大进展、教训、待办
3. 应用古文压缩四原则
4. 输出压缩摘要
# ...
输出文件：/tmp/compressed.md（约 600 词，压缩比约 4 倍）
# ...
输出内容结构：
  ## 2026-07-18 关键经验
  ### 关键事件
  - **完成支付模块联调**
    - PostgreSQL数据库事务回滚测试通过
  ### 待办/未完成
  - 🔴 07-20 前完成订单模块测试
# ...
后续操作：
  cat /tmp/compressed.md >> MEMORY.md
```

## FAQ

### Q1：免费版支持批量压缩吗？

免费版仅支持单文件压缩。如需批量压缩多日日志，请升级到付费版.
### Q2：压缩比能达到多少？

免费版典型压缩比约 4 倍。付费版通过混合提取引擎可达 4-8 倍。压缩比取决于原始日志的冗余度.
### Q3：压缩会丢信息吗？

免费版使用关键词匹配提取，未匹配的章节可能遗漏。付费版的兜底提取机制确保零数据丢失。建议关键场景人工审查压缩结果.
## 依赖说明

### 运行环境

- **Agent 平台**：支持 SKILL.md 的任意 AI Agent（Claude Code / Cursor / Codex / Gemini CLI 等）
- **操作系统**：Windows / macOS / Linux
- **运行时**：Node.js 16+

### 依赖项

| 依赖项 | 类型 | 是否必需 | 获取方式 |
|:---:|:---:|:---:|:---:|
| Node.js | 运行时 | 必需 | Node.js 官网安装，版本 16+ |
| memory-compress.js | 脚本 | 必需 | 随技能提供 |
| LLM API | API | 必需 | 由 Agent 内置 LLM 提供 |

### API Key 配置

本技能基于本地 Node.js 脚本处理日志文件，无需额外 API Key.
### 可用性分类

- **分类**：MD+EXEC（Markdown 指令驱动，需 exec 执行 Node.js 脚本）
- **说明**：基于 Markdown 的 AI Skill，通过自然语言指令驱动 Agent 运行压缩脚本

## 已知限制

- 仅支持单文件压缩，不支持批量处理
- 压缩比约 4 倍，低于付费版的 4-8 倍
- 无兜底提取机制，未匹配关键词的章节可能遗漏
- 无心跳集成，需手动执行压缩
- 不支持多日合并文件的混合模式处理

## 升级提示

本免费版提供基础日志压缩能力。升级到付费版可获得以下增强：

- **混合提取引擎**：关键词匹配 + 兜底提取 + 混合模式三重保障，零数据丢失
- **更高压缩比**：4-8 倍压缩比（免费版约 4 倍），显著减少 MEMORY.md 体积
- **批量压缩多日日志**：一次性处理一周或多周日志，每天单独压缩保留日期维度
- **心跳集成维护**：每 2-3 天自动执行压缩，无需手动触发
- **边界情况全兼容**：自动处理空文件、BOM 编码、非 UTF-8、多日合并等异常情况
- **中英文混合处理**：按段落识别语言，应用对应关键词集，混合日志也能高效压缩

如需这些高级能力，请升级到日志压缩器付费版.