ClaudeMap

compact-adviser

只回答一个问题的 agent 插件:现在该不该 /compact?由 Jev 判断当前会话是否落在可安全压缩的边界上。

插件与代理contextcompactionpluginjevtoken-savings

compact-adviser 盯着每一轮落定的回合,用 TypeSafe 的 Jev 问两个一句话问题——这轮工作做完了吗、这是亲手干活还是协调指挥——在代码里合成一个分数。提示门槛随上下文滑动:几乎为空(约 10% 以内)时是 0.90,到约 90% 满时降到 0.50——还有余量时错误提示的代价最大。它可以选择只给提示,也可以在你显式授权后(仅 Pi 与 Claude Code)在合适的时机自动执行压缩;Codex CLI 与 Grok Build 只做提示,因为它们没有任何会话外进程能触发 /compact。本地门控保证它在 4 万 token 下限以下、非交互会话、以及设置了 COMPACT_ADVISER_DISABLE 时保持沉默。

它做什么

  • 四个宿主共用同一套判断:Pi 0.82+、Claude Code 2.1.274+、Codex CLI 0.153+、Grok Build 1.0.34(Node 22+,Codex 与 Grok 需 22.18+)
  • Claude Code 以插件安装(marketplace add kunchenguid/compact-adviser),需要实验性的 Claude Mod 开关 CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1
  • 在带追问标注的金标集(96 个检查点、40 场会话)上评估:随窗口变满而放松的门槛在保持高精确率的同时拉高召回
  • 隐私有界且有文档:至多最近 64 条可见回复、裁剪过的摘录、32,000 字节上限、尽力抹除密钥、密钥只进 Authorization 头——不能离开机器的材料请用 Off 模式或卸载

什么时候用

压缩时机靠猜的长会话:压早了丢工作上下文,压晚了宿主在任务中间强制压缩。也适合无人值守运行——export COMPACT_ADVISER_DISABLE=1 后顾问完全沉默。

如何上手

claude plugin marketplace add kunchenguid/compact-adviser
claude plugin install compact-adviser@compact-adviser
CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 claude
# 然后运行 /compact-adviser(status 会显示 Key: env / saved / .env)
# 需要一个 TypeSafe API 密钥(TYPESAFE_API_KEY)

注意事项

需要 TypeSafe API 密钥,安装即视为同意把符合条件的检查点上下文发送给 TypeSafe——README 的表格写明了发什么、不发什么,但文档明说这不是保证:必须留在本机的材料请用 Off 模式。Claude Code 路径依赖实验特性开关 CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1。自动压缩只存在于 Pi 与 Claude Code(首次使用需确认);Codex 与 Grok 只能提示。MIT。

代码仓库

kunchenguid/compact-adviser

收录日期

地图上的相关资源

  • CometixCode

    插件 / 代理

    非官方的 Claude Code 终端 UI 复刻:用 Rust 按 1:1 逐文件移植到 iocraft 这套 React 风格 TUI 框架上。

    • terminal-ui
    • rust
    • reimplementation
    • unofficial
  • Abide

    插件 / 代理

    把 AGENTS.md、CLAUDE.md 里的自然语言规则变成钩子级强制:每次编辑都被评审,违规当场修复。

    • hooks
    • code-review
    • rules
    • agents-md
  • fast-jev-compaction

    插件 / 代理

    用 Jev 评分式修剪取代有损压缩摘要的 Claude Code 插件:过期的工具调用被丢弃,保留下来的内容原样不动。

    • plugin
    • context-management
    • compaction
    • function-hooks