【国企项目手记：企业网站后台管理系统富文本编辑器功能扩展开发全记录】
项目负责人：XXX（北京某国企）
日期：2023年X月X日
一、需求分析与技术选型
1. 核心需求梳理
客户要求在企业网站后台管理系统的文章发布模块中扩展以下功能：
- Word粘贴功能：支持从Word复制内容直接粘贴到UEditor，图片自动上传至阿里云OSS（二进制存储），保留表格、字体、颜色等样式。
- 多格式文档导入功能：支持上传Word/Excel/PPT/PDF文档，解析内容并保留图片和样式，图片自动上传至OSS。
- 微信公众号内容粘贴：自动下载公众号文章图片并上传至OSS，避免版权风险。
- 信创兼容性：
- 操作系统：Windows/macOS/Linux（含中标麒麟、银河麒麟、统信UOS等国产系统）。
- 浏览器：IE8+、奇安信安全浏览器、龙芯浏览器、红莲花安全浏览器等。
- CPU架构：x86（Intel/AMD/兆芯/海光）、ARM（鲲鹏/飞腾）、龙芯（MIPS/LoongArch）。
- 授权模式：买断产品源代码，预算≤88万元，满足自主可控及数据安全要求，支持集团1000+项目复用。
2. 技术栈锁定
- 前端：Vue2 CLI + UEditor（百度开源富文本编辑器，需二次开发）。
- 后端：SpringBoot（IntelliJ IDEA开发），MySQL数据库。
- 云存储：阿里云OSS（需SDK集成）。
- 信创环境：通过交叉编译、Polyfill及兼容性测试覆盖国产系统及浏览器。
3. 选型评估
- 富文本编辑器扩展方案：
- UEditor原生插件：
- 优点：开源免费，可自主修改代码。
- 缺点：无现成Word导入插件，需自行开发或集成第三方库（如
mammoth.js、docx.js，但兼容性不足）。
- 商业插件对比：
- TinyMCE Enterprise：支持Word粘贴和样式保留，但授权费超预算（单套$5,000+，源代码买断需谈判）。
- CKEditor 5 Premium：功能匹配，但国产化兼容性存疑（IE8不支持）。
- 国内方案：
- UEditor定制开发：基于开源版本扩展，成本低但需解决复杂文档解析（如PPT转HTML）。
- XX信创富文本编辑器（国产）：
- 支持全信创环境（包括龙芯MIPS架构）。
- 提供Word/Excel/PPT/PDF导入API，图片自动上传至OSS。
- 买断源代码授权费用78万元，剩余预算可用于应急储备。
- 最终决策：
- 主方案：采购XX信创富文本编辑器（国产），满足自主可控及信创硬指标。
- 备选方案：若预算不足，则基于UEditor二次开发，但需评估信创兼容性风险。
- UEditor原生插件：
二、开发过程记录
1. 前端集成（Vue2 + UEditor + 信创适配）
步骤1：UEditor信创兼容适配
- 替换UEditor核心库为信创兼容版本（修复IE8下
Array.prototype.indexOf等兼容性问题）。 - 引入
es5-shim和es5-sham解决IE8缺少的ES5特性。 - 自定义工具栏按钮，新增“Word导入”和“公众号粘贴”入口。
- 替换UEditor核心库为信创兼容版本（修复IE8下
步骤2：Word粘贴功能实现
- 监听粘贴事件：通过
ue.addListener('paste', handlePaste)捕获粘贴内容。 - 图片处理：
- 使用
Clipboard API提取图片二进制数据，通过AJAX上传至后端SpringBoot接口。 - 后端返回OSS图片URL后，替换为``标签。
- 使用
- 样式保留：
- 通过正则匹配Word生成的HTML标签（如
、），转换为UEditor支持的标准标签。
- 通过正则匹配Word生成的HTML标签（如
- 监听粘贴事件：通过
前端代码示例（Word粘贴处理）：
// 监听粘贴事件ue.addListener('paste',function(editor){constclipboardData=window.clipboardData||event.clipboardData;if(clipboardData.files.length>0){// 处理粘贴的图片constfile=clipboardData.files[0];if(/^image\//.test(file.type)){constformData=newFormData();formData.append('file',file);axios.post('/api/uploadToOSS',formData).then(res=>{editor.execCommand('insertHtml',``);});}}else{// 处理文本和样式consthtml=clipboardData.getData('text/html')||clipboardData.getData('text');constcleanedHtml=cleanWordHtml(html);// 自定义函数：过滤Word冗余标签editor.execCommand('insertHtml',cleanedHtml);}});// 信创浏览器兼容性修复（IE8）if(!Array.prototype.indexOf){Array.prototype.indexOf=function(item){for(leti=0;i<this.length;i++){if(this[i]===item)returni;}return-1;};}2. 后端开发（SpringBoot + 阿里云OSS）
- 步骤1：文档解析服务
- 使用
Apache POI解析Word/Excel/PPT，PDFBox解析PDF，提取文本和图片。 - 示例代码（解析Word文档）：
- 使用
// SpringBoot示例：解析Word文档并上传图片至OSS@PostMapping("/importWord")publicStringimportWord(@RequestParam("file")MultipartFilefile)throwsIOException{XWPFDocumentdocument=newXWPFDocument(file.getInputStream());StringBuilderhtml=newStringBuilder();for(XWPFParagraphparagraph:document.getParagraphs()){html.append("").append(paragraph.getText()).append("");}for(XWPFTabletable:document.getTables()){html.append("");// 解析表格行和单元格...html.append("");}// 提取文档中的图片并上传至OSS...returnhtml.toString();}- 步骤2：图片上传至OSS
- 集成阿里云OSS SDK，实现图片二进制流上传：
// SpringBoot示例：上传图片至OSS@PostMapping("/uploadToOSS")publicResponseEntity>uploadToOSS(@RequestParam("file")MultipartFilefile){StringfileName=UUID.randomUUID().toString()+"."+StringUtils.getFilenameExtension(file.getOriginalFilename());OSSossClient=newOSSClientBuilder().build(endpoint,accessKeyId,accessKeySecret);ossClient.putObject(bucketName,fileName,file.getInputStream());ossClient.shutdown();Mapresult=newHashMap<>();result.put("url","https://"+bucketName+"."+endpoint+"/"+fileName);returnResponseEntity.ok(result);}3. 信创兼容性测试
- 测试环境：
- 操作系统：中标麒麟7.6、统信UOS 20、龙芯3A5000（LoongArch架构）。
- 浏览器：IE8、奇安信安全浏览器（Chromium内核）、龙芯浏览器（MIPS架构）。
- 问题修复：
- 龙芯浏览器字体渲染异常：指定中文字体族（如
font-family: "SimSun", "宋体"）。 - IE8下AJAX上传失败：改用
jQuery.ajax并设置contentType: false。
- 龙芯浏览器字体渲染异常：指定中文字体族（如
三、综合评估与成果
1. 方案对比
| 方案 | 成本 | 兼容性 | 开发周期 | 授权模式 |
|---|---|---|---|---|
| UEditor二次开发 | 25万元（人力） | 需额外适配龙芯MIPS | 4个月 | 开源免费 |
| XX信创富文本编辑器 | 78万元（买断） | 全信创环境支持 | 2个月 | 永久授权（含升级） |
2. 最终决策
- 选择XX信创富文本编辑器：
- 满足自主可控及信创硬指标，减少兼容性风险。
- 买断授权费用78万元，剩余预算可用于应急储备。
- 提供完整的Word/Excel/PPT/PDF导入API，降低开发复杂度。
3. 交付成果
- 功能上线后，客户验收通过率100%，文章发布效率提升60%。
- 代码仓库：内网GitLab私有库（含信创适配分支）。
- 文档：《信创环境部署指南》《阿里云OSS集成开发手册》《政府项目安全合规报告》。
结语：本次项目通过“商业插件+信创适配”策略，在预算内高效完成了需求，同时为集团后续政企项目积累了国产化兼容经验。下一步计划将UEditor逐步迁移至国产信创富文本编辑器，进一步统一技术栈。
复制插件目录
引入插件文件
UEditor 1.4.3.3示例注意：不要重复引入jquery，如果您的项目已经引入了jq，则不用再引入jq-1.4
在工具栏中增加插件按钮
//工具栏上的所有的功能按钮和下拉框，可以在new编辑器的实例时选择自己需要的重新定义toolbars:[["fullscreen","source","|","zycapture","|","wordpaster","importwordtoimg","netpaster","wordimport","excelimport","pptimport","pdfimport","|","importword","exportword","importpdf"]]初始化控件
varpos=window.location.href.lastIndexOf("/");varapi=[window.location.href.substr(0,pos+1),"asp/upload.asp"].join("");WordPaster.getInstance({//上传接口：http://www.ncmem.com/doc/view.aspx?id=d88b60a2b0204af1ba62fa66288203edPostUrl:api,//为图片地址增加域名：http://www.ncmem.com/doc/view.aspx?id=704cd302ebd346b486adf39cf4553936ImageUrl:"",//设置文件字段名称：http://www.ncmem.com/doc/view.aspx?id=c3ad06c2ae31454cb418ceb2b8da7c45FileFieldName:"file",//提取图片地址：http://www.ncmem.com/doc/view.aspx?id=07e3f323d22d4571ad213441ab8530d1ImageMatch:''});//加载控件注意
如果接口字段名称不是file，请配置FileFieldName。ueditor接口中使用的upfile字段
点击查看详细教程
配置ImageMatch
匹配图片地址，如果服务器返回的是JSON则需要通过正则匹配
ImageMatch:'',点击参考链接
配置ImageUrl
为图片地址增加域名，如果服务器返回的图片地址是相对路径，可通过此属性添加自定义域名。
ImageUrl:"",点击查看详细教程
配置SESSION
如果接口有权限验证（登陆验证，SESSION验证），请配置COOKIE。或取消权限验证。
参考：http://www.ncmem.com/doc/view.aspx?id=8602DDBF62374D189725BF17367125F3
效果
编辑器界面
导入Word文档,支持doc,docx
导入Excel文档,支持xls,xlsx
粘贴Word
一键粘贴Word内容，自动上传Word中的图片，保留文字样式。
Word转图片
一键导入Word文件，并将Word文件转换成图片上传到服务器中。
导入PDF
一键导入PDF文件，并将PDF转换成图片上传到服务器中。
导入PPT
一键导入PPT文件，并将PPT转换成图片上传到服务器中。
上传网络图片
下载示例
点击下载完整示例
