改進授權流程為自動綁定模式

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

LICENSE_WORKFLOW.md

@@ -6,60 +6,9 @@ KSTools License Manager 是一個為 Revit Plugin 設計的授權管理系統，
 
 ## 授權流程詳細說明
 
-### 1. 用戶端操作 (Revit Plugin)
+### 1. 管理員操作 (後台管理)
 
-#### 1.1 硬體指紋生成
-```csharp
-// HardwareManager.cs 中的實作
-public class HardwareManager
-{
-    public static string GetHardwareId()
-    {
-        var hwInfo = "";
-        
-        // 取得 CPU ProcessorId
-        using (var searcher = new ManagementObjectSearcher("SELECT ProcessorId FROM Win32_Processor"))
-        {
-            foreach (var obj in searcher.Get())
-            {
-                hwInfo += obj["ProcessorId"]?.ToString();
-                break;
-            }
-        }
-        
-        // 取得主機板序號
-        using (var searcher = new ManagementObjectSearcher("SELECT SerialNumber FROM Win32_BaseBoard"))
-        {
-            foreach (var obj in searcher.Get())
-            {
-                hwInfo += obj["SerialNumber"]?.ToString();
-                break;
-            }
-        }
-        
-        // 生成 SHA256 Hash 並取前32位
-        using (var sha256 = SHA256.Create())
-        {
-            var hash = sha256.ComputeHash(Encoding.UTF8.GetBytes(hwInfo));
-            return Convert.ToBase64String(hash).Substring(0, 32);
-        }
-    }
-}
-```
-
-#### 1.2 用戶操作步驟
-1. 開啟 Revit Plugin
-2. 點擊「取得授權」或「授權管理」按鈕
-3. 系統自動生成 32 位硬體指紋
-4. 用戶複製硬體指紋
-5. 聯繫管理員提供：
-   - 用戶名稱
-   - 硬體指紋 (32位字符)
-   - 所需授權期間
-
-### 2. 管理員操作 (後台管理)
-
-#### 2.1 建立新授權
+#### 1.1 建立新授權 (簡化流程)
 1. 登入管理後台
 2. 進入「用戶管理」頁面
 3. 點擊「建立新授權」按鈕
@@ -67,7 +16,6 @@ public class HardwareManager
 
 **必要欄位：**
 - **用戶名稱**: 識別用戶的名稱
-- **硬體指紋**: 用戶提供的32位硬體指紋
 - **有效天數**: 授權有效期限
   - 7天 (試用)
   - 30天
@@ -79,47 +27,104 @@ public class HardwareManager
 - **電子郵件**: 聯繫用途
 - **備註**: 內部記錄使用
 
-#### 2.2 系統驗證
+#### 1.2 系統驗證
 - 用戶名稱不可為空
-- 硬體指紋必須為32位字符
 - 有效天數必須選擇
-- 硬體指紋自動轉為大寫統一格式
+- **無需硬體指紋**: 系統將在首次啟用時自動綁定
 
-#### 2.3 授權生成
+#### 1.3 授權生成
 系統自動生成：
-- 唯一授權碼 (32位字符，顯示為 XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX 格式)
+- 唯一授權碼 (32位字符)
 - 到期時間計算
 - 建立時間記錄
+- **硬體指紋設為 null** (等待首次綁定)
 
-### 3. 授權驗證流程
+### 2. 用戶端操作 (Revit Plugin)
 
