@alint-js/model-adapter-acp

中文文档
0.7.3发布于 2026/09/29MITTypeScriptES Module近 30 天下载 9.4万

代理客户协议编码代理的 OpenAI 兼容 HTTP 网关

中文使用文档
文档目录5 节
  1. 它会做什么
  2. 如何使用一个命令
  3. 如何嵌入非加太公司的连接
  4. 何时使用
  5. 不使用时

@alint-js/model-adapter-acp

一个兼容ACP编码代理的HTTP网关.

它会做什么

软件包将 ACP 会话语义保留在 alint外. 它暴露了被配置的非加太公司代理人 OpenAI 兼容模型和执行器 :

  • GET /v1/models
  • 非流式和SSE 文本聊天补全
  • 通过 MCP 流式 HTTP 向 ACP 曝光的 OpenAI 函数工具
  • 推迟 tool_calls 以后继续 role: tool 消息
  • tool_choice、使用、中止、继续 TTL 和权限拒绝处理

综合套房还开着一个真正的 runAlint 文件规则通过 ctx.model()时,xsAI generateStructured,这个 HTTP 网关,一个非加太会话,和 MCP reportFindings 前一个工具 坚持阿林特的诊断结果.

MCP大桥采用随机路线和无记名符号,用于每次完成转弯. 当大众 网关地址不是回放, 配置 mcpBaseUrl; 请求主机信头不可信 选择认证的 MCP 目的地.

非加太国家与OpenAI没有同等地位 temperature,而最终的非加太公司用途则无法使用 等待工具调用 。 使用 onCompatibilityDiagnostic 观察这些案件。 待决 工具调用响应报告零使用,因为 xsAI 需要 OpenAI usage 对象.

如何使用一个命令

createCommandModel 用途 tinyexec 每个完成一个非加太进程. startGateway 拥有回回转的HTTP服务器,关闭后关闭活动ACP进程.

import { createCommandModel, startGateway } from '@alint-js/model-adapter-acp'

const gateway = await startGateway({
  cwd: process.cwd(),
  models: [createCommandModel({
    command: 'codex-acp',
    cwd: process.cwd(),
    id: 'codex',
    name: 'Codex ACP',
  })],
})

console.info(gateway.endpoint)
await gateway.shutdown()

闪烁的 CLI 将这个接口包起来. 用户通常设置 driver = "acp" 或 .alint/config.toml 而不是自己开始门户.

如何嵌入非加太公司的连接

import { createGateway } from '@alint-js/model-adapter-acp'
import { serve } from 'h3/node'

const app = createGateway({
  cwd: process.cwd(),
  mcpBaseUrl: 'http://127.0.0.1:7419',
  models: [{
    id: 'reviewer',
    name: 'Review Agent',
    openConnection: async () => ({
      kind: 'stream',
      stream: await openYourAcpStream(),
    }),
  }],
})

const server = await serve(app, { hostname: '127.0.0.1', port: 7419 }).ready()

// On shutdown, stop accepting HTTP first, then cancel retained ACP continuations.
await server.close()
await app.shutdown()

openConnection 接受正式的非加太公司 AgentApp 或者说 Stream。嵌入式应用程序可以不使用命令适配器而拥有不同的传输或生命周期政策.

其他OpenAI兼容的消费者可以使用由此而来的一般提供者端点:

[[providers]]
id = "acp"
type = "openai-compatible"
endpoint = "http://127.0.0.1:7419/v1"

何时使用

  • 您需要现有的 OpenAI 兼容消费者来调用 ACP 编码代理 .
  • 在使用请求工具时,非加太公司代理在HTTP上支持MCP.
  • OpenAI 客户端执行函数调用并返回 role: tool 留言.

不使用时

  • 当规则故意依赖于特定代理人的行为时,使用取精剂适配器.
  • 不要使用此软件包作为 OpenAI 响应, 实时, 音频, 或图像相容层 .
  • 序列工具调用工作与流式和非流式聊天完成.
  • 不支持并行工具调用 .

版本与发布记录

@alint-js/model-adapter-acp 共发布 7 个版本,首次发布于 2026/08/08;过去 12 个月发布了 7 个版本。

版本发布日期距今
0.7.3latest2026/09/291 个月前
0.7.22026/09/281 个月前
0.7.12026/08/292 个月前
0.7.02026/08/292 个月前
0.6.02026/08/192 个月前
0.5.02026/08/162 个月前

关于 @alint-js/model-adapter-acp 的常见问题

@alint-js/model-adapter-acp 是什么?

代理客户协议编码代理的 OpenAI 兼容 HTTP 网关

如何安装 @alint-js/model-adapter-acp?

在项目目录运行 npm install @alint-js/model-adapter-acp,或使用 pnpm add / yarn add / bun add。

@alint-js/model-adapter-acp 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@alint-js/model-adapter-acp 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@alint-js/model-adapter-acp 可以商用吗?

@alint-js/model-adapter-acp 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@alint-js/model-adapter-acp 的下载量有多少?

根据 npm 官方下载统计,@alint-js/model-adapter-acp 在 2026/10/06 – 2026/11/04 这 30 天内被下载 93,600 次,日均约 3,120 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@alint-js/model-adapter-acp 还在维护吗?

最新版本 0.7.3 发布于 2026/09/29(1 个月前);至今共发布 7 个版本,其中过去 12 个月发布了 7 个;首次发布于 2026/08/08。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。