Mibayy/token-savior

解决的问题

Token Savior 旨在减少 AI 编码代理（如 Claude Code）中常见的巨大令牌消耗和上下文窗口膨胀问题。它解决了三个主要问题：代理倾向于为获取少量信息而读取整个文件、重启后会丢失会话记忆，以及冗长的 Bash 输出造成的噪声，消耗了对话预算。

工作原理

该项目作为一个 Model Context Protocol (MCP) 服务器运行，提供多层优化：

• 结构化导航：不读取整个文件，而是通过符号（函数、类、导入、调用图）对代码库进行索引，使代理能够通过指针进行导航。
• 持久化内存：结合使用 SQLite（WAL + FTS5）和向量嵌入，存储决策、修复和规范，并在新会话中以紧凑的增量形式重新注入。
• Bash 优化：
  • PreToolUse 重写器：在命令执行前对其进行编辑，生成更小、更高效的输出，以减少模型接收的负担。
  • PostToolUse 压缩器：应用 34 种不同的纯函数压缩器（适用于 git、docker、kubectl 等），以节省令牌的方式呈现工具输出。虽然这些压缩器不会缩小当前回合的大小，但它们会将完整输出保存在“捕获沙盒”中，使其在上下文压缩中得以保留。
• 配置文件：提供不同的工具清单（如 optimized、tiny、full），以控制模型可见的工具数量，进一步减少清单令牌消耗。

适用人群

主要面向使用 AI 编码代理（如 Claude Code、Cursor、Gemini 或 Codex）的开发者，希望降低令牌成本、加快代理响应速度，并在编码会话间保持持久记忆。

主要亮点

• 显著减少令牌使用：在 tsbench 基准测试中，每个任务的活跃令牌减少了 80%。
• 基于符号的索引：用直接符号查找替代 cat 和 grep 链。
• PreToolUse 重写：在问题发生前主动修改命令，防止令牌膨胀。
• 持久化内存引擎：使用贝叶斯有效性与 ROI 排名管理长期项目知识。
• 广泛工具支持：包含 34 种针对常见 CLI 工具（如 git、gh、pytest、aws-cli）的专用压缩器。