WPS Office 全家桶 v4.8.0 ✅

🏗️ 四引擎智能识别：自动检测用户电脑已安装的软件，按 WPS → MS Office → LibreOffice → 纯Python 顺序选择最合适的引擎 ✨ 纯Python模式增强 v4.8：排序、筛选、图表、公式、统计、条件格式、数据验证、合并单元格、命名区域 — 跨平台全部支持 🔄 自动重试：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 状态检测 + 残留进程清理 🧮 公式解释器 v4.7：Excel 公式 → 自然语言解释（反向 NL2Formula，纯本地实现） 📝 Markdown 转换 v4.7：MD → Word/PPT（保留标题层级，纯本地实现） 📑 长文档排版 v4.7：统一入口 long-document --action（8命令合并），性能优化（分批+单次保存+进度回调） ✉️ 邮件智能回复 v4.8：模板匹配 + LLM 个性化回复（纯本地，多模型降级） 📊 周报/月报生成 v4.8：关键点 → 结构化 Word 报告（模板 + 可选 LLM 润色） 🤖 AI 统一入口 v4.8：wps ai --action 统一 6 大 AI 功能入口 📧 建议反馈：有更好建议？邮箱：njskills@agent.qq.com

🚀 分钟上手

1. 检查环境

python scripts/wps_test.py

2. 查看当前引擎 + 硬件

python scripts/wps_excel.py engine-info

3. 创建文件

python scripts/wps_word.py create --title "测试文档"
python scripts/wps_excel.py create --name "预算表" --sheets "收入,支出"
python scripts/wps_ppt.py create --title "推广方案"

4. 检查更新

python scripts/wps_excel.py check-update

5. 生成模板（代码生成，无二进制文件）

python templates/generate_templates.py --dir ./output

⚡ 硬件自适应

🔧 功能矩阵

✅（回退）= 原生引擎不支持时，自动回退到纯 Python 实现

📂 文档模板（代码生成，零二进制文件）

模板通过纯 Python 代码动态生成，无需分发二进制文件。首次运行需安装 python-docx、openpyxl、python-pptx。

⚠️ 文件限制速查

🔧 故障排除大章（v4.5 合并，统一索引）

统一索引表

🚫 避坑详解（20+ 条）

🥇 高频问题（TOP 10）

❌ 坑 1：WPS 没安装就调用 WPS 功能

症状：win32com.com_error 或 "WPS 未安装"
排查：
  1. 运行 python scripts/wps_excel.py engine-info 检查当前引擎
  2. 如果显示 PURE 或 LIBREOFFICE，说明 WPS 不可用
  3. 安装 WPS Office 2019+ 后重启电脑

❌ 坑 2：纯 Python 模式下写公式，打开 Excel 显示 #NAME?

症状：公式写入后打开显示 #NAME? 错误
排查：
  1. openpyxl 写的是公式字符串，打开时需 Excel/WPS 重新计算
  2. 解决：按 Ctrl+Alt+F9 强制重新计算
  3. 或切换到 WPS 模式自动计算

❌ 坑 3：中文路径编码错误

症状：UnicodeEncodeError 或 FileNotFoundError
排查：
  1. 避免中文路径：D:\docs\report.docx ✅
  2. 路径加引号："D:\中文\报告.docx" ✅
  3. 使用 raw string：r"D:\中文\报告.docx" ✅

❌ 坑 4：大文件内存溢出

症状：MemoryError 或程序卡死
排查：
  1. 先运行 python scripts/wps_word.py info --file big.docx 查看大小
  2. < 50MB 直接处理
  3. > 50MB 拆分处理：分 Sheet/Section
  4. 硬件自适应会自动延长超时

❌ 坑 5：WPS 卡住无响应

症状：操作超时（30s/60s/120s）
排查：
  1. Skill 已自动重试 3 次（等 1s → 2s → 4s）
  2. 仍失败则：任务管理器 → 结束 WPS 进程
  3. 反复出现：pip install --upgrade pywin32

