diff --git a/docs/research/2026-11-17-pin-metadata-capability.md b/docs/research/2026-11-17-pin-metadata-capability.md new file mode 100644 index 0000000..75f864c --- /dev/null +++ b/docs/research/2026-11-17-pin-metadata-capability.md @@ -0,0 +1,7 @@ +# 引脚字段读取范围 + +FREEFORM / FLAT BLOCKS 原生文本中的 `Pin 名称\tnum 编号\ttype 类型码` 可以与已解析图的实例、位号、物理脚号核对。适配器保留文件 SHA256 和行号,重复或无法绑定的字段不进入已证明清单。类型码按原文展示,不臆造类型语义。 + +自建格式夹具验证了逻辑名和电气类型码。引脚级 Value 尚未在该格式中证明,保持 unknown;器件 Value 不能代替它。确切库版本内部的引脚到焊盘映射尚未支持,保持未覆盖。没有进行客户工程真实字段验收。 + +探针:`python tools/probe_verification_pin_metadata.py <受管导出/netlist.json>`,只读已有输出,不调用 CAD、不修改工程。 diff --git a/src/dx_productivity/trial_task_center/verification/pin_metadata.py b/src/dx_productivity/trial_task_center/verification/pin_metadata.py new file mode 100644 index 0000000..6f539da --- /dev/null +++ b/src/dx_productivity/trial_task_center/verification/pin_metadata.py @@ -0,0 +1,58 @@ +"""Conservative native text adapter. Missing fields remain unknown.""" +from pathlib import Path +import re +from ..native_netlist import _hash, _instance_identity +from ..native_inventory import read_native_text +from .rules import component_key + + +def inspect_footprint_mapping(binding): + return {'state':'unknown','mapping':None,'reason':'未实现确切库版本的内部引脚到焊盘映射读取'} + + +def inspect_pin_metadata(export,*,evidence_root): + result={'pins':[],'uncovered':['引脚级 Value','库内引脚到焊盘映射']} + try: + path=Path(export.get('outputs',{})['effective']).resolve() + if not path.is_relative_to(Path(evidence_root).resolve()):raise ValueError('原始证据越界') + sha=_hash(path);lines=read_native_text(path).splitlines();records=[];record=None + for n,line in enumerate(lines,1): + if line.startswith(' Symbol '): + match=re.fullmatch(r' Symbol (.+?)\tref des ([^\t]*)\tpage ([^\t]*)',line) + record={'uid':match[1],'refdes':match[2],'page':match[3],'paths':[],'pins':[]} if match else None + if record:records.append(record) + elif record is not None: + if line.startswith('\tPath '):record['paths'].append(line[6:]) + elif line.startswith('\tPin '): + fields=line[5:].split('\t');values=dict(v.split(' ',1) for v in fields[1:] if ' ' in v) + record['pins'].append((fields[0],values,n)) + graph=export.get('graph',{}).get('components',{}) + candidates=[] + for record in records: + for scope in record['paths']: + uid=_instance_identity(record['uid'],scope);component=graph.get(uid) + if component is None or component.get('refdes')!=record['refdes']:continue + for name,values,n in record['pins']: + pin=component.get('pins',{}).get(name) + if not pin or not values.get('num') or pin.get('number')!=values['num']:continue + key=component_key(uid,component) + if key is None:continue + candidates.append({'endpoint':[*key,values['num']], + 'logical_name':{'value':name,'confidence':'proven'}, + 'pin_value':{'value':None,'confidence':'unknown'}, + 'electrical_type':{'value':values.get('type'),'confidence':'proven' if 'type' in values else 'unknown'}, + 'raw':{'path':str(path),'sha256':sha,'line':n,'page':record['page'] or None}}) + from collections import Counter + counts=Counter(tuple(p['endpoint']) for p in candidates) + result['pins']=[p for p in candidates if counts[tuple(p['endpoint'])]==1] + if _hash(path)!=sha:raise ValueError('原始证据在读取时变化') + except (OSError,ValueError,KeyError,TypeError) as error: + result.update(pins=[],reason=str(error)) + return result + + +def compare_metadata(before,after): + left={tuple(p['endpoint']):p for p in before['pins']};right={tuple(p['endpoint']):p for p in after['pins']} + return {'comparisons':{str(key):{phase:{name:row[name]['value'] for name in ('pin_value','electrical_type')} + for phase,row in (('before',left[key]),('after',right[key]))} + for key in left.keys()&right.keys()}} diff --git a/src/dx_productivity/trial_task_center/verification/runner.py b/src/dx_productivity/trial_task_center/verification/runner.py index ae6324d..2ffe284 100644 --- a/src/dx_productivity/trial_task_center/verification/runner.py +++ b/src/dx_productivity/trial_task_center/verification/runner.py @@ -46,8 +46,12 @@ def run_attempt(service,attempt_id,*,stop_event): check_cancelled(stop_event) expected=service.artifacts.read(payload['expectation_ref'],'expectations') if payload['expectation_ref'] else None from .rules import evaluate - result=dict(evaluate(left,right,expectations=expected,check_plan=payload['check_plan']), + from .pin_metadata import inspect_pin_metadata,compare_metadata + metadata={phase:inspect_pin_metadata(export,evidence_root=output) for phase,export in (('before',left),('after',right))} + result=dict(evaluate(left,right,expectations=expected,check_plan=payload['check_plan'], + pin_metadata=compare_metadata(metadata['before'],metadata['after'])), before=left,after=right,attempt_state='succeeded',resource_state='released') + result['pin_metadata']=metadata result.update(item_id=attempt['item_id'],input_version=attempt['input_version'],attempt_id=attempt_id, generation=attempt['generation'],input_digest=payload['payload_digest'],policy=payload['check_plan']) ref=service.artifacts.put('result',result) diff --git a/tests/v1_1/test_verification_pin_metadata.py b/tests/v1_1/test_verification_pin_metadata.py new file mode 100644 index 0000000..e7c719c --- /dev/null +++ b/tests/v1_1/test_verification_pin_metadata.py @@ -0,0 +1,20 @@ +from test_native_cli_netlist import graph + + +def test_native_pin_type_has_raw_proof_but_component_value_is_not_pin_value(tmp_path): + from dx_productivity.trial_task_center.verification.pin_metadata import inspect_pin_metadata + g=graph(tmp_path) + result=inspect_pin_metadata({'graph':g,'outputs':{'effective':str(tmp_path/'effective.txt')}},evidence_root=tmp_path) + pin=result['pins'][0] + assert pin['logical_name']['value']=='A' and pin['logical_name']['confidence']=='proven' + assert pin['electrical_type']['value']=='1' + assert pin['pin_value']['value'] is None and pin['pin_value']['confidence']=='unknown' + assert pin['raw']['sha256'] and pin['raw']['line']>0 + + +def test_missing_or_mismatched_raw_does_not_prove_metadata(tmp_path): + from dx_productivity.trial_task_center.verification.pin_metadata import inspect_pin_metadata,inspect_footprint_mapping + g=graph(tmp_path);g['components']['$1I1']['pins']['A']['number']='9' + result=inspect_pin_metadata({'graph':g,'outputs':{'effective':str(tmp_path/'effective.txt')}},evidence_root=tmp_path) + assert not result['pins'] + assert inspect_footprint_mapping({'evidence':None})['mapping'] is None diff --git a/tools/probe_verification_pin_metadata.py b/tools/probe_verification_pin_metadata.py new file mode 100644 index 0000000..4999ac2 --- /dev/null +++ b/tools/probe_verification_pin_metadata.py @@ -0,0 +1,16 @@ +"""Read an existing managed native export; never launch or write CAD.""" +import argparse +import json +from pathlib import Path +from dx_productivity.trial_task_center.verification.pin_metadata import inspect_pin_metadata + + +def main(): + parser=argparse.ArgumentParser();parser.add_argument('export',type=Path) + args=parser.parse_args() + result=inspect_pin_metadata(json.loads(args.export.read_text(encoding='utf-8')),evidence_root=args.export.parent) + print(json.dumps(result,ensure_ascii=False,indent=2)) + return 0 if result['pins'] else 1 + + +if __name__=='__main__':raise SystemExit(main())