name: word-style-cleaner description: "清理 Word (.docx) 檔案中未使用的文字樣式。當用戶要求清理 Word 文件樣式、刪除多餘樣式、簡化樣式列表、或提到樣式面板太亂時使用此 Skill。支援單個檔案或批次資料夾操作。保留正文、標題1-5、表格樣式及文件中實際使用的樣式，刪除 heading 6-9、TOC、批註、字型殘留等垃圾樣式。" agent_created: true

docx-clean-styles — Word 樣式清理

觸發條件

當用戶提到以下任一意圖時觸發：

• "清理Word樣式" / "刪除多餘樣式" / "簡化樣式列表"
• "樣式面板太亂" / "不相關的文字樣式刪掉"
• "把 XXX.docx 裡沒用的樣式去掉"
• 指定一個 .docx 檔案或資料夾，要求"只保留正文和標題"

使用方式

直接執行內建指令碼，一鍵完成解壓→分析→清理→打包全流程。

清理單個檔案

python scripts/clean_styles.py "D:/path/to/document.docx"

清理資料夾下所有 .docx

python scripts/clean_styles.py "D:/path/to/folder/"

清理多個檔案

python scripts/clean_styles.py "D:/a.docx" "D:/b.docx" "D:/c.docx"

保留策略

指令碼預設保留以下樣式，其餘全部刪除：

刪除內容

• heading 6-9 + 對應字元樣式
• TOC1-TOC9（目錄樣式）
• 批註/批註主題/annotation 全套
• font5-font12（字型殘留樣式）
• xl65-xl79（Excel 匯入殘留）
• Title、Subtitle、表單、列表段落等未使用樣式

注意事項

• 指令碼依賴 docx 外掛的 unpack.py 和 pack.py，如果路徑變化需更新指令碼頂部常量
• 操作直接覆蓋原檔案，建議先備份

  來源於7w4.net。

• 保留策略如需調整（如只保留標題1-3），修改指令碼中 BASE_KEEP_IDS 集合即可

這是一個功能專一的 Word 樣式清理工具，能有效刪除多餘樣式並保留必要的正文、標題、表格等樣式。程式碼質量較好，處理了頁首頁尾和動態檢測實際使用樣式等細節。但存在兩個明顯不足：一是指令碼會直接覆蓋原檔案，操作有風險；二是依賴固定的外掛路徑，可能在某些環境下無法執行。總體質量中等，功能實用但安全性需加強。