❌ 坑 6：COM 对象残留

症状：第二次调用报 "RPC 服务器不可用"
排查：
  1. Worker 已内置自动释放（每次操作后调用 release_wps）
  2. 手动清理：任务管理器 → 结束 kwps.exe
  3. 避免频繁创建/销毁 Worker，使用 stdin/stdout 协议

❌ 坑 7：PPT 添加幻灯片失败

症状：纯Python模式不支持添加幻灯片
排查：
  1. 添加幻灯片、插入内容、主题应用仅 WPS 支持
  2. 替代方案：用 pure_create_ppt 创建时指定 slides_content 一次生成多页
  3. 或安装 WPS Office

❌ 坑 8：openpyxl 读取公式为 None

症状：读取含公式的单元格返回 None
排查：
  1. openpyxl 默认读取缓存值（data_only=True）
  2. 如果从未在 Excel 中打开计算，缓存值为 None
  3. 解决：先在 WPS 中打开保存一次，或改用公式计算

❌ 坑 9：sort 命令排序错乱

症状：排序结果不对
排查：
  1. 确保第一行是表头（不参与排序）
  2. 列名参数 column 需与表头完全一致（区分大小写）
  3. 多列排序时注意优先级顺序

❌ 坑 10：filter 筛选返回空结果

症状：筛选条件正确但返回空
排查：
  1. 条件 column 值需与表头完全一致
  2. 数值比较时 value 必须是字符串（"--value": "5000"）
  3. 检查是否有隐藏空格，使用 trim

🥈 中频问题

⚠️ 坑 11：LibreOffice 转换失败

症状：Word 转 PDF 报错
排查：先检查 LibreOffice 是否加入 PATH；避免中文路径；确保文件未损坏

⚠️ 坑 12：generate_templates.py 报 ImportError

症状：缺少 python-docx / openpyxl / python-pptx
排查：pip install python-docx openpyxl python-pptx

⚠️ 坑 13：_worker 启颈慢

症状：首次调用需2-3秒
排查：正常！Worker 启动时检测硬件和引擎

⚠️ 坑 14：MS Office 模式下功能缺失

症状：纯Python能做的MS Office不行
排查：MS Office COM 接口并非全功能，部分自动回退到纯Python

⚠️ 坑 15：多 Sheet 引用公式失效

症状：=SUM(1月:12月!B2) 不计算
排查：openpyxl 写公式不支持 3D 引用，改用 stats 命令或逐 Sheet 运算

🥉 低频但重要

⚡ 坑 16：macOS 上 WPS 部分功能不可用

症状：Mac 版 WPS COM 不支持某些操作
排查：回退到纯Python模式（WPS_ENGINE=PURE）

⚡ 坑 17：xlsm 文件宏丢失

症状：保存后宏功能失效
排查：openpyxl 不支持宏，xlsm 文件请用 WPS/MS Office 模式

⚡ 坑 18：批量操作时 WPS 弹出对话框

症状：WPS 弹窗阻断自动化
排查：弹窗需手动点击；建议在无人值守时关闭 WPS 弹窗

⚡ 坑 19：文件被占用

症状：PermissionError
排查：关闭占用文件的程序（WPS/Excel/Word），等待 3-5 秒后重试

⚡ 坑 20：Windows 长路径限制

症状：Windows 默认最大路径 260 字符
排查：启用 Windows 长路径支持，或使用短路径

📋 常见问题 FAQ（Q&A）

Q1：我应该选择哪个引擎？

不用选！Skill 自动检测。运行 python scripts/wps_excel.py engine-info 查看。如果强行切换，可以设置环境变量 WPS_ENGINE=PURE 强制使用纯 Python。

Q2：WPS 版本有要求吗？

• WPS Office 2019+ 或 WPS 365
• 安装后必须重启电脑
• 32/64 位均可

