Context Gatekeeper

🗜️ 智能压缩对话,节省 90% Token

通过智能摘要压缩对话历史,减少 API token 消耗,同时保留关键决策、待办事项和近期上下文,适用于长对话场景。

收藏
8.1k
安装
2.3k
版本
0.1.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

Context Gatekeeper 综合评估

核心用法

Context Gatekeeper 是一个用于优化大模型 API 调用成本的上下文管理工具。它通过本地脚本(Python)处理对话历史,生成精简摘要文件 context/current-summary.md,替代完整对话历史传入 API。工作流程包括:记录对话轮次 → 执行摘要脚本 → 注入摘要作为上下文 → 循环更新。脚本支持自定义参数:摘要句子数(默认 6 句)、保留的近期轮次数(默认 4 轮),以及输入输出文件路径。

显著优点

1. Token 经济性:显著降低长对话场景的 API 成本,避免重复计费历史消息
2. 焦点保持:通过显式提取 TODO、follow-up 等关键信息,防止模型注意力稀释

3. 架构简洁:纯本地处理,无需外部服务,可与任意模型 API 集成

4. 可审计性:生成结构化 Markdown 文件,便于人工核查与调试

5. 灵感来源可信:设计参考 OpenClaude 的 /compact 机制,有成熟实践背书

潜在缺点与局限性

  • 信息损失风险:强制压缩可能导致细节遗漏,依赖摘要质量
  • 单点依赖:未提及其他摘要策略(如语义向量化检索)作为 fallback
  • 格式约束严格:要求输入严格遵循 ROLE: texto 格式,容错性未说明
  • 无版本控制:频繁覆写 current-summary.md,历史摘要回溯需自行实现
  • TODO 提取规则黑箱:基于关键词匹配(TODO、próxima ação 等),可能漏检或误检

适合人群

  • 高频使用 Claude/OpenAI API 且对话长度常超上下文窗口的开发者
  • 追求成本控制的 AI 应用架构师
  • 习惯本地优先、文件驱动工作流的工程师
  • 需要可解释上下文管理的合规敏感场景

常规风险

  • 脚本执行安全:需审查 Python 脚本无恶意行为(如文件越界读写、网络请求)
  • 提示注入漏洞:若历史记录包含恶意内容,摘要可能将其保留并传入后续 API
  • 状态同步失败:脚本执行失败或文件读写竞态可能导致上下文断裂
  • 过度压缩导致幻觉:关键信息被截断后,模型可能基于不完整摘要产生错误推断

安全认证说明

> ⚠️ 当前安全认证报告为系统自动生成的占位符,未执行实际安全扫描。建议在使用前完成代码审计与沙箱测试。

Context Gatekeeper 内容

context文件夹
scripts文件夹
手动下载zip · 8.5 kB
current-summary.mdtext/markdown
请选择文件