1ay1/agentty

解决的问题

agentty 是一个高性能的终端编码代理，旨在取代笨重且依赖运行时的工具。它解决了启动缓慢、因“上下文转储”（将整个存储库发送给 LLM）而导致的高额 Token 成本，以及厂商锁定问题，通过提供一个快速且模型无关的二进制文件，仅检索最相关的代码片段。

运作原理

agentty 使用 C++26 编写，作为单一静态二进制文件运行，不依赖 Node.js 或 Python。它使用先进的本地 RAG（检索增强生成）引擎，结合 BM25 关键字搜索与密集向量嵌入，来获取特定的代码片段。

核心架构特色包括：

• 智能模式 (Smart Mode)：采用协调者-工作者设计，由旗舰模型规划任务，并根据复杂度将任务委派给成本较低的模型。
• 沙盒机制 (Sandboxing)：Shell 和构建指令在操作系统强制执行的沙盒中执行（Linux 上使用 seccomp/landlock，macOS 上使用 seatbelt），以确保安全性。
• 本地 RAG 管线：包含倒数排名融合 (Reciprocal Rank Fusion)、重排序 (re-ranking) 和 GraphRAG 扩展的多阶段漏斗，在无需云端依赖的情况下提供高精度的上下文。

目标用户

适合希望在终端中使用极速、注重隐私的编码助手，且能与任何 LLM 提供商（包括通过 Ollama 使用的本地模型）协作，并支持离线环境的开发者。

特色亮点

• 极致性能：冷启动时间小于 1ms；单一静态二进制文件 (~16.7 MB)。
• 模型无关：支持 Claude, GPT, Groq, OpenRouter, Ollama, DeepSeek, xAI, Gemini 和 Fireworks。
• 进阶检索：本地混合 BM25 + 向量嵌入，结合 GraphRAG 与源码语义搜索。
• 安全优先：默认 Shell 调用沙盒化，并通过 SSH 中继支持离线模式。
• 整合工具：提供完整的读取、写入、编辑和搜索代码工具套件，并能在终端中交互式执行代码块。