办公文档处理三件套，本地处理 Word（生成/保真替换/批量替换/转纯文本）、Excel（读取/统计/报表/合并）、PDF（合并/拆分/提取文字/加页码/加密/解密）。基于 python-docx / openpyxl / PyPDF2，无需 API key，纯本地运行数据不上传。面向日常办公人群。
slug: office-doc-suite displayName: 办公文档三件套（Word/Excel/PDF） version: 1.2.1 description: 办公文档处理三件套 Skill。本地处理 Word（生成/保真替换/批量替换/转纯文本）、Excel（读取/统计/报表/合并）、PDF（合并/拆分/提取文字/加页码/加密/解密）。基于 python-docx / openpyxl / PyPDF2，无需 API key，纯本地运行数据不上传，异常时给出中文修复提示。面向日常办公、报告制作、数据整理人群。 homepage: https://github.com/zhaoheng588-tech/ai-skills-collection/skills/office-doc-suite license: MIT tags: [ai-skill]
Office Doc Suite - 办公文档处理三件套
本地处理 Word、Excel、PDF 三大办公文档类型。对标站内 Word/DOCX（18万下载）、Excel/XLSX（17万）、Nano PDF（12万）——本套件三合一 + 中文场景适配。
环境要求
```bash pip install python-docx openpyxl PyPDF2 # 必需（Word/Excel/PDF 核心功能） pip install pycryptodome # 可选（PDF 解密 AES 加密文件需要） pip install pymupdf # 可选（仅「PDF 加页码」需要） ```
使用方式
本 Skill 通过 Python 脚本执行具体任务（scripts/ 下），SKILL.md 提供任务路由：
Word 处理（python-docx）
- 生成文档：从内容生成 docx（标题/正文/表格） - 保真替换：替换文字并保留原格式（不破坏样式） - 批量替换：一次替换多组文字（旧1=>新1|旧2=>新2） - 转纯文本：提取文档文字（含表格）为 txt - 脚本：`python scripts/docx_tool.py` - 命令示例： - `python scripts/docx_tool.py create out.docx -title "周报" -body "内容1|内容2" -table "A,B|1,2"` - `python scripts/docx_tool.py replace in.docx -o out.docx -find "旧" -replace "新"` - `python scripts/docx_tool.py replace-batch in.docx -pairs "旧1=>新1|旧2=>新2"` - `python scripts/docx_tool.py totext in.docx -o out.txt`Excel 处理（openpyxl）
- 读取：查看数据、工作表信息 - 统计：指定列求和/平均/最大/最小 - 报表：生成带合计的报表（列筛选） - 合并：多文件合并（自动去重表头） - 脚本：`python scripts/xlsx_tool.py` - 命令示例： - `python scripts/xlsx_tool.py read data.xlsx` - `python scripts/xlsx_tool.py stats data.xlsx -col 销售额` - `python scripts/xlsx_tool.py report data.xlsx -o report.xlsx -sum 销售额` - `python scripts/xlsx_tool.py merge a.xlsx b.xlsx -o merged.xlsx`PDF 处理（PyPDF2 + PyMuPDF）
- 合并/拆分：多 PDF 合并、按页拆分 - 提取：文字提取（支持指定页范围，如 1-3,5） - 加页码：为每页添加页码（需 `pip install pymupdf`） - 加密/解密：设置或移除密码 - 信息：页数/元数据/加密状态 - 脚本：`python scripts/pdf_tool.py` - 命令示例： - `python scripts/pdf_tool.py merge 1.pdf 2.pdf -o out.pdf` - `python scripts/pdf_tool.py split in.pdf -pages 1-3,5` - `python scripts/pdf_tool.py extract in.pdf -o out.txt -pages 1-3` - `python scripts/pdf_tool.py page-num in.pdf -o out.pdf` - `python scripts/pdf_tool.py decrypt in.pdf -o out.pdf -pwd 密码`任务路由（AI 判断用哪个工具）
| 用户需求 | 工具 | 示例指令 |
|---|---|---|
| 做/改 Word 文档 | docx_tool.py | "把周报模板填上数据生成 docx" |
| 处理表格/报表 | xlsx_tool.py | "合并 3 个 Excel 计算部门汇总" |
| 合并/拆分/提取 PDF | pdf_tool.py | "把这 5 个 PDF 合成一个" |
真实场景示例（照着做）
场景 1：把 5 份 PDF 合成一份，并加页码 ```bash python scripts/pdf_tool.py merge a.pdf b.pdf c.pdf d.pdf e.pdf -o 合并.pdf python scripts/pdf_tool.py page-num 合并.pdf -o 合并-带页码.pdf ```
场景 2：每周报表汇总（合并 4 个部门 Excel + 统计销售额） ```bash python scripts/xlsx_tool.py merge 华东.xlsx 华南.xlsx 华北.xlsx 华中.xlsx -o 汇总.xlsx python scripts/xlsx_tool.py stats 汇总.xlsx -col 销售额 python scripts/xlsx_tool.py report 汇总.xlsx -o 报表.xlsx -sum 销售额 ```
场景 3：批量替换周报模板里的占位文字 ```bash python scripts/docx_tool.py replace-batch 周报模板.docx -o 本周周报.docx -pairs "【姓名】=>张三|【部门】=>市场部|【日期】=>2026-08-16" ```
直接提问模板（复制即可用）
> 帮我处理这个 Word/Excel/PDF：<文件路径>，需求是 <具体操作>。
异常处理（遇到问题时）
| 情况 | 正确处理 |
|---|---|
| 文件路径无效 | 脚本会提示"文件不存在 + 当前目录"，请用完整路径重试 |
| 依赖未安装 | 提示 `pip install python-docx openpyxl PyPDF2`，装完重试 |
| 文件损坏/加密 | PDF 提示先解密；docx/xlsx 提示另存为 .docx/.xlsx 格式 |
| 旧版 .doc/.xls 文件 | 不支持，请先在 Word/Excel 里另存为 .docx/.xlsx |
| 文件被占用 | 关闭 WPS/Word/Excel 后再运行 |
| 权限不足 | 提示无读取/写入权限，换目录或检查权限 |
| 页码/路径写错 | 提示正确格式（如 `1-3,5`、完整路径） |
不适用场景（诚实说明）
- 不处理他人版权文档（仅个人合法使用） - 不自动删除/覆盖原文件（所有操作输出到新文件） - 不支持旧版 .doc/.xls 格式（需先另存为 .docx/.xlsx） - 不支持复杂排版（艺术字、复杂图表、专业排版建议用专业软件） - 扫描件 PDF 需 OCR 工具（本套件不含 OCR，可配 skill-pdf-ocr 使用） - PDF 加页码为简单页脚文本，不支持复杂页眉页脚样式
FAQ（常见问题）
Q：要装什么依赖？ `pip install python-docx openpyxl PyPDF2`（必需）；`pip install pycryptodome`（PDF 解密 AES 加密文件需要）；`pip install pymupdf`（仅 PDF 加页码需要）。
Q：能批量处理吗？ 能。Word 批量替换、Excel 多文件合并、PDF 多文件合并都支持。
Q：会破坏原文件吗？ 不会。所有操作输出到新文件，原文件保持不变。
Q：旧版 .doc / .xls 文件能处理吗？ 不能，请先在 Word/Excel 里另存为 .docx/.xlsx 再处理。
Q：报错看不懂怎么办？ v1.2 起所有脚本用中文提示错误原因和修复建议（路径/权限/格式/占用等）。
Q：能把 PDF 转成图片吗？ 不支持。本套件专注文字提取/合并/拆分/加密；PDF 转图片需图像处理工具。
Q：提取 PDF 能只提取某几页吗？ 能。`extract in.pdf -pages 1-3,5` 只提取指定页。
Q：PDF 加密/解密需要额外依赖吗？ 解密 AES 加密的 PDF 需要 `pip install pycryptodome`；简单密码加密（RC4）PyPDF2 自带支持。
核心原则
1. 本地运行：数据不上传（隐私卖点，对标云文档） 2. 保真处理：不破坏原文件格式/内容，必要时先备份 3. 可重复：输出操作日志，用户知道改了什么 4. 中文适配：中文字体/编码/格式优先（竞品偏英文生态）
合规声明
- 仅处理用户提供的文档，不采集/上传任何数据 - 涉及版权内容（他人 PDF/文档）仅限个人合法使用
来源：GitHub https://github.com/zhaoheng588-tech/ai-skills-collection