============================================================
  Soar AutoCAD 2026 MCP — V1.1
  一鍵安裝包（客戶版，Claude / Cowork）
  For Autodesk AutoCAD 2026
  By Soar Design (Jimmy Kwok) © 2026
============================================================

【安裝前確認】

1. Windows 10 / 11 64-bit
2. Autodesk AutoCAD 2026 已裝
3. Claude 桌面版或 Cowork 已裝
4. 已向 Soar Design 買咗 license key（SOAR-ACAD-XXXX-XXXX-XXXX）

注意：本版本已內建執行環境，唔需要安裝 Python。

【架構】

獨立 EXE 執行環境，經 pywin32 直接 COM 操控 AutoCAD 2026，無需 .NET plugin。
業務邏輯存喺 Cloudflare，每次啟動 launcher 自動拉新版到記憶體。

【安裝步驟】

1. 解壓 zip 去簡單路徑（建議 D:\Soar\AutoCAD_MCP）
   * 唔好放喺 Program Files（會權限問題）
   * 路徑唔好有中文、空格、括號或特殊字元
2. 雙擊 install.bat — 3 步自動完成：
   - 檢查 launcher.exe 存在
   - 問你攞 license key
   - 試連 Cloudflare server，下載最新 module + 寫 Cowork MCP config
3. 重啟 AutoCAD + Claude / Cowork
4. Prompt 試：「list all layers」

【日常使用】

* 開 AutoCAD 2026 + 任何 .dwg
* 開 Claude / Cowork
* 直接問，例如：
    「list 所有 layer」
    「畫一條 line 由 (0,0) 到 (100,100)」
    「export 當前 view 做 PDF」
    「批量改所有 layer 顏色為 white」

【自動更新】

業務邏輯模組自動 sync from Cloudflare。每次啟動時：
* launcher 會 check Cloudflare 有冇新版本
* 有就自動 download 新 module
* 客戶完全唔使理

【卸載】

雙擊 uninstall.bat 即可。會清除：
* 本地 cache（%LOCALAPPDATA%\SoarAutoCADMCP\）
* 本地 log 檔案
* Cowork / Claude config 入面 soar-autocad MCP entry

【緊急解鎖】

如果 MCP 被鎖定（例如 anomaly 觸發），雙擊 unlock_mcp.bat
清除本地鎖定檔案，然後重啟 MCP。

【疑難解答】

Q: install.bat 話 "Install path contains special characters"？
A: 路徑有括號、!、& 等特殊字元。搬去簡單路徑如 D:\Soar\AutoCAD_MCP

Q: install.bat 話搵唔到 launcher.exe？
A: 確認 launcher.dist 資料夾同 launcher.exe 完整存在。
   如有損毀，請重新下載安裝包。

Q: AutoCAD 開咗但命令冇反應？
A: 確認 AutoCAD 已開 .dwg 文件（唔係 Start tab）。

Q: License invalid？
A: 核對 key 冇打錯（大階、dash 位）。過期請聯絡 Soar。

Q: License 話 "bound to another machine"？
A: 每個 license 綁定一部機。如需轉機，聯絡 Soar 申請 transfer。

Q: 跳出 modal dialog 卡死？
A: 常見彈窗 action 已 blacklist。如撞到新 dialog，按取消，
   向 Soar 報告 action 名同截圖。

【技術支援】

Email: info@soarmcpsoftware.com
Subject: 包含 license key 前 8 位 (e.g. SOAR-ACAD)

============================================================
