feat: 单项 Value 策略与迁移工程多 Excel BOM 导入 #21

Merged
abaishu0730 merged 3 commits from codex/item-value-bom-import into main 2026-11-05 14:08:02 +08:00
Owner

本次让每个位号独立指定 Value 来源,并让迁移过工程目录的 BOM 支持多份 Excel 一次导入。旧路径失效时,仅按唯一、精确匹配的工程名称绑定当前路径;名称歧义或跨文件重复位号会阻止本批保存。

变更

  • 单项支持继承任务默认、Preserve、Part Label、Part Number、Custom;显式选择优先于任务默认,批量自定义规则更新保留单项覆盖。
  • 策略随数据库、Excel 计划、冻结命令及恢复读取保存;兼容旧 BOM 和旧计划格式。
  • 多选 BOM 沿用既有监督、阶段通知、取消和清理保护;保留来源文件、原行号、原路径、当前路径和匹配原因。
  • 对接主线操作历史,记录仅修改单项 Value 的操作;读取计划时同时保留封装选择和 Value 策略。
  • 修复真实实测发现的两处文件占用问题:资源状态原子替换补齐共享占用识别的目标路径;会话回执增加有界的文件写入重试,不重做 CAD 操作。

审查修复(94a873f)

已按评论 217 处理 1 项 P2、5 项 P3,并补齐 CI 覆盖:

  • 迁移路由同时接受唯一任务显示名与工程文件名;精确路径优先、名称歧义阻断;单工程空路径保留旧行为。
  • 重复项与界面报告显示原始文件/行号,来源记录挂入报告和任务事件,可随脱敏诊断包导出;沿用历史保留限制,校验后删除规范化 Excel。
  • 匹配原因区分迁移与唯一工程兜底,相对路径仍拒绝;来源映射使用既有原子写入与占用重试。
  • 用户 BOM 模板固定提供第 12 列 Value 来源,含样式、帮助与五种策略下拉;旧 11 列格式兼容。
  • 多文件导入从读源前进入同一个监督操作,全程持有占用,逐文件显示进度;清理异常保留报告并清除可执行预览。
  • Linux CI 增加 openpyxl 和模板/策略、审查回归测试入口。

本轮定向验证:功能与监督 44 passed;模板兼容 34 passed;协议与结果处理 22 passed;UI 原始行号/失败/重试 3 passed;真实监督子进程完整双表导入 1 passed。范围有重叠,不累加。报告、诊断及保留相邻用例中两项 UI 的旧模拟入口/按钮就绪等待已修正,只复跑失败项;原始与最终结果均写入记录。独立只读复核未发现阻塞问题,编译和差异检查通过。远端 Linux CI 已通过:94a873f 的 push 与 pull_request 共 4 个检查全部 success,包含新增模板/策略及审查回归。

修复及逐项验收记录:docs/testing/2026-11-05-pr21-review-fixes.md。本轮未重复真实 CAD/PCB,未构建安装包,未合并 PR。

原功能验收记录

  • 基于最新 main(9316cf4)整理后:新增功能与文件占用、界面专项 29 passed;计划读取及操作历史适配 14 passed。检查范围有重叠,不累加为独立总数。
  • 真实 DxDesigner:2 个工程新副本、2 份旧路径 Excel、4 个位号实际替换,保存重开并用全新 CAD 进程独立读回。Value 分别为 Part Label 的 0R、Preserve 的无 Value 属性、Part Number 的 4100-CA0000-T0、Custom 的 47k。
  • 现场遇到文件占用后按保护流程停止,修复并核验恢复;日志恰好 4 次原生替换,恢复记录 native_replacement_called=false。原工程、源库及 PCB 文件哈希未变。
  • 真实 CAD 实测在分支整理前的功能工作区完成;移入最新主线后仅做上述适配检查,按用户要求没有重复替换、没有执行 PCB,也未重复跑整套回归。
  • 差异检查和 Python 编译检查通过。未构建或发布安装包。

详细记录:

  • docs/testing/2026-11-05-item-value-bom-import.md
  • docs/testing/2026-11-05-item-value-bom-native.md

PR 基于最新 main,仅提交本轮功能和实测修复;原工作区的其他 DSH 改动保留在原处。

本次让每个位号独立指定 Value 来源,并让迁移过工程目录的 BOM 支持多份 Excel 一次导入。旧路径失效时,仅按唯一、精确匹配的工程名称绑定当前路径;名称歧义或跨文件重复位号会阻止本批保存。 ## 变更 - 单项支持继承任务默认、Preserve、Part Label、Part Number、Custom;显式选择优先于任务默认,批量自定义规则更新保留单项覆盖。 - 策略随数据库、Excel 计划、冻结命令及恢复读取保存;兼容旧 BOM 和旧计划格式。 - 多选 BOM 沿用既有监督、阶段通知、取消和清理保护;保留来源文件、原行号、原路径、当前路径和匹配原因。 - 对接主线操作历史,记录仅修改单项 Value 的操作;读取计划时同时保留封装选择和 Value 策略。 - 修复真实实测发现的两处文件占用问题:资源状态原子替换补齐共享占用识别的目标路径;会话回执增加有界的文件写入重试,不重做 CAD 操作。 ## 审查修复(94a873f) 已按评论 217 处理 1 项 P2、5 项 P3,并补齐 CI 覆盖: - 迁移路由同时接受唯一任务显示名与工程文件名;精确路径优先、名称歧义阻断;单工程空路径保留旧行为。 - 重复项与界面报告显示原始文件/行号,来源记录挂入报告和任务事件,可随脱敏诊断包导出;沿用历史保留限制,校验后删除规范化 Excel。 - 匹配原因区分迁移与唯一工程兜底,相对路径仍拒绝;来源映射使用既有原子写入与占用重试。 - 用户 BOM 模板固定提供第 12 列 Value 来源,含样式、帮助与五种策略下拉;旧 11 列格式兼容。 - 多文件导入从读源前进入同一个监督操作,全程持有占用,逐文件显示进度;清理异常保留报告并清除可执行预览。 - Linux CI 增加 openpyxl 和模板/策略、审查回归测试入口。 本轮定向验证:功能与监督 44 passed;模板兼容 34 passed;协议与结果处理 22 passed;UI 原始行号/失败/重试 3 passed;真实监督子进程完整双表导入 1 passed。范围有重叠,不累加。报告、诊断及保留相邻用例中两项 UI 的旧模拟入口/按钮就绪等待已修正,只复跑失败项;原始与最终结果均写入记录。独立只读复核未发现阻塞问题,编译和差异检查通过。远端 Linux CI 已通过:94a873f 的 push 与 pull_request 共 4 个检查全部 success,包含新增模板/策略及审查回归。 修复及逐项验收记录:`docs/testing/2026-11-05-pr21-review-fixes.md`。本轮未重复真实 CAD/PCB,未构建安装包,未合并 PR。 ## 原功能验收记录 - 基于最新 main(9316cf4)整理后:新增功能与文件占用、界面专项 **29 passed**;计划读取及操作历史适配 **14 passed**。检查范围有重叠,不累加为独立总数。 - 真实 DxDesigner:2 个工程新副本、2 份旧路径 Excel、4 个位号实际替换,保存重开并用全新 CAD 进程独立读回。Value 分别为 Part Label 的 0R、Preserve 的无 Value 属性、Part Number 的 4100-CA0000-T0、Custom 的 47k。 - 现场遇到文件占用后按保护流程停止,修复并核验恢复;日志恰好 4 次原生替换,恢复记录 native_replacement_called=false。原工程、源库及 PCB 文件哈希未变。 - 真实 CAD 实测在分支整理前的功能工作区完成;移入最新主线后仅做上述适配检查,按用户要求没有重复替换、没有执行 PCB,也未重复跑整套回归。 - 差异检查和 Python 编译检查通过。未构建或发布安装包。 详细记录: - `docs/testing/2026-11-05-item-value-bom-import.md` - `docs/testing/2026-11-05-item-value-bom-native.md` PR 基于最新 main,仅提交本轮功能和实测修复;原工作区的其他 DSH 改动保留在原处。
abaishu0730 added 1 commit 2026-11-05 11:28:42 +08:00
feat: support item value policies and migrated multi-file BOM import
Core regression / Python core and release configuration (push) Successful in 17s
Core regression / JavaScript syntax (push) Successful in 2s
Core regression / Python core and release configuration (pull_request) Successful in 14s
Core regression / JavaScript syntax (pull_request) Successful in 3s
8b5509d64f
Author
Owner

