用途：管理名为 Matrix/Virgo-Core 的 Proxmox VE 三节点集群（节点 Foxtrot、Golf、Hotel，硬件为 MINISFORUM MS-A2，AMD Ryzen 9 9955HX，64GB DDR5，每节点 1×1TB 启动盘与 2×4TB CEPH OSD，4 网卡），涵盖虚拟机创建、VLAN 网络与 cloud-init 自动化。
主要能力：模板管理（Ubuntu/Debian cloud-init 模板、virtio-scsi、串口控制台、启动顺序与 cloud-init CD-ROM ide2）；网络（vmbr0 管理/VLAN 9 Corosync，vmbr1 CEPH 公共 192.168.5.0/24 MTU 9000，vmbr2 CEPH 私有 192.168.7.0/24 MTU 9000，VLAN 2-4094，802.3ad LACP）；CEPH 多 OSD 与健康监控；API 自动化支持 proxmoxer、Ansible community.general.proxmox_* 与 Terraform Telmate/proxmox。
使用方式：Python 脚本基于 uv 运行，如 uv run tools/cluster_status.py、uv run tools/check_ceph_health.py，均支持 --help；另有 validate_template.py、check_cluster_health.py。克隆模板示例：qm clone 9000 101 --name web-01；qm set 101 --ipconfig0 ip=192.168.3.100/24,gw=192.168.3.1；qm set 101 --net0 virtio,bridge=vmbr0,tag=30；qm start 101。Ansible 与 Terraform 示例见 examples/ 与 workflows/，参考文档见 reference/，常见错误见 anti-patterns/。
适用场景：Proxmox VE 集群运维、模板与虚拟机批量部署、CEPH 与网络诊断。限制：资料未提供具体版本要求、权限前提与故障处理细节，需结合实际环境验证。