BaseMetas FileView / IDP 客户 FAQ

BaseMetas FileView 是面向业务系统的在线文件预览产品，主要用于在 OA、BPM、合同、档案、知识库、企业网盘、政企内网等系统中实现附件在线查看。

它的核心目标是让用户无需下载文件、无需本地安装 Office、CAD、PDF 等客户端软件，即可在浏览器中查看多种格式文件。

BaseMetas FileView 提供社区版和商业版：

• 社区版适合开发者、中小项目、内部系统和基础预览场景；
• 商业版适合企业正式生产环境，提供更完整的权限、安全、部署、运维和技术支持能力。

BaseMetas FileView 可以理解为 BaseMetas IDP 中的文件预览能力。

BaseMetas IDP 是更完整的智能文档平台，当前能力包括：

• 文件预览；
• 文件格式转换；
• 文件内容处理；
• 授权验证；
• 统一 API；
• 统一任务模型；
• 统一交付架构；
• 安全治理；
• 部署运维支持。

简单来说：

FileView 重点解决"文件在线查看"；IDP 进一步解决"预览、转换、处理、集成、安全、交付和运维"等企业文档能力问题。

不是。

BaseMetas 当前阶段不替代客户已有的业务系统、文件服务器、对象存储、档案系统或文档管理系统。

它更适合作为文档能力服务接入到已有系统中，为这些系统补充：

• 文件在线预览；
• 文件格式转换；
• 文档内容处理；
• 水印和权限控制；
• 统一文档处理接口；
• 企业级部署和运维能力。

也就是说，客户原来的文件仍然可以继续存放在原业务系统、文件服务器或对象存储中，BaseMetas 负责提供文档查看、转换和处理能力。

BaseMetas 适合以下客户：

• 需要给业务系统增加文件在线预览能力的企业；
• 正在建设 OA、BPM、合同、档案、知识库、企业网盘等系统的客户；
• 需要私有化部署、内网部署、国产化环境适配的客户；
• 希望从开源预览方案升级到商业支持方案的客户；
• 希望在预览基础上继续扩展格式转换、内容处理和文档治理能力的客户；
• 系统集成商、软件厂商、项目交付团队；
• 对金山 WPS、永中 DCS 等高端方案预算有限，但又需要企业级能力的客户。

社区版主要面向基础文件预览场景，适合开发者和中小项目使用。

它可以用于：

• Office 文档预览；
• PDF / OFD 预览；
• 图片预览；
• 文本和代码文件预览；
• 压缩包预览；
• CAD / 图纸预览；
• 音视频预览；
• 常见业务系统附件预览；
• 内部系统集成；
• 二次开发和技术验证。

社区版的价值在于低成本、开源、可二次开发，适合项目早期验证和基础预览需求。

可以，但要看生产场景复杂度。

如果只是内部系统、轻量项目、中小规模业务、基础附件预览，社区版可以满足很多场景。

但如果涉及以下要求，建议选择商业版：

• 权限控制；
• 动态水印；
• 下载、打印、复制控制；
• 多业务系统统一接入；
• 大文件和高并发；
• 预转换；
• 缓存管理；
• 任务状态跟踪；
• 集群部署；
• 高可用部署；
• 私有化正式交付；
• 运维排查；
• 商业技术支持；
• 客户现场交付责任。

一句话概括：

社区版解决"能不能预览"，商业版解决"企业能不能稳定、安全、可控、长期使用"。

不是。

商业版不是简单把社区版收费化，而是在社区版基础上，面向企业生产环境补齐更多能力。

商业版重点解决：

• 企业级集成；
• 权限与水印控制；
• 安全认证；
• 多应用接入；
• 任务状态管理；
• 缓存和结果复用；
• 预转换；
• 集群部署；
• 高可用部署；
• 运维排查；
• 商业授权；
• 技术支持；
• 项目交付。

因此，商业版的价值不是"多几个预览格式"，而是把文件预览能力产品化、平台化、企业化。

企业正式业务系统通常不只是要求"文件能打开"。

企业客户还会关注：

