AgentMeshOS_v1.0.0_Source.zip 使用说明

本 README 仅适用于：

AgentMeshOS_v1.0.0_Source.zip

该压缩包面向开发协作者、代码审查人员和二次开发人员，包含可以直接查看、安装、运行和测试的 AgentMeshOS 1.0.0 项目源码。

项目简介

AgentMeshOS 是一个离线优先、可复现的多智能体协作系统原型，主要实现：

版本化的多智能体通信协议；
text 与 structured 两种通信模式；
异步 Agent Runtime 和可靠传输层；
通用任务 DAG；
基于 StateRef 的非文本数值状态交换；
SharedMemory 与 mmap 状态后端；
SQLite 与 NumPy 持久化共享记忆；
确定性离线 embedding；
Planner、Retriever、Executor 和 Reporter 四个参考 Agent；
受限 CodeAct 执行能力；
正式 benchmark、指标、报告和图表；
命令行工具与只读 Dashboard。

工业异常诊断只是使用合成数据构建的参考验证场景，不代表真实生产诊断能力。

压缩包内容

解压后第一层目录为：

AgentMeshOS_v1.0.0_Source/

主要内容：

路径	说明
`src/agentmeshos/`	AgentMeshOS 核心源码
`tests/`	单元、集成和端到端测试
`data/`	合成任务 fixtures 与离线知识库
`configs/`	benchmark、演示和传输策略配置
`scripts/`	安装、测试、演示、验证和发布脚本
`docs/`	架构、协议、记忆、安全和部署文档
`artifacts/benchmarks/`	Phase 5 正式 benchmark
`artifacts/transfer_benchmarks/`	Phase 6 状态传输 benchmark
`deliverables/演示素材/`	中文 PPT 演示素材
`README.md`	项目主说明
`PROJECT_STATUS.md`	当前实现和验证状态
`TASKS.md`	各阶段任务完成情况
`PROJECT_COMPLETE.json`	独立验收结果
`pyproject.toml`	Python 项目与质量工具配置
`Containerfile`	容器构建定义
`LICENSE`	Apache-2.0 许可证

环境要求

Python 3.11 或更高版本；
无需 GPU；
默认运行路径无需网络；
无需 API Key；
无需付费服务。

当前实际验证环境：

Windows 11；
Python 3.13.9。

Linux、openEuler 24.03-LTS-SP3 和容器环境尚未实际验证。

Windows 安装

解压 ZIP，进入源码目录：

cd AgentMeshOS_v1.0.0_Source

创建虚拟环境并安装：

python -m venv .venv
.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -e . --no-build-isolation

确认安装版本：

python -c "import agentmeshos; print(agentmeshos.__version__)"

预期输出：

1.0.0

快速运行

查看 CLI：

python -m agentmeshos.cli --help

运行一个 structured 模式任务：

python -m agentmeshos.cli run-task --task-id surface-002 --mode structured

运行 text 模式任务：

python -m agentmeshos.cli run-task --task-id surface-002 --mode text

运行全部 10 个连续任务：

python -m agentmeshos.cli run-suite --mode structured

启动只读 Dashboard：

python -m agentmeshos.cli dashboard

Dashboard 默认只读取本地 artifacts 和运行结果，不调用外部服务。

运行测试

安装开发依赖：

python -m pip install -e ".[dev]" --no-build-isolation

运行全部测试和覆盖率：

python -m pytest --cov=agentmeshos --cov-branch --cov-report=term

运行静态质量检查：

python -m ruff check .
python -m ruff format --check .
python -m mypy src tests
python -m pip check

本次源码交付前的实际结果：

pytest：182 passed，1 skipped；
coverage：87.36%；
Ruff lint：通过；
Ruff format check：通过；
strict mypy：通过；
pip check：通过。

跳过项是 Windows 不支持的 Unix domain socket 平台测试。

验证正式实验

Phase 5 正式 benchmark：

python -m agentmeshos.cli benchmark-validate `
  artifacts/benchmarks/phase5-20260729T134236Z-d8d67d1f `
  --historical-source

Run ID：

phase5-20260729T134236Z-d8d67d1f

Phase 6 状态传输 benchmark：

artifacts/transfer_benchmarks/transfer-20260729T150127Z-ab94c79a/

Run ID：

transfer-20260729T150127Z-ab94c79a

正式实验数据为已保留的实际运行结果，本次源码打包没有重新生成或手工修改。

Linux 和 openEuler

项目提供以下脚本：

python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e . --no-build-isolation
bash scripts/run_demo.sh
bash scripts/run_tests.sh
bash scripts/check_openeuler.sh

部署说明：

docs/openEuler_deployment.md

上述脚本和文档已经提供，但当前没有 Linux、openEuler 实机或容器构建通过记录。

已知限制

四个参考 Agent 当前是同一进程中的异步处理器；
完整四 Agent 工作流尚未跨独立进程部署；
工业任务数据是可再分发的合成 fixtures；
小向量 Windows workload 中，StateRef 时延高于 inline embedding；
token 数为字符数除以 4 的估算值；
RSS 是阶段采样结果，不是连续峰值；
CodeAct 是轻量策略沙箱，不应视为强安全隔离边界。

更多说明见：

docs/limitations.md
docs/security.md
docs/architecture.md
docs/detailed_design.md

文件完整性

源码 ZIP 的 SHA-256：

5154a4dc2caffc44c471b7469aa518b690da9639e94501a0763a7adfe27e1fa9

Windows PowerShell 验证命令：

Get-FileHash .\AgentMeshOS_v1.0.0_Source.zip -Algorithm SHA256

计算结果必须与上面的 SHA-256 完全一致。若不一致，说明文件内容发生变化或传输过程中出现损坏。

版本信息

项目版本：1.0.0
发布分支：release-package
源码交付提交：d40bb819619d9a6c0b90c1890d5a893c7681449c
Manifest 后续提交：a2ff123b2c1a91cc95b1b1e4e53c837221ed106f
源码包文件数：387
源码 ZIP 大小：14,235,691 字节

源码 ZIP 不包含 .git 目录和完整 Git 历史。如需提交记录、分支或历史版本，请通过 Git 仓库进行协作。