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

【安裝前確認】

1. Windows 10/11 64-bit
2. Microsoft PowerPoint 2016 / 2019 / 2021 / 365（任何一版都可以）
3. Claude 桌面版或 Cowork 已安裝
4. 已向 Soar Design 買咗 license key
   格式：SOAR-XXXX-XXXX-XXXX-XXXX
   （Office Bundle license 同 Excel/Word 共用同一個 key）

【安裝步驟】

1. 解壓呢個 zip 去任何文件夾（建議 D:\SoarMCP\PPT）
   * 唔好放喺 Program Files（會權限問題）
   * 路徑唔好有中文或空格
2. 雙擊 install.bat
3. 等佢自動做晒：
   - 檢查 launcher.exe 存在
   - 問你攞 license key
   - 打 registry patch（開啟 PowerPoint VBA 信任，畀 run_vba 可以用）
   - 試連 Cloudflare server
   - 寫 Cowork MCP config
4. 見到「Installation complete」就可以關視窗

【日常使用】

* 打開 PowerPoint（隨便邊一版）並開一個 .pptx
* 打開 Claude / Cowork
* 可以直接問 Claude 用 PowerPoint，例如：
    「加 5 張 slide，每張一個 title」
    「將呢張圖縮細一半再 center」
    「將 slide 3 嘅 bullet 變成 dark blue」
    「export 做 PDF」
    「加 transition fade 落每張 slide」

【更新】

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

只有 launcher 升級先要重裝。

【卸載】

雙擊 uninstall.bat 即可。會：
* 移除 Cowork config 入面 soar-ppt 條 entry
* 註：register 過嘅 AccessVBOM 留住唔郁（係 PowerPoint 設定，影響其他工具）

【疑難解答】

Q: install.bat 話搵唔到 launcher.exe？
A: 確保 launcher.dist\ 文件夾完整解壓，入面有 launcher.exe。

Q: License 話 invalid？
A: 核對 key 冇打錯（大階、dash 位）。有效期過咗請聯絡 Soar。
   注意 Office Bundle 一個 key 解鎖 Excel + Word + PPT 三個 MCP。

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

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

Q: 提示「Print」/「Slide Show」全螢幕跳出嚟？
A: print_presentation / start_slideshow 已被列入黑名單唔會 trigger。
   如果係其他 dialog / 全螢幕模式，請按 ESC 退出，再向 Soar 報告 action 名。

【技術支援】

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

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