furniture-3d-system-Wu/docs/agent-memory/open-issues.md

待办与阻塞（长期）

最后更新：2026-03-11

P0（高优先级）

• 问题：SKU 详情页与 SKU 装配页“部分板材不可选/折角线贴合异常”已完成代码修复，但仍需基于真实模型做人工终验（自动化仅验证到开关/基础交互）。

  • 责任角色：QA 测试员 / 3D 工程师 / 前端工程师
  • 下一步：在 3000 端口对固定 SKU 执行全量点选回归（非抽样），逐板件验证：可选中、安装顺序可入列、折角线贴边。
  • 证据：src/app/products/[id]/skus/[skuId]/SKUDetailClient.workspace.tsx、src/components/3d/model-viewer-pick-tolerance.ts、output/playwright/sku-regression-progress-2026-03-05T02-36-59-091Z/report.json
  • 状态：处理中

• 问题：HoleOverlay2D 在 requestAnimationFrame 内仍有较重计算（每帧分组聚合与多次对象创建），孔位多时存在掉帧风险。

  • 责任角色：3D 工程师
  • 下一步：抽离“静态分组/标签聚合”到 useMemo，绘制环节仅做投影与绘制；减少帧内临时对象创建。
  • 证据：src/components/3d/HoleOverlay2D.tsx
  • 状态：待处理

P1（中优先级）

• 问题：generate-from-order 仍缺“接口限频 + 幂等键”治理，网络抖动下存在重复生成与写放大风险。

  • 责任角色：后端工程师
  • 下一步：为该路由增加用户维度限频，并设计幂等键（同一次提交在短窗口只执行一次）。
  • 证据：src/app/api/products/[id]/assembly/generate-from-order/route.ts
  • 状态：待处理

• 问题：当前补偿回滚仅覆盖安装顺序，生成前创建版本的写放大仍需评估（失败时可能产生额外版本记录）。

  • 责任角色：后端工程师
  • 下一步：评估“版本创建时机后移”或“失败标记版本”策略，避免无效版本增长。
  • 证据：src/server/services/assembly.service.ts
  • 状态：待处理

• 问题：安装顺序单接口 generate-from-order 已接入，仍需联调确认异常场景与 warnings 展示策略。

  • 责任角色：前端工程师 / 后端工程师
  • 下一步：用真实产品执行“点选顺序 -> 保存并生成”，确认失败提示与步骤回填一致；评估是否补充 warnings UI。
  • 证据：src/app/products/[id]/assembly/AssemblyEditorWorkspace.tsx
  • 状态：待处理

• 问题：AssemblyEditorWorkspace 仍有历史视觉 token 不统一（如部分 bg-white/text-white）。

  • 责任角色：前端工程师
  • 下一步：按页面分区批量替换为语义 token，不改业务逻辑
  • 证据：src/app/products/[id]/assembly/AssemblyEditorWorkspace.tsx
  • 状态：待处理

• 问题：AssemblyEditorWorkspace 仍存在组件内直写 fetch 的历史实现，未完全收口到 hooks/数据层。

  • 责任角色：前端工程师
  • 下一步：按接口链路分批迁移到 src/hooks/api，先迁移装配页高频接口，保持行为不变。
  • 证据：src/app/products/[id]/assembly/AssemblyEditorWorkspace.tsx
  • 状态：待处理

阻塞项

暂无

记录模板

• 问题：
• 责任角色：
• 下一步：
• 证据（文件/命令）：
• 状态：待处理 / 处理中 / 已完成 / 阻塞