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

【安裝前確認】

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

【安裝步驟】

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

【日常使用】

* 打開 Word（隨便邊一版）並開一個 .docx
* 打開 Claude / Cowork
* 可以直接問 Claude 用 Word，例如：
    「將呢段 paragraph 改做 Heading 1」
    「插入一個 3x3 table，第一行做 header」
    「加 page number 落 footer」
    「export 做 PDF」

【更新】

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

只有 launcher 升級先要重裝。

【卸載】

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

【疑難解答】

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: Word 指令 call 完冇反應？
A: 確認 Word 已開咗文件（唔係 Start 頁）。
   見 logs\launcher.log 對照錯誤。

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

【技術支援】

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

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