---
slug: "memory-distiller-free"
name: "memory-distiller-free"
version: "1.0.0"
displayName: "记忆蒸馏器免费版"
summary: "基础日志蒸馏工具，支持单文件压缩与古文压缩原则，约4倍压缩比。记忆蒸馏器免费版提供基础日志蒸馏能力，将冗长日志压缩为结构化摘要. 核心能力包括：单文件日志蒸馏、古文压缩四原则、关键词匹配提取"
summary_zh: "基础日志蒸馏工具，支持单文件压缩与古文压缩原则，约4倍压缩比。记忆蒸馏器免费版提供基础日志蒸馏能力，将冗长日志压缩为结构化摘要. 核心能力包括：单文件日志蒸馏、古文压缩四原则、关键词匹配提取"
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
```

## 错误处理

| 错误类型 | 原因 | 处理方式 |
|---:|---:|---:|
| 摘要缺失关键事件 | 关键词模式未覆盖日志中的事件表述 | 确认日志标题格式符合识别模式，必要时手动补充摘要 |
| 压缩比低于 4 倍 | 日志本身已高度结构化 | 正常现象，或检查是否有大段重复内容未去除 |
| Node.js 运行时缺失 | 系统未安装 Node.js 或版本过低 | 安装 Node.js 16+ 后检查网络连接和配置后重试，通过 `node --version` 验证 |

## 示例

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

用户当天产生了 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：不同类型的内容压缩策略一样吗？

免费版对所有内容采用统一压缩策略。付费版提供分类型差异化压缩（事件/教训/待办/成长四类不同粒度），教训保留最细、待办压缩最狠。如需差异化压缩，请升级到付费版.
### 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 体积
- **多语言混合处理**：中英文混杂日志按段落识别语言，应用对应关键词集
- **批量压缩与心跳集成**：支持多日批量蒸馏，集成到维护周期自动执行

如需这些高级能力，请升级到记忆蒸馏器付费版.