Files
dxdesigner-part-replacement/docs/testing/2026-10-15-cbb-conversion-and-navigation.md

3.5 KiB

任务导航与 CBB BOM 格式转换(1.1.2 开发中,未发布)

任务导航

左侧支持按任务名称、目录、备注搜索,以及执行顺序、名称正反序、创建时间正反序、最近更新排序。名称按自然顺序排列,例如 Board2 在 Board10 前面。排序选择在重启后保留。

搜索、排序在缓存的任务列表上进行,不重复查询数据库,也不改写批次执行位置。隐藏当前任务时保留右侧上下文,清空搜索后恢复选中。顺序执行仍处理原批次的全部任务。清空搜索、选择执行顺序后,才可用上移/下移调整执行位置。

本次转换

输入:F:\ABS-file\ABS-file\CBB_BOM_替换清单2026.10.12(1).xlsx。

以“结果”表为主,共 1803 行、104 种工程标签。转换使用现有 write_bom_template,没有修改模板的 11 列、工作表结构或导入约定,也没有修改原文件、任务数据库或 CAD 工程。

复现命令:

python tools/convert_cbb_bom.py 'F:/ABS-file/ABS-file/CBB_BOM_替换清单2026.10.12(1).xlsx' --project-root 'F:/Sync Tool Skyworth/Work Maps/Skyworth_CBB_Lib/CBB' --output-dir 'dist/CBB-BOM-converted'

M 列作为方案候选,V 列只保留作对照,不在 M 缺失时自动补入 V。V 与“缓存”表 O 列的 1803 行一致;M/V 有 90 行同时为明确料号但不同,其中 88 行是 4300-CB1040-A100 与 4300-CC1040-7100 的差异,另外 2 行以 431R 开头。列用途是基于数据关系作出的判断,不代表电气可替换性已经确认。

输出位于 dist/CBB-BOM-converted,不随源码提交原始业务数据:

文件 内容与限制
CBB_转换模板_全量待核对.xlsx 441 行候选、1019 个位号;未定位的工程路径留空,需补齐后才能批量导入
CBB_转换模板_已匹配工程.xlsx 当前目录能定位的候选:10 个工程、63 行、170 个位号;50 行启用,13 行存在差异,默认停用
CBB_逐行转换核对.csv 保留所有 1803 行原始数据、原行号、路径匹配结果和转换说明;不是导入文件
conversion-report.json 转换计数与文件位置

当前指定的 CBB 目录可定位 14 种工程标签,其中 10 种有可转换行。没有新料号、包含“删除该CBB”“不可更换”等说明的行保留在核对清单,不转换为替换操作。M 中仅含一个料号的说明文字可提取为停用候选;多料号、公式和系列后缀不自动解释。M/V 差异、手工处理、未绑定路径等候选默认停用。完成标记不用于删除或筛选行,原 VALUE 不自动写入 custom_value,NC 同步使用原模板默认开启。原行号、M/V、完成标记、VALUE 和相关备注保存在新料号单元格批注中。

验证与尚待完善

27 项针对任务搜索/排序、选中状态、设置持久化、异步响应、原 BOM 导入和此次转换的检查通过(13.16 秒)。两份输出由工具实际的 read_bom_records 重新解析,并检查列名、单工作表、无公式、自动换行以及已匹配路径存在。没有启动 CAD,也没有验证这些业务料号在当前工程/中央库中的实际替换结果;导入仍需同批工程绑定与位号采集匹配。

建议后续补充:导入时选择工作表与列映射;工程名称到任务路径的匹配预览;一次列出全部未命中、跨页重号和冲突行;在界面展示转换来源和停用原因。它们属于后续功能,本次没有改动 BOM 模板或导入界面。