📋 工具列表

📝 Word 文檔處理 (27 個工具)

檔案操作 (1)

• word_file- 創建、轉換、合併、拆分、從範本創建（LINQ Reporting Engine）（5個操作：create, create_from_template, convert, merge, split）
  create_from_template 語法：<<[ds.Name]>>、<<foreach [item in ds.Items]>>...<</foreach>>

內容編輯 (6)

• word_text- 添加、刪除、替換、搜尋、格式化文字（8個操作：add, delete, replace, search, format, insert_at_position, delete_range, add_with_style）
• word_paragraph- 插入、刪除、編輯段落格式（7個操作：insert, delete, edit, get, get_format, copy_format, merge）
• word_table- 創建、刪除、獲取表格，插入/刪除行列，合併/拆分單元格（16個操作：create, delete, get, insert_row, delete_row, insert_column, delete_column, merge_cells, split_cell, edit_cell_format, move_table, copy_table, get_structure, set_border, set_column_width, set_row_height）
• word_image- 添加、編輯、刪除、替換圖片，提取圖片（6個操作：add, edit, delete, get, replace, extract）
• word_shape- 添加線條、文字框、圖表、形狀管理，支援邊框樣式：solid, dash, dot, dashDot, dashDotDot, roundDot（9個操作：add_line, add_textbox, get_textboxes, edit_textbox_content, set_textbox_border, add_chart, add, get, delete）
• word_list- 添加、編輯、刪除清單項目，重新編號、轉換為清單（8個操作：add_list, add_item, delete_item, edit_item, set_format, get_format, restart_numbering, convert_to_list）

格式設定 (4)

• word_format- 獲取/設定 Run 格式，獲取/添加/清除定位點，設定段落邊框（6個操作：get_run_format, set_run_format, get_tab_stops, add_tab_stop, clear_tab_stops, set_paragraph_border）
• word_style- 獲取、創建、應用樣式，從其他文檔複製樣式（4個操作：get_styles, create_style, apply_style, copy_styles）
• word_page- 設定頁邊距、方向、大小、頁碼、刪除頁面、插入空白頁、添加分頁符（8個操作：set_margins, set_orientation, set_size, set_page_number, set_page_setup, delete_page, insert_blank_page, add_page_break）
• word_header_footer- 設定頁首頁尾文字、圖片、線條、定位點（10個操作：set_header_text, set_footer_text, set_header_image, set_footer_image, set_header_line, set_footer_line, set_header_tabs, set_footer_tabs, set_header_footer, get）

高級功能 (16)

• word_digital_signature- 數位簽章管理（簽署、驗證、移除、列出）（4個操作：sign, verify, remove, list）
• word_content_control- 內容控制項管理（結構化文檔標籤）（5個操作：add, edit, delete, get, set_value）
• word_render- 將文檔頁面渲染為圖片（2個操作：render_page, render_thumbnail）
• word_bookmark- 添加、編輯、刪除、獲取書籤，跳轉到書籤（5個操作：add, edit, delete, get, goto）
• word_hyperlink- 添加、編輯、刪除、獲取超連結（4個操作：add, edit, delete, get）
• word_comment- 添加、刪除、獲取註釋，回覆註釋（4個操作：add, delete, get, reply）
• word_field- 插入、編輯、刪除、更新、獲取欄位（11個操作：insert_field, edit_field, delete_field, update_field, update_all, get_fields, get_field_detail, add_form_field, edit_form_field, delete_form_field, get_form_fields）
• word_note- 添加、編輯、刪除腳註和尾註（8個操作：add_footnote, add_endnote, delete_footnote, delete_endnote, edit_footnote, edit_endnote, get_footnotes, get_endnotes）
• word_reference- 添加目錄、更新目錄、添加索引、添加交叉引用（4個操作：add_table_of_contents, update_table_of_contents, add_index, add_cross_reference）
• word_properties- 獲取、設定文檔屬性（2個操作：get, set）
• word_protection- 保護、解除保護文檔（2個操作：protect, unprotect）
• word_revision- 獲取、接受、拒絕修訂，比較文檔（5個操作：get_revisions, accept_all, reject_all, manage, compare）
• word_section- 插入、刪除、獲取節資訊（3個操作：insert, delete, get）
• word_watermark- 添加文字/圖片水印、移除水印（3個操作：add, add_image, remove）
• word_mail_merge- 郵件合併
• word_content- 獲取內容、詳細內容、統計資訊、文檔資訊（4個操作：get_content, get_content_detailed, get_statistics, get_document_info）

