memory-distiller-free

记忆蒸馏器免费版

基础日志蒸馏工具，将日志压缩为结构化摘要.

输入参数

能力描述

1. 单文件日志蒸馏

将单日日志文件蒸馏为结构化摘要.

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

压缩效果：

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

2. 古文压缩四原则

借鉴古典中文写作的压缩智慧进行结构化提炼.

• 参数：无，内置于压缩逻辑
• 用法：自动应用于所有蒸馏操作
• 输出：遵循四原则的摘要

3. 关键词匹配提取

扫描日志标题识别中英文关键词模式.

• 参数：无，自动扫描
• 用法：自动识别重大进展、教训、待办等关键词
• 输出：匹配的关键信息条目

即刻上手

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

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

操作流程

领先步：准备日志文件

确保 Agent 每日日志以 Markdown 格式存储在 memory/YYYY-MM-DD.md 文件中.

第二步：执行蒸馏

运行蒸馏脚本处理目标日志文件.

node （请参考skill目录中的脚本文件） memory/2026-07-18.md /tmp/compressed.md

第三步：追加到精选记忆

审查蒸馏结果后追加到 MEMORY.md.

cat /tmp/compressed.md >> MEMORY.md

异常处理架构

使用范例

示例一：每日日志归档

用户当天产生了 2500 词的开发日志，需要压缩归档.

用户："今天的日志太长了，帮我蒸馏归档"
# ...
输入文件：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 关键经验
  
### 关键事件
  - **完成支付模块联调**
    - 数据库数据库事务回滚测试通过
  
### 待办/未完成
  - 🔴 07-20 前完成订单模块测试
# ...
后续操作：
  cat /tmp/compressed.md >> MEMORY.md

用户疑问解答

Q1：免费版有溯源链吗？

免费版不支持溯源链功能。蒸馏后的摘要不含原始段落定位标记。如需从摘要回溯到原始日志细节，请升级到付费版获取完整溯源链.

Q2：不同类型的内容压缩策略一样吗？

免费版对所有内容采用统一压缩策略。付费版提供分类型差异化压缩（事件/教训/待办/成长四类不同粒度），教训保留最细、待办压缩最狠。如需差异化压缩，请升级到付费版.

Q3：能验证压缩质量吗？

免费版不提供质量评估器。用户需手动审查蒸馏结果。付费版提供四维质量指标（压缩比/信息保留率/可读性/溯源覆盖率）的自动评估报告。如需自动质量评估，请升级到付费版.

前置条件

运行环境

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

依赖项

API Key 配置

本技能基于本地 Node.js 脚本处理日志文件，无需额外 API Key.

可用性分类

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

升级提示

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

• 分类型差异化压缩：事件/教训/待办/成长四类内容采用不同压缩粒度，教训保留最细、待办压缩最狠
• 压缩溯源链：每个摘要条目保留原始段落定位标记，可一键回溯到原始日志细节
• 压缩质量评估器：压缩比/信息保留率/可读性/溯源覆盖率四维指标自动评估，不达标告警
• 混合提取引擎：关键词匹配 + 兜底提取 + 混合模式三重保障，零数据丢失
• 更高压缩比：4-8 倍压缩比（免费版约 4 倍），显著减少 MEMORY.md 体积
• 多语言混合处理：中英文混杂日志按段落识别语言，应用对应关键词集
• 批量压缩与心跳集成：支持多日批量蒸馏，集成到维护周期自动执行

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

能力限制说明

输入限制

• 文件格式：仅支持 Markdown 格式的日志文件。
• 文件大小：单文件处理能力有限，对于非常大的日志文件，可能需要分块处理。
• 日志内容：不支持二进制文件或包含特殊字符的文件。

性能边界

• 压缩比：免费版提供的压缩比约为 4 倍，可能因日志内容差异而有所变化。
• 处理速度：处理速度取决于日志文件的大小和系统的性能。

兼容性约束

• 操作系统：需要在支持 Node.js 16+ 的操作系统上运行。
• Node.js 版本：必须使用 Node.js 16 或更高版本。
• 依赖项：需要安装 memory-compress.js 和 LLM API，这些依赖项必须正确配置。

其他限制

• 批量处理：免费版不支持批量处理日志文件，每次只能处理一个文件。
• 异步处理：不支持异步处理，所有操作都是同步执行的。
• API Key：无需配置 API Key，因为所有操作都在本地执行。

输入输出格式说明

输入格式

• input：输入日志文件的内容或路径。
• options：可选的配置对象，包括模式选择、格式偏好等。
• callback_url：异步处理完成后的回调通知URL。

输出格式

• 输出文件：处理后的结构化摘要文件。
• 内容结构：摘要通常包含标题、关键事件、待办事项等结构化信息。
• 格式：输出格式为 Markdown，方便集成到其他文档中。

配置选项详解

模式选择

• 默认模式：自动检测并应用优选压缩模式。
• 自定义模式：通过 options 参数指定压缩模式。

格式偏好

• 标题格式：支持自定义标题格式，如日期、事件类型等。
• 内容格式：支持自定义内容格式，如列表、表格等。

故障排除指南

常见错误

• Node.js 运行时缺失：确保已安装 Node.js 16+。
• 日志文件格式错误：确保输入的日志文件是有效的 Markdown 格式。
• 依赖项未安装：检查是否已正确安装所有必需的依赖项。

故障排除步骤

1. 检查运行环境：确保 Node.js 和所有依赖项都已正确安装。
2. 验证输入文件：确保输入的日志文件格式正确。
3. 查看错误日志：如果出现错误，查看错误日志以获取更多信息。
4. 寻求帮助：如果无法解决问题，可以寻求社区或技术支持的帮助。

创新亮点

===

效率提升量化分析

差异化对比

核心痛点解决

===

诊断与修复

===

安全告示

1. 确保日志文件内容不包含敏感信息，如个人隐私数据或公司机密。
2. 日志处理过程中，避免日志文件被未授权访问或泄露。
3. 定期更新Node.js环境，确保使用的是最新稳定版本，减少安全风险。
4. 使用强密码保护日志存储路径，防止未授权访问。
5. 对日志处理脚本进行代码审计，确保没有安全漏洞。

安全风险防范

功能一览

• 自动化执行: 基础日志蒸馏工具，支持单文件压缩与古文压缩原则，约4倍压缩比。记忆蒸馏器免费版提供基础日志蒸馏能力，将冗长日志压缩为结构
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果

使用指引

1. 配置API密钥: 在环境变量中设置对应的API Key
2. 初始化连接: 使用提供的凭证建立API连接
3. 调用接口: 传入必要参数执行API调用
4. 准备文件: 确认文件路径正确且格式受支持
5. 执行处理: 调用对应的处理函数
6. 查看结果: 检查输出文件或返回数据
7. 检查环境: 确认运行时和依赖已安装
8. 执行命令: 使用正确的参数格式执行
9. 查看输出: 检查命令输出和退出码

前置条件

• 已安装所需运行环境(参考依赖说明)
• 已获取必要的API密钥或访问凭证(如适用)
• 输入数据已准备就绪