Discuz! X 增量升级补丁生成工具

IsaacZ

DiscuzPatchCreator 使用说明

一个 Windows 下的单文件命令行工具，用于对比两个 Discuz! X 安装包（zip）的差异，并生成一个补丁包，方便从旧版本升级到新版本时只替换变动的文件。

工具文件名：DiscuzPatchCreator.bat（自包含单文件，双击即用）

---

一、它能做什么

• 下载你提供的两个 Discuz! X 安装包 zip（旧版本 与 新版本），生成补丁包 zip
  

---

二、运行环境

• 操作系统：Windows 10 / Windows 11（自带 PowerShell，无需安装任何东西）。
  

---

三、使用方法

方式一：双击运行（推荐）

• 双击 DiscuzPatchCreator.bat。
• 按提示分别粘贴两个 zip 的下载网址：
  
  • 先输入【旧版本】网址；
  • 再输入【新版本】网址。
    
• 回车后自动下载、解压、比对、生成补丁。
• 完成后屏幕会提示「按任意键关闭窗口」，按任意键即可关闭（避免一闪而过看不到结果）。
  

方式二：命令行直接传参

1. DiscuzPatchCreator.bat   -OldUrl   "旧版本zip网址"   -NewUrl   "新版本zip网址"
   

复制代码

可选参数：

参数	说明
-OldUrl "..."	旧版本 zip 下载网址（起始）
-NewUrl "..."	新版本 zip 下载网址（结束）
-KeepWork	保留解压临时目录（默认运行完自动删除，便于排查）

示例：

1. DiscuzPatchCreator.bat ^
   
2.   -OldUrl "https://gitee.com/Discuz/DiscuzX/releases/download/v3.5-20260504/Discuz_X3.5_SC_UTF8_20260504.zip" ^
   
3.   -NewUrl "https://gitee.com/Discuz/DiscuzX/attach_files/2979888/download"
   

复制代码

演示图：

---

四、关于下载网址

工具只需要两个可直接下载的 zip 网址：

• 附件直链（形如，数字为附件 ID）：
  https://gitee.com/Discuz/DiscuzX/attach_files/<id>/download
  

如何拿到附件直链：用浏览器登录 Gitee 后，在
https://gitee.com/Discuz/DiscuzX/attach_files 页面找到对应版本，
右键复制「下载」链接（形如 .../attach_files/<id>/download）即可。

---

五、输出说明

补丁包生成在脚本所在目录，命名为：

1. patch_<旧文件名>_to_<新文件名>.zip
   

复制代码

补丁包内结构：

内容	说明
各目录下的文件	新增 / 变更 的文件，按原目录结构存放
deleted_files.txt	相对路径清单，升级时需按此删除这些文件
patch_info.txt	生成时间、版本、网址、统计数与操作步骤

---

六、如何应用补丁（升级步骤）

• 将补丁 zip 内，除 deleted_files.txt / patch_info.txt 之外的所有文件，
  按相同目录结构覆盖到 Discuz 站点根目录。
• 若存在 deleted_files.txt，按其中的相对路径删除对应文件。
• 如涉及额外升级流程，以 Discuz! 官方发布的升级流程为准。
  

---

七、临时目录说明

工具运行时会创建以下目录（均在脚本所在目录）：

目录	用途	运行后
_cache	已下载的 zip（命中则跳过下载）	保留，可作缓存
_work	解压后的新旧版本文件	默认删除（-KeepWork 时保留）
_patch	补丁打包前的暂存区	删除

下载地址：

DiscuzPatchCreator.zip (5.96 KB, 下载次数: 0)

6 天前 上传

点击文件名下载附件