Q3：纯 Python 模式和 WPS 模式有什么区别？

Q4：文件太大怎么办？

Skill 硬件自适应会自动延长超时（最高 5 倍）。 建议：< 50MB 直接处理；> 50MB 先分片处理（拆分 Sheet/Section）。 批量操作时单次建议 ≤ 50 个文件。

Q5：Linux 上能用吗？

✅ 能用！安装 LibreOffice 即可：

> sudo apt install libreoffice  # Ubuntu/Debian
> 

支持格式转换（Word/Excel/PPT → PDF）； 公式、排序、筛选、图表也能用纯 Python 模式。

Q6：WPS 卡住怎么办？

Skill 会自动重试 3 次。如果仍然失败： 1. 打开任务管理器 → 结束 WPS 进程 2. 重新运行命令 3. 如果反复出现，尝试：pip install --upgrade pywin32

Q7：纯 Python 模式如何安装依赖？

pip install python-docx openpyxl python-pptx

Q8：模板文件在哪里？如何获取？

模板通过代码生成，不包含二进制文件。安装依赖后运行：

> python templates/generate_templates.py --dir ./output
> 

即可生成 3 个模板：report_template.docx、budget_template.xlsx、business_ppt_template.pptx

Q9：如何批量转换格式？

# 单个文件
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

Q10：如何同时处理多个 Sheet？

# 查看所有 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]]'

Q11：排序/筛选/图表操作总是失败？

纯 Python 模式下这些功能 100% 支持。 1. 确保已安装：pip install openpyxl 2. 文件不能正在被占用（关闭 WPS/Excel） 3. 第一行必须是表头（列名） 4. 列名参数需与表头完全一致

Q12：如何提交反馈？

python scripts/wps_feedback.py email  # 打开邮件客户端（自动附带系统信息）

或直接发邮件到：njskills@agent.qq.com

Q13：纯 Python 模式下公式何时计算？

openpyxl 写入公式字符串，打开文件时由 Excel/WPS 计算。 如果需要立即计算，请使用 WPS 模式或 MS Office 模式。

Q14：文件被占用怎么办？

关闭占用文件的程序（WPS/Excel/Word），等待 3-5 秒后重试。 或使用自动重试（Skill 已内置 3 次重试）。

Q15：哪些功能在纯 Python 模式下不可用？

v4.8 新增条件格式、数据验证、合并单元格、命名区域支持，纯Python模式覆盖度显著提升。

- 添加幻灯片（add-slide） - 幻灯片插入内容（insert） - 幻灯片主题（theme） - VBA/宏操作 替代方案：安装 WPS Office 或 MS Office 获取完整功能。

🏆 最佳实践（10 个案例）

BP-1：大文件处理策略

问题：50MB 的 Word 文档操作很慢
策略：
  1. 先运行 python scripts/wps_word.py info --file big.docx 查看大小
  2. 如果 > 50MB，分片处理
  3. 使用纯 Python 模式读取内容
  4. 避免频繁保存（每次保存触发全量写入）

BP-2：周报自动化

问题：每周重复做相同格式的周报
策略：
  1. 生成模板：python templates/generate_templates.py --dir ./output
  2. 复制模板：copy output\report_template.docx 本周周报.docx
  3. 用 edit 命令追加内容
  4. 用 format 命令设置格式
  5. 用 export 生成 PDF

BP-3：预算跟踪自动化

问题：每月记录收入支出，手动计算汇总
策略：
  1. 生成预算模板：python templates/generate_templates.py --dir ./output
  2. 每月用 input 命令录入数据
  3. 汇总 Sheet 含公式自动计算
  4. 用 stats 命令验证数据

BP-4：商务PPT快速制作

问题：需要做项目汇报 PPT
策略：
  1. 生成模板：python templates/generate_templates.py --dir ./output
  2. 复制模板并修改标题
  3. 如有多页内容，创建时指定 --slides 参数

BP-5：数据报表自动化

