SlidePatch은(는) 무엇을 하나요?
이 스킬과 함께 제공되는 스크립트를 사용하세요. 호스트 에이전트의 작업 디렉토리에 관계없이 이 파일을 기준으로 스크립트 경로를 확인하세요. 호스트는 로컬 명령 실행 및 이미지 보기가 가능해야 합니다. 이 스킬은 DSH 관련 API나 모델 API 키를 사용하지 않습니다.
새로 설치하는 경우 python <skill>/scripts/slidepatch.py doctor를 실행하세요(차트 마이그레이션에는 --charts, 방정식 변환에는 --equations 추가). 이 명령은 응용 프로그램을 열지 않고 종속성 및 Office 등록 상태를 확인합니다. '준비 완료(result ready)' 메시지가 네이티브 확인을 대체하지는 않습니다.
네이티브 방정식 변환
독립형 수식 텍스트, 그림 또는 MathType/OLE 방정식을 네이티브 PowerPoint 방정식으로 변환하는 요청에는 inspect-equations 및 convert-equations를 사용하세요. 계획, 전사 및 확인 계약에 대해서는 references/equations.md를 읽으세요. 이 모드는 Windows/PowerPoint 외에도 Pandoc이 필요합니다. 다른 모드는 Pandoc이 필요하지 않습니다. 데크의 레이아웃, 페이지 수 및 지정되지 않은 개체를 보존하고, 템플릿을 사용하지 않으며, 기존 네이티브 방정식을 다시 변환하지 않습니다. 명시적인 전체 개체 LaTeX는 후보를 생성합니다. 에이전트는 그림과 캐시된 OLE 미리보기를 검토하고 전사하며, OLE를 활성화하거나 MathType 바이너리를 구문 분석하지 않습니다. 명확하지 않은 개체는 그대로 두고 보고합니다. 템플릿 마이그레이션은 현재 수학적 구조 손실을 방지하기 위해 네이티브 방정식을 거부합니다. 방정식 변환을 마이그레이션에 대한 자동 지원으로 취급하지 마십시오.
전체 데크 마이그레이션 및 페이지 매김
전체 프레젠테이션을 마이그레이션하거나 페이지 매김을 허용하는 요청에는 migrate를 사용하는 것이 좋습니다. 적용 범위 계약 및 증거 형식에 대해서는 references/batch.md를 읽으세요.
python <skill>/scripts/slidepatch.py migrate <source.pptx> --template <template.pptx> --output <new-output.pptx> --evidence <fresh-evidence-directory>
엔진은 모든 소스 슬라이드를 순서대로 방문합니다. 표지, 목차, 번호가 매겨진 섹션 및 일반 콘텐츠 페이지를 식별하고, 일치하는 템플릿 페이지 유형을 선호하며, 네이티브 템플릿 배경, 그래픽 및 레이아웃을 재사용합니다. 목차 페이지는 전용 목차 템플릿이 없을 때 콘텐츠 페이지 스타일을 사용할 수 있습니다. plan.json에서 분류 및 대체(fallback)를 검토하십시오. 이는 기하학적/인쇄체 추론이며, 제한 없는 이미지 이해가 아닙니다.
템플릿 글꼴 패밀리, 크기, 두께 및 색상을 보존합니다. 네이티브 텍스트 측정값이 용량을 결정합니다. 가능하면 완전한 그룹을 함께 유지합니다. 동일하게 짧은 전체 그룹 페이지 분할 중에서 텍스트 볼륨의 균형을 맞춥니다. 단일 그룹이 너무 큰 경우 본문 개체, 문단 또는 문장 경계에서 분할하고 정확한 문자 조각을 보존합니다. 크기가 큰 그룹의 연속 페이지는 콘텐츠를 상단에 정렬합니다. 제목, 그룹 머리글 및 바닥글은 명시적 컨텍스트로 반복됩니다. 본문 조각은 소스를 정확히 한 번, 순서대로 재구성해야 합니다. 소스 번호를 다시 작성하거나 목차를 자동으로 다시 매기지 마십시오. 템플릿 인쇄체를 변경하지 않고는 맞출 수 없는 문장이 있으면 전체 작업이 실패합니다.
이 모드는 일반 편집 가능 텍스트, 지원되는 소스 텍스트 자리 표시자 및 명확한 구조의 포함된 그림/네이티브 차트를 지원합니다. 소스 자리 표시자 제한 사항은 references/plan.md에 있습니다. 미디어 페이지의 경우 references/media.md를 읽으세요. 이미지와 해당 자르기는 네이티브로 유지되고, 차트는 포함된 통합 문서를 유지하며, 관련 캡션은 레이아웃 및 페이지 매김 중에 해당 자산과 함께 유지됩니다. 미디어 페이지는 콘텐츠 템플릿을 사용합니다. 텍스트가 아닌 장식, 지원되지 않는 자리 표시자, 그룹, 애니메이션, 외부 링크 및 모호한 구조는 지원되지 않은 상태로 유지됩니다. 어떤 페이지에서든 실패하면 전체 출력 게시가 차단됩니다. 불완전한 데크를 절대 전달하지 마십시오. 생성된 모든 페이지는 다시 열리고, 렌더링되고, 템플릿 글꼴/배경에 대해 검사되고, 별도의 증명(proof) 사본에서 실제로 편집 및 저장됩니다. 출력은 모든 페이지, 텍스트 및 미디어 검사를 통과한 후에만 게시됩니다.
모든 after-N.png, 특히 표지/섹션 제목, 목차 페이지 대체 및 페이지 매김 경계를 검토하십시오. report.json에서 페이지별 검사 및 편집 가능 페이지 목록을 읽으십시오. 확인된 PPTX, 미리보기 및 간단한 소스-출력 페이지 요약을 제공하십시오. 페이지가 분할된 경우 반복된 컨텍스트는 의도된 것임을 명시하십시오. 원본 파일은 변경되지 않습니다.
동일 파일 모드 (계획 v1)
- 입력은 기존
.pptx입니다. 소스와 참조는 해당 파일의 다른 슬라이드이며, 동일한 디자인과 레이아웃을 가지고 있고 숨겨진 마스터 그래픽이 없습니다. - 소스: 일반 도형, 선 및 수평 텍스트 상자. 참조: 이러한 요소에 장식 그림이 추가됨. 선택된 슬라이드 중 어느 쪽에도 그룹, 자리 표시자, 차트, 스마트아트, 애니메이션, 전환, 하이퍼링크 또는 회전된 개체가 없어야 합니다.
- 모든 소스 텍스트 개체는 정확히 하나의 참조 텍스트 개체에 매핑되며, 그 반대도 마찬가지입니다. 소스의 텍스트가 아닌 도형은 교체할 장식으로 명시적으로 식별되어야 합니다. 개체에 의미 있는 시각적 증거가 포함될 수 있는 경우 설명을 위해 중지하십시오.
- 작업은 소스 슬라이드의 로컬 개체를 참조 개체의 네이티브 복사본으로 교체하고 정확한 소스 문자열로 채웁니다. 강조 변경 사항을 포함하여 참조 인쇄체를 채택합니다. 소스의 문자 서식 보존을 보장하지 않습니다.
- 콘텐츠 요약, 페이지 분할, 자동 글꼴 축소 또는 이미지-편집 가능 텍스트 재구성이 없습니다. 선택한 슬라이드가 이러한 제한에 맞지 않으면 관련 없는 도구를 통해 데크를 재구축하는 대신 특정 제한 사항을 설명하십시오.
별도 템플릿 모드 (계획 v2)
별도 PPTX 파일의 소스 슬라이드와 템플릿에 대해 apply-template를 사용하십시오. 이 모드는 템플릿 크기로 새 슬라이드 1개를 생성합니다. 소스 데크를 다시 작성하거나 다른 템플릿 슬라이드를 포함하지 않습니다. 사용자가 소스 데크의 다른 슬라이드를 보존해야 하는 경우 v1을 선택하십시오.
두 파일을 검사하고, 이제 inheritance 아래에 나열된 상속된 레이아웃/마스터 그래픽을 포함하십시오. 실제 미리보기를 보고 슬라이드 2가 적합한 템플릿이라고 가정하지 말고 콘텐츠 페이지를 선택하십시오. 브랜딩과 장식을 보존하십시오. 모든 로컬 템플릿 개체를 유지된 장식 또는 제거된 샘플 콘텐츠로 명시적으로 분류하십시오. 관련 없는 템플릿 사진을 소스 콘텐츠의 증거로 유지하지 마십시오.
소스 텍스트 개체당 하나의 배치(placement)를 만드십시오. 배치는 일반 텍스트를 포함하는 템플릿 도형을 스타일 제공자(donor)로 지정하고 포인트 단위의 경계를 제공합니다. 동일한 제공자가 여러 배치에 사용될 수 있으므로 소스와 템플릿 텍스트 개수는 다를 수 있습니다. 엔진은 템플릿 내에서 네이티브 개체를 복제하여 레이아웃/마스터 및 테마를 보존합니다. 텍스트는 소스에서 직접 가져옵니다. 계획에는 대체 문자열이 포함되지 않습니다. 글꼴 축소 및 콘텐츠 재작성은 지원되지 않습니다.
소스 제한 사항은 v1과 동일하지만, v2는 지원되는 소스 텍스트 자리 표시자도 허용합니다. 빈 안전 텍스트 슬롯은 명시적으로 폐기된 것으로 기록됩니다. 활성 상속된 소스 텍스트는 자동으로 생략되지 않고 거부를 초래합니다. 스타일 제공자는 자리 표시자/그룹이 아닌 일반적인 회전되지 않은 수평 텍스트 도형이어야 합니다. 템플릿 레이아웃/마스터 장식은 상속된 그림 및 사용되지 않은 레이아웃 자리 표시자를 포함하여 네이티브로 유지됩니다. 유지된 로컬 장식에는 텍스트가 없어야 합니다. 계획은 어떤 개체가 제거되었는지 기록합니다. 자동 계획이 이러한 결정을 제안할 수 있으며, 에이전트는 그 의미를 검토합니다.
자동 레이아웃 (별도 템플릿에 권장)
명확한 제목과 본문 텍스트(지원되는 소스 텍스트 자리 표시자 포함)가 있는 텍스트 전용 소스의 경우 먼저 다음을 실행하십시오:
python <skill>/scripts/slidepatch.py plan-template <source.pptx> --template <template.pptx> --source-slide 1 --out <fresh-planning-directory>
이 명령은 수동으로 대상 페이지, 도형 ID 또는 좌표를 제공하지 않고 일반 v2 plan.json을 생성합니다. selection.json은 추론된 소스 역할, 후보 템플릿 페이지, 기하학 기반 장식 결정, 후보 레이아웃, 맞춤 측정 및 거부 이유를 기록합니다. 상태 planned는 계획이 존재함을 의미하며 PPTX가 최종 확인을 통과했음을 의미하지 않습니다.
계획자는 글꼴 계층과 공간적 근접성을 사용하여 제목과 본문을 연결합니다. 도형 이름이나 템플릿 페이지 번호를 사용하지 않습니다. 뚜렷한 상단 제목이 필요하며, 짧은 글꼴의 하단 바닥글을 인식하고, 그룹화된 행/열 또는 머리글이 없는 문단을 지원합니다. 행, 쌓기(stacked), 2열 및 3열 레이아웃을 검색하며, 원본 템플릿 글꼴 크기로 PowerPoint의 네이티브 텍스트 경계를 사용합니다. 텍스트는 자동 줄 바꿈됩니다. 문자열 재작성 또는 글꼴 축소가 발생하지 않습니다. 후보 상자는 서로 또는 유지된 장식과 겹쳐서는 안 됩니다. 전체 페이지 배경 및 사용되지 않은 레이아웃 자리 표시자는 장애물 검사에서 제외됩니다.
selection.json을 읽고, source.png와 선택된 template-N.png를 보고, 역할 연결과 샘플 그림 제거가 합리적인지 확인하십시오. 자동 그림 분류는 이미지 이해가 아닌 기하학 및 근처 캡션을 사용합니다. 보편적인 의미론적 일치를 주장하지 마십시오. 명확한 결과의 경우 생성된 계획과 함께 apply-template로 직접 진행한 다음 렌더링된 출력을 검토하십시오. 사용자는 좌표를 제공하거나 요청에 이미 포함된 일상적인 선택을 승인할 필요가 없습니다.
단일 페이지 계획이 모호한 역할, 불확실한 장식, 지원되지 않는 개체 또는 용량 초과 콘텐츠를 거부하는 경우 기록된 이유를 읽으십시오. 페이지 매김이 승인된 경우 migrate를 사용하십시오. 그렇지 않으면 검토된 명시적 v2 계획을 사용하기 전에 실제 개체를 검사하십시오. 콘텐츠를 자동으로 생략하거나, 글꼴을 축소하거나, 승인된 페이지 범위를 변경하지 마십시오. 그림, 텍스트가 아닌 장식, 혼합/불명확한 계층, 차트 또는 그룹이 있는 소스는 여전히 명시적 또는 지원되지 않는 콘텐츠 워크플로가 필요합니다.
실행
Python 3.10+ 가상 환경에 requirements.txt를 설치하십시오. 모든 명령에 해당 인터프리터를 사용하십시오. 데스크톱 PowerPoint는 로그인된 Windows 세션에서 사용 가능해야 합니다. 먼저 검사하십시오:
python <skill>/scripts/slidepatch.py inspect <source.pptx> --out <fresh-inspection-directory>
inventory.json을 읽고 관련 slide-N.png 미리보기를 모두 보십시오. 실제 개체와 모양을 사용하여 콘텐츠 역할을 일치시키십시오. 순서에서 도형 ID를 추론하거나 메모리에서 보호된 텍스트를 재구성하지 마십시오.
동일 파일 모드의 경우 references/plan.md의 스키마를 사용하여 JSON 계획을 만드십시오. 별도 템플릿의 경우 plan-template을 선호하십시오. 자동 추론이 부적합한 경우 수동 검토된 v2 계획을 사용하십시오. 현재 인벤토리에서 해시와 ID를 복사하십시오. 사용자의 의도된 범위를 보존하십시오. 명확한 승인 요청과 명확한 매핑이 있으면 진행할 수 있습니다. 파일에서 해결할 수 없는 중요한 콘텐츠 모호성이 있는 경우에만 질문하십시오.
python <skill>/scripts/slidepatch.py apply <source.pptx> --plan <plan.json> --output <new-output.pptx> --evidence <fresh-evidence-directory>
별도 템플릿의 경우 템플릿도 검사한 다음 v2 계획을 사용하십시오:
python <skill>/scripts/slidepatch.py inspect <template.pptx> --out <fresh-template-inspection>
python <skill>/scripts/slidepatch.py apply-template <source.pptx> --template <template.pptx> --plan <v2-plan.json> --output <new-output.pptx> --evidence <fresh-evidence-directory>
엔진은 편집된 데크를 준비하고, PowerPoint에서 다시 열고 렌더링하고, 정확한 텍스트 개체와 숫자를 비교하고, 대상이 아닌 슬라이드를 확인하고, 별도의 증명 사본에서 실제 텍스트 편집 및 도형 이동을 테스트합니다. 이러한 검사를 통과한 후에만 출력을 게시합니다. PowerPoint 종료를 호출하거나 관련 없는 프레젠테이션을 닫지 않습니다. 네이티브 복사/붙여넣기는 시스템 클립보드를 사용합니다.
템플릿 모드는 대신 단일 슬라이드 결과, 두 원본 해시, 모든 로컬 소스 문자열, 저장된 네이티브 개체, 그리고 전후에 동일한 렌더링된 장식 레이어를 확인합니다. 기존 장식 번짐(bleed)은 허용되지만 새 콘텐츠는 맞아야 합니다. 클립보드 없이 네이티브 Duplicate를 사용합니다. PPTX에는 여전히 사용되지 않은 템플릿 레이아웃, 마스터 또는 미디어가 포함될 수 있습니다. 이 프로토타입은 숨겨진 패키지 자산을 정리하지 않습니다.
검토 및 전달
report.json을 읽으십시오. 종료 상태와 보고서 모두 성공을 나타내야 합니다. before-<source>.png, before-<reference>.png 및 after-<source>.png를 보십시오. 스타일이 일치하고 클리핑, 의도하지 않은 겹침 또는 잘못된 읽기 순서가 없는지 확인하십시오. 기하학 검사는 시각적 검토를 대체하지 않습니다.
템플릿 모드의 경우 source-before.png, template-before.png, after-1.png 및 template-shell.png, output-shell.png를 보십시오. 템플릿의 시각적 언어에 대해 새 구성을 확인하십시오. 텍스트 문자열 일치만으로는 충분하지 않습니다.
새 PPTX를 미리보기와 함께 전달하고 검사 및 범위에 대한 간결한 요약을 제공하십시오. editability-proof.pptx에는 의도적으로 편집 마커가 포함되어 있으며 증거이지 최종 전달물이 아닙니다. 어떤 검사라도 실패하면 문제를 보고하십시오. 준비(staged) 파일이나 증명 파일을 최종 데크로 절대 제시하지 마십시오. 재시도 시 새 경로를 선택하고 실패 증거를 사용할 수 있도록 유지하십시오.