核心用法
doc-processor 是一款面向本地环境的智能文档处理引擎，采用"样式感知+三层模板+动态分类"架构，覆盖文档全生命周期管理。核心功能包括：
读写操作：支持 Word(.docx)、Excel(.xlsx)、PDF、CSV、TXT、Markdown 六种格式的读取与写入，其中 PDF 仅支持读取/提取，不支持写入。
格式转换：实现跨格式无损转换，如 Word↔CSV、Excel↔Word、PDF→文本等，转换过程保留表格结构与原样式。
批量处理：v2.5 起支持批量文档合并，Word 支持多文件拼接，Excel 支持多文件→多 Sheet 整合。
智能提取：可针对性提取表格数据、指定 Sheet、段落内容等，支持通过 --options 参数限定处理范围以优化大文件性能。
模板填充：v2.3 引入智能化模板匹配，支持 JSON 数据驱动生成结构化文档。
显著优点
1. 本地优先架构：所有处理在本地完成，无需上传云端，敏感数据不外流
2. 多源安装支持：提供 Homebrew、apt 及脚本三种安装方式，适配中国大陆网络环境（内置清华/中科大镜像源）
3. 渐进式功能迭代：从 v1.0 到 v2.7 持续优化，日志系统、性能监控、错误增强机制完善
4. Python API 友好：提供类库级调用接口，便于集成至现有 Python 工作流
潜在局限
- 格式限制：明确不支持旧版 .doc/.xls（需 LibreOffice 预转换）
- PDF 单向：无法生成 PDF，仅支持读取与文本提取
- 系统依赖：依赖 poppler-utils 等外部二进制工具，Windows 支持未明确说明
- 性能瓶颈：大文件处理需手动分页，缺乏流式处理机制
适合人群
- 企业自动化办公开发者
- 需要将 Excel/Word 数据互通的财务/运营人员
- 注重数据隐私、拒绝云服务的本地化优先用户
- Python 技术栈的 RPA/ETL 工程师
常规风险
- 依赖失效风险：poppler-utils 等系统包版本变动可能导致 PDF 功能异常
- 路径处理问题：v1.0.4 前版本存在 Word 合并时相对路径解析 Bug
- 编码兼容性：中文环境下需确保模板文件 UTF-8 编码一致
- 无权限隔离：作为本地工具，缺乏细粒度权限控制，多用户环境需注意文件访问安全