Version 0.2.1-beta — security maintenance beta
PC Full Check for Windows is a privacy-first, read-only Windows PowerShell diagnostic aid. It collects selected hardware, Windows, storage, battery, security, update, driver, and reliability evidence, then writes local HTML, JSON, text, and log reports with transparent statuses. The core diagnostic engine does not upload data, install dependencies, or repair the computer.
- Windows 10 or Windows 11;
- Windows PowerShell 5.1 or later;
- Administrator privileges;
- a new or empty output directory.
The core diagnostic script does not auto-elevate. The optional PCFC-Easy-Runner.ps1 convenience launcher can request Administrator privileges through UAC before invoking the same diagnostic engine. Other operating systems and earlier PowerShell versions are unsupported.
Version 0.2.1-beta is privacy-mode only. There is no public or hidden sensitive mode. Core diagnostic processing is local, with no network request, telemetry, analytics, or upload behavior in PC-Full-Check.ps1. The optional Easy Runner uses HTTPS to download a reviewed, pinned source snapshot and verifies executable-file hashes before running downloaded scripts; it does not upload diagnostic reports.
Privacy mode excludes documented direct identifiers and never saves raw localized integrity output. It reduces exposure but does not provide anonymity: reports can still reveal hardware, software, driver, update, device, event, security, and storage information. Review every report before sharing it.
The tool is read-only. Full mode uses DISM /CheckHealth, SFC /verifyonly, and CHKDSK /scan; no repair, restore, fix, dismount, or automatic configuration change is performed.
New to the project? Start with the beginner-friendly START_HERE.md guide. It explains the one-paste launch path, Easy Runner commands, Quick/Standard/Full modes, report locations, privacy, exit codes, and common mistakes.
For the easiest supported launch path, save PCFC-Easy-Runner.ps1 as a .ps1 file and run:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File ".\PCFC-Easy-Runner.ps1"The Easy Runner defaults to Standard mode and requests UAC when needed. For security, this launcher pins the reviewed v0.2.1-beta source snapshot (b8b02fdf667712062be482cd52ccb0068d5393aa) instead of automatically following main. It downloads that exact source snapshot over HTTPS, compares every downloaded PowerShell script and the public file manifest against SHA-256 values embedded in the launcher, rejects unexpected or missing files, then runs repository tests and invokes PC-Full-Check.ps1. This trust policy protects an already trusted local copy of the launcher; downloading a compromised launcher itself is outside this guarantee. Updating the trusted source requires a reviewed launcher update. Diagnostic reports remain local. Use -Mode Quick or -Mode Full only when needed; Standard remains the default.
Open Windows PowerShell as Administrator, change to the extracted project directory, and run one command:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File ".\PC-Full-Check.ps1" -Mode Quick
powershell.exe -NoProfile -ExecutionPolicy Bypass -File ".\PC-Full-Check.ps1" -Mode Standard
powershell.exe -NoProfile -ExecutionPolicy Bypass -File ".\PC-Full-Check.ps1" -Mode FullStandard is the default mode. A custom new output directory can be selected with:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File ".\PC-Full-Check.ps1" -Mode Standard -OutputPath ".\PCFC-Report"For download, extraction, PowerShell, report-review, troubleshooting, and safety instructions, read the complete user guide.
| Capability | Quick | Standard | Full |
|---|---|---|---|
| Total entries | 9 | 21 | 32 |
| Core Windows and hardware checks | Yes | Yes | Yes |
| Battery, update, driver, power, and event checks | Not included | Yes | Yes |
| Read-only DISM, SFC, and CHKDSK checks | Not included | Not included | Yes |
| Privacy-only raw categories | Not included | Not included | 8 Omitted |
The eight Full omissions are EnergyReport, BatteryReport, SleepStudy, SleepDiagnostics, MSInfo32, DxDiag, DeviceRegistration, and LicenseDetails. They have no executing collector, Data, or OutputFile in this release.
A successful run creates:
00_HEALTH_SUMMARY.html— offline visual summary;00_HEALTH_SUMMARY.json— structured complete summary;00_READ_ME.txt— short orientation and safety notice;run.log— controlled progress and status log;checks/<Name>.json— conditional structured data for checks that return Data.
Reports remain local unless the user shares them.
- Passed: the implemented check completed successfully under its documented contract.
- Warning: verified evidence matched an attention rule; this is not a software failure.
- Failed: a collection or output operation failed, timed out, or returned a non-zero native result.
- Unavailable: the required capability or usable evidence was not available.
- Omitted: the check was intentionally not executed for privacy.
Overall assessments are Good, Attention required, Unknown, or Critical. Warning results produce Attention required when no Critical condition exists. Unavailable and Omitted are never treated as Passed. See the report guide for the exact rules.
The dependency-free repository suite performs static, structural, parser, fictional-fixture, manifest, privacy, and documentation checks. It does not run Quick, Standard, Full, or a native diagnostic:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File ".\tests\run-tests.ps1"The runner reports its actual totals at completion; its single Not Executed item is the intentionally separate Windows functional diagnostic.
The published v0.1.0-beta clean-structure baseline was TOTAL=77; PASSED=76; FAILED=0; NOT_EXECUTED=1. The nested assessment suite passed 10/10, the CHKDSK/privacy-progress/trusted-resolver suite passed 26/26, and the 8 maintained PowerShell files in that release parsed with 0 errors. The current repository test runner prints the authoritative totals for the checked revision.
The remediated implementation was functionally tested on one current Windows computer:
- Quick: exit 0; 8 Passed, 1 Warning, 0 Failed;
- Standard: exit 0; 17 Passed, 3 Warning, 0 Failed, 1 Unavailable;
- Full: exit 0; 20 Passed, 3 Warning, 0 Failed, 1 Unavailable, 8 Omitted;
- the isolated shared CHKDSK production path passed with native exit code 0, without raw-output persistence or a repair command.
These results support the current beta on the validated computer. They do not certify physical disk health, predict future reliability, establish universal Windows compatibility, or replace professional diagnosis. Representative Windows version, hardware, firmware, provider, and localization coverage remains incomplete.
- Beginner start guide
- Complete user guide
- Privacy policy
- Security policy
- Contributing guide
- Release notes
- Supported systems
- Report and assessment guide
The original unpublished executable is not part of this repository and is not a supported entry point. PC-Full-Check.ps1 is the only supported diagnostic entry point. PCFC-Easy-Runner.ps1 is an optional convenience launcher that acquires and validates the official source before invoking that diagnostic entry point; it is not a second diagnostic engine. See the source-free legacy integrity record.
- Previous archived release: v0.2.0-beta on Zenodo — this DOI applies ONLY to historical
v0.2.0-beta, not the current maintenance beta. - Current archived release: v0.2.1-beta on Zenodo — cite this DOI for the exact
v0.2.1-betaarchive. - All Zenodo-archived versions: Zenodo concept DOI — resolves to the newest version actually deposited on Zenodo, which may differ from the newest GitHub release.
- GitHub release: v0.2.1-beta (historical v0.2.0-beta).
- Author ORCID: 0009-0001-6071-9418.
For current citation metadata, see CITATION.cff, which records the published v0.2.1-beta version DOI. The project remains MIT-licensed; historical Git tags and Zenodo archives are unaffected.
Created and maintained by Ayman Bounaouj.
See AUTHORS.md and CITATION.cff for attribution and citation metadata. No personal contact address is published.
Released under the MIT License. See LICENSE.
Copyright (c) 2026 Ayman Bounaouj.