acplause – OpenAI uyumlu API'ler için bir ACP aracısı
Özgün başlık: acplause – An ACP agent for OpenAI-compatible APIs
Ne oldu
OpenAI uyumlu API'ler ile çalışmak üzere tasarlanan acplause adlı yeni bir Agent Client Protocol v2 (ACP v2) aracısı duyuruldu. Editör ile standart girdi/çıktı (stdio) üzerinden iletişim kuran bu araç, OpenRouter başta olmak üzere herhangi bir OpenAI uyumlu Sohbet Tamamlama API'si aracılığıyla akıl yürütme yeteneği sergiliyor ve araçlar vasıtasıyla çalışma alanında görev yapıyor.
Neden önemli
Araç döngüleri, sınırlar ve hata yönetimi konularında behavioral referans kabul edilen acp-bridge projesinden ilham alan acplause, sabitlenmiş ACP v2 şartnamesine uyum sağlıyor. Projenin geliştiricileri yazılımın deneysel aşamada olduğunu ve takvim tabanlı sürüm numaralarının herhangi bir uyumluluk taahhüdü barındırmadığını belirtiyor.
Teknik detaylar
Kurulum süreci, Go dilini bir derleme bağımlılığı olarak kullanarak etiketli kaynağın yerel makinede derlenmesiyle gerçekleştiriliyor. macOS üzerinde yerel derleme tercihi, ücretli bir Apple Developer ID sertifikası gereksinimi olmadan veya indirilen ikili dosyalardan karantinayı kaldıran kurulum kancalarına ihtiyaç duyulmadan dağıtım yapılmasına imkan tanıyor. Bunun dezavantajı ise SQLite bağımlılığının derlenmesi dahil ilk kurulumun daha yavaş sürmesi olarak öne çıkıyor.
Go kurulumu yapmak istemeyen kullanıcılar için GitHub Releases üzerinden macOS ve Linux işletim sistemleri ile arm64 veya amd64 mimarilerine uygun hazır arşivler sunuluyor. Bu arşivler SHA256 sağlama toplamları ve GitHub eser tasdiklerini içeriyor. macOS için önceden derlenmiş ikili dosyalar imzalanmamış veya noter tasdikli olmadığından, işletim sistemi çalıştırılması için açık onay isteyebiliyor.
Kimi etkiler, ne yapmalı
Aracı kullanmak için ACP v2 istemcisinin, sağlayıcı anahtarını içeren ACPLAUSE_API_KEY değişkeni ile acplause başlatacak şekilde yapılandırılması gerekiyor. Varsayılan sağlayıcı OpenRouter olmakla birlikte, farklı bir OpenAI uyumlu API kökü için ACPLAUSE_BASE_URL ayarlanabiliyor. Anahtar girilmediği durumlarda yetkilendirme başlığı gönderilmiyor ve bu sayede uyumlu yerel sağlayıcılar destekleniyor.
İlk komut gönderilmeden önce istemci üzerinden bir model seçilmesi gerekiyor. Yeni oturumlar son kullanılan modeli ve akıl yürütme çabasını yeniden kullanırken, acplause asla otomatik bir ikame model seçimi yapmıyor. Sürüm notlarında önemli değişikliklerin vurgulandığı, ACP v2 protokolünün ise henüz bir taslak aşamasında olduğu ifade ediliyor.
What happened
acplause has been introduced as an Agent Client Protocol v2 (ACP v2) agent designed to work with OpenAI-compatible APIs. Communicating with your editor over standard input/output (stdio), the agent reasons using any OpenAI-compatible Chat Completions API—with OpenRouter as the default—and operates within your workspace utilizing tools.
Why it matters
Inspired by acp-bridge, which serves as a behavioral reference for tool loops, limits, and error handling, acplause adheres to the pinned ACP v2 specification for its wire protocol. The project is currently classified as experimental, and its calendar-based versioning does not guarantee compatibility across releases.
Technical details
The build formula compiles the tagged source directly on the user's machine, utilizing Go as a build dependency. On macOS, local compilation allows distribution without requiring a paid Apple Developer ID certificate or an installation hook to remove quarantine flags from downloaded binaries. The compromise for this approach is a slower initial installation due to compiling the SQLite dependency.
Alternatively, users who prefer not to install Go can download precompiled archives for supported operating systems (macOS and Linux) and architectures (arm64 and amd64) from GitHub Releases. These archives include SHA256 checksums and GitHub artifact attestations. Because prebuilt macOS binaries lack Developer ID signing and notarization, macOS may require explicit permission to execute them.
Who is affected, what to do
Users need to configure their ACP v2 client to launch acplause with the ACPLAUSE_API_KEY environment variable set to their provider key. While OpenRouter serves as the default provider, an alternative OpenAI-compatible API root can be specified using ACPLAUSE_BASE_URL. If no key is provided, the agent omits the Authorization header, allowing compatibility with local providers.
Before sending the first prompt, a model must be selected within the client. Subsequent sessions reuse the previous model and reasoning effort, and acplause does not substitute models automatically. Breaking changes are highlighted in release notes, and users should note that ACP v2 remains a draft specification.
Qué pasó
acplause se ha introducido como un agente Agent Client Protocol v2 (ACP v2) diseñado para funcionar con API compatibles con OpenAI. Al comunicarse con su editor a través de entrada/salida estándar (stdio), el agente utiliza cualquier API de finalización de chat compatible con OpenAI, con OpenRouter como predeterminado, y opera dentro de su espacio de trabajo utilizando herramientas.
Por qué es importante
Inspirándose en acp-bridge, que sirve como referencia de comportamiento para bucles de herramientas, límites y manejo de errores, acplause se adhiere a la especificación ACP v2 fijada para su protocolo de cableado. Actualmente, el proyecto está clasificado como experimental y su control de versiones basado en calendario no garantiza la compatibilidad entre versiones.
Detalles técnicos
La fórmula de compilación compila la fuente etiquetada directamente en la máquina del usuario, utilizando Go como dependencia de compilación. En macOS, la compilación local permite la distribución sin necesidad de un certificado de ID de desarrollador de Apple pagado o un enlace de instalación para eliminar indicadores de cuarentena de los archivos binarios descargados. El compromiso de este enfoque es una instalación inicial más lenta debido a la compilación de la dependencia SQLite.
Alternativamente, los usuarios que prefieran no instalar Go pueden descargar archivos precompilados para sistemas operativos (macOS y Linux) y arquitecturas (arm64 y amd64) compatibles desde las versiones GitHub. Estos archivos incluyen sumas de verificación SHA256 y certificaciones de artefactos GitHub. Debido a que los archivos binarios prediseñados de macOS carecen de firma y certificación de ID de desarrollador, es posible que macOS requiera permiso explícito para ejecutarlos.
Quién se ve afectado, qué hacer
Los usuarios deben configurar su cliente ACP v2 para iniciar acplause con la variable de entorno ACPLAUSE_API_KEY configurada en su clave de proveedor. Si bien OpenRouter actúa como proveedor predeterminado, se puede especificar una raíz API alternativa compatible con OpenAI utilizando ACPLAUSE_BASE_URL. Si no se proporciona ninguna clave, el agente omite el encabezado Autorización, lo que permite la compatibilidad con los proveedores locales.
Antes de enviar el primer mensaje, se debe seleccionar un modelo dentro del cliente. Las sesiones posteriores reutilizan el modelo y el esfuerzo de razonamiento anteriores, y los aplausos no sustituyen los modelos automáticamente. Los cambios importantes se destacan en las notas de la versión y los usuarios deben tener en cuenta que ACP v2 sigue siendo una especificación preliminar.
Что случилось
acplause был представлен как агент Agent Client Protocol v2 (ACP v2), предназначенный для работы с API-интерфейсами, совместимыми с OpenAI. Общаясь с вашим редактором через стандартный ввод/вывод (stdio), агент использует любой OpenAI-совместимый API-интерфейс Chat Completions — с OpenRouter по умолчанию — и работает в вашем рабочем пространстве, используя инструменты.
Почему это важно
Вдохновленный acp-bridge, который служит эталоном поведения для инструментальных циклов, ограничений и обработки ошибок, acplause придерживается закрепленной спецификации ACP v2 для своего проводного протокола. В настоящее время проект классифицируется как экспериментальный, и его управление версиями на основе календаря не гарантирует совместимости между выпусками.
Технические детали
Формула сборки компилирует исходный код с тегами непосредственно на компьютере пользователя, используя Go в качестве зависимости сборки. В macOS локальная компиляция позволяет распространять без необходимости платного сертификата Apple Developer ID или установочного крючка для удаления флагов карантина из загруженных двоичных файлов. Компромиссом для этого подхода является более медленная первоначальная установка из-за компиляции зависимости SQLite.
В качестве альтернативы пользователи, которые предпочитают не устанавливать Go, могут загрузить предварительно скомпилированные архивы для поддерживаемых операционных систем (macOS и Linux) и архитектур (arm64 и amd64) из GitHub Releases. Эти архивы включают контрольные суммы SHA256 и аттестации артефактов GitHub. Поскольку в готовых двоичных файлах macOS отсутствует подпись и нотариальное заверение идентификатора разработчика, macOS может потребовать явного разрешения для их выполнения.
Кто пострадал, что делать
Пользователям необходимо настроить свой клиент ACP v2 для запуска acplause с переменной среды ACPLAUSE_API_KEY, установленной в ключ их провайдера. Хотя OpenRouter служит поставщиком по умолчанию, альтернативный корень API, совместимый с OpenAI, можно указать с помощью ACPLAUSE_BASE_URL. Если ключ не указан, агент опускает заголовок авторизации, обеспечивая совместимость с местными поставщиками.
Прежде чем отправлять первое приглашение, в клиенте необходимо выбрать модель. Последующие сеансы повторно используют предыдущую модель и рассуждения, а аплодисменты не заменяют модели автоматически. Критические изменения выделены в примечаниях к выпуску, и пользователи должны иметь в виду, что ACP v2 остается черновой версией спецификации.