witty-compat

openEuler 南向硬件兼容性分析与 AI 推理栈部署诊断 Agent。

是什么

帮助开发者在鲲鹏、昇腾等硬件 + openEuler 上部署和诊断 AI 推理栈。内置参数化多分支安装引擎、1691 篇故障案例知识库、推理性能压测工具、以及 OS 级调优模块。

快速开始

# pip 安装（推荐）
pip install witty-compat
witty-compat-setup

# 或源码安装
git clone https://atomgit.com/openeuler/witty-compat.git ~/.config/opencode/witty-compat
cd ~/.config/opencode/witty-compat && bash install.sh

重启 OpenCode，输入 /agents 选择 司南Agent。

"检查当前环境"          → K+O+X 采集 + 兼容性匹配
"帮我部署 7B 模型"      → 多分支贪心安装 → 冒烟压测
"为什么报错了"          → 环境 diff → 知识库检索 → 修复建议

Agent 体系

Agent	职责
司南Agent	总控，意图识别 + 路由
DeployAgent	多分支贪心部署
ValidateAgent	全量兼容性验证
DiagnoseAgent	故障诊断 + RAG 检索

工具

工具	命令
env-detect	python3 tools/env_detect.py --json [--remote host]
kb-match	python3 tools/kb_match.py --json
kb-search	python3 tools/kb_search.py --search "关键词" --json
branch-try	python3 tools/branch_try.py --step torch --branch pip_nvidia_index
benchmark	python3 tools/benchmark.py --json --model <M> --stream
run-ops	python3 tools/run_ops.py --mode diagnose

参数化安装分支

knowledge/branches/ 中的 YAML 使用模板自动匹配当前环境：

• pip_nvidia_index → --index-url cu{cuda_ver_short}（CUDA 版本自动检测）
• source_build → TORCH_CUDA_ARCH_LIST={gpu_cc}（GPU 架构自动检测）

知识库

目录	内容
knowledge/branches/	torch / vLLM / CUDA 参数化安装分支
knowledge/environments/	已测试环境兼容矩阵
knowledge/cases/	openEuler 真实故障案例 (1691 篇)

搜索：python3 tools/kb_search.py --search "GPU驱动安装失败" --json

路径

• 只读（代码）：site-packages 或 editable 安装目录
• 可写（数据）：~/.local/share/witty-compat/（XDG 标准）
• 环境变量覆盖：WITTY_DATA_DIR / WITTY_RESULTS_DIR / WITTY_CASES_DIR

许可证

MulanPSL-2.0