• 文件是否能受控查看；
• 是否能禁止下载；
• 是否能禁止打印；
• 是否能禁止复制；
• 是否能加用户水印；
• 是否能隐藏真实文件地址；
• 是否能防止预览链接被随意转发；
• 是否能接入业务系统权限；
• 是否能支撑高并发访问；
• 是否能做集群和高可用；
• 出问题后是否有人支持；
• 是否能满足项目交付和验收要求。

这些能力通常不是普通社区版的重点，因此正式生产系统建议选择商业版。

可以。

比较推荐的方式是：

第一阶段，使用社区版进行技术验证和业务接入验证。

第二阶段，确认业务需求后，引入商业版能力，例如权限、水印、安全认证、缓存、任务模型、集群部署等。

第三阶段，如果客户需要预览、转换、内容处理等完整文档能力，则升级到 BaseMetas IDP。

这种路径适合中小企业、集成项目和预算分阶段投入的客户。

kkFileView 是成熟的开源文件预览项目，适合快速接入和基础预览场景。

BaseMetas 的优势在于：

• 社区版更强调后续二次开发和商业版承接；
• 商业版提供企业级权限、水印、安全、缓存、任务、部署和运维能力；
• IDP 不仅做文件预览，还扩展到格式转换和内容处理；
• 更适合中小企业、系统集成商、私有化交付和长期文档能力建设。

如果只是快速做一个基础预览服务，kkFileView 是可选方案。

如果希望后续升级企业能力，或者需要厂商技术支持、企业部署和平台能力，BaseMetas 更适合。

两者都属于文件在线预览相关产品，但定位有所不同。

kkFileView 更偏成熟开源预览工具，适合快速接入常见文件预览。

BaseMetas FileView 社区版同样提供开源预览能力，但更强调可扩展、可二次开发和后续商业能力承接。

BaseMetas 商业版 / IDP 则进一步面向企业生产环境，提供权限、水印、安全接入、格式转换、内容处理、集群部署、高可用和商业支持。

可以简单理解为：

• 快速开源预览：kkFileView；
• 开源二开和长期演进：BaseMetas FileView 社区版；
• 企业级生产和商业交付：BaseMetas FileView 商业版 / IDP。

纯前端方案适合轻量场景，比如 PDF、图片、文本、代码、Markdown、CSV 等文件预览。

但纯前端方案对复杂 Office 文档的还原能力通常有限，尤其是 Word、Excel、PPT 中的复杂版式，例如：

• 页眉页脚；
• 目录；
• 批注；
• 修订；
• 浮动图片；
• 表格嵌套；
• 自动编号；
• Excel 合并单元格；
• Excel 图表；
• PPT 母版；
• 特殊字体；
• 分页和换行。

如果客户只是做简单文件查看，纯前端方案成本低、集成快。

但如果是 OA、公文、合同、档案、审批材料等正式业务文件，通常不建议把纯前端方案作为主方案。

依赖本地客户端或本地 Office 的方案，通常在 Office 文档还原效果上有优势。

但它的问题是环境依赖较强，例如：

• 可能需要安装 Office、WPS 或专用客户端；
• 对终端环境有要求；
• 对操作系统有要求；
• 不利于统一部署；
• 不利于信创和国产化环境；
• 不利于多终端浏览器访问；
• 运维和升级成本较高。

如果客户终端环境完全可控，并且最关注 Office 还原效果，可以考虑这类方案。

但如果客户希望浏览器直接访问、无需终端安装软件、支持私有化统一交付和信创环境，则更适合服务端解析和转换方案。

金山 WPS、永中 DCS 属于高端商业方案，在 Office 文档还原效果、政企场景、国产化生态和大型客户交付方面有很强优势。

它们更适合：

• 党政机关；
• 军工单位；
• 大型政企；
• 大型国企；
• 高预算项目；
• 对 Office 还原要求极高的场景。

BaseMetas 的定位更偏性价比企业级方案，适合：

• 中小企业；
• 软件集成商；
• 项目型交付；
• OA / BPM / 合同 / 档案 / 知识库；
• 对预算敏感但又需要企业级能力的客户；
• 希望从预览扩展到转换和内容处理的客户。

如果客户预算充足，并且要求 Office 还原效果极致一致，可以考虑金山 WPS、永中 DCS。