问题：每周重复做相同格式的报表
策略：
  1. 创建模板文件（含公式和图表位置）
  2. 每周用 input 命令录入新数据
  3. 公式和图表自动更新
  4. 导出 PDF 分发

BP-6：多 Sheet 数据汇总

问题：12 个月的数据在 12 个 Sheet，需要年度汇总
策略：
  1. 用 add-sheet 创建"年度汇总"Sheet
  2. 用 stats 命令逐 Sheet 验证汇总结果

BP-7：条件筛选导出

问题：从 1000 条记录中筛出"销售额>5000 且 地区=华东"
策略：
  python scripts/wps_excel.py filter --file data.xlsx --sheet Q1 \
    --conditions '[{"column":"销售额","op":">","value":"5000"},{"column":"地区","op":"=","value":"华东"}]' \
    --logic AND
  ✅ 筛出符合条件的记录

BP-8：批量文件重命名

问题：20 个文件需要统一命名规范
策略：
  1. 用 document_manager.py 列出所有文件
  2. 批量重命名（加日期前缀）
  3. 用 format_converter.py 批量转换格式

BP-9：跨平台文档转换

问题：Linux 服务器上需要把 Word 转 PDF
策略：
  1. 安装 LibreOffice：sudo apt install libreoffice
  2. 引擎自动检测为 LIBREOFFICE
  3. 直接 export --format pdf

BP-10：定时自动化

问题：每天凌晨自动生成报表
策略：
  1. 编写自动化脚本（调用 wps_excel.py + wps_word.py）
  2. 使用 WorkBuddy automation 定时执行
  3. 输出到指定目录

🚨 错误速查手册 v3.1（15个错误ID）

E001-E010：用户可自助解决

E011-E015：需要进一步排查

⚠️ 能力边界说明

🔗 CLI 参数速查

Word

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_word.py md-convert --file "README.md" --format docx --output "文档.docx"
python scripts/wps_word.py md-convert --file "README.md" --format pptx --output "演示.pptx"
python scripts/wps_word.py long-document --file "report.docx" --action all --preset thesis

Excel

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_excel.py formula-explain --formula "=SUM(A1:A10)"
python scripts/wps_excel.py formula-explain --file "data.xlsx" --cell "B2"
python scripts/wps_excel.py formula-explain --file "data.xlsx" --sheet "Sheet1"

PPT

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

🆕 v4.0 新命令（详见下方各组件）

🆕 v4.3 Excel 深度分析命令

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

🆕 v4.4 长文档排版命令（已升级为 v4.7 统一入口）

v4.7 起，长文档排版 8 个命令合并为 wps_word.py long-document --action 统一入口，降低记忆成本。

# 新统一入口（推荐）
python scripts/wps_word.py long-document --file report.docx --action all --preset thesis

# 旧命令仍可通过 long_document.py 调用（兼容）
python scripts/long_document.py all --file report.docx --preset thesis --output 排版后.docx

🆕 v4.5 会议纪要 + COM 健康命令

# 会议纪要生成
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

🆕 v4.6 Excel 智能分析 + 数据图表 + 文档翻译

# 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                                  # 检查可用翻译引擎

🆕 v4.7 公式解释器 + Markdown 转换 + 长文档统一入口

# 公式解释器（反向 NL2Formula，纯本地实现）
python scripts/wps_excel.py formula-explain --formula "=SUM(A1:A10)"
python scripts/wps_excel.py formula-explain --file data.xlsx --cell B2
python scripts/wps_excel.py formula-explain --file data.xlsx --sheet Sheet1

# Markdown → Word/PPT
python scripts/wps_word.py md-convert --file README.md --format docx --output 文档.docx
python scripts/wps_word.py md-convert --file README.md --format pptx --output 演示.pptx
python scripts/wps_word.py md-convert --dir ./docs --format docx --output-dir ./output

