name: word-format-master description: "【Word文件排版大師】專門用於對Word文件（.docx/.doc/.wps/.wpt等）進行專業排版和格式美化的技能。當用戶提出'排版文件'、'美化Word'、'調整格式'、'規範排版'、'設定樣式'、'文件格式化'等需求時觸發。支援頁面設定、字型樣式、段落格式、標題層級、頁首頁尾、頁碼、目錄、表格美化、列表格式等全流程排版操作。通過本地WPS Office SDK（tencent-local-office-edit）實現即時視覺化編輯。" agent_created: true

Word文件排版大師

概述

對Word文件進行專業排版和格式美化。涵蓋頁面佈局、字型段落、標題樣式、頁首頁尾、頁碼、目錄、表格美化、列表編號等全流程排版操作。通過本地 WPS Office SDK（editor_sdk）實現即時視覺化編輯，使用者可即時看到排版效果。

前置條件

1. 載入本地編輯技能

使用本技能前，必須先載入 tencent-local-office-edit 技能以獲取本地 WPS 編輯能力：

Skill: invoke tencent-local-office-edit

2. 確認 / 啟動 editor_sdk 服務

當本地 WPS 編輯服務未執行時，按以下步驟啟動：

方式一：通過自動化命令啟動

啟動editor_sdk本地WPS編輯服務

方式二：手動啟動（PowerShell）

Start-Process -FilePath "C:\Program Files\WorkBuddy\resources\app.asar.unpacked\node_modules\@tencent\tencent-docs-ai-engine\bin\win32-x64\editor_sdk.exe" -WindowStyle Hidden

方式三：開機自啟（已配置計劃任務） 系統已建立計劃任務 WorkBuddyEditorSDK，在任務計劃程式中可檢視和管理。

驗證服務是否就緒：

小蔥技能7w4.net持續更新中。

cd "C:\Program Files\WorkBuddy\resources\app.asar.unpacked\resources\builtin-skills\tencent-local-office-edit"
python3 edsdk.py list doc

如果返回工具清單則服務正常。

服務啟動後在埠 39099 監聽。若 edsdk.py 返回錯誤，檢查埠是否被佔用。

3. 開啟文件

開啟待排版的 Word 文件：

# 方式一：用 present_files 在預覽面板中開啟（推薦，使用者可即時看到編輯效果）
# 先調 present_files 工具開啟文件路徑
# 然後通過 get_pool_status 獲取 file_id
python3 edsdk.py call get_pool_status
# 從返回結果中按檔案路徑匹配目標文件，獲取 file_id

# 方式二：直接 open_file（無需預覽展示的場景）
python3 edsdk.py call open_file file_path=</path/to/document.docx>
# 記錄返回的 file_id，後續所有操作都用這個 ID

排版工作流程

排版工作遵循「先分析，再規劃，後執行」的原則，避免盲目修改。

階段一：文件結構分析

開始排版前，先用分析工具瞭解文件當前結構：

# 1. 獲取文件大綱結構（標題層級、內容範圍）
python3 edsdk.py schema doc_get_outline
python3 edsdk.py call doc_get_outline file_id=<file_id>

# 2. 獲取文件結構樹（段落、表格等元素的完整結構）
python3 edsdk.py schema doc_resolve_document_structure
python3 edsdk.py call doc_resolve_document_structure file_id=<file_id>

# 3. 獲取可操作位置（瞭解文件長度）
python3 edsdk.py schema doc_get_last_operable_pos
python3 edsdk.py call doc_get_last_operable_pos file_id=<file_id>

# 4. 檢視文件當前文本屬性和段落屬性（抽樣瞭解現有格式）
python3 edsdk.py schema doc_get_text_property
python3 edsdk.py call doc_get_text_property file_id=<file_id> idx=<0>

python3 edsdk.py schema doc_get_paragraph_property
python3 edsdk.py call doc_get_paragraph_property file_id=<file_id> idx=<0>

階段二：規劃排版方案

根據文件型別和使用者需求，確定排版方案。通用排版推薦以下規範：

階段三：執行排版操作

按以下分類依次執行排版操作。每執行完一步儲存一次，避免操作間相互干擾。

排版操作詳解

1. 頁面設定（Page Setup）

設定紙張大小、方向、頁邊距。

# 使用的工具：doc_modify_paragraph（可修改段落屬性含頁面設定相關內容）
# 先查詢 schema 確認引數
python3 edsdk.py schema doc_modify_paragraph

