AgentLink：多智能体低开销通信、引用式状态传递与共享记忆系统

第三届中国研究生操作系统开源创新大赛暨开放原子大赛操作系统专项赛 — 初赛参赛作品 参赛赛道：应用创新赛道（第 9 赛题） 参赛队伍：智链未来 完成时间：2026 年 7 月

---

一、作品简介

AgentLink 是一套面向多智能体协作运行场景的可运行、可测量、可复现系统原型。它把「通信 · 状态 · 记忆 · 验证」四件事系统化，通过 双通道通信（ProtocolMessage + UDS）、StateRef 引用式状态传递、Memory v2 跨任务共享记忆 等机制，在保持进程级故障隔离的前提下，让多智能体协作的工程结论有据可查。

1.1 核心机制

模块	设计要点
控制面 / 数据面 / 记忆面三层分离	Coordinator + Coder / Reviewer / Tester 四进程；ProtocolMessage 结构化消息；UDS 传输
StateRef	统一 put/get/open_view 接口，File / SharedMemory 双后端；open_view() 提供零拷贝只读视图
Memory v2	SQLite FTS5 + BM25 + CJK bigram，1k P50 延迟 264.46 → 5.83 ms（≈45.3×），MRR 0.443 → 0.9278
拒答门控 (gate)	FP 由 0.50 降至 0.0625（Recall@5 仅由 0.5143 降至 0.5066）
评测与证据链	N0–N4 五级管道消融（n=30，Mann-Whitney U + Cliff’s δ + Holm 校正），四级证据链

1.2 关键数据（N0–N4，n=30）

阶梯	均值 (ms)	相对 N0	说明
N0	1518.467	1.00×	TEXT + JSON + File + Legacy Memory
N1	1606.755	1.06×	+STRUCTURED + IPC
N2	1555.059	1.02×	+MessagePack
N3	1682.700	1.11×	+SharedMemory
N4	270.711	0.18×	+Memory v2

• N3 → N4：p_holm = 1.208 × 10⁻¹⁰，Cliff’s δ = 1.0（large），下降约 5.61×，主因 Memory v2 FTS5 索引。
• N0 → N3：全部不显著（p_holm = 1.0），多进程 / MessagePack / SharedMemory 在整体管道延迟上未带来显著加速（如实保留）。
• 连续任务 mem-v2 复用率 = 0.8333（30 轮 n=30，不写 100%）。

1.3 测试覆盖（独立口径，不跨环境相加）

环境	通过	失败	跳过
Windows 11 / Python 3.11.9	639	0	1（符号链接权限）
openEuler 24.03 LTS-SP3 / WSL2	639	1（SQLite WAL 并发锁）	0

二、目录结构（本仓库 master 根目录）

文件	说明
README.md	本文件
AgentLink_作品设计书.docx	作品设计书（含项目说明书结构：绪论 / 技术理论 / 项目介绍 / 实验测试 / 总结）
AgentLink_作品介绍PPT.pptx	18 页作品介绍 PPT
AgentLink_演示视频.mp4	4 分 50 秒系统演示视频（MP4 / 1920×1080 / 30 fps）
参赛原创承诺书.docx	参赛作品原创性承诺书

源代码与可运行工程位于 agentlink/ 子目录（含 CLI、Web 控制台、Benchmark 2.0、统计脚本与评审证据 review_evidence/）。

三、运行说明

需要 Python 3.11+。

# 1. 克隆仓库
git clone <repo-url>
cd <repo-dir>
cd agentlink

# 2. 创建虚拟环境并安装
python3.11 -m venv .venv
source .venv/bin/activate            # Linux / macOS
# .venv\Scripts\activate             # Windows

pip install -e .

# 3. 启动四进程系统演示
python -m agentlink demo --enable-state --enable-memory

# 4. 启动 Web 控制台（默认 127.0.0.1:8000；浏览器打开 /national 查看国赛成果展示页）
python -m agentlink web --port 8000

# 5. Benchmark 2.0 快速冒烟
python run_benchmark.py --quick

# 6. 完整 N0–N4 × 30 轮 Benchmark
python benchmarks/national_benchmark_v2.py

# 7. 检索评测（1k / 10k / 100k × M0–M4）
python -m agentlink eval-retrieval --scales 1k,10k,100k

更多 CLI（连续任务、统计复算、openEuler 复验）与目录结构详见 agentlink/README.md。

四、匿名化说明

依据赛事「匿名化」要求，本作品所有提交材料（README、文档、PPT、视频、截图、源码注释）均仅出现：

• 参赛队伍名称：智链未来
• 所选赛题名称：AgentLink：多智能体低开销通信、引用式状态传递与共享记忆系统

本作品提交材料未包含任何可识别个人身份的信息。代码提交记录的作者邮箱使用匿名邮箱或 GitLink 系统邮箱。