fast-jev-compaction

它做什么

• 从不总结：只删除或截断 Jev 评分判定不再需要的工具调用与结果——留下的每一条都原样保留
• 每个调用三选一：保留结果、保留调用但截断结果、或成对丢弃；最近的消息受保护不动
• 双重形态：既是 npm 库（compactMessages、reductionRatio、可注入的 JevAsker），也是接管 /compact 与自动压缩的函数钩子插件
• 失败即回退：Jev 出错、答案畸形或删减不足时，自动退回 Claude Code 内置摘要

什么时候用

需要早期轮次的文件路径、原始报错或约束在压缩后依然存活的长时间会话；也适合想做程序化对话修剪、希望删除决策附带概率而不是有损改写的人。

如何上手

# 1. 把 TypeSafe API 密钥写进 ~/.claude/settings.json
# （Claude Code v2.1.287 起 mods 默认开启——README 仍要求的抢先体验开关已被忽略，无需设置）：
{ "env": { "TYPESAFE_API_KEY": "<你的密钥>" } }

# 2. 安装插件：
claude plugin marketplace add tamaratran/fast-jev-compaction
claude plugin install fast-jev-compaction@fast-jev-compaction

# 3. 重启 Claude Code 或执行 /reload-plugins
# 此后 /compact 按原文字修剪，提示条会报告 kept N/M 或回退

注意事项

需要 TypeSafe API 密钥，并会把对话状态发给 TypeSafe 的 Jev 做评分。函数钩子已于 Claude Code v2.1.287（2026-10-01）随 Claude Mods 默认开启；README 仍保留抢先体验开关的说明，但官方文档明确该开关自该版本起被忽略。核验时（2026-09-19）README 提到的 npm 包尚未发布到公共 registry，可用的安装路径是插件。保留概率不等于结果可以安全删除——被丢弃的工具可能得重跑。MIT。