aovestdipaperino/tokensave

tokensave – AI编码代理的语义代码智能

简介 – tokensave是一个基于Rust的本地代码索引服务器，可构建项目源代码的语义知识图谱。AI驱动的编码助手（Claude、Gemini、Cursor、Copilot等）可以查询此图谱，而不是grep或读取文件，从而大幅减少在“探索”操作上花费的token数量。

重要性 – 大型语言模型代理按token计费。使用grep、find或类似工具扫描存储库可能会在代理开始编写代码之前消耗数百个token。通过预先索引符号、调用图和关系，tokensave让代理在单次工具调用中获取精确的符号、其调用者和代码片段，从而节省成本和延迟。

主要功能

• 语义搜索 – 按含义（例如“authentication”）查找代码，并接收结构化结果：入口点、相关符号和源代码片段。
• 影响分析 – 跟踪调用者、被调用者以及任何符号的完整变更范围。
• 多分支支持 – 可选的每分支数据库，可重用祖先分支的工作，因此切换分支永远不会强制完全重新索引。
• 崩溃恢复同步 – 解析在短期子进程中运行；Tree-sitter语法中的段错误只会终止工作进程，而不会终止整个索引作业。
• 原子编辑原语 – 安全、AST感知的替换/插入操作，自动重新索引受影响的文件。
• 广泛的语言覆盖 – 50多种语言，包括Rust、Go、Python、TypeScript、C/C++、Swift、着色器语言等。
• 代理集成 – 为Claude Code、Gemini CLI、Cursor、Copilot等12多个代理提供即用型MCP（元编码协议）工具定义。

使用方法

1. 安装 – 通过Homebrew、Scoop、cargo binstall或macOS、Linux和Windows的预构建二进制文件。
2. 注册代理 – tokensave install --agent <name>将必要的MCP服务器条目和钩子配置写入每个代理的原生配置（例如~/.claude.json）。--local标志可让您将注册保持为项目特定。
3. 创建索引 – tokensave init创建一个.tokensave/目录，其中包含带有图谱的libSQL数据库。后续更改使用tokensave sync应用。
4. 从代理查询 – 代理调用tokensave_search、tokensave_branch_search或编辑原语等MCP工具；服务器返回即时、结构化的结果。

安装亮点

• 跨平台 – 适用于macOS（Apple Silicon）、Linux（x86_64/ARM64）和Windows的二进制文件。
• 功能层级 – lite、medium和full二进制文件让您可以在二进制大小和语言覆盖范围之间进行权衡。
• 零信任 – 所有数据保留在设备上；不需要API密钥或外部服务。

高级功能

• 多分支索引 – 如tokensave branch add/list/remove等命令让您维护每个Git分支的单独图谱，并通过Git钩子自动后台跟踪。
• 子进程隔离提取 – 防止单个格式错误的文件停止整个同步。
• 跨会话内存 – 某些MCP工具在代理会话之间持久化上下文（详情请参阅文档）。

适用对象 – 严重依赖LLM编码助手并希望减少token消耗、提高响应速度并保持代码分析完全本地的团队。

了解更多 – 存储库的README、docs/BRANCHING-USER-GUIDE.md文件以及crates.io上的crate页面提供了更深入的使用说明和配置详细信息。