PR #21 审查意见

审查提交:8b5509d64f15331167f637a71158457764ddd71f(1 个提交),基分支 main:9316cf4fc4f1b378e0df55cf136934ef3d28539d。
head 直接位于 main 顶端,无落后提交;Gitea mergeable=true。改动 29 个文件、+1418/−63。

建议修复后合并(Request changes):1 项 P2、5 项 P3。

总体判断:单项 Value 策略这条链路是完整且自洽的——数据库迁移、任务上下文、执行规则、冻结命令、恢复读取、计划导入导出、UI 下拉与 Esc 取消都有真实测试,我也逐处核对了"inherit 是否在每个解析点都拿到任务默认值"。多文件 BOM 的读入、路由、重复阻塞、规范化与原子保存也成立。问题集中在两处口径不一致与三处证据/提示细节上,都属于小范围可修的。


[P2] 迁移路由按"工程文件基名"匹配,模板导出的却是"任务显示名"——任务改名后按名称迁移直接失败

位置:workspace_bom.py:17–19(_project_name 只取路径最后一段)、workspace_bom.py:116–120、workspace_bom.py:123–139、bom_batch.py:45–48。

export_template 把 project_name 写成 task.name(任务显示名,UI 可编辑,main_window.py:596),而 resolve_project/_exact_name_matches 把 BOM 里的名称与 Path(project).name(文件名,含 .prj)比较。两者只在"任务从未改过名"时相等(发现任务时任务名就是文件名,例如 Board.prj),一旦用户把任务改成有意义的名字,名称迁移就永远匹配不上。

复现(真实 TaskCenterService,两个工程场景同源):

create_project_tasks(root)                    # 任务名 Board.prj
update_task(task, name='音频板')               # UI 里的改名
export_template(...)                          # 模板工程名称列 = '音频板'
# 按迁移用法把旧路径改成 Z:\migrated-old\Board.prj,填好旧/新料号与位号
preview_bom_sources(task, (stale.xlsx,))
→ project_binding: 无法唯一匹配 BOM 工程,请确认迁移工程对应关系:stale.xlsx 第 2 行:音频板

同名不改成"音频板"(即模板里是 Board.prj)时,同一份文件按名称路由成功。也就是说,本 PR 主打的"旧路径失效时按唯一、精确匹配的工程名称绑定"在任务改名(一个正常的整理动作)后就失效;多工程批次里只要有一个成员改过名,它的所有行都会被整批拒绝。

同一段代码还带来一个旧用法回归(同一 fixture 在 base 与 head 上对照):

单工程任务 + BOM 工程路径列留空 + 工程名称列 = 任务名(非 .prj 基名)
base(inspect_bom_batch) → passed=1 failed=0 preview=True
head(preview_bom_sources)→ project_binding 整批拒绝,且没有逐行报告

base 对单工程 BOM 在路径为空时无条件绑定唯一工程;head 要求名称也必须精确命中,于是"复制 BOM 行时清空路径列"这种常见做法从"能用"变成"整批拒绝",而且拒绝发生在规范化阶段,用户拿不到熟悉的逐行报告。

建议:让模板导出的名称与匹配器口径一致——要么名称匹配同时接受任务显示名与 .prj 基名,要么模板把 .prj 基名写进"工程名称"列(显示名放到别处);同时对"范围内只有一个工程"的情况保留无条件绑定,或至少降级为逐行失败报告而不是整批异常。

[P3] 跨文件重复位号的提示行号是规范化后的行号,与"来源"标注自相矛盾

位置:bom_import_report.py:118–123、bom_import_report.py:315–319、service.py:222–228。

重复提示用的是规范化文件里的行号。两份文件、第二份真实第 5 行时,输出是:

位号在 BOM 中重复(Excel 行 2, 3);来源:…\d1.xlsx 第 2 行
位号在 BOM 中重复(Excel 行 2, 3);来源:…\d2.xlsx 第 5 行

"Excel 行 2, 3"与"第 5 行"直接打架,用户按提示去第二份文件找第 3 行会找不到。建议在 annotate 之后按来源行号重排这句提示,或只报位号不报行号。

[P3] "保留来源"落在 imports/<uuid>/,但不被任何记录引用、不进诊断包、也没有清理

位置:service.py:216–219、workspace_bom.py:163–185。

每次多文件导入都会写 imports/<uuid>/normalized-bom.xlsx 与 source-map.json。但:

  • 全仓只有 service.py:216 一处引用这个目录,任务、历史、导入结果里都没有它的路径;
  • 诊断包的顶层白名单(diagnostics_bundle.py:98)会把 imports 记为 outside_allowlist(实测 manifest 里就是这条),所以证据包也不含它;
  • 没有保留/清理策略,只增不减,且每份副本都含用户的 BOM 内容与原始工程路径。