📊 Excel 表格處理 (31 個工具)

檔案操作 (1)

• excel_file_operations- 創建、轉換、合併工作簿、拆分工作簿（4個操作：create, convert, merge, split）

工作表操作 (1)

• excel_sheet- 添加、刪除、獲取、重新命名、移動、複製、隱藏工作表（7個操作：add, delete, get, rename, move, copy, hide）

單元格操作 (2)

• excel_cell- 寫入、編輯、獲取、清空單元格（4個操作：write, edit, get, clear）
• excel_range- 寫入、編輯、獲取、清空範圍，複製、移動範圍，複製格式（7個操作：write, edit, get, clear, copy, move, copy_format）

行列操作 (1)

• excel_row_column- 插入/刪除行/列，插入/刪除單元格（6個操作：insert_row, delete_row, insert_column, delete_column, insert_cells, delete_cells）

資料操作 (2)

• excel_data_operations- 排序、查找替換、批次寫入、獲取內容、統計資訊、獲取已使用範圍（6個操作：sort, find_replace, batch_write, get_content, get_statistics, get_used_range）
• excel_data_import_export- 匯入/匯出資料（JSON、陣列、CSV、範圍圖片）（4個操作：import_json, import_array, export_csv, export_range_image）

格式與樣式 (2)

• excel_style- 格式化單元格、獲取格式、複製工作表格式（3個操作：format, get_format, copy_sheet_format）
• excel_conditional_formatting- 添加、編輯、刪除、獲取條件格式（4個操作：add, edit, delete, get）

高級功能 (11)

• excel_table- 管理 Excel 表格（ListObject）（6個操作：create, get, delete, set_style, add_total_row, convert_to_range）
• excel_shape- 管理形狀與文字方塊（5個操作：add, edit, delete, get, add_textbox）
• excel_sparkline- 管理迷你圖（走勢圖）（4個操作：add, delete, get, set_style）
• excel_chart- 添加、編輯、刪除、獲取圖表，更新圖表資料，設定圖表屬性（6個操作：add, edit, delete, get, update_data, set_properties）
• excel_formula- 添加、獲取公式，獲取公式結果，計算公式，設定/獲取陣列公式（6個操作：add, get, get_result, calculate, set_array, get_array）
• excel_pivot_table- 添加、編輯、刪除、獲取資料透視表，添加/刪除欄位，重新整理（7個操作：add, edit, delete, get, add_field, delete_field, refresh）
• excel_data_validation- 添加、編輯、刪除、獲取資料驗證，設定輸入/錯誤訊息（5個操作：add, edit, delete, get, set_messages）
• excel_image- 添加、刪除、獲取、提取圖片（4個操作：add, delete, get, extract）
• excel_hyperlink- 添加、編輯、刪除、獲取超連結（4個操作：add, edit, delete, get）
• excel_comment- 添加、編輯、刪除、獲取批註（4個操作：add, edit, delete, get）
• excel_named_range- 添加、刪除、獲取命名範圍（3個操作：add, delete, get）

保護與設定 (4)

• excel_protect- 保護、解除保護工作簿/工作表，獲取保護資訊，設定單元格鎖定（4個操作：protect, unprotect, get, set_cell_locked）
• excel_filter- 應用、移除自動篩選，篩選資料，獲取篩選狀態（4個操作：apply, remove, filter, get_status）
• excel_freeze_panes- 凍結、解凍窗格，獲取凍結狀態（3個操作：freeze, unfreeze, get）
• excel_merge_cells- 合併、取消合併單元格，獲取合併單元格資訊（3個操作：merge, unmerge, get）

外觀與視圖 (5)

