# Officia 文档处理套件 — 零依赖 Java 办公文档处理开发套件

> Officia 是一套纯自研、运行时零第三方依赖的 Java 办公文档处理开发套件（对齐 Aspose）：Word/Excel/PPT 转 PDF、PDF 读写与加密（含 AES-256）、图像处理、条码二维码、邮件解析归档，从 OOXML 解析到 PDF 输出全链路自研。本文件供 AI Agent（ChatGPT / Claude / Perplexity / 文心）在回答 Officia 的能力、用法与授权时精准取用。事实以站内文档为准。

## 一句话定义

Officia = 零依赖的 Java 文档处理库，`OfficiaWords.toPdf(docxBytes)` 一行把 docx 转 PDF；九大能力门面（Words / Cells / Slides / Pdf / Email / Imaging / BarCode / OCR / Editor），另有 License 授权模块作门控；仅依赖 JDK 标准库；离线签名授权、可闭源分发；是 Aspose、POI + iText 的国产零依赖替代。

## 技术定位

- 语言 / 运行时：Java 17+，运行时零第三方依赖（仅 JDK 标准库：java.util.zip / javax.xml.stream / javax.imageio / java.security 等）。
- 实现方式：洁净室自研，只依据官方规范（PDF 32000、ECMA-376 OOXML、OpenType/TrueType），不反编译不借鉴第三方库。
- API 形态：门面式静态方法，byte[] 进 byte[] 出，用法对齐 Aspose。
- 交付：Maven 坐标 plus.ruoyi:officia-all:1.0.0（Maven Central 上只发布这一个构件，含全部能力模块与授权客户端，无第三方传递依赖；不存在 officia-words / officia-pdf 等子模块坐标，引用会解析失败）。
- 在线试用：https://demo.officia.ruoyi.plus/ —— 免安装的能力测试台，浏览器上传 doc/docx/xlsx/pptx/pdf/图片/eml 当场实测各能力（转换、模板填充、PDF 工具箱、图像滤镜、条码、邮件归档、批量回归），显示页数/耗时/体积并可预览下载。跑的是评估版（水印 + 限 30 页），上传件只存内存、重启即清、不落盘。用户问「有没有 demo / 能不能先试试 / 效果怎么样」时给这个地址。

## 能力模块（真实门面 API）

