MARS: Multi-Agent Runtime with Shared memory

MARS 是一个面向 openEuler 的多智能体协作原型系统，目标是验证低开销通信、非文本状态传递与共享记忆复用机制。

本项目用于“中国研究生操作系统开源创新大赛”赛题：一种面向多智能体协作的低开销通信、状态传递与共享记忆机制。

目标运行环境为 openEuler 24.03-LTS-SP3。系统计划采用 Rust + Python 混合架构：

• Rust：负责协议、状态交换、指标采集，以及可选的 runtime IPC。
• Python：负责 Agent 行为、共享记忆、实验场景、评测与报告生成。

Docker 环境

Docker 镜像基于 openeuler/openeuler:24.03-lts-sp3。镜像中安装开发工具 rust, cargo, uv。

构建镜像：

docker build -t mars:openeuler-24.03-lts-sp3 .

启动交互式容器，并将当前仓库挂载到 /workspace：

docker run --rm -it \
  -v "$PWD":/workspace \
  -w /workspace \
  mars:openeuler-24.03-lts-sp3

当前模块

mars-protocol

mars-protocol 定义 Agent 间结构化通信消息，支持 CALL、RESULT、CAPABILITY、ERROR 和 StateRef 的 JSON 编解码。

本机运行测试：

cargo test -p mars-protocol

在 openEuler Docker 环境中运行测试：

docker volume create mars-cargo-home
docker volume create mars-cargo-target

docker run --rm \
  -v "$PWD":/workspace \
  -v mars-cargo-home:/root/.cargo \
  -v mars-cargo-target:/workspace/target \
  -w /workspace \
  mars:openeuler-24.03-lts-sp3 \
  cargo test -p mars-protocol