结果是文档承诺的"保留来源文件、原行号、原路径、当前路径和匹配原因"实际不可从任务或诊断包找回,只能在数据目录里碰运气。建议把来源映射挂到导入结果/历史(或随批次命名登记),并决定它进证据包还是定期清理。

[P3] source-map.json 的 match_reason 在兜底与相对路径场景下标注失真,且写入未加保护

位置:workspace_bom.py:175–185。

  • 工程名称与路径都为空、靠"唯一工程兜底"绑定的行,match_reason 写成 migrated_exact_name(探针实测),实际既不是名称匹配也不是迁移匹配;
  • 相对路径(如 sub/Board.prj)在 load_sources 阶段不被拦截,resolve_project 会退化成"按末端名称匹配"并接受,而 base 的 parse_bom_row 会报"工程路径必须使用模板中的完整路径"。宽容本身可以接受,但应该在 match_reason 里体现为 basename/relative_path 而不是 migrated_exact_name;
  • source-map.json 用裸 write_text 落盘,没有本仓统一的 retry_sharing_violation/原子替换;在数据目录被同步盘或杀软短暂占用时,导入会在规范化完成后整批失败,且可能留下半截 JSON。

[P3] BOM 模板不提供"Value 来源"列;手工加列时表头没有样式与帮助

位置:bom_plan.py:48–75、workspace_bom.py:99–103。

export_template 的记录里没有 value_mode,所以 write_bom_template 导出的仍是 11 列;而导入侧完全支持 value_mode/value来源/value策略 三种列名。也就是说,用户想按 BOM 指定单项策略,只能自己手工加一列(列名还得正好命中别名),模板、提示、帮助文字都没有引导。

用带 value_mode 的记录生成时,第 12 列表头没有深色填充也没有批注(zip(sheet[1], _HEADER_HELP) 只覆盖 11 项,实测 fill_type=None、comment=None),而相邻表头都是 1D3557 实色 + 帮助批注;L2:L… 的下拉校验也只在这个内部规范化文件里才会生效。

建议:模板固定导出该列(或在帮助文字里说明可加列及列名),并补齐第 12 列的表头样式/批注。

[P3] 多文件导入被拆成两个独立操作,中间释放快速执行租约;读取阶段没有相位/进度

位置:service.py:200–221、service.py:230–242。

normalize 在 _idle_quick_run_operation('preview_bom_sources', …) 里执行(取租约、检查队列空闲),随后 inspect_bom_batch 再走一次独立的监督操作。两段之间租约已经释放:若队列或另一个窗口的操作恰好启动,导入会在"文件已全部读出、规范化文件已落盘"之后被拒(失败方向是安全的,但白读一遍且报错信息不指向真正原因)。另外 load_sources 不调用 on_phase/on_progress,选中多个大工作簿时界面在进入 inspect 之前没有任何阶段或进度反馈。

建议:用一个操作包住"读取+路由+检查"(或把规范化放进监督请求里),并让 load_sources 按文件上报相位。


已独立验证、不重复列的部分

  • 单项策略解析:inherit 在任务上下文、_execution_rules、BOM 校验、新回合、计划读取五处都按任务默认解析;显式 preserve/part_label/part_number/custom 覆盖任务默认;custom 强制 custom_value_enabled 一致。全仓 9 处 compile_target_rules 调用点逐一核对,未传默认值的 3 处都只做校验(不产出执行规则)。
  • 冻结与恢复:command.tsv 每行写 value_mode,并新增 base_value_mode 承载任务默认;_read_command_options/_queue_value_mode/_queue_matches_inputs 都会校验两列;execution_journal.command_identity 把 value_mode 纳入冻结计划哈希;recovery 只重写目标 job 的四个选项并保留 base_value_mode,读回仍能通过校验。
  • 数据库与历史:ALTER TABLE target_plan ADD COLUMN value_mode TEXT NOT NULL DEFAULT 'inherit' 等于旧语义(旧行随任务默认);历史变更捕获列入 value_mode,_TABLES 只用于当前库的捕获触发器,旧 JSONL 导入不读该列,无兼容风险。
  • 多文件读入:先读完全部工作簿再进入工程检查,公式/坏料号在 CAD 之前拦截;跨文件重复位号阻塞、名称歧义阻塞、save_batch 事务 + 基线与范围比对、未确认前不改计划,均已验证。
  • 两处文件占用修复:write_record 把目标路径传入共享占用识别,只对 32/33 与"读句柄占 5"重试 3 次,永久权限错误不重试;VBS 仅对 project-session-result.tsv 做 20×50ms 有界重试,其余写入一次即抛,不重做 CAD。
  • UI:下拉 inherit/preserve/part_label/part_number/custom、Tab 提交、Esc 取消、旧自定义勾选与策略同步、编辑锁定时只读,均有真实控件测试;columnCount 随 HEADERS 增长,批量编辑路径按列分派。

测试与流程

  • 本 PR 新增/改动的专项与相邻套件独立跑:tests/trial_task_center/test_item_value_and_bom_sources.py、tests/ui/test_value_options_layout.py、tests/v1_1/{test_bom_batch,test_bom_import_report,test_history_service_entrypoints,test_path_access,test_project_session,test_ui_workspace}.py → 109 passed。
  • 文档里那条 165 项回归命令在 head 上重跑 → 175 passed(比文档多 10 项,属套件增量)。
  • 文档声称 tests/trial_task_center 全目录 355 passed,本次重跑 → 359 passed(比文档多 4 项,属本轮新增用例)。
  • CI 不覆盖本 PR 任何测试:.gitea/workflows/ci.yml:33–41 只跑 5 个 dsh 测试和 3 个 packaging 文件,tests/trial_task_center、tests/v1_1、tests/ui 都不在其中。建议至少把本 PR 的专项文件纳入。
  • PR 自述"移入最新主线后仅做上述适配检查…未重复跑整套回归"——这一点与 PR19 相同:最终 head 没有完整回归记录,跨模块影响只能靠审查侧复核。

本次独立验证记录

  • 数据来源:从 Git 导出的独立快照与工作树 G:\pr21-head(head 8b5509d)、G:\base21-head(base 9316cf4),未修改 PR 源码。
  • 静态检查:python -m compileall -q src packaging tools 退出 0;git diff --check basemain21 pr21 退出 0。
  • 行为对照(base vs head,同一 fixture、同一份 BOM):单工程空路径场景 base passed=1 preview=True、head project_binding 拒绝;改名任务 + 旧路径场景 head 拒绝;跨文件重复提示行号与来源标注矛盾;模板列与表头样式;imports 目录与诊断包白名单。以上均用真实服务与真实 xlsx 复现,未使用模拟 CAD(inspect 用 runtime 代替品)。
  • 未做:真实 DxDesigner 替换(沿用 PR 自述的实测边界)、PCB、安装包构建、真实工单。
