为什么

这插件就是我自己需要才做出来的，需求很简单：后台能传文件、前台能展示版本列表和下载按钮，完事。写着写着发现结构还算完整，想着应该有人跟我有同样的需求，干脆开源分享出来，谁用得上谁拿去。

断断续续打磨了一阵子，小栈版本管理插件（xzdbk-version-manager）V1.0.0 今天总算能拿出来了。

大佬们轻拍，代码水平有限且 AI 功劳很大，二开随意。

这插件能干啥

核心就一件事：管版本，给下载。

后台长这样：

卡片式的项目列表，新建、编辑、删除都很顺手。删的时候有二次确认，手滑了也不慌。

每个项目独立管理，名字、标识（slug）、描述随便填。

上传文件有两种路子

• 直接传 ZIP 包，自动存到 wp-content/uploads/xzdbk-versions/项目名/ 目录下，规规矩矩不乱放；
• 填外部链接，适合把文件丢网盘或云存储的朋友。版本号、文件名、下载地址填上就行。

不管哪种方式，下载次数都会自动记下来。

前台怎么展示

不用写一行代码。在 WordPress 外观 → 小工具里，拖一个「xzdbk – 版本管理」进去，完事。

一个小工具里包含了这些东西：

头部信息区：

• 项目名称 + 描述
• 最新版本号、发布日期、文件大小
• 最新更新日志（滚动区域，最高 240px，多了滑动看）

下面分了 4 个标签页：

1. 项目概览：四个统计卡片——总版本数、总下载量、总文件大小、最近更新时间。下面紧跟最新版本的详情。
2. 版本列表：完整的版本表格，带分页，版本多了也不卡。
3. 下载中心：最新版大卡片 + 历史版本大卡片，重点突出，用户一眼能找到想下的。
4. 更新日志：可折叠面板，自动识别日志类型并着色——
   • 🟢 新增
   • 🟡 修复
   • 🔵 优化
   • 🟣 改进

颜色区分后，用户扫一眼就知道每次更新干了啥。

关于子比主题的适配

这个得单独说一嘴。

我自己在用子比，所以做的时候专门做了深度适配。如果检测到子比主题激活，会自动复用 zib-widget、box-body、title-h-left、but jb-blue 这些原生样式，暗色模式也自动跟着走。

不是子比主题的站点也没问题，我写了完整的 fallback 样式，视觉上是一致的，不会裸奔。

几个贴心的小开关

后台设置里放了几个自由度比较高的选项：

• 全局盒子开关：一键关掉所有内部背景和边框，变成纯平风格；
• 卡片背景独立开关：单独控制要不要卡片背景；
• 更新日志显示开关；
• 默认激活哪个标签页，自己选；
• 日志默认折叠还是展开，也自己定。

批量删除旧版本也支持——勾选版本表格里的复选框，一键清理，不用一个一个点。

安装步骤（老司机跳过）

1. 上传插件文件夹到 /wp-content/plugins/
2. 后台激活
3. 进入「版本管理」→ 新建项目
4. 上传版本（本地或外部链接都行）
5. 外观 → 小工具 → 拖入「xzdbk – 版本管理」

就这几步，没了。