用途：这是 BESSER 的排错速查技能，按症状组织，单文件、无 references/ 子目录，可从头扫描或直接搜索，帮助快速定位并修复常见错误。
主要覆盖：
- 安装问题：pip install 因原生依赖失败（psycopg2-binary 需 libpq-dev/postgresql；pyodbc 需 unixodbc-dev/unixodbc；oracledb 需 Oracle Instant Client）；pip install -e . 须在仓库根目录运行并先升级 setuptools>=42 与 wheel；需 Python 3.11+；Windows 激活路径为 venv\Scripts\activate。
- 导入错误：No module named 'besser'；结构元模型导入名（StringType、IntegerType 等，均为单例而非类）；OCL 需 bocl==1.0.1；PlantUML 解析需 antlr4-python3-runtime>=4.13.1；可选包 deep-translator、docker、qiskit、torch/tensorflow。
- 模型构建与校验：名称不得含空格或连字符；主键唯一；BinaryAssociation 须恰好两端；校验前调用 model.validate()。
- 生成器与部署：DBMS 取值、Qiskit 后端、Django、jinja2.TemplateNotFound、Docker/Compose 端口与 PYTHONPATH 等。
用法：按报错信息或症状在上表中查找→原因→首个修复动作；提供最小可复现脚本模板与诊断命令（如 python -c "from besser.BUML.metamodel.structural import DomainModel; print('OK')"）。
限制：不涉及错误输出的深度调试，后者归 besser-generators 的 references/debugging.md；PlantUML 转换仅支持子集；OCL 为回退解析且复杂约束可能被标为无效但不阻断生成。其他细节暂未提供。