LiteAgent Runtime

面向多智能体协作的低开销通信、非文本状态传递与共享记忆原型系统。项目对应“应用创新——一种面向多智能体协作的低开销通信、状态传递与共享记忆机制（社区赛题）”。

作品简介

系统以 Linux 故障分析为演示场景，由 Planner、Retriever、Executor、Summarizer 四类 Agent 协作完成任务。它同时实现纯文本模式和结构化协议模式，在相同的两组、共10轮连续任务中，比较消息数、文本字符、估算Token、传输字节、任务耗时和记忆命中率。

核心机制：

Agent运行时：注册、握手、能力发现、消息路由和顺序调度；
结构化协议：消息包含动作、参数、结果、能力、状态引用和记忆引用；
非文本状态：将文本转为64维确定性语义向量，经操作系统共享内存传递；
共享记忆：SQLite保存记忆ID、来源Agent、时间、主题、摘要、标签、向量与复用次数；
混合检索：综合关键词、标签重合度和向量余弦相似度；
自动评测：运行两种模式各10轮，自动生成CSV、JSON、Markdown和HTML报告。

项目不依赖云端API，也不需要下载模型，使用 Python 标准库即可运行。

快速运行

要求：Python 3.9及以上，Windows或通用Linux/openEuler。

python3 run_demo.py

Windows也可以运行：

python run_demo.py

输出目录为 results/：

metrics.csv：20次任务的逐轮原始指标；
summary.json：两种模式汇总与提升比例；
experiment_report.md：自动生成的实验报告；
dashboard.html：可直接打开的可视化看板；
demo_slides.html：自动翻页的录屏演示页；
demo_results.json：代表性任务的运行结果。

实测结果

本仓库当前结果由 python run_demo.py 在本地自动生成：

指标	纯文本	结构化
连续任务数	10	10
成功率	100%	100%
消息数	40	40
文本字符	56,851	15,486
估算Token	28,425	7,742
传输字节	75,525	18,258
非文本状态传递	0	10次 / 5,120 B
记忆命中率	80%	80%
平均任务耗时	56.014 ms	26.712 ms

结构化模式的文本字符和估算Token减少约 **72.76%**，传输字节减少约 **75.83%**。耗时实验采用固定200KB/s受限链路模型，条件和计算方式在实验报告中公开。

两组连续任务

磁盘故障组：根分区告警、日志增长、Nginx日志、容器存储、预防方案；
服务故障组：Nginx启动失败、端口冲突、配置错误、依赖未就绪、预防方案。

每组首个任务从空白记忆开始，后续任务按标签和语义相似度复用同组历史记忆。

测试

python3 -m unittest discover -s tests -v

openEuler验证：

chmod +x scripts/verify_openeuler.sh
./scripts/verify_openeuler.sh

项目结构

liteagent/
  agents.py          四类Agent
  protocol.py        注册、握手、能力发现、通信总线
  state_exchange.py  64维向量与共享内存
  memory.py          SQLite共享记忆与混合检索
  runtime.py         多Agent运行时和调度
  evaluation.py      10轮任务、指标与报告生成
docs/
  DESIGN.md          系统设计文档
  DEPLOYMENT.md      部署与复现文档
  DEMO_SCRIPT.md     演示视频录制脚本
results/             自动生成的实验材料
tests/               自动化测试
run_demo.py          一键运行入口

文档

说明

本项目定位为可运行、可评测、可复现的最小系统原型。CodeAct、eBPF、WASM和真实大模型均为赛题鼓励项，不属于本版本范围。