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

实现方案-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，并完成重新部署验证。