feat: 支持通过配置独立控制 JS/CSS 资源缓存版本号

README.md

@@ -17,6 +17,7 @@
 
 > 更多功能正在持续开发... 欢迎交流评论
 
+- 支持通过 `admin.assets_version` 配置项（或 `ADMIN_ASSETS_VERSION` 环境变量）自定义 JS/CSS 缓存破坏版本号，不再强制跟随框架版本
 - [2025/08/05 增强对枚举字段的渲染支持](https://github.com/PrintNow/dcat-admin/pull/5)
 - [@deflinhec : 修正 Grid 以 LazyRenderable 呈現時Group Filter 沒有正確篩選](https://github.com/PrintNow/dcat-admin/commit/4390a8f494c20910828e7c93513d13032f0d01dd)
 - [新增 highlightjs 类以支持代码块高亮显示](https://github.com/PrintNow/dcat-admin/commit/52050882eea475b9d3863ace98048404f7d320b7)

config/admin.php

@@ -106,6 +106,18 @@
    */
     'assets_server' => env('ADMIN_ASSETS_SERVER'),
 
+    /*
+    |--------------------------------------------------------------------------
+    | Assets version
+    |--------------------------------------------------------------------------
+    |
+    | The version string appended to JS/CSS URLs as a cache-busting query
+    | parameter (e.g. `?v1.0.0`). Defaults to the framework version. Set to
+    | null/empty to disable the version query entirely.
+    |
+    */
+    'assets_version' => env('ADMIN_ASSETS_VERSION'),
+
     /**
      * @deprecated 不再建议使用此配置。如果你使用了反向代理，配置好 `app/Http/Middleware/TrustProxies.php` 中的 $proxies 属性，
      *             页面就会自动使用 https 协议。未来将完全移除此配置。

src/Console/stubs/config.stub

@@ -104,6 +104,18 @@ return [
    */
     'assets_server' => env('ADMIN_ASSETS_SERVER'),
 
+    /*
+    |--------------------------------------------------------------------------
+    | Assets version
+    |--------------------------------------------------------------------------
+    |
+    | The version string appended to JS/CSS URLs as a cache-busting query
+    | parameter (e.g. `?v1.0.0`). Defaults to the framework version. Set to
+    | null/empty to disable the version query entirely.
+    |
+    */
+    'assets_version' => env('ADMIN_ASSETS_VERSION'),
+
     /*
     |--------------------------------------------------------------------------
     | Access via `https`

src/Layout/Asset.php

@@ -689,7 +689,13 @@ public function withVersionQuery($url)
             $url .= '?';
         }
 
-        $ver = 'v'.Admin::VERSION;
+        $assetsVersion = config('admin.assets_version', Admin::VERSION);
+
+        if (! $assetsVersion) {
+            return rtrim($url, '?');
+        }
+
+        $ver = 'v'.$assetsVersion;
 
         return Str::endsWith($url, '?') ? $url.$ver : $url.'&'.$ver;
     }