Cherry Chu

Appearance

Lyrics Card Generator v5.6.1 Release Notes ​

Release date: 2026-07-15

v5.6.1 fixes a request-boundary regression introduced in v5.5.4 and restores NetEase Cloud Music search, search-result resolution, and multi-platform song-link parsing.

Search and parsing restored ​

  • NetEase Cloud Music search returns song candidates again, and selecting a result imports its metadata and lyrics.
  • Spotify, Apple Music, NetEase, and QQ Music links once again populate metadata through the song parser.
  • The underlying NetEase search, detail, and lyric protocols were unchanged; existing parsers and output shapes remain compatible.

Request-boundary fix ​

  • v5.5.4 compared the browser's Origin directly with Next's internal request.url. The desktop page loads from 127.0.0.1, while Next normalizes the route URL to localhost, so the same loopback service was misclassified as cross-origin and returned 403.
  • The boundary now reconstructs the externally visited origin from Host, X-Forwarded-Host, and the forwarded protocol. Missing origins, explicit cross-site requests, and real origin mismatches are still rejected, while the app marker and media-type checks remain unchanged.
  • Shared protections for AI translation, local-audio parsing, and lyric fetching remain enabled.

Verification ​

  • Regression coverage now includes Next's internal localhost URL with an external 127.0.0.1 origin, missing origins, missing app markers, and explicit cross-site metadata.
  • The production browser flow covers NetEase search, result import, and song-link parsing.
  • Editing, importing, translation, export, and the v5.6.0 visual behavior remain unchanged.

Cherry Chu · Projects, notes, and working documentation.

© 2026 Qrzzzz