============================================================
  Soar Excel MCP — V1.0
  一鍵安裝包（客戶版）
  By Soar Design (Jimmy Kwok) © 2026
============================================================

【安裝前確認】

1. Windows 10/11 64-bit
2. Microsoft Excel 2016 / 2019 / 2021 / 365（任何一版都可以）
3. Python 3.10 x64 已安裝並加入 PATH
   下載：https://www.python.org/downloads/release/python-31011/
   裝嗰陣請剔 "Add Python to PATH"
4. Claude 桌面版或 Cowork 已安裝
5. 已向 Soar Design 買咗 license key
   格式：SOAR-XXXX-XXXX-XXXX-XXXX

【安裝步驟】

1. 解壓呢個 zip 去任何文件夾（建議 D:\SoarMCP\Excel）
   * 唔好放喺 Program Files（會權限問題）
   * 路徑唔好有中文或空格
2. 雙擊 install.bat
3. 等佢自動做晒：
   - 檢查 Python 3.10
   - 建 venv 虛擬環境
   - 裝依賴 (pywin32, mcp, openpyxl 等)
   - 問你攞 license key
   - 打 registry patch（開啟 VBA 信任，畀 run_vba 可以用）
   - 試連 Cloudflare server
   - 寫 Cowork MCP config
4. 見到「✅ 安裝完成」就可以關視窗

【日常使用】

* 打開 Excel（隨便邊一版）並開一個 .xlsx
* 打開 Claude / Cowork
* 可以直接問 Claude 用 Excel，例如：
    「將 A1:C10 加總落 D 欄」
    「插入個 chart 由 A1:B5 嘅資料」
    「將工作表 1 export 做 PDF」

【更新】

業務邏輯更新係自動嘅！每次 run_mcp.bat 啟動時：
* launcher 會 check Cloudflare 有冇新版本
* 有就自動 download 新 module
* 客戶唔駛做任何嘢

只有 launcher / requirements 升級先要重裝。

【卸載】

雙擊 uninstall.bat 即可。會刪除：
* 本 folder venv
* Cowork config 入面 soar-excel 條 entry
* %LOCALAPPDATA%\SoarExcelMCP\ 入面 cache
* 註：register 過嘅 AccessVBOM 留住唔郁（係 Excel 設定，影響其他工具）

【疑難解答】

Q: install.bat 話搵唔到 Python？
A: 去 Microsoft Store 或 python.org 裝 Python 3.10，
   裝嗰陣剔 "Add Python to PATH"，重開 cmd 再 run。

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

Q: Claude 收唔到 MCP？
A: 退出 Cowork 完全重開一次。如果仲唔得，見 logs\*.log。

Q: Excel 指令 call 完冇反應？
A: 確認 Excel 已開咗工作簿（唔係 Start 頁）。
   見 logs\launcher.log 對照錯誤。

Q: 提示「請畀名」「拼字檢查」之類嘅 dialog 跳出嚟？
A: spell_check / print_preview 已被列入黑名單唔會 trigger。
   如果係其他 dialog，請按取消，再向 Soar 報告 action 名。

【技術支援】

Email: info@soarmcpsoftware.com
Subject 請包含你嘅 license key 前 8 位（e.g. SOAR-AB12）

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