SystemLens

ChatGPT가 문제를 해결 중인 Windows PC에 대해 신뢰할 수 있는 가시성을 제공하고, 이후 변경된 사항을 검증하세요.

SystemLens는 Quod가 만든 오픈소스, 읽기 전용 Windows 진단 컴패니언이자 MCP 아키텍처입니다. 제한된 시스템 증거를 수집하고, 안정적인 스키마로 정규화하며, 반복 가능한 진단 → 검사 → 검증 워크플로를 지원합니다.

프로젝트 상태: 0.3.0-showcase는 소스 우선 Showcase/데모 릴리스입니다. 결정적 로컬 데모는 실행 준비가 완료되었으며, 호스팅된 프로덕션 플러그인 서비스는 현재 운영되지 않습니다. SystemLens는 OpenAI가 제작, 지원, 인증 또는 보증하지 않습니다.

SystemLens가 존재하는 이유

일반적인 문제 해결은 추측에 의존합니다: 증상을 설명하고, 제안을 시도하고, 관련 상태가 변경되기를 바라는 것입니다. SystemLens는 이 루프를 증거 우선으로 만듭니다:

1. 제한된 Windows 진단 범주를 검사합니다.

2. 단기 보존되는 정규화된 기준선을 저장합니다.

3. 사용자가 권장 변경을 수행하도록 합니다.

4. 동일한 범주를 다시 검사합니다.

5. 상관관계가 인과관계를 증명한다고 주장하지 않고 결정적 델타를 반환합니다.

대표 픽스처는 낮은 C: 드라이브 여유 공간, 시작 시 활성화된 Discord, 문제 코드가 있는 오래된 디스플레이 드라이버, 반복되는 디스플레이 재설정으로 시작합니다. 이후 상태는 더 많은 여유 공간, 시작 시 비활성화된 Discord, 변경된 드라이버, 더 이상의 디스플레이 재설정 없음으로 구성됩니다.

Related MCP server: Windows Forensics MCP Server

결정적 데모 사용해 보기

데모는 합성 데이터로, 정제되었으며 명확하게 표시됩니다. 실제 픽스처 로더, 스냅샷 저장소 및 비교 로직을 사용하며, 실제 머신, 호스팅 백엔드 또는 OpenAI API에 접촉하지 않습니다.

사전 요구 사항: Node.js 24 및 pnpm 11.

git clone https://github.com/Quod-cmd/SystemLens.git
cd SystemLens
pnpm install --frozen-lockfile
pnpm demo

JSON 결과에는 이전 상태, 생성된 스냅샷, 이후 상태 및 구조화된 검증 증거가 포함됩니다. 예상 검증 포인트는 데모 가이드를 참조하세요.

아키텍처

오픈소스 데모는 결정적 픽스처에서 로컬로 실행됩니다. 더 완전한 아키텍처는 MCP 백엔드가 보안 아웃바운드 장치 채널을 통해 ChatGPT를 Windows 컴패니언에 연결할 수 있는 방법을 보여줍니다. 해당 호스팅 서비스는 이 릴리스에서 의도적으로 운영되지 않습니다.

• 컴패니언 (companion/) — C#/.NET 읽기 전용 수집기, 로컬 정제, 명시적 기능 상태, 향후 페어링 배포를 위한 DPAPI 자격 증명 저장소.

• MCP 서버 (server/) — TypeScript, Express, MCP TypeScript SDK, 엄격한 스키마, OAuth 리소스 서버 경계, 장치 소유권 검사, 스냅샷 및 비교 로직.

• 증거 위젯 (web/) — 제한된 스냅샷 및 비교 증거를 위한 React/Vite MCP UI.

• 픽스처 (tests/fixtures/) — 결정적이고 창작된 진단 시나리오만 포함.

자세한 아키텍처, 도구 계약 및 위협 모델을 읽어보세요.

진단 범주

SystemLens는 다음을 위한 제한된 수집기를 정의합니다:

• Windows, CPU, 메모리, GPU, 가동 시간 및 전원 관리 옵션 개요

• 고정 볼륨 용량, 여유 공간, 파일 시스템 및 사용 가능한 상태 메타데이터

• 프로세스 이름 및 제한된 CPU/메모리 요약 — 명령줄은 절대 포함하지 않음

• 시작 애플리케이션 상태

• 드라이버 버전, 날짜, 상태 및 문제 코드

• 그룹화되고 정제된 크래시 및 허용 목록에 등록된 Windows 이벤트

• 정확하거나 사전 정의된 서비스 상태

• 최소화된 어댑터, 게이트웨이, DNS 및 인터넷 연결 가능 상태

• 일련번호가 없는 연결된 USB 메타데이터

• 제한된 설치 소프트웨어 검색

• 명시적 미지원 상태를 포함한 안전한 OS 보고 온도 가용성

읽기 전용 보안 경계

