HomeoQuorum-Mem

HomeoQuorum-Mem 是面向多智能体协作的低开销通信、非文本状态传递与共享记忆运行时。项目针对多 Agent 协作中长上下文重复广播、内部状态反复文本化、历史经验难复用等问题，提供结构化 Signal Packet、hashed semantic StateFrame、SQLiteMemoryStore、QuorumGate 和可复核 evidence pack。

赛题匹配

• 赛题方向：一种面向多智能体协作的低开销通信、状态传递与共享记忆机制（社区赛题）
• 作品形态：可运行 Python 原型、可视化前端、可复现实验、技术报告和演示材料。
• 核心目标：在不降低可验证任务成功率的前提下，减少多智能体协作通信开销，并保留可审计证据链。
• 运行目标环境：openEuler 24.03-LTS-SP3；当前材料同时在 Windows/Python 环境完成可复现验证。

快速运行

python -m pip install -e .[dev,integrations]
python tools\run_demo.py --output-dir runs\demo --skip-dashboard
python -m pytest -q

启动前端演示：

python -m hqm.cli serve-dashboard --tasks benchmarks\hqm_bugs\tasks.jsonl --host 127.0.0.1 --port 8765

默认访问 http://127.0.0.1:8765/。前端可运行 Judge Demo、Champion Mode、QuixBugs Exec、PatchCheck、Reliability、Real API Mini 和 LangGraph 嵌入验证。

核心结果

实验	成功率	Baseline 通信字符	HomeoQuorum 通信字符	通信下降	非文本状态传递
HQM-Bugs 30	100.00%	72,503	59,538	17.88%	90 次 / 23,040 bytes
QuixBugs 8	100.00%	25,221	17,303	31.39%	24 次 / 6,144 bytes

LangGraph 嵌入验证中，HomeoQuorum 保持相同业务节点顺序，pytest 通过 4/4，通信下降 49.34%。

赛题关键机制

• 多 Agent 运行时：Planner、Retriever、Executor、Verifier、Summarizer、QuorumGate 至少 5 类角色协作。
• 结构化通信：Signal Packet 显式包含 action_type、input_params、return_result、capability 等字段，避免直接透传完整自然语言上下文。
• 非文本状态传递：StateFrame 使用固定 64 维 hashed semantic float32 向量，按二进制状态帧统计传输次数与字节数。
• 共享记忆复用：SQLiteMemoryStore 记录 memory_id、source_agent、created_at、task_topic、summary、tags、evidence_refs，并支持 tag/semantic 检索。
• 连续任务验证：HQM-Bugs 30 和 QuixBugs 8 均按连续任务运行，可复核不少于 10 轮执行。

正确性裁判

• HQM-Bugs / QuixBugs metadata：hidden oracle。
• QuixBugs Exec / PatchCheck：应用补丁后运行 pytest。
• LangGraph 嵌入验证：真实 LangGraph workflow + pytest。
• trace replay：外部 reward、DB match 和 tool-action match。
• 真实 provider：模型只生成候选诊断，最终由 oracle 或测试程序裁判。

仓库材料

• 项目说明书.docx / 项目说明书.pdf：项目背景、系统方案、运行方式和测试用例。
• 技术报告.pdf：创新点、架构、实验结果、证据边界和引用说明。
• 作品介绍PPT.pptx / 作品介绍PPT.pdf：答辩展示材料。
• 演示视频.mp4：核心目标预期效果展示，文件小于 100MB。
• 作品原创承诺书_官方模板_待手写签字.docx：官方原创承诺书模板，需正式提交前手写签字后替换。
• docs/：Markdown 版说明和证据索引。
• Dockerfile.openeuler / scripts/verify_openeuler*：openEuler 24.03-LTS-SP3 容器化编译、运行、测试复现入口。
• evidence/：可复核实验结果和 claim 表。
• src/、tests/、benchmarks/、tools/：脱敏后的可运行源码和实验脚本。
• source_package.zip：同一份脱敏源码的归档备份，未包含密钥、虚拟环境、缓存和本地路径。

匿名化说明

本提交材料不包含参赛单位、指导教师、学生姓名、单位邮箱、API key 或本地绝对路径。请提交前确认 GitLink 提交 author 邮箱也满足赛事匿名化要求。