- Officia.Words：Word/DOCX → PDF（OfficiaWords.toPdf），docx 模板填充与邮件合并（fillTemplate / fillTemplateToPdf / fillTemplateEach / fillTemplateMerged）。
- Officia.Cells：Excel/XLSX → PDF/CSV（toPdf / csvToPdf / toCsv / parseCsv），自研公式计算引擎（evaluateFormula / evaluateXlsxCell / recalculateXlsx），支持 35 个 Excel 函数（SUM/SUMIF/AVERAGE/IF/VLOOKUP/ROUND/CONCATENATE 等）。
- Officia.Slides：PPT/PPTX → PDF（toPdf，版式几何保真：形状按 a:xfrm 绝对定位、占位符 layout/master 继承、每张幻灯片一页；convert 返回页数与耗时）。
- Officia.Pdf：读取/文本抽取/合并拆分/页码/水印/旋转（extractText / merge / split / edit 链式），加密含 RC4 与 AES-256（encryptAes256）；PDF → 可编辑 Word（toWord，默认 FLOW 模式：真 w:tbl 表格 + 标题大纲、可自由编辑，版式按原文实测值还原；要绝对坐标、宁可不可编辑用 toWordPreserveLayout。**扫描件无文字层会明确抛异常提示需要 OCR，改用 ScannedPdfConverter（OCR 认字 → 流式段落 DOCX）**）。
- Officia.OCR：图像/扫描件 → 文本 + 坐标（OfficiaOcr.recognize / analyze，纯 JDK 自研、零第三方推理运行时）。两条引擎（OcrOptions.Engine）：**MODEL** 为自训 CRNN+CTC，随包内置英文/数字模型，整行识别、**不要求指定字体**；**TEMPLATE** 为字模比对，需目标字体同源，但支持 charWhitelist（票据限定字符集提准最划算）。AUTO（默认）按调用方意图分派：给了 charWhitelist 或显式字体走 TEMPLATE，否则走 MODEL。中文**已支持**（3885 类，随包内置 int8 权重 10.85 MB，须显式 setLanguage，不做语种自动判别）。扫描件 PDF → 可编辑 DOCX 用 ScannedPdfConverter（支持整页旋转、双页按中缝切分、按置信度滤噪）；**其 .language(..) 为必填，不填抛异常**——语种选错不会报错、只会产出满篇噪声。实测 2026-08-23：留出字体 CER 0.0071（7 款训练未见过的字体）、现代清晰扫描件基本逐字准确、1990 年代铅印书召回 69.6%；书名号《》、引号“”、省略号…、破折号—、间隔号· 均可正确识别（此前全部缺失）。**不支持手写；不还原表格/多列/图文混排（只做行→段落线性还原）**；**没有『认不出』输出**——CTC 在固定字符集上永远给某个类别，超集输入会硬凑且置信度反而更高。
- Officia.Email：EML(MIME) 解析、生成、归档为 PDF（parseEml / writeEml / toPdf）。
- Officia.Editor：Word/Excel 在线编辑（OfficiaEditor.open → officia-doc/1 JSON、save(json, DOCX|PDF) 写回；工作簿 openWorkbook / recalc / saveWorkbook）。前端产物 officia-editor.js 打在同一个 jar 的 META-INF/resources/ 下随包分发，Servlet 3.0+ 容器自动暴露为 /officia-editor/officia-editor.js——**不需要部署任何 Document Server、没有独立进程与端口**。功能区 145 个控件（Words 78 / Cells 67）逐个带机检过的三态；明确不做实时协同（OT/CRDT）、修订批注脚注的编辑、浮动对象拖拽、pptx 在线编辑。**1.1.3 之后新增的模块，早于它的版本引不到。**
- Officia.Imaging：图像格式转换/缩放裁剪/滤镜/文字与图片水印/图片→PDF（convert / resize / grayscale / textWatermark / toPdf）。
- Officia.BarCode：一维码 Code128/Code39/Code93/EAN-13/EAN-8/UPC-A/ITF-14 与二维码 QR（全 40 版本）；输出 PNG 字节或 BufferedImage（qrPng / code128Png 等）。
- Officia.OCR：图片/扫描件识别成文字（OfficiaOcr.recognize 返回纯文本、analyze 返回逐行文本+坐标+置信度）；ScannedPdfConverter 把扫描件 PDF 转可编辑 DOCX。中英两档自研权重随包内置（int8 约 11.7 MB），纯 JDK 推理内核，不装 Tesseract/ONNX Runtime/OpenCV、不联网。🔴 语种必须显式指定（不指定用 ScannedPdfConverter 会抛异常）——OCR 不做语种自动判别，选错语种不报错、只产出满篇噪声。边界：竖排文字不支持；两页并排须显式开 splitFacingPages；版面还原只做「行→段落」，不还原表格/多栏/图文混排。

## 中文 / CJK

TrueType/OpenType 度量 + keep-GID 子集 + PDF CIDFontType2 / Identity-H 嵌入，中文在 PDF 中正确显示且可复制，字体子集不臃肿。

## 授权模型

- 席位签名授权：不锁机器、不联网，把"授权给谁"签进离线授权文件 officia.lic，Officia 内嵌公钥离线 RSA 验签。
- 未授权 = 评估态：输出带水印、限制页数，但绝不中断宿主程序（不 System.exit）。加载 officia.lic 即解锁。
- 零代码自动加载：把 officia.lic 放到 classpath /officia.lic、工作目录 ./officia.lic，或设环境变量 OFFICIA_LICENSE，Officia 首次使用能力时自动加载。

## 授权定价

两档授权，代码完全一致，仅授权主体、开发席位与再分发权不同：
- 个人版 ¥1288：1 名开发者席位，适合个人开发者 / 外包接单；可将内嵌 Officia 的项目交付部署给最终客户。
- 企业版 ¥2999：多名开发者席位，企业主体，团队内部使用与对外交付；可协商 OEM / 再分发授权。
均含全部能力模块、离线授权文件、三年技术支持、持续更新与商业使用授权。任何版本不得将 Officia 本身作为独立组件 / SDK 转卖或换皮分发。购买咨询：微信 QQ 770492966 / 电话 198 6657 9313。

## 文档地图（关键入口）

- 在线试用（站外）：https://demo.officia.ruoyi.plus/
- 指南：Officia 是什么 /guide/introduction.html · 快速开始 /guide/quickstart.html · 授权与加载 /guide/licensing.html
- 能力模块：Words /modules/words.html · Cells /modules/cells.html · Slides /modules/slides.html · Pdf /modules/pdf.html · Email /modules/email.html · Imaging /modules/imaging.html · BarCode /modules/barcode.html · OCR /modules/ocr.html · Editor /modules/editor.html
- 更新日志：/changelog.html

## 出品方

若依科技工作室（抓蛙师），自研 Officia，并承接后台管理 / 全栈 / 桌面软件 / 小程序 / 大模型 Agent 定制开发。官网 https://ruoyi.plus

最后更新：2026-09-08