diff --git a/Dockerfile b/Dockerfile
index 3ed0bcf2..dff9781e 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -1,4 +1,4 @@
-FROM keking/kkfileview-base:4.4.0
+FROM keking/kkfileview-base:5.0.0
ADD server/target/kkFileView-*.tar.gz /opt/
-ENV KKFILEVIEW_BIN_FOLDER=/opt/kkFileView-4.4.0/bin
-ENTRYPOINT ["java","-Dfile.encoding=UTF-8","-Dspring.config.location=/opt/kkFileView-4.4.0/config/application.properties","-jar","/opt/kkFileView-4.4.0/bin/kkFileView-4.4.0.jar"]
+ENV KKFILEVIEW_BIN_FOLDER=/opt/kkFileView-5.0.0/bin
+ENTRYPOINT ["java","-Dfile.encoding=UTF-8","-Dspring.config.location=/opt/kkFileView-5.0.0/config/application.properties","-jar","/opt/kkFileView-5.0.0/bin/kkFileView-5.0.0.jar"]
diff --git a/README.cn.md b/README.cn.md
index 1d66a58f..bef30c0e 100644
--- a/README.cn.md
+++ b/README.cn.md
@@ -149,6 +149,18 @@ pdf预览模式预览效果如下
### 历史更新记录
+#### > 2026年04月14日,v5.0.0 版本发布 :
+#### 优化内容
+1. 压缩包预览页重构为单工作区布局,支持目录折叠与右侧内嵌预览
+2. 优化压缩包内文件类型标识,以及单图预览页的展示样式
+3. 补充面向工程自动化与编码代理的仓库说明文档
+
+#### 修复问题
+1. 修复压缩包内 Office 文件在重复解压后被追加写坏,导致一直卡在加载中的问题
+2. Office 默认预览改为 PDF 模式,且 PDF 预览默认打开缩略图侧栏
+3. 启动脚本改为自动发现当前发布包中的 jar,移除过时的硬编码 jar 名称
+4. 更新 Docker 与发布辅助文档,使其与 5.0.0 发布线保持一致
+
#### > 2026年01月20日,v5.0 版本发布 :
#### 优化内容
1. xlsx 前端解析优化 - 提升Excel文件前端渲染性能
@@ -468,4 +480,3 @@ dcm医疗数位影像 引用于 [dcmjs](https://github.com/dcmjs-org/dcmjs )开
- 本项目诞生于[凯京集团],在取得公司高层同意后以 Apache 协议开源出来反哺社区,在此特别感谢凯京集团,以及集团领导[@唐老大](https://github.com/tangshd)的支持、@端木详笑的贡献。
- 本项目已脱离公司由[KK开源社区]维护发展壮大,感谢所有给 kkFileView 提 Issue 、Pr 开发者
- 本项目引入的第三方组件已在 '关于引用' 列表列出,感谢这些项目,让 kkFileView 更出色
-
diff --git a/README.md b/README.md
index 740fdd9f..5cf4c8a2 100644
--- a/README.md
+++ b/README.md
@@ -65,6 +65,19 @@ URL:[https://file.kkview.cn](https://file.kkview.cn)
## Change History
+### Version 5.0.0 (April 14, 2026)
+
+#### Improvements
+1. Redesigned archive preview into a single workspace with a collapsible tree and inline file preview
+2. Improved archive preview file-type badges and single-image preview styling
+3. Added an agent-focused repository guide for engineering automation and maintenance
+
+#### Fixes
+1. Fixed archive-contained Office files that could stay stuck on loading because repeated extraction appended to existing files
+2. Default Office preview now prefers PDF mode, and PDF preview opens with the thumbnail sidebar visible by default
+3. Updated startup scripts to discover the packaged jar dynamically instead of relying on stale hard-coded jar names
+4. Updated Docker and release helper docs to align with the 5.0.0 release line
+
### Version 5.0 (January 20, 2026)
#### Optimizations
diff --git a/doc/ci-auto-deploy.md b/doc/ci-auto-deploy.md
index fc7ccdc5..028260e5 100644
--- a/doc/ci-auto-deploy.md
+++ b/doc/ci-auto-deploy.md
@@ -3,7 +3,7 @@
当前线上 Windows 服务器的实际部署信息如下:
- 部署根目录:`C:\kkFileView-5.0`
-- 运行 jar:`C:\kkFileView-5.0\bin\kkFileView-5.0.jar`
+- 运行 jar:`C:\kkFileView-5.0\bin\kkFileView-<当前项目版本>.jar`
- 启动脚本:`C:\kkFileView-5.0\bin\startup.bat`
- 运行配置:`C:\kkFileView-5.0\config\test.properties`
- 健康检查地址:`http://127.0.0.1:8012/`
diff --git a/docker/kkfileview-base/README.cn.md b/docker/kkfileview-base/README.cn.md
index 42706e12..a129ea5a 100644
--- a/docker/kkfileview-base/README.cn.md
+++ b/docker/kkfileview-base/README.cn.md
@@ -7,10 +7,10 @@
然后使用 kkfileview-base 作为基础镜像进行构建,加快 kkfileview docker 镜像构建与发布。
执行如下命令即可构建基础镜像:
-> 这里镜像 tag 以 4.4.0 为例,本项目所维护的 Dockerfile 文件考虑了跨平台兼容性。 如果你需要用到 arm64 架构镜像, 则在arm64 架构机器上同样执行下面的构建命令即可
+> 这里镜像 tag 以 5.0.0 为例,本项目所维护的 Dockerfile 文件考虑了跨平台兼容性。 如果你需要用到 arm64 架构镜像, 则在arm64 架构机器上同样执行下面的构建命令即可
```shell
-docker build --tag keking/kkfileview-base:4.4.0 .
+docker build --tag keking/kkfileview-base:5.0.0 .
```
@@ -46,5 +46,5 @@ docker build --tag keking/kkfileview-base:4.4.0 .
现在就可以愉快地开始构建了,构建命令示例:
```shell
-docker buildx build --platform=linux/amd64,linux/arm64 -t keking/kkfileview-base:4.4.0 --push .
+docker buildx build --platform=linux/amd64,linux/arm64 -t keking/kkfileview-base:5.0.0 --push .
```
diff --git a/docker/kkfileview-base/README.md b/docker/kkfileview-base/README.md
index 95f840f6..e1fa6850 100644
--- a/docker/kkfileview-base/README.md
+++ b/docker/kkfileview-base/README.md
@@ -8,10 +8,10 @@ Then, use kkfileview-base as the base image to build and speed up the kkfileview
To build the base image, run the following command:
-> In this example, the image tag is 4.4.0. The Dockerfile maintained in this project considers cross-platform compatibility. If you need an arm64 architecture image, run the same build command on an arm64 architecture machine.
+> In this example, the image tag is 5.0.0. The Dockerfile maintained in this project considers cross-platform compatibility. If you need an arm64 architecture image, run the same build command on an arm64 architecture machine.
```shell
-docker build --tag keking/kkfileview-base:4.4.0 .
+docker build --tag keking/kkfileview-base:5.0.0 .
```
@@ -49,5 +49,5 @@ Assuming the current machine is amd64 (x86_64) architecture, you'll need to enab
Now you can enjoy the building. Here’s an example build command:
```shell
-docker buildx build --platform=linux/amd64,linux/arm64 -t keking/kkfileview-base:4.4.0 --push .
+docker buildx build --platform=linux/amd64,linux/arm64 -t keking/kkfileview-base:5.0.0 --push .
```
diff --git a/pom.xml b/pom.xml
index ae0b4894..61e104db 100644
--- a/pom.xml
+++ b/pom.xml
@@ -6,7 +6,7 @@
cn.keking
kkFileView-parent
- 5.0
+ 5.0.0
@@ -110,4 +110,4 @@
github
https://github.com/kekingcn/kkFileView/issues
-
\ No newline at end of file
+
diff --git a/server/pom.xml b/server/pom.xml
index b815f309..bf620c30 100644
--- a/server/pom.xml
+++ b/server/pom.xml
@@ -6,7 +6,7 @@
kkFileView-parent
cn.keking
- 5.0
+ 5.0.0
kkFileView
diff --git a/server/src/main/bin/startup.bat b/server/src/main/bin/startup.bat
index 2c56460f..4f4ff07a 100644
--- a/server/src/main/bin/startup.bat
+++ b/server/src/main/bin/startup.bat
@@ -1,10 +1,20 @@
@echo off
set "KKFILEVIEW_BIN_FOLDER=%cd%"
cd "%KKFILEVIEW_BIN_FOLDER%"
+set "JAR_NAME="
+for %%F in (kkFileView-*.jar) do (
+ set "JAR_NAME=%%~nxF"
+ goto :jar_found
+)
+echo Error: kkFileView jar not found in %KKFILEVIEW_BIN_FOLDER%
+exit /b 1
+
+:jar_found
echo Using KKFILEVIEW_BIN_FOLDER %KKFILEVIEW_BIN_FOLDER%
+echo Using JAR_NAME %JAR_NAME%
echo Starting kkFileView...
echo Please check log file in ../log/kkFileView.log for more information
echo You can get help in our official home site: https://kkview.cn
echo If you need further help, please join our kk opensource community: https://t.zsxq.com/09ZHSXbsQ
echo If this project is helpful to you, please star it on https://gitee.com/kekingcn/file-online-preview/stargazers
-java -Dspring.config.location=..\config\application.properties -jar kkFileView-4.4.0.jar -> ..\log\kkFileView.log
+java -Dspring.config.location=..\config\application.properties -jar "%JAR_NAME%" > ..\log\kkFileView.log 2>&1
diff --git a/server/src/main/bin/startup.sh b/server/src/main/bin/startup.sh
index fb1a3d8b..da3a4aa6 100644
--- a/server/src/main/bin/startup.sh
+++ b/server/src/main/bin/startup.sh
@@ -49,9 +49,16 @@ else
fi
fi
+ JAR_PATH=$(ls kkFileView-*.jar 2>/dev/null | head -n 1)
+ if [ -z "${JAR_PATH}" ]; then
+ echo "kkFileView jar not found in ${KKFILEVIEW_BIN_FOLDER}"
+ exit 1
+ fi
+
## 启动kkFileView
echo "Starting kkFileView..."
- nohup java -Dfile.encoding=UTF-8 -Dspring.config.location=../config/application.properties -jar kkFileView-4.4.0.jar > ../log/kkFileView.log 2>&1 &
+ echo "Using jar ${JAR_PATH}"
+ nohup java -Dfile.encoding=UTF-8 -Dspring.config.location=../config/application.properties -jar "${JAR_PATH}" > ../log/kkFileView.log 2>&1 &
echo "Please execute ./showlog.sh to check log for more information"
echo "You can get help in our official home site: https://kkview.cn"
echo "If you need further help, please join our kk opensource community: https://t.zsxq.com/09ZHSXbsQ"