新功能 (2026-06-19) — Office 讀寫

Office 文件的 headless 讀寫——Excel(.xlsx)、Word(.docx)、 PowerPoint(.pptx)——讓流程不必驅動 GUI 就能吃進資料列或產出報表。 走完整五層(facade、AC_* 執行器指令、MCP 工具、Script Builder)。

背後的函式庫(openpyxl / python-docx / python-pptx)是 **可選**相依:

pip install je_auto_control[office]

缺少對應函式庫時,每個函式都會丟出清楚的 RuntimeError,因此核心 套件維持精簡,``import je_auto_control`` 不會載入任何一個。

Excel

from je_auto_control import read_workbook, write_workbook

write_workbook("people.xlsx", [{"name": "Ada", "age": 36}], sheet="P")
rows = read_workbook("people.xlsx", sheet="P")   # [{'name': 'Ada', ...}]

第一列作為 dict 的鍵;``sheet`` 預設為作用中工作表。指令: AC_read_workbook / AC_write_workbook``(以及 ``ac_read_workbook / ac_write_workbook)。

Word

from je_auto_control import read_document, write_document

write_document("report.docx", ["標題", "第一行", "第二行"])
paragraphs = read_document("report.docx")["paragraphs"]

指令:AC_read_document / AC_write_document。

PowerPoint

from je_auto_control import read_presentation, write_presentation

write_presentation("deck.pptx", [
    {"title": "簡介", "body": ["重點一", "重點二"]},
])
slides = read_presentation("deck.pptx")["slides"]   # 每張投影片的文字

每張投影片規格為 {title, body:[...]},採用「標題及內容」版面。指令: AC_read_presentation / AC_write_presentation。