如果客户希望成本可控，同时具备企业级预览、转换、内容处理、权限水印、私有化部署和技术支持能力，可以考虑 BaseMetas。

不建议这样承诺。

金山 WPS、永中 DCS 在 Office 排版和文档渲染方面有长期积累，尤其适合对 Office 还原要求极高的党政、政企、军工等场景。

BaseMetas 更适合强调：

• 成本可控；
• 私有化部署；
• 多格式预览；
• 企业级权限和水印；
• 格式转换；
• 内容处理；
• 系统集成；
• 交付支持；
• 中小企业和集成项目性价比。

在客户对 Office 还原要求极高时，建议通过真实业务文件进行 POC 测试，以测试结果作为选型依据。

BaseMetas 支持多类常见文件预览，包括：

• Office 文档；
• PDF；
• OFD；
• 图片；
• 文本；
• 代码文件；
• 压缩包；
• CAD / 工程图纸；
• 音视频；
• 流程图；
• 思维导图；
• 3D 模型；
• 其他常见业务文件格式。

具体格式支持情况，应以当前版本能力清单和实际测试结果为准。

支持。

BaseMetas 支持常见 Office 文件的在线预览，包括 Word、Excel、PPT 等。

对于复杂 Office 文件，建议客户在 POC 阶段提供真实业务文件进行测试，例如：

• 合同；
• 公文；
• 审批材料；
• 财务表格；
• 多 Sheet Excel；
• 带批注和修订的 Word；
• 复杂 PPT；
• 使用特殊字体的文档。

文档预览效果最终应以实际文件测试结果为准。

支持。

OFD 在政企、公文、档案和国产化场景中较常见。BaseMetas 可用于 OFD 文件预览，并可结合企业档案、政企协同、合同归档等业务场景使用。

支持。

BaseMetas 可用于工程图纸、CAD 文件、技术资料等场景的在线查看，适合工程制造、项目管理、设备资料管理等系统。

具体 CAD 格式和显示效果，建议使用客户真实图纸进行 POC 测试。

支持。

压缩包预览适合附件包、资料包、归档包、项目交付包等场景。具体支持的压缩格式、密码包、嵌套目录等能力，应以当前版本能力和实际测试结果为准。

BaseMetas IDP 支持文件格式转换能力。

格式转换适合以下场景：

• Office 转 PDF；
• 图片格式转换；
• PDF / OFD 标准化；
• 业务归档前转换；
• 合同版本固化；
• 审批材料生成；
• 知识库入库前格式统一；
• 业务系统批量转换。

格式转换通常采用任务方式执行，适合处理耗时文件、大文件和批量任务。

BaseMetas IDP 支持文件内容处理能力。

文件内容处理适合：

• PDF 页面处理；
• PDF 合并；
• PDF 抽取；
• 批注清理；
• 修订处理；
• 元数据提取；
• 水印处理；
• 文档安全处理；
• Word 内容处理；
• Excel 内容处理；
• 知识库入库前处理；
• AI 文档解析前处理。

这类能力适合从"文件预览"进一步扩展到"文档治理"和"文档自动化"。

商业版支持围绕查看器能力进行权限控制，包括下载、打印、复制等受控查看能力。

这些能力通常需要业务系统将用户身份、文件权限、业务权限等参数传递给 BaseMetas，由 BaseMetas 在预览页面中执行相应控制。

需要说明的是，浏览器环境中的权限控制更多是业务层和产品层的控制，不能替代企业整体数据安全体系。对于高度敏感文件，还应结合网络安全、终端安全、审计、DLP、水印追踪等手段综合治理。

商业版支持水印能力。

常见水印参数可以包括：

• 用户名；
• 用户 ID；
• 部门；
• 时间；
• 文件名称；
• IP 地址；
• 自定义业务字段。

水印适合合同、档案、审批材料、内部资料、政企文件等场景，用于降低截图传播和二次泄露风险。

支持。

动态水印可以结合用户身份、时间、文件信息和业务系统参数生成。不同用户访问同一文件时，可以显示不同水印内容。

典型场景包括：

• 合同查看；
• 审批附件；
• 档案查阅；
• 内部资料阅读；
• 政企文件查看；
• 项目文档外发前预览。