# PR #21 审查意见 审查提交:`8b5509d64f15331167f637a71158457764ddd71f`(1 个提交),基分支 main:`9316cf4fc4f1b378e0df55cf136934ef3d28539d`。 head 直接位于 main 顶端,无落后提交;Gitea `mergeable=true`。改动 29 个文件、+1418/−63。 **建议修复后合并(Request changes):1 项 P2、5 项 P3。** 总体判断:单项 Value 策略这条链路是完整且自洽的——数据库迁移、任务上下文、执行规则、冻结命令、恢复读取、计划导入导出、UI 下拉与 Esc 取消都有真实测试,我也逐处核对了"inherit 是否在每个解析点都拿到任务默认值"。多文件 BOM 的读入、路由、重复阻塞、规范化与原子保存也成立。问题集中在两处口径不一致与三处证据/提示细节上,都属于小范围可修的。 --- ## [P2] 迁移路由按"工程文件基名"匹配,模板导出的却是"任务显示名"——任务改名后按名称迁移直接失败 位置:[workspace_bom.py:17–19](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/8b5509d64f15331167f637a71158457764ddd71f/src/dx_productivity/trial_task_center/workspace_bom.py#L17)(`_project_name` 只取路径最后一段)、[workspace_bom.py:116–120](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/8b5509d64f15331167f637a71158457764ddd71f/src/dx_productivity/trial_task_center/workspace_bom.py#L116)、[workspace_bom.py:123–139](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/8b5509d64f15331167f637a71158457764ddd71f/src/dx_productivity/trial_task_center/workspace_bom.py#L123)、[bom_batch.py:45–48](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/8b5509d64f15331167f637a71158457764ddd71f/src/dx_productivity/trial_task_center/bom_batch.py#L45)。 `export_template` 把 `project_name` 写成 `task.name`(任务显示名,UI 可编辑,[main_window.py:596](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/8b5509d64f15331167f637a71158457764ddd71f/src/dx_productivity/trial_task_center/ui/main_window.py#L596)),而 `resolve_project`/`_exact_name_matches` 把 BOM 里的名称与 `Path(project).name`(文件名,含 `.prj`)比较。两者只在"任务从未改过名"时相等(发现任务时任务名就是文件名,例如 `Board.prj`),一旦用户把任务改成有意义的名字,名称迁移就永远匹配不上。 复现(真实 `TaskCenterService`,两个工程场景同源): ``` create_project_tasks(root) # 任务名 Board.prj update_task(task, name='音频板') # UI 里的改名 export_template(...) # 模板工程名称列 = '音频板' # 按迁移用法把旧路径改成 Z:\migrated-old\Board.prj,填好旧/新料号与位号 preview_bom_sources(task, (stale.xlsx,)) → project_binding: 无法唯一匹配 BOM 工程,请确认迁移工程对应关系:stale.xlsx 第 2 行:音频板 ``` 同名不改成"音频板"(即模板里是 `Board.prj`)时,同一份文件按名称路由成功。也就是说,本 PR 主打的"旧路径失效时按唯一、精确匹配的工程名称绑定"在任务改名(一个正常的整理动作)后就失效;多工程批次里只要有一个成员改过名,它的所有行都会被整批拒绝。 同一段代码还带来一个**旧用法回归**(同一 fixture 在 base 与 head 上对照): ``` 单工程任务 + BOM 工程路径列留空 + 工程名称列 = 任务名(非 .prj 基名) base(inspect_bom_batch) → passed=1 failed=0 preview=True head(preview_bom_sources)→ project_binding 整批拒绝,且没有逐行报告 ``` base 对单工程 BOM 在路径为空时无条件绑定唯一工程;head 要求名称也必须精确命中,于是"复制 BOM 行时清空路径列"这种常见做法从"能用"变成"整批拒绝",而且拒绝发生在规范化阶段,用户拿不到熟悉的逐行报告。 建议:让模板导出的名称与匹配器口径一致——要么名称匹配同时接受任务显示名与 `.prj` 基名,要么模板把 `.prj` 基名写进"工程名称"列(显示名放到别处);同时对"范围内只有一个工程"的情况保留无条件绑定,或至少降级为逐行失败报告而不是整批异常。 ## [P3] 跨文件重复位号的提示行号是规范化后的行号,与"来源"标注自相矛盾 位置:[bom_import_report.py:118–123](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/8b5509d64f15331167f637a71158457764ddd71f/src/dx_productivity/trial_task_center/bom_import_report.py#L118)、[bom_import_report.py:315–319](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/8b5509d64f15331167f637a71158457764ddd71f/src/dx_productivity/trial_task_center/bom_import_report.py#L315)、[service.py:222–228](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/8b5509d64f15331167f637a71158457764ddd71f/src/dx_productivity/trial_task_center/service.py#L222)。 重复提示用的是规范化文件里的行号。两份文件、第二份真实第 5 行时,输出是: ``` 位号在 BOM 中重复(Excel 行 2, 3);来源:…\d1.xlsx 第 2 行 位号在 BOM 中重复(Excel 行 2, 3);来源:…\d2.xlsx 第 5 行 ``` "Excel 行 2, 3"与"第 5 行"直接打架,用户按提示去第二份文件找第 3 行会找不到。建议在 `annotate` 之后按来源行号重排这句提示,或只报位号不报行号。 ## [P3] "保留来源"落在 `imports/<uuid>/`,但不被任何记录引用、不进诊断包、也没有清理 位置:[service.py:216–219](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/8b5509d64f15331167f637a71158457764ddd71f/src/dx_productivity/trial_task_center/service.py#L216)、[workspace_bom.py:163–185](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/8b5509d64f15331167f637a71158457764ddd71f/src/dx_productivity/trial_task_center/workspace_bom.py#L163)。 每次多文件导入都会写 `imports/<uuid>/normalized-bom.xlsx` 与 `source-map.json`。但: - 全仓只有 [service.py:216](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/8b5509d64f15331167f637a71158457764ddd71f/src/dx_productivity/trial_task_center/service.py#L216) 一处引用这个目录,任务、历史、导入结果里都没有它的路径; - 诊断包的顶层白名单([diagnostics_bundle.py:98](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/8b5509d64f15331167f637a71158457764ddd71f/src/dx_productivity/trial_task_center/diagnostics_bundle.py#L98))会把 `imports` 记为 `outside_allowlist`(实测 manifest 里就是这条),所以证据包也不含它; - 没有保留/清理策略,只增不减,且每份副本都含用户的 BOM 内容与原始工程路径。 结果是文档承诺的"保留来源文件、原行号、原路径、当前路径和匹配原因"实际不可从任务或诊断包找回,只能在数据目录里碰运气。建议把来源映射挂到导入结果/历史(或随批次命名登记),并决定它进证据包还是定期清理。 ## [P3] `source-map.json` 的 `match_reason` 在兜底与相对路径场景下标注失真,且写入未加保护 位置:[workspace_bom.py:175–185](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/8b5509d64f15331167f637a71158457764ddd71f/src/dx_productivity/trial_task_center/workspace_bom.py#L175)。 - 工程名称与路径都为空、靠"唯一工程兜底"绑定的行,`match_reason` 写成 `migrated_exact_name`(探针实测),实际既不是名称匹配也不是迁移匹配; - 相对路径(如 `sub/Board.prj`)在 `load_sources` 阶段不被拦截,`resolve_project` 会退化成"按末端名称匹配"并接受,而 base 的 `parse_bom_row` 会报"工程路径必须使用模板中的完整路径"。宽容本身可以接受,但应该在 `match_reason` 里体现为 `basename`/`relative_path` 而不是 `migrated_exact_name`; - `source-map.json` 用裸 `write_text` 落盘,没有本仓统一的 `retry_sharing_violation`/原子替换;在数据目录被同步盘或杀软短暂占用时,导入会在规范化完成后整批失败,且可能留下半截 JSON。 ## [P3] BOM 模板不提供"Value 来源"列;手工加列时表头没有样式与帮助 位置:[bom_plan.py:48–75](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/8b5509d64f15331167f637a71158457764ddd71f/src/dx_productivity/trial_task_center/bom_plan.py#L48)、[workspace_bom.py:99–103](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/8b5509d64f15331167f637a71158457764ddd71f/src/dx_productivity/trial_task_center/workspace_bom.py#L99)。 `export_template` 的记录里没有 `value_mode`,所以 `write_bom_template` 导出的仍是 11 列;而导入侧完全支持 `value_mode`/`value来源`/`value策略` 三种列名。也就是说,用户想按 BOM 指定单项策略,只能自己手工加一列(列名还得正好命中别名),模板、提示、帮助文字都没有引导。 用带 `value_mode` 的记录生成时,第 12 列表头**没有**深色填充也没有批注(`zip(sheet[1], _HEADER_HELP)` 只覆盖 11 项,实测 `fill_type=None`、`comment=None`),而相邻表头都是 `1D3557` 实色 + 帮助批注;`L2:L…` 的下拉校验也只在这个内部规范化文件里才会生效。 建议:模板固定导出该列(或在帮助文字里说明可加列及列名),并补齐第 12 列的表头样式/批注。 ## [P3] 多文件导入被拆成两个独立操作,中间释放快速执行租约;读取阶段没有相位/进度 位置:[service.py:200–221](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/8b5509d64f15331167f637a71158457764ddd71f/src/dx_productivity/trial_task_center/service.py#L200)、[service.py:230–242](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/8b5509d64f15331167f637a71158457764ddd71f/src/dx_productivity/trial_task_center/service.py#L230)。 `normalize` 在 `_idle_quick_run_operation('preview_bom_sources', …)` 里执行(取租约、检查队列空闲),随后 `inspect_bom_batch` 再走一次独立的监督操作。两段之间租约已经释放:若队列或另一个窗口的操作恰好启动,导入会在"文件已全部读出、规范化文件已落盘"之后被拒(失败方向是安全的,但白读一遍且报错信息不指向真正原因)。另外 `load_sources` 不调用 `on_phase`/`on_progress`,选中多个大工作簿时界面在进入 `inspect` 之前没有任何阶段或进度反馈。 建议:用一个操作包住"读取+路由+检查"(或把规范化放进监督请求里),并让 `load_sources` 按文件上报相位。 --- ## 已独立验证、不重复列的部分 - **单项策略解析**:`inherit` 在任务上下文、`_execution_rules`、BOM 校验、新回合、计划读取五处都按任务默认解析;显式 `preserve`/`part_label`/`part_number`/`custom` 覆盖任务默认;`custom` 强制 `custom_value_enabled` 一致。全仓 9 处 `compile_target_rules` 调用点逐一核对,未传默认值的 3 处都只做校验(不产出执行规则)。 - **冻结与恢复**:`command.tsv` 每行写 `value_mode`,并新增 `base_value_mode` 承载任务默认;`_read_command_options`/`_queue_value_mode`/`_queue_matches_inputs` 都会校验两列;`execution_journal.command_identity` 把 `value_mode` 纳入冻结计划哈希;`recovery` 只重写目标 job 的四个选项并保留 `base_value_mode`,读回仍能通过校验。 - **数据库与历史**:`ALTER TABLE target_plan ADD COLUMN value_mode TEXT NOT NULL DEFAULT 'inherit'` 等于旧语义(旧行随任务默认);历史变更捕获列入 `value_mode`,`_TABLES` 只用于当前库的捕获触发器,旧 JSONL 导入不读该列,无兼容风险。 - **多文件读入**:先读完全部工作簿再进入工程检查,公式/坏料号在 CAD 之前拦截;跨文件重复位号阻塞、名称歧义阻塞、`save_batch` 事务 + 基线与范围比对、未确认前不改计划,均已验证。 - **两处文件占用修复**:`write_record` 把目标路径传入共享占用识别,只对 32/33 与"读句柄占 5"重试 3 次,永久权限错误不重试;VBS 仅对 `project-session-result.tsv` 做 20×50ms 有界重试,其余写入一次即抛,不重做 CAD。 - **UI**:下拉 `inherit/preserve/part_label/part_number/custom`、Tab 提交、Esc 取消、旧自定义勾选与策略同步、编辑锁定时只读,均有真实控件测试;`columnCount` 随 `HEADERS` 增长,批量编辑路径按列分派。 ## 测试与流程 - 本 PR 新增/改动的专项与相邻套件独立跑:`tests/trial_task_center/test_item_value_and_bom_sources.py`、`tests/ui/test_value_options_layout.py`、`tests/v1_1/{test_bom_batch,test_bom_import_report,test_history_service_entrypoints,test_path_access,test_project_session,test_ui_workspace}.py` → **109 passed**。 - 文档里那条 165 项回归命令在 head 上重跑 → **175 passed**(比文档多 10 项,属套件增量)。 - 文档声称 `tests/trial_task_center` 全目录 355 passed,本次重跑 → **359 passed**(比文档多 4 项,属本轮新增用例)。 - **CI 不覆盖本 PR 任何测试**:[.gitea/workflows/ci.yml:33–41](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/8b5509d64f15331167f637a71158457764ddd71f/.gitea/workflows/ci.yml#L33) 只跑 5 个 dsh 测试和 3 个 packaging 文件,`tests/trial_task_center`、`tests/v1_1`、`tests/ui` 都不在其中。建议至少把本 PR 的专项文件纳入。 - PR 自述"移入最新主线后仅做上述适配检查…未重复跑整套回归"——这一点与 PR19 相同:最终 head 没有完整回归记录,跨模块影响只能靠审查侧复核。 ## 本次独立验证记录 - 数据来源:从 Git 导出的独立快照与工作树 `G:\pr21-head`(head `8b5509d`)、`G:\base21-head`(base `9316cf4`),未修改 PR 源码。 - 静态检查:`python -m compileall -q src packaging tools` 退出 0;`git diff --check basemain21 pr21` 退出 0。 - 行为对照(base vs head,同一 fixture、同一份 BOM):单工程空路径场景 base `passed=1 preview=True`、head `project_binding` 拒绝;改名任务 + 旧路径场景 head 拒绝;跨文件重复提示行号与来源标注矛盾;模板列与表头样式;`imports` 目录与诊断包白名单。以上均用真实服务与真实 xlsx 复现,未使用模拟 CAD(`inspect` 用 `runtime` 代替品)。 - 未做:真实 DxDesigner 替换(沿用 PR 自述的实测边界)、PCB、安装包构建、真实工单。
abaishu0730 added 1 commit 2026-11-05 12:42:47 +08:00
fix: address PR21 BOM routing and supervision review
Core regression / Python core and release configuration (push) Successful in 19s
Core regression / JavaScript syntax (push) Successful in 4s
Core regression / Python core and release configuration (pull_request) Successful in 17s
Core regression / JavaScript syntax (pull_request) Successful in 3s
94a873f929
Author
Owner

