feat: add translated and phonetic lyric previews

fix: keep public security headers authoritative
merge: preserve concise public documentation
2026-08-26 00:59:33 +08:00 · 2026-08-25 23:17:42 +08:00 · 2026-08-25 23:10:13 +08:00 · 2026-08-25 23:08:28 +08:00 · 2026-08-25 14:51:17 +00:00
18 changed files with 1108 additions and 118 deletions
@@ -1,3 +1,4 @@
 .git
 dist
 *.exe
+public
@@ -9,6 +9,7 @@ RUN go test ./... \
 && mkdir -p /out/download \
 && CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -trimpath -ldflags="-s -w -X main.version=${VERSION}" -o /out/download/lrc-local-windows-amd64.exe . \
 && CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -trimpath -ldflags="-s -w -X main.version=${VERSION}" -o /out/download/lrc-local-linux-amd64 . \
+ && cp /out/download/lrc-local-linux-amd64 /out/lrc-local-server \
 && CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 go build -trimpath -ldflags="-s -w -X main.version=${VERSION}" -o /out/download/lrc-local-darwin-arm64 . \
 && CGO_ENABLED=0 GOOS=darwin GOARCH=amd64 go build -trimpath -ldflags="-s -w -X main.version=${VERSION}" -o /out/download/lrc-local-darwin-amd64 . \
 && cd /out/download \
@@ -18,9 +19,10 @@ RUN go test ./... \
 && rm lrc-local-linux-amd64 lrc-local-darwin-arm64 lrc-local-darwin-amd64 \
 && sha256sum lrc-local-* > SHA256SUMS

-FROM busybox:1.37.0-musl@sha256:fc6dddc4c44b1bfe37f41cae8e67d1693828e8f42a91862816d7953e2c9d3f23
-COPY public /srv
+FROM scratch
+COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/ca-certificates.crt
+COPY --from=builder /out/lrc-local-server /lrc-local
 COPY --from=builder /out/download /srv/download
 USER 65534:65534
 EXPOSE 8080
-ENTRYPOINT ["httpd", "-f", "-p", "8080", "-h", "/srv"]
+ENTRYPOINT ["/lrc-local", "--public", "--listen", "0.0.0.0:8080", "--origin", "https://lrc.flechazo.xin", "--downloads", "/srv/download"]
@@ -1,30 +1,19 @@
 # LRC Local

-一个本地优先的 QQ 音乐歌词搜索与导出工具，使用 Go 编写。
+一个可直接在网页使用、也提供可选本机版的 QQ 音乐歌词搜索与导出工具，使用 Go 编写。

-公开下载页：<https://lrc.flechazo.xin>
-
-## 为什么不是纯网页
-
-QQ 音乐接口拒绝第三方网页的跨域请求，并校验来源。浏览器页面无法安全地修改 `Origin` 和 `Referer`。LRC Local 因此以本机单文件程序运行：程序只监听随机的 `127.0.0.1` 端口，浏览器 UI 和外部请求均由用户自己的电脑处理；公开服务器只分发静态页面和二进制文件。
+网页：<https://lrc.flechazo.xin>

 ## 功能

 - 搜索歌曲并显示歌手、专辑和时长。
- 导出原文 `.lrc`、翻译 `.trans.lrc` 或无时间轴 `.txt`。
- 不创建账号，不保存搜索历史，不向本站服务器上传任何内容。
+- 完整歌词预览，可按歌曲实际内容选择仅原文、附带翻译、附带“音”，或同时附带两者。
+- 导出原文 LRC/TXT；有真实翻译时才提供翻译 LRC/TXT，有罗马音、韩语音译或方言注音时才提供“音” LRC/TXT。
+- 歌词来自 QQ 音乐 `GetPlayLyricInfo` 返回的原文、翻译与 `roma` 字段；本站不进行机器翻译，也不自行生成注音。
+- 网页版只转发到源码中固定的 QQ 音乐接口，不保存搜索词、歌词或历史。
+- 可选本机版只监听随机的 `127.0.0.1` 端口。

-## 安全边界
-
- 只监听操作系统分配的随机 IPv4 回环端口。
- 启动使用 256 位随机令牌，之后使用 `HttpOnly`、`SameSite=Strict` 会话 Cookie。
- 校验精确的 `Host` 和 `Origin`，不设置 CORS，拒绝 DNS rebinding 和跨站 API 请求。
- 只连接源码中固定的两个 HTTPS 接口；禁止重定向，不提供通用代理。
- 限制请求体、上游响应体、并发、频率和超时。
- 页面启用严格 CSP、禁止嵌入、禁止外部脚本和外部资源。
- 所有公开构建均提供 SHA-256 校验值；Linux 和 macOS 使用归档保留可执行权限。
-
-## 本地构建与测试
+## 构建

 ```sh
 go test ./...
@@ -32,16 +21,6 @@ go vet ./...
 go build -trimpath .
 ```

-运行：
+生产部署必须先提交并推送到自建 Gitea，再由生产机检出明确提交。容器无特权、根文件系统只读，Caddy 只反向代理 `127.0.0.1:8083`。

-```sh
-./lrc-local
-```
-
-## 部署
-
-生产变更必须先提交并推送到自建 Gitea，再由生产机检出明确提交。`docker compose up -d --build` 会从同一提交交叉编译四个平台的程序，并以无特权、只读容器提供静态下载页。Caddy 只反向代理 `127.0.0.1:8083`。
-
-## 声明
-
-本项目不是 QQ 音乐官方产品，QQ 音乐是其权利人的商标。使用者应遵守相关服务条款与著作权规则，只访问和使用自己有权获取的内容。
+本项目不是 QQ 音乐官方产品。请遵守相关服务条款与著作权规则，只使用自己有权获取的内容。
@@ -5,7 +5,7 @@ services:
    build:
      context: .
      args:
-        VERSION: v2026.08.25-r2
+        VERSION: v2026.08.26-r6
    restart: unless-stopped
    ports:
      - "127.0.0.1:8083:8080"
@@ -14,13 +14,13 @@ services:
      - no-new-privileges:true
    cap_drop:
      - ALL
-    pids_limit: 32
-    mem_limit: 64m
-    cpus: 0.25
+    pids_limit: 64
+    mem_limit: 128m
+    cpus: 0.5
    tmpfs:
      - /tmp:size=8m,mode=1777
    healthcheck:
-      test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1:8080/"]
+      test: ["CMD", "/lrc-local", "--healthcheck", "http://127.0.0.1:8080/health"]
      interval: 30s
      timeout: 3s
      retries: 3
