From 2829e3b08214348f05ff2f5beae644882eccad58 Mon Sep 17 00:00:00 2001
From: InfinityPacer <160988576+InfinityPacer@users.noreply.github.com>
Date: Mon, 15 Jun 2026 15:54:08 +0800
Subject: [PATCH] fix(subscribe): display special season labels (#491)

---
 scripts/check-season-label.ts          | 12 ++++++++++++
 src/@core/utils/season.ts              | 15 +++++++++++++++
 src/components/cards/SubscribeCard.vue |  5 +++--
 src/locales/en-US.ts                   |  1 +
 src/locales/zh-CN.ts                   |  1 +
 src/locales/zh-TW.ts                   |  1 +
 src/views/discover/MediaDetailView.vue |  6 ++++--
 7 files changed, 37 insertions(+), 4 deletions(-)
 create mode 100644 scripts/check-season-label.ts
 create mode 100644 src/@core/utils/season.ts

diff --git a/scripts/check-season-label.ts b/scripts/check-season-label.ts
new file mode 100644
index 00000000..f758e59b
--- /dev/null
+++ b/scripts/check-season-label.ts
@@ -0,0 +1,12 @@
+import assert from 'node:assert/strict'
+
+import { formatSeasonLabel } from '../src/@core/utils/season.ts'
+
+assert.equal(formatSeasonLabel(0, '特别篇'), '特别篇')
+assert.equal(formatSeasonLabel('0', 'Specials'), 'Specials')
+assert.equal(formatSeasonLabel(1, '特别篇'), 'S01')
+assert.equal(formatSeasonLabel('12', '特别篇'), 'S12')
+assert.equal(formatSeasonLabel(null, '特别篇'), '')
+assert.equal(formatSeasonLabel(undefined, '特别篇'), '')
+
+console.log('season label checks passed')
diff --git a/src/@core/utils/season.ts b/src/@core/utils/season.ts
new file mode 100644
index 00000000..11e644be
--- /dev/null
+++ b/src/@core/utils/season.ts
@@ -0,0 +1,15 @@
+/**
+ * 格式化用户可见的季标签。
+ *
+ * TMDB 使用季号 0 表示特别季；调用方传入当前语言的特别季名称，
+ * 其余季号保持 MoviePilot 现有的 Sxx 展示口径。
+ */
+export function formatSeasonLabel(
+  season: number | string | null | undefined,
+  specialsLabel: string,
+): string {
+  if (season === null || season === undefined || season === '') return ''
+  if (Number(season) === 0) return specialsLabel
+
+  return `S${String(season).padStart(2, '0')}`
+}
diff --git a/src/components/cards/SubscribeCard.vue b/src/components/cards/SubscribeCard.vue
index 5b2f4f13..8f7f7489 100644
--- a/src/components/cards/SubscribeCard.vue
+++ b/src/components/cards/SubscribeCard.vue
@@ -1,7 +1,8 @@
 <script lang="ts" setup>
 import { useToast } from 'vue-toastification'
 import { useConfirm } from '@/composables/useConfirm'
-import { formatDateDifference, formatSeason } from '@/@core/utils/formatters'
+import { formatDateDifference } from '@/@core/utils/formatters'
+import { formatSeasonLabel } from '@/@core/utils/season'
 import api from '@/api'
 import type { Subscribe } from '@/api/types'
 import router from '@/router'
@@ -478,7 +479,7 @@ function handleCardClick() {
                   <div class="text-sm font-medium text-white sm:pt-1">{{ props.media?.year }}</div>
                   <div class="mr-2 min-w-0 text-lg font-bold text-white text-ellipsis overflow-hidden line-clamp-2 ...">
                     {{ props.media?.name }}
-                    {{ formatSeason(props.media?.season ? props.media?.season.toString() : '') }}
+                    {{ formatSeasonLabel(props.media?.season, t('media.specials')) }}
                   </div>
                 </div>
               </VCardText>
diff --git a/src/locales/en-US.ts b/src/locales/en-US.ts
index 002748d0..132ced78 100644
--- a/src/locales/en-US.ts
+++ b/src/locales/en-US.ts
@@ -950,6 +950,7 @@ export default {
     minutes: 'minutes',
     overview: 'Overview',
     seasons: 'Seasons',
+    specials: 'Specials',
     seasonNumber: 'Season {number}',
     episodeCount: '{count} Episodes',
     actions: {
diff --git a/src/locales/zh-CN.ts b/src/locales/zh-CN.ts
index 5f82042a..aabbb571 100644
--- a/src/locales/zh-CN.ts
+++ b/src/locales/zh-CN.ts
@@ -946,6 +946,7 @@ export default {
     minutes: '分钟',
     overview: '简介',
     seasons: '季',
+    specials: '特别篇',
     seasonNumber: '第 {number} 季',
     episodeCount: '{count}集',
     actions: {
diff --git a/src/locales/zh-TW.ts b/src/locales/zh-TW.ts
index 2663eeb8..7d2ecb01 100644
--- a/src/locales/zh-TW.ts
+++ b/src/locales/zh-TW.ts
@@ -946,6 +946,7 @@ export default {
     minutes: '分鐘',
     overview: '簡介',
     seasons: '季',
+    specials: '特別篇',
     seasonNumber: '第 {number} 季',
     episodeCount: '{count}集',
     actions: {
diff --git a/src/views/discover/MediaDetailView.vue b/src/views/discover/MediaDetailView.vue
index a26ff47a..6911c2b1 100644
--- a/src/views/discover/MediaDetailView.vue
+++ b/src/views/discover/MediaDetailView.vue
@@ -7,6 +7,7 @@ import type { MediaInfo, NotExistMediaInfo, Site, Subscribe, TmdbEpisode } from
 import NoDataFound from '@/components/NoDataFound.vue'
 import { doneNProgress, startNProgress } from '@/api/nprogress'
 import { formatSeason } from '@/@core/utils/formatters'
+import { formatSeasonLabel } from '@/@core/utils/season'
 import router from '@/router'
 import { isNullOrEmptyObject } from '@/@core/utils'
 import { useUserStore } from '@/stores'
@@ -807,8 +808,9 @@ onBeforeMount(() => {
                   <template #default>
                     <div class="flex flex-row items-center justify-between">
                       <span class="font-weight-bold">{{
-                        season.season_number === 0 && season.name ?
-                        season.name : t('media.seasonNumber', { number: season.season_number })
+                        season.season_number === 0
+                          ? season.name || formatSeasonLabel(0, t('media.specials'))
+                          : t('media.seasonNumber', { number: season.season_number })
                         }}</span>
                       <VChip size="small" class="ms-1">
                         {{ t('media.episodeCount', { count: season.episode_count }) }}