PR #21 增量审查:94a873f(BOM 路由、来源证据与监督边界修复复核)

复查对象:94a873f9294b3de9c8ef1be1937ac4ae1e9ea5e2(base 9316cf4,19 文件 +622/−70),增量基线为我上次审查的 8b5509d。PR #19 无新提交(仍为 775bc23,评论 215/219 的结论继续有效),本评论只覆盖 #21。

结论:建议合并(Approve)。 上次 1 项 P2 + 5 项 P3 与 CI 建议全部修复,我逐项独立复现通过,没有新增功能缺陷。剩余 2 项 P3 都在测试判别力与响应文档计数上,不阻塞合并,但建议顺手改掉(P3-1 只需 1 行断言)。


一、逐项复核(我的独立证据)

上次审查项 本轮实现 我的独立验证
P2 任务显示名与工程文件名不一致时误判 resolve_project 改为:精确路径 → 任务显示名/文件名后缀 → basename,歧义阻断;单工程空路径才保留兜底 改名「音频板」+ 旧模板路径 → passed,match_reason=migrated_task_name;单工程 + 空路径 + 无关显示名 → passed,single_project;旧路径 + 无关名称 → 仍 project_binding(与文档「显式错误路径不能任意兜底」一致)
P3 跨文件重复提示用规范化行号 BomRowResult.duplicate_rows + annotate 用源文件/源行重写原因;UI 显示原始行号 两份文件重复行 → 两行均 failed,原因同时列出「d1.xlsx 第 2 行;d2.xlsx 第 3 行」及各自来源;无预览。作者用例(第 5 行)同向
P3 来源证据无引用、无导出、无限累积 改存锚点任务 quick-run-history/bom-import-<uuid>/source-map.json,报告/任务事件引用,诊断包只放行该 JSON,规范化 Excel 在 finally 删除,纳入保留策略 map 存在、normalized-bom.xlsx 已删;events.jsonl 含该路径;诊断 ZIP 含 3 份映射、不含任何 .xlsx;Users\ 已脱敏为 <USER_HOME>;限 1 份时旧删新留
P3 match_reason 失真 + 非原子写入 7 种原因区分;相对路径在规范化前拒绝;改用共享原子 write_record 各原因断言通过;relative.xlsx:Excel 第 2 行工程路径必须是完整路径;替换失败时旧 JSON 完整、无 .tmp 残留
P3 模板缺 Value 来源列 两个模板入口都导出第 12 列,样式/批注/下拉齐全,旧写入接口仍 11 列 openpyxl 读回 12 个表头、L1 实心填充 + 批注、下拉 L2:L502;空任务模板同样 12 列
P3 两阶段释放租约、读源无进度 读取/路由/校验合并进一个租约(inspect_batch 直接调用),监督入口早于任何本地读,逐文件进度 + READING,子进程上报进度与相位 租约采集次数:旧代码 2 次(preview_bom_sources、inspect_bom_batch)→ 新代码 1 次;真实监督子进程往返 7 passed
CI 建议 安装 python3-openpyxl 并加入两个无 Qt/CAD 依赖用例 94a873f 上 push 与 pull_request 两个 job 均 success(12:43)