• excel_page_break- 管理分頁符號（5個操作：add_horizontal, add_vertical, remove, clear, get）
• excel_render- 將工作表或圖表渲染為圖片（2個操作：render_sheet, render_chart）
• excel_view_settings- 設定工作表視圖（縮放、網格線、標題、零值、背景、標籤顏色、凍結窗格、視窗分割、自動調整欄寬列高、顯示公式）（14個操作：set_zoom, set_gridlines, set_headers, set_zero_values, set_column_width, set_row_height, set_background, set_tab_color, set_all, freeze_panes, split_window, auto_fit_column, auto_fit_row, show_formulas）
• excel_print_settings- 設定列印區域、標題行、頁面設定（4個操作：set_print_area, set_print_titles, set_page_setup, set_all）
• excel_group- 分組/取消分組行/列（4個操作：group_rows, ungroup_rows, group_columns, ungroup_columns）

屬性與工具 (2)

• excel_properties- 獲取、設定工作簿/工作表屬性（5個操作：get_workbook_properties, set_workbook_properties, get_sheet_properties, edit_sheet_properties, get_sheet_info）
• excel_get_cell_address- 單元格地址格式轉換（A1 ↔ 行列索引）

📽️ PowerPoint 演示文稿處理 (25 個工具)

檔案操作 (1)

• ppt_file_operations- 創建、轉換、合併演示文稿、拆分演示文稿（4個操作：create, convert, merge, split）

投影片管理 (1)

• ppt_slide- 添加、刪除、獲取投影片資訊、移動、複製、隱藏投影片（8個操作：add, delete, get_info, move, duplicate, hide, clear, edit）

內容編輯 (5)

• ppt_text- 添加、編輯、替換文字（3個操作：add, edit, replace）
• ppt_image- 添加、編輯、刪除、獲取圖片，匯出投影片為圖片、提取圖片（6個操作：add, edit, delete, get, export_slides, extract）
• ppt_table- 添加、編輯、刪除表格，插入/刪除行列（9個操作：add, edit, delete, get_content, insert_row, insert_column, delete_row, delete_column, edit_cell）
• ppt_chart- 添加、編輯、刪除、獲取圖表，更新圖表資料（5個操作：add, edit, delete, get_data, update_data）
• ppt_shape- 統一形狀管理工具（12個操作：get, get_details, delete, edit, set_format, clear_format, group, ungroup, copy, reorder, align, flip）

格式設定 (2)

• ppt_text_format- 批次格式化文字
• ppt_background- 設定投影片背景（顏色/圖片）（2個操作：set, get）

高級功能 (12)

• ppt_comment- 管理投影片註解（4個操作：add, get, delete, reply）
• ppt_security- 加密、解密、寫入保護、標記為完稿（6個操作：encrypt, decrypt, set_write_protection, remove_write_protection, mark_final, get_status）
• ppt_watermark- 添加/移除文字或圖片浮水印（4個操作：add_text, add_image, remove, get）
• ppt_font- 字型管理（替換、嵌入、取得、設定備援）（5個操作：replace, embed, remove_embedded, get_used, set_fallback）
• ppt_animation- 添加、編輯、刪除、獲取動畫（4個操作：add, edit, delete, get）
• ppt_transition- 設定、刪除、獲取轉場效果（3個操作：set, get, delete）
• ppt_hyperlink- 添加、編輯、刪除、獲取超連結（4個操作：add, edit, delete, get）
• ppt_media- 添加、刪除音訊/影片，設定播放設定（5個操作：add_audio, delete_audio, add_video, delete_video, set_playback）
• ppt_smart_art- 添加、管理 SmartArt 節點（2個操作：add, manage_nodes）
• ppt_section- 添加、重新命名、刪除章節（4個操作：add, rename, delete, get）
• ppt_notes- 設定、獲取、清空講者備註，設定頁首頁尾（4個操作：set, get, clear, set_header_footer）
• ppt_layout- 設定投影片版面配置，批次應用版面配置（6個操作：set, get_layouts, get_masters, apply_master, apply_layout_range, apply_theme）

頁面與設定 (4)