可以通过服务端 API、预览入口、签名认证、访问有效期等方式降低真实文件地址暴露风险。

推荐做法是：

• 文件真实地址由业务系统或服务端管理；
• 前端不直接暴露原始文件地址；
• 外部系统通过服务端 API 初始化预览；
• BaseMetas 返回受控的 previewUrl；
• 预览地址设置有效期；
• 敏感文件结合权限、水印和访问控制使用。

商业版支持服务端签名认证。

典型方式是业务系统通过 AppKey、AppSecret、时间戳和签名值调用 BaseMetas 服务端 API，以降低接口被伪造调用和请求重放风险。

这类方式适合后端服务主导的企业系统集成。

支持。

商业版可以为不同业务系统配置独立的应用凭证，例如不同的 AppKey、AppSecret、租户标识和权限范围。

适合以下场景：

• OA 系统接入；
• 合同系统接入；
• 档案系统接入；
• 知识库接入；
• 多个子系统共用同一套文档能力服务；
• 集团型企业多部门、多应用接入。

商业版支持按租户、应用、客户端标识等方式隔离任务和结果。

如果客户是 SaaS 平台、集团多组织、多业务系统统一接入，需要在项目实施阶段明确租户模型、文件来源、权限体系和数据隔离要求。

支持。

BaseMetas 适合私有化、内网、专有云和企业自有环境部署。

客户可以将服务部署在自己的服务器、虚拟机、容器平台或内网环境中，由业务系统通过 API 或前端方式接入。

支持。

BaseMetas 推荐使用容器化方式交付，适合大多数私有化和生产环境。

容器化部署便于：

• 快速安装；
• 环境隔离；
• 版本升级；
• 服务编排；
• 集群扩展；
• 健康检查；
• 自动重启；
• 滚动发布。

支持。

对于不能使用 Docker 或 Kubernetes 的客户环境，可以采用非容器化部署方式，例如：

• JAR 运行；
• systemd 管理；
• 外部 Redis；
• 外部消息队列；
• Nginx / F5 / 负载均衡；
• 共享目录或对象存储。

这种方式适合部分政企内网、传统数据中心或已有成熟主机运维体系的客户。

商业版支持集群部署。

集群部署适合：

• 多业务系统接入；
• 文件访问量较大；
• 转换任务较多；
• Worker 需要横向扩展；
• 单机资源不足；
• 生产环境稳定性要求较高。

在集群模式下，可以将 API 服务、Worker 服务、中间件和存储按角色拆分，提升系统扩展能力。

商业版支持高可用部署方案。

高可用部署通常需要结合：

• 多 API 节点；
• 多 Worker 节点；
• 负载均衡；
• Redis 高可用；
• 消息队列高可用；
• 共享存储或对象存储；
• 健康检查；
• 自动重启；
• 滚动发布；
• 监控告警。

是否需要高可用，取决于客户业务系统的重要程度、访问规模和连续性要求。

可以按以下原则选择：

• 开发测试、POC、内部轻量系统：单机部署；
• 中小规模生产系统：单机或小规模集群；
• 多业务系统统一接入：集群部署；
• 核心生产系统、政企项目、高连续性要求：高可用部署。

建议客户先从业务规模、并发量、文件大小、任务量、可用性要求和预算综合评估。

BaseMetas 面向私有化和企业级交付场景设计，可适配主流 Linux 发行版和部分国产化操作系统环境。

国产化项目建议在 POC 阶段重点验证：

• 操作系统；
• CPU 架构；
• 浏览器内核；
• 字体环境；
• 文件格式；
• 网络环境；
• 中间件；
• 容器平台；
• 负载均衡；
• 客户现场安全要求。

主要有两种方式：

第一，服务端 API 集成。

业务系统后端调用 BaseMetas API，初始化预览、提交转换任务或内容处理任务，再将结果返回给前端。

第二，前端 JSSDK 集成。

业务系统前端直接引入 JSSDK，以组件化方式嵌入预览能力。

一般建议：

• 权限复杂、安全要求高、后端主导的系统，使用服务端 API；
• 前后端分离或纯前端页面，可以结合 JSSDK；
• 正式企业系统优先采用服务端 API 控制核心权限和文件来源。

不一定。

BaseMetas 可以支持多种文件来源，具体方式取决于项目集成方案，例如：

• 本地文件；
• 网络文件 URL；
• 对象存储文件；
• 业务系统文件下载接口；
• 已登记文件 ID；
• 共享目录文件。

对于安全要求较高的系统，通常建议由业务系统后端控制文件来源，不直接把真实文件地址暴露给前端用户。

支持对象存储类文件接入和结果文件管理场景。

在企业项目中，常见的对象存储包括：

• MinIO；
• 阿里云 OSS；
• 腾讯云 COS；
• 华为云 OBS；
• 私有化对象存储；
• 兼容 S3 协议的对象存储。

具体接入方式需要结合客户现有存储架构设计。

支持。

对于文件转换、内容处理等异步任务，业务系统可以通过任务查询或回调通知获取处理结果。

回调适合：

• 转换完成后更新业务状态；
• 处理完成后入库；
• 失败后触发重试或告警；
• 批量任务异步处理。

支持。

BaseMetas 文件预览能力可以通过 iframe、页面嵌入、JSSDK 容器挂载或统一网关子路径等方式嵌入业务系统。

适合嵌入：

• 审批详情页；
• 合同详情页；
• 档案详情页；
• 知识库阅读页；
• 企业网盘文件详情页；
• 项目资料页面。

大文件通常建议通过服务端任务模型处理，而不是让用户长时间同步等待。

可以结合：

• 异步任务；
• 预转换；
• 结果复用；
• 缓存策略；
• Worker 扩展；
• 文件大小限制；
• 任务队列；
• 存储规划；
• 超时控制。

对于大文件场景，建议客户在 POC 阶段提供真实大文件测试。

商业版支持预转换类能力。

预转换适合以下场景：

• 文件上传后提前生成预览结果；
• 审批流程发起前提前转换；
• 热点文件提前缓存；
• 批量附件提前处理；
• 大文件避免用户首次打开等待过久。

预转换可以提升用户体验，但也会增加服务端资源消耗，需要根据业务访问频率合理规划。

支持。

缓存和结果复用适合：

• 热点文件；
• 重复访问文件；
• 批量查看；
• 多用户访问同一文件；
• 转换耗时较长的文件；
• 频繁打开的合同、制度、档案、知识库文档。

合理的缓存策略可以降低重复转换成本，提高打开速度。

转换失败通常需要从以下方向排查：

• 文件是否损坏；
• 文件是否加密；
• 文件格式是否真实匹配扩展名；
• 文件大小是否超过限制；
• 字体是否缺失；
• 转换引擎是否可用；
• Worker 是否正常；
• 存储目录是否可写；
• 网络文件是否可访问；
• 任务队列是否积压；
• 日志中是否有明确异常。

商业版可以结合日志、任务状态、链路信息和技术支持进行排查。

支持。

企业级部署中通常会关注：

• 访问日志；
• 任务日志；
• 转换日志；
• Worker 日志；
• 授权日志；
• 错误日志；
• requestId；
• taskId；
• fileId；
• 文件来源；
• 目标格式；
• 执行耗时。

这些信息可以帮助客户定位访问异常、转换失败、任务超时、权限错误等问题。

可结合客户现有监控体系接入。

常见监控指标包括：

• API 服务状态；
• Worker 服务状态；
• CPU；
• 内存；
• 磁盘；
• 网络；
• Redis 状态；
• 消息队列积压；
• 任务成功率；
• 任务失败率；
• 平均处理耗时；
• 存储空间使用情况。

具体监控方式需要结合客户基础设施和部署方案确定。

BaseMetas 商业版适合对成本敏感，但又需要企业级能力的客户。

典型客户包括：

• 中小企业；
• 软件公司；
• 系统集成商；
• 项目交付团队；
• 私有化部署客户；
• 不希望完全自行维护开源方案的客户；
• 预算不足以采用高端商业方案，但又需要正式技术支持的客户。

BaseMetas 的主要优势是性价比和灵活性。

它适合：

