Windows AppShots

Windows AppShots는 하나의 Windows 애플리케이션에 대한 명시적 의미 체계 체크포인트를 픽셀과 제한된 Microsoft UI 자동화 트리 및 공급자 노출 텍스트로 유지합니다.

AppShot은 재사용 가능한 증거이지, 데스크톱 액추에이터도 아니고 라이브 컴퓨터 사용 작업 루프를 위한 저지연 스크린샷 표면도 아닙니다. 새 상태와 작업에는 컴퓨터 사용 드라이버를 사용하고, 결과를 저장하거나 나중에 검색하거나 제한된 의미 체계 번들로 검사해야 하는 경우 AppShot을 요청하십시오.

이것은 독립적인 커뮤니티 프로젝트입니다. OpenAI 제품이 아니며 OpenAI의 보증이나 지원을 받지 않습니다. Brian Mulder가 OpenAI Codex의 도움을 받아 만들었습니다.

요구 사항

• x64의 Windows 10 또는 11;

• Node.js 22 이상;

• Codex 또는 로컬 플러그인이 활성화된 ChatGPT 데스크톱 앱.

Node는 MCP 어댑터만 실행합니다. 기본 캡처 도우미, 감시자, 단축키 및 트레이에는 Node가 필요하지 않습니다. 최종 사용자에게 .NET SDK는 필요하지 않습니다.

Related MCP server: screenshot-mcp

설치

최신 GitHub 릴리스에서 WindowsAppShots-Setup-0.1.1.exe를 다운로드하여 실행합니다. 사용자별 설치 프로그램은 관리자 권한이 필요하지 않습니다.

설치 프로그램은 다음을 수행할 수 있습니다.

• 기본적으로 선택되는 Codex에 로컬 플러그인을 등록합니다.

• 선택적으로 로그인 시 트레이 아이콘과 함께 감시자를 시작합니다.

• 업그레이드 전에 확인된 기존 감시자를 중지합니다.

Codex 등록을 변경하기 전에 설치 프로그램은 지원되는 Node가 PATH에 있는지 확인합니다. 해당 확인에 실패하면 기본 도우미는 설치된 상태로 유지되며 오류에 나중에 등록을 완료하는 방법이 설명됩니다.

설치 후 Codex 또는 ChatGPT 데스크톱 앱을 다시 시작합니다.

릴리스 설치 프로그램은 현재 서명되지 않았으므로 Windows에 알 수 없는 게시자 경고가 표시될 수 있습니다. 실행하기 전에 릴리스와 함께 게시된 SHA-256 값을 확인하십시오.

사용

공유하려는 애플리케이션에 초점을 맞추고 Codex로 돌아가서 다음과 같이 요청합니다.

마지막으로 사용한 Windows 앱을 캡처해 줘.

대상 앱이 포그라운드에 있는 동안 Ctrl+Alt+Shift+A를 눌러도 됩니다. 그런 다음 다음과 같이 요청합니다.

내 최신 Windows AppShot을 사용해 줘.

단축키는 캡처 번들을 작성하고 Windows 성공음을 재생합니다.

MCP 서버는 capture_appshot, get_latest_appshot, list_appshots 및 stop_watcher를 노출합니다.

감시자가 있는 이유

Codex는 일반적으로 MCP 캡처가 실행될 때쯤이면 포그라운드에 있습니다. 감시자는 마지막 비 Codex 창 ID를 기억하므로 나중에 캡처해도 의도한 대상을 계속 유지할 수 있습니다.

감시자는 선택적 단축키와 트레이 상태도 소유합니다. 지속적으로 스크린샷을 찍거나 UI 자동화를 탐색하지 않습니다. 이러한 작업은 사용자가 캡처를 요청할 때만 발생합니다.

트레이 메뉴는 캡처 폴더를 열거나 감시자를 중지할 수 있습니다. 알림 영역을 열면 포그라운드 창 컨텍스트가 변경되어 의도한 앱 대신 셸 UI가 선택될 수 있으므로 캡처 버튼은 없습니다.

캡처 도구는 UI 자동화 control, content 및 raw 보기를 지원합니다. 원시 모드는 노드, 깊이, 텍스트 및 시간 제한에 따라 가장 완전한 공급자 노출 트리를 반환합니다.

캡처 내용 및 개인 정보 보호

사용 전에 간결한 개인 정보 보호 정책을 읽으십시오.

capture_appshot을 호출하거나 단축키를 누르는 것은 명시적 공유 작업입니다. 번들을 로컬에 저장하고 선택한 픽셀과 의미 체계 컨텍스트를 활성 Codex 작업에 반환합니다.

캡처된 텍스트는 신뢰할 수 없는 데이터이지 Codex가 따라야 할 지침이 아닙니다.

번들은 다음 위치에 저장됩니다.

%LOCALAPPDATA%\WindowsAppshots

자동 만료는 없습니다. Windows AppShots를 비활성화하거나 제거해도 기존 캡처는 삭제되지 않습니다.