注意：頁面級屬性（紙張大小、頁邊距等）需要對整個文件範圍的段落屬性進行設定，或使用底層段落屬性介面。

2. 字型格式設定（Text Property）

設定文件各部分的字型、字號、顏色、加粗等屬性。

# 先通過 doc_find 定位要修改的文本範圍
python3 edsdk.py schema doc_find
python3 edsdk.py call doc_find file_id=<file_id> search_text="要查詢的文本"

# 然後更新文本屬性
python3 edsdk.py schema doc_update_text_property
python3 edsdk.py call doc_update_text_property file_id=<file_id> begin=<begin> end=<end> font_name="宋體" font_size=12 bold=false

常用文本屬性引數（以 schema 實際返回為準）： - font_name: 字型名稱（"宋體"、"黑體"、"微軟雅黑"、"仿宋"、"Times New Roman"等） - font_size: 字號（磅值，如 12 表示小四號，16 表示三號） - bold: 是否加粗（true/false） - italic: 是否斜體（true/false） - color: 字型顏色（RGB HEX值如 "FF0000"） - underline: 下劃線型別

3. 段落格式設定（Paragraph Property）

設定對齊方式、行間距、段間距、首行縮排等。

# 修改段落屬性
python3 edsdk.py schema doc_modify_paragraph
python3 edsdk.py call doc_modify_paragraph file_id=<file_id> idx=<段落起始索引> ...

常用段落屬性引數（以 schema 實際返回為準）： - alignment: 對齊方式（0=左對齊，1=居中，2=右對齊，3=兩端對齊，4=分散對齊） - line_spacing: 行間距（值=行距倍數×240，如 1.5倍=360，單倍=240） - space_before: 段前間距（單位：磅） - space_after: 段後間距（單位：磅） - indent_first_line: 首行縮排（單位：磅，2字元約等於48磅） - indent_left: 左���進 - indent_right: 右縮排

4. 標題層級格式化

對文件標題進行統一格式化，形成清晰的大綱層級。

工作流程：

# 1. 獲取文件大綱，瞭解標題層級分佈
python3 edsdk.py call doc_get_outline file_id=<file_id>

# 2. 逐個層級設定標題樣式
# 對一級標題：大號字型、加粗、段前段後間距
# 對二級標題：中號字型、加粗
# 對三級標題：小號字型、加粗

# 使用 doc_find 定位每個標題的位置
# 使用 doc_update_text_property 修改字型
# 使用 doc_modify_paragraph 修改段落屬性

推薦標題格式：

5. 頁首頁尾設定（Header & Footer）

# 設定頁首
python3 edsdk.py schema doc_insert_header
python3 edsdk.py call doc_insert_header file_id=<file_id> text="頁首內容"

# 設定頁尾
python3 edsdk.py schema doc_insert_footer
python3 edsdk.py call doc_insert_footer file_id=<file_id> text="頁尾內容"

6. 頁碼設定（Page Number）

# 插入頁碼（自動放在頁尾中）
python3 edsdk.py schema doc_set_page_number
python3 edsdk.py call doc_set_page_number file_id=<file_id>

7. 表格美化（Table Formatting）

對文件中的表格進行格式美化。

# 1. 獲取表格資訊
python3 edsdk.py schema doc_get_table_info
python3 edsdk.py call doc_get_table_info file_id=<file_id> idx=<表格所在位置索引>

# 2. 設定表格屬性
python3 edsdk.py schema doc_set_table_properties
python3 edsdk.py call doc_set_table_properties file_id=<file_id> idx=<表格索引> ...
# 常用引數：邊框樣式、表格寬度、對齊方式

# 3. 設定行高/列寬
python3 edsdk.py schema doc_set_table_layout
python3 edsdk.py call doc_set_table_layout file_id=<file_id> idx=<索引> ...

8. 插入分隔符和分頁

# 插入分頁符
python3 edsdk.py schema doc_insert_page_break
python3 edsdk.py call doc_insert_page_break file_id=<file_id> idx=<位置>

# 插入段落分隔符
python3 edsdk.py schema doc_insert_paragraph
python3 edsdk.py call doc_insert_paragraph file_id=<file_id> idx=<位置>

9. 查詢替換（Find & Replace）

批次修改文件中的特定文本內容：

python3 edsdk.py schema doc_find_and_replace
python3 edsdk.py call doc_find_and_replace file_id=<file_id> search_text="舊文本" replace_text="新文本"

10. 批次插入內容