SystemLens는 증거 평면이지 원격 관리 평면이 아닙니다.

PowerShell 또는 임의의 명령을 실행하거나, 임의의 파일을 읽거나, 브라우저 기록이나 자격 증명을 검사하거나, 키 입력이나 스크린샷을 캡처하거나, 프로세스를 종료하거나, 레지스트리를 편집하거나, 서비스나 네트워킹을 재구성하거나, 소프트웨어를 설치하거나, 드라이버를 업데이트하거나, Windows 설정을 변경할 수 없습니다.

수집은 요청 시 수행됩니다. 결과는 스키마로 검증되고 제한됩니다. 사용자 프로필 경로와 일반적인 비밀 패턴은 로컬에서 정제됩니다. 알 수 없음, 미지원, 액세스 거부 및 시간 초과 상태는 정상으로 보고되지 않고 계속 표시됩니다. 개인정보/데이터 맵을 참조하세요.

전체 프로젝트를 로컬에서 실행

결정적 데모와 TypeScript 테스트는 크로스 플랫폼입니다. 컴패니언 및 실제 머신 수집기 검증에는 Windows와 .NET SDK 10이 필요합니다.

pnpm install --frozen-lockfile
pnpm build
pnpm test
pnpm test:companion
pnpm validate
pnpm scan:public

픽스처 기반 개발 서버를 시작하려면:

$env:APP_ENV = 'development'
$env:DEVICE_GATEWAY_MODE = 'fixture'
$env:FIXTURE_SCENARIO = 'flagship-before'
pnpm dev

로컬 개발 베어러 식별자는 더미 픽스처이며 프로덕션 모드에서 거부됩니다. SystemLens는 MCP를 구현하고 런타임에 OpenAI 모델 API를 호출하지 않으므로 OpenAI API 키가 필요하지 않습니다.

실제 머신 로컬 모드

컴패니언은 고정된 읽기 전용 수집기 허용 목록을 Windows PC에서 직접 실행할 수 있습니다. 이 로컬 수집 경로는 Render, Auth0, 프로덕션 OAuth, 공개 MCP 서버 또는 OpenAI 계정이 필요하지 않습니다. 원격 ChatGPT 통합에는 별도로 운영되는 백엔드와 인증 서비스가 추가로 필요합니다. 이들은 현재 호스팅되는 제품이 아닌 아키텍처 구성 요소입니다.

서명되지 않은 실행 파일을 일반 설치 프로그램으로 배포하지 마십시오. 로컬 평가를 위해 소스에서 빌드하십시오:

dotnet build SystemLens.sln -c Release
dotnet run --project companion/SystemLens.Companion -- collect system_overview

검증

릴리스 게이트는 서버와 위젯을 빌드하고, 백엔드/위젯/컴패니언 테스트를 실행하고, 계약을 검증하고, 결정적 데모를 실행하고, Showcase 필드 제한을 확인하고, 자격 증명을 스캔하고, 추적된 트리와 전체 Git 기록을 감사합니다. 정확한 공개 릴리스 결과는 릴리스 노트에 기록되어 있습니다.

저장소 맵

companion/       Windows companion, collectors, normalization, transport, tests
server/          MCP/backend, fixture gateway, snapshots, demo, tests
web/             evidence widget and sanitized preview
tests/fixtures/  deterministic invented before/after data
assets/          public cover, architecture, and evidence media
docs/            architecture, demo, security, release, and historical launch audits
scripts/         validation, packaging, secret scanning, public-source audit

이전 프로덕션 Plugin Directory 작업은 엔지니어링 기록을 위해 보존되지만, 해당 출시 트랙은 연기되었습니다. 현재 릴리스는 오픈소스 Showcase 에디션으로, 호스팅 백엔드, 소비자용 설치 프로그램 또는 Plugin Directory 가용성을 약속하지 않습니다. 프로젝트 상태 및 연기된 트랙 참고를 참조하세요.

기여 및 보안

의도적으로 좁은 유지 관리 범위는 CONTRIBUTING.md를, 비공개 취약점 신고는 SECURITY.md를 참조하세요. 공개 이슈에 실제 원격 측정 데이터, 자격 증명 또는 개인 시스템 데이터를 첨부하지 마십시오.

Codex로 제작됨

Codex는 아키텍처, Windows 수집기, MCP 계약, 보안 강화, 자동화된 테스트, 증거 위젯, 문서화, 미디어 준비 및 릴리스 감사 전반에 사용되었습니다. 설계 결정과 생성된 작업은 실행 가능한 테스트, 결정적 픽스처, 개인정보 보호 경계 및 읽기 전용 실제 머신 검증에 대해 반복적으로 확인되었습니다.

라이선스

SystemLens는 허용적인 MIT 라이선스로 제공됩니다: 검사 가능한 데모와 재사용 가능한 참조 구현에 적합한 단순한 선택입니다. Copyright © 2026 Quod.