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

【安裝前確認】

1. Windows 10 / 11 64-bit
2. CSI SAFE V23 已裝（V25 / V26 暫時未測試，建議升 V23）
3. Claude 桌面版或 Cowork 已裝
4. 已向 Soar Design 買咗 license key（SOAR-SAFE-XXXX-XXXX-XXXX）
   （SAFE 同 ETABS / Office 係獨立 license，唔共用）

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

【架構】

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

【安裝步驟】

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

【日常使用】

* 開 CSI SAFE V23 + 任何 .fdb model（或新建空模型）
* 開 Claude / Cowork
* 直接問，例如：
    「list 所有 frame sections」
    「加 W14X22 鋼柱 section」
    「定義 modal analysis case」
    「Run analysis」
    「show period of mode 1」
    「export reactions 做 Excel」

【自動更新】

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

【卸載】

雙擊 uninstall.bat 即可。會清除：
* 本地 log 檔案
* 本地鎖定檔案
* Cowork / Claude config 入面 soar-safe MCP entry

【緊急解鎖】

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

【疑難解答】

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

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

Q: SAFE 開咗但命令冇反應？
A: 確認 SAFE 已啟動（SAFE.exe 喺 task manager 見得到），
   而且至少打開過一個 model（或者新建一個空 model）。

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-SAFE)

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