关键位置(94a873f 源码行):


二、本轮新发现(2 项 P3,均不阻塞)

P3-1 该回归用例在修复前也通过,防不住它命名的缺陷

tests/trial_task_center/test_bom_import_review.py:170-197(test_single_lease_covers_source_read_and_inspection)。

  • 我把这个文件整体放到旧代码 8b5509d 上跑:13 failed / 1 passed,唯一通过的就是这条租约用例。
  • 原因:上次的缺陷是「两个操作之间租约被释放」,而用例只在 load_sources / inspect_batch 内部采样租约,采样点天然看不到中间的空隙——旧代码同样是「读时持有、校验时持有」,只是中间断了一次。
  • 建议(我已验证可判别):统计 TaskCenterService._idle_quick_run_operation 的采集次数,断言 == ['preview_bom_sources']。实测旧代码得到 ['preview_bom_sources', 'inspect_bom_batch'],新代码得到 ['preview_bom_sources'];或者直接断言 service.inspect_bom_batch 未被调用。这样用例名和注释才与实际保护范围一致。

P3-2 响应文档的计数与提交内容对不上

docs/testing/2026-11-05-pr21-review-fixes.md:23-26。

  • 「原始 9 项全部失败;修复后 9 项全部通过」:提交的 test_bom_import_review.py 现有 13 个测试函数 / 14 个用例,且修复前实测是 13 failed / 1 passed(见 P3-1)。
  • 「6 项监督验证」:tests/v1_1/test_bom_sources_supervision.py 是 4 个函数 / 7 个用例(我实跑 7 passed)。
  • 不涉及功能,但验收文档会被当作后续审查基线;数字与文件不一致会让复核者无法判断覆盖面,建议按最终文件更新,或注明「含后续补充用例」。

