Skip to content

库索引 ​

九个仓颉库,按依赖方向分三层:基础层负责和模型说话,协议层负责和外面的世界说话,框架层把它们组装成能交付的产品。MCP / A2A / ACP 三个协议层库共用同一套 JSON-RPC 底座(UHP 自己基于 stdx 实现 HTTP),所以选型时先看「对面要什么协议」,再决定拉哪个包。

库包名层一句话版本
Atelieratelier框架层可嵌入的 Agent Harness:推理循环、工具、上下文压缩、信任闸门都已实现0.1.15
Cordisystyle::cordis_core / cordis_host / cordis_plugin框架层微内核 + 进程隔离的插件系统,热插拔、崩溃自愈0.3.2
UHP Server不发中心仓(二进制产品)框架层把多个 harness 收敛成一个 UHP 常驻端点0.1.0
JSON-RPCystyle::jsonrpc + 5 个传输层包协议层JSON-RPC 2.0 框架,协议层的消息底座0.7.9
MCPmcp协议层Model Context Protocol 的客户端与服务端2.4.0
A2Aa2a协议层A2A v1.0 双向实现:Agent 之间互相调用0.1.1
ACPacp协议层ACP v1 双向实现:编辑器接入 Agent0.3.0
UHPuhp(+ uhp_acp / uhp_opencode)协议层Unified Harness Protocol 的 SDK 与两个现成适配器0.1.1
LLM APIllm_api基础层OpenAI / Anthropic / Ollama 一套接口打通1.4.2

版本号取自各库的 cjpm.toml(monorepo 取子成员里的那一份);实际能拉取的版本以中心仓为准。

基础层:模型访问 ​

把「发一次请求、收流式增量、解析工具调用」封装成统一接口,屏蔽三家协议差异。上层框架不该直接写 HTTP。

  • llm_api —— 同步 chat() + 流式 chatStreaming(),五种消息角色、工具调用、推理内容、图片输入。

协议层:和外部世界说话 ​

同一个底座(json-rpc)+ 各自协议的语义层,因此这几个库的用法形状高度相似:Server 注册 handler、Client 发请求,类型都实现 stdx.encoding.json.stream 的序列化接口。

  • json-rpc —— 纯消息层,不绑定任何协议语义;stdio / TCP / Unix Socket / HTTP / WebSocket 五种传输。
  • mcp —— 把工具、资源、提示词暴露给模型侧,也支持反向作为客户端连别的 MCP 服务器;推荐 Streamable HTTP(2025-11-25)。
  • a2a —— Agent 与 Agent 互通:Agent Card 发现、任务生命周期、SSE 流式、推送通知;JSON-RPC 与 HTTP+JSON 双绑定。
  • acp —— 编辑器接入:以子进程 + stdio 被 Zed / opencode 拉起,session/prompt 流式回包。
  • uhp —— 常驻 Harness 协议:把「一个能被反复调用的 agent 端点」标准化,自带 opencode 2.x 与 ACP 两个适配器。

框架层:组装成产品 ​

协议层给出「怎么说话」,框架层给出「说什么、记住什么、允不允许」。

  • atelier —— 全栈 Harness:Agent 循环 + 工具系统 + 会话树 + 上下文压缩 + 信任闸门,并同时实现 MCP / A2A / ACP / UHP 四端。
  • cordis —— 不绑定 Agent 的通用组合框架:插件独立进程运行,卸载即杀进程,用声明式配置做调和。
  • uhp-server —— 把 UHP 协议做成常驻服务的成品,可选把适配器放进 cordis 托管的独立进程。

依赖关系 ​

llm_api ──▶ atelier
json-rpc ──▶ mcp / a2a / acp / cordis
mcp / a2a / acp / uhp ──▶ atelier
uhp ──▶ uhp-server ◀── cordis

链路很短,所以按需拉包就行:只写一个 MCP 服务器,装 mcp 一个包即可;要完整 Agent,装 atelier 会把协议层一起带进来。

接着读 ​

以仓颉语言构建的 Agent 生态