Seasons API, search filtering, and landing-page polish

Folds in the Seasons API + library search filtering, plus landing-page
updates: a real hero photo, a new 使用指南/guide page, and an IPTV
feature callout — all added since the previous local v0.9.4 commit.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

Author: YangHanqing

desktop-go/internal/emby/client.go

@@ -349,6 +349,11 @@ func (c *Client) Episodes(seriesID, seasonID string, start, limit int, sort stri
 	return c.request("GET", "/Shows/"+seriesID+"/Episodes", q, nil)
 }
 
+func (c *Client) Seasons(seriesID string) ([]byte, error) {
+	q := url.Values{"UserId": {c.userID()}}
+	return c.request("GET", "/Shows/"+seriesID+"/Seasons", q, nil)
+}
+
 // ── Images ───────────────────────────────────────────────────────────────────
 
 // ImageBytes returns the image content and its content-type, or nil if missing.

desktop-go/internal/plex/client.go

@@ -356,6 +356,23 @@ func (c *Client) Episodes(series, season string, start, limit int, order string)
 	return marshalItems(out[start:end], int64(total))
 }
 
+func (c *Client) Seasons(seriesID string) ([]byte, error) {
+	d, e := c.get("/library/metadata/"+url.PathEscape(seriesID)+"/children", nil)
+	if e != nil {
+		return nil, e
+	}
+	out := []map[string]any{}
+	for _, m := range metadata(d) {
+		if strings.EqualFold(stringValue(m["type"]), "season") {
+			out = append(out, mapItem(m, false))
+		}
+	}
+	sort.Slice(out, func(i, j int) bool {
+		return integer(out[i]["IndexNumber"]) < integer(out[j]["IndexNumber"])
+	})
+	return marshalItems(out, int64(len(out)))
+}
+
 func (c *Client) ImageBytes(id string, maxHeight int, imageType string) ([]byte, string) {
 	d, e := c.get("/library/metadata/"+url.PathEscape(id), nil)
 	if e != nil {

desktop-go/internal/provider/provider.go

@@ -23,6 +23,7 @@ type Media interface {
 	Resume(limit int) ([]byte, error)
 	ItemDetailRaw(id string) ([]byte, error)
 	Episodes(series, season string, start, limit int, sort string) ([]byte, error)
+	Seasons(seriesID string) ([]byte, error)
 	ImageBytes(id string, maxHeight int, imageType string) ([]byte, string)
 	BackdropBytes(id string, maxHeight, index int) ([]byte, string)
 	ChoosePlayURL(id string) (PlayChoice, error)
@@ -47,6 +48,7 @@ func (m *embyMedia) ItemDetailRaw(a string) ([]byte, error) { return m.c.ItemDet
 func (m *embyMedia) Episodes(a, b string, c, d int, e string) ([]byte, error) {
 	return m.c.Episodes(a, b, c, d, e)
 }
+func (m *embyMedia) Seasons(a string) ([]byte, error) { return m.c.Seasons(a) }
 func (m *embyMedia) ImageBytes(a string, b int, c string) ([]byte, string) {
 	return m.c.ImageBytes(a, b, c)
 }
@@ -76,6 +78,7 @@ func (m *plexMedia) ItemDetailRaw(a string) ([]byte, error) { return m.c.ItemDet
 func (m *plexMedia) Episodes(a, b string, c, d int, e string) ([]byte, error) {
 	return m.c.Episodes(a, b, c, d, e)
 }
+func (m *plexMedia) Seasons(a string) ([]byte, error) { return m.c.Seasons(a) }
 func (m *plexMedia) ImageBytes(a string, b int, c string) ([]byte, string) {
 	return m.c.ImageBytes(a, b, c)
 }

desktop-go/internal/server/handlers.go

@@ -416,9 +416,42 @@ func (s *Server) embyItems(w http.ResponseWriter, r *http.Request) {
 		qInt(r, "limit", 60),
 		search != "",
 	)
+	if err == nil && search != "" {
+		body = dropUnmatchedEpisodes(body, search)
+	}
 	writeRaw(w, r, body, err)
 }
 
+// dropUnmatchedEpisodes removes Episode results that only matched because the
+// server indexes an episode under its parent series name — otherwise a
+// series-title search floods the results with every episode of that show.
+// An episode stays only if its own title contains the search term.
+func dropUnmatchedEpisodes(body []byte, search string) []byte {
+	var payload struct {
+		Items            []map[string]any `json:"Items"`
+		TotalRecordCount int              `json:"TotalRecordCount"`
+	}
+	if json.Unmarshal(body, &payload) != nil {
+		return body
+	}
+	q := strings.ToLower(search)
+	filtered := payload.Items[:0]
+	for _, item := range payload.Items {
+		if typ, _ := item["Type"].(string); typ == "Episode" {
+			name, _ := item["Name"].(string)
+			if !strings.Contains(strings.ToLower(name), q) {
+				continue
+			}
+		}
+		filtered = append(filtered, item)
+	}
+	payload.Items = filtered
+	if out, err := json.Marshal(payload); err == nil {
+		return out
+	}
+	return body
+}
+
 func (s *Server) embyItemDetail(w http.ResponseWriter, r *http.Request) {
 	c, err := provider.Active()
 	if err != nil {
@@ -449,6 +482,16 @@ func (s *Server) embyEpisodes(w http.ResponseWriter, r *http.Request) {
 	writeRaw(w, r, body, err)
 }
 
+func (s *Server) embySeasons(w http.ResponseWriter, r *http.Request) {
+	c, err := provider.Active()
+	if err != nil {
+		writeErr(w, r, err)
+		return
+	}
+	body, err := c.Seasons(r.URL.Query().Get("series_id"))
+	writeRaw(w, r, body, err)
+}
+
 func (s *Server) embyImage(w http.ResponseWriter, r *http.Request) {
 	c, err := provider.Active()
 	if err != nil {

desktop-go/internal/server/server.go

@@ -57,6 +57,7 @@ func (s *Server) Handler() http.Handler {
 	mux.HandleFunc("GET /api/emby/items", s.embyItems)
 	mux.HandleFunc("GET /api/emby/items/{item_id}", s.embyItemDetail)
 	mux.HandleFunc("GET /api/emby/episodes", s.embyEpisodes)
+	mux.HandleFunc("GET /api/emby/seasons", s.embySeasons)
 	mux.HandleFunc("GET /api/emby/image/{item_id}", s.embyImage)
 
 	// ── File sources (local / SMB / WebDAV) ──

site/assets/hero.jpg

@@ -13,6 +13,7 @@
 }
 
 * { box-sizing: border-box; }
+.hidden { display: none !important; }
 html { scroll-behavior: smooth; }
 body { margin: 0; color: var(--ink); background: var(--paper); font-family: Inter, ui-sans-serif, -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", "Microsoft YaHei", sans-serif; line-height: 1.6; }
 a { color: inherit; text-decoration: none; }
@@ -183,3 +184,61 @@ footer a:hover { color: white; }
 .modal-card h3 { margin-bottom: 10px; font-size: 22px; }
 .modal-card p { margin-bottom: 24px; color: var(--muted); font-size: 14px; }
 .modal-card .button { width: 100%; }
+
+/* ---- Guide page ("使用指南") ---- */
+.guide-hero { padding: 170px 0 70px; }
+.guide-hero .back-link { display: inline-flex; align-items: center; gap: 6px; margin-bottom: 26px; color: #80938b; font-size: 13px; }
+.guide-hero .back-link:hover { color: white; }
+.guide-hero h1 { max-width: 780px; }
+.guide-hero .hero-lead { margin-bottom: 0; }
+
+.path-nav { display: grid; grid-template-columns: repeat(4, 1fr); gap: 14px; padding-bottom: 70px; }
+.path-nav a { display: block; padding: 26px 24px; border: 1px solid var(--line); border-radius: var(--radius); background: rgba(255,255,255,.022); transition: transform .2s, background .2s, border-color .2s; }
+.path-nav a:hover { transform: translateY(-3px); background: rgba(255,255,255,.045); border-color: rgba(221,245,233,.3); }
+.path-nav span { display: block; margin-bottom: 14px; color: var(--mint); font: 11px ui-monospace, monospace; text-transform: uppercase; letter-spacing: .06em; }
+.path-nav h3 { margin-bottom: 8px; font-size: 17px; letter-spacing: -.02em; }
+.path-nav p { margin: 0; color: #82948c; font-size: 13px; }
+
+.guide-section { padding: 70px 0; border-top: 1px solid var(--line); }
+.guide-section .section-heading { max-width: 760px; margin-bottom: 40px; }
+.guide-section h2 { font-size: clamp(30px, 3.6vw, 44px); }
+.guide-section .section-body { max-width: 760px; color: #a9bab3; font-size: 17px; }
+
+.callout { display: flex; gap: 18px; margin-top: 32px; padding: 28px 30px; border: 1px solid rgba(185,243,74,.25); border-radius: var(--radius); background: rgba(185,243,74,.055); }
+.callout .callout-mark { flex-shrink: 0; color: var(--acid); font-size: 20px; line-height: 1; }
+.callout h4 { margin-bottom: 8px; font-size: 15px; }
+.callout p { margin: 0; color: #a9bab3; font-size: 14px; }
+.callout p b { color: var(--ink); }
+
+.os-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 18px; margin-top: 36px; }
+.os-card { padding: 30px; border: 1px solid var(--line); border-radius: var(--radius); background: rgba(255,255,255,.022); }
+.os-card > b { display: inline-block; margin-bottom: 20px; padding: 5px 14px; border-radius: 999px; background: var(--ink); color: var(--dark); font-size: 12px; font-weight: 800; }
+.os-card .os-step { padding: 16px 0; border-top: 1px solid var(--line); }
+.os-card .os-step:first-of-type { border-top: none; }
+.os-card .os-step h4 { margin-bottom: 6px; font-size: 14px; color: var(--mint); }
+.os-card .os-step p { margin: 0; color: #8fa198; font-size: 13.5px; }
+
+.reco-card { display: flex; align-items: flex-start; gap: 26px; margin-top: 36px; padding: 34px; border-radius: var(--radius); background: var(--warm); color: #17201d; }
+.reco-card .reco-badge { flex-shrink: 0; display: flex; flex-direction: column; align-items: center; justify-content: center; min-width: 108px; padding: 18px 10px; border-radius: 20px; background: #14251f; color: white; text-align: center; }
+.reco-card .reco-badge span { color: var(--acid); font-size: 10px; font-weight: 800; letter-spacing: .06em; text-transform: uppercase; }
+.reco-card .reco-badge strong { margin-top: 8px; font-size: 18px; }
+.reco-card p { margin: 0; color: #59655f; font-size: 14.5px; }
+
+.guide-cta { margin: 40px 0 110px; padding: 70px 80px; display: flex; align-items: center; justify-content: space-between; gap: 40px; border-radius: 36px; background: var(--acid); color: var(--dark); }
+.guide-cta h2 { margin-bottom: 6px; font-size: clamp(26px, 3vw, 36px); }
+.guide-cta p { margin: 0; color: #3f5b1e; font-size: 14px; }
+
+@media (max-width: 900px) {
+  .path-nav { grid-template-columns: repeat(2, 1fr); }
+  .os-grid { grid-template-columns: 1fr; }
+  .reco-card { flex-direction: column; }
+  .guide-cta { flex-direction: column; align-items: start; padding: 55px; }
+}
+
+@media (max-width: 640px) {
+  .guide-hero { padding: 125px 0 50px; }
+  .path-nav { grid-template-columns: 1fr; padding-bottom: 45px; }
+  .guide-section { padding: 50px 0; }
+  .callout { flex-direction: column; padding: 24px; }
+  .guide-cta { margin: 25px 0 70px; padding: 38px 26px; }
+}