-#### 3.1 首次啟用
-1. 用戶在 Revit Plugin 輸入收到的授權碼
+#### 2.1 硬體指紋生成 (自動)
+```csharp
+// HardwareFingerprint.cs 中的實作
+public class HardwareFingerprint
+{
+    public static string GetHardwareId()
+    {
+        var hwInfo = "";
+        
+        // 取得 CPU ProcessorId
+        string cpuId = GetCpuId();
+        if (!string.IsNullOrEmpty(cpuId))
+            hwInfo += cpuId;
+        
+        // 取得主機板序號
+        string motherboardSerial = GetMotherboardSerial();
+        if (!string.IsNullOrEmpty(motherboardSerial))
+            hwInfo += motherboardSerial;
+        
+        // 備選方案：MAC 地址
+        if (string.IsNullOrEmpty(hwInfo))
+            hwInfo = GetMacAddress();
+        
+        // 生成 SHA256 Hash 並取前32位
+        using (var sha256 = SHA256.Create())
+        {
+            var hash = sha256.ComputeHash(Encoding.UTF8.GetBytes(hwInfo + "KSTOOLS_SALT"));
+            string hashString = Convert.ToBase64String(hash);
+            hashString = hashString.Replace("+", "").Replace("/", "").Replace("=", "");
+            return hashString.Substring(0, 32);
+        }
+    }
+}
+```
+
+#### 2.2 用戶操作步驟 (簡化)
+1. 開啟 Revit Plugin
+2. 點擊「授權管理」按鈕
+3. 輸入管理員提供的授權碼
+4. **系統自動生成並綁定硬體指紋**
+5. 立即啟用成功，無需額外操作
+
+### 3. 授權驗證流程 (自動綁定)
+
+#### 3.1 首次啟用 (自動綁定)
+1. 用戶在 Revit Plugin 輸入授權碼
+2. 系統驗證授權碼有效性
+3. **檢查是否為首次啟用** (`activated_at` 為 null)
+4. **自動生成硬體指紋並綁定**
+5. 記錄啟用時間和硬體資訊
+6. 授權狀態變更為「已啟用」
+
+#### 3.2 重複啟用 (驗證綁定)
+1. 用戶再次輸入授權碼
 2. 系統驗證授權碼有效性
-3. 檢查硬體指紋是否匹配
-4. 記錄啟用時間和硬體資訊
-5. 授權狀態變更為「已啟用」
+3. **檢查硬體指紋是否匹配**
+4. 匹配成功 → 啟用成功
+5. 不匹配 → 顯示「此授權已綁定其他設備」
 
-#### 3.2 日常驗證
+#### 3.3 日常驗證 (快取支援)
 1. Plugin 啟動時自動驗證
 2. 檢查授權是否過期
 3. 驗證硬體指紋匹配
-4. 記錄使用時間
-5. 更新��後使用時間
+4. **支援 24 小時離線使用** (快取機制)
+5. 記錄使用時間並更新最後使用時間
 
 ### 4. 授權狀態管理
 
 #### 4.1 授權狀態分類
-- **未啟用**: 已建立但未使用的授權
-- **啟用中**: 正常使用中的授權
+- **未啟用**: 已建立但未首次使用的授權 (`activated_at` 為 null)
+- **啟用中**: 已綁定硬體且正常使用中的授權
 - **已過期**: 超過有效期限的授權
 - **已停用**: 管理員手動停用的授權
 
-#### 4.2 硬體綁定規則
-- 每個授權只能綁定到一台電腦
-- 硬體指紋基於 CPU + 主機板
-- 更換主要硬體將導致授權失效
-- 需要重新申請授權
+#### 4.2 硬體綁定規則 (自動綁定模式)
+- **首次啟用自動綁定**: 輸入授權碼後自動綁定當前硬體
+- **一機一碼**: 每個授權只能在一台設備上使用
+- **硬體指紋基於**: CPU ProcessorId + 主機板序號 + MAC 地址 (備選)
+- **硬體變更影響**: 更換 CPU 或主機板將導致指紋變更，需重新授權
+
+#### 4.3 安全機制
+- **防止授權碼濫用**: 首次綁定後無法在其他設備使用
+- **離線支援**: 24 小時本地快取，網路中斷仍可使用
+- **自動過期**: 系統自動檢查並處理過期授權
 
 ### 5. 系統記錄與監控
 
@@ -139,29 +144,36 @@ public class HardwareManager
 
 ### 6. 安全特性
 
-#### 6.1 硬體綁定安全
-- 基於硬體唯一識別碼
-- SHA256 雜湊加密
-- 32位字符長度
-- 大小寫統一處理
+#### 6.1 硬體綁定安全 (增強版)
+- **多重硬體識別**: CPU ProcessorId + 主機板序號 + MAC 地址備選
+- **SHA256 + Base64 編碼**: 強化加密算法
+- **32位字符長度**: 標準長度確保唯一性
+- **KSTOOLS_SALT**: 專用鹽值增加安全性
 
