用途：为 Three.js 建造类游戏（Fortnite、Rust、Valheim 风格）提供结构稳定性验证与损坏系统。
主要能力：HeuristicValidator 用于校验新部件的放置是否合法，返回有效性与稳定性百分比及支撑信息；DamageSystem 支持施加伤害与范围爆炸伤害，并处理损坏状态、火焰蔓延与连锁坍塌；stability-optimizer.js 面向大型结构提供缓存与批量更新；physics-engine-lite.js 为可选的拟真应力/应变模拟。
用法：从脚本导入模块后创建校验器，添加部件并校验放置结果；再基于校验器创建 DamageSystem，按目标部件或位置施加伤害。示例： import { HeuristicValidator } from './scripts/heuristic-validator.js'; import { DamageSystem } from './scripts/damage-propagation.js'; const validator = new HeuristicValidator({ mode: 'heuristic' }); validator.addPiece(piece); const result = validator.validatePlacement(newPiece); const damage = new DamageSystem(validator); damage.applyDamage(piece, 50, 'physical'); damage.applyExplosiveDamage(position, 100, 10);
适用场景：战斗向建造可用街机模式（仅连通性、即时坍塌）；生存向建造可用启发式模式（稳定性百分比、规则可预测）；工程模拟可用拟真模式（完整应力/应变，计算开销较高）。
限制：拟真模式计算成本高；其余性能、依赖与兼容性信息暂未提供。进阶文档 references/structural-physics-advanced.md 涵盖模式对比、材料属性与衰减、损坏状态阈值与连锁机制。