选型咨询系统开发日志

系统名：机器人选型咨询决策辅助平台

当前版本：v1.0

仓库位置：项目本地目录（已脱敏）

---

版本历史

v0.1 经典版 — 已退役

• 一次性全填表单 + 全枚举选型算法
• 2026-09-01 分步向导上线后删除 UI
• 备份：项目备份目录（已脱敏）
• 算法层（src/ 2848 行）继续被底层复用

v1.0 分步向导 — 当前

• 4 步配置化向导：选大类 → 选细分 → 选规格 → Top-5

---

基础架构

• 项目骨架：products.json（544 整机）+ wizard.yaml（7 大类 + 4 步配置）+ wizard.py（4 个 API）+ wizard.html（4 步前端）
• 修 web/__init__.py 让 python3 -m web.app 可被调用
• 修 Flask 端口 5000 → 5001（macOS AirPlay Receiver 占用 5000）

数据准备

• 读产品中心 CSV（2484 行）→ 提取 7 类目 / 544 整机
• 修字段名匹配（172 个不同字段名）
• 修 IP 字段重复 IPIP50 → IP50
• 协作机器人数据完整度提升：payload 17→149、reach 80→148、repeat 0→48

4 步向导

• 4 步基础跑通（机械臂线完整）
• 进度条可点击回跳（4 步均可点）
• step1 选卡片自动跳 step2（0.2 秒延迟）

第 3 步滑块

• 加 3 字段：负载 / 臂展 / 重复定位精度
• 动态 step：0-10 用 1 步 / 10-100 用 10 步 / 100+ 用 50 步
• 修滑块拖动 bug（4 input 拆开独立 update）
• 改对数刻度（让主流机械臂 500-1500mm 占滑块中段）

第 4 步

• 选择回顾面板（点修改跳回任意步）
• 两栏布局：左 Top-5 卡片 / 右产品详情
• localStorage 历史记录（10 条 + 签名去重）
• 卡片去第三行（左侧只显示品牌 + 型号 + 分类）
• 全屏"查看所有"modal（左侧 2 列 grid + 右侧详情）

对话框

• step1/2/3 底部各加"帮助"占位 UI
• 点击弹 alert 提示 2.0 上线
• 待办：FAQ + LLM 接入（2.0 实现）

Bug 修复

• 滑块拖不动 → 拆开 4 input 独立监听
• 重复历史记录 → 加签名去重
• "55轴"误显示 → 加 axes <= 10 过滤
• 步 4 跳转报错（首次）→ 修 setTimeout 异步时序
• 跳回前几步选项清空 → 3 个 load 函数恢复 state
• 进度条直接点 step2/3/4 未选大类 → 加拦截

文档 / 清理

• 品牌脱敏：5 模板去"肉包机器人"、保留 roboxera.cn
• 首页副标题删除、12 处装饰 emoji 删除
• 删经典版 v0.1 UI（备份在项目备份目录）
• 加 LOG.md + /log 路由
• 加侧边使用说明小窗口

---

关键数字

• 总代码行数：3700+ 行
• 产品库：544 整机 / 2484 全量
• 测试用例：69 个（全过）
• 部署端口：5001
• 启动命令：bash run_web.sh 或 python3 -m web.app
• 访问地址：http://127.0.0.1:5001/wizard
• 日志地址：http://127.0.0.1:5001/log

决策记录

• step1 选卡片自动跳 step2 — 用户体验，减少点击
• 进度条可点击回跳 — 让用户能修改前面选择
• 第 4 步前置条件 = state.category — 避免 setTimeout 异步时序 bug
• 跳回前几步保留选项 — UI 和数据保持一致
• 步 3 滑块用对数刻度 — 主流产品（500-1500mm）占中段
• 卡片不显示参数行 — 减少视觉噪音，参数看右侧详情
• 历史去重（category+subtypes+specs）— 相同查询不重复覆盖
• 删经典版 v0.1 UI — v1.0 完整覆盖其功能

2.0 待办

• 对话框真实功能（FAQ + LLM）
• 动态产品规格范围（按 l2 分类）
• 软著说明书（30 页）
• 性能优化（renderAll 时分页）
• 价格兜底（取代理价/零售价）