三、观察(不阻塞,仅记录)

  • service.py:229 每次导入都会执行 maintain_quick_run_storage,该函数用 rglob 全量统计历史(上限 5GB / 100 条 / 30 天)。它与 batch.py:51、quick_run.py:125 同模式,但导入是只读校验:历史很大时,等待时间会与历史规模绑定。链接/占用条目是「跳过」而非报错——我用 junction 实测导入仍然成功,不会误伤。若日后有人反馈导入变慢,可改为按天/每 N 次执行。
  • 导入来源与执行历史共用 quick-run-history 的保留额度(文档已写明复用),这里只作提醒。

四、验证记录

环境:Windows、Python 3.12.10、PySide6、QT_QPA_PLATFORM=offscreen;在 94a873f 的独立 worktree 上执行。

  • pytest -q tests/trial_task_center tests/v1_1/test_bom_plan.py test_bom_part_number_types.py test_bom_batch.py test_bom_import_report.py test_bom_sources_supervision.py test_project_task_ui.py tests/ui/test_value_options_layout.py → 463 passed(696s)。
  • 上次的 13 文件相邻回归集(bom/plan/target/ui)→ 176 passed(137s)。
  • tests/v1_1/test_bom_sources_supervision.py 单跑 → 7 passed,含真实监督子进程端到端往返。
  • 旧代码对照:新 test_bom_import_review.py 在 8b5509d 上 → 13 failed / 1 passed。
  • 行为探针(本机真实 store + openpyxl):改名任务旧路径 / 单工程空路径 / 旧路径无关名 / 相对路径 / 跨文件重复 / 模板 12 列 / 导入后仅剩 source-map.json / 诊断 ZIP 含映射且脱敏 / 租约采集 1 次,结果见上表。
  • CI:94a873f 的 push 与 pull_request 两个 job 均 success。
  • 未验证:真实 CAD/PCB 替换、Windows 安装包、Linux CI 日志明细(只看状态)、上表之外的长尾回归。

五、结论

建议合并(Approve):上次的 1 项 P2 与 5 项 P3 全部修复且有独立证据,CI 覆盖已补上并在远端通过。剩余 2 项 P3 属于测试判别力与文档计数,建议合并前顺手修改(P3-1 加一行断言即可)。PR #19 无新提交,无需重复审查。

