更新记录

0.1.0(2026-11-05) 下载此版本

0.1.0

  • docx 结构化解析 / xlsx·csv 表格解析 / txt·md / pdf(WebView)/ 图片预览 / 下载进度超时重试 / 旧格式如实降级系统打开 / 全屏预览组件。

平台兼容性

pk-docview 文档预览套件

docx/xlsx/csv/pdf 纯前端解析 —— 零后端不怕服务关停、快速失败、如实降级。纯 JS、零原生插件。

为什么做这款

调研 3 款文档预览竞品发现:依赖第三方预览服务(服务一关插件报废)、报错黑盒(只有"预览失败"三个字)、旧格式卡死。pk-docview 全部在客户端解析,每个失败路径都有明确错误码和出路。

核心能力

格式 方式
.docx 内置解析:标题/加粗/列表/段落结构化渲染
.xlsx 内置解析:sharedStrings + inline,第一个工作表
.csv 内置解析:RFC 4180 引号转义
.txt/.md 纯文本
.pdf 系统 WebView 渲染(Android/iOS 自带)
图片 全屏预览
.doc/.xls/.ppt 如实降级:告知不支持内置解析,一键系统应用打开

使用

// 方式一:全屏预览组件(3 行接入)
// <pk-docview-modal ref="docview" />
this.$refs.docview.open({ url: 'https://x.com/a.docx', name: '报告.docx' });

// 方式二:仅解析
import pkDocview from '@/uni_modules/pk-docview/js_sdk/index.js';
const data = await pkDocview.parse({ url });

错误码:E-DV-10 下载失败(自动重试 2 次)/ E-DV-20 格式不支持(fallback: openWithSystem)/ E-DV-30 容器损坏(魔数校验防伪装)。

质量保障

  • 22 个 node 单测全绿(docx 结构、xlsx 混合单元格、csv 转义、魔数探测、重试状态机)
  • 厚逻辑全部纯函数化,运行时薄封装

文档

  • 在线文档(含 8 个内置真实示例文件的演示说明 + 示例下载):https://plugins.cnajiu.cn/public/pk-docview.html
  • 兼容性矩阵:docs/compatibility.md
  • 竞品调研:docs/research.md

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

许可协议

MIT协议

暂无用户评论。