用途：这是一份 Terraform 基础设施即代码参考，帮助编写配置、管理状态、设计模块与配置 provider。
核心工作流：init → validate → fmt → plan → apply。常用命令保持原样：terraform init（初始化并下载 provider）、terraform validate（语法校验）、terraform fmt -recursive（格式化 HCL）、terraform plan（预览变更）、terraform apply（执行变更）。检查命令包括 terraform state list、terraform state show <resource>、terraform graph | dot -Tsvg > graph.svg。调试可用 TF_LOG=DEBUG terraform plan 2>debug.log。
主要能力与参考文件：按任务按需加载 troubleshooting.md（常见错误、调试）、state-management.md（后端、锁定、操作）、module-design.md（模块模式与组合）、security.md（密钥、状态安全），以及 Proxmox 相关文档 gotchas.md、authentication.md、vm-qemu.md、troubleshooting.md 和 external-resources.md。
使用方式与验证清单：apply 前完成 init、validate、fmt，仔细审阅 plan（关注 destroy/replace），团队环境正确配置后端并启用状态锁定，敏感变量标记 sensitive = true，provider 版本固定在 terraform.tf，勿将密钥提交版本控制，评估影响范围。
变量优先级（由高到低）：-var 标志、-var-file 标志、.auto.tfvars、terraform.tfvars、TF_VAR_ 环境变量、variables.tf 默认值。
限制：资料未提供价格、平台支持范围或效果数据；具体 provider 细节需查阅对应参考文件。