Swival/swival

解决的问题

Swival 是一款 CLI 编码代理，旨在提供可靠且实用的体验，专门针对通常具有紧凑上下文窗口和有限资源的较小型、本地模型进行了优化。它允许开发者跨各种模型提供商自动化编码任务（例如重构、审计和修复错误），而无需复杂的框架。

工作原理

Swival 作为一个自主工具循环运行，连接到各种 LLM 提供商（包括如 LM Studio 和 llama.cpp 的本地服务器，或如 Gemini 和 Claude 的云 API）。它通过渐进式压缩和持久化思考笔记来管理上下文，以防止代理在多步骤计划中迷失方向。它可以通过基于 SKILL.md 的技能、模型上下文协议 (MCP) 和自定义命令系统进行扩展。

适用人群

它专为想要一个灵活、轻量级编码代理的开发者打造，该代理可以使用开源模型在他们自己的硬件上运行，或利用现有订阅（如 ChatGPT Plus 或 Claude Pro）而无需单独的 API 密钥。

亮点

• 广泛的提供商支持：可与本地服务器（LM Studio、llama.cpp、ollama）、云 API 和现有的基于浏览器的订阅（ChatGPT Plus、Claude Pro）配合使用。
• 上下文韧性：使用渐进式压缩和状态保存，即使在上下文溢出或中断期间也能保持进度。
• 目标导向执行：/goal 命令强制代理坚持任务，直到它提供基于证据的完成结果或达到预算上限。
• 安全第一：具备透明的密钥加密功能，可向 LLM 提供商隐藏 API 密钥，并内置 /audit 命令用于安全漏洞扫描。
• 可扩展性：支持代理客户端协议 (ACP) 以进行编辑器集成（例如 Zed）、代理对代理 (A2A) 服务器模式，以及用于外部工具的 MCP。
• 基准测试工具：生成机器可读的 JSON 报告，用于比较模型在实际编码任务上的性能。