From d19956fd3325c048357cf4a630a5da6d1e20fb69 Mon Sep 17 00:00:00 2001
From: kasyfur <kasyfur@abyres.net>
Date: Tue, 27 Oct 2026 11:17:44 +0800
Subject: [PATCH] Update README.md

Adding README
---
 README.md | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/README.md b/README.md
index 6de9139..87fc37a 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,40 @@
 # it-support-scripts
 
+Abyres IT support diagnostic scripts. All scripts are **read-only** and make no changes to the device.
+
+## laptop-check.ps1
+
+This script checks a Windows laptop for performance, battery and throttling problems. It takes about 1 minute and includes a 30-second CPU load test.
+
+### How to run
+1. Press **Win + X**, choose **Terminal (Admin)**, then click **Yes**.
+2. Paste and press Enter:
+   ```
+   [Net.ServicePointManager]::SecurityProtocol='Tls12'; irm https://git.abyres.net/kasyfur/it-support-scripts/raw/branch/main/laptop-check.ps1 | iex
+   ```
+3. Run it **twice**: once plugged in and once on battery. Close other apps first.
+4. Email the `laptop-check-<PC>-<time>.txt` files from the Desktop to **support@abyres.net**.
+
+The script also saves `battery-report-<PC>-<time>.html` to the Desktop.
+
+### What it checks
+- Power source, charging status, power mode and CPU cap
+- Battery health (current capacity vs design) and cycle count
+- CPU load, top processes, and interrupt/DPC time
+- 30-second full CPU load test, measuring clock speed under load
+- Firmware throttling events, unexpected shutdowns with cause, and hardware errors (last 14 days)
+- RAM, disk space and disk health
+
+### Reading the result
+Lines marked `[FLAG]` are issues, and they are listed again in the **SUMMARY** at the end.
+
+| Finding | Likely cause |
+|---|---|
+| Load test under ~1,000 MHz | Battery/charger forcing throttling, or overheating |
+| Battery under 60% of design | Battery worn, replace it |
+| Battery draining while plugged in | Charger too weak or faulty |
+| Sudden power loss shutdowns | Battery or adapter |
+| One process with high CPU% | Software issue, not hardware |
+| Power mode = Best power efficiency | Settings → System → Power & battery → change Power mode |
+
+Reference (i3-1315U, TravelMate P214-55): about 2,400 MHz plugged in and about 1,600–1,900 MHz on battery under load is normal.
\ No newline at end of file