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

工程分析/实现方案-2026-05-25-13-42-13.md

@@ -0,0 +1,52 @@
+# 实现方案-2026-05-25-13-42-13
+
+## 实现方案文档路径
+
+`工程分析/实现方案-2026-05-25-13-42-13.md`
+
+## 修改目标
+
+将自动微调匹配工作区“迭代轮次”的最高可选值从 12 提升到 50，并保证后端接口同步支持。
+
+## 涉及路径
+
+- `WebSite/src/components/AutoMatchWorkspace.tsx`
+- `WebSite/server.ts`
+- `工程分析/需求分析-2026-05-25-13-42-13.md`
+- `工程分析/实现方案-2026-05-25-13-42-13.md`
+- `工程分析/测试方案-2026-05-25-13-42-13.md`
+- `工程分析/经验记录.md`
+
+## 技术路线
+
+- 前端：把迭代轮次输入框 `max` 和 `onChange` clamp 上限改为 50。
+- 后端：把 `normalizeAutoMatchIterations` 的 clamp 上限改为 50。
+- 保持默认 `iterations = 6`，避免进入页面后默认就触发长耗时运行。
+
+## 执行步骤
+
+1. 确认已读 `工程分析/经验记录.md`。
+2. 修改前端迭代轮次输入限制。
+3. 修改后端接口参数归一化限制。
+4. 执行 `npm run build`。
+5. 重启 `tmux` 会话 `revoxelseg-dicom` 服务。
+6. 验证本机与公网访问。
+7. 追加经验记录并提交推送。
+
+## 兼容性与回滚方案
+
+- 旧请求中 `iterations <= 12` 行为不变。
+- 若 50 次导致耗时过长，可再引入运行中取消、进度显示或更严格候选限制。
+- 回滚只需恢复前后端上限为 12。
+
+## 预计文件变更
+
+- 两处代码常量级修改。
+- 新增本次工程分析三件套。
+- 追加经验记录。
+
+## 提交与部署策略
+
+- 只暂存本次代码和文档变更。
+- commit message 包含 `2026-05-25-13-42-13` 和简要描述。
+- 提交后推送到 Gitea，并完成重新部署验证。