Session Memory Extractor

自动提取旧会话记忆并清理磁盘空间

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:Session Memory Extractor。
它的用途是:自动提取旧会话记忆并清理磁盘空间
完整的 Skill 内容见:https://321skill.com/skills/session-memory-extractor-x/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'请扫描我的Claude本地Session文件,提取其中关于项目决策和用户偏好的记忆,并清理无用的.jsonl文件。' 它会自动定位Session目录,逐文件调用AI提炼关键信息追加写入memory/,完成后安全删除旧文件释放数百MB磁盘空间。

介绍

Session Memory Extractor 解决了 Claude 用户长期面临的会话文件膨胀问题。随着对话堆积,本地存储的 .jsonl 和 .trajectory.jsonl 文件会占用数百 MB 甚至更多磁盘空间,而手动清理又担心丢失重要记忆。该工具自动扫描旧 Session 文件,利用 AI 提炼其中的决策、偏好、事实等关键信息,追加写入 memory/ 目录,随后安全删除原始文件,实现记忆保留与空间释放的双赢。

使用非常简单:安装后只需运行一次扫描命令,工具会自动定位本地 Session 路径,逐文件调用 AI 提取结构化记忆,确认无误后才会执行清理。提炼失败的文件会被自动移入 Quarantine 隔离区,不会静默删除,确保数据零丢失。整个过程无需手动干预,适合设置定时任务定期执行。

最适合长期使用 Claude 进行开发、写作或研究的用户,尤其是智能体开发者和需要维护大量对话上下文的后端工程师。对于频繁创建新会话、依赖历史记忆进行决策的场景,该工具能显著降低存储成本,同时保持记忆的连续性。

建议首次使用时先手动检查 memory/ 输出内容,确认提取质量后再开启自动清理。定期运行(如每周一次)可保持磁盘空间健康。注意该工具仅处理本地文件,不适用于云端会话或跨设备同步场景。

核心特点

与同类记忆管理工具相比,Session Memory Extractor 最大的特点是“先提炼后清理”——确保记忆被安全提取并写入持久化目录后才删除原始文件,且提炼失败的文件自动隔离不删除,彻底避免静默丢数据的风险。

注意事项

不适合需要实时同步记忆或跨设备共享记忆的场景,仅处理本地旧 Session 文件。

常见问题

这个工具会删除我的对话历史吗?

会删除原始的 .jsonl 和 .trajectory.jsonl 文件,但前提是已成功提取关键记忆并写入 memory/ 目录。提炼失败的文件会被隔离,不会删除。

如何安装 Session Memory Extractor?

可以通过 git clone 仓库并运行 npm install 安装依赖,具体命令请参考下文安装部分。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/session-memory-extractor-x/raw/index.md 读取 Session Memory Extractor 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。