为订阅内容卡片增加“加入角色卡”按钮，支持从单个 Steam 创意工坊订阅中手动恢复/添加角色卡 (#1523)

* 为订阅内容卡片增加“加入角色卡”按钮，支持从单个 Steam 创意工坊订阅中手动恢复/添加角色卡

* _sync_result() 现在无论是否 target sync 都会带上 code

loadCharacterCards() 刷新失败单独提示“刷新列表失败”，不再误报为“加入角色卡失败”

* 已存在但仍带 tombstone 的角色，现在手动“加入角色卡”会清理 tombstone，并作为恢复成功返回，不再误走 409

* restored_existing_candidates 不再只按名字清 tombstone；现在只清理已确认属于当前 Workshop item 的同名角色

* fix(workshop): _is_matching_workshop_character 也按 avatar 绑定判定归属

恢复路径的归属判定原本只看 character_origin.source_id，但退订确认路径
(_is_confirmed_workshop_character) 已同时把 avatar.asset_source_id 当作 Workshop
归属依据。旧数据/半迁移数据可能只有 avatar 绑定（live2d_item_id 迁移只写
avatar.asset_source_id；用户在模型设置里手动绑定 Workshop 模型时也只写 avatar.*），
这类角色会被退订按 avatar 命中删除并打 tombstone，却无法被恢复路径识别，导致
tombstone 永远清不掉、/sync-character/{item_id} 一直回 409。两边判定收口为一致。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* fix(workshop): 同步内部异常显式回 500，不再伪装成业务态

sync_workshop_character_cards 的外层 except 原本只 log + error_count+=1 后
返回普通 _sync_result()（无 code），下游 /sync-character/{item_id} 与
/sync-characters 只按业务 code 分支，导致真实后端异常被误判成
WORKSHOP_CHARACTER_NOT_FOUND / NOT_ADDED，前端把服务端故障当成
"此订阅里没有角色卡"。

外层 except 改为返回专属 code WORKSHOP_SYNC_FAILED（区别于逐角色的部分错误，
后者仍走原 error_count 累加），两个入口都补 500 映射。前端 !response.ok 分支
会把后端 error 串接进通用失败文案，无需新增 i18n key。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* fix(workshop): 恢复成功也回写 added_character_names，前端提示不丢名字

/sync-character/{item_id} 成功分支用 successful_names（added + restored 去重）
拼 message，但响应只 **result，added_character_names 在“仅清 tombstone 恢复成功”
场景仍为空。前端成功提示只读 added_character_names，会被
formatWorkshopCharacterNameList 回退成“未知角色卡”。把 successful_names 回写到
added_character_names，restored_deleted_names 仍保留。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Hongzhi Wen <cartabio.coder1@gmail.com>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: 3 people

main_routers/workshop_router.py

@@ -2675,11 +2675,13 @@ line-height: 1.4;
 
 /* 卡片操作按钮 - workshop-card专用（按钮区域） */
 .workshop-card .card-actions {
-    background-color: #bcf1ff;
-    padding: 6px;
-    border-radius: 50px;
+    background: transparent;
+    padding: 0;
+    border-radius: 0;
     margin: auto 8px 0 8px;
-    display: block;
+    display: flex;
+    flex-direction: column;
+    gap: 18px;
 }
 
 .workshop-card .card-actions button,
@@ -2693,7 +2695,9 @@ line-height: 1.4;
     font-weight: 900;
     letter-spacing: 2px;
     padding: 14px 0;
+    margin: 0 !important;
     cursor: pointer;
+    box-shadow: 0 0 0 6px #bcf1ff;
     text-shadow: 0px 1px 2px rgba(0, 0, 0, 0.1);
     transition: filter 0.2s;
 }
@@ -2702,7 +2706,7 @@ line-height: 1.4;
 .workshop-card .card-actions .button:hover {
     filter: brightness(1.05);
     transform: none;
-    box-shadow: none;
+    box-shadow: 0 0 0 6px #bcf1ff;
 }
 
 /* 已发布/禁用按钮 - 非交互外观 */
@@ -2712,13 +2716,14 @@ line-height: 1.4;
     color: rgba(255, 255, 255, 0.8);
     cursor: not-allowed;
     opacity: 0.7;
+    box-shadow: 0 0 0 6px #bcf1ff;
 }
 
 .workshop-card .card-actions .button-disabled:hover,
 .workshop-card .card-actions button[disabled]:hover {
     filter: none;
     transform: none;
-    box-shadow: none;
+    box-shadow: 0 0 0 6px #bcf1ff;
 }
 
 /* 卡片操作按钮 */