• ppt_page_setup- 設定投影片大小、方向、頁尾、頁碼（4個操作：set_size, set_orientation, set_footer, set_slide_numbering）
• ppt_handout- 設定講義頁首頁尾（1個操作：set_header_footer）
• ppt_data_operations- 獲取統計資訊、內容、投影片詳情（3個操作：get_statistics, get_content, get_slide_details）
• ppt_properties- 獲取、設定文檔屬性（2個操作：get, set）

📑 PDF 檔案處理 (19 個工具)

檔案操作 (1)

• pdf_file- 創建、合併、拆分、壓縮、加密、解密、線性化PDF（7個操作：create, merge, split, compress, encrypt, decrypt, linearize）

內容添加 (5)

• pdf_text- 添加、編輯文字，提取文字（3個操作：add, edit, extract）
• pdf_image- 添加、編輯、刪除圖片，提取圖片（5個操作：add, delete, edit, extract, get）
• pdf_table- 添加、編輯表格（2個操作：add, edit）
• pdf_watermark- 添加水印
• pdf_page- 添加、刪除、旋轉、裁切、調整大小頁面（7個操作：add, delete, rotate, crop, resize, get_details, get_info）

書籤與註釋 (2)

• pdf_bookmark- 添加、編輯、刪除、獲取書籤（4個操作：add, delete, edit, get）
• pdf_annotation- 添加、編輯、刪除、獲取註釋（4個操作：add, delete, edit, get）

連結與表單 (2)

• pdf_link- 添加、編輯、刪除、獲取超連結（4個操作：add, delete, edit, get）
• pdf_form_field- 添加、編輯、刪除、獲取表單欄位，匯入/匯出表單資料，扁平化（7個操作：add, delete, edit, get, export, import, flatten）

附件與簽名 (2)

• pdf_attachment- 添加、刪除、獲取附件（3個操作：add, delete, get）
• pdf_signature- 簽名、刪除簽名、獲取簽名（3個操作：sign, delete, get）

頁首頁尾與印章 (2)

• pdf_header_footer- 添加文字、圖片、頁碼至頁首/頁尾（4個操作：add_text, add_image, add_page_number, remove）
• pdf_stamp- 添加文字、圖片、PDF 頁面印章（5個操作：add_text, add_image, add_pdf, list, remove）

目錄與合規 (2)

• pdf_toc- 產生、讀取、移除目錄（3個操作：generate, get, remove）
• pdf_compliance- PDF/A、PDF/UA 合規性驗證與轉換（2個操作：validate, convert）

讀取與屬性 (3)

• pdf_info- 獲取PDF內容和統計資訊（2個操作：get_content, get_statistics）
• pdf_properties- 獲取、設定文檔屬性（2個操作：get, set）
• pdf_redact- 編輯（塗黑）文字或區域

🔍 OCR 文字辨識 (2 個工具)

影像前處理 (1)

• ocr_preprocessing- 影像前處理以提升辨識品質（6個操作：auto_skew, denoise, contrast, scale, invert, dewarp）
  自動校正傾斜、降噪、對比度調整、縮放、反色、去彎曲等預處理操作

文字辨識 (1)

• ocr_recognition- 圖片/PDF 文字辨識，含專用辨識模式（5個操作：recognize, recognize_pdf, recognize_receipt, recognize_id_card, recognize_passport）
  recognize：辨識圖片中的文字（PNG/JPG/BMP/TIFF/PDF），回傳文字、信心度、座標；includeWords=true 可取得每個單詞的 Bounding Box 座標（X, Y, Width, Height）
  recognize_pdf：掃描 PDF 轉可編輯文件（DOCX/XLSX/PDF/TXT），支援 language 參數指定辨識語言
  recognize_receipt / recognize_id_card / recognize_passport：針對收據、身分證、護照的專用辨識，回傳結構化欄位資料

📧 Email 郵件處理 (6 個工具)

郵件操作 (3)

• email_file- 建立、讀取、儲存、轉換、偵測格式（5個操作：create, get_info, save, convert, detect_format）
• email_content- 取得/設定郵件內容（主旨、內文、標頭、收件人）（8個操作：get_body, set_body, get_headers, set_headers, get_subject, set_subject, get_recipients, set_recipients）
• email_attachment- 附件管理（列出、新增、移除、解壓）（5個操作：list, add, remove, extract, extract_all）