-#### 6.2 授權保護
-- 授權碼加密儲存
-- 時間戳記驗證
-- IP 地址記錄
-- 異常使用監控
+#### 6.2 授權保護 (自動綁定模式)
+- **首次綁定保護**: 防止授權碼被搶先綁定到錯誤設備
+- **本地加密快取**: Windows Registry 加密儲存
+- **時間戳記驗證**: 防止時間回撥攻擊
+- **IP 地址記錄**: 完整的使用追蹤
+- **24小時離線支援**: 網路中斷時的可用性保障
 
 ## 故障排除
 
-### 常見問題
-1. **硬體指紋不匹配**: 更換了 CPU 或主機板
+### 常見問題 (更新版)
+1. **「此授權已綁定其他設備」**: 
+   - 原因: 授權已在其他設備上首次啟用
+   - 或者: 更換了 CPU 或主機板導致硬體指紋變更
 2. **授權過期**: 超過設定的有效期限
-3. **授權未啟用**: 用戶未正確輸入授權碼
-
-### 解決方案
-1. 重新申請授權 (硬體變更)
-2. 延長授權期限 (過期問題)
-3. 重新發送正確授權碼 (啟用問題)
+3. **網路連接錯誤**: API 服務無法連接
+4. **首次啟用失敗**: 授權碼錯誤或已過期
+
+### 解決方案 (更新版)
+1. **硬體綁定問題**:
+   - 確認是否在正確的設備上啟用
+   - 如需變更設備，請聯繫管理員重新建立授權
+2. **過期問題**: 管理員可延長授權期限
+3. **網路問題**: 檢查網路連接，或等待離線快取生效
+4. **啟用失敗**: 確認授權碼正確性，檢查是否已過期
 
 ## 技術規格
 

README.md

@@ -24,25 +24,24 @@ pinned: false
 
 ### 🎯 核心授權流程
 
-#### 用戶端操作 (Revit Plugin)
-1. **硬體指紋生成** - 系統自動生成 32 位硬體指紋 (CPU + 主機板)
-2. **取得指紋** - 用戶點擊按鈕複製硬體指紋
-3. **聯繫管理員** - 提供用戶名稱和硬體指紋
-
 #### 管理員操作 (Web 後台)
 1. **建立授權** - 填入必要資訊：
    - 用戶名稱 *
-   - 硬體指紋 * (32位字符)
    - 有效天數 * (7天/30天/90天/1年/永久)
    - 電子郵件 (選填)
    - 備註 (選填)
-2. **生成授權碼** - 系統自動產生 32位字符授權碼 (顯示為 XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX)
+2. **生成授權碼** - 系統自動產生 32位字符授權碼
 3. **提供給用戶** - 將授權碼交付給用戶
 
-#### 啟用與驗證
-1. **授權啟用** - 用戶在 Plugin 輸入授權碼首次啟用
-2. **硬體綁定** - 系統驗證硬體指紋匹配並綁定
-3. **日常驗證** - Plugin 每次使用時自動驗證授權有效性
+#### 用戶端操作 (Revit Plugin)
+1. **輸入授權碼** - 用戶在 Plugin 中輸入管理員提供的授權碼
+2. **自動綁定** - 首次啟用時系統自動生成並綁定 32位硬體指紋 (CPU + 主機板)
+3. **即時啟用** - 無需額外操作，立即啟用成功
+
+#### 持續驗證
+1. **自動驗證** - Plugin 每次使用時自動驗證授權有效性
+2. **硬體綁定** - 確保授權只能在綁定的設備上使用
+3. **離線支援** - 支援 24 小時離線使用 (快取機制)
 
 ### 🎨 現代化前端
 - **零框架依賴**: 純 HTML/CSS/JS，載入迅速
@@ -52,10 +51,10 @@ pinned: false
 - **即時更新**: 無需重新載入的 SPA 體驗
 
 ### 🛡️ 安全機制
-- 硬體綁定授權系統
-- JWT Token 認證
-- 加密通訊協議
-- 防止授權濫用
+- **硬體綁定**: 首次啟用自動綁定，防止授權碼被濫用
+- **JWT Token 認證**: 管理後台安全認證
+- **加密通訊**: HTTPS 加密通訊協議
+- **一機一碼**: 每個授權碼只能在一台設備上使用
 
 ### 📊 管理功能
 - 用戶授權管理

app/services/license_service.py

