AI导哈

上下文管理插件

一个用于Claude Code的插件，通过MCP工具和钩子实现主动的上下文窗口管理，包括保存/加载结构化检查点、跟踪重复工具使用和标记子任务完成以安全减少上下文。

  • by DxTa
  • JavaScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 DxTa/claude-dynamic-context-pruning

使用说明

上下文管理器--克劳德代码插件

通过MCP工具+钩子进行主动上下文窗口管理。让克劳德明白 保存/加载结构化检查点的工具，这些检查点可以在压缩后幸存下来，跟踪重复 以减少安全上下文。

背景

该插件基于三篇论文：

  • 动态上下文修剪 (arXiv 2305.15805)——“DCP”名称的起源；演示了可学习的令牌修剪，在不损失质量的情况下实现了高达80%的上下文减少
  • CAT/上下文作为工具 (arXiv 2512.22087)——主要建筑影响；提出了一种结构化的3段工作空间，模型通过工具调用主动管理自己的上下文
  • 复杂性陷阱 (arXiv 2508.21433)--验证简单的观察掩蔽（删除过时的工具输出）是否与基于LLM的摘要质量相匹配，从而证明了这里基于钩子的方法

为什么它在实践中有所帮助： 状态（任务进度、决策、文件上下文）在压缩之前写入磁盘，然后恢复，因此不会丢失任何内容。检测并警告重复的工具读取，减少重新读取相同文件时浪费的令牌。子任务边界为模型提供了安全、可预测的压缩点，而不会丢失关键上下文。

需求

  • Node.js >= 20
  • jq公司 （钩子脚本需要）
  • bash （钩子脚本需要）
  • 克劳德代码 支持插件

安装

git clone https://github.com/DxTa/claude-dynamic-context-pruning.git ~/.claude-plugins/context-manager
cd ~/.claude-plugins/context-manager && ./setup.sh
claude --plugin-dir ~/.claude-plugins/context-manager

这 --plugin-dir flag加载所有三个层：MCP服务器、钩子和技能。这三个都是正确操作所必需的——钩子在压实过程中自动保存/恢复，该技能教模型何时以及如何使用这些工具。

包含内容

图层 用途 文件
MCP服务器 模型管理其上下文的6个工具 server/
钩子 压缩前自动保存，压缩后自动恢复，跟踪重复项 hooks/
技能 行为指导，教模型何时/如何使用工具 skills/
配置 插件清单、MCP注册、钩子定义 根文件

MCP工具

  • save_checkpoint --保存结构化状态（任务、文件、决策、错误）
  • load_checkpoint --压缩后或会话之间恢复状态
  • mark_complete --安全上下文压缩的信号子任务完成
  • get_context_stats --查看会话统计信息和重复读取警告
  • list_checkpoints --枚举所有已保存的检查点
  • track_tool_usage --记录工具使用事件（通常由钩子调用）

钩子

  • 预紧 --压缩前自动从转录中提取状态
  • 会话启动（紧凑型） --压缩后注入恢复文本
  • PostToolUse（读取| Bash） --跟踪重复读取，在3时发出警告+

运作原理

  1. 模特阅读技巧→ 学习上下文管理协议
  2. 模型调用 save_checkpoint 在子任务边界处
  3. 模型调用 mark_complete 当工作完成时
  4. 压缩时：PreCompact挂钩自动保存→ 压实作业→ SessionStart钩子注入恢复
  5. 模型调用 load_checkpoint 压缩后恢复完整上下文
  6. get_context_stats 显示重复数据消除警告→ 模型停止重新读取

国家坚持 .claude/context-state/ 在项目目录中。

平台支持

平台 判决
Linux/Ubuntu ✅ 全力支持
macOS ✅ 完全支持--通过安装jq brew install jq
Windows（WSL2） ✅ 全力支持
Windows（本机） ❌ 不支持--没有bash
Windows（Git Bash） ❌ 不支持--默认情况下jq不可用

挂钩需要 bash 和 jq。不支持没有两者的平台。

发展

cd server
pkgx npm install
pkgx npm run bundle   # Single-file esbuild bundle (recommended, no runtime node_modules)
pkgx npm run build    # TypeScript tsc compilation

许可证

麻省理工学院

相关 MCP