Fast Jev Compaction教程:4.3k星Claude Code插件,无损上下文压缩

📌 项目:tamaratran/fast-jev-compaction | 星数:4.3k(TypeScript,MIT)| 日期:2026-09-20 | 今日 GitHub Trending +0 | 来源:GitHub | Trending详情

📋 项目简介

Fast Jev Compaction(4.3k星,MIT,TypeScript)是Claude Code插件,用Jev评分替代LLM摘要式压缩。它对每个工具调用/结果评分,一次请求评估整个对话,过时的删除或截断,保留的内容原样不动——无损压缩。也可作为npm独立库使用。与 Claude Code自定义技能插件 配合,可构建更可控的上下文管理。

📊 核心特性

特性说明
Jev评分替代摘要用轻量模型评分而非LLM重写,无损压缩
工具调用配对按tool_use_id配对调用与结果,精准定位
分阶段压缩先截断后折叠,工具输入1000→200→60字符
保留最近消息preserveRecentMessages保护最近N条不动
npm独立可用既能做插件,也可作为npm库集成
即装即用Claude Code插件机制,零配置接入

⚡ 安装与运行

# 作为 npm 包使用
npm install fast-jev-compaction

# 作为 Claude Code 插件
# 在 Claude Code 设置中启用 fast-jev-compaction
# 插件会自动接管上下文压缩流程

# 关键参数
# preserveRecentMessages: 保护最近消息数(默认值)
# maxStateTokens: 状态token上限(默认 25k)

💡 使用建议

📚 常见问题

这和Claude Code自带压缩有什么区别?

自带压缩用LLM生成摘要(有损),本插件用Jev评分只删不重写(无损)。文件路径、错误信息等关键信息不会消失。

Jev是什么?

一个轻量模型,对每个工具调用评分判断是否还有用。一次请求评估整个对话,速度快。

会丢失重要信息吗?

不会。用户和助手文本原样保留,只删除Jev判定为过时的工具调用结果。最近的消息受保护不会被删除。