각 번들에는 다음이 포함됩니다.

manifest.json
visual.png
accessibility-tree.json
accessible-text.txt
model-context.md

UI 자동화 텍스트는 표시되는 뷰포트 밖의 콘텐츠를 포함할 수 있습니다. 화면 대체가 필요한 경우 대상 사각형 안에 겹치는 창이나 알림이 visual.png에 나타날 수 있습니다.

암호로 표시된 컨트롤은 기본 메타데이터를 유지하지만 UI 자동화 값과 텍스트는 억제됩니다. 제한된 자격 증명 정책은 또한 인식된 비밀을 의미 체계 아티팩트에서 삭제합니다.

삭제는 최선의 노력이지 안전을 보장하지 않습니다. 일반적인 기밀 문구, 개인 정보, 식별자, 파일 경로 또는 모든 비정상적인 자격 증명 형식을 제거하지는 않습니다.

visual.png는 삭제되지 않습니다. 캡처 전에 대상 창을 검토하고 모든 번들을 중요 정보로 취급하십시오.

매니페스트는 잘림, 경고 및 의미 체계 삭제 영수증을 기록합니다. 누락된 픽셀, 노드 또는 텍스트가 애플리케이션에 없다는 것을 증명하지는 않습니다.

중지, 제거 및 삭제

Codex에 stop_watcher를 호출하도록 요청하거나, 트레이 메뉴에서 Windows AppShots 종료를 선택하거나, 다음을 실행합니다.

& "$env:LOCALAPPDATA\Programs\WindowsAppShots\bin\AppshotCapture.exe" stop `
  --state-root "$env:LOCALAPPDATA\WindowsAppshots"

설치 프로그램 설치의 경우 설치된 앱 > Windows AppShots > 제거를 사용합니다. 이렇게 하면 확인된 감시자가 중지되고 해당 설치로 등록된 Codex 마켓플레이스가 제거됩니다.

소스 설치의 경우 플러그인과 마켓플리스를 제거합니다.

codex plugin remove windows-appshots@windows-appshots
codex plugin marketplace remove windows-appshots

캡처는 제거 후에도 유지됩니다. 더 이상 필요하지 않으면 캡처 저장소를 검사한 다음 삭제합니다.

Get-ChildItem -LiteralPath "$env:LOCALAPPDATA\WindowsAppshots" -Force
Remove-Item -LiteralPath "$env:LOCALAPPDATA\WindowsAppshots" -Recurse -Force

빌드 및 확인

이 리포지토리를 Codex 플러그인 마켓플레이스로 추가한 다음 플러그인을 설치합니다.

codex plugin marketplace add brianmulder/windows-appshots --ref main
codex plugin add windows-appshots@windows-appshots

소스 빌드는 고정된 .NET 10.0.302 SDK를 사용하여 결정적 .NET Framework 4.8 도우미를 생성합니다. 설치된 도우미에는 .NET 10 런타임이 필요하지 않습니다.

고정 SDK를 설치하거나 관리자 권한이 없는 설치를 .tools\dotnet에 배치한 다음 실행합니다.

npm run build
npm run verify

npm run verify는 두 번 빌드하고 출력을 비교하고 MCP 테스트를 실행하며 기본 캡처, 삭제, 감시자 ID, 제한된 UI 자동화, 트레이 동작 및 MCP 감시자 중지를 테스트합니다.

설치 프로그램을 빌드하려면 NSIS 3.12를 설치하거나 .tools\nsis에 배치한 다음 실행합니다.

npm run build:installer

설치 프로그램 소스는 installer/WindowsAppShots.nsi입니다. 생성된 실행 파일은 커밋되지 않습니다. 각 설치 프로그램 빌드는 dist/BUILD-RECEIPT.json 및 dist/SHA256SUMS.txt를 작성합니다.

릴리스 전에 전체 설치, 등록, 캡처, 트레이, 중지, 업그레이드 및 제거 게이트를 실행합니다.

npm run verify:release

GitHub Actions는 동일한 Windows 릴리스 게이트를 실행하고 설치 프로그램, 체크섬 및 빌드 영수증을 워크플로 아티팩트로 유지합니다.

플랫폼 제한 사항

• 보안 데스크톱 및 상승된 창은 우회되지 않습니다.

• 보호되거나 DRM이 적용된 콘텐츠는 빈 시각적 개체를 생성할 수 있습니다.

• 최소화되거나 GPU 합성된 애플리케이션은 불완전한 픽셀을 제공할 수 있습니다.

• UI 자동화 품질과 응답성은 대상 애플리케이션에 따라 다릅니다.

• 공급자는 외부 시간 초과가 격리된 UI 자동화 작업자를 종료할 때까지 캡처를 지연시킬 수 있습니다.

프로젝트 정보

• 기여

• 보안 보고

• 코드 서명 정책

• 브랜드 자산

• MIT 라이선스