@@ -7043,12 +7048,28 @@ margin-top: 10px;
     color: #93c5fd;
 }
 
-[data-theme="dark"] .workshop-card .card-path,
-[data-theme="dark"] .workshop-card .card-actions {
+[data-theme="dark"] .workshop-card .card-path {
     background: rgba(15, 23, 42, 0.42);
     border: 1px solid rgba(125, 211, 252, 0.18);
 }
 
+/* 订阅卡操作区保持透明，按钮各自保留独立底板。 */
+[data-theme="dark"] .workshop-card .card-actions {
+    background: transparent;
+    border: 0;
+}
+
+[data-theme="dark"] .workshop-card .card-actions button,
+[data-theme="dark"] .workshop-card .card-actions .button,
+[data-theme="dark"] .workshop-card .card-actions button:hover,
+[data-theme="dark"] .workshop-card .card-actions .button:hover,
+[data-theme="dark"] .workshop-card .card-actions .button-disabled,
+[data-theme="dark"] .workshop-card .card-actions button[disabled],
+[data-theme="dark"] .workshop-card .card-actions .button-disabled:hover,
+[data-theme="dark"] .workshop-card .card-actions button[disabled]:hover {
+    box-shadow: 0 0 0 6px rgba(15, 23, 42, 0.42);
+}
+
 [data-theme="dark"] .card-info-body,
 [data-theme="dark"] #card-info-preview,
 [data-theme="dark"] #card-info-dynamic-content,

static/css/character_card_manager.css

@@ -2064,6 +2064,7 @@ function renderSubscriptionsPage() {
                         <button class="button button-primary" onclick="openWorkshopVoiceClone('${formattedItem.id}')" title="${formattedItem.voiceReferenceDisplayName || ''}" style="margin-bottom: 8px;">
                             ${window.t ? window.t('steam.openVoiceClone') : '在语音克隆页打开'}
                         </button>` : ''}
+                        <button class="button button-primary" data-item-id="${formattedItem.id}" data-item-name="${formattedItem.name}" onclick="addWorkshopCharacterCardFromSubscription(this)" style="margin-bottom: 8px;">${window.t ? window.t('steam.workshopAddCharacterCard') : '加入角色卡'}</button>
                         <button class="button button-danger" data-item-id="${formattedItem.id}" data-item-name="${formattedItem.name}" onclick="unsubscribeItem(this.dataset.itemId, this.dataset.itemName)">${window.t ? window.t('steam.unsubscribe') : '取消订阅'}</button>
                     </div>
                 </div>
@@ -2072,6 +2073,94 @@ function renderSubscriptionsPage() {
     }).join('');
 }
 
+function formatWorkshopCharacterNameList(names) {
+    const list = Array.isArray(names)
+        ? names.map(name => String(name || '').trim()).filter(Boolean)
+        : [];
+    return list.length > 0 ? list.join('、') : (window.t ? window.t('steam.unknownCharacterCard') : '未知角色卡');
+}
+
+async function showWorkshopCharacterAddAlert(message, type = 'info') {
+    if (typeof showAlertDialog === 'function') {
+        const title = type === 'info'
+            ? (window.t ? window.t('steam.characterCardAlreadyExistsTitle') : '角色卡已存在')
+            : (window.t ? window.t('common.warning') : '提示');
+        await showAlertDialog(message, {
+            type,
+            title,
+        });
+        return;
+    }
+    window.alert(message);
+}
+
+async function addWorkshopCharacterCardFromSubscription(button) {
+    const itemId = button?.dataset?.itemId || '';
+    if (!itemId) return;
+
+    const originalText = button.textContent;
+    button.disabled = true;
+    button.textContent = window.t ? window.t('steam.workshopAddingCharacterCard') : '正在加入...';
+
+    try {
+        const response = await fetch(`/api/steam/workshop/sync-character/${encodeURIComponent(itemId)}`, {
+            method: 'POST',
+        });
+        let data = {};
+        try {
+            data = await response.json();
+        } catch (_) {
+            data = {};
+        }
+
+        if (data.code === 'WORKSHOP_CHARACTER_ALREADY_EXISTS') {
+            const namesText = formatWorkshopCharacterNameList(data.existing_character_names);
+            const message = window.t
+                ? window.t('steam.characterCardAlreadyExistsMessage', { names: namesText })
+                : `角色卡已存在：${namesText}`;
+            await showWorkshopCharacterAddAlert(message, 'info');
+            return;
+        }
+
+        if (!response.ok || !data.success) {
+            const fallbackError = data.error || data.message || (window.t ? window.t('common.unknownError') : 'Unknown error');
+            const key = data.code === 'WORKSHOP_CHARACTER_NOT_FOUND'
+                ? 'steam.workshopCharacterNotFound'
+                : 'steam.workshopCharacterAddFailed';
+            const message = window.t
+                ? window.t(key, { error: fallbackError })
+                : (data.code === 'WORKSHOP_CHARACTER_NOT_FOUND'
+                    ? '此订阅内容中未找到可加入的角色卡，请确认内容已下载完成。'
+                    : `加入角色卡失败: ${fallbackError}`);
+            await showWorkshopCharacterAddAlert(message, 'warning');
+            return;
+        }
+
+        const namesText = formatWorkshopCharacterNameList(data.added_character_names);
+        const successMessage = window.t
+            ? window.t('steam.workshopCharacterAdded', { names: namesText })
+            : `已加入角色卡：${namesText}`;
+        showMessage(successMessage, 'success');
+        try {
+            await loadCharacterCards();
+        } catch (refreshError) {
+            console.warn('刷新角色卡列表失败:', refreshError);
+            const refreshMessage = window.t
+                ? window.t('steam.characterCardsRefreshFailed', { error: refreshError.message })
+                : `刷新列表失败: ${refreshError.message}`;
+            showMessage(refreshMessage, 'warning');
+        }
+    } catch (error) {
+        const message = window.t
+            ? window.t('steam.workshopCharacterAddFailed', { error: error.message })
+            : `加入角色卡失败: ${error.message}`;
+        showMessage(message, 'error');
+    } finally {
+        button.disabled = false;
+        button.textContent = originalText;
+    }
+}
+
 // 更新分页控件
 function updatePagination() {
     const pagination = document.querySelector('.pagination');

static/js/character_card_manager.js

@@ -208,6 +208,14 @@
         "uploadReady": "Ready to upload {{itemName}}",
         "pageDescription": "From this page you can browse, edit, upload, import and export character cards, and manage Live2D models and voices hosted on the Steam Workshop.",
         "openVoiceClone": "Open in Voice Clone",
+        "workshopAddCharacterCard": "Add Character Card",
+        "workshopAddingCharacterCard": "Adding...",
+        "unknownCharacterCard": "Unknown character card",
+        "characterCardAlreadyExistsTitle": "Character Card Exists",
+        "characterCardAlreadyExistsMessage": "Character card already exists: {{names}}",
+        "workshopCharacterAdded": "Character card added: {{names}}",
+        "workshopCharacterNotFound": "No character card was found in this subscription. Make sure the content has finished downloading.",
+        "workshopCharacterAddFailed": "Failed to add character card: {{error}}",
         "configurePath": "Configure Path",
         "localModPathConfig": "Local Mod Path Configuration",
         "localModFolder": "Local Mod Folder Path",
@@ -411,6 +419,7 @@
         "loadingItemDetailsById": "Loading details for item ID: {{id}}...",
         "characterCardsRefreshed": "Character cards list refreshed, {{count}} character cards in total",
         "characterCardsRefreshedEmpty": "Character cards list refreshed, no character cards available",
+        "characterCardsRefreshFailed": "Failed to refresh list: {{error}}",
         "requiredFieldsMissing": "Please fill in the following required fields: {{fields}}",
         "refreshLive2DPreview": "Refresh Live2D Preview",
         "removeTag": "Remove Tag",

static/locales/en.json

@@ -208,6 +208,14 @@
         "uploadReady": "Listo para cargar {{itemName}}",
         "pageDescription": "Gestiona tarjetas de personaje: explora, edita, importa/exporta tarjetas y administra modelos y voces (incluyendo Steam Workshop como fuente opcional)",
         "openVoiceClone": "Abrir en clon de voz",
+        "workshopAddCharacterCard": "Añadir tarjeta",
+        "workshopAddingCharacterCard": "Añadiendo...",
+        "unknownCharacterCard": "Tarjeta de personaje desconocida",
+        "characterCardAlreadyExistsTitle": "La tarjeta ya existe",
+        "characterCardAlreadyExistsMessage": "La tarjeta de personaje ya existe: {{names}}",
+        "workshopCharacterAdded": "Tarjeta de personaje añadida: {{names}}",
+        "workshopCharacterNotFound": "No se encontró una tarjeta de personaje en esta suscripción. Asegúrate de que el contenido haya terminado de descargarse.",
+        "workshopCharacterAddFailed": "No se pudo añadir la tarjeta de personaje: {{error}}",
         "configurePath": "Configurar ruta",
         "localModPathConfig": "Configuración de ruta de modificación local",
         "localModFolder": "Ruta de la carpeta de modificación local",
@@ -411,6 +419,7 @@
         "loadingItemDetailsById": "Cargando detalles para el ID del artículo: {{id}}...",
         "characterCardsRefreshed": "Lista de tarjetas de personaje actualizada, {{count}} tarjetas de personaje en total",
         "characterCardsRefreshedEmpty": "Lista de cartas de personaje actualizada, no hay cartas de personaje disponibles",
+        "characterCardsRefreshFailed": "Error al actualizar la lista: {{error}}",
         "requiredFieldsMissing": "Por favor complete los siguientes campos obligatorios: {{fields}}",
         "refreshLive2DPreview": "Actualizar vista previa de Live2D",
         "removeTag": "Quitar etiqueta",

static/locales/es.json

@@ -208,6 +208,14 @@
         "uploadReady": "{{itemName}}のアップロード準備完了",
         "pageDescription": "このページではキャラクターカードの閲覧・編集・アップロード・インポート/エクスポート、およびSteamワークショップ内のLive2Dモデルとボイスの管理が行えます",
         "openVoiceClone": "ボイスクローンで開く",
+        "workshopAddCharacterCard": "キャラクターカードを追加",
+        "workshopAddingCharacterCard": "追加中...",
+        "unknownCharacterCard": "不明なキャラクターカード",
+        "characterCardAlreadyExistsTitle": "キャラクターカードは既に存在します",
+        "characterCardAlreadyExistsMessage": "キャラクターカードは既に存在します：{{names}}",
+        "workshopCharacterAdded": "キャラクターカードを追加しました：{{names}}",
+        "workshopCharacterNotFound": "このサブスクリプション内に追加できるキャラクターカードが見つかりません。コンテンツのダウンロード完了を確認してください。",
+        "workshopCharacterAddFailed": "キャラクターカードの追加に失敗しました: {{error}}",
         "configurePath": "パス設定",
         "localModPathConfig": "ローカルMODパス設定",
         "localModFolder": "ローカルMODフォルダパス",
@@ -411,6 +419,7 @@
         "loadingItemDetailsById": "アイテムID: {{id}} の詳細を読み込み中...",
         "characterCardsRefreshed": "キャラクターカードリストを更新しました。合計 {{count}} 枚",
         "characterCardsRefreshedEmpty": "キャラクターカードリストを更新しました。利用可能なカードはありません",
+        "characterCardsRefreshFailed": "リストの更新に失敗しました: {{error}}",
         "requiredFieldsMissing": "以下の必須項目を入力してください: {{fields}}",
         "refreshLive2DPreview": "Live2Dプレビューを更新",
         "removeTag": "タグを削除",

static/locales/ja.json

@@ -208,6 +208,14 @@
         "uploadReady": "{{itemName}} 업로드 준비 중",
         "pageDescription": "이 페이지에서 캐릭터 카드를 검색·편집·업로드·가져오기/내보내기 하고 Steam 창작마당의 Live2D 모델과 음성을 관리할 수 있습니다",
         "openVoiceClone": "음성 복제에서 열기",
+        "workshopAddCharacterCard": "캐릭터 카드 추가",
+        "workshopAddingCharacterCard": "추가 중...",
+        "unknownCharacterCard": "알 수 없는 캐릭터 카드",
+        "characterCardAlreadyExistsTitle": "캐릭터 카드가 이미 존재함",
+        "characterCardAlreadyExistsMessage": "캐릭터 카드가 이미 존재합니다: {{names}}",
+        "workshopCharacterAdded": "캐릭터 카드가 추가되었습니다: {{names}}",
+        "workshopCharacterNotFound": "이 구독 항목에서 추가할 수 있는 캐릭터 카드를 찾을 수 없습니다. 콘텐츠 다운로드가 완료되었는지 확인해 주세요.",
+        "workshopCharacterAddFailed": "캐릭터 카드 추가 실패: {{error}}",
         "configurePath": "경로 구성",
         "localModPathConfig": "로컬 Mod 경로 구성",
         "localModFolder": "로컬 Mod 폴더 경로",
@@ -411,6 +419,7 @@
         "loadingItemDetailsById": "항목 ID: {{id}}에 대한 세부정보 로드 중...",
         "characterCardsRefreshed": "캐릭터 카드 목록이 새로 고쳐졌습니다. 총 {{count}} 캐릭터 카드입니다.",
         "characterCardsRefreshedEmpty": "캐릭터 카드 목록이 새로 고쳐졌고 사용 가능한 캐릭터 카드가 없습니다.",
+        "characterCardsRefreshFailed": "목록 새로 고침 실패: {{error}}",
         "requiredFieldsMissing": "다음 필수 필드를 작성하십시오: {{fields}}",
         "refreshLive2DPreview": "Live2D 미리보기 새로 고침",
         "removeTag": "태그 제거",

static/locales/ko.json

@@ -208,6 +208,14 @@
         "uploadReady": "Pronto para carregar {{itemName}}",
         "pageDescription": "Navegue, assine, baixe e gerencie modelos e vozes Live2D do Steam Workshop",
         "openVoiceClone": "Abrir no clone de voz",
+        "workshopAddCharacterCard": "Adicionar cartão",
+        "workshopAddingCharacterCard": "Adicionando...",
+        "unknownCharacterCard": "Cartão de personagem desconhecido",
+        "characterCardAlreadyExistsTitle": "Cartão já existe",
+        "characterCardAlreadyExistsMessage": "O cartão de personagem já existe: {{names}}",
+        "workshopCharacterAdded": "Cartão de personagem adicionado: {{names}}",
+        "workshopCharacterNotFound": "Nenhum cartão de personagem foi encontrado nesta inscrição. Verifique se o conteúdo terminou de baixar.",
+        "workshopCharacterAddFailed": "Falha ao adicionar cartão de personagem: {{error}}",
         "configurePath": "Configurar caminho",
         "localModPathConfig": "Configuração do caminho do mod local",
         "localModFolder": "Caminho da pasta Mod local",
@@ -411,6 +419,7 @@
         "loadingItemDetailsById": "Carregando detalhes do ID do item: {{id}}...",
         "characterCardsRefreshed": "Lista de cartas de personagem atualizada, {{count}} cartas de personagem no total",
         "characterCardsRefreshedEmpty": "Lista de cartas de personagem atualizada, nenhuma carta de personagem disponível",
+        "characterCardsRefreshFailed": "Falha ao atualizar a lista: {{error}}",
         "requiredFieldsMissing": "Preencha os seguintes campos obrigatórios: {{fields}}",
         "refreshLive2DPreview": "Atualizar visualização do Live2D",
         "removeTag": "Remover etiqueta",

static/locales/pt.json

@@ -208,6 +208,14 @@
         "uploadReady": "Готово к загрузке {{itemName}}",
         "pageDescription": "На этой странице можно просматривать, редактировать, загружать, импортировать и экспортировать карточки персонажей, а также управлять моделями Live2D и голосами в Мастерской Steam",
         "openVoiceClone": "Открыть в клонировании голоса",
+        "workshopAddCharacterCard": "Добавить карточку",
+        "workshopAddingCharacterCard": "Добавление...",
+        "unknownCharacterCard": "Неизвестная карточка персонажа",
+        "characterCardAlreadyExistsTitle": "Карточка уже существует",
+        "characterCardAlreadyExistsMessage": "Карточка персонажа уже существует: {{names}}",
+        "workshopCharacterAdded": "Карточка персонажа добавлена: {{names}}",
+        "workshopCharacterNotFound": "В этой подписке не найдена карточка персонажа. Убедитесь, что загрузка содержимого завершена.",
+        "workshopCharacterAddFailed": "Не удалось добавить карточку персонажа: {{error}}",
         "configurePath": "Настроить путь",
         "localModPathConfig": "Настройка пути к локальным модам",
         "localModFolder": "Путь к папке локальных модов",
@@ -411,6 +419,7 @@
         "loadingItemDetailsById": "Загрузка деталей предмета ID: {{id}}...",
         "characterCardsRefreshed": "Список карточек обновлён, всего {{count}} карточек",
         "characterCardsRefreshedEmpty": "Список карточек обновлён, карточки отсутствуют",
+        "characterCardsRefreshFailed": "Не удалось обновить список: {{error}}",
         "requiredFieldsMissing": "Заполните следующие обязательные поля: {{fields}}",
         "refreshLive2DPreview": "Обновить предпросмотр Live2D",
         "removeTag": "Удалить тег",