2026-05-25-13-42-13 调整自动匹配迭代轮次上限

工程分析/经验记录.md

@@ -1959,3 +1959,21 @@ C. 解决问题方案
 D. 后续如何避免问题
 
 整理软著代码汇总时，先确认用户要的是“带核对信息的审阅版”还是“纯源码版”。若目标是提交材料，默认减少额外说明、文件标题和行号，只保留源码文本；用于内部核对的行号应放在临时检查结果里，不直接写入最终 docx。
+
+## 2026-05-25-13-42-13 自动匹配参数上限要前后端同步
+
+A. 具体问题
+
+用户要求自动微调匹配工作区“迭代轮次”最高变为 50 次。页面旧输入框最大值为 12，后端 `normalizeAutoMatchIterations` 也会把请求轮次截断到 12。
+
+B. 产生问题原因
+
+自动匹配的轮次上限同时存在于前端输入控件和后端请求归一化中。若只修改其中一侧，会出现界面可以输入但接口不执行，或接口支持但页面无法选择的状态。
+
+C. 解决问题方案
+
+将 `AutoMatchWorkspace.tsx` 中迭代轮次输入框的 `max` 和 `onChange` clamp 上限改为 50；同步将 `server.ts` 中 `normalizeAutoMatchIterations` 的服务端 clamp 上限改为 50。默认值仍保留 6，避免进入页面后默认运行变慢。
+
+D. 后续如何避免问题
+
+后续调整自动匹配参数上限时，要同时检查前端控件、API 类型、服务端归一化、默认值和运行耗时提示。对可能显著增加耗时的参数，只提高上限不改变默认值；若用户常用高上限，应补充进度、取消和超时保护。