name: wps-office-suite displayName: WPS Office 全家桶 slug: wps-office-suite description: WPS Office 全家桶 - 四引擎(WPS/MS Office/LibreOffice/純Python)智慧識別使用者已安裝軟體,純Python模式支援排序/篩選/圖表/公式/統計,含文件模板(程式碼生成)、最佳實踐案例、故障排除大章(20+避坑+15 FAQ+15錯誤ID 統一索引)、自動重試、硬體自適應、環境自檢、Skill更新提醒;v4.0新增:Word→PPT一鍵生成、Excel自然語言資料分析、Word合同條款審查、Excel發票OCR入賬;v4.3新增:Excel深度分析(公式糾錯/資料清洗/透視表/資料預測/NL2Formula);v4.4新增:長文件排版自動化(目錄/頁首頁尾/標題編號/圖表索引/交叉引用/格式統一);v4.5新增:會議紀要生成(ASR轉寫→LLM摘要→Word)、COM健康檢查(狀態檢測+殘留程序+自動釋放);v4.6新增:Excel智慧分析統一入口(6命令合併)、資料圖表生成器(自動選圖+生成)、文件翻譯增強版(Word/Excel/PPT多格式翻譯) version: 4.6.1 category: 辦公協作與生產力工具 platforms: - windows - macos - linux permission: - 檔案系統訪問 - 應用程式控制(WPS / MS Office / LibreOffice / 純Python) dependency: - "Python 3.8+" - "pywin32(Windows COM 模式,可選)" - "python-docx / openpyxl / python-pptx(純Python模式,可選)" - "WPS Office 2019+ 或 Microsoft Office(可選,增強模式)" - "LibreOffice(可選,跨平臺兜底轉換)" pricing: 免費 tags: - WPS - MS-Office - LibreOffice - Office - Word - Excel - PPT - 四引擎 - 智慧識別 - 純Python - 跨平臺 - 自動重試 - 硬體自適應 - 自動化 - 辦公提效 - AI助手 - 文件模板 - 最佳實踐 - 避坑指南 建議反饋郵箱: njskills@agent.qq.com
🏗️ 四引擎智慧識別:自動檢測使用者電腦已安裝的軟體,按 WPS → MS Office → LibreOffice → 純Python 順序選擇最合適的引擎 ✨ 純Python模式增強:排序、篩選、圖表、公式、統計 — 跨平臺全部支援 🔄 自動重試:WPS 卡住時自動重試 3 次,不用手動重啟 ⚡ 硬體自適應:自動檢測 CPU 記憶體,動態調整超時和執行緒,不拖累電腦 📚 文件模板 + 最佳實踐 + 故障排除:程式碼生成3個即用模板 + 10個最佳實踐案例 + 統一故障排除大章 📬 Skill 更新提醒:自動檢查新版本,7天提醒一次,保持最新 🆕 檔案大小明確限制:單檔案 < 50MB 直接處理,> 50MB 有分片建議 🔬 Excel 智慧分析 v4.6:6命令合併為 1 個統一入口(--action 引數路由) 📊 資料圖表生成器 v4.6:基於資料特徵自動推薦圖表型別 + 生成圖表嵌入 Excel 🌐 文件翻譯 v4.6:Word/Excel/PPT 專業翻譯(支援多模型降級) 🎙️ 會議紀要 v4.5:音訊 → ASR 轉寫 → LLM 摘要 → Word(支援降級鏈) 🏥 COM 健康檢查 v4.5:WPS/MS Office 狀態檢測 + 殘留程序清理 📧 建議反饋:有更好建議?郵箱:njskills@agent.qq.com
python scripts/wps_test.py
python scripts/wps_excel.py engine-info
python scripts/wps_word.py create --title "測試文件"
python scripts/wps_excel.py create --name "預算表" --sheets "收入,支出"
python scripts/wps_ppt.py create --title "推廣方案"
python scripts/wps_excel.py check-update
python templates/generate_templates.py --dir ./output訪問小蔥技能站7w4.net,解鎖更多實用的AI技能外掛。
| 硬體等級 | CPU / 記憶體 | 超時 | 並行數 | 適用場景 |
|---|---|---|---|---|
| 高效能 | 8核+ / 16G+ | 30s | 8執行緒 | 批次處理、大檔案 |
| 中等 | 4核+ / 8G+ | 60s | 4執行緒 | 日常辦公 |
| 低效能 | 2核 / 4G | 120s | 1執行緒 | 輕量任務 |
| 功能 | WPS | MS Office | LibreOffice | 純Python |
|---|---|---|---|---|
| 建立/編輯/格式 — Word | ✅ | ✅ | ✅(回退) | ✅ |
| 表格/圖片/目錄 — Word | ✅ | ✅ | ❌ | ✅ |
| 建立/編輯/公式/圖表 — Excel | ✅ | ✅(回退) | ✅(回退) | ✅ |
| 排序/篩選/統計 — Excel | ✅ | ✅(回退) | ✅(迴避) | ✅ |
| 幻燈片/主題/插入 — PPT | ✅ | ❌ | ❌ | ❌ |
| PPT 建立/多頁 — PPT | ✅ | ✅ | ✅(回退) | ✅ |
✅(回退)= 原生引擎不支援時,自動回退到純 Python 實現
| 模板 | 用途 | 生成命令 |
|---|---|---|
| 工作報告 | 週報/月報/彙報 | python templates/generate_templates.py --dir ./output |
| 月度預算 | 收入/支出/彙總 | 同上 |
| 商務PPT | 專案彙報/方案 | 同上 |
模板通過純 Python 程式碼動態生成,無需分發二進位制檔案。首次執行需安裝
python-docx、openpyxl、python-pptx。
| 限制項 | 閾值建議 | 超出後處理方式 |
|---|---|---|
| 單檔案大小 | < 50MB 直接處理 | > 50MB 先分片(拆 Sheet/Section) |
| 批次檔案數 | 建議 ≤ 50 個/批 | 超過時分批呼叫 |
| Excel 行數 | < 100,000 行 | 超過時分 Sheet 儲存 |
| PPT 頁數 | < 100 頁 | 拆分為多個檔案 |
| 併發操作 | 同一引擎 1 個例項 | 序列等待,避免並行寫同一檔案 |
| 檔名長度 | < 200 字元 | 過短路徑避免中文 |
| 型別 | 問題 | 快速解決 |
|---|---|---|
| 🚫 避坑 | WPS 未安裝就呼叫 | 執行 engine-info 檢查引擎 |
| 🚫 避坑 | 公式寫入顯示 #NAME? | 按 Ctrl+Alt+F9 重新計算 |
| 🚫 避坑 | 中文路徑編碼錯誤 | 改用英文路徑或 raw string |
| 🚫 避坑 | 大檔案記憶體溢位 | >50MB 分片處理 |
| 🚫 避坑 | WPS 卡住無響應 | 已自動重試3次,不行就工作管理員結束 |
| 🚫 避坑 | COM 物件殘留 | Worker 自動釋放,或執行 com-health release-all |
| 🚫 避坑 | PPT 新增幻燈片失敗 | 僅 WPS 支援,或一次性指定 slides_content |
| 🚫 避坑 | openpyxl 讀取公式為 None | 先 WPS 開啟儲存一次 |
| 🚫 避坑 | 排序/篩選/圖表錯亂 | 確保第一行是表頭,列名完全一致 |
| 🚫 避坑 | 篩選返回空結果 | 數值 value 必須是字串 |
| ⚠️ FAQ | 該選哪個引擎? | 自動檢測,無需手動選擇 |
| ⚠️ FAQ | WPS 版本有要求? | 2019+ 或 WPS 365,安裝後必須重啟 |
| ⚠️ FAQ | 純Python vs WPS 區別? | 公式計算/圖表/新增幻燈片不同 |
| ⚠️ FAQ | 檔案太大怎麼辦? | <50MB 直接處理,>50MB 分片 |
| ⚠️ FAQ | Linux 能用嗎? | 能,安裝 LibreOffice |
| ⚠️ FAQ | WPS 卡住怎麼辦? | 自動重試3次,不行結束程序 |
| ⚠️ FAQ | 純Python 安裝依賴? | pip install python-docx openpyxl python-pptx |
| ⚠️ FAQ | 模板如何獲取? | 程式碼生成,執行 generate_templates.py |
| ⚠️ FAQ | 批次轉換格式? | format_converter.py batch |
| ⚠️ FAQ | 多 Sheet 處理? | 逐 Sheet 呼叫或 add-sheet |
| ⚠️ FAQ | 排序/篩選總失敗? | 確保 openpyxl 安裝、檔案未佔用 |
| ⚠️ FAQ | 如何提交反饋? | wps_feedback.py email 或發郵件 |
| ⚠️ FAQ | 公式何時計算? | 開啟檔案時由 Excel/WPS 計算 |
| ⚠️ FAQ | 檔案被佔用怎麼辦? | 關閉程式,等待3-5秒重試 |
| ⚠️ FAQ | 純Python 不可用功能? | 新增幻燈片/插入/主題/VBA/條件格式 |
| 🚨 錯誤ID | E001 WPS 未安裝或 COM 註冊失敗 | 安裝 WPS 後重啟電腦 |
| 🚨 錯誤ID | E002 python-docx 未安裝 | pip install python-docx openpyxl python-pptx |
| 🚨 錯誤ID | E003 檔案路徑不存在 | 改用英文路徑或以管理員執行 |
| 🚨 錯誤ID | E004 格式轉換失敗 | 安裝 WPS 或 LibreOffice |
| 🚨 錯誤ID | E005 需要 WPS 模式 | 安裝 WPS 或改用純Python模式 |
| 🚨 錯誤ID | E006 WPS 卡住無響應 | 工作管理員結束程序;更新到最新版 |
| 🚨 錯誤ID | E007 許可權不足 | 以管理員執行;檢查檔案只讀屬性 |
| 🚨 錯誤ID | E008 pywin32 匯入失敗 | pip uninstall pywin32 && pip install pywin32 |
| 🚨 錯誤ID | E009 Python 版本過低 | 升級到 Python 3.8+ |
| 🚨 錯誤ID | E010 引擎不支援此功能 | 安裝 WPS 或改用 info 檢視能力矩陣 |
| 🚨 錯誤ID | E011 LibreOffice 未安裝 | 下載 LibreOffice 並新增到 PATH |
| 🚨 錯誤ID | E012 LibreOffice 轉換失敗 | 檢查原始檔是否損壞;避免中文路徑 |
| 🚨 錯誤ID | E013 檔案不存在 | 確認路徑正確;未被刪除或移動 |
| 🚨 錯誤ID | E014 未知執行時錯誤 | 執行環境自檢 wps_test.py;聯絡反饋 |
| 🚨 錯誤ID | E015 不支援的操作或格式 | 輸出格式改為 pdf/txt/html |
症狀:win32com.com_error 或 "WPS 未安裝"
排查:
1. 執行 python scripts/wps_excel.py engine-info 檢查當前引擎
2. 如果顯示 PURE 或 LIBREOFFICE,說明 WPS 不可用
3. 安裝 WPS Office 2019+ 後重啟電腦
症狀:公式寫入後開啟顯示 #NAME? 錯誤
排查:
1. openpyxl 寫的是公式字串,開啟時需 Excel/WPS 重新計算
2. 解決:按 Ctrl+Alt+F9 強制重新計算
3. 或切換到 WPS 模式自動計算
症狀:UnicodeEncodeError 或 FileNotFoundError
排查:
1. 避免中文路徑:D:\docs\report.docx ✅
2. 路徑加引號:"D:\中文\報告.docx" ✅
3. 使用 raw string:r"D:\中文\報告.docx" ✅
症狀:MemoryError 或程式卡死
排查:
1. 先執行 python scripts/wps_word.py info --file big.docx 檢視大小
2. < 50MB 直接處理
3. > 50MB 拆分處理:分 Sheet/Section
4. 硬體自適應會自動延長超時
症狀:操作超時(30s/60s/120s)
排查:
1. Skill 已自動重試 3 次(等 1s → 2s → 4s)
2. 仍失敗則:工作管理員 → 結束 WPS 程序
3. 反覆出現:pip install --upgrade pywin32
症狀:第二次呼叫報 "RPC 伺服器不可用"
排查:
1. Worker 已內建自動釋放(每次操作後呼叫 release_wps)
2. 手動清理:工作管理員 → 結束 kwps.exe
3. 避免頻繁建立/銷燬 Worker,使用 stdin/stdout 協議
症狀:純Python模式不支援新增幻燈片
排查:
1. 新增幻燈片、插入內容、主題應用僅 WPS 支援
2. 替代方案:用 pure_create_ppt 建立時指定 slides_content 一次生成多頁
3. 或安裝 WPS Office
症狀:讀取含公式的單元格返回 None
排查:
1. openpyxl 預設讀取快取值(data_only=True)
2. 如果從未在 Excel 中開啟計算,快取值為 None
3. 解決:先在 WPS 中開啟儲存一次,或改用公式計算
症狀:排序結果不對
排查:
1. 確保第一行是表頭(不參與排序)
2. 列名引數 column 需與表頭完全一致(區分大小寫)
3. 多列排序時注意優先順序順序
症狀:篩選條件正確但返回空
排查:
1. 條件 column 值需與表頭完全一致
2. 數值比較時 value 必須是字串("--value": "5000")
3. 檢查是否有隱藏空格,使用 trim
症狀:Word 轉 PDF 報錯
排查:先檢查 LibreOffice 是否加入 PATH;避免中文路徑;確保檔案未損壞
症狀:缺少 python-docx / openpyxl / python-pptx
排查:pip install python-docx openpyxl python-pptx
症狀:首次呼叫需2-3秒
排查:正常!Worker 啟動時檢測硬體和引擎
症狀:純Python能做的MS Office不行
排查:MS Office COM 介面並非全功能,部分自動回退到純Python
症狀:=SUM(1月:12月!B2) 不計算
排查:openpyxl 寫公式不支援 3D 引用,改用 stats 命令或逐 Sheet 運算
症狀:Mac 版 WPS COM 不支援某些操作
排查:回退到純Python模式(WPS_ENGINE=PURE)
症狀:儲存後宏功能失效
排查:openpyxl 不支援宏,xlsm 檔案請用 WPS/MS Office 模式
症狀:WPS 彈窗阻斷自動化
排查:彈窗需手動點選;建議在無人值守時關閉 WPS 彈窗
症狀:PermissionError
排查:關閉佔用檔案的程式(WPS/Excel/Word),等待 3-5 秒後重試
症狀:Windows 預設最大路徑 260 字元
排查:啟用 Windows 長路徑支援,或使用短路徑
不用選!Skill 自動檢測。執行 python scripts/wps_excel.py engine-info 檢視。如果強行切換,可以設定環境變數 WPS_ENGINE=PURE 強制使用純 Python。
| WPS 模式 | 純 Python 模式 | |
|---|---|---|
| 公式計算 | ✅ 自動計算 | ⚠️ 寫入公式,開啟時計算 |
| 圖表 | ✅ 即時預覽 | ✅ 嵌入到 Excel |
| 新增幻燈片 | ✅ 支援 | ❌ 不支援 |
| 記憶體佔用 | 高(幾百 MB) | 低(幾十 MB) |
| 速度 | 快(WPS 最佳化) | 較慢 |
Skill 硬體自適應會自動延長超時(最高 5 倍)。 建議:< 50MB 直接處理;> 50MB 先分片處理(拆分 Sheet/Section)。 批次操作時單次建議 ≤ 50 個檔案。
✅ 能用!安裝 LibreOffice 即可:
bash sudo apt install libreoffice # Ubuntu/Debian支援格式轉換(Word/Excel/PPT → PDF); 公式、排序、篩選、圖表也能用純 Python 模式。
Skill 會自動重試 3 次。如果仍然失敗: 1. 開啟工作管理員 → 結束 WPS 程序 2. 重新執行命令 3. 如果反覆出現,嘗試:
pip install --upgrade pywin32
pip install python-docx openpyxl python-pptx
模板通過程式碼生成,不包含二進位制檔案。安裝依賴後執行:
bash python templates/generate_templates.py --dir ./output即可生成 3 個模板:report_template.docx、budget_template.xlsx、business_ppt_template.pptx
# 單個檔案
python scripts/wps_word.py export --file report.docx --format pdf
# 批次轉換(使用 format_converter.py)
python scripts/format_converter.py batch --input-dir ./docs --input-format docx --output-format pdf
# 檢視所有 Sheet
python scripts/wps_excel.py info --file Sales.xlsx
# 為每個 Sheet 新增資料(逐 Sheet 呼叫)
python scripts/wps_excel.py input --file Sales.xlsx --sheet Q1 --data '[["A",100]]'
python scripts/wps_excel.py input --file Sales.xlsx --sheet Q2 --data '[["B",200]]'
# 新增新 Sheet
python scripts/wps_excel.py add-sheet --file Sales.xlsx --sheet Q4 --headers '["產品","價格"]' --data '[["X",300]]'
純 Python 模式下這些功能 100% 支援。 1. 確保已安裝:
pip install openpyxl2. 檔案不能正在被佔用(關閉 WPS/Excel) 3. 第一行必須是表頭(列名) 4. 列名引數需與表頭完全一致
python scripts/wps_feedback.py email # 開啟郵件客戶端(自動附帶系統資訊)
或直接發郵件到:njskills@agent.qq.com
openpyxl 寫入公式字串,開啟檔案時由 Excel/WPS 計算。 如果需要立即計算,請使用 WPS 模式或 MS Office 模式。
關閉佔用檔案的程式(WPS/Excel/Word),等待 3-5 秒後重試。 或使用自動重試(Skill 已內建 3 次重試)。
- 新增幻燈片(add-slide)
- 幻燈片插入內容(insert)
- 幻燈片主題(theme)
- VBA/宏操作
- 條件格式
替代方案:安裝 WPS Office 或 MS Office 獲取完整功能。
問題:50MB 的 Word 文件操作很慢
策略:
1. 先執行 python scripts/wps_word.py info --file big.docx 檢視大小
2. 如果 > 50MB,分片處理
3. 使用純 Python 模式讀取內容
4. 避免頻繁儲存(每次儲存觸發全量寫入)
問題:每週重複做相同格式的週報
策略:
1. 生成模板:python templates/generate_templates.py --dir ./output
2. 複製模板:copy output\report_template.docx 本週週報.docx
3. 用 edit 命令追加內容
4. 用 format 命令設定格式
5. 用 export 生成 PDF
問題:每月記錄收入支出,手動計算彙總
策略:
1. 生成預算模板:python templates/generate_templates.py --dir ./output
2. 每月用 input 命令錄入資料
3. 彙總 Sheet 含公式自動計算
4. 用 stats 命令驗證資料
問題:需要做專案彙報 PPT
策略:
1. 生成模板:python templates/generate_templates.py --dir ./output
2. 複製模板並修改標題
3. 如有多頁內容,建立時指定 --slides 引數
問題:每週重複做相同格式的報表
策略:
1. 建立模板檔案(含公式和圖表位置)
2. 每週用 input 命令錄入新資料
3. 公式和圖表自動更新
4. 匯出 PDF 分發
問題:12 個月的資料在 12 個 Sheet,需要年度彙總
策略:
1. 用 add-sheet 建立"年度彙總"Sheet
2. 用 stats 命令逐 Sheet 驗證彙總結果
問題:從 1000 條記錄中篩出"銷售額>5000 且 地區=華東"
策略:
python scripts/wps_excel.py filter --file data.xlsx --sheet Q1 \
--conditions '[{"column":"銷售額","op":">","value":"5000"},{"column":"地區","op":"=","value":"華東"}]' \
--logic AND
✅ 篩出符合條件的記錄
問題:20 個檔案需要統一命名規範
策略:
1. 用 document_manager.py 列出所有檔案
2. 批次重新命名(加日期字首)
3. 用 format_converter.py 批次轉換格式
問題:Linux 伺服器上需要把 Word 轉 PDF
策略:
1. 安裝 LibreOffice:sudo apt install libreoffice
2. 引擎自動檢測為 LIBREOFFICE
3. 直接 export --format pdf
問題:每天凌晨自動生成報表
策略:
1. 編寫自動化指令碼(呼叫 wps_excel.py + wps_word.py)
2. 使用 WorkBuddy automation 定時執行
3. 輸出到指定目錄
| ID | 錯誤 | 解決 |
|---|---|---|
| E001 | WPS 未安裝或 COM 註冊失敗 | 安裝 WPS 後重啟電腦 |
| E002 | python-docx 未安裝 | pip install python-docx openpyxl python-pptx |
| E003 | 檔案路徑不存在或無法訪問 | 改用英文路徑或以管理員執行 |
| E004 | 格式轉換失敗(純Python不支援) | 安裝 WPS 或 LibreOffice |
| E005 | 排序/篩選/圖表需要 WPS 模式 | 安裝 WPS 或改用純Python模式 |
| E006 | WPS/LibreOffice 卡住無響應 | 工作管理員結束程序;更新到最新版 |
| E007 | 許可權不足 | 或以管理員執行;檢查檔案只讀屬性 |
| E008 | pywin32 匯入失敗 | pip uninstall pywin32 && pip install pywin32 |
| E009 | Python 版本過低 | 升級到 Python 3.8+ |
| E010 | 當前引擎不支援此功能 | 安裝 WPS 或改用 info 檢視能力矩陣 |
| ID | 錯誤 | 解決 |
|---|---|---|
| E011 | LibreOffice 未安裝 | 下載 LibreOffice 並新增到 PATH |
| E012 | LibreOffice 轉換失敗 | 檢查原始檔是否損壞;避免中文路徑 |
| E013 | 檔案不存在 | 確認路徑正確;未被刪除或移動 |
| E014 | 未知執行時錯誤 | 執行環境自檢 wps_test.py;聯絡反饋 |
| E015 | 不支援的操作或格式 | 輸出格式改為 pdf/txt/html |
| 限制項 | 說明 | 解決方案 |
|---|---|---|
| 檔案大小 | 單檔案 < 50MB 直接處理 | 大檔案先分片處理(硬體自適應自動延長超時) |
| 批次檔案數 | 建議 ≤ 50 個/批 | 超過時分批呼叫 |
| 複雜度 | 透視表/VBA/ActiveX 不支援 | 使用 pandas 或手動處理 |
| 網路檔案 | 不支援 HTTP/URL 下載 | 先手動下載到本地,再呼叫 Skill |
| 併發限制 | 同一時間只能操作同一引擎的一個例項 | 等待上次操作完成再發起 |
| 中文名檔案路徑 | 建議改用英文路徑 | 路徑中避免中文和特殊字元 |
| 即時協作 | 不支援多人同時編輯同一檔案 | 通過手動分發和合並 |
python scripts/wps_word.py create --title "report" --body "正文內容"
python scripts/wps_word.py edit --file "report.docx" --text "新增內容"
python scripts/wps_word.py format --file "report.docx" --font "微軟雅黑" --size 14 --align center --bold --first-indent 0.74
python scripts/wps_word.py export --file "report.docx" --format pdf
python scripts/wps_word.py review --file "合同.docx" --output "合同_審查版.docx"
python scripts/wps_word.py info --file "report.docx"
python scripts/wps_word.py engine-info
python scripts/wps_excel.py create --name "Sales" --sheets "Q1,Q2,Q3"
python scripts/wps_excel.py input --file "Sales.xlsx" --sheet "Q1" --data '[["A",100]]'
python scripts/wps_excel.py formula --file "Sales.xlsx" --sheet "Q1" --cell "C1" --formula "=SUM(A1:B1)"
python scripts/wps_excel.py chart --file "Sales.xlsx" --sheet "Q1" --type bar --data "A1:B10" --title "銷售趨勢"
python scripts/wps_excel.py sort --file "Sales.xlsx" --sheet "Q1" --sorts '[{"column":"Price","ascending":false}]'
python scripts/wps_excel.py filter --file "Sales.xlsx" --sheet "Q1" --conditions '[{"column":"Price","op":">","value":"50"}]' --logic AND
python scripts/wps_excel.py add-sheet --file "Sales.xlsx" --sheet "Q4" --headers '["Product","Price"]' --data '[["X",300]]'
python scripts/wps_excel.py nl-analyze --file "Sales.xlsx" --query "按月份統計銷售額並畫出趨勢圖"
python scripts/wps_excel.py invoice --input "發票.pdf" --output "進賬臺賬.xlsx"
python scripts/wps_excel.py stats --file "Sales.xlsx" --sheet "Q1" --column "B" --type SUM
python scripts/wps_excel.py info --file "Sales.xlsx"
python scripts/wps_excel.py engine-info
python scripts/wps_excel.py check-update
python scripts/wps_ppt.py create --title "Pitch"
python scripts/wps_ppt.py add-slide --file "Pitch.pptx" --title "Intro"
python scripts/wps_ppt.py insert --file "Pitch.pptx" --slide 2 --content "Key points"
python scripts/wps_ppt.py theme --file "Pitch.pptx" --name business_blue
python scripts/wps_ppt.py export --file "Pitch.pptx" --format pdf
python scripts/wps_ppt.py docx-to-ppt --input 報告.docx --output 演示.pptx --title "專案彙報" --theme business
python scripts/wps_ppt.py info --file "Pitch.pptx"
python scripts/wps_ppt.py engine-info
| 功能 | 命令 |
|---|---|
| Word→PPT | python scripts/wps_ppt.py docx-to-ppt --input report.docx --output ppt.pptx |
| NL分析 | python scripts/wps_excel.py nl-analyze --file data.xlsx --query "按月份統計銷售額畫趨勢圖" |
| 合同審查 | python scripts/wps_word.py review --file contract.docx --output 審查版.docx |
| 發票OCR | python scripts/wps_excel.py invoice --input 發票.pdf --output 入賬臺賬.xlsx |
python scripts/excel_analyzer.py profile --file data.xlsx --sheet Sheet1
python scripts/excel_analyzer.py fix-formulas --file data.xlsx --sheet Sheet1
python scripts/excel_analyzer.py pivot --file data.xlsx --sheet Sheet1
python scripts/excel_analyzer.py predict --file data.xlsx --sheet Sheet1 --column 銷售額 --method auto --steps 3
python scripts/excel_analyzer.py nl2formula --query "同比增長率"
python scripts/excel_analyzer.py clean --file data.xlsx --sheet Sheet1
python scripts/excel_analyzer.py hardware
python scripts/long_document.py analyze --file report.docx
python scripts/long_document.py toc --file report.docx --max-level 3 --insert
python scripts/long_document.py header --file report.docx --chapter-in-header --page-number
python scripts/long_document.py numbering --file report.docx --style arabic --max-level 4
python scripts/long_document.py fig-index --file report.docx --insert
python scripts/long_document.py xref --file report.docx
python scripts/long_document.py format --file report.docx --preset thesis
python scripts/long_document.py all --file report.docx --preset thesis --output 排版後.docx
python scripts/long_document.py preview --file report.docx --preset thesis
# 會議紀要生成
python scripts/meeting_minutes.py check # 檢查可用 ASR 引擎
python scripts/meeting_minutes.py transcribe --file audio.wav --method auto
python scripts/meeting_minutes.py generate --file audio.wav --output 紀要.docx
python scripts/meeting_minutes.py batch --input-dir ./audio --output-dir ./docs
# COM 健康檢查
python scripts/com_health.py wps-check # WPS COM 狀態
python scripts/com_health.py ms-check # MS Office COM 狀態
python scripts/com_health.py residuals # 檢測殘留程序
python scripts/com_health.py release-all --force # 強制清理所有
python scripts/com_health.py full-check --json # 完整健康報告
# 通過 wps_word.py 呼叫
python scripts/wps_word.py meeting-minutes --file audio.wav --output 紀要.docx
python scripts/wps_word.py com-health --check full
# Excel 智慧分析(6 命令合併為 1 個 --action 路由)
python scripts/wps_excel.py excel-smart --file data.xlsx --action profile
python scripts/wps_excel.py excel-smart --file data.xlsx --action fix-formulas
python scripts/wps_excel.py excel-smart --file data.xlsx --action pivot
python scripts/wps_excel.py excel-smart --file data.xlsx --action predict --column 銷售額 --method auto --steps 3
python scripts/wps_excel.py excel-smart --file data.xlsx --action nl2formula --query "同比增長率"
python scripts/wps_excel.py excel-smart --file data.xlsx --action clean
python scripts/wps_excel.py excel-smart --file data.xlsx --action hardware
# 資料圖表生成器
python scripts/wps_excel.py chart-gen --file data.xlsx --action auto # 一鍵分析+推薦+生成
python scripts/wps_excel.py chart-gen --file data.xlsx --action analyze # 僅分析資料特徵
python scripts/wps_excel.py chart-gen --file data.xlsx --action recommend # 僅推薦圖表型別
python scripts/wps_excel.py chart-gen --file data.xlsx --action generate --type line # 生成指定圖表
# 文件翻譯
python scripts/wps_word.py translate --file report.docx --output 報告_zh.docx --source en --target zh
python scripts/wps_word.py translate --input-dir ./docs --output-dir ./translated --source en --target zh
python scripts/document_translator.py translate --file report.docx --output 報告_zh.docx
python scripts/document_translator.py batch --input-dir ./docs --output-dir ./translated
python scripts/document_translator.py check # 檢查可用翻譯引擎
python scripts/wps_test.py # 環境自檢(人類可讀)
python scripts/wps_test.py --json # 環境自檢(JSON 格式)
python scripts/wps_feedback.py page # 開啟反饋頁面
python scripts/wps_feedback.py email # 開啟郵件客戶端
python scripts/wps_update.py --force # 強制檢查更新
python scripts/wps_toc.py insert --file "report.docx" # 插入目錄
python scripts/format_converter.py batch --input-dir "D:\Reports" --input-format docx --output-format pdf # 批次轉換
python templates/generate_templates.py --dir ./output # 生成模板
| Python | WPS Office | LibreOffice | Windows | macOS | Linux | 狀態 |
|---|---|---|---|---|---|---|
| 3.8+ | 2019+ | - | ✅ | ⚠️ | ❌ | 基礎 |
| 3.8+ | 365 | - | ✅ | ✅ | ❌ | 最佳 |
| 3.8+ | - | 7.0+ | ✅ | ✅ | ✅ | 跨平臺推薦 |
| 3.8+ | - | - | ✅ | ✅ | ✅ | 純Python |
⚠️ = 部分功能受限(純Python模式),❌ = 對應引擎不可用
✅ 四道防線保障安全:
1. 引擎自檢:啟動時自動檢測可用引擎,崩潰自動重啟
2. 路徑校驗:safe_path() 全面校驗,拒絕非法路徑和特殊字元
3. 錯誤中文化:所有錯誤 ID 提供詳細中文說明和操作步驟
4. 資料零上傳:所有處理在本地完成,不上傳任何內容到網際網路
📝 注意事項:
- 批次操作時,桌面會建立 WPS_Backup 資料夾儲存副本
- macOS 上 WPS 不支援所有功能
- 純 Python 模式下格式設定有限,複雜排版建議安裝 WPS
- 所有檔案操作在本地進行,不會聯網
- LibreOffice Headless 模式下不支援即時預覽
- Skill 每 7 天自動檢查更新,不會頻繁打擾
- 模板為純程式碼生成,不包含二進位制檔案,更安全可靠
| 版本 | 日期 | 本次更新 |
|---|---|---|
| v4.6.1 | 2026-08-16 | 修復:ASR 引擎改為顯式 Opt-in 模式(auto 僅使用本地 whisper-local,不讀取外部憑證);修復:Azure/Google STT 僅在 method 顯式指定時呼叫,首次使用顯示憑證讀取範圍警告;修復:LLM 翻譯改為顯式 Opt-in 模式(auto 僅使用 local-rule,不讀取 API Key);修復:外部 SDK 依賴(google-cloud-speech / azure-cognitiveservices-speech)補充宣告至 requirements.txt |
| v4.6.0 | 2026-08-16 | 增加:Excel 智慧分析統一入口 excel-smart(6 命令合併為 1 個 --action 路由);增加:資料圖表生成器 chart_recommender.py(資料特徵分析 + 智慧圖表推薦 + 圖表嵌入 Excel);增加:文件翻譯模組 document_translator.py(Word/Excel/PPT 多格式翻譯 + 多模型降級鏈);增加:翻譯引擎降級鏈(cn-llm-router → local-rule → pure-template);增加:圖表推薦規則引擎(時間序列/類別對比/相關性/多變數);增加:硬體自適應(低配停用複雜圖表渲染);增加:術語表支援(JSON 格式可配置) |
| v4.5.0 | 2026-08-05 | 增加:會議紀要生成模組 meeting_minutes.py(ASR 轉寫 → LLM 摘要 → Word 生成);增加:ASR 降級鏈(whisper-local → azure-speech → google-stt → template);增加:LLM 降級鏈(rule-engine → external-llm → pure-template);增加:COM 健康檢查模組 com_health.py(WPS/MS COM 狀態檢測 + 殘留程序檢測 + 自動釋放);增加:6 個 CLI 子命令(transcribe/summarize/generate/batch/wps-check/ms-check/residuals/release-all/full-check);合併:避坑指南 20+ 條 + FAQ 15 個 + 錯誤 ID 15 個 → 統一故障排除大章(含統一索引表);增加:音訊分段處理(預設 5 分鐘/段)+ 進度回撥;增加:硬體自適應(低配停用並行轉寫) |
| v4.4.0 | 2026-07-30 | 增加:長文件排版自動化模組 long_document.py(自動目錄生成/頁首頁尾自動化/標題編號自動化/圖表索引自動化/交叉引用自動化/格式統一/批次排版);增加:8 個 CLI 子命令(analyze/toc/header/numbering/fig-index/xref/format/all/preview);增加:多級標題編號引擎(支援中文/阿拉伯/羅馬數字三種樣式);增加:圖表索引自動生成(圖 1-1 xxx / 表 1-1 xxx);增加:交叉引用驗證與自動修復;增加:格式統一預設模板(論文/標書/報告三種風格);增加:效能最佳化(分批處理 + 進度回撥 + 單次儲存) |
| v4.3.0 | 2026-07-23 | 增加:Excel 智慧分析模組 excel_analyzer.py(公式自動糾錯/資料清洗輔助/透視表自動生成/資料預測/NL2Formula 自然語言轉公式/硬體自適應降級);增加:6 個 CLI 子命令(profile/fix-formulas/pivot/predict/nl2formula/clean/hardware);最佳化:資料型別探測演算法(數值/日期/文本自動識別);最佳化:透視表智慧欄位推薦(基於唯一值比例+資料型別);增加:資料質量評分體系(0-100分) |
| v4.1.0 | 2026-07-17 | 增加:PPT智慧生成深度增強模組 ppt_generator.py(多源輸入/演講者備註/動畫建議/配色適配/圖表推薦/排練輔助);增加:4 大工具 CLI 子命令擴充套件(docx-to-ppt/generate/nl-analyze/invoice/review);增加:配色方案自動生成引擎;增加:演講者備註雙模式(模板引擎 + 外部 LLM 可選);最佳化:PPT 生成流程重構為分層架構 |
| v4.0.0 | 2026-07-13 | 增加:Word→PPT一鍵生成;增加:Excel自然語言資料分析;增加:Word合同條款審查標註;增加:Excel發票OCR入賬;增加:4 個專用指令碼(wps_docx_to_ppt/wps_nl_analysis/wps_contract_review/wps_invoice_ocr);增加:Worker 路由擴充套件至 28 個命令 |
| v3.1.0 | 2026-07-07 | 修復:模板安全問題(刪除二進位制檔案,改為純Python程式碼生成);增加:20+避坑指南;增加:FAQ擴充套件到15個;增加:檔案限制速查表 |
| v3.0.0 | 2026-07-07 | 增加:自動重試機制(3次指數退避);增加:硬體自適應(CPU/記憶體動態調整);增加:Skill更新檢查(7天提醒);增加:常見問題FAQ(8個Q&A);增加:CLI引數說明+返回結果示例;增加:反饋郵箱;增加:反模式FAQ(8個常見錯誤);增加:最佳實踐(10個案例);增加:wps_performance.py 效能管理 |
| v2.5.0 | 2026-07-03 | 增加:純Python模式增強(排序/篩選/圖表/公式/統計);增加:文件模板目錄;增加:10個最佳實踐案例;增加:反模式FAQ |
| v2.2.0 | 2026-06-30 | 增加:四引擎智慧識別;增加:LibreOffice Headless 跨平臺兜底;增加:純Python格式設定/表格/圖片插入 |
| v2.1.0 | 2026-06-28 | 增加:目錄生成;增加:環境自檢;增加:反饋入口;增加:錯誤速查手冊 |
| v1.0.0 | 2026-06-28 | 初始版本,三大元件 + 格式轉換 |
這個 Skill 質量很好,功能很全面,能自動識別電腦上的 WPS/MS Office/LibreOffice 來工作,不需要手動配置。它的文件非常詳細,遇到問題基本都能找到解決方法。不過它依賴電腦上安裝了 Office 軟體才能發揮全部功能,部分高階功能(如翻譯、語音轉文字)需要額外配置。使用前建議先執行測試指令碼檢查環境是否正常。總體來說,這是一個穩定可靠、適合辦公場景的自動化工具。