diff --git a/extend/base/admin/service/adminUpdateCodeData/v2.5.0.php b/extend/base/admin/service/adminUpdateCodeData/v2.5.0.php
new file mode 100644
index 0000000..a1bf317
--- /dev/null
+++ b/extend/base/admin/service/adminUpdateCodeData/v2.5.0.php
@@ -0,0 +1,235 @@
+<?php
+/**
+ * @internal-framework
+ *
+ * 此文件为框架内置功能
+ *
+ * 用途：框架版本更新代码（v2.5.0）- S3 / WebDAV 存储支持存量升级
+ * 维护者：框架维护者
+ *
+ * 变更：
+ *   - system_config 新增 upload 组 12 条存储配置（与 adminInitData/SystemConfig.php 种子一致）
+ *       s3_access_key / s3_secret_key / s3_region / s3_bucket / s3_endpoint /
+ *       s3_path_style / s3_domain
+ *       webdav_url / webdav_username / webdav_password / webdav_prefix / webdav_domain
+ *   - system_config.upload_allow_type 追加合并 s3、webdav（保留用户自定义值与原顺序）
+ *   - 清理 sysconfig 缓存（tag=sysconfig，TTL 3600s，脚本直改 DB 不清则
+ *     in: 校验 1 小时内拒绝新上传方式）
+ *
+ * 设计说明：
+ *   - 幂等 check-then-insert：新配置用 (group, name) 检查存在性
+ *   - upload_allow_type 为追加合并而非整体覆盖：仅在缺失时 append，已有自定义值不动
+ *   - 表前缀取默认连接配置（database.default 指向的连接），不写死 mysql 连接——
+ *     本项目默认连接是 main，自定义前缀项目上 connections.mysql.prefix 会取错前缀
+ *
+ * 注意：此文件属于框架内核，业务开发者不应修改
+ */
+
+use think\console\Input;
+use think\console\Output;
+use think\facade\Cache;
+use think\facade\Db;
+
+class UpdateFunction
+{
+    /**
+     * @var Input
+     */
+    public $input;
+
+    /**
+     * @var Output
+     */
+    public $output;
+
+    /**
+     * 待新增 sysconfig 配置（upload 组，S3 / WebDAV 存储）.
+     * 字段顺序与 adminInitData/SystemConfig.php 一致：name/group/value/remark/sort.
+     */
+    public $newConfigs = [
+        [
+            'name'   => 's3_access_key',
+            'group'  => 'upload',
+            'value'  => '填你的',
+            'remark' => 'S3公钥',
+            'sort'   => 0,
+        ],
+        [
+            'name'   => 's3_secret_key',
+            'group'  => 'upload',
+            'value'  => '填你的',
+            'remark' => 'S3私钥',
+            'sort'   => 0,
+        ],
+        [
+            'name'   => 's3_region',
+            'group'  => 'upload',
+            'value'  => '填你的',
+            'remark' => 'S3地域',
+            'sort'   => 0,
+        ],
+        [
+            'name'   => 's3_bucket',
+            'group'  => 'upload',
+            'value'  => '填你的',
+            'remark' => 'S3空间名称',
+            'sort'   => 0,
+        ],
+        [
+            'name'   => 's3_endpoint',
+            'group'  => 'upload',
+            'value'  => '',
+            'remark' => 'S3自定义端点(兼容MinIO等,留空用AWS官方)',
+            'sort'   => 0,
+        ],
+        [
+            'name'   => 's3_path_style',
+            'group'  => 'upload',
+            'value'  => '0',
+            'remark' => 'S3路径风格(1开启,MinIO建议)',
+            'sort'   => 0,
+        ],
+        [
+            'name'   => 's3_domain',
+            'group'  => 'upload',
+            'value'  => '填你的',
+            'remark' => 'S3访问域名',
+            'sort'   => 0,
+        ],
+        [
+            'name'   => 'webdav_url',
+            'group'  => 'upload',
+            'value'  => '填你的',
+            'remark' => 'WebDAV服务地址',
+            'sort'   => 0,
+        ],
+        [
+            'name'   => 'webdav_username',
+            'group'  => 'upload',
+            'value'  => '填你的',
+            'remark' => 'WebDAV账户',
+            'sort'   => 0,
+        ],
+        [
+            'name'   => 'webdav_password',
+            'group'  => 'upload',
+            'value'  => '填你的',
+            'remark' => 'WebDAV密码',
+            'sort'   => 0,
+        ],
+        [
+            'name'   => 'webdav_prefix',
+            'group'  => 'upload',
+            'value'  => '',
+            'remark' => 'WebDAV存储前缀',
+            'sort'   => 0,
+        ],
+        [
+            'name'   => 'webdav_domain',
+            'group'  => 'upload',
+            'value'  => '填你的',
+            'remark' => 'WebDAV访问域名',
+            'sort'   => 0,
+        ],
+    ];
+
+    /**
+     * upload_allow_type 待追加的上传方式（追加合并，不覆盖已有值）.
+     */
+    public $allowTypeAppend = ['s3', 'webdav'];
+
+    public function update()
+    {
+        $this->output->writeln('更新代码');
+
+        $this->output->info('v2.5.0：S3 / WebDAV 存储支持存量升级（补齐 12 条 sysconfig + upload_allow_type 追加 s3、webdav）');
+
+        // 表前缀从默认连接取（database.default 指向的连接），不能写死 connections.mysql
+        $prefix = config('database.connections.' . config('database.default') . '.prefix', 'ul_');
+        $configTable = $prefix . 'system_config';
+
+        // 确认表存在（防御性检查）
+        $tablesExist = Db::query(
+            'SELECT TABLE_NAME FROM information_schema.TABLES WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = ?',
+            [$configTable]
+        );
+        if (empty($tablesExist)) {
+            $this->output->warning("表 {$configTable} 不存在，跳过数据补齐。请先执行 scheme:sync 或 migrate:run 初始化表结构。");
+
+            return;
+        }
+
+        // ==================== 新配置幂等补齐（check-then-insert）====================
+        $configAdded = 0;
+        $configSkipped = 0;
+        foreach ($this->newConfigs as $cfg) {
+            // 幂等：用 (group, name) 检查存在性
+            $exists = Db::name('system_config')
+                ->where('group', $cfg['group'])
+                ->where('name', $cfg['name'])
+                ->find();
+            if ($exists) {
+                $this->output->writeln("  - 配置 {$cfg['group']}.{$cfg['name']} 已存在，跳过");
+                ++$configSkipped;
+                continue;
+            }
+
+            Db::name('system_config')->insert($cfg);
+            $this->output->writeln("  - 新增配置 {$cfg['group']}.{$cfg['name']} 完成");
+            ++$configAdded;
+        }
+
+        // ==================== upload_allow_type 追加合并（不覆盖用户自定义值）====================
+        $typesAppended = [];
+        $allowRow = Db::name('system_config')
+            ->where('group', 'upload')
+            ->where('name', 'upload_allow_type')
+            ->find();
+        if (!$allowRow) {
+            // 不存在则插入完整默认值（与种子 adminInitData/SystemConfig.php 一致）
+            Db::name('system_config')->insert([
+                'name'   => 'upload_allow_type',
+                'group'  => 'upload',
+                'value'  => 'local_public,alioss,qnoss,txcos,s3,webdav',
+                'remark' => '可用的上传文件方式',
+                'sort'   => 0,
+            ]);
+            $this->output->writeln('  - 新增配置 upload.upload_allow_type 完成（默认全集）');
+            ++$configAdded;
+        } else {
+            // 追加合并：过滤空串项后逐个 append，保持原顺序与用户自定义值不动
+            $types = array_values(array_filter(explode(',', (string) $allowRow['value']), function ($item) {
+                return $item !== '';
+            }));
+            foreach ($this->allowTypeAppend as $type) {
+                if (!in_array($type, $types, true)) {
+                    $types[] = $type;
+                    $typesAppended[] = $type;
+                }
+            }
+            if (!empty($typesAppended)) {
+                Db::name('system_config')
+                    ->where('id', $allowRow['id'])
+                    ->update(['value' => implode(',', $types)]);
+                $this->output->writeln('  - 配置 upload.upload_allow_type 追加 ' . implode(',', $typesAppended) . ' 完成：' . implode(',', $types));
+            } else {
+                $this->output->writeln('  - 配置 upload.upload_allow_type 已含 ' . implode(',', $this->allowTypeAppend) . '，跳过');
+            }
+        }
+
+        // ==================== 清理 sysconfig 缓存 ====================
+        // 脚本直改 DB 绕过了 sysconfig() 的缓存失效逻辑（tag=sysconfig，TTL 3600s），
+        // 不清理则表单 in: 校验在缓存过期前会拒绝新上传方式
+        Cache::tag('sysconfig')->clear();
+        $this->output->writeln('  - 已清理 sysconfig 缓存（tag=sysconfig）');
+
+        $summary = "本次新增 {$configAdded} 条配置";
+        if (!empty($typesAppended)) {
+            $summary .= '，upload_allow_type 追加 ' . implode(',', $typesAppended);
+        }
+        $summary .= "，跳过 {$configSkipped} 条已存在";
+        $this->output->info($summary);
+
+        $this->output->writeln('更新代码完成');
+    }
+}