ARCANADA
← 生态系统 / Model Connector
已上线 L2 · 目标 L3

Model Connector

连接 AI CLI 智能体与云端模型提供商的统一 API。

一个兼容 OpenAI 的统一端点,连接 Cursor、Claude Code、Gemini CLI、Codex 和 OpenRouter。使用 NestJS + Fastify,监听端口 3900,已在 connector.arcanada.ai 上线。公开仓库采用 MIT 许可证。内部基准测试记录了明确取舍:CLI 连接器缺少 json_schema 和并发支持,因此不能在 Graphiti、Cognee 或 LangChain 智能体等框架中替代 OpenAI API;对于需要结构化输出的任务,应使用 OpenRouter 或直接 API。

自主性(AAL)
L2 → L3
技术栈
NestJS + Fastify,端口 3900
端点
connector.arcanada.ai
许可证
开源,MIT

01

一个端点,多个提供商

通过一个兼容 OpenAI 的端点连接 Cursor、Claude Code、Gemini CLI、Codex 和 OpenRouter。

02

配额与用量记录

按租户限流和设置配额,并按请求、按租户记录 token 用量。

03

以能力矩阵说明实际支持

逐个连接器记录 json_schema 和并发支持情况,让调用方清楚每个连接器能做什么。

CLI 的取舍

内部基准测试记录了明确取舍:CLI 连接器缺少 json_schema 和并发支持,因此不能在 Graphiti、Cognee 或 LangChain 智能体等框架中替代 OpenAI API。

对于需要结构化输出的任务,应使用 OpenRouter 或直接 API。

能力

已实现的能力

  • 兼容 OpenAI 的 /chat/completions 端点(/execute 返回 HTTP 201)
  • 连接器:Claude CLI、Cursor、Gemini、Codex、OpenRouter
  • 按租户限流和设置配额
  • 按请求及按租户记录 token 用量
  • 采用 MIT 许可证的公开仓库(Arcanada-one/model-connector)
  • 104 项测试覆盖全部四个 CLI 连接器
  • 已记录能力矩阵(逐个连接器列明 json_schema / 并发支持)

当前自主性等级

L2
等级说明(英文)→

当前限制

CLI 连接器本身较脆弱:智能体发生逻辑错误时仍可能以退出码 0 结束,不支持结构化输出,并发一次只能处理一个请求。提供商之间没有自动回退链;如果 Claude CLI 挂起,请求也会挂起。

达到以下目标等级的路线图:L3

  1. 提升至 L3——连接器启动自检;通过 Zod 验证输出模式;按连接器对失败分类。
  2. 提升至 L4——提供商回退链(Claude → OpenRouter → OpenAI),为每个连接器配置熔断器,并按租户设置硬性成本熔断。
  3. L5 候选——根据任务复杂度、预算和结构化输出要求自动路由到提供商。

相关链接

下一步

了解已上线产品及其当前限制

“已上线”表示项目目前可用;上方的当前限制和路线图说明了该版本的能力边界。

查看达到目标等级的路径

本页展示完整的项目说明。专用目录、运行时详情或附加材料目前仍在英文扩展视图中。 打开扩展视图(英文) →