@@ -23,12 +23,37 @@ var version = "dev"

 func main() {
 	noOpen := flag.Bool("no-open", false, "do not open the browser automatically")
+	publicMode := flag.Bool("public", false, "run the public web service")
+	listenAddress := flag.String("listen", "0.0.0.0:8080", "public web service listen address")
+	publicOrigin := flag.String("origin", "https://lrc.flechazo.xin", "allowed public browser origin")
+	downloadDirectory := flag.String("downloads", "", "directory containing optional local-app downloads")
+	healthcheckURL := flag.String("healthcheck", "", "check a running service and exit")
 	showVersion := flag.Bool("version", false, "print version and exit")
 	flag.Parse()
 	if *showVersion {
 		fmt.Println(version)
 		return
 	}
+	if *healthcheckURL != "" {
+		client := &http.Client{Timeout: 3 * time.Second}
+		response, err := client.Get(*healthcheckURL)
+		if err != nil {
+			log.Fatal(err)
+		}
+		_ = response.Body.Close()
+		if response.StatusCode != http.StatusOK {
+			log.Fatalf("healthcheck returned HTTP %d", response.StatusCode)
+		}
+		return
+	}
+	if *publicMode {
+		runPublic(*listenAddress, *publicOrigin, *downloadDirectory)
+		return
+	}
+	runLocal(*noOpen)
+}
+
+func runLocal(noOpen bool) {

 	listener, err := net.Listen("tcp4", "127.0.0.1:0")
 	if err != nil {
@@ -56,7 +81,7 @@ func main() {

 	launchURL := baseURL + "/start?t=" + token
 	fmt.Printf("LRC Local %s\n仅监听本机：%s\n关闭此窗口即可停止。\n", version, baseURL)
-	if !*noOpen {
+	if !noOpen {
 		go func() {
 			time.Sleep(150 * time.Millisecond)
 			if err := openBrowser(launchURL); err != nil {
@@ -71,6 +96,33 @@ func main() {
 	}
 }

+func runPublic(listenAddress, origin, downloadDirectory string) {
+	listener, err := net.Listen("tcp4", listenAddress)
+	if err != nil {
+		log.Fatal(err)
+	}
+	webFS, err := fs.Sub(embeddedWeb, "web")
+	if err != nil {
+		log.Fatal(err)
+	}
+	app, err := newPublicApp(origin, downloadDirectory, webFS, newQQClient())
+	if err != nil {
+		log.Fatal(err)
+	}
+	server := &http.Server{
+		Handler:           app.routes(),
+		ReadHeaderTimeout: 5 * time.Second,
+		ReadTimeout:       15 * time.Second,
+		WriteTimeout:      5 * time.Minute,
+		IdleTimeout:       60 * time.Second,
+		MaxHeaderBytes:    16 * 1024,
+	}
+	log.Printf("LRC Local %s public service listening on %s", version, listener.Addr())
+	if err := server.Serve(listener); err != nil && err != http.ErrServerClosed {
+		log.Fatal(err)
+	}
+}
+
 func randomToken() (string, error) {
 	buf := make([]byte, 32)
 	if _, err := rand.Read(buf); err != nil {
@@ -1,21 +0,0 @@
-<!doctype html>
-<html lang="zh-CN">
-<head>
-  <meta charset="utf-8">
-  <meta name="viewport" content="width=device-width,initial-scale=1">
-  <meta name="description" content="LRC Local：在你自己的电脑上搜索并导出 LRC 歌词。">
-  <title>LRC Local — 歌词只经过你的电脑</title>
-  <link rel="stylesheet" href="/site.css">
-</head>
-<body>
-  <main>
-    <nav><b>LRC <i>Local</i></b><a href="https://git.sighs.cc/Flechazo/lrc-local">查看源码 ↗</a></nav>
-    <section class="hero">
-      <div class="copy"><p class="tag">NO CLOUD · NO ACCOUNT · NO HISTORY</p><h1>歌词只经过<br><em>你的电脑。</em></h1><p class="lead">一个很小的本地歌词工具。下载、运行，浏览器会自动打开；搜索词、歌词和生成的文件都不会经过本站服务器。</p></div>
-      <aside><span>01</span><h2>下载本机程序</h2><p>无需安装。首次运行时，系统可能提示未知发布者。</p><a class="primary" href="/download/lrc-local-windows-amd64.exe">Windows 64 位</a><div class="secondary"><a href="/download/lrc-local-linux-amd64.tar.gz">Linux x64</a><a href="/download/lrc-local-darwin-arm64.tar.gz">macOS Apple 芯片</a><a href="/download/lrc-local-darwin-amd64.tar.gz">macOS Intel</a></div></aside>
-    </section>
-    <section class="steps"><article><b>02</b><h3>双击运行</h3><p>程序只监听随机的本机回环端口，不对局域网或公网开放。</p></article><article><b>03</b><h3>搜索与导出</h3><p>支持原文 LRC、翻译 LRC 和去除时间轴的 TXT。</p></article><article><b>04</b><h3>关掉即停止</h3><p>关闭程序窗口，本地服务立即消失；不创建账号，不保存历史。</p></article></section>
-    <section class="trust"><h2>它到底把什么发到哪里？</h2><p>本站只提供静态页面和程序下载。运行后的程序只向固定的 QQ 音乐搜索与歌词接口发出请求，不接受任意代理地址。浏览器只连接 <code>127.0.0.1</code>，文件由浏览器在本地生成。</p><p class="small">非 QQ 音乐官方工具。QQ 音乐是其权利人的商标。请遵守服务条款和著作权规则，只使用你有权访问的内容。校验文件：<a href="/download/SHA256SUMS">SHA256SUMS</a></p></section>
-  </main>
-</body>
-</html>
@@ -1 +0,0 @@
-:root{font-family:Inter,"Segoe UI","PingFang SC",sans-serif;background:#08100d;color:#edf6f2;color-scheme:dark;--mint:#75f0b2;--muted:#94a49e;--line:#27352f}*{box-sizing:border-box}body{margin:0;background:radial-gradient(circle at 87% 5%,#185036 0,transparent 34rem),#08100d}main{width:min(1160px,calc(100% - 34px));margin:auto}nav{height:86px;display:flex;align-items:center;justify-content:space-between;border-bottom:1px solid var(--line)}nav b{letter-spacing:.08em}nav i{font-style:normal;color:var(--mint)}a{color:inherit}.hero{min-height:650px;display:grid;grid-template-columns:minmax(0,1.45fr) minmax(310px,.55fr);gap:70px;align-items:center}.tag{color:var(--mint);font:700 .74rem ui-monospace,monospace;letter-spacing:.18em}.copy h1{font-size:clamp(3.8rem,8.2vw,7.4rem);line-height:.88;letter-spacing:-.07em;margin:28px 0}.copy h1 em{font-style:normal;color:transparent;-webkit-text-stroke:1px #a9c9bc}.lead{max-width:690px;color:var(--muted);font-size:1.1rem;line-height:1.8}aside{border:1px solid #3a554a;background:#10211a;padding:28px;border-radius:14px;box-shadow:0 24px 70px #0008}aside>span,.steps b{color:var(--mint);font:700 .78rem ui-monospace,monospace}aside h2{font-size:1.7rem;margin:18px 0 8px}aside p,.steps p,.trust p{color:var(--muted);line-height:1.7}.primary{display:block;text-align:center;background:var(--mint);color:#07110c;text-decoration:none;font-weight:850;border-radius:8px;padding:15px;margin:25px 0 12px}.secondary{display:grid;gap:7px}.secondary a{text-align:center;border:1px solid #365046;border-radius:7px;padding:10px;text-decoration:none;font-size:.84rem}.steps{display:grid;grid-template-columns:repeat(3,1fr);border-top:1px solid var(--line);border-bottom:1px solid var(--line)}.steps article{padding:36px 30px;border-right:1px solid var(--line)}.steps article:last-child{border:0}.steps h3{font-size:1.25rem}.trust{padding:80px 0;max-width:850px}.trust h2{font-size:2.4rem;letter-spacing:-.035em}.small{font-size:.82rem}code{background:#15231e;padding:2px 5px;border-radius:4px;color:#c6e3d7}@media(max-width:800px){.hero{grid-template-columns:1fr;padding:65px 0}.copy h1{font-size:4rem}.steps{grid-template-columns:1fr}.steps article{border-right:0;border-bottom:1px solid var(--line)}}
@@ -0,0 +1,196 @@
+package main
+
+import (
+	"errors"
+	"io/fs"
+	"mime"
+	"net"
+	"net/http"
+	"net/url"
+	"os"
+	"path/filepath"
+	"strings"
+	"sync"
+	"time"
+)
+
+const (
+	publicClientLimit = 30
+	publicGlobalLimit = 300
+)
+
+var publicDownloadNames = map[string]struct{}{
+	"SHA256SUMS":                    {},
+	"lrc-local-windows-amd64.exe":   {},
+	"lrc-local-linux-amd64.tar.gz":  {},
+	"lrc-local-darwin-arm64.tar.gz": {},
+	"lrc-local-darwin-amd64.tar.gz": {},
+}
+
+type rateWindow struct {
+	started time.Time
+	seen    time.Time
+	count   int
+}
+
+type publicApp struct {
+	origin      string
+	host        string
+	downloadDir string
+	web         fs.FS
+	core        *localApp
+	sem         chan struct{}
+	mu          sync.Mutex
+	global      rateWindow
+	clients     map[string]rateWindow
+}
+
+func newPublicApp(origin, downloadDir string, web fs.FS, qq qqAPI) (*publicApp, error) {
+	parsed, err := url.Parse(origin)
+	if err != nil || parsed.Scheme != "https" || parsed.Host == "" || parsed.Path != "" {
+		return nil, errors.New("public origin must be an HTTPS origin without a path")
+	}
+	now := time.Now()
+	return &publicApp{
+		origin: origin, host: parsed.Host, downloadDir: downloadDir, web: web,
+		core: newApp(origin, "", web, qq), sem: make(chan struct{}, 12),
+		global: rateWindow{started: now, seen: now}, clients: make(map[string]rateWindow),
+	}, nil
+}
+
+func (a *publicApp) routes() http.Handler {
+	mux := http.NewServeMux()
+	mux.HandleFunc("GET /", a.index)
+	mux.HandleFunc("GET /app.js", a.asset("app.js", "text/javascript; charset=utf-8"))
+	mux.HandleFunc("GET /styles.css", a.asset("styles.css", "text/css; charset=utf-8"))
+	mux.HandleFunc("GET /api/info", func(w http.ResponseWriter, _ *http.Request) {
+		writeJSON(w, http.StatusOK, map[string]any{"mode": "public", "version": version})
+	})
+	mux.HandleFunc("POST /api/search", a.withAPI(a.core.search))
+	mux.HandleFunc("POST /api/lyrics", a.withAPI(a.core.lyrics))
+	mux.HandleFunc("GET /download/{name}", a.download)
+	mux.HandleFunc("GET /health", func(w http.ResponseWriter, _ *http.Request) {
+		writeJSON(w, http.StatusOK, map[string]string{"status": "ok"})
+	})
+	return a.securityHeaders(mux)
+}
+
+func (a *publicApp) securityHeaders(next http.Handler) http.Handler {
+	return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		w.Header().Set("Cache-Control", "no-store")
+		w.Header().Set("Cross-Origin-Opener-Policy", "same-origin")
+		w.Header().Set("X-Frame-Options", "DENY")
+		next.ServeHTTP(w, r)
+	})
+}
+
+func (a *publicApp) index(w http.ResponseWriter, r *http.Request) {
+	if r.URL.Path != "/" {
+		http.NotFound(w, r)
+		return
+	}
+	a.serveFile(w, r, "app.html", "text/html; charset=utf-8")
+}
+
+func (a *publicApp) asset(name, contentType string) http.HandlerFunc {
+	return func(w http.ResponseWriter, r *http.Request) { a.serveFile(w, r, name, contentType) }
+}
+
+func (a *publicApp) serveFile(w http.ResponseWriter, r *http.Request, name, contentType string) {
+	data, err := fs.ReadFile(a.web, name)
+	if err != nil {
+		http.NotFound(w, r)
+		return
+	}
+	w.Header().Set("Content-Type", contentType)
+	_, _ = w.Write(data)
+}
+
+func (a *publicApp) download(w http.ResponseWriter, r *http.Request) {
+	name := r.PathValue("name")
+	if _, allowed := publicDownloadNames[name]; !allowed || a.downloadDir == "" {
+		http.NotFound(w, r)
+		return
+	}
+	path := filepath.Join(a.downloadDir, name)
+	file, err := os.Open(path)
+	if err != nil {
+		http.NotFound(w, r)
+		return
+	}
+	defer file.Close()
+	info, err := file.Stat()
+	if err != nil || !info.Mode().IsRegular() {
+		http.NotFound(w, r)
+		return
+	}
+	w.Header().Set("Content-Disposition", `attachment; filename="`+name+`"`)
+	http.ServeContent(w, r, name, info.ModTime(), file)
+}
+
+func (a *publicApp) withAPI(next http.HandlerFunc) http.HandlerFunc {
+	return func(w http.ResponseWriter, r *http.Request) {
+		mediaType, _, _ := mime.ParseMediaType(r.Header.Get("Content-Type"))
+		if r.Header.Get("Origin") != a.origin || mediaType != "application/json" {
+			writeJSON(w, http.StatusForbidden, map[string]string{"error": "请求来源无效"})
+			return
+		}
+		if !a.allowRequest(clientAddress(r)) {
+			w.Header().Set("Retry-After", "60")
+			writeJSON(w, http.StatusTooManyRequests, map[string]string{"error": "请求过于频繁，请稍后再试"})
+			return
+		}
+		select {
+		case a.sem <- struct{}{}:
+			defer func() { <-a.sem }()
+		case <-time.After(time.Second):
+			writeJSON(w, http.StatusServiceUnavailable, map[string]string{"error": "当前请求较多，请稍后重试"})
+			return
+		}
+		r.Body = http.MaxBytesReader(w, r.Body, 16*1024)
+		next(w, r)
+	}
+}
+
+func clientAddress(r *http.Request) string {
+	if forwarded := net.ParseIP(strings.TrimSpace(r.Header.Get("X-Real-IP"))); forwarded != nil {
+		return forwarded.String()
+	}
+	host, _, err := net.SplitHostPort(r.RemoteAddr)
+	if err == nil {
+		return host
+	}
+	return "unknown"
+}
+
+func (a *publicApp) allowRequest(client string) bool {
+	a.mu.Lock()
+	defer a.mu.Unlock()
+	now := time.Now()
+	if now.Sub(a.global.started) >= time.Minute {
+		a.global = rateWindow{started: now, seen: now}
+	}
+	if a.global.count >= publicGlobalLimit {
+		return false
+	}
+	entry := a.clients[client]
+	if entry.started.IsZero() || now.Sub(entry.started) >= time.Minute {
+		entry = rateWindow{started: now, seen: now}
+	}
+	if entry.count >= publicClientLimit {
+		return false
+	}
+	entry.count++
+	entry.seen = now
+	a.clients[client] = entry
+	a.global.count++
+	a.global.seen = now
+	if len(a.clients) > 2048 {
+		for address, candidate := range a.clients {
+			if now.Sub(candidate.seen) > 10*time.Minute {
+				delete(a.clients, address)
+			}
+		}
+	}
+	return true
+}
@@ -0,0 +1,111 @@
+package main
+
+import (
+	"net/http"
+	"net/http/httptest"
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+	"testing/fstest"
+)
+
+func newTestPublicApp(t *testing.T, downloads string) (*publicApp, http.Handler) {
+	t.Helper()
+	web := fstest.MapFS{
+		"app.html":   &fstest.MapFile{Data: []byte("public app")},
+		"app.js":     &fstest.MapFile{Data: []byte("js")},
+		"styles.css": &fstest.MapFile{Data: []byte("css")},
+	}
+	app, err := newPublicApp("https://lrc.flechazo.xin", downloads, web, fakeQQ{})
+	if err != nil {
+		t.Fatal(err)
+	}
+	return app, app.routes()
+}
+
+func publicRequest(method, path, body string) *http.Request {
+	request := httptest.NewRequest(method, "https://lrc.flechazo.xin"+path, strings.NewReader(body))
+	request.Header.Set("Origin", "https://lrc.flechazo.xin")
+	request.Header.Set("Content-Type", "application/json")
+	request.Header.Set("X-Real-IP", "203.0.113.7")
+	return request
+}
+
+func TestPublicPageNeedsNoSession(t *testing.T) {
+	_, handler := newTestPublicApp(t, "")
+	w := httptest.NewRecorder()
+	handler.ServeHTTP(w, publicRequest(http.MethodGet, "/", ""))
+	if w.Code != http.StatusOK || w.Body.String() != "public app" {
+		t.Fatalf("status=%d body=%q", w.Code, w.Body.String())
+	}
+	if w.Header().Get("Cache-Control") != "no-store" || w.Header().Get("X-Frame-Options") != "DENY" {
+		t.Fatal("public application safety headers are missing")
+	}
+}
+
+func TestPublicAPIRejectsWrongOrigin(t *testing.T) {
+	_, handler := newTestPublicApp(t, "")
+	request := publicRequest(http.MethodPost, "/api/search", `{"keyword":"test","limit":2}`)
+	request.Header.Set("Origin", "https://attacker.example")
+	w := httptest.NewRecorder()
+	handler.ServeHTTP(w, request)
+	if w.Code != http.StatusForbidden {
+		t.Fatalf("expected 403, got %d", w.Code)
+	}
+}
+
+func TestPublicSearchWorksWithoutCookie(t *testing.T) {
+	_, handler := newTestPublicApp(t, "")
+	w := httptest.NewRecorder()
+	handler.ServeHTTP(w, publicRequest(http.MethodPost, "/api/search", `{"keyword":"测试","limit":2}`))
+	if w.Code != http.StatusOK || !strings.Contains(w.Body.String(), "测试") {
+		t.Fatalf("status=%d body=%s", w.Code, w.Body.String())
+	}
+}
+
+func TestPublicPerClientRateLimit(t *testing.T) {
+	_, handler := newTestPublicApp(t, "")
+	for attempt := 1; attempt <= publicClientLimit+1; attempt++ {
+		w := httptest.NewRecorder()
+		handler.ServeHTTP(w, publicRequest(http.MethodPost, "/api/search", `{"keyword":"test","limit":1}`))
+		if attempt <= publicClientLimit && w.Code != http.StatusOK {
+			t.Fatalf("attempt %d unexpectedly returned %d", attempt, w.Code)
+		}
+		if attempt == publicClientLimit+1 && w.Code != http.StatusTooManyRequests {
+			t.Fatalf("expected final attempt to return 429, got %d", w.Code)
+		}
+	}
+}
+
+func TestPublicDownloadWhitelistAndRange(t *testing.T) {
+	directory := t.TempDir()
+	name := "lrc-local-windows-amd64.exe"
+	if err := os.WriteFile(filepath.Join(directory, name), []byte("0123456789"), 0o600); err != nil {
+		t.Fatal(err)
+	}
+	_, handler := newTestPublicApp(t, directory)
+	request := publicRequest(http.MethodGet, "/download/"+name, "")
+	request.Header.Set("Range", "bytes=2-5")
+	w := httptest.NewRecorder()
+	handler.ServeHTTP(w, request)
+	if w.Code != http.StatusPartialContent || w.Body.String() != "2345" {
+		t.Fatalf("status=%d body=%q", w.Code, w.Body.String())
+	}
+	if !strings.Contains(w.Header().Get("Content-Disposition"), name) {
+		t.Fatal("download disposition is missing")
+	}
+
+	w = httptest.NewRecorder()
+	handler.ServeHTTP(w, publicRequest(http.MethodGet, "/download/not-allowed", ""))
+	if w.Code != http.StatusNotFound {
+		t.Fatalf("unexpected non-whitelist status %d", w.Code)
+	}
+}
+
+func TestPublicOriginConfigurationMustUseHTTPS(t *testing.T) {
+	_, err := newPublicApp("http://lrc.flechazo.xin", "", fstest.MapFS{}, fakeQQ{})
+	if err == nil {
+		t.Fatal("expected insecure public origin to be rejected")
+	}
+}
@@ -2,6 +2,7 @@ package main

 import (
 	"bytes"
+	"encoding/base64"
 	"encoding/json"
 	"errors"
 	"fmt"
@@ -13,9 +14,10 @@ import (
 )

 const (
-	searchEndpoint   = "https://c.y.qq.com/soso/fcgi-bin/search_for_qq_cp"
-	lyricsEndpoint   = "https://c.y.qq.com/lyric/fcgi-bin/fcg_query_lyric_new.fcg"
-	maxUpstreamBytes = 4 << 20
+	searchEndpoint       = "https://c.y.qq.com/soso/fcgi-bin/search_for_qq_cp"
+	musicuEndpoint       = "https://u.y.qq.com/cgi-bin/musicu.fcg"
+	legacyLyricsEndpoint = "https://c.y.qq.com/lyric/fcgi-bin/fcg_query_lyric_new.fcg"
+	maxUpstreamBytes     = 4 << 20
 )

 type song struct {
@@ -29,6 +31,7 @@ type song struct {
 type lyricResult struct {
 	Lyric string `json:"lyric"`
 	Trans string `json:"trans"`
+	Roma  string `json:"roma"`
 	Code  int    `json:"code"`
 }

@@ -40,6 +43,7 @@ type qqAPI interface {
 type qqClient struct {
 	httpClient     *http.Client
 	searchEndpoint string
+	musicuEndpoint string
 	lyricsEndpoint string
 }

@@ -57,7 +61,8 @@ func newQQClient() *qqClient {
 			},
 		},
 		searchEndpoint: searchEndpoint,
-		lyricsEndpoint: lyricsEndpoint,
+		musicuEndpoint: musicuEndpoint,
+		lyricsEndpoint: legacyLyricsEndpoint,
 	}
 }

@@ -112,6 +117,54 @@ func (c *qqClient) Search(keyword string, limit int) ([]song, error) {
 }

 func (c *qqClient) Lyrics(mid string) (lyricResult, error) {
+	result, err := c.musicuLyrics(mid)
+	if err == nil {
+		return result, nil
+	}
+	return c.legacyLyrics(mid)
+}
+
+func (c *qqClient) musicuLyrics(mid string) (lyricResult, error) {
+	payload := map[string]any{
+		"comm": map[string]any{"ct": 24, "cv": 0, "format": "json", "platform": "yqq.json"},
+		"req_1": map[string]any{
+			"module": "music.musichallSong.PlayLyricInfo",
+			"method": "GetPlayLyricInfo",
+			"param": map[string]any{
+				"songMID": mid, "songID": 0, "crypt": 0, "qrc": 0, "trans": 1, "roma": 1,
+			},
+		},
+	}
+	var response struct {
+		Code    int `json:"code"`
+		Request struct {
+			Code int `json:"code"`
+			Data struct {
+				Lyric string `json:"lyric"`
+				Trans string `json:"trans"`
+				Roma  string `json:"roma"`
+			} `json:"data"`
+		} `json:"req_1"`
+	}
+	if err := c.postJSON(c.musicuEndpoint, payload, &response); err != nil {
+		return lyricResult{}, err
+	}
+	if response.Code != 0 || response.Request.Code != 0 {
+		return lyricResult{}, errors.New("QQ Music lyrics request failed")
+	}
+	lyric, err := decodeLyricBase64(response.Request.Data.Lyric)
+	if err != nil || strings.TrimSpace(lyric) == "" {
+		return lyricResult{}, errors.New("lyrics are not available for this track")
+	}
+	trans, _ := decodeLyricBase64(response.Request.Data.Trans)
+	roma := ""
+	if response.Request.Data.Roma != "" {
+		roma, _ = decryptQRCLyric(response.Request.Data.Roma)
+	}
+	return lyricResult{Lyric: lyric, Trans: trans, Roma: roma, Code: 0}, nil
+}
+
+func (c *qqClient) legacyLyrics(mid string) (lyricResult, error) {
 	query := url.Values{
 		"format": {"json"}, "songmid": {mid}, "outCharset": {"utf-8"}, "nobase64": {"1"},
 	}
@@ -125,11 +178,42 @@ func (c *qqClient) Lyrics(mid string) (lyricResult, error) {
 	return result, nil
 }

+func decodeLyricBase64(value string) (string, error) {
+	if value == "" {
+		return "", nil
+	}
+	decoded, err := base64.StdEncoding.DecodeString(value)
+	if err != nil {
+		return "", errors.New("QQ Music returned invalid lyric encoding")
+	}
+	if len(decoded) > maxUpstreamBytes {
+		return "", errors.New("decoded lyrics exceeded the safety limit")
+	}
+	return string(decoded), nil
+}
+
+func (c *qqClient) postJSON(endpoint string, payload, destination any) error {
+	body, err := json.Marshal(payload)
+	if err != nil {
+		return err
+	}
+	request, err := http.NewRequest(http.MethodPost, endpoint, bytes.NewReader(body))
+	if err != nil {
+		return err
+	}
+	request.Header.Set("Content-Type", "application/json")
+	return c.doJSON(request, destination)
+}
+
 func (c *qqClient) getJSON(endpoint string, query url.Values, destination any) error {
 	request, err := http.NewRequest(http.MethodGet, endpoint+"?"+query.Encode(), nil)
 	if err != nil {
 		return err
 	}
+	return c.doJSON(request, destination)
+}
+
+func (c *qqClient) doJSON(request *http.Request, destination any) error {
 	request.Header.Set("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 Chrome/131 Safari/537.36")
 	request.Header.Set("Referer", "https://y.qq.com/")
 	request.Header.Set("Origin", "https://y.qq.com")
@@ -2,6 +2,8 @@ package main

 import (
 	"bytes"
+	"encoding/base64"
+	"encoding/json"
 	"net/http"
 	"net/http/httptest"
 	"strings"
@@ -15,6 +17,49 @@ func TestUnwrapJSONP(t *testing.T) {
 	}
 }

+func TestQQClientMusicuLyricsRequestsTranslationAndPhonetics(t *testing.T) {
+	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		if r.Method != http.MethodPost || r.Header.Get("Content-Type") != "application/json" {
+			t.Fatalf("unexpected request: %s %s", r.Method, r.Header.Get("Content-Type"))
+		}
+		var body struct {
+			Request struct {
+				Module string `json:"module"`
+				Method string `json:"method"`
+				Param  struct {
+					MID   string `json:"songMID"`
+					Trans int    `json:"trans"`
+					Roma  int    `json:"roma"`
+					QRC   int    `json:"qrc"`
+				} `json:"param"`
+			} `json:"req_1"`
+		}
+		if err := json.NewDecoder(r.Body).Decode(&body); err != nil {
+			t.Fatal(err)
+		}
+		if body.Request.Module != "music.musichallSong.PlayLyricInfo" || body.Request.Method != "GetPlayLyricInfo" || body.Request.Param.MID != "0004jPDk2eB2dt" {
+			t.Fatalf("unexpected request body: %#v", body)
+		}
+		if body.Request.Param.Trans != 1 || body.Request.Param.Roma != 1 || body.Request.Param.QRC != 0 {
+			t.Fatalf("required lyric variants were not requested: %#v", body.Request.Param)
+		}
+		lyric := base64.StdEncoding.EncodeToString([]byte("[00:01.00]原文"))
+		trans := base64.StdEncoding.EncodeToString([]byte("[00:01.00]translation"))
+		_, _ = w.Write([]byte(`{"code":0,"req_1":{"code":0,"data":{"lyric":"` + lyric + `","trans":"` + trans + `"}}}`))
+	}))
+	defer server.Close()
+
+	client := newQQClient()
+	client.musicuEndpoint = server.URL
+	result, err := client.musicuLyrics("0004jPDk2eB2dt")
+	if err != nil {
+		t.Fatal(err)
+	}
+	if result.Lyric != "[00:01.00]原文" || result.Trans != "[00:01.00]translation" {
+		t.Fatalf("unexpected lyrics: %#v", result)
+	}
+}
+
 func TestQQClientSearchUsesFixedShape(t *testing.T) {
 	server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
 		if r.Header.Get("Origin") != "https://y.qq.com" || r.Header.Get("Referer") != "https://y.qq.com/" {
@@ -44,8 +89,8 @@ func TestQQClientRejectsOversizedResponse(t *testing.T) {
 	}))
 	defer server.Close()
 	client := newQQClient()
-	client.lyricsEndpoint = server.URL
-	_, err := client.Lyrics("0004jPDk2eB2dt")
+	client.musicuEndpoint = server.URL
+	_, err := client.musicuLyrics("0004jPDk2eB2dt")
 	if err == nil || !strings.Contains(err.Error(), "safety limit") {
 		t.Fatalf("expected response limit error, got %v", err)
 	}
@@ -0,0 +1,236 @@
+package main
+
+import (
+	"bytes"
+	"compress/zlib"
+	"encoding/binary"
+	"encoding/hex"
+	"encoding/xml"
+	"errors"
+	"fmt"
+	"io"
+	"regexp"
+	"strconv"
+	"strings"
+)
+
+// The QRC transform and keys below follow the community-provided
+// qq_lyric_tables.py implementation supplied with the original script.
+var (
+	qrcKey1 = [8]byte{'!', '@', '#', ')', '(', '*', '$', '%'}
+	qrcKey2 = [8]byte{'1', '2', '3', 'Z', 'X', 'C', '!', '@'}
+	qrcKey3 = [8]byte{'!', '@', '#', ')', '(', 'N', 'H', 'L'}
+)
+
+const maxQRCBytes = 4 << 20
+
+var (
+	qrcWordTimingPattern = regexp.MustCompile(`\(\d+,\d+\)`)
+	qrcLinePattern       = regexp.MustCompile(`^\[(\d+),(\d+)\](.*)$`)
+	qrcMetadataPattern   = regexp.MustCompile(`^\[(ti|ar|al|by|offset|kana|language|total):`)
+)
+
+func decryptQRCLyric(encoded string) (string, error) {
+	encrypted, err := hex.DecodeString(strings.TrimSpace(encoded))
+	if err != nil {
+		return "", errors.New("QQ Music returned invalid phonetic lyrics")
+	}
+	if len(encrypted) == 0 || len(encrypted)%8 != 0 || len(encrypted) > maxUpstreamBytes {
+		return "", errors.New("QQ Music returned invalid phonetic lyric length")
+	}
+	decrypted := append([]byte(nil), encrypted...)
+	transformQRCBlocks(decrypted, newQRCDes(qrcKey3, true))
+	transformQRCBlocks(decrypted, newQRCDes(qrcKey2, false))
+	transformQRCBlocks(decrypted, newQRCDes(qrcKey1, true))
+
+	reader, err := zlib.NewReader(bytes.NewReader(decrypted))
+	if err != nil {
+		return "", errors.New("QQ Music returned invalid compressed phonetic lyrics")
+	}
+	decompressed, readErr := io.ReadAll(io.LimitReader(reader, maxQRCBytes+1))
+	closeErr := reader.Close()
+	if readErr != nil || closeErr != nil {
+		return "", errors.New("could not decompress phonetic lyrics")
+	}
+	if len(decompressed) > maxQRCBytes {
+		return "", errors.New("phonetic lyrics exceeded the safety limit")
+	}
+	return qrcXMLToLRC(decompressed)
+}
+
+func qrcXMLToLRC(document []byte) (string, error) {
+	decoder := xml.NewDecoder(bytes.NewReader(document))
+	content := ""
+	for {
+		token, err := decoder.Token()
+		if errors.Is(err, io.EOF) {
+			break
+		}
+		if err != nil {
+			return "", errors.New("QQ Music returned invalid phonetic lyric XML")
+		}
+		start, ok := token.(xml.StartElement)
+		if !ok {
+			continue
+		}
+		for _, attribute := range start.Attr {
+			if attribute.Name.Local == "LyricContent" {
+				content = attribute.Value
+				break
+			}
+		}
+		if content != "" {
+			break
+		}
+	}
+	if content == "" {
+		return "", errors.New("phonetic lyrics did not contain lyric content")
+	}
+
+	lines := make([]string, 0, strings.Count(content, "\n")+1)
+	for _, rawLine := range strings.Split(strings.ReplaceAll(content, "\r\n", "\n"), "\n") {
+		line := strings.TrimSpace(rawLine)
+		if line == "" {
+			continue
+		}
+		if qrcMetadataPattern.MatchString(line) {
+			lines = append(lines, line)
+			continue
+		}
+		match := qrcLinePattern.FindStringSubmatch(line)
+		if match == nil {
+			lines = append(lines, line)
+			continue
+		}
+		start, err := strconv.Atoi(match[1])
+		if err != nil || start < 0 {
+			continue
+		}
+		lyric := strings.TrimSpace(qrcWordTimingPattern.ReplaceAllString(match[3], ""))
+		if lyric == "" {
+			continue
+		}
+		lines = append(lines, fmt.Sprintf("[%02d:%02d.%03d]%s", start/60000, start%60000/1000, start%1000, lyric))
+	}
+	if len(lines) == 0 {
+		return "", errors.New("phonetic lyrics were empty")
+	}
+	return strings.Join(lines, "\n"), nil
+}
+
+type qrcDes struct {
+	subkeys [16]uint64
+}
+
+func newQRCDes(key [8]byte, decrypt bool) qrcDes {
+	parameter := qrcMap64(binary.LittleEndian.Uint64(key[:]), qrcKeyPermutation[:])
+	c, d := uint32(parameter), uint32(parameter>>32)
+	var result qrcDes
+	for round, shift := range qrcRoundShifts {
+		c = c<<shift | (c>>(28-shift))&0xfffffff0
+		d = d<<shift | (d>>(28-shift))&0xfffffff0
+		subkey := qrcMap64(uint64(d)<<32|uint64(c), qrcKeyCompression[:])
+		if decrypt {
+			result.subkeys[15-round] = subkey
+		} else {
+			result.subkeys[round] = subkey
+		}
+	}
+	return result
+}
+
+func (d qrcDes) transform(value uint64) uint64 {
+	state := qrcMap64(value, qrcInitialPermutation[:])
+	for _, key := range d.subkeys {
+		right := uint32(state >> 32)
+		left := uint32(state)
+		expanded := qrcMap64(uint64(right)<<32|uint64(right), qrcKeyExpansion[:]) ^ key
+		sbox := uint32(0)
+		for index, shift := range qrcSBoxShifts {
+			sbox = sbox<<4 | uint32(qrcSBoxes[index][expanded>>shift&0x3f])
+		}
+		next := qrcMap32(sbox, qrcPBox[:]) ^ left
+		state = uint64(next)<<32 | uint64(right)
+	}
+	state = state>>32 | state<<32
+	return qrcMap64(state, qrcFinalPermutation[:])
+}
+
+func transformQRCBlocks(data []byte, cipher qrcDes) {
+	for offset := 0; offset < len(data); offset += 8 {
+		binary.LittleEndian.PutUint64(data[offset:offset+8], cipher.transform(binary.LittleEndian.Uint64(data[offset:offset+8])))
+	}
+}
+
+func qrcBitMask(index uint8) uint64 {
+	if index < 32 {
+		return uint64(1) << (31 - index)
+	}
+	return uint64(1) << (63 - index + 32)
+}
+
+func qrcMapBit(result, source uint64, check, set uint8) uint64 {
+	if source&qrcBitMask(check) != 0 {
+		result |= qrcBitMask(set)
+	}
+	return result
+}
+
+func qrcMap64(source uint64, table []uint8) uint64 {
+	half := len(table) / 2
+	var low, high uint64
+	for index := 0; index < half; index++ {
+		low = qrcMapBit(low, source, table[index], uint8(index))
+		high = qrcMapBit(high, source, table[index+half], uint8(index))
+	}
+	return uint64(uint32(high))<<32 | uint64(uint32(low))
+}
+
+func qrcMap32(source uint32, table []uint8) uint32 {
+	var result uint64
+	for index, check := range table {
+		result = qrcMapBit(result, uint64(source), check, uint8(index))
+	}
+	return uint32(result)
+}
+
+var qrcRoundShifts = [16]uint8{1, 1, 2, 2, 2, 2, 2, 2, 1, 2, 2, 2, 2, 2, 2, 1}
+var qrcSBoxShifts = [8]uint8{26, 20, 14, 8, 58, 52, 46, 40}
+
+var qrcInitialPermutation = [64]uint8{
+	57, 49, 41, 33, 25, 17, 9, 1, 59, 51, 43, 35, 27, 19, 11, 3, 61, 53, 45, 37, 29, 21, 13, 5, 63, 55, 47, 39, 31, 23, 15, 7,
+	56, 48, 40, 32, 24, 16, 8, 0, 58, 50, 42, 34, 26, 18, 10, 2, 60, 52, 44, 36, 28, 20, 12, 4, 62, 54, 46, 38, 30, 22, 14, 6,
+}
+
+var qrcFinalPermutation = [64]uint8{
+	39, 7, 47, 15, 55, 23, 63, 31, 38, 6, 46, 14, 54, 22, 62, 30, 37, 5, 45, 13, 53, 21, 61, 29, 36, 4, 44, 12, 52, 20, 60, 28,
+	35, 3, 43, 11, 51, 19, 59, 27, 34, 2, 42, 10, 50, 18, 58, 26, 33, 1, 41, 9, 49, 17, 57, 25, 32, 0, 40, 8, 48, 16, 56, 24,
+}
+
+var qrcKeyPermutation = [56]uint8{
+	56, 48, 40, 32, 24, 16, 8, 0, 57, 49, 41, 33, 25, 17, 9, 1, 58, 50, 42, 34, 26, 18, 10, 2, 59, 51, 43, 35,
+	62, 54, 46, 38, 30, 22, 14, 6, 61, 53, 45, 37, 29, 21, 13, 5, 60, 52, 44, 36, 28, 20, 12, 4, 27, 19, 11, 3,
+}
+
+var qrcKeyCompression = [48]uint8{
+	13, 16, 10, 23, 0, 4, 2, 27, 14, 5, 20, 9, 22, 18, 11, 3, 25, 7, 15, 6, 26, 19, 12, 1,
+	45, 56, 35, 41, 51, 59, 34, 44, 55, 49, 37, 52, 48, 53, 43, 60, 38, 57, 50, 46, 54, 40, 33, 36,
+}
+
+var qrcKeyExpansion = [48]uint8{
+	31, 0, 1, 2, 3, 4, 3, 4, 5, 6, 7, 8, 7, 8, 9, 10, 11, 12, 11, 12, 13, 14, 15, 16, 15, 16, 17, 18, 19, 20, 19, 20, 21, 22, 23, 24,
+	23, 24, 25, 26, 27, 28, 27, 28, 29, 30, 31, 0,
+}
+
+var qrcPBox = [32]uint8{15, 6, 19, 20, 28, 11, 27, 16, 0, 14, 22, 25, 4, 17, 30, 9, 1, 7, 23, 13, 31, 26, 2, 8, 18, 12, 29, 5, 21, 10, 3, 24}
+
+var qrcSBoxes = [8][64]uint8{
+	{14, 0, 4, 15, 13, 7, 1, 4, 2, 14, 15, 2, 11, 13, 8, 1, 3, 10, 10, 6, 6, 12, 12, 11, 5, 9, 9, 5, 0, 3, 7, 8, 4, 15, 1, 12, 14, 8, 8, 2, 13, 4, 6, 9, 2, 1, 11, 7, 15, 5, 12, 11, 9, 3, 7, 14, 3, 10, 10, 0, 5, 6, 0, 13},
+	{15, 3, 1, 13, 8, 4, 14, 7, 6, 15, 11, 2, 3, 8, 4, 15, 9, 12, 7, 0, 2, 1, 13, 10, 12, 6, 0, 9, 5, 11, 10, 5, 0, 13, 14, 8, 7, 10, 11, 1, 10, 3, 4, 15, 13, 4, 1, 2, 5, 11, 8, 6, 12, 7, 6, 12, 9, 0, 3, 5, 2, 14, 15, 9},
+	{10, 13, 0, 7, 9, 0, 14, 9, 6, 3, 3, 4, 15, 6, 5, 10, 1, 2, 13, 8, 12, 5, 7, 14, 11, 12, 4, 11, 2, 15, 8, 1, 13, 1, 6, 10, 4, 13, 9, 0, 8, 6, 15, 9, 3, 8, 0, 7, 11, 4, 1, 15, 2, 14, 12, 3, 5, 11, 10, 5, 14, 2, 7, 12},
+	{7, 13, 13, 8, 14, 11, 3, 5, 0, 6, 6, 15, 9, 0, 10, 3, 1, 4, 2, 7, 8, 2, 5, 12, 11, 1, 12, 10, 4, 14, 15, 9, 10, 3, 6, 15, 9, 0, 0, 6, 12, 10, 11, 10, 7, 13, 13, 8, 15, 9, 1, 4, 3, 5, 14, 11, 5, 12, 2, 7, 8, 2, 4, 14},
+	{2, 14, 12, 11, 4, 2, 1, 12, 7, 4, 10, 7, 11, 13, 6, 1, 8, 5, 5, 0, 3, 15, 15, 10, 13, 3, 0, 9, 14, 8, 9, 6, 4, 11, 2, 8, 1, 12, 11, 7, 10, 1, 13, 14, 7, 2, 8, 13, 15, 6, 9, 15, 12, 0, 5, 9, 6, 10, 3, 4, 0, 5, 14, 3},
+	{12, 10, 1, 15, 10, 4, 15, 2, 9, 7, 2, 12, 6, 9, 8, 5, 0, 6, 13, 1, 3, 13, 4, 14, 14, 0, 7, 11, 5, 3, 11, 8, 9, 4, 14, 3, 15, 2, 5, 12, 2, 9, 8, 5, 12, 15, 3, 10, 7, 11, 0, 14, 4, 1, 10, 7, 1, 6, 13, 0, 11, 8, 6, 13},
+	{4, 13, 11, 0, 2, 11, 14, 7, 15, 4, 0, 9, 8, 1, 13, 10, 3, 14, 12, 3, 9, 5, 7, 12, 5, 2, 10, 15, 6, 8, 1, 6, 1, 6, 4, 11, 11, 13, 13, 8, 12, 1, 3, 4, 7, 10, 14, 7, 10, 9, 15, 5, 6, 0, 8, 15, 0, 14, 5, 2, 9, 3, 2, 12},
+	{13, 1, 2, 15, 8, 13, 4, 8, 6, 10, 15, 3, 11, 7, 1, 4, 10, 12, 9, 5, 3, 6, 14, 11, 5, 0, 0, 14, 12, 9, 7, 2, 7, 2, 11, 1, 4, 14, 1, 7, 9, 4, 12, 10, 14, 8, 2, 13, 0, 15, 6, 12, 10, 9, 13, 0, 15, 3, 3, 5, 5, 6, 8, 11},
+}
@@ -0,0 +1,62 @@
+package main
+
+import (
+	"bytes"
+	"compress/zlib"
+	"encoding/hex"
+	"strings"
+	"testing"
+)
+
+func TestQRCModifiedDESVectors(t *testing.T) {
+	input := []byte{1, 2, 3, 4, 5, 6, 7, 8, 9, 0, 1, 2, 3, 4, 5, 6}
+	expected := []byte{
+		0xfd, 0x0e, 0x64, 0x06, 0x65, 0xbe, 0x74, 0x13,
+		0x77, 0x63, 0x3b, 0x02, 0x45, 0x4e, 0x70, 0x7a,
+	}
+	key := [8]byte{'T', 'E', 'S', 'T', '!', 'K', 'E', 'Y'}
+	transformQRCBlocks(input, newQRCDes(key, true))
+	if !bytes.Equal(input, expected) {
+		t.Fatalf("unexpected decrypt vector: %x", input)
+	}
+	transformQRCBlocks(input, newQRCDes(key, false))
+	if !bytes.Equal(input, []byte{1, 2, 3, 4, 5, 6, 7, 8, 9, 0, 1, 2, 3, 4, 5, 6}) {
+		t.Fatalf("unexpected encrypt vector: %x", input)
+	}
+}
+
+func TestDecryptQRCAndConvertXML(t *testing.T) {
+	document := []byte(`<QrcInfos><LyricInfo LyricContent="[ti:测试]&#xA;[1498,2200]a (1498,200)i (1698,200)&#xA;[3849,1200]完整(3849,400)歌词(4249,500)"/></QrcInfos>`)
+	var compressed bytes.Buffer
+	writer := zlib.NewWriter(&compressed)
+	if _, err := writer.Write(document); err != nil {
+		t.Fatal(err)
+	}
+	if err := writer.Close(); err != nil {
+		t.Fatal(err)
+	}
+	encrypted := append([]byte(nil), compressed.Bytes()...)
+	if remainder := len(encrypted) % 8; remainder != 0 {
+		encrypted = append(encrypted, make([]byte, 8-remainder)...)
+	}
+	transformQRCBlocks(encrypted, newQRCDes(qrcKey1, false))
+	transformQRCBlocks(encrypted, newQRCDes(qrcKey2, true))
+	transformQRCBlocks(encrypted, newQRCDes(qrcKey3, false))
+
+	result, err := decryptQRCLyric(hex.EncodeToString(encrypted))
+	if err != nil {
+		t.Fatal(err)
+	}
+	if !strings.Contains(result, "[00:01.498]a i") || !strings.Contains(result, "[00:03.849]完整歌词") {
+		t.Fatalf("unexpected converted lyrics: %q", result)
+	}
+}
+
+func TestDecryptQRCRejectsInvalidInput(t *testing.T) {
+	if _, err := decryptQRCLyric("not-hex"); err == nil {
+		t.Fatal("expected invalid hex to be rejected")
+	}
+	if _, err := decryptQRCLyric("00"); err == nil {
+		t.Fatal("expected invalid block length to be rejected")
+	}
+}
@@ -44,6 +44,9 @@ func (a *localApp) routes() http.Handler {
 	mux.HandleFunc("GET /app", a.withSession(a.appPage))
 	mux.HandleFunc("GET /app.js", a.withSession(a.asset("app.js", "text/javascript; charset=utf-8")))
 	mux.HandleFunc("GET /styles.css", a.withSession(a.asset("styles.css", "text/css; charset=utf-8")))
+	mux.HandleFunc("GET /api/info", a.withSession(func(w http.ResponseWriter, _ *http.Request) {
+		writeJSON(w, http.StatusOK, map[string]any{"mode": "local", "version": version})
+	}))
 	mux.HandleFunc("POST /api/search", a.withSession(a.withAPI(a.search)))
 	mux.HandleFunc("POST /api/lyrics", a.withSession(a.withAPI(a.lyrics)))
 	mux.HandleFunc("GET /health", func(w http.ResponseWriter, _ *http.Request) {
@@ -15,7 +15,7 @@ func (fakeQQ) Search(keyword string, limit int) ([]song, error) {
 	return []song{{Name: keyword, MID: "0004jPDk2eB2dt", Singer: "Tester", Interval: limit}}, nil
 }
 func (fakeQQ) Lyrics(string) (lyricResult, error) {
-	return lyricResult{Code: 0, Lyric: "[00:01.00]line"}, nil
+	return lyricResult{Code: 0, Lyric: "[00:01.00]line", Trans: "[00:01.00]翻译", Roma: "[00:01.00]sound"}, nil
 }

 func testApp() (*localApp, http.Handler, fs.FS) {
@@ -103,3 +103,16 @@ func TestRejectsInvalidMID(t *testing.T) {
 		t.Fatalf("expected 400, got %d", w.Code)
 	}
 }
+
+func TestLyricsReturnsAvailableTranslationAndPhonetics(t *testing.T) {
+	_, handler, _ := testApp()
+	r := request(http.MethodPost, "http://127.0.0.1:18765/api/lyrics", `{"mid":"0004jPDk2eB2dt"}`)
+	r.AddCookie(validSessionCookie())
+	r.Header.Set("Content-Type", "application/json")
+	r.Header.Set("Origin", "http://127.0.0.1:18765")
+	w := httptest.NewRecorder()
+	handler.ServeHTTP(w, r)
+	if w.Code != http.StatusOK || !strings.Contains(w.Body.String(), `"trans":"[00:01.00]翻译"`) || !strings.Contains(w.Body.String(), `"roma":"[00:01.00]sound"`) {
+		t.Fatalf("status=%d body=%s", w.Code, w.Body.String())
+	}
+}
@@ -3,30 +3,43 @@
 <head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width,initial-scale=1">
+  <meta name="description" content="搜索、预览并下载原文、翻译与音歌词。">
  <title>LRC Local</title>
  <link rel="stylesheet" href="/styles.css">
 </head>
 <body>
-  <main class="shell">
+  <main>
    <header>
-      <div class="brand">LRC <span>Local</span></div>
-      <div class="local-pill"><i></i> 本机运行中</div>
+      <h1>LRC Local</h1>
+      <a href="https://git.sighs.cc/Flechazo/lrc-local">源码</a>
    </header>
-    <section class="hero">
-      <p class="eyebrow">LOCAL-FIRST LYRIC TOOL</p>
-      <h1>把歌词带走，<br><em>别把隐私留下。</em></h1>
-      <p class="lead">搜索与歌词请求从这台电脑直接发出。关键词、歌词和下载文件不会经过我们的服务器。</p>
-      <form id="search-form">
-        <label for="keyword">歌曲、歌手或专辑</label>
-        <div class="search-row">
-          <input id="keyword" name="keyword" maxlength="100" autocomplete="off" placeholder="例如：起风了" required autofocus>
-          <button type="submit">搜索歌词</button>
-        </div>
-      </form>
-      <div id="notice" class="notice" role="status" aria-live="polite"></div>
-    </section>
+
+    <p>搜索、完整预览并下载原文、翻译或“音”歌词。翻译与音歌词只在 QQ 音乐提供对应内容时出现。</p>
+    <p id="mode-note" class="note">正在确认运行模式…</p>
+
+    <form id="search-form">
+      <label for="keyword">歌曲、歌手或专辑</label>
+      <div class="search-row">
+        <input id="keyword" name="keyword" maxlength="100" autocomplete="off" placeholder="例如：起风了" required autofocus>
+        <button type="submit">搜索</button>
+      </div>
+    </form>
+    <div id="notice" class="notice" role="status" aria-live="polite"></div>
    <section id="results" class="results" aria-label="搜索结果"></section>
-    <footer>非 QQ 音乐官方工具。请仅下载和使用你有权访问的歌词内容。</footer>
+
+    <section id="local-downloads" class="downloads" hidden>
+      <h2>可选：本机版</h2>
+      <p>如果不希望查询经过本站，可以下载本机版。它只监听 <code>127.0.0.1</code>，关闭窗口即停止。</p>
+      <div class="download-links">
+        <a href="/download/lrc-local-windows-amd64.exe">Windows 64 位</a>
+        <a href="/download/lrc-local-linux-amd64.tar.gz">Linux x64</a>
+        <a href="/download/lrc-local-darwin-arm64.tar.gz">macOS Apple 芯片</a>
+        <a href="/download/lrc-local-darwin-amd64.tar.gz">macOS Intel</a>
+        <a href="/download/SHA256SUMS">SHA-256</a>
+      </div>
+    </section>
+
+    <footer>网页版请求由本站转发到固定的 QQ 音乐接口，不保存搜索词、歌词或历史。非 QQ 音乐官方工具，请仅使用你有权访问的内容。</footer>
  </main>
  <script src="/app.js" defer></script>
 </body>
@@ -2,11 +2,15 @@ const form = document.querySelector('#search-form');
 const keyword = document.querySelector('#keyword');
 const notice = document.querySelector('#notice');
 const results = document.querySelector('#results');
+const modeNote = document.querySelector('#mode-note');
+const localDownloads = document.querySelector('#local-downloads');
+const lyricCache = new Map();

 function text(value) { return document.createTextNode(value ?? ''); }
+function hasText(value) { return typeof value === 'string' && value.trim().length > 0; }
 function safeName(value) { return (value || 'unknown').replace(/[\\/:*?"<>|\u0000-\u001f]/g, '_').trim().slice(0, 180) || 'unknown'; }
 function duration(seconds) { const n = Number(seconds || 0); return n ? `${Math.floor(n / 60)}:${String(n % 60).padStart(2, '0')}` : ''; }
-function plainText(lrc) { return lrc.split(/\r?\n/).map(line => line.replace(/\[[^\]]*\]/g, '').trim()).filter(Boolean).join('\n'); }
+function plainText(lrc) { return (lrc || '').split(/\r?\n/).map(line => line.replace(/\[[^\]]*\]/g, '').trim()).filter(Boolean).join('\n'); }

 async function api(path, payload) {
  const response = await fetch(path, { method: 'POST', headers: {'Content-Type': 'application/json'}, body: JSON.stringify(payload) });
@@ -15,56 +19,267 @@ async function api(path, payload) {
  return data;
 }

+async function loadInfo() {
+  try {
+    const response = await fetch('/api/info');
+    const info = await response.json();
+    if (info.mode === 'local') {
+      modeNote.textContent = '本机模式：查询从这台电脑直接发出，不经过 lrc.flechazo.xin。';
+    } else {
+      modeNote.textContent = '网页模式：查询由本站后端转发，但不会写入数据库或日志正文。下载文件在浏览器中生成。';
+      localDownloads.hidden = false;
+    }
+  } catch {
+    modeNote.textContent = '无法确认运行模式，请刷新页面重试。';
+  }
+}
+
 function download(name, body, type = 'text/plain;charset=utf-8') {
  const url = URL.createObjectURL(new Blob([body], {type}));
  const anchor = document.createElement('a');
-  anchor.href = url; anchor.download = name; anchor.hidden = true;
-  document.body.append(anchor); anchor.click(); anchor.remove();
+  anchor.href = url;
+  anchor.download = name;
+  anchor.hidden = true;
+  document.body.append(anchor);
+  anchor.click();
+  anchor.remove();
  setTimeout(() => URL.revokeObjectURL(url), 1500);
 }

-async function fetchAndSave(song, kind, button) {
-  button.disabled = true;
-  notice.className = 'notice'; notice.textContent = `正在读取《${song.name}》…`;
-  try {
-    const data = await api('/api/lyrics', {mid: song.mid});
-    const base = safeName(`${song.name} - ${song.singer}`);
-    if (kind === 'lrc') download(`${base}.lrc`, data.lyric);
-    if (kind === 'txt') download(`${base}.txt`, plainText(data.lyric));
-    if (kind === 'trans') {
-      if (!data.trans) throw new Error('这首歌没有翻译歌词');
-      download(`${base}.trans.lrc`, data.trans);
+function parseLRC(lrc) {
+  const lines = [];
+  for (const raw of (lrc || '').split(/\r?\n/)) {
+    const stamps = [...raw.matchAll(/\[(\d+):(\d+)(?:[.:](\d{1,3}))?\]/g)];
+    if (!stamps.length) continue;
+    const content = raw.replace(/\[[^\]]*\]/g, '').trim();
+    if (!content) continue;
+    for (const stamp of stamps) {
+      const fraction = stamp[3] || '0';
+      const milliseconds = Number(fraction.padEnd(3, '0').slice(0, 3));
+      lines.push({time: Number(stamp[1]) * 60000 + Number(stamp[2]) * 1000 + milliseconds, content});
    }
-    notice.textContent = '文件已在浏览器中生成，内容未上传。';
-  } catch (error) {
-    notice.className = 'notice error'; notice.textContent = error.message;
-  } finally { button.disabled = false; }
+  }
+  return lines.sort((a, b) => a.time - b.time);
+}
+
+function timestamp(milliseconds) {
+  const minutes = Math.floor(milliseconds / 60000);
+  const seconds = Math.floor(milliseconds % 60000 / 1000);
+  const millis = milliseconds % 1000;
+  return `[${String(minutes).padStart(2, '0')}:${String(seconds).padStart(2, '0')}.${String(millis).padStart(3, '0')}]`;
+}
+
+function alignTrack(base, extra) {
+  const aligned = new Array(base.length).fill('');
+  let cursor = 0;
+  for (let index = 0; index < base.length && cursor < extra.length; index += 1) {
+    while (cursor + 1 < extra.length && Math.abs(extra[cursor + 1].time - base[index].time) <= Math.abs(extra[cursor].time - base[index].time)) cursor += 1;
+    if (Math.abs(extra[cursor].time - base[index].time) <= 1800) {
+      aligned[index] = extra[cursor].content;
+      cursor += 1;
+    }
+  }
+  return aligned;
+}
+
+function previewText(data, mode) {
+  const original = parseLRC(data.lyric);
+  if (!original.length) return data.lyric || '';
+  const translations = mode.includes('trans') ? alignTrack(original, parseLRC(data.trans)) : [];
+  const phonetics = mode.includes('roma') ? alignTrack(original, parseLRC(data.roma)) : [];
+  const output = [];
+  original.forEach((line, index) => {
+    output.push(`${timestamp(line.time)}${line.content}`);
+    if (translations[index]) output.push(`  译：${translations[index]}`);
+    if (phonetics[index]) output.push(`  音：${phonetics[index]}`);
+  });
+  return output.join('\n');
+}
+
+function cachedLyrics(song) {
+  if (!lyricCache.has(song.mid)) {
+    const request = api('/api/lyrics', {mid: song.mid}).catch(error => {
+      lyricCache.delete(song.mid);
+      throw error;
+    });
+    lyricCache.set(song.mid, request);
+  }
+  return lyricCache.get(song.mid);
+}
+
+function actionButton(label, primary, handler) {
+  const button = document.createElement('button');
+  button.type = 'button';
+  if (primary) button.className = 'primary';
+  button.append(text(label));
+  button.addEventListener('click', handler);
+  return button;
+}
+
+function saveLyrics(song, data, kind) {
+  const base = safeName(`${song.name} - ${song.singer}`);
+  const variants = {
+    lrc: [`${base}.lrc`, data.lyric],
+    txt: [`${base}.txt`, plainText(data.lyric)],
+    transLRC: [`${base}.trans.lrc`, data.trans],
+    transTXT: [`${base}.trans.txt`, plainText(data.trans)],
+    romaLRC: [`${base}.sound.lrc`, data.roma],
+    romaTXT: [`${base}.sound.txt`, plainText(data.roma)]
+  };
+  const selected = variants[kind];
+  if (!selected || !hasText(selected[1])) throw new Error('这首歌没有对应歌词');
+  download(selected[0], selected[1]);
+}
+
+function populatePreview(select, output, data) {
+  const current = select.value;
+  select.replaceChildren();
+  const choices = [['original', '仅原文']];
+  if (hasText(data.trans)) choices.push(['trans', '原文 + 翻译']);
+  if (hasText(data.roma)) choices.push(['roma', '原文 + 音']);
+  if (hasText(data.trans) && hasText(data.roma)) choices.push(['trans-roma', '原文 + 翻译 + 音']);
+  choices.forEach(([value, label]) => {
+    const option = document.createElement('option');
+    option.value = value;
+    option.append(text(label));
+    select.append(option);
+  });
+  if ([...select.options].some(option => option.value === current)) select.value = current;
+  output.textContent = previewText(data, select.value);
+}
+
+function renderSongActions(song, actions, data) {
+  actions.replaceChildren();
+  const definitions = [['lrc', '下载 LRC', true], ['txt', '原文 TXT', false]];
+  if (hasText(data.trans)) definitions.push(['transLRC', '翻译 LRC', false], ['transTXT', '翻译 TXT', false]);
+  if (hasText(data.roma)) definitions.push(['romaLRC', '音 LRC', false], ['romaTXT', '音 TXT', false]);
+  definitions.forEach(([kind, label, primary]) => {
+    actions.append(actionButton(label, primary, () => {
+      try {
+        saveLyrics(song, data, kind);
+        notice.className = 'notice';
+        notice.textContent = '文件已在浏览器中生成。';
+      } catch (error) {
+        notice.className = 'notice error';
+        notice.textContent = error.message;
+      }
+    }));
+  });
 }

 function renderSongs(songs) {
  results.replaceChildren();
  songs.forEach((song, index) => {
-    const article = document.createElement('article'); article.className = 'song';
+    const article = document.createElement('article');
+    article.className = 'song';
+    const top = document.createElement('div');
+    top.className = 'song-top';
    const info = document.createElement('div');
-    const title = document.createElement('h2'); title.append(text(`${String(index + 1).padStart(2, '0')}  ${song.name}`));
-    const meta = document.createElement('div'); meta.className = 'meta';
+    info.className = 'song-info';
+    const title = document.createElement('h2');
+    title.append(text(`${String(index + 1).padStart(2, '0')}  ${song.name}`));
+    const meta = document.createElement('div');
+    meta.className = 'meta';
    meta.append(text([song.singer, song.album ? `《${song.album}》` : '', duration(song.interval)].filter(Boolean).join(' · ')));
    info.append(title, meta);
-    const actions = document.createElement('div'); actions.className = 'actions';
-    [['lrc','下载 LRC','primary'],['txt','纯文本'],['trans','翻译 LRC']].forEach(([kind,label,klass]) => {
-      const button = document.createElement('button'); button.type = 'button'; button.className = klass || ''; button.append(text(label));
-      button.addEventListener('click', () => fetchAndSave(song, kind, button)); actions.append(button);
+
+    const actions = document.createElement('div');
+    actions.className = 'actions';
+    const details = document.createElement('details');
+    details.className = 'preview';
+    const summary = document.createElement('summary');
+    summary.append(text('完整歌词预览'));
+    const previewBody = document.createElement('div');
+    previewBody.className = 'preview-body';
+    const previewStatus = document.createElement('p');
+    previewStatus.className = 'preview-status';
+    previewStatus.append(text('展开后读取歌词。'));
+    const controls = document.createElement('label');
+    controls.className = 'preview-controls';
+    controls.hidden = true;
+    controls.append(text('预览内容 '));
+    const select = document.createElement('select');
+    controls.append(select);
+    const output = document.createElement('pre');
+    output.className = 'lyric-preview';
+    output.hidden = true;
+    previewBody.append(previewStatus, controls, output);
+    details.append(summary, previewBody);
+
+    let loadedData = null;
+    const load = async trigger => {
+      if (loadedData) return loadedData;
+      if (trigger) trigger.disabled = true;
+      previewStatus.textContent = `正在读取《${song.name}》…`;
+      notice.className = 'notice';
+      notice.textContent = `正在读取《${song.name}》…`;
+      try {
+        loadedData = await cachedLyrics(song);
+        renderSongActions(song, actions, loadedData);
+        populatePreview(select, output, loadedData);
+        controls.hidden = false;
+        output.hidden = false;
+        previewStatus.hidden = true;
+        notice.textContent = '歌词已读取；翻译和“音”按钮只在存在对应内容时显示。';
+        return loadedData;
+      } catch (error) {
+        previewStatus.hidden = false;
+        previewStatus.textContent = error.message;
+        notice.className = 'notice error';
+        notice.textContent = error.message;
+        if (details.open) details.open = false;
+        throw error;
+      } finally {
+        if (trigger) trigger.disabled = false;
+      }
+    };
+
+    const initialLRC = actionButton('下载 LRC', true, async () => {
+      try {
+        const data = await load(initialLRC);
+        saveLyrics(song, data, 'lrc');
+        notice.textContent = '文件已在浏览器中生成。';
+      } catch { /* load already reports the error */ }
    });
-    article.append(info, actions); results.append(article);
+    const initialTXT = actionButton('原文 TXT', false, async () => {
+      try {
+        const data = await load(initialTXT);
+        saveLyrics(song, data, 'txt');
+        notice.textContent = '文件已在浏览器中生成。';
+      } catch { /* load already reports the error */ }
+    });
+    actions.append(initialLRC, initialTXT);
+    details.addEventListener('toggle', () => {
+      if (details.open && !loadedData) load().catch(() => {});
+    });
+    select.addEventListener('change', () => {
+      if (loadedData) output.textContent = previewText(loadedData, select.value);
+    });
+
+    top.append(info, actions);
+    article.append(top, details);
+    results.append(article);
  });
 }

 form.addEventListener('submit', async event => {
-  event.preventDefault(); const submit = form.querySelector('button'); submit.disabled = true;
-  notice.className = 'notice'; notice.textContent = '正在从这台电脑搜索…'; results.replaceChildren();
+  event.preventDefault();
+  const submit = form.querySelector('button');
+  submit.disabled = true;
+  notice.className = 'notice';
+  notice.textContent = '正在搜索…';
+  results.replaceChildren();
+  lyricCache.clear();
  try {
    const data = await api('/api/search', {keyword: keyword.value.trim(), limit: 15});
-    renderSongs(data.songs || []); notice.textContent = data.songs?.length ? `找到 ${data.songs.length} 条结果。` : '没有找到相关歌曲。';
-  } catch (error) { notice.className = 'notice error'; notice.textContent = error.message; }
-  finally { submit.disabled = false; }
+    renderSongs(data.songs || []);
+    notice.textContent = data.songs?.length ? `找到 ${data.songs.length} 条结果。展开预览或下载时才会读取歌词。` : '没有找到相关歌曲。';
+  } catch (error) {
+    notice.className = 'notice error';
+    notice.textContent = error.message;
+  } finally {
+    submit.disabled = false;
+  }
 });
+
+loadInfo();
@@ -1 +1 @@
-:root{font-family:Inter,"Segoe UI","PingFang SC",sans-serif;color:#eaf0ee;background:#09100e;color-scheme:dark;--mint:#75f0b2;--muted:#93a39e;--line:#26332f}*{box-sizing:border-box}body{margin:0;min-height:100vh;background:radial-gradient(circle at 85% 5%,#17442f 0,transparent 31rem),linear-gradient(145deg,#09100e,#101815 60%,#080d0b)}body:before{content:"";position:fixed;inset:0;pointer-events:none;opacity:.12;background-image:linear-gradient(#fff 1px,transparent 1px),linear-gradient(90deg,#fff 1px,transparent 1px);background-size:48px 48px}.shell{width:min(1020px,calc(100% - 32px));margin:auto;padding:30px 0 48px;position:relative}header{display:flex;justify-content:space-between;align-items:center}.brand{font-size:1.1rem;font-weight:850;letter-spacing:.08em}.brand span{color:var(--mint)}.local-pill{border:1px solid #315044;background:#10251d;padding:8px 12px;border-radius:99px;color:#b9d3c9;font-size:.82rem}.local-pill i{display:inline-block;width:7px;height:7px;background:var(--mint);border-radius:50%;box-shadow:0 0 12px var(--mint);margin-right:6px}.hero{padding:90px 0 42px;max-width:780px}.eyebrow{color:var(--mint);font-family:ui-monospace,monospace;font-size:.78rem;letter-spacing:.18em}.hero h1{font-size:clamp(3.1rem,9vw,6.8rem);line-height:.91;letter-spacing:-.065em;margin:24px 0;font-weight:880}.hero h1 em{font-style:normal;color:transparent;-webkit-text-stroke:1px #9ec4b5}.lead{color:var(--muted);font-size:1.08rem;line-height:1.75;max-width:650px}form{margin-top:38px}label{display:block;font-size:.82rem;color:#b5c4bf;margin-bottom:9px}.search-row{display:flex;gap:10px}input{flex:1;min-width:0;background:#eff7f3;color:#0b1511;border:0;border-radius:8px;padding:17px 18px;font:inherit;font-size:1.04rem;outline:2px solid transparent}input:focus{outline-color:var(--mint)}button{border:0;border-radius:8px;padding:0 24px;background:var(--mint);color:#07100c;font:inherit;font-weight:800;cursor:pointer}button:hover{filter:brightness(1.06)}button:disabled{opacity:.55;cursor:wait}.notice{min-height:28px;color:#b7cac2;margin-top:14px}.notice.error{color:#ff9b9b}.results{display:grid;gap:10px}.song{display:grid;grid-template-columns:minmax(0,1fr) auto;gap:20px;align-items:center;padding:20px;border:1px solid var(--line);background:#101916d9;border-radius:12px}.song h2{font-size:1.05rem;margin:0 0 7px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.meta{color:var(--muted);font-size:.86rem;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.actions{display:flex;gap:7px}.actions button{background:#1c2a25;color:#d9e7e2;border:1px solid #31453e;padding:9px 12px;font-size:.82rem}.actions button.primary{background:var(--mint);border-color:var(--mint);color:#07100c}footer{margin-top:70px;padding-top:20px;border-top:1px solid var(--line);color:#75847f;font-size:.78rem}@media(max-width:700px){.shell{width:min(100% - 22px,1020px)}.hero{padding-top:65px}.hero h1{font-size:3.6rem}.search-row{display:grid}.search-row button{padding:15px}.song{grid-template-columns:1fr}.actions{flex-wrap:wrap}.actions button{flex:1}.local-pill{font-size:.72rem}}
+:root{font-family:system-ui,-apple-system,"Segoe UI","PingFang SC",sans-serif;color:#1f2937;background:#f7f8fa;color-scheme:light;line-height:1.55}*{box-sizing:border-box}body{margin:0}main{width:min(900px,calc(100% - 28px));margin:0 auto;padding:34px 0 60px}header{display:flex;align-items:center;justify-content:space-between;border-bottom:1px solid #dfe3e8;padding-bottom:16px;margin-bottom:28px}h1{font-size:1.5rem;margin:0}h2{font-size:1.05rem;margin:0 0 8px}a{color:#155eef}p{margin:10px 0}.note{background:#eef4ff;border:1px solid #c9d9ff;border-radius:8px;padding:10px 12px;color:#344054;font-size:.9rem}form{margin:26px 0 0}label{display:block;font-weight:650;margin-bottom:7px}.search-row{display:flex;gap:8px}input{flex:1;min-width:0;border:1px solid #b8c0cc;border-radius:7px;background:#fff;color:#111827;padding:12px;font:inherit}input:focus,select:focus{outline:2px solid #8bb6ff;border-color:#3977db}button{border:0;border-radius:7px;background:#2563eb;color:#fff;padding:0 20px;font:inherit;font-weight:650;cursor:pointer}button:disabled{opacity:.55;cursor:wait}.notice{min-height:28px;margin:10px 0;color:#475467}.notice.error{color:#b42318}.results{display:grid;gap:8px}.song{padding:14px;background:#fff;border:1px solid #dfe3e8;border-radius:8px;min-width:0}.song-top{display:grid;grid-template-columns:minmax(0,1fr) auto;gap:16px;align-items:center}.song-info{min-width:0}.song h2{white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.meta{color:#667085;font-size:.86rem;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.actions{display:flex;flex-wrap:wrap;justify-content:flex-end;gap:6px}.actions button{background:#fff;color:#344054;border:1px solid #b8c0cc;padding:7px 10px;font-size:.82rem}.actions button.primary{background:#2563eb;color:#fff;border-color:#2563eb}.preview{margin-top:12px;border-top:1px solid #eaecf0;padding-top:10px}.preview summary{color:#155eef;cursor:pointer;font-size:.9rem;width:max-content}.preview-body{padding-top:10px}.preview-status{color:#667085;font-size:.86rem;margin:0}.preview-controls{font-size:.86rem;margin:0 0 8px}.preview-controls select{border:1px solid #b8c0cc;border-radius:6px;background:#fff;color:#1f2937;padding:6px 28px 6px 8px;font:inherit}.lyric-preview{width:100%;max-height:min(62vh,720px);overflow:auto;white-space:pre-wrap;overflow-wrap:anywhere;margin:0;padding:12px;border:1px solid #dfe3e8;border-radius:7px;background:#f8fafc;color:#344054;font:ui-monospace,SFMono-Regular,Consolas,"Liberation Mono",monospace;font-size:.82rem;line-height:1.65}.downloads{margin-top:38px;padding-top:24px;border-top:1px solid #dfe3e8}.downloads p,footer{color:#667085;font-size:.88rem}.download-links{display:flex;flex-wrap:wrap;gap:8px 15px}code{background:#eceff3;padding:1px 4px;border-radius:4px}footer{margin-top:35px;padding-top:20px;border-top:1px solid #dfe3e8}@media(max-width:700px){main{padding-top:22px}.search-row{display:grid}.search-row button{padding:11px}.song-top{grid-template-columns:1fr}.actions{justify-content:flex-start}.actions button{flex:1 1 auto}.preview summary{width:auto}.lyric-preview{max-height:58vh;padding:10px;font-size:.78rem}}
Author	SHA1	Message	Date
Flechazo	783e620214	feat: add translated and phonetic lyric previews	2026-08-26 00:59:33 +08:00
Flechazo	bfd84ccdb5	fix: keep public security headers authoritative	2026-08-25 23:17:42 +08:00
Flechazo	1fbfa32fbd	merge: preserve concise public documentation	2026-08-25 23:10:13 +08:00
Flechazo	54167c1b59	feat: add protected public web lyrics workflow	2026-08-25 23:08:28 +08:00
Flechazo	4669d5f1bd	更新 README.md	2026-08-25 14:51:17 +00:00
				`@@ -1 +0,0 @@`
				:root{font-family:Inter,"Segoe UI","PingFang SC",sans-serif;background:#08100d;color:#edf6f2;color-scheme:dark;--mint:#75f0b2;--muted:#94a49e;--line:#27352f}*{box-sizing:border-box}body{margin:0;background:radial-gradient(circle at 87% 5%,#185036 0,transparent 34rem),#08100d}main{width:min(1160px,calc(100% - 34px));margin:auto}nav{height:86px;display:flex;align-items:center;justify-content:space-between;border-bottom:1px solid var(--line)}nav b{letter-spacing:.08em}nav i{font-style:normal;color:var(--mint)}a{color:inherit}.hero{min-height:650px;display:grid;grid-template-columns:minmax(0,1.45fr) minmax(310px,.55fr);gap:70px;align-items:center}.tag{color:var(--mint);font:700 .74rem ui-monospace,monospace;letter-spacing:.18em}.copy h1{font-size:clamp(3.8rem,8.2vw,7.4rem);line-height:.88;letter-spacing:-.07em;margin:28px 0}.copy h1 em{font-style:normal;color:transparent;-webkit-text-stroke:1px #a9c9bc}.lead{max-width:690px;color:var(--muted);font-size:1.1rem;line-height:1.8}aside{border:1px solid #3a554a;background:#10211a;padding:28px;border-radius:14px;box-shadow:0 24px 70px #0008}aside>span,.steps b{color:var(--mint);font:700 .78rem ui-monospace,monospace}aside h2{font-size:1.7rem;margin:18px 0 8px}aside p,.steps p,.trust p{color:var(--muted);line-height:1.7}.primary{display:block;text-align:center;background:var(--mint);color:#07110c;text-decoration:none;font-weight:850;border-radius:8px;padding:15px;margin:25px 0 12px}.secondary{display:grid;gap:7px}.secondary a{text-align:center;border:1px solid #365046;border-radius:7px;padding:10px;text-decoration:none;font-size:.84rem}.steps{display:grid;grid-template-columns:repeat(3,1fr);border-top:1px solid var(--line);border-bottom:1px solid var(--line)}.steps article{padding:36px 30px;border-right:1px solid var(--line)}.steps article:last-child{border:0}.steps h3{font-size:1.25rem}.trust{padding:80px 0;max-width:850px}.trust h2{font-size:2.4rem;letter-spacing:-.035em}.small{font-size:.82rem}code{background:#15231e;padding:2px 5px;border-radius:4px;color:#c6e3d7}@media(max-width:800px){.hero{grid-template-columns:1fr;padding:65px 0}.copy h1{font-size:4rem}.steps{grid-template-columns:1fr}.steps article{border-right:0;border-bottom:1px solid var(--line)}}