# PR #21 增量审查:`94a873f`(BOM 路由、来源证据与监督边界修复复核) 复查对象:`94a873f9294b3de9c8ef1be1937ac4ae1e9ea5e2`(base `9316cf4`,19 文件 +622/−70),增量基线为我上次审查的 `8b5509d`。PR #19 无新提交(仍为 `775bc23`,评论 215/219 的结论继续有效),本评论只覆盖 #21。 **结论:建议合并(Approve)。** 上次 1 项 P2 + 5 项 P3 与 CI 建议全部修复,我逐项独立复现通过,没有新增功能缺陷。剩余 2 项 P3 都在测试判别力与响应文档计数上,不阻塞合并,但建议顺手改掉(P3-1 只需 1 行断言)。 --- ## 一、逐项复核(我的独立证据) | 上次审查项 | 本轮实现 | 我的独立验证 | | --- | --- | --- | | **P2** 任务显示名与工程文件名不一致时误判 | `resolve_project` 改为:精确路径 → 任务显示名/文件名后缀 → basename,歧义阻断;单工程空路径才保留兜底 | 改名「音频板」+ 旧模板路径 → `passed`,`match_reason=migrated_task_name`;单工程 + 空路径 + 无关显示名 → `passed`,`single_project`;旧路径 + 无关名称 → 仍 `project_binding`(与文档「显式错误路径不能任意兜底」一致) | | **P3** 跨文件重复提示用规范化行号 | `BomRowResult.duplicate_rows` + `annotate` 用源文件/源行重写原因;UI 显示原始行号 | 两份文件重复行 → 两行均 `failed`,原因同时列出「d1.xlsx 第 2 行;d2.xlsx 第 3 行」及各自来源;无预览。作者用例(第 5 行)同向 | | **P3** 来源证据无引用、无导出、无限累积 | 改存锚点任务 `quick-run-history/bom-import-<uuid>/source-map.json`,报告/任务事件引用,诊断包只放行该 JSON,规范化 Excel 在 finally 删除,纳入保留策略 | map 存在、`normalized-bom.xlsx` 已删;`events.jsonl` 含该路径;诊断 ZIP 含 3 份映射、不含任何 `.xlsx`;`Users\` 已脱敏为 `<USER_HOME>`;限 1 份时旧删新留 | | **P3** `match_reason` 失真 + 非原子写入 | 7 种原因区分;相对路径在规范化前拒绝;改用共享原子 `write_record` | 各原因断言通过;`relative.xlsx:Excel 第 2 行工程路径必须是完整路径`;替换失败时旧 JSON 完整、无 `.tmp` 残留 | | **P3** 模板缺 Value 来源列 | 两个模板入口都导出第 12 列,样式/批注/下拉齐全,旧写入接口仍 11 列 | openpyxl 读回 12 个表头、L1 实心填充 + 批注、下拉 `L2:L502`;空任务模板同样 12 列 | | **P3** 两阶段释放租约、读源无进度 | 读取/路由/校验合并进**一个**租约(`inspect_batch` 直接调用),监督入口早于任何本地读,逐文件进度 + READING,子进程上报进度与相位 | 租约采集次数:旧代码 2 次(`preview_bom_sources`、`inspect_bom_batch`)→ 新代码 1 次;真实监督子进程往返 7 passed | | **CI 建议** | 安装 `python3-openpyxl` 并加入两个无 Qt/CAD 依赖用例 | `94a873f` 上 push 与 pull_request 两个 job 均 success(12:43) | 关键位置(`94a873f` 源码行): - [service.py:198-273](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/94a873f9294b3de9c8ef1be1937ac4ae1e9ea5e2/src/dx_productivity/trial_task_center/service.py#L198-L273):单操作、`annotate`、finally 删除规范化 Excel - [workspace_bom.py:127-167](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/94a873f9294b3de9c8ef1be1937ac4ae1e9ea5e2/src/dx_productivity/trial_task_center/workspace_bom.py#L127-L167):路由;[:170-204](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/94a873f9294b3de9c8ef1be1937ac4ae1e9ea5e2/src/dx_productivity/trial_task_center/workspace_bom.py#L170-L204):来源映射与原子写 - [bom_import_report.py:122-128](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/94a873f9294b3de9c8ef1be1937ac4ae1e9ea5e2/src/dx_productivity/trial_task_center/bom_import_report.py#L122-L128):重复行;[:26-28](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/94a873f9294b3de9c8ef1be1937ac4ae1e9ea5e2/src/dx_productivity/trial_task_center/bom_import_report.py#L26-L28) 字段 - [bom_plan.py:50-94](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/94a873f9294b3de9c8ef1be1937ac4ae1e9ea5e2/src/dx_productivity/trial_task_center/bom_plan.py#L50-L94):12 列模板 - [diagnostics_bundle.py:54-56](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/94a873f9294b3de9c8ef1be1937ac4ae1e9ea5e2/src/dx_productivity/trial_task_center/diagnostics_bundle.py#L54-L56)、[retention.py:21](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/94a873f9294b3de9c8ef1be1937ac4ae1e9ea5e2/src/dx_productivity/trial_task_center/retention.py#L21)、[batch_worker.py:159-179](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/94a873f9294b3de9c8ef1be1937ac4ae1e9ea5e2/src/dx_productivity/trial_task_center/batch_worker.py#L159-L179)、[ui/project_plan.py:700-704](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/94a873f9294b3de9c8ef1be1937ac4ae1e9ea5e2/src/dx_productivity/trial_task_center/ui/project_plan.py#L700-L704) --- ## 二、本轮新发现(2 项 P3,均不阻塞) ### P3-1 该回归用例在修复前也通过,防不住它命名的缺陷 [tests/trial_task_center/test_bom_import_review.py:170-197](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/94a873f9294b3de9c8ef1be1937ac4ae1e9ea5e2/tests/trial_task_center/test_bom_import_review.py#L170-L197)(`test_single_lease_covers_source_read_and_inspection`)。 - 我把这个文件整体放到旧代码 `8b5509d` 上跑:**13 failed / 1 passed**,唯一通过的就是这条租约用例。 - 原因:上次的缺陷是「两个操作**之间**租约被释放」,而用例只在 `load_sources` / `inspect_batch` **内部**采样租约,采样点天然看不到中间的空隙——旧代码同样是「读时持有、校验时持有」,只是中间断了一次。 - 建议(我已验证可判别):统计 `TaskCenterService._idle_quick_run_operation` 的采集次数,断言 `== ['preview_bom_sources']`。实测旧代码得到 `['preview_bom_sources', 'inspect_bom_batch']`,新代码得到 `['preview_bom_sources']`;或者直接断言 `service.inspect_bom_batch` 未被调用。这样用例名和注释才与实际保护范围一致。 ### P3-2 响应文档的计数与提交内容对不上 [docs/testing/2026-11-05-pr21-review-fixes.md:23-26](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/94a873f9294b3de9c8ef1be1937ac4ae1e9ea5e2/docs/testing/2026-11-05-pr21-review-fixes.md#L23-L26)。 - 「原始 9 项全部失败;修复后 9 项全部通过」:提交的 `test_bom_import_review.py` 现有 13 个测试函数 / 14 个用例,且修复前实测是 13 failed / 1 passed(见 P3-1)。 - 「6 项监督验证」:`tests/v1_1/test_bom_sources_supervision.py` 是 4 个函数 / 7 个用例(我实跑 7 passed)。 - 不涉及功能,但验收文档会被当作后续审查基线;数字与文件不一致会让复核者无法判断覆盖面,建议按最终文件更新,或注明「含后续补充用例」。 --- ## 三、观察(不阻塞,仅记录) - `service.py:229` 每次导入都会执行 `maintain_quick_run_storage`,该函数用 `rglob` 全量统计历史(上限 5GB / 100 条 / 30 天)。它与 `batch.py:51`、`quick_run.py:125` 同模式,但导入是只读校验:历史很大时,等待时间会与历史规模绑定。链接/占用条目是「跳过」而非报错——我用 junction 实测导入仍然成功,不会误伤。若日后有人反馈导入变慢,可改为按天/每 N 次执行。 - 导入来源与执行历史共用 `quick-run-history` 的保留额度(文档已写明复用),这里只作提醒。 --- ## 四、验证记录 环境:Windows、Python 3.12.10、PySide6、`QT_QPA_PLATFORM=offscreen`;在 `94a873f` 的独立 worktree 上执行。 - `pytest -q tests/trial_task_center tests/v1_1/test_bom_plan.py test_bom_part_number_types.py test_bom_batch.py test_bom_import_report.py test_bom_sources_supervision.py test_project_task_ui.py tests/ui/test_value_options_layout.py` → **463 passed**(696s)。 - 上次的 13 文件相邻回归集(bom/plan/target/ui)→ **176 passed**(137s)。 - `tests/v1_1/test_bom_sources_supervision.py` 单跑 → **7 passed**,含真实监督子进程端到端往返。 - 旧代码对照:新 `test_bom_import_review.py` 在 `8b5509d` 上 → **13 failed / 1 passed**。 - 行为探针(本机真实 store + openpyxl):改名任务旧路径 / 单工程空路径 / 旧路径无关名 / 相对路径 / 跨文件重复 / 模板 12 列 / 导入后仅剩 `source-map.json` / 诊断 ZIP 含映射且脱敏 / 租约采集 1 次,结果见上表。 - CI:`94a873f` 的 push 与 pull_request 两个 job 均 success。 - 未验证:真实 CAD/PCB 替换、Windows 安装包、Linux CI 日志明细(只看状态)、上表之外的长尾回归。 --- ## 五、结论 建议合并(Approve):上次的 1 项 P2 与 5 项 P3 全部修复且有独立证据,CI 覆盖已补上并在远端通过。剩余 2 项 P3 属于测试判别力与文档计数,建议合并前顺手修改(P3-1 加一行断言即可)。PR #19 无新提交,无需重复审查。
abaishu0730 added 1 commit 2026-11-05 14:06:01 +08:00
test: tighten PR21 review regression evidence
Core regression / Python core and release configuration (push) Successful in 21s
Core regression / JavaScript syntax (push) Successful in 2s
Core regression / Python core and release configuration (pull_request) Successful in 18s
Core regression / JavaScript syntax (pull_request) Successful in 2s
37a458e3c3
abaishu0730 merged commit 08ddf4cd6a into main 2026-11-05 14:08:02 +08:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Skyworth_Digital_Hardware/dxdesigner-part-replacement#21