# 구조를 검사하고 전후 결과 비교하기 [색인](/llms.txt) · [브라우저 API](/docs/agents/api.md) · [재료 ID](/docs/agents/materials.md) 먼저 “어느 단계의 어떤 재료가 어느 위치에 있어야 하는가”를 수치로 정합니다. 계산 완료, 단면의 재료, 접촉 면적, 연결성은 서로 다른 증거입니다. 현재 문서와 단계에 묶인 결과를 확인하세요. ## 지원 경로 | 목적 | 일반 웹 UI | 브라우저 API 1.0 | 연결된 MCP | | --- | --- | --- | --- | | 선택 단계 계산 | 타임닷 | `computeTo(id)` | `arpelier_compute_flow`의 `stepId` | | 단면의 재료 확인 | 2D/3D 단면 | `getCrossSection`의 재료 ID 배열 | `arpelier_cross_section`의 문자 지도·층 스택(`stacks`), 작은 단면은 `includeMatrix` | | 제거·추가·주입량 | 공정 인스펙터의 영향 관측 | 지원 단계의 주의·관측 범위; 임의 재료 통계 API는 없음 | `arpelier_compute_flow`의 재료별 전체 부피를 두 단계에서 비교 | | 맞닿음·연결·절연 | Connection 렌즈와 단면 | `inspectStructure`의 interface/connection 검사 (capabilities 확인) | `arpelier_inspect_structure` (같은 요청 계약) | MCP는 실제 연결 서버가 제공할 때만 사용할 수 있습니다. 도구 스키마를 읽고 현재 지원 범위를 확인하세요. MCP 도구는 브라우저와 같은 Flow 1.0 문서를 입력으로 받으며, 매 호출마다 그 문서를 처음부터 다시 계산합니다. ## 실행 예제: 산화막 창이 열린 위치 확인 새 테스트 프로젝트를 연 뒤 앱의 개발자 콘솔에서 실행하는 예제입니다. 현재 작업을 예제 흐름으로 바꾸므로 보존할 프로젝트에서 실행하지 마세요. 계정 저장은 호출하지 않습니다. ```js const A = window.arpelier; if (A?.version !== '1.0') throw new Error('API 1.0 required'); const original = await A.getFlow(); const example = await fetch('/docs/agents/examples/oxide-window.flow.json') .then(response => { if (!response.ok) throw new Error('Example unavailable'); return response.json(); }); const validation = await A.validate(example); if (!validation.valid) throw new Error(JSON.stringify(validation.issues)); await A.setFlow(validation.flow); const observed = []; const sample = (section, x, z) => section.materials[ Math.floor(z / section.spacing.vertical) ][Math.floor(x / section.spacing.horizontal)]; for (const id of ['photo', 'etch']) { await A.computeTo(id, { inspectOutcomeSteps: id === 'etch' ? ['etch'] : [], }); const section = await A.getCrossSection({ axis: 'y', at: 40, dz: 1 }); if (section.computedUpTo !== id) throw new Error('Wrong computed step'); observed.push({ step: id, opening: sample(section, 40, 40), protectedField: sample(section, 5, 40), substrate: sample(section, 40, 10), }); } console.table(observed); const actual = observed.map(row => [row.opening, row.protectedField, row.substrate]); if (JSON.stringify(actual) !== JSON.stringify([[18, 18, 4], [0, 18, 4]])) { throw new Error('Opening, protected field or substrate differs from the fixture'); } // 테스트를 마친 뒤 문서만 원래대로 되돌리려면: // await A.setFlow(original); ``` 이 예제의 실제 격자는 5 nm, 수직 표본 간격은 1 nm입니다. `photo` 뒤에는 두 위치에 SiO2(18)가 있고, `etch` 뒤에는 창 중심만 0으로 바뀌며 바깥 SiO2와 p형 기판(4)은 유지됩니다. 여기서 0은 해당 column의 고체 위 빈 공간입니다. 모든 빈 영역이 1(AIR)로 저장된다고 가정하지 마세요. 2(CAVITY)는 구분해야 합니다. 위 좌표는 이 80 × 80 nm 예제의 형상 경계에서 떨어진 검사점입니다. 다른 레이아웃에 그대로 재사용하지 마세요. 소수 점의 성공이 전체 개구 크기·옆면·모든 연결의 성공을 증명하지는 않습니다. 같은 예제의 `etch` 계산을 마친 상태에서 기판 연결과 남은 산화막의 접촉을 함께 측정할 수 있습니다. ```js if (!A.capabilities?.inspectStructure || typeof A.inspectStructure !== 'function') { throw new Error('Structure inspection is unavailable on this deployment'); } const structure = await A.inspectStructure({ checks: [ { id: 'substrate', type: 'connection', materialIds: [4], connected: true, anchors: [{xNm:5,yNm:5,zNm:10,materialId:4}, {xNm:75,yNm:75,zNm:10,materialId:4}] }, { id: 'oxide-contact', type: 'interface', materialA:4, materialB:18, boundsNm:{x:[0,80],y:[0,80],z:[0,50]}, minAreaNm2:1 }, ] }); if (structure.computedUpTo !== 'etch' || structure.checks.some(check => !check.pass)) { throw new Error(JSON.stringify(structure)); } console.log(structure.projectId, structure.revision, structure.checks); ``` 이는 여섯 방향의 면 접촉에 기반한 형상 검사입니다. `materialIds`는 exact ID 지정으로, 5만 넣으면 p형 4를 포함하지 않습니다. `invalid-anchors`의 `connected`/`separate`는 null이므로 절연 성공으로 해석하지 말고 기대 재료와 좌표를 확인하세요. 접촉 면적은 저항이나 전기적 동작을 나타내지 않습니다. 검사 1–16개·최대 4개 재료 집합·추가 작업 메모리(브라우저 512 MiB, MCP 서버 256 MiB) 등의 [입력·자원 제한](/docs/agents/api.md#연결성과-접촉-면적)이 있으며, 초과 시 원래 해상도를 유지하고 `INSPECTION_TOO_LARGE`로 거부합니다. 작업량은 선택한 재료의 구간 수에 비례하므로, 거부되면 한 검사에 넣는 재료를 줄이세요(예: 라이너와 금속을 따로 검사). 결과는 같은 `projectId`·`computedUpTo`·`revision`의 관측으로 비교하세요. ## 묻는 질문에 맞는 검사 - **막이 남았는가**: 관심 위치의 column 구간이나 영역의 재료 점유율을 확인합니다. 재료 카탈로그에 등록되어 있다는 사실은 실제 부피가 있다는 증거가 아닙니다. - **두 재료가 접촉하는가**: interface의 공유 격자 면적을 확인합니다. 같은 화면 좌표에 보이거나 경계점 하나가 겹친다는 사실로 면 접촉을 확정하지 않습니다. - **두 지점이 연결되는가**: connection의 각 anchor에서 실제 재료와 node ID가 유효한지 먼저 확인합니다. anchor가 공기나 다른 재료에 놓인 `invalid-anchors`는 절연 성공도 단락도 아닙니다. - **최종 구조에서도 유지되는가**: 중간 단계와 최종 단계를 각각 검사합니다. 후속 식각·증착·CMP가 앞 단계의 접촉·절연을 바꿀 수 있습니다. 연속 식각에서 원인을 찾을 때는 의심 공정의 **직전·직후·후속 식각 뒤**를 같은 좌표·격자·관측 범위로 비교해 최초로 재료 구간이 바뀌는 단계를 찾으세요. 넓은 필드와 좁은 옆면·틈 근처를 따로 검사합니다. 문서가 바뀌면 새 리비전에 맞춰 다시 측정해야 합니다. 선택 식각이 제외 재료를 그대로 남겨도, 옆의 막을 제거해 후속 습식 식각의 접근 통로를 열 수 있습니다. 이때 좁은 형상의 상단이 명목 식각량보다 크게 낮아졌다는 사실만으로 앞 단계가 그 재료를 함께 식각했거나 막 전체를 그만큼 제거했다고 결론 내리지 마세요. 각 column의 재료 구간과 관측 영역의 재료량을 전후 비교하세요. 브라우저 API에 없는 전체 재료 부피를 추정값으로 꾸미지 말고, 지원되는 단면이나 MCP 계산 결과의 측정 범위와 한계를 함께 기록합니다. MCP 도구 결과는 그 호출에 보낸 Flow 문서의 관측입니다. 문서를 고친 뒤에는 다시 계산하고, 이전 문서의 결과를 새 문서의 증거로 붙이지 마세요. 브라우저의 `warningCoverage`는 지원되는 authored 공정별 선택 반복 회차의 관측 범위입니다. 전체 재료 통계나 모든 반복 회차의 완전한 검사가 아닙니다. [계산 한계](/docs/agents/performance.md)를 함께 확인하세요. ## 저장소에서 재현하기 저장소 루트에서 설치된 Node.js와 프로젝트 의존성으로 실행합니다. 외부 계정 쓰기는 하지 않습니다. ```powershell node dev/src/features/automation/__tests__/flow-document.verify.mjs node dev/src/features/automation/__tests__/automation-api.verify.mjs node --test --test-name-pattern="new source-planned seed|same source-linked checks|absent connection anchor" dev/apps/chatgpt/tests/research-workflow.verify.mjs ``` 마지막 비교는 실제 GridEngine에서 잘못된 마스크 극성의 검사 실패, 최소 수정 뒤 성공, 잘못 놓인 anchor의 거부를 검증합니다. 이 검사는 최종 GPU 화면이나 물리 소자의 성능 검증을 대신하지 않습니다. 근거: `CrossSection.js`, `ArpelierAutomation.js`, `inspectionContract.js`, `inspectProject.js`, `research-workflow.verify.mjs`.