@@ -52,10 +52,10 @@ class LicenseService:
                 "license_code": license_code,
                 "user_name": license_data.user_name,
                 "user_email": license_data.user_email,
-                "hardware_id": license_data.hardware_id,
+                "hardware_id": None,  # 方案B：創建時不綁定硬體，首次啟用時自動綁定
                 "expires_at": expires_at.isoformat(),
                 "is_active": True,
-                "activated_at": datetime.now(timezone.utc).isoformat() if license_data.hardware_id else None
+                "activated_at": None  # 首次啟用時才設定
             }
             
             print(f"🔄 Creating license with data: {license_record}")
@@ -119,8 +119,12 @@ class LicenseService:
                     message="授權已過期"
                 )
             
-            # 檢查硬體綁定
-            if license_data["hardware_id"] and license_data["hardware_id"] != activation.hardware_id:
+            # 檢查硬體綁定狀態 (方案B：首次啟用自動綁定)
+            if license_data["activated_at"] is None:
+                # 首次啟用：允許綁定到當前硬體
+                print(f"🔄 首次啟用授權，綁定硬體ID: {activation.hardware_id}")
+            elif license_data["hardware_id"] != activation.hardware_id:
+                # 已啟用過，但硬體ID不匹配
                 await self._log_usage(license_id, "activate", client_ip, error_message="硬體ID不符")
                 return ActivationResponse(
                     success=False,

frontend/js/components.js

@@ -73,7 +73,7 @@ class Components {
                     </label>
                     <input type="text" id="userName" name="userName" class="form-input" required 
                            placeholder="輸入使用者名稱">
-                    <small class="form-help">此名稱將與硬體ID綁定</small>
+                    <small class="form-help">此名稱將顯示在授權記錄中</small>
                 </div>
                 
                 <div class="form-group">
@@ -86,15 +86,6 @@ class Components {
                     <small class="form-help">選填：用於聯繫和通知</small>
                 </div>
                 
-                <div class="form-group">
-                    <label for="hardwareId" class="form-label">
-                        <i class="fas fa-desktop"></i>
-                        硬體ID *
-                    </label>
-                    <input type="text" id="hardwareId" name="hardwareId" class="form-input" required 
-                           placeholder="從 Revit Plugin 取得的 32 位硬體ID" maxlength="32">
-                    <small class="form-help">用戶從 Revit Plugin 取得的硬體ID (32 位字符)</small>
-                </div>
                 
                 <div class="form-group">
                     <label for="validDays" class="form-label">
@@ -126,9 +117,9 @@ class Components {
                         硬體綁定機制說明
                     </div>
                     <div class="info-content">
-                        <p>• 系統會自動生成32位硬體ID (CPU ProcessorId + 主機板序號)</p>
-                        <p>• 使用者首次啟用時會綁定到特定硬體</p>
-                        <p>• 更換CPU或主機板將導致授權失效，需重新授權</p>
+                        <p>• 使用者首次輸入授權碼時會自動綁定硬體</p>
+                        <p>• 系統會自動生成32位硬體指紋 (CPU ProcessorId + 主機板序號)</p>
+                        <p>• 每個授權碼只能在一台設備上啟用使用</p>
                     </div>
                 </div>
                 
@@ -166,7 +157,6 @@ class Components {
         
         // 驗證必要欄位
         const userName = formData.get('userName')?.trim();
-        const hardwareId = formData.get('hardwareId')?.trim();
         const validDays = formData.get('validDays');
         
         if (!userName) {
@@ -174,16 +164,6 @@ class Components {
             return;
         }
         
-        if (!hardwareId) {
-            Utils.showError('驗證失敗', '請輸入硬體ID');
-            return;
-        }
-        
-        if (hardwareId.length !== 32) {
-            Utils.showError('驗證失敗', '硬體ID必須為 32 位字符');
-            return;
-        }
-        
         if (!validDays) {
             Utils.showError('驗證失敗', '請選擇有效天數');
             return;
@@ -193,7 +173,6 @@ class Components {
             user_name: userName,
             user_email: formData.get('email')?.trim() || null,
             expires_days: parseInt(validDays),
-            hardware_id: hardwareId.toUpperCase(), // 統一轉為大寫
             notes: formData.get('notes')?.trim() || null
         };