Files
dxdesigner-part-replacement/docs/testing/dxdesigner-795-part-replacement-live.md

12 KiB
Raw Permalink Blame History

DxDesigner 7.9.5 现场验收记录

发布级别:仅评估(evaluation-only)。 本清单只接受在可丢弃的真实 DxDesigner 7.9.5 项目副本和站点中央库映射上取得的人工现场证据。自动化、mock、静态检查或文档审阅都不得勾选任何项目。所有条目当前未执行。

批次元数据

  • DxDesigner build:
  • Windows version:
  • Active project identity:
  • Central library identity or fingerprint:
  • Route profile:
  • Probe profile path / SHA-256:
  • Acceptance manifest path / SHA-256:
  • Tester:
  • Date:
  • Run/job directory:
  • Job ID:
  • Runtime manifest v2 path:
  • Evidence root:

每个条目都必须保留其自身的 fixture、mapping、observation(观察到的 API route/value/error)、唯一 evidence path、evidence file SHA-256、status、tester 和 ISO 日期;缺一项即不能勾选。记录错误时包括 API error number、source、description 和操作名。用于 promote-profile 的 acceptance.json 必须逐项对应这些记录,绑定原始 probe profile 字节、精确 version/build、操作员和中央库身份;不得直接编辑运行配置的 live_acceptance。

执行操作循环时,每一轮保留 operator-step JSON、current-part-replacement.json v2、command.json、返回的 status.json/snapshot.json 和相关事件。manifest 必须只有 complete、current_action、current_command_id、current_project_id、format_version、projects 六个字段;非完成状态的三项 current 绑定必须与唯一项目记录和 command 精确一致,完成状态必须为 complete=true 且三项均为 null。

执行前能力探测

本节是方案 A 的现场认证前置条件,必须按阶段顺序执行并保留原始证据。静态类型库、mock 和自动化测试只能帮助定位候选 API,均不构成 DxDesigner 7.9.5 现场认证;当前发布级别仍为 evaluation-only。

阶段 1:只读探针

  1. 在真实 DxDesigner 7.9.5、可识别的测试项目和已映射的中央库上运行 integration/dxdesigner795/PartReplaceProbe.vbs;探针不得写入任何元件、参数、显示属性或连线字段。
  2. 保存探针产生的 components[].parameter_probe 原始输出及其 SHA-256。确认每个替换候选的每个参数均可记录 Name、Value、TextString、参数文字 X/Y、Color、Font、Size、Orientation、Origin、Visible 和 owner。
  3. 对每个候选元件,独立记录探针对 Value、Value1、Part Number 和 Part Label 的查询结果;不得用其中任一字段的推断结果替代实际查询。
  4. 每次查询都记录精确 API route、返回 type、value(或缺失状态)、error number/source/description、证据路径和证据文件 SHA-256。探针失败时记录失败的字段和 route,不得把未验证字段标为可用。

阶段 2:可丢弃副本上的 setter 认证(未来动作)

仅在阶段 1 完成后,才可在完整、可丢弃的项目副本上逐一认证 setter。本阶段是未来的人工现场动作;当前脚本尚未实现这些写入、回读和恢复步骤,不能将阶段 1 输出解释为写入能力已获认证。

  1. 一次只动一个字段。仅对专用测试参数单独认证 Value 的哨兵值写入、独立回读和原值恢复;普通参数的 Value 绝不写入。除该哨兵试验和阶段 3 最终 Part Label 到 Value 的验证外,不允许写值。
  2. 再逐字段认证 SetLocation(X,Y)、Color、Font、Size、Orientation、Origin 和 Visible 的写入、独立回读和原值恢复。对于只读、不可写或类型不匹配的成员,记录实际拒绝结果,不得绕过或猜测。
  3. TextString 当前仅是读取和报告候选,除非实机和规格另行认证,不得作为必写 setter。owner 仅是参数实例归属/关联证据,不得作为 setter 测试或写入目标。
  4. 每个 setter 试验均记录目标对象身份、写前值和 type、写入值和 type、回读值和 type、恢复后值和 type、精确 route、error(如有)、证据路径及 SHA-256。恢复失败即停止该副本上的后续认证并保留该副本供调查。

阶段 3:人工原生替换验收

在已完成阶段 1 和适用阶段 2 认证的完整可丢弃副本上,人工执行 DxDesigner 原生 Replace Part,选择 Library Wins。不自动重连,且不以自定义字段写入替代原生替换。

  1. 替换前快照每个参数的 Name、Value、TextString、文字 X/Y、Color、Font、Size、Orientation、Origin、Visible 和 owner;owner 只用于替换前后参数匹配和防止参数串位,不得写入。
  2. 原生替换后,仅为同名参数恢复阶段 2 已认证可写的显示属性;普通参数的值必须保留新库值,绝不从快照回写旧值。
  3. 独立查询替换后 Part Label 与 Value,验收 Value 精确等于新的 Part Label。同时验证同名参数的显示属性已恢复、普通参数值未被覆盖,以及原有连线、网络和引脚连接均未改变。
  4. 为替换、每次显示属性恢复和每项验收保存精确 route、type、value、error number/source/description、前后快照、证据路径和证据文件 SHA-256。普通参数显示字段继承失败仅记录 parameter_style_inheritance_failed 警告,不触发 Undo,也不单独阻止保存;未认证或不可用的字段必须禁用其自动恢复并显式报告。仅 Part Label/Value 缺失、歧义、不可写或回读不一致,以及硬不变量失败或连线变化,构成 hard failure。

