✨ 功能特性

🎯 核心特性

核心功能

• 88 個統一工具 - Word(24)、Excel(25)、PowerPoint(21)、PDF(15)、轉換(2)、Session(1) 已整合
• 按需啟用 - 只啟用需要的文檔類型，減少資源佔用
• 跨平台 - Windows、Linux、macOS (Intel + ARM)，單一可執行檔案
• 開箱即用 - 預編譯版本無需安裝 .NET Runtime
• 完整讀寫 - 支援從A文檔讀取格式應用到B文檔

技術特性

• MCP 2025-11-25 規範支援 - 完全符合最新 MCP 協議規範，自動工具註解（readonly/destructive）基於命名約定，完整的 JSON-RPC 2.0 錯誤處理
• 統一字型設定 - 多個工具支援中英文字型分別設定（fontNameAscii 和 fontNameFarEast 參數）
• 靈活的授權配置 - 支援總授權或單一組件授權，自動搜尋、環境變數或命令列參數配置，試用模式降級（找不到授權時）
• 自動工具發現 - 基於命名約定的自動工具註冊系統
• 安全加固 - 全面的路徑驗證、輸入驗證和錯誤處理

🔒 安全特性

路徑驗證

• 所有檔案路徑都經過 `SecurityHelper.ValidateFilePath()` 驗證
• 防止路徑遍歷攻擊（`../`, `..\`）
• 限制路徑長度（最大260字元）和檔案名稱長度（最大255字元）
• 驗證路徑中的非法字元

輸入驗證

• 陣列大小驗證（`SecurityHelper.ValidateArraySize`，最大1000項）
• 字串長度驗證（`SecurityHelper.ValidateStringLength`，最大10000字元）

錯誤處理

• 錯誤訊息清理，防止資訊洩露
• 移除檔案路徑、堆疊追蹤等敏感資訊
• 生產環境不暴露詳細錯誤資訊

安全限制

📡 MCP 協議支援

MCP 2025-11-25 規範支援

• 符合最新 MCP 協議規範（protocolVersion: 2025-11-25）
• 自動工具註解（readonly/destructive）基於命名約定
• 完整的 JSON-RPC 2.0 錯誤處理

🎨 其他特性

統一字型設定

多個工具支援中英文字型分別設定（`fontNameAscii` 和 `fontNameFarEast` 參數），確保中英文混排文檔的完美顯示。

靈活的授權配置

• 支援總授權或單一組件授權
• 自動搜尋、環境變數或命令列參數配置
• 試用模式降級（找不到授權時）

跨格式轉換

• 啟用任何文檔工具時，自動包含 `convert_to_pdf`（轉換為PDF）
• 啟用兩個或以上文檔工具時，自動包含 `convert_document`（跨格式轉換，如Word轉Excel）