wangruiguo/OnebotCatalog
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
v2.2
OnebotCatalog/工作总结-2026-09.md
wangruiguo e94d2aebc9 v2.2: 桌面版同步 DESTACO 风格选型 + 网页预览后台启动 
桌面版 (仅网页版 v2.1 已做的部分, 本次补齐桌面端, 两端语义一致)
- 新增 OptionTile 控件类: 三态选项块 (可选/已选/不可选), 替代 ComboBox 下拉
  不可选取值置灰+删除线但保留占位 (让用户看到选项存在, 而非从列表消失);
  悬停青色高亮, 再点一次取消选择
- 新增零件号实时条: 复用与网页版同一套「候选型号最长公共前缀」算法,
  已确定片段深青实心 + 待定位数虚化 + 进度条, 选满唯一命中时整块转青色实心
- 维度标题后回显当前已选值
- range 参数 (连续域) 保留可编辑下拉, 无法枚举成卡片
- 参数联动仍复用 Configurator.AllowedOptions, 规则引擎未改动

网页预览后台启动 (无 PowerShell 窗口)
- 新增 tools/serve-web-bg.ps1: Start-Process -WindowStyle Hidden 启动,
  带 -Stop / -Status; 用命令行匹配定位进程 (比只看 PID 文件可靠)
- _start_web.bat / _start_all.bat 改用之, 不再弹窗口

工具
- ui-diagnose.ps1 增强: 原只检查 _boxes (下拉), 现同时检查选项块数量、
  每维度是否有可选值、零件号条输出 —— 可自动发现"某维度全被置灰无从下手"
- 新增 assess-combo-risk.py: 用量化口径评估生成候选的风险
  (以同缸径真实数据值域为官方值域的代理)
- 新增 make-pending-list.py: 重写待补清单, 增加 nearest_real / diff_from_nearest
  列, 每个候选与其最近的真实型号并列, 便于逐个核实

文档
- 新增 工作总结-2026-09.md: 两阶段工作回顾、发现的问题、踩坑经验

验证
- 编译首次通过; UI 诊断 40/40 系列 0 问题
- 零件号条实测: KC0032-10 / ULP32020AEK0 / UAGP075OK120WS0 / LAE140NN31 均完整;
  UCBP 正确提示"该组合对应 2 个型号" (暴露已知数据问题)

踩坑记录
- PowerShell 变量名大小写不敏感: $root 与 $Root 是同一变量, 互相覆盖导致
  启动脚本指向错误目录 (改用 $projRoot)
- .ps1 必须带 UTF-8 BOM, 否则 PS 5.1 按 ANSI 读, 中文注释破坏解析

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-15 18:27:11 +08:00

9.0 KiB
Raw Permalink Blame History

工作总结 — OnebotCatalog 数据完善与界面改版

时间范围：2026-09-13 ~ 09-15 版本：v1.0 → v2.0 → v2.1（桌面版改动未提交，见文末） 代码仓库：https://git.ruiguo.wang/wangruiguo/OnebotCatalog

一、总体成果

指标 改动前 改动后
系列数 40 40
型号总数 54,136 57,293
真实数据分类 3 个（气缸/迷你缸） 7 个（+夹紧缸/定位销/勾销缸/翻转缸/电缸）
手册附图 灰度、部分系列仅 1 页 彩色 346 页，覆盖全部 42 系列
网页版选型交互 下拉菜单 DESTACO 风格（选项块 + 零件号实时拼装）
数据包体积 1.21 GB 2.14 GB

各分类现状：

分类 系列 型号数
AUT 汽车行业气缸 6 12,554
MIN 不锈钢迷你缸 3 25,200
ALU 铝合金迷你缸 2 14,400
CLM 气动夹紧缸 11 860
PIN 气动可伸缩定位销 9 3,455
HOK 气动勾销缸 5 72
ROT 气动翻转缸 2 741
ELEC 电动气缸 1 9
GRP 气动夹爪缸 1 2（仍为占位，X 盘无真实数模）

二、按阶段的工作

阶段 1（v2.0）：4 个分类的真实数据替换