需要向文件中插入大段格式化內容時，優先使用 Markdown 方式：

python3 edsdk.py schema doc_insert_markdown
python3 edsdk.py call doc_insert_markdown file_id=<file_id> idx=<位置> markdown="
# 標題
正文內容
- 列表項1
- 列表項2
"

格式化指令碼（scripts/）

通用的排版處理指令碼

scripts/format_doc.py — 對 Word 文件執行一鍵式排版處理，包括標準化字型、段落、標題等。適用於批次處理場景。

使用方式

python3 scripts/format_doc.py <輸入檔案路徑> [輸出檔案路徑] [--style 通用|公文|論文]

排版參考（references/）

references/formatting_specs.md — 包含詳細的排版規範參考： - 通用文件排版規範 - 公文排版規範（GB/T 9704） - 學術論文排版規範 - 常見字號與磅值對照表 - 常用排版引數速查

內建排版方案：三段式通用文件排版

以下為使用者確認的預設排版方案，適用於審計方案/工作報告/企業公文等型別文件。

整體佈局

文件分為三個區域：封面頁 → 目錄頁 → 報告正文頁，以分節符(下一頁)分隔。 不允許使用自動編號，所有編號保持手動編號（Word自動編號可能導致相容性問題）。

封面頁格式

目錄頁格式

報告正文頁格式

標題（一級~五級）

序號編排規則

核心原則：全手動編號，不使用Word自動編號功能。每個層級的序號在同級內順序遞增，每遇到上級標題就重新開始編號。

各層級格式：

示例（以當前文件實際結構）：

一、審計專案概況          ← H1#1
  （一）專案名稱          ← H2#1（在H1#1下從一重新開始）
  （二）審計目標          ← H2#2
  （三）審計依據          ← H2#3
  （四）審計期間          ← H2#4
二、審計範圍和物件        ← H1#2
  （一）業務流程範圍      ← H2#1（在H1#2下重新從（一）開始）
  （二）組織範圍          ← H2#2
  （三）時間範圍          ← H2#3
三、審計內容與重點        ← H1#3
  （一）基礎資料收集      ← H2#1
  （二）核心流程審查      ← H2#2
    1.流程節點必要性審查  ← H3#1（在H2#2下從1.重新開始）
    2.執行效率量化統計    ← H3#2
    3.典型低效事項剖析    ← H3#3
    4.合同簽署時效核查    ← H3#4
      （1）倒籤判定       ← H4#1（在H3#4下從（1）重新開始）
      （2）逾期判定       ← H4#2
      （3）超期未籤判定   ← H4#3

⚠️ 重要：所有序號均為手動輸入的文字，不得使用Word的「自動編號」功能。修改文件時需手動調整序號以保持連續性和重啟規則。

正文

表格

頁面設定

頁碼

排版流程速查

1. 加��� tencent-local-office-edit 技能
2. 開啟文件 → 獲取 file_id
3. 分析文件結構（get_outline / resolve_document_structure）
4. 頁面設定（頁邊距、紙張大小）
5. 格式化正文（字型 + 段落）
6. 格式化標題層級
7. 設定頁首/頁尾/頁碼
8. 美化表格（如有）
9. 統一編號和列表格式（如有）
10. 儲存文件
11. 展示排版結果

注意事項

1. 每次編輯前先查 schema：所有 doc_* 工具呼叫前，必須執行 edsdk.py schema <工具名> 確認引數。
2. 漸進式操作：不要一次性全部改完再儲存，每完成一個排版分類就 save 一次。
3. 座標在編輯後失效：插入、刪除、替換會讓舊座標偏移，連續操作時每改完一處就重新查詢最新索引。
4. 優先用 Markdown 批次插入：批次插入內容時用 doc_insert_markdown，避免多次單段寫入。
5. 儲存後不要主動關閉文件：呼叫 save_file 儲存即可，不要調 close_file（會關閉使用者正在看的檢視）。
6. 排版前先備份：對大文件或有重要內容的文件，排版前先另存一份備份。
7. 二次確認再執行：排版前向用戶展示排版方案（分析結果+規劃方案），獲得確認後執行。

這個 Skill 內容比較全面，提供了詳細的排版流程和多種格式規範參考，適合需要專業排版的使用者。但存在一些不足：文件中有亂碼問題，部分字型名稱顯示不全；附帶的指令碼功能有限，實際排版仍需手動操作；部分排版引數在不同位置存在不一致。總體來說功能完整度尚可，但文件質量有待提升。