Mibayy/token-savior

解决的问题

Token Savior 旨在减少 AI 编码代理（如 Claude Code）在回答简单问题时通常需要读取整个文件，或在会话间丢失上下文所导致的巨大令牌消耗和成本。它解决了三个主要问题：低效的代码库导航、会话间缺乏持久记忆，以及消耗会话预算的冗余 Bash 输出。

工作原理

该项目实现了一个 Model Context Protocol (MCP) 服务器，提供多层优化：

• 结构化代码导航： 不再读取整个文件，而是通过符号（函数、类、导入、调用图）对代码库进行索引，使代理能够通过指向特定代码段的指针进行导航。
• 持久化内存引擎： 使用 SQLite（WAL + FTS5）和向量嵌入存储决策、修复和规范，并在新会话开始时以紧凑的增量形式重新注入。
• Bash 优化：
  • PreToolUse 重写器： 在命令执行前修改 Bash 命令，以生成更小、更节省令牌的输出。
  • PostToolUse 压缩器： 在工具返回后将 Bash 输出渲染为节省令牌的格式，同时将完整输出保存在捕获沙箱中以供后续查询。

适用人群

使用 AI 编码代理（如 Claude Code、Cursor、Gemini 或 Codex）并希望降低 API 成本、减少延迟，并提升代理在不同会话间保持上下文能力的开发者。

主要亮点

• 显著减少令牌使用： 在 tsbench 基准测试中，每个任务的活跃令牌数报告减少了 80%。
• 定制化配置文件： 提供多种配置文件（如 optimized、tiny、full），用于在暴露的工具数量和 manifest 令牌成本之间取得平衡。
• 广泛的 Bash 支持： 包含 34 种不同压缩器，支持 git、gh、kubectl、docker 以及各种测试/ lint 框架等常用工具。
• 代理无关性： 虽然针对 Claude Code 优化，但也为非 MCP 代理（如 Cursor 和 Aider）提供 CLI 工具。