背景：定位销 / 勾销缸 / 翻转缸 / 电缸 4 个分类此前是 demo 占位数据（每类仅 1-3 个型号）。

做法：

  1. 用 pdftotext 提取 19 份 Univer 官方图册的 CODIFICATION KEY，拿到每个系列的官方订购码结构（不靠推测）
  2. 扫描 X 盘 3D 数模，按「官方值域校验 + 左对齐 DFS 填空」解析文件名
  3. 生成 CSV / meta / 复制 STEP

成果：新增 19 系列 1,124 个真实型号（PIN 303 / HOK 73 / ROT 741 / ELEC 9）

过程中解决的关键问题：

问题 处理
解析器无法处理省略空位的型号（如 ULP50040SK0） 改用官方值域 DFS 填空
参数组合可能一对多（选型会静默错配） 加唯一性门禁，1124 型号全部通过
占位/测试文件（如 USP50J_0___K0 销径为空） 解析阶段丢弃
catalog.json 分类系列表未同步 → 10 个系列没进包 更新 CLM.series 数组
手册页全是灰度 脚本误写死 colorspace=fitz.csGRAY，去掉后重做彩色 346 页
UCBT 附图只有 1 页 筛选条件写死 UCBT40 且漏 CLAMPING ARMS，已修正为 3 页
重跑数据脚本会覆盖 meta 附件 改为扫描 manual 目录自动生成附件清单
数据包 2.25GB 超 MemoryStream 2GB 上限 OpcPackage 超大包改走临时文件（保留原有句柄释放语义）

阶段 2（v2.0）：网页版界面改版

  • 首页：全部产品缩略图网格，按大类分组
  • 左树：手风琴（一次展开一个），父级带 9 个内置 SVG 图标，悬停放大动画，可收起为图标窄条
  • 缩略图：40 张（27 张真实产品图从 bom-viewer 复用 + 13 张占位图）
  • 修复分隔条被拖出容器后无法找回（容器感知上限 + resize 重夹取 + 双击复位）
  • 修复搜索到型号后点结果内容区空白（switchTab('dim') 已失效）
  • 购物车打包改取 .step.gz 副档（传输量降至约 1/4.5）

阶段 3（v2.1）：DESTACO 风格选型 + 参数组合补全

3.1 零件号实时拼装

DESTACO 配置器的核心体验。技术难点：40 个系列中只有 KC 有编码模板。

解法：用**「当前候选型号的最长公共前缀」** —— 选得越多候选越少、前缀越长，自然拼出完整零件号。 已验证 40/40 系列前缀单调增长（不回退）。

3.2 参数选择改为选项块

下拉菜单 → 可视化卡片：悬停抬升+青色投影、选中青色填充+✓、 不可选取值置灰保留（而非消失，让用户看到选项存在）、再点一次取消。

3.3 参数组合补全（缺组合也能出零件号）

原逻辑要求「必须有真实数模才能生成型号」，导致库里没有的组合选不出来、也出不了号。

  1. 反推编码模板：infer-sku-template.py 从已有型号反推出 23 个系列 100% 可复现的模板
  2. 加自检门禁：verify-templates.py 用模板重渲染每个已有型号必须逐字一致。 这道检查抓出了真实错误 —— ULM/ULP 行程补零位数写错（2 位写成 3 位）， 若无此校验会生成 3,000 个不存在的零件号发给客户
  3. 补全 8 个系列共 3,157 个型号（全库 54,136 → 57,293）
  4. 占位数模：3157 个型号共用 1 个 PLACEHOLDER.step（4.5KB）， 数据包仅从 2.10GB 增至 2.14GB
  5. 输出 _pending_models.csv 待补清单供 AI 补真实数模

阶段 4：桌面版同步（未提交）

将 3.1 / 3.2 同步到 C#/WPF 桌面版，保持两端语义一致：

  • 新增 OptionTile 控件类（三态选项块）
  • 零件号实时条（复用同一套最长公共前缀算法）
  • range 参数保留可编辑下拉
  • 编译首次通过，算法对拍 40/40 系列通过

三、发现但未处理的问题

按优先级排列：