环境、身份与库存

  • 精确 7.9.5 build(exact 7.9.5 build)

    • Fixture: ________
    • Mapping: ________
    • Observed API route/value/error: ________
    • Evidence path: ________
    • Tester: ________
    • Date: ________
  • 活动项目身份(active-project identity)

    • Fixture: ________
    • Mapping: ________
    • Observed API route/value/error: ________
    • Evidence path: ________
    • Tester: ________
    • Date: ________

    现场步骤:分别验证错误活动项目、已完成 manifest、陈旧 project ID、command ID、action 和 command project ID 均在 bridge 调用前被拒绝;初始 open_project 仅允许无活动项目,其他动作要求规范路径精确匹配。

  • 脏项目拒绝(dirty-state rejection)

    • Fixture: ________
    • Mapping: ________
    • Observed API route/value/error: ________
    • Evidence path: ________
    • Tester: ________
    • Date: ________
  • 完整库存(full inventory)

    • Fixture: ________
    • Mapping: ________
    • Observed API route/value/error: ________
    • Evidence path: ________
    • Tester: ________
    • Date: ________
  • 精确组选择(exact group selection)

    • Fixture: ________
    • Mapping: ________
    • Observed API route/value/error: ________
    • Evidence path: ________
    • Tester: ________
    • Date: ________

原生替换路线与目标

  • 原生对话框路线或人工回退(native dialog route or manual fallback)

    • Fixture: ________
    • Mapping: ________
    • Observed API route/value/error: ________
    • Evidence path: ________
    • Tester: ________
    • Date: ________
  • 正确目标(correct target)

    • Fixture: ________
    • Mapping: ________
    • Observed API route/value/error: ________
    • Evidence path: ________
    • Tester: ________
    • Date: ________
  • 错误目标(wrong target)

    • Fixture: ________
    • Mapping: ________
    • Observed API route/value/error: ________
    • Evidence path: ________
    • Tester: ________
    • Date: ________
  • 兼容单单元替换(compatible single-unit)

    • Fixture: ________
    • Mapping: ________
    • Observed API route/value/error: ________
    • Evidence path: ________
    • Tester: ________
    • Date: ________
  • 兼容多单元替换(compatible multi-unit,站点相关时必需)

    • Fixture: ________
    • Mapping: ________
    • Observed API route/value/error: ________
    • Evidence path: ________
    • Tester: ________
    • Date: ________

不变量与拒绝路径

  • 原点不匹配(origin mismatch)

    • Fixture: ________
    • Mapping: ________
    • Observed API route/value/error: ________
    • Evidence path: ________
    • Tester: ________
    • Date: ________
  • 引脚号/数量不匹配(pin-number/count mismatch)

    • Fixture: ________
    • Mapping: ________
    • Observed API route/value/error: ________
    • Evidence path: ________
    • Tester: ________
    • Date: ________
  • 网络改变(changed net)

    • Fixture: ________
    • Mapping: ________
    • Observed API route/value/error: ________
    • Evidence path: ________
    • Tester: ________
    • Date: ________
  • 无关对象保护(unrelated-object protection)

    • Fixture: ________
    • Mapping: ________
    • Observed API route/value/error: ________
    • Evidence path: ________
    • Tester: ________
    • Date: ________
  • 陈旧库存(stale inventory)

    • Fixture: ________
    • Mapping: ________
    • Observed API route/value/error: ________
    • Evidence path: ________
    • Tester: ________
    • Date: ________

恢复、保存与继续

  • 备份/恢复(backup/restore)

    • Fixture: ________
    • Mapping: ________
    • Observed API route/value/error: ________
    • Evidence path: ________
    • Tester: ________
    • Date: ________
  • Undo

    • Fixture: ________
    • Mapping: ________
    • Observed API route/value/error: ________
    • Evidence path: ________
    • Tester: ________
    • Date: ________
  • 关闭且不保存(close without save)

    • Fixture: ________
    • Mapping: ________
    • Observed API route/value/error: ________
    • Evidence path: ________
    • Tester: ________
    • Date: ________
  • 持久化保存验证(persisted-save verification)

    • Fixture: ________
    • Mapping: ________
    • Observed API route/value/error: ________
    • Evidence path: ________
    • Tester: ________
    • Date: ________
  • 多项目恢复继续(multi-project resume)

    • Fixture: ________
    • Mapping: ________
    • Observed API route/value/error: ________
    • Evidence path: ________
    • Tester: ________
    • Date: ________

    现场步骤:在待处理命令处输入 Q,记录 manifest v2 与 command ID;以 -ResumeJob 指向同一绝对作业目录恢复,确认没有新建作业或重读原 Mapping/Projects/Certifications,同一待处理命令 ID 不变,已 verified_saved 项目不重跑,后续命令每次只推进一个项目/动作,最终 manifest 原子变为完成状态。

保存后的外部检查

  • Packager

    • Fixture: ________
    • Mapping: ________
    • Observed API route/value/error: ________
    • Evidence path: ________
    • Tester: ________
    • Date: ________
  • ERC

    • Fixture: ________
    • Mapping: ________
    • Observed API route/value/error: ________
    • Evidence path: ________
    • Tester: ________
    • Date: ________
  • 网表比较(netlist comparison)

    • Fixture: ________
    • Mapping: ________
    • Observed API route/value/error: ________
    • Evidence path: ________
    • Tester: ________
    • Date: ________

结论

所有必需项目均须以真实现场证据逐项勾选;若站点不使用多单元元件,记录该适用性判断及证据,但不要把自动或 mock 证据当作通过。任何未勾选项、未解决阻断项或缺失证据都使发布保持 evaluation-only。