# 长文档排版统一入口（8 命令合并为 1 个 --action 路由）
python scripts/wps_word.py long-document --file report.docx --action analyze
python scripts/wps_word.py long-document --file report.docx --action toc --max-level 3 --insert
python scripts/wps_word.py long-document --file report.docx --action header --chapter-in-header --page-number
python scripts/wps_word.py long-document --file report.docx --action numbering --style arabic --max-level 4
python scripts/wps_word.py long-document --file report.docx --action fig-index --insert
python scripts/wps_word.py long-document --file report.docx --action xref
python scripts/wps_word.py long-document --file report.docx --action format --preset thesis
python scripts/wps_word.py long-document --file report.docx --action all --preset thesis --output 排版后.docx
python scripts/wps_word.py long-document --file report.docx --action preview --preset thesis

🆕 v4.8 邮件智能回复 + 周报月报 + 纯Python增强 + AI统一入口

# 邮件智能回复（模板匹配 + 可选 LLM 个性化）
python scripts/wps_word.py email-reply --content "已收到您的来信，关于项目进度..." --tone polite
python scripts/wps_word.py email-reply --content "请查收附件" --tone formal --output 回复.docx
python scripts/email_reply.py reply --content "谢谢" --tone friendly
python scripts/email_reply.py batch --input-dir ./emails --output-dir ./replies

# 周报/月报自动生成
python scripts/wps_word.py report --type weekly --points "完成需求A,修复Bug B,启动项目C"
python scripts/wps_word.py report --type monthly --points "上线v2.0,培训3场,客户拜访5家" --output 月报.docx
python scripts/report_generator.py generate --type weekly --points "完成A,B,C" --output 周报.docx

# 纯 Python 模式增强（条件格式/数据验证/合并单元格/命名区域）
python scripts/wps_excel.py cond-format --file data.xlsx --sheet Sheet1 --range A1:A100 --type color-scale
python scripts/wps_excel.py data-validation --file data.xlsx --sheet Sheet1 --range B1:B100 --list "是,否"
python scripts/wps_excel.py merge-cells --file data.xlsx --sheet Sheet1 --range A1:D1
python scripts/wps_excel.py named-range --file data.xlsx --name "销售数据" --range A1:D100

# AI 统一入口（wps ai --action）
python scripts/wps_ai.py --action email-reply --content "已收到" --tone polite
python scripts/wps_ai.py --action report --type weekly --points "完成A,B,C"
python scripts/wps_ai.py --action meeting --file audio.wav --output 纪要.docx
python scripts/wps_ai.py --action contract --file 合同.docx --output 审查版.docx
python scripts/wps_ai.py --action translate --file report.docx --output 报告_zh.docx
python scripts/wps_ai.py --action formula --formula "=SUM(A1:A10)"

其他工具

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模式），❌ = 对应引擎不可用

⚠️ 安全须知

✅ 五道防线保障安全：

1. 引擎自检：启动时自动检测可用引擎，崩溃自动重启
2. 路径校验：safe_path() 全面校验，拒绝非法路径和特殊字符
3. 错误中文化：所有错误 ID 提供详细中文说明和操作步骤
4. 数据零上传：所有处理在本地完成，不上传任何内容到互联网
5. 显式 Opt-in（v4.6.1 引入）：外部服务（ASR/LLM）仅在用户显式指定 method 时调用，auto 模式仅使用本地引擎

📝 注意事项：

• 批量操作时，桌面会创建 WPS_Backup 文件夹保存副本
• macOS 上 WPS 不支持所有功能
• 纯 Python 模式下格式设置有限，复杂排版建议安装 WPS
• 所有文件操作在本地进行，不会联网
• LibreOffice Headless 模式下不支持实时预览
• Skill 每 7 天自动检查更新，不会频繁打扰
• 模板为纯代码生成，不包含二进制文件，更安全可靠
• v4.7 新增公式解释器、MD 转换均为纯本地实现，不读取外部凭证或 API Key

更新日志