name: doc-beautifier description: "Beautify Word documents (.docx) using a professional general template. Trigger when the user asks to: beautify/美化/排版/格式化 a Word document, apply a template/style to a .docx file, make a document look professional/clean/formatted, or clean up a document's formatting. Works by reading the source .docx, detecting document structure (title, headings, body), and applying consistent fonts, sizes, spacing, indentation, and page layout. Supports multiple template styles."

doc-beautifier

Beautify .docx files with a professional general template. Preserves all original text content while applying consistent formatting.

Quick Start

python3 scripts/beautify.py <input.docx> <output.docx>
# Optional template:
python3 scripts/beautify.py input.docx output.docx --template elegant
7w4.net提供免費和付費技能下載。

Features

• Structure Detection: Heuristically identifies titles, headings (3 levels), and body paragraphs based on text patterns, length, and existing formatting
• 3 Built-in Templates:
• standard — Default professional template (A4, 微軟雅黑 headings, 宋體 body, 1.5 line spacing)
• compact — Tighter spacing, smaller margins, 1.25 line spacing (for dense documents)
• elegant — Larger margins, refined colors, spacious layout (for formal reports)
• Page Layout: Sets A4 page size, proper margins, centered page numbers in footer
• Content Preservation: ALL original text is preserved; no content is added, removed, or reordered

Template Specification

Workflow

1. Locate the user's input .docx file
2. Run beautify.py with desired template
3. Validate the output by unpacking or checking with python-docx
4. Deliver the beautified document path to the user

Structure Detection Heuristics

The script identifies paragraph roles using:

• First non-empty paragraph → Document title
• Already styled as Heading 1-3 → Preserve heading level
• Bold + large font + short text (< 50 chars) without ending punctuation → Heading
• Starts with Chinese number (一、二、) or decimal (1.1, 2.3) → Heading
• Bold paragraphs under 60 chars → Heading
• Everything else → Body text

Customization

Edit the TEMPLATES dictionary in scripts/beautify.py to:

• Change colors, fonts, sizes
• Add new template variants
• Adjust line spacing or indentation
• Modify page margins

Requirements

• python-docx (install: pip install python-docx)
• Python 3.8+

這是一款實用且完成度較高的 Word 美化工具。它能一鍵調整文件的字型、段落間距、頁邊距等格式，提供三種專業模板可選，省去手動排版的麻煩。不過它對文件中包含複雜表格或圖片時美化效果可能有限，且不支援批次處理多個檔案。總體來說，質量可靠，能滿足日常文件格式化的基本需求。