用途：在用户明确要求做资源感知规划，或某项具体工作负载需要资源估算前，检测当前进程实际可见的资源约束，区分主机清单、进程亲和性、cgroup/容器限制、调度器分配和加速器运行时可可用性。不应对每个科学任务都持久化指纹。
主要能力：可生成临时 stdout 快照；用 --output resource-snapshot.json 显式写入私有文件；可选 psutil 增强跨平台物理核心、亲和性、可用内存、交换和磁盘覆盖；用 --skip-accelerators 跳过加速器探测；规划工作负载（cpu/mixed/io）、给出建议 worker 数与每 worker 线程数；校验和对比快照；生成不执行任何诊断的加速器诊断计划。
快速开始： python scripts/detect_resources.py python scripts/detect_resources.py --output resource-snapshot.json uv run --no-project --with "psutil==7.2.2" python scripts/detect_resources.py python scripts/plan_workload.py resource-snapshot.json --workload cpu --tasks 100 --memory-per-worker-mib 2048 python scripts/snapshot_tools.py validate resource-snapshot.json python scripts/snapshot_tools.py diff before.json after.json
限制：不得运行压力测试、基准测试、大分配、写探针、设备重置、驱动安装或时钟/电源变更；不导出环境变量；不输出主机名、绝对路径、cgroup 路径、作业 ID、设备 UUID、PCI 地址或可见性变量原始值。缺失观测视为未知，不得转为无限；可见的主机 CPU、内存池或 GPU 不代表在调度器分配或容器内可用。运行时可可用设备保持 null，设备兼容性为 not_tested。磁盘快照只覆盖工作文件系统，绝对工作路径始终脱敏。已知内存预算不足一个 worker 时返回零 worker 和 insufficient_memory，不应启动该计划。未知 CPU 或可用内存产生 review_required。另包含 schema 1.1 契约、语义说明与来源台账等参考文件。