Repository navigation
v1.0.0
MIMO Array Visualizer 的第一个 Web 正式版:面向 60 / 77 / 92 GHz 毫米波 FMCW 雷达的 MIMO 天线阵列性能工作台。部署在局域网服务器上,用浏览器访问,取代此前的 PySide6 桌面版(v0.2.0)。
主要功能
阵列布局:拖拽 + 网格吸附的 Tx/Rx 编辑器,撤销/重做,标准 MIMO 自动排阵(λ/2 虚拟 ULA),λ / mm 坐标表,虚拟阵列实时预览。
视场内测角评估:1D DBF 角谱播放、2D 方位 × 俯仰热图、逐帧测角误差(峰值细化到 0.002°)、竞争峰裕量、不模糊范围与截断原因。
雷达级检查:60G / 77G / 92G 频段预设与扫频范围、扫频起止的频段内性能、实测 3 dB 分辨率、第一零点 PSL、规格逐项判定、多方案对比、阵元重叠检查。
实测数据:HFSS 通道幅相、单元方向图、自定义 / 校准 DBF 字典(范围外不外推,覆盖不足时提示)。
协作:服务器项目库(多人同时修改同一项目时提示冲突,不会静默覆盖)、分享链接 http://服务器:8000/s/、兼容桌面版的阵面 JSON、.mimo.zip 项目包、带 CSV/JSON 数据包的 PDF 报告、REST API(/api/docs)。
中文 / English / 日本語,浅色 / 深色主题,支持手机宽度。
部署
docker compose up -d --build # 推荐
或裸机:scripts/setup_server.sh,然后
.venv/bin/mimo-array-server --host 0.0.0.0 --port 8000 --data-dir ./data
也可以直接安装下方附件中的 wheel(已内置构建好的前端,不需要 Node.js):
pip install mimo_array_visualizer-1.0.0-py3-none-any.whl
mimo-array-server --host 0.0.0.0 --port 8000 --data-dir ./data
需要 Python 3.10+。中文 / 日文 PDF 报告需要系统安装 CJK 字体(如 fonts-noto-cjk),Docker 镜像已内置。
wheel SHA-256:f10e6f25322f8f980195b2fa2606ec200daa6354e7063be334353198e841dada
安全与稳定性
经过四轮外部测试并全部修复:上传文件和项目包按大小、行数、列数和解压量设上限(zip / XLSX 解压炸弹在 0.3 s 内被拒绝,内存不增长);损坏的文件返回 4xx;请求体有大小上限;磁盘满或数据目录只读时返回明确提示,不留残缺文件;项目库的保存与删除在并发下保持一致;坐标和数字输入严格校验。
发布验证
CI(Python 测试 + ruff、ESLint + 前端单元测试 + 构建、Playwright e2e)全部通过
后端 229 个测试在 Python 3.10 / 3.12 / 3.13 下通过;前端 220 个单元测试;5 个浏览器端到端用例
wheel 在全新虚拟环境中安装(Python 3.10 与 3.13,最新依赖)后端到端测试通过
全新克隆执行 scripts/setup_server.sh 后启动,健康检查、界面、评估、中文 PDF 报告正常
npm audit / pip-audit:0 个已知漏洞
已知限制
没有内置登录鉴权,适合在可信局域网使用;需要更大范围访问时请在前面加带认证的反向代理。
自动化端到端测试只覆盖 Chromium;Firefox / WebKit 由人工测试验证,未在真实手机上测试。
未做数小时级的长时间稳定性测试。
本次发布验证的环境无法访问 Debian 软件源,Docker 镜像中安装 CJK 字体这一步沿用上一轮测试的验证结果(该步骤此后未改动)。建议在目标服务器上执行一次 docker compose up -d --build 作为部署验收。