1. ULP 生成的候选有 56% 超出依据范围 ⚠️

补全时用的是系列级值域（整个 ULP 系列各维度取值的并集），而非按缸径分级。

缸径 真实型号数 真实行程 真实传感器
ULP32 14 20, 40 只有 K
ULP50 83 15~110 D, K
ULP63 71 15~60 D, K

结果：给 ULP32 生成了 9 种行程、传感器 D、杆样式 D/F/H/I/L/M —— 这些在该缸径的真实数据中从未出现。

风险量化（assess-combo-risk.py）：

低风险（取值在同缸径真实数据都出现过）  1,212  (43%)
高风险（含该缸径从未出现的取值）        1,590  (56%)

建议：收窄到低风险的 1,212 个；其余等 AI 补数模时先核对官方图册。

注：曾三次尝试从官方 PDF 提取分级值域，均因图册双栏排版导致文本化后左右栏交错而失败 （把真实数据都判成越界 = 解析错误）。故改用「同缸径真实数据」作为可靠代理。

2. 夹紧缸 9 个系列：一组参数对应多个型号

系列 变体数 重复组数 一组最多
UCBP 358 46 组 18 个
UCBM 266 26 组 15 个
UCBH / UCBQ / UCDP / UCIM / UCIP / UFL / UCBT — 2-7 组 2-6 个

共 310 个型号受影响。原因是编码含参数之外的尾缀（版本号/变体标记）， 如 UCBP25AK00 vs UCBP25AK010。界面已提示"该组合对应 N 个型号"，但无法唯一确定。

3. UAGP / LAGP 参数顺序与官方编码结构不符

官方订购码顺序为 规格-台位-传感器-转角-制动-接口，当前 meta 里传感器排在最后。 不影响选型正确性（参数按名索引），但导致编码模板推不出来，界面展示顺序也与官方不一致。

4. 17 个系列未补全组合

模板验证未通过的系列保持原状 —— 宁可少补，也不生成可能不存在的零件号。

5. 夹爪缸 UGP 仍为占位

X 盘无 UGP 系列真实数模（只有 GR8 抓手组装体），需确认 Univer 官方夹爪缸系列代号。

四、关键经验（避免重复踩坑）

坑 教训
模板必须先自检 用模板重渲染全部已有型号，逐字一致才能用于生成新号。省这道检查会造出不存在的零件号
PowerShell 变量名大小写不敏感 $root 与 $Root 是同一变量，会互相覆盖（启动脚本因此指向错误目录）
.ps1 必须带 UTF-8 BOM PS 5.1 对无 BOM 文件按 ANSI 读，中文注释会破坏解析（用 tools/fix-bom.ps1）
脚本重跑会覆盖手工结果 meta 附件清单改为扫描目录自动生成，而非硬编码
NTFS 硬链接上限 1024 超限部分退化为真实拷贝（曾白占 500MB）。改用共享单文件
Join-Path 不做路径归约 需再 GetFullPath 规范化
MemoryStream 上限 2GB 超大 .opc 改走临时文件副本

五、产出与交付

新增脚本（11 个）：infer-sku-template / verify-templates / quantify-combo-gap / gen-missing-combos / gen-placeholder-step / check-combo-unique / assess-combo-risk / make-pending-list / gen-step-gz / gen-series-thumbs / serve-web-bg

新增文档：docs/更改说明-v2.1.md、本文件

发布产物（release/，未纳入 Git）：

  • OnebotCatalog_2026.09/ — 客户版目录（catalog.opc 2.14GB）
  • update_2026.09/catalog.opc — 增量更新包
  • web_2026.09/ — 网页站（含 3,285 个 gz 副档）

六、待办

  1. 决定 ULP 高危候选如何处置（收窄 / 维持 / 由 AI 核对官方图册）
  2. 桌面版改动提交推送（当前工作区有未提交改动，建议发 v2.2）
  3. AI 补真实数模：按 _pending_models.csv 逐个核对后替换 step_file
  4. 处理夹紧缸一对多问题（补维度或清理尾缀）
  5. 确认 UGP 夹爪缸官方系列代号

本总结由 Claude Code 生成于 2026-09-15