故障诊断

围绕具体故障收集输入、日志、环境和首次异常位置，逐步收窄到能解释现象的原因。仅诊断的请求交付证据与结论，修复按当前任务授权进行。

• 优先取得最小复现；无法稳定复现时，可依据足够的日志、代码或运行证据继续定位和修复，明确未验证的部分，不把假设写成已确认根因。
• 每次试验针对可检验的假设，说明什么结果能支持或排除它。未获得新证据时回到定位，不靠连续修改碰运气。
• 修改共享函数前检查相关调用方及其契约，避免只修报告中的一个入口。若涉及并发，确定共享状态与竞争顺序后再选择修复机制。
• 区分临时止血与根因修复。重试、重启或清缓存只有在故障机制和恢复边界有证据时才有意义，不能据此宣称根因已修复。
• 选择能够发现该故障的最小有效回归检查，优先复用已有测试。修复影响此前检查时重跑相关项。

出现 Windows PowerShell 乱码或编码兼容异常时，读 windows-encoding.md。常规 Windows 命令不做编码巡检或统一初始化。

交付说明原因所在层、证据、修复或建议及验证局限。只有既有检查实际漏检时，才说明漏检原因和需要补充的约束。