docs(agents): 说明 mvnw.cmd 内部固定用 5.1 引导

yeg

2026-09-17 50c71b346312acda1567e20f46e55a266842330c

docs(agents): 说明 mvnw.cmd 内部固定用 5.1 引导

mvnw.cmd 是 batch/PowerShell 混合 wrapper，无论外层 shell 是哪个，它自己都会用 powershell（5.1）
跑引导段。这是 Maven Wrapper 3.3.4 的既有实现，写下来免得有人把它改成 pwsh，或把 wrapper 报错
误判成 shell 问题。顺带说明 zcode 的 bash 工具跑在 Git Bash 里，PowerShell 只在显式点名或该
wrapper 内部出现。

 docs/agents/testing.md

@@ -38,6 +38,10 @@
Windows PowerShell 5.1 下实测通过——但如果 5.1 里出现"构建在编译中途莫名中断"，先换 `pwsh` 再怀疑代码：
5.1 会把 Maven 打到 stderr 的警告（例如 JVM 的 `sun.misc.Unsafe`）当成终止错误。

另注：`mvnw.cmd` 是 batch／PowerShell 混合的 wrapper，它自己**总是**用 `powershell`（即 5.1）做引导，
与你在哪个 shell 里敲命令无关——这是 Apache Maven Wrapper 3.3.4 的既有实现，不要改成 `pwsh`。
（`zcode` 的 bash 工具跑在 Git Bash 里，PowerShell 只在显式点名或这个 wrapper 内部才出现。）

**必须走这个脚本（或等价地只跑一个 Maven 进程）。** 同一个 checkout 上并发跑两个构建会写坏
`target/`，症状是看起来不可能的报错——例如 `No qualifying bean of type 'HuifuPaymentProperties'`。
遇到这类"不可能"的 bean/classpath 错误，先 `-Clean`，再怀疑代码。