From 584c418f73504838490b223b4d0f7160b1e590f2 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 27 Jul 2026 23:08:30 +0000 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20README=20=E7=82=BA?= =?UTF-8?q?=E5=B0=8D=E5=A4=96=E4=BD=BF=E7=94=A8=E8=AA=AA=E6=98=8E=E6=96=87?= =?UTF-8?q?=E4=BB=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 改寫為以使用者為導向的繁體中文說明，補上使用步驟、顏色說明、 隱私說明與常見問題，並移除僅供內部開發使用的驗證流程細節。 Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_01Kfnn2NcCf3dguTWS1zSNnF --- README.md | 63 +++++++++++++++++++++++++++++++++++++++---------------- 1 file changed, 45 insertions(+), 18 deletions(-) diff --git a/README.md b/README.md index fd0da51..f797912 100644 --- a/README.md +++ b/README.md @@ -1,43 +1,70 @@ # Keyboard Monitor -Windows 鍵盤與滑鼠診斷工具，可即時顯示實體按鍵狀態、卡鍵、按壓持續時間、每秒按鍵數、打字速度，以及滑鼠按鍵與滾輪事件。 +Windows 鍵盤與滑鼠診斷工具。可即時顯示實體按鍵狀態、偵測卡鍵、量測按鍵持續時間與打字速度，並同步記錄滑鼠按鍵與滾輪事件。 + +適合用來檢查新鍵盤是否有失靈或卡住的按鍵、確認全鍵無衝突（同時按下多鍵）的表現，或單純測試自己的打字速度。 ## 功能 -- 支援 100%、80% TKL 與 60% 鍵盤配置。 -- 使用 Windows 全域低階 Hook 偵測鍵盤與滑鼠事件。 -- 區分左右 Shift、Ctrl、Alt，以及主鍵盤／數字鍵盤共用鍵碼。 -- 顯示目前與最高 KPS、WPM、按鍵持續時間及最近 100 筆事件。 -- 按鍵持續超過 2 秒時標示為可能卡鍵。 -- 所有輸入事件只在本機記憶體中用於即時顯示；程式不儲存或傳送輸入內容。 +- **鍵盤配置顯示**：支援 100% 全尺寸、80% TKL 與 60% 緊湊型三種配置，可隨時切換。 +- **即時按鍵狀態**：按下的鍵會亮起，測試過的鍵維持標記，方便逐鍵檢查是否有無反應的按鍵。 +- **卡鍵偵測**：任一按鍵持續按住超過 2 秒即以紅色標示並顯示警告。 +- **精準按鍵辨識**：可區分左右 Shift、Ctrl、Alt，並正確分辨數字鍵盤與方向／導覽鍵（即使 NumLock 關閉）。 +- **速度量測**：顯示 WPM（每分鐘字數）、當前 KPS、最高 KPS 與最近一次按鍵的持續時間。 +- **滑鼠診斷**：偵測左鍵、右鍵、中鍵、側鍵（X1／X2）與滾輪上下捲動。 +- **即時事件日誌**：保留最近的鍵盤與滑鼠事件並附上時間戳記。 + +## 隱私說明 + +所有輸入事件只在本機記憶體中用於即時顯示。程式不會寫入檔案、不會連線網路，也不會儲存或傳送任何輸入內容；關閉視窗後所有紀錄即消失。 ## 系統需求 - Windows 10 或 Windows 11 -- [.NET 8 Desktop Runtime](https://dotnet.microsoft.com/download/dotnet/8.0)，或使用自包含發佈版本 +- [.NET 8 Desktop Runtime](https://dotnet.microsoft.com/download/dotnet/8.0)（若使用自包含發佈版本則不需要） -## 建置與驗證 +## 使用方式 -```powershell -dotnet build .\KeyboardMonitor.csproj -c Release -dotnet run --project .\tests\KeyboardMonitor.Tests\KeyboardMonitor.Tests.csproj -c Release -dotnet format .\KeyboardMonitor.csproj whitespace --verify-no-changes --no-restore -``` +1. 啟動程式後，視窗會自動開始監控整個桌面工作階段的鍵盤與滑鼠事件，不需要保持視窗在最前景。 +2. 從右上角下拉選單切換 100%／80%／60% 鍵盤配置。 +3. 依序按過鍵盤上每個按鍵，觀察是否有按鍵沒有亮起（可能失靈）或持續亮紅（可能卡鍵）。 +4. 在「打字與延遲測試」文字框中輸入文字，即可看到 WPM 與 KPS 數值；按 Esc 可清空該文字框。 +5. 按「清除重設」可清空所有按鍵狀態、統計數值與事件日誌，重新開始測試。 + +### 顏色說明 -回歸執行器不依賴外部測試套件，涵蓋鍵碼解析、修飾鍵、導覽鍵／數字鍵盤、WPM 與 KPS 計算。 +| 顏色 | 意義 | +| --- | --- | +| 亮藍色 | 目前正被按下 | +| 暗青色 | 已測試過（曾經按下） | +| 紅色 | 可能卡鍵（持續按下超過 2 秒） | -## 執行 +## 從原始碼建置與執行 ```powershell +dotnet build .\KeyboardMonitor.csproj -c Release dotnet run --project .\KeyboardMonitor.csproj -c Release ``` -程式會監控目前 Windows 桌面工作階段的全域鍵盤與滑鼠事件。關閉視窗後，程式會立即解除 Hook 並釋放計時器資源。 +### 產生自包含單一執行檔 -## 建立自包含單一執行檔 +不需在目標電腦安裝 .NET Runtime 即可執行： ```powershell dotnet publish .\KeyboardMonitor.csproj -c Release -r win-x64 --self-contained true ` -p:PublishSingleFile=true -p:DebugType=None -p:DebugSymbols=false ` -o .\publish\win-x64 ``` + +輸出的 `KeyboardMonitor.exe` 位於 `publish\win-x64` 資料夾。 + +## 常見問題 + +**啟動時出現 Hook 安裝失敗的訊息？** +程式需要安裝 Windows 全域低階輸入 Hook 才能運作。若有其他軟體佔用或系統政策限制，請嘗試以系統管理員身分執行。 + +**部分按鍵按了沒有反應？** +請先確認該鍵在其他程式中是否可用。某些鍵盤的巨集鍵、多媒體鍵或韌體層處理的按鍵不會產生標準的 Windows 鍵盤事件，因此不會顯示。 + +**程式關不掉或事件持續累積？** +關閉視窗時程式會立即解除鍵盤與滑鼠 Hook 並釋放資源，正常情況下程序會隨即結束。