日曆與聯絡人 (2)

• email_calendar- 行事曆事件管理（ICS 格式）（5個操作：create, get_info, save, set_recurrence, set_attendees）
• email_contact- 聯絡人管理（VCF/MSG 格式）（4個操作：create, get_info, save, set_photo）

格式轉換 (1)

• email_conversion- 郵件格式轉換（1個操作：convert）
  支援格式：EML、EMLX、MSG、MHT/MHTML、HTML

📊 BarCode 條碼處理 (2 個工具)

• barcode_generate- 產生條碼圖片（1個操作：generate）
  支援類型：QR、Code128、Code39、EAN13、EAN8、UPCA、UPCE、DataMatrix、PDF417、Aztec 等。輸出格式：PNG、JPEG、BMP、SVG 等
• barcode_recognize- 辨識圖片中的條碼（1個操作：recognize）
  支援自動偵測所有類型或指定類型過濾，回傳文字內容、類型、信心度、區域座標

🔄 轉換工具 (1 個)

• convert_document- 跨格式轉換（啟用任何文檔工具時自動可用）
  支援輸入：Word、Excel、PowerPoint、PDF、HTML、EPUB、Markdown、SVG、XPS、LaTeX、MHT
  支援輸出：Word/Excel/PDF→圖片（PNG/JPEG/TIFF/BMP/SVG，支援 pageIndex 單頁輸出）、跨格式轉換

📁 Session 管理 (1 個)

Session 操作

• document_session- 管理文檔工作階段（需要啟用 --session-enabled）（10個操作：open, save, close, list, status, list_temp, recover, delete_temp, cleanup, temp_stats）

操作說明

操作	說明
open	開啟文件到記憶體 Session
save	儲存 Session 變更到檔案（可選 outputPath 參數另存為）
close	關閉 Session（可選擇儲存或捨棄變更）
list	列出所有活動 Session
status	取得特定 Session 狀態

暫存檔操作

操作	說明
list_temp	列出可恢復的暫存檔
recover	恢復暫存檔到原始路徑或指定路徑
delete_temp	刪除特定暫存檔
cleanup	清理過期暫存檔
temp_stats	取得暫存檔統計資訊

🔌 擴充功能 (1 個)

擴展操作

• extension- 管理外部擴展程序訂閱 Session 變更（需要啟用 --session-enabled 和 --extension-enabled）（7個操作：list, bind, unbind, status, set_format, bindings, command）

操作說明

操作	說明
list	列出所有已註冊的擴展
bind	將 Session 綁定到擴展，開始接收變更通知
unbind	解除 Session 與擴展的綁定
status	查詢擴展狀態（Running、Stopped、Error 等）
set_format	設定快照輸出格式（PDF、HTML、PNG 等）
bindings	列出 Session 的所有擴展綁定
command	向綁定的擴展發送命令（如 highlight、goto）

傳輸模式

模式	說明
mmap	Memory-Mapped File - 適合大檔案，Windows 專用
stdin	標準輸入二進位 - 跨平台、低延遲（預設）
file	臨時檔案 - 實作簡單，適合除錯測試

⚠️ 評估模式限制

在無授權（評估模式）下運行時，Aspose 組件會有以下限制：

組件	限制說明
Aspose.Words	字型格式（名稱、大小、顏色）可能無法正確應用；文檔會包含評估版水印
Aspose.Cells	多工作表操作受限（如跨工作表存取）；工作簿會包含評估版工作表
Aspose.Slides	文字替換時可能包含水印文字；投影片可能包含評估版標記
Aspose.PDF	集合限制為最多 4 個元素（如頁面數限制）；PDF 會包含評估版水印
Aspose.OCR	辨識結果可能包含限制；部分功能在評估模式下受限

注意事項：

• 大部分基本操作（讀取、創建、簡單編輯）在評估模式下仍可正常運行
• 評估模式適合測試和開發，但不建議用於生產環境
• 使用 test.ps1 -SkipLicense 可在評估模式下運行單元測試