审查提交:8b5509d64f15331167f637a71158457764ddd71f(1 个提交),基分支 main:9316cf4fc4f1b378e0df55cf136934ef3d28539d。
head 直接位于 main 顶端,无落后提交;Gitea mergeable=true。改动 29 个文件、+1418/−63。
建议修复后合并(Request changes):1 项 P2、5 项 P3。
总体判断:单项 Value 策略这条链路是完整且自洽的——数据库迁移、任务上下文、执行规则、冻结命令、恢复读取、计划导入导出、UI 下拉与 Esc 取消都有真实测试,我也逐处核对了"inherit 是否在每个解析点都拿到任务默认值"。多文件 BOM 的读入、路由、重复阻塞、规范化与原子保存也成立。问题集中在两处口径不一致与三处证据/提示细节上,都属于小范围可修的。
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
本次让每个位号独立指定 Value 来源,并让迁移过工程目录的 BOM 支持多份 Excel 一次导入。旧路径失效时,仅按唯一、精确匹配的工程名称绑定当前路径;名称歧义或跨文件重复位号会阻止本批保存。
变更
审查修复(94a873f)
已按评论 217 处理 1 项 P2、5 项 P3,并补齐 CI 覆盖:
本轮定向验证:功能与监督 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。原功能验收记录
详细记录:
docs/testing/2026-11-05-item-value-bom-import.mddocs/testing/2026-11-05-item-value-bom-native.mdPR 基于最新 main,仅提交本轮功能和实测修复;原工作区的其他 DSH 改动保留在原处。
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,两个工程场景同源):同名不改成"音频板"(即模板里是
Board.prj)时,同一份文件按名称路由成功。也就是说,本 PR 主打的"旧路径失效时按唯一、精确匹配的工程名称绑定"在任务改名(一个正常的整理动作)后就失效;多工程批次里只要有一个成员改过名,它的所有行都会被整批拒绝。同一段代码还带来一个旧用法回归(同一 fixture 在 base 与 head 上对照):
base 对单工程 BOM 在路径为空时无条件绑定唯一工程;head 要求名称也必须精确命中,于是"复制 BOM 行时清空路径列"这种常见做法从"能用"变成"整批拒绝",而且拒绝发生在规范化阶段,用户拿不到熟悉的逐行报告。
建议:让模板导出的名称与匹配器口径一致——要么名称匹配同时接受任务显示名与
.prj基名,要么模板把.prj基名写进"工程名称"列(显示名放到别处);同时对"范围内只有一个工程"的情况保留无条件绑定,或至少降级为逐行失败报告而不是整批异常。[P3] 跨文件重复位号的提示行号是规范化后的行号,与"来源"标注自相矛盾
位置:bom_import_report.py:118–123、bom_import_report.py:315–319、service.py:222–228。
重复提示用的是规范化文件里的行号。两份文件、第二份真实第 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。但:imports记为outside_allowlist(实测 manifest 里就是这条),所以证据包也不含它;结果是文档承诺的"保留来源文件、原行号、原路径、当前路径和匹配原因"实际不可从任务或诊断包找回,只能在数据目录里碰运气。建议把来源映射挂到导入结果/历史(或随批次命名登记),并决定它进证据包还是定期清理。
[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 导入不读该列,无兼容风险。save_batch事务 + 基线与范围比对、未确认前不改计划,均已验证。write_record把目标路径传入共享占用识别,只对 32/33 与"读句柄占 5"重试 3 次,永久权限错误不重试;VBS 仅对project-session-result.tsv做 20×50ms 有界重试,其余写入一次即抛,不重做 CAD。inherit/preserve/part_label/part_number/custom、Tab 提交、Esc 取消、旧自定义勾选与策略同步、编辑锁定时只读,均有真实控件测试;columnCount随HEADERS增长,批量编辑路径按列分派。测试与流程
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。tests/trial_task_center全目录 355 passed,本次重跑 → 359 passed(比文档多 4 项,属本轮新增用例)。tests/trial_task_center、tests/v1_1、tests/ui都不在其中。建议至少把本 PR 的专项文件纳入。本次独立验证记录
G:\pr21-head(head8b5509d)、G:\base21-head(base9316cf4),未修改 PR 源码。python -m compileall -q src packaging tools退出 0;git diff --check basemain21 pr21退出 0。passed=1 preview=True、headproject_binding拒绝;改名任务 + 旧路径场景 head 拒绝;跨文件重复提示行号与来源标注矛盾;模板列与表头样式;imports目录与诊断包白名单。以上均用真实服务与真实 xlsx 复现,未使用模拟 CAD(inspect用runtime代替品)。PR #21 增量审查:
94a873f(BOM 路由、来源证据与监督边界修复复核)复查对象:
94a873f9294b3de9c8ef1be1937ac4ae1e9ea5e2(base9316cf4,19 文件 +622/−70),增量基线为我上次审查的8b5509d。PR #19 无新提交(仍为775bc23,评论 215/219 的结论继续有效),本评论只覆盖 #21。结论:建议合并(Approve)。 上次 1 项 P2 + 5 项 P3 与 CI 建议全部修复,我逐项独立复现通过,没有新增功能缺陷。剩余 2 项 P3 都在测试判别力与响应文档计数上,不阻塞合并,但建议顺手改掉(P3-1 只需 1 行断言)。
一、逐项复核(我的独立证据)
resolve_project改为:精确路径 → 任务显示名/文件名后缀 → basename,歧义阻断;单工程空路径才保留兜底passed,match_reason=migrated_task_name;单工程 + 空路径 + 无关显示名 →passed,single_project;旧路径 + 无关名称 → 仍project_binding(与文档「显式错误路径不能任意兜底」一致)BomRowResult.duplicate_rows+annotate用源文件/源行重写原因;UI 显示原始行号failed,原因同时列出「d1.xlsx 第 2 行;d2.xlsx 第 3 行」及各自来源;无预览。作者用例(第 5 行)同向quick-run-history/bom-import-<uuid>/source-map.json,报告/任务事件引用,诊断包只放行该 JSON,规范化 Excel 在 finally 删除,纳入保留策略normalized-bom.xlsx已删;events.jsonl含该路径;诊断 ZIP 含 3 份映射、不含任何.xlsx;Users\已脱敏为<USER_HOME>;限 1 份时旧删新留match_reason失真 + 非原子写入write_recordrelative.xlsx:Excel 第 2 行工程路径必须是完整路径;替换失败时旧 JSON 完整、无.tmp残留L2:L502;空任务模板同样 12 列inspect_batch直接调用),监督入口早于任何本地读,逐文件进度 + READING,子进程上报进度与相位preview_bom_sources、inspect_bom_batch)→ 新代码 1 次;真实监督子进程往返 7 passedpython3-openpyxl并加入两个无 Qt/CAD 依赖用例94a873f上 push 与 pull_request 两个 job 均 success(12:43)关键位置(
94a873f源码行):annotate、finally 删除规范化 Excel二、本轮新发现(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。
test_bom_import_review.py现有 13 个测试函数 / 14 个用例,且修复前实测是 13 failed / 1 passed(见 P3-1)。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)。tests/v1_1/test_bom_sources_supervision.py单跑 → 7 passed,含真实监督子进程端到端往返。test_bom_import_review.py在8b5509d上 → 13 failed / 1 passed。source-map.json/ 诊断 ZIP 含映射且脱敏 / 租约采集 1 次,结果见上表。94a873f的 push 与 pull_request 两个 job 均 success。五、结论
建议合并(Approve):上次的 1 项 P2 与 5 项 P3 全部修复且有独立证据,CI 覆盖已补上并在远端通过。剩余 2 项 P3 属于测试判别力与文档计数,建议合并前顺手修改(P3-1 加一行断言即可)。PR #19 无新提交,无需重复审查。