• 成本可控；
• 私有化交付；
• 多格式预览；
• 企业级权限和水印；
• 文件转换；
• 内容处理；
• 系统集成；
• 技术支持；
• 中小企业和项目型交付。

如果客户预算非常充足，并且核心诉求是极致 Office 还原效果，可以考虑金山 WPS、永中 DCS。

如果客户希望能力够用、成本合理、集成灵活、可交付可维护，BaseMetas 更适合。

商业版提供技术支持。

技术支持可以覆盖：

• 部署指导；
• 接口接入；
• 参数配置；
• 问题排查；
• 文件兼容分析；
• 性能调优建议；
• 升级指导；
• 交付支持；
• 常见故障定位。

具体支持范围、响应方式和服务周期，以合同或商业授权约定为准。

可以根据客户需求评估定制开发。

常见定制方向包括：

• 特定格式支持；
• 查看器界面调整；
• 权限参数扩展；
• 水印样式扩展；
• 业务系统集成；
• 特定文件来源接入；
• 特定转换链路；
• 内容处理能力扩展；
• 国产化环境适配；
• 部署方案定制。

定制需求需要结合技术可行性、产品路线、交付周期和商务条件综合评估。

建议先进行 POC。

POC 阶段建议客户准备真实业务文件，包括：

• Word 合同；
• 公文；
• Excel 表格；
• PPT 材料；
• PDF；
• OFD；
• CAD 图纸；
• 压缩包；
• 大文件；
• 加密文件；
• 异常文件；
• 使用特殊字体的文件。

同时建议测试：

• 打开速度；
• 还原效果；
• 权限控制；
• 水印效果；
• 下载控制；
• 打印控制；
• 复制控制；
• API 集成；
• JSSDK 集成；
• 任务状态；
• 并发访问；
• 部署环境适配。

如果只是内部轻量附件预览，可以先使用社区版。

如果是正式生产 OA，建议选择商业版或 IDP。

原因是 OA 通常涉及：

• 审批附件；
• 权限控制；
• 下载限制；
• 水印；
• 多用户访问；
• 日志排查；
• 高可用；
• 长期运维。

建议选择商业版或 IDP。

合同系统通常涉及敏感文件，需要：

• 合同在线预览；
• Word / PDF 转换；
• 水印；
• 下载控制；
• 打印控制；
• 修订处理；
• 批注清理；
• 归档处理；
• 文件地址保护。

这些场景更适合商业版或 IDP。

建议选择 IDP。

档案系统通常不只是预览，还需要：

• PDF / OFD 预览；
• 扫描件查看；
• 格式标准化；
• 页面处理；
• 元数据提取；
• 批量处理；
• 长期归档；
• 安全访问；
• 内网部署。

IDP 比单独预览产品更适合作为档案系统的文档能力组件。

建议选择 IDP。

知识库不仅需要文件预览，还可能需要：

• 正文抽取；
• 格式统一；
• 文档解析；
• 搜索前处理；
• 内容清洗；
• PDF 转换；
• 图片和附件处理；
• 后续接入 AI 问答。

IDP 更适合作为知识库的文档处理底座。

系统集成商可以按项目类型选择：

• 低预算、基础预览项目：社区版；
• 正式交付、有验收要求：商业版；
• 需要预览、转换、内容处理组合能力：IDP；
• 高预算、极致 Office 还原客户：可评估金山 WPS、永中 DCS；
• 成本敏感、又需要企业能力的客户：优先推荐 BaseMetas 商业版 / IDP。

中小企业通常更关注成本、易部署、能用、有人支持。

建议：

• 只是内部简单预览：社区版；
• 正式业务系统：商业版；
• 涉及转换、内容处理、知识库、档案：IDP。

BaseMetas 商业版 / IDP 更适合中小企业在成本可控的前提下获得企业级文档能力。

政企客户建议根据预算和还原要求选择：

• 如果对 Office 还原效果要求极高、预算充足，可评估金山 WPS、永中 DCS；
• 如果更关注性价比、私有化、内网、系统集成、权限水印和文档处理能力，可评估 BaseMetas 商业版 / IDP；
• 如果只是早期验证，可先使用 BaseMetas 社区版做 POC。

政企客户必须通过真实业务文件、真实部署环境和真实权限场景进行测试。