ODS测试体系全解BATS、契约测试与多发行版冒烟测试如何守护你的本地AI服务器【免费下载链接】ODSTurn your PC, Mac, or Linux box into an AI server. LLM inference, chat UI, voice, agents, workflows, RAG, and image generation.项目地址: https://gitcode.com/GitHub_Trending/dr/ODSODSOsmantic ODS是一个把PC、Mac 或 Linux 机器变成本地 AI 服务器的开源项目LLM 推理、聊天界面、语音、Agent、工作流、RAG 与图像生成一站搞定。因为安装脚本要覆盖 10 多种 Linux 发行版、Windows/WSL 与 macOS并且要对接 NVIDIA、AMD、Apple Silicon 等多种 GPU 后端它的测试体系格外有分量。本文带你快速看懂 ODS 测试体系的三大支柱BATS 单元测试、契约测试、多发行版冒烟测试以及一条make gate命令如何串起完整的发布门禁。为什么本地 AI 服务器需要多层测试ODS 的安装器不是一段简单的脚本而是一条由 13 个阶段组成的流水线预检 → 硬件检测 → 依赖 → Docker → 镜像 → 服务 → 健康检查。任何一环在不同发行版或 GPU 平台上出错用户都会在安装中途卡住。因此 ODS 采用「金字塔 横向矩阵」的测试布局层级测什么跑得多快典型入口BATS 单元测试shell 库函数检测、分层、打包逻辑秒级make bats契约测试配置文件与关键接口的约定分钟级make test平台冒烟测试各平台关键路径是否接线正确秒级make smoke多发行版 Fleet10 发行版真实容器/虚拟机5–75 分钟make fleet-distros 核心思路便宜的测试每次提交都跑昂贵的真实机器测试在发布前跑各层互不重复。BATS 单元测试秒级验证 shell 库函数ODS 的安装器核心用 Bash 编写BATSBash Automated Testing System就是为 shell 脚本量身定做的测试框架。运行入口 ods/tests/run-bats.sh 会在首次运行时自动拉取固定版本的 bats-corev1.11.1、bats-support 与 bats-assert之后一条命令跑完全部用例make bats以 ods/tests/bats-tests/detection.bats 为例它测试硬件检测库 installers/lib/detection.sh 的层级归一化函数test normalize_profile_tier: T1 normalizes to 1 { run normalize_profile_tier T1 assert_output 1 }可以看到几个工程细节打桩Stub隔离依赖setup()里把日志函数替换为空操作并伪造一个临时目录充当SCRIPT_DIR让被测库在干净沙箱中加载不污染真实环境 ✅Mock 硬件在 Linux 上用假的nvidia-smi输出来测试 GPU 检测不依赖真显卡按平台跳过用到 GNU 特性的用例在 macOS 上自动 skipbats-tests/目录下共 30 个.bats文件覆盖检测、打包、Docker 拉取、预检、进度条、路径工具等安装器核心库——这正是秒级回归的来源。⚡契约测试用文件锁定关键接口契约测试Contract Test回答的问题是各个组件之间的约定现在还成立吗 ODS 把大量约定写成了机器可校验的契约文件然后由 ods/tests/contracts/ 目录下的 27 个测试脚本Bash / Python / PowerShell 三种语言逐一核验。以 ods/tests/contracts/test-installer-contracts.sh 为例它校验四个 GPU 后端契约 JSON 必须完整for f in config/backends/amd.json config/backends/nvidia.json \ config/backends/cpu.json config/backends/apple.json; do jq -e .id and .llm_engine and .service_name and .public_api_port \ and .public_health_url and .provider_name and .provider_url $f done也就是说amd.json、nvidia.json、cpu.json、apple.json这几个契约文件必须同时包含 id、推理引擎、服务名、API 端口、健康检查地址等 7 个字段缺一个就整体失败。类似的契约还包括硬件分级契约config/hardware-classes.json 中strix_unified、nvidia_pro、apple_silicon、cpu_fallback每类都必须给出推荐后端与层级端口契约tests/contracts/test-port-contracts.sh 保证服务端口与 config/ports.json 保持一致安装足迹契约校验三种平台上安装后落盘的内容符合预期Llama 运行时契约tests/contracts/test-llama-runtime-tunables.py 校验运行时参数注入格式一条make test即可执行几十组契约检查见 ods/Makefile 中的test目标相当于给整个项目的接口做了一次体检。多发行版冒烟测试一次验证 10 个发行版ODS 支持 Ubuntu、Debian、Fedora、Arch、Manjaro、CachyOS、openSUSE、Rocky、Linux Mint 等发行版包管理器横跨apt、dnf、pacman、zypper四大家族。冒烟测试分两层平台冒烟测试秒级ods/tests/smoke/ 下的脚本做最快速的接线检查例如 ods/tests/smoke/linux-nvidia.sh 确认 NVIDIA 安装路径、GPU 后端分支、支持矩阵文档、扩展服务目录都完好[smoke] Linux NVIDIA installer paths [smoke] Extension service directories exist [smoke] PASS linux-nvidia同目录还有linux-amd.sh、wsl-logic.sh、macos-dispatch.sh、mobile-dispatch.sh由make smoke一键跑完。Fleet 多发行版矩阵真容器 / 真虚拟机Docker 矩阵tests/fleet-multi-distro.sh 一次性在 10 个发行版容器里执行安装器逻辑支持点名运行子集tests/fleet-multi-distro.sh ubuntu/24.04 archlinux/current mint发行版镜像包管理器ubuntu2404 / ubuntu2204 / debian12 / mint213官方容器aptfedora41 / rocky9官方容器dnfarch / manjaro / cachyos官方容器pacmanopensuse (Tumbleweed)官方容器zypperIncus 虚拟机矩阵tests/fleet-incus-vm.sh 启动 5 台一次性虚拟机Ubuntu / Fedora / Rocky / Arch / openSUSE在真实 systemd 环境中验证 Docker 守护进程与安装器行为——这是容器测不到的内核层。 完整的多发行版测试方法论Distrobox 日常调试、Ventoy USB 周验证、真实硬件 Fleet详见官方文档 docs/TESTING.md。发布门禁一条 make gate 全跑完ods/Makefile 把所有测试层串联成一道发布门禁make gate # lint → test → bats → smoke → simulate目标作用make lint全部 shell 脚本语法检查 Python 编译检查make test契约测试与单元级脚本测试make batsBATS 单元测试套件make smoke四平台冒烟测试make simulate安装器仿真演练 scripts/simulate-installers.sh文档与界面小改动通常只需 CI 针对性检查而一旦触碰安装阶段、compose 生成、GPU 检测、生命周期命令等运行路径就应该跑完整的 release-grade 扫描。测试速查清单 改了某个 shell 库→make bats秒级出结果 动了配置、端口、后端 JSON→make test校验契约️ 改了安装分派或平台分支→make smoke 怀疑某发行版出问题→tests/fleet-multi-distro.sh 发行版别名 准备发版→make gate全绿再走人ODS 的测试体系把本地 AI 服务器安装不能出错这件事拆解成了可重复、可分层、可点名执行的自动化流程。无论你是想贡献代码还是评估项目的工程质量从 ods/tests/ 目录读起都是最快的切入点。【免费下载链接】ODSTurn your PC, Mac, or Linux box into an AI server. LLM inference, chat UI, voice, agents, workflows, RAG, and image generation.项目地址: https://gitcode.com/GitHub_Trending/dr/ODS创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考