# 自動按鍵精靈 - 安裝說明

## 系統需求
- Windows 7 或更新版本（64-bit）
- 不需要安裝 Python（已打包成 exe）
- 管理員權限（安裝 Interception 驅動時需要）

## 重要說明：按鍵模擬模式

本程式支援兩種按鍵模擬方式：

### 🖱️ 軟體模擬（SendInput API）
- 無需安裝驅動即可使用
- 部分遊戲可能會偵測到按鍵是程式發送的

### ⌨️ 硬體模擬（Interception 驅動）
- **必須安裝 Interception 驅動**
- 驅動級（kernel-level）按鍵模擬，最難被偵測
- 真正的硬體級按鍵輸出，適用所有 Windows 鍵盤
- 幾乎不會被遊戲偵測

**建議：若要獲得最佳效果，請安裝 Interception 驅動。**

## 安裝步驟

### 1. 基本安裝
1. 將整個「安裝程式」資料夾複製到您想要的位置
2. 雙擊執行「自動按鍵精靈.exe」即可開始使用

### 2. 安裝 Interception 驅動程式（強烈建議）

**若要使用硬體級按鍵模擬，必須安裝此驅動。**

驅動特點：
- ✅ 適用於所有 Windows 鍵盤（不限品牌）
- ✅ 驅動級（kernel-level）按鍵模擬，幾乎無法被偵測
- ✅ 真正的硬體級按鍵輸出
- ⚠️ 需要關閉 Windows 記憶體完整性功能

**詳細安裝步驟請參閱：「驅動安裝指南.txt」**

**資料夾結構**：
```
安裝程式/
├── 自動按鍵精靈.exe (64-bit)
├── Interception/
│   ├── command line installer/
│   │   └── install-interception.exe  ← 驅動安裝程式
│   └── library/
│       └── x64/
│           └── interception.dll  ← 64-bit 驅動 DLL
├── config.json
├── 安裝說明.txt
└── 驅動安裝指南.txt  ← 詳細安裝步驟
```

### 3. 設定檔說明
程式支援多個設定檔：
- `config.json` - 預設設定檔
- `config_profile1.json` - 設定檔 1
- `config_profile2.json` - 設定檔 2  
- `config_profile3.json` - 設定檔 3

您可以在 GUI 中切換不同的設定檔。

## 使用說明

### 啟動程式
1. 雙擊執行「自動按鍵精靈.exe」
2. **重要：請確保遊戲以「視窗模式」運行，不要使用全螢幕**
   - 大多數遊戲的視窗模式設定位置：設定 → 環境設定 → 視窗顯示（或類似選項）
3. 程式會自動偵測血魔條位置
4. 在 GUI 介面中設定您的規則
5. 選擇啟動模式開始使用

### 啟動模式
- **👀 僅顯示數值** - 只偵測並顯示 HP/MP，不執行任何按鍵
- **⏰ 僅定時執行** - 只執行定時器規則
- **🧪 僅自動喝水** - 只執行 HP/MP 規則
- **🚀 完整功能** - 執行所有規則

## 疑難排解

### 程式無法啟動
- 確認 Windows Defender 或防毒軟體沒有阻擋程式
- 嘗試以管理員身份執行
- 將程式加入防毒軟體白名單

### 按鍵無效或不穩定
**先嘗試這些方法：**
1. **確認遊戲使用視窗模式（非全螢幕）** - 程式偵測效果最佳
   - 進入設定 → 環境設定 → 視窗顯示（或類似選項）
   - 切換為「視窗模式」而非「全螢幕」
2. 確認遊戲視窗在前景（最上層）
3. 檢查快捷鍵設定是否正確
4. 重新啟動程式

**如果還是無效：**
- 考慮安裝 Interception 驅動（參考「驅動安裝指南.txt」）
- 程式會自動嘗試多種按鍵模擬方式

### 無法偵測血魔條
- 確認遊戲已經啟動並在畫面中
- 確認遊戲視窗不是最小化
- 嘗試點選「重新偵測血魔條」
- 檢查遊戲解析度和縮放設定

### 程式啟動時顯示「無法載入 Interception」
- 表示您尚未安裝 Interception 驅動
- 程式會自動切換為 SendInput API（軟體模擬）
- **建議安裝驅動以使用硬體級按鍵模擬**，詳見「驅動安裝指南.txt」

### Interception 驅動安裝失敗或無法使用
**常見問題及解決方法：**

**1. Windows 記憶體完整性功能干擾（最常見）**
- 症狀：驅動安裝後程式仍顯示「無法載入 Interception」
- 解決方法：
  1. 開啟「Windows 安全性」（搜尋「Windows 安全性」）
  2. 點選左側「裝置安全性」
  3. 點選「核心隔離詳細資料」
  4. 將「記憶體完整性」切換為「關閉」
  5. **重新啟動電腦**
  6. **重新以系統管理員身份執行「install-interception.exe」安裝驅動**
     - 右鍵點選「安裝程式\Interception\command line installer\install-interception.exe」
     - 選擇「以管理員身份執行」
  7. **再次重新啟動電腦**

**2. 驅動安裝程式無法以管理員身份執行**
- 右鍵點選「install-interception.exe」
- 選擇「以管理員身份執行」

**3. 若以上方法都無法解決**
- 程式會自動降級使用 SendInput API（軟體模擬）
- 按鍵仍然可以使用，只是相比驅動模式容易被遊戲偵測

## 授權資訊
本程式僅供學習和個人使用。

## 版本資訊
v1.0.0 - OCR 數字識別 + Interception 驅動支援

## 技術支援
遇到問題請參考：
1. 本安裝說明
2. 驅動安裝指南.txt（驅動相關問題）
3. GUI 中的操作提示

---
最後更新：2026年2月26日
