Skip to content

5.0.0版本发布 / Release v5.0.0

Latest
Latest

Choose a tag to compare

View all tags
@klboke klboke released this 14 Apr 01:14
· 2 commits to master since this release
v5.0.0
171762d
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

项目简介 / Project Overview

kkFileView 是一个文件文档在线预览开源解决方案，基于 Spring Boot 构建，部署后可独立提供预览服务，通过 HTTP 接口访问，不需要和业务系统强耦合集成，适合跨系统、跨语言场景使用。项目提供 Windows / Linux 发行包、自定义配置文件，以及一键启动 / 停止脚本，同时也提供 Docker 部署方式，便于在容器环境中快速落地。

kkFileView is an open-source solution for online file and document preview, built with Spring Boot. Once deployed, it can run as an independent preview service and be accessed through HTTP APIs without tight integration with your business application. It is suitable for cross-system and cross-language usage. The project provides Windows / Linux release packages, custom configuration files, one-click start / stop scripts, and Docker-based deployment options.

由于项目目前主要由开源社区持续维护和迭代，服务器与运维成本也由社区共同支持，因此我们同步运营了 kk 开源社区，用于发布最新发行包、解答使用问题、沉淀经验案例，并支持 kkFileView 及相关开源项目的持续发展。

The project is now maintained and iterated mainly by the open-source community. Infrastructure and maintenance costs are also supported by the community, so we operate the kk Community to share the latest release packages, answer usage questions, collect practical experience, and support the sustainable development of kkFileView and related open-source projects.

本次 v5.0.0 更新内容 / What's New in v5.0.0

优化 / Improvements

中文：

  • 优化 xlsx、图片、tif、svg、json 解析效果，并提升 FTP 多客户端接入与 Markdown 渲染体验。
  • 首页支持目录访问，并切换为 POST 服务端分页机制。
  • 压缩包预览页重构为单工作区布局，支持目录折叠与右侧内嵌预览。
  • 优化压缩包内文件类型标识，并改进单图预览页展示样式。
  • 重构演示门户页面，包括首页、接入说明、版本记录与赞助页。
  • 补充面向工程自动化与编码代理的仓库说明文档。

English:

  • Improved parsing and rendering for xlsx, images, tif, svg, and json, while enhancing FTP multi-client access and Markdown rendering.
  • Added directory access on the home page and switched it to POST-based server-side pagination.
  • Redesigned archive preview into a single workspace with a collapsible tree and inline preview panel.
  • Improved archive file-type badges and refined the single-image preview experience.
  • Refreshed the demo portal pages, including the index, integration guide, release record, and sponsor pages.
  • Added an agent-friendly repository guide for engineering automation and maintenance.

新增 / New Capabilities

中文：

  • 新增 msg 邮件预览、HEIC/HEIF 预览、pptm 支持。
  • 新增页码定位、文本高亮、AES、Basic Auth、秘钥访问等能力。
  • 新增防重复转换、异步等待、上传限制与 cadviewer 转换能力。

English:

  • Added support for msg email preview, HEIC/HEIF preview, and pptm.
  • Added page positioning, text highlighting, AES, Basic Auth, and key-based access capabilities.
  • Added anti-duplicate conversion, async waiting, upload restrictions, and cadviewer conversion support.

修复 / Fixes

中文：

  • 修复压缩包路径处理问题、安全相关问题、图片水印不完整问题，以及 SSL 自签证书接入兼容性问题。
  • 修复压缩包内 Office 文件重复解压后被追加写坏，导致一直卡在加载中的问题。
  • 修复 OFD 表格竖线溢出导致的渲染异常。
  • 修复 PDF.js 兼容性补丁，避免兼容环境下的预览报错。

English:

  • Fixed compressed-file path handling, multiple security-related issues, incomplete image watermark rendering, and SSL self-signed certificate compatibility.
  • Fixed archive-contained Office files that could stay stuck on loading because repeated extraction appended to existing files.
  • Fixed OFD table border overflow rendering issues.
  • Refined the PDF.js compatibility polyfill to avoid preview errors in compatibility environments.

升级说明 / Upgrade Notes

中文：

  • JDK 21 及以上现已成为必需要求。
  • Office 预览默认切换为 PDF 模式，且 PDF 预览默认展开缩略图侧栏。
  • 图片/PDF 模式切换按钮默认隐藏；如果你希望升级后继续保持旧的图片优先体验，请显式设置 office.preview.type=image 与 office.preview.switch.disabled=false。
  • trust.host 及相关规则现已支持通配符和 CIDR 匹配；如果你依赖域名/IP 模式匹配，请在升级后重新检查白名单和黑名单的实际生效范围。

English:

  • JDK 21 or higher is now required.
  • Office preview now defaults to PDF mode, and PDF preview opens with the thumbnail sidebar visible by default.
  • The image/PDF mode switch is hidden by default. If you need the previous image-first behavior after upgrade, explicitly set office.preview.type=image and office.preview.switch.disabled=false.
  • trust.host and related rules now support wildcard and CIDR matching. If you rely on host/IP pattern matching, review your allow/deny rules after upgrade.

社区说明 / Community Note

最新发行包、部署答疑、使用问题支持，以及 kkFileView 相关经验分享，会优先在 kk 开源社区内同步。欢迎加入社区，支持开源项目持续迭代。

The latest release packages, deployment support, usage Q&A, and practical experience around kkFileView are shared first in the kk Community. You are welcome to join the community and support the continued development of this open-source project.

Assets 2
Loading