refactor: 静态资源缓存破坏改为文件级哈希，重启不刷新未修改文件的缓存

- 启动时计算每个 JS/CSS 的 SHA-1 前 8 位作为版本号
- 文件不变则哈希不变，浏览器继续用缓存，重启零压力
- 替换全局 AssetVersion 为 assetV 模板函数，按文件路径查询哈希
- 移除 BuildPageData 中的全局版本号注入

cmd/server/main.go

@@ -3,6 +3,7 @@ package main
 import (
 	"log"
 
+	"metazone.cc/metalab/internal/common"
 	"metazone.cc/metalab/internal/config"
 	"metazone.cc/metalab/internal/model"
 	"metazone.cc/metalab/internal/router"
@@ -48,6 +49,9 @@ func main() {
 
 	r := gin.Default()
 
+	// 计算静态资源哈希（用于缓存破坏，文件不变哈希不变）
+	common.ComputeAssetHashes("templates/MetaLab-2026")
+
 	// 模板加载（前端主题 + 管理后台）
 	tmpl, err := theme.LoadTemplates(
 		theme.TemplateRoot{Dir: "templates/MetaLab-2026/html", Prefix: ""},

internal/common/helper.go

@@ -1,23 +1,105 @@
 package common
 
 import (
+	"crypto/sha1"
+	"encoding/hex"
 	"fmt"
+	"io/fs"
+	"log"
 	"net/http"
 	"net/url"
+	"os"
+	"path/filepath"
 	"regexp"
-	"strconv"
+	"sync"
-	"time"
 
 	"metazone.cc/metalab/internal/model"
 
 	"github.com/gin-gonic/gin"
 )
 
-// AssetVersion 静态资源版本号（服务启动时生成，重启即刷新缓存）
+// assetHashes 静态资源文件哈希表（URL 路径 → 短哈希，文件不变哈希不变）
-var AssetVersion string
+var (
+	assetHashes map[string]string
+	assetOnce   sync.Once
+)
 
-func init() {
+// ComputeAssetHashes 遍历 static 目录，计算每个文件的 SHA-1 前 8 位作为版本号
-	AssetVersion = strconv.FormatInt(time.Now().Unix(), 36)
+func ComputeAssetHashes(templateDir string) {
+	assetHashes = make(map[string]string)
+	staticDir := filepath.Join(templateDir, "static")
+	filepath.WalkDir(staticDir, func(path string, d fs.DirEntry, err error) error {
+		if err != nil || d.IsDir() {
+			return nil
+		}
+		// 只处理 .js 和 .css
+		ext := filepath.Ext(path)
+		if ext != ".js" && ext != ".css" {
+			return nil
+		}
+		data, err := os.ReadFile(path)
+		if err != nil {
+			return nil
+		}
+		h := sha1.Sum(data)
+		shortHash := hex.EncodeToString(h[:])[:8]
+		// 生成 URL 路径：/static/...
+		rel, _ := filepath.Rel(filepath.Dir(templateDir), path)
+		urlPath := "/" + filepath.ToSlash(rel)
+		assetHashes[urlPath] = shortHash
+		return nil
+	})
+	// 也处理 shared/static 目录
+	sharedDir := filepath.Join(filepath.Dir(templateDir), "shared", "static")
+	filepath.WalkDir(sharedDir, func(path string, d fs.DirEntry, err error) error {
+		if err != nil || d.IsDir() {
+			return nil
+		}
+		ext := filepath.Ext(path)
+		if ext != ".js" && ext != ".css" {
+			return nil
+		}
+		data, err := os.ReadFile(path)
+		if err != nil {
+			return nil
+		}
+		h := sha1.Sum(data)
+		shortHash := hex.EncodeToString(h[:])[:8]
+		rel, _ := filepath.Rel(filepath.Dir(templateDir), path)
+		urlPath := "/" + filepath.ToSlash(rel)
+		assetHashes[urlPath] = shortHash
+		return nil
+	})
+	// 也处理 admin/static 目录
+	adminDir := filepath.Join(filepath.Dir(templateDir), "admin", "static")
+	filepath.WalkDir(adminDir, func(path string, d fs.DirEntry, err error) error {
+		if err != nil || d.IsDir() {
+			return nil
+		}
+		ext := filepath.Ext(path)
+		if ext != ".js" && ext != ".css" {
+			return nil
+		}
+		data, err := os.ReadFile(path)
+		if err != nil {
+			return nil
+		}
+		h := sha1.Sum(data)
+		shortHash := hex.EncodeToString(h[:])[:8]
+		rel, _ := filepath.Rel(filepath.Dir(templateDir), path)
+		urlPath := "/" + filepath.ToSlash(rel)
+		assetHashes[urlPath] = shortHash
+		return nil
+	})
+	log.Printf("[AssetHashes] computed %d file hashes", len(assetHashes))
+}
+
+// AssetV 返回指定静态资源的哈希版本号（模板函数）
+func AssetV(path string) string {
+	if h, ok := assetHashes[path]; ok {
+		return h
+	}
+	return "0"
 }
 
 // mdImageRe 匹配 Markdown 图片语法 ![alt](url)
@@ -57,8 +139,6 @@ func BuildPageData(c *gin.Context, extra gin.H) gin.H {
 	if isMaintenance, exists := c.Get("is_maintenance"); exists {
 		data["IsMaintenance"] = isMaintenance
 	}
-	// 注入静态资源版本号
-	data["V"] = AssetVersion
 	return data
 }
 

internal/theme/loader.go

@@ -6,6 +6,8 @@ import (
 	"os"
 	"path/filepath"
 	"strings"
+
+	"metazone.cc/metalab/internal/common"
 )
 
 // TemplateRoot 模板根目录配置
@@ -21,6 +23,7 @@ func LoadTemplates(roots ...TemplateRoot) (*template.Template, error) {
 		"add":        func(a, b int) int { return a + b },
 		"subtract":   func(a, b int) int { return a - b },
 		"formatTTL": formatTTL,
+		"assetV":     common.AssetV,
 	}
 	t := template.New("").Funcs(funcMap)
 	for _, root := range roots {

templates/MetaLab-2026/html/auth/login.html

@@ -42,7 +42,7 @@
     <svg class="icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><line x1="12" y1="19" x2="12" y2="5"/><polyline points="5 12 12 5 19 12"/></svg>
 </button>
 
-<script src="/static/js/common.js?v={{.V}}"></script>
+<script src="/static/js/common.js?v={{assetV "/static/js/common.js"}}"></script>
-<script src="/static/js/login.js?v={{.V}}"></script>
+<script src="/static/js/login.js?v={{assetV "/static/js/login.js"}}"></script>
 </body>
 </html>

templates/MetaLab-2026/html/auth/register.html

@@ -89,7 +89,7 @@
     <svg class="icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><line x1="12" y1="19" x2="12" y2="5"/><polyline points="5 12 12 5 19 12"/></svg>
 </button>
 
-<script src="/static/js/common.js?v={{.V}}"></script>
+<script src="/static/js/common.js?v={{assetV "/static/js/common.js"}}"></script>
-<script src="/static/js/register.js?v={{.V}}"></script>
+<script src="/static/js/register.js?v={{assetV "/static/js/register.js"}}"></script>
 </body>
 </html>

templates/MetaLab-2026/html/home/index.html

@@ -37,6 +37,6 @@
 
 {{template "layout/footer.html" .}}
 
-<script src="/static/js/common.js?v={{.V}}"></script>
+<script src="/static/js/common.js?v={{assetV "/static/js/common.js"}}"></script>
 </body>
 </html>

templates/MetaLab-2026/html/layout/header.html

@@ -13,9 +13,9 @@
 {{if .OgURL}}<meta property="og:url" content="{{.OgURL}}">{{end}}
 {{end}}
 <title>{{.Title}} - MetaLab</title>
-<link rel="stylesheet" href="/static/css/common.css?v={{.V}}">
+<link rel="stylesheet" href="/static/css/common.css?v={{assetV "/static/css/common.css"}}">
 {{if .ExtraCSS}}
-<link rel="stylesheet" href="{{.ExtraCSS}}?v={{.V}}">
+<link rel="stylesheet" href="{{.ExtraCSS}}?v={{assetV .ExtraCSS}}">
 {{end}}
-<script src="/shared/static/js/utils.js"></script>
+<script src="/shared/static/js/utils.js?v={{assetV "/shared/static/js/utils.js"}}"></script>
 </head>

templates/MetaLab-2026/html/messages/index.html

@@ -202,6 +202,6 @@
     }
 })();
 </script>
-<script src="/static/js/common.js?v={{.V}}"></script>
+<script src="/static/js/common.js?v={{assetV "/static/js/common.js"}}"></script>
 </body>
 </html>

templates/MetaLab-2026/html/posts/404.html

@@ -9,6 +9,6 @@
     </div>
 </div>
 {{template "layout/footer.html" .}}
-<script src="/static/js/common.js?v={{.V}}"></script>
+<script src="/static/js/common.js?v={{assetV "/static/js/common.js"}}"></script>
 </body>
 </html>

templates/MetaLab-2026/html/posts/index.html

@@ -53,6 +53,6 @@
 
 {{template "layout/footer.html" .}}
 
-<script src="/static/js/common.js?v={{.V}}"></script>
+<script src="/static/js/common.js?v={{assetV "/static/js/common.js"}}"></script>
 </body>
 </html>

templates/MetaLab-2026/html/posts/new.html

@@ -62,9 +62,9 @@
 
 {{template "layout/footer.html" .}}
 
-<link rel="stylesheet" href="/static/vditor/dist/index.css">
+<link rel="stylesheet" href="/static/vditor/dist/index.css?v={{assetV "/static/vditor/dist/index.css"}}">
-<script src="/static/vditor/dist/index.min.js"></script>
+<script src="/static/vditor/dist/index.min.js?v={{assetV "/static/vditor/dist/index.min.js"}}"></script>
-<script src="/static/js/common.js?v={{.V}}"></script>
+<script src="/static/js/common.js?v={{assetV "/static/js/common.js"}}"></script>
-<script type="module" src="/static/js/editor.js?v={{.V}}"></script>
+<script type="module" src="/static/js/editor.js?v={{assetV "/static/js/editor.js"}}"></script>
 </body>
 </html>

templates/MetaLab-2026/html/posts/show.html

@@ -48,10 +48,10 @@
 {{/* MD 内容安全传递给 JS */}}
 <textarea id="postMdContent" style="display:none">{{.Post.Body}}</textarea>
 
-<link rel="stylesheet" href="/static/vditor/dist/index.css">
+<link rel="stylesheet" href="/static/vditor/dist/index.css?v={{assetV "/static/vditor/dist/index.css"}}">
-<script src="/static/vditor/dist/method.min.js"></script>
+<script src="/static/vditor/dist/method.min.js?v={{assetV "/static/vditor/dist/method.min.js"}}"></script>
-<script src="/static/js/common.js?v={{.V}}"></script>
+<script src="/static/js/common.js?v={{assetV "/static/js/common.js"}}"></script>
-<script src="/static/js/shortcode.js?v={{.V}}"></script>
+<script src="/static/js/shortcode.js?v={{assetV "/static/js/shortcode.js"}}"></script>
 <script>
 (function() {
     var el = document.getElementById('postContent');

templates/MetaLab-2026/html/settings/index.html

@@ -253,7 +253,7 @@
     </div>
 </div>
 
-<script src="/static/js/common.js?v={{.V}}"></script>
+<script src="/static/js/common.js?v={{assetV "/static/js/common.js"}}"></script>
 <script>
 (function () {
     'use strict';

templates/MetaLab-2026/html/space/index.html

@@ -88,6 +88,6 @@
 
 {{template "layout/footer.html" .}}
 
-<script src="/static/js/common.js?v={{.V}}"></script>
+<script src="/static/js/common.js?v={{assetV "/static/js/common.js"}}"></script>
 </body>
 </html>

templates/MetaLab-2026/html/studio/write.html

@@ -64,9 +64,9 @@
 
 {{template "layout/footer.html" .}}
 
-<link rel="stylesheet" href="/static/vditor/dist/index.css">
+<link rel="stylesheet" href="/static/vditor/dist/index.css?v={{assetV "/static/vditor/dist/index.css"}}">
-<script src="/static/vditor/dist/index.min.js"></script>
+<script src="/static/vditor/dist/index.min.js?v={{assetV "/static/vditor/dist/index.min.js"}}"></script>
-<script src="/static/js/common.js?v={{.V}}"></script>
+<script src="/static/js/common.js?v={{assetV "/static/js/common.js"}}"></script>
-<script src="/static/js/studio-editor.js?v={{.V}}"></script>
+<script src="/static/js/studio-editor.js?v={{assetV "/static/js/studio-editor.js"}}"></script>
 </body>
 </html>

templates/admin/html/layout/base.html

@@ -5,7 +5,7 @@
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 {{if .CSRFToken}}<meta name="csrf-token" content="{{.CSRFToken}}">{{end}}
 <title>{{.Title}} - MetaLab 管理面板</title>
-<link rel="stylesheet" href="/admin/static/css/common.css">
+<link rel="stylesheet" href="/admin/static/css/common.css?v={{assetV "/admin/static/css/common.css"}}">
 {{if .ExtraCSS}}
 <link rel="stylesheet" href="{{.ExtraCSS}}">
 {{end}}

templates/admin/html/layout/footer.html

@@ -1,7 +1,7 @@
     </main>
 </div>
-<script src="/shared/static/js/utils.js?v={{.V}}"></script>
+<script src="/shared/static/js/utils.js?v={{assetV "/shared/static/js/utils.js"}}"></script>
-<script src="/admin/static/js/common.js?v={{.V}}"></script>
+<script src="/admin/static/js/common.js?v={{assetV "/admin/static/js/common.js"}}"></script>
 {{if .ExtraJS}}
 <script src="{{.ExtraJS}}"></script>
 {{end}}

templates/admin/html/posts/index.html

@@ -82,5 +82,5 @@
         </div>
         {{end}}
 
-<script src="/admin/static/js/posts.js?v={{.V}}"></script>
+<script src="/admin/static/js/posts.js?v={{assetV "/admin/static/js/posts.js"}}"></script>
 {{template "admin/layout/footer.html" .}}