# CoRA: Collaborative Runtime for Agents

CoRA 是一个面向 openEuler 的低开销多智能体协作运行时系统。

本项目围绕多 Agent 协作中的通信开销、状态传递冗余和共享记忆复用问题，设计并实现结构化通信协议、非文本状态传递机制和共享记忆模块，并通过可复现实验对比纯文本协作模式与结构化协议协作模式在 token 开销、任务耗时、消息次数和记忆复用效果方面的差异。

## 项目定位

CoRA 采用“控制面 + 数据面”分离思路：

- 控制面：通过轻量结构化协议完成 Agent 间握手、能力发现、任务调度和消息路由；

- 数据面：通过 StateRef / Shared Memory State Store 传递中间状态，减少大段文本在 Agent 间反复传递；

- 记忆层：将任务过程中的摘要、证据链、经验片段和策略沉淀为可检索、可复用的共享记忆单元；

- 评测层：统计 token 开销、字符开销、消息次数、任务耗时、状态传递次数、记忆命中率等指标。

## 当前阶段

Phase 0：项目骨架初始化。

## 目录结构

cora/

├── cora/ # 核心源码

├── docs/ # 文档

├── scripts/ # 运行脚本

├── examples/ # 示例任务

├── tests/ # 测试代码

└── results/ # 实验结果

## 赛题说明

官方赛题原始 README 已备份至：

docs/official_problem.md