dsh-session-guard 3.2.3 → 3.2.5

package/src/client/index.ts

@@ -11,6 +11,7 @@
  *
  * 构建：tsdown → lib/client.js（__ModuleLoader__.load 注册，与 input-traffic 同构）。
  */
+import { NS, dictionaries } from './locales'
 import { StatusBadge } from './status-badge'
 import { PauseButton } from './pause-button'
 import { SessionGuardCard } from './settings-card'
@@ -20,9 +21,19 @@ import { GuardFamilySection, type FamilyTabEntry } from './family-section'
 // （id `dsh-family`）并声明 `dsh-family.tab` 子席位，本插件贡献卡片。宿主缺席
 // 时本插件按下载量排名接管该节（见 apply 内的选举逻辑），节名仍为
 // 「起子插件设置」；宿主在场时本插件只贡献卡片。
+// 类型导入（构建时擦除，bundle 无 value-import 平台包）：让下方 `declare
+// module` 增补能解析到 @deepseek-ai/dsh-client-ui-slots 的 SlotMap。
+import type {} from '@deepseek-ai/dsh-client-ui-slots'
 declare module '@deepseek-ai/dsh-client-ui-slots' {
   interface SlotMap {
     'dsh-family.tab': { kind: 'list'; scope: 'root' }
+    /**
+     * 插件页配置卡（官方 ui-plugin-manager 契约，key = 包名）：Plugins 页
+     * 不自动渲染 volatile 配置表单，bundle 详情页只渲染注册在本 keyed 席位
+     * 下的卡片；owner props 由页面给（`{ view: 'page', form }`），本卡片改经
+     * inject 工厂拿自己的 scope（与 dsh-family.tab 注册同源）。
+     */
+    'plugins.bundle.config': { kind: 'keyed'; scope: 'root'; owner: Record<string, unknown> }
   }
 }
 
@@ -51,12 +62,23 @@ interface SlotsFace {
 interface ConfigFormsFace {
   get: <T>(_entryId: string) => import('./scope-face').SettingsScope<T>
 }
+interface LocaleFace {
+  register(ns: string, dicts: Record<string, Record<string, string>>): () => void
+}
 interface ClientCtx {
   slots: SlotsFace
   configForms: ConfigFormsFace
+  locale?: LocaleFace
+  effect: (fn: () => (() => void) | void, label: string) => void
 }
 
 export function apply(ctx: ClientCtx) {
+  // 注册全部 9 种语言字典（guarded：throw 不会逃逸）。
+  if (ctx.locale) {
+    const locale = ctx.locale
+    ctx.effect(() => locale.register(NS, dictionaries), 'dsh-session-guard: dictionaries')
+  }
+
   // 暂停会话按钮（v0.2.0）：step 级门控的状态显示 + 手动解除。
   // order 20 < input-traffic 冻结按钮的 30 → 排在左侧，两者并列互不取代（ADR-001/002）。
   ctx.slots.inject('conversation.input.right', () => ctx.slots.register({
@@ -84,6 +106,17 @@ export function apply(ctx: ClientCtx) {
     inject: () => ({ scope: ctx.configForms.get<Record<string, unknown>>('session-guard') }),
   }, SessionGuardCard))
 
+  // 插件页配置卡：Plugins 页不自动渲染 volatile 配置表单，须注册
+  // `plugins.bundle.config` 席位（key = 包名），配置卡才渲染在 bundle 详情页。
+  // 卡片组件与 props（scope）与上方 dsh-family.tab 注册完全同源：同一张
+  // SessionGuardCard、同一 inject 工厂，配置仍写入 entry `session-guard` 的
+  // volatile config；页面注入的 owner props（form 等）本卡不消费。
+  ctx.slots.inject('plugins.bundle.config', () => ctx.slots.register({
+    name: 'plugins.bundle.config',
+    key: 'dsh-session-guard',
+    inject: () => ({ scope: ctx.configForms.get<Record<string, unknown>>('session-guard') }),
+  }, SessionGuardCard))
+
   // 家族节宿主选举：宿主 dsh-thinking-levels 缺席时顶上「起子插件设置」节。
   // 宽限期后若 `settings.section` 里没有 id `dsh-family` 的条目，则按同一 id
   // 接管（声明同一个 dsh-family.tab 子席位，节内通用渲染全部贡献卡）。与

package/src/client/locales.ts

@@ -1,4 +1,4 @@
-/** `session-guard` client dictionaries (zh / en / ja / ko). */
+/** `session-guard` client dictionaries (zh / en / ja / ko / fr / de / it / ru / es). */
 
 /** Dictionary namespace owned by this plugin. */
 export const NS = 'session-guard'
@@ -159,5 +159,203 @@ export const ko: Record<keyof typeof zh, string> = {
   'status.peak_all': '피크·전체 정지',
 }
 
+/** French dictionary (keys mirror zh). */
+export const fr: Record<keyof typeof zh, string> = {
+  'badge.normal': 'Normal',
+  'badge.paused': 'En pause (pic)',
+  'badge_paused_peak': 'Pause pic en cours',
+  'settings.enabled': 'Pause auto en période de pic',
+  'settings.enabled.desc': 'Mettre automatiquement en pause les sessions actives pendant les heures de pic',
+  'settings.offPeakAutoResume': 'Reprise auto hors pic',
+  'settings.offPeakAutoResume.desc': 'Reprendre automatiquement les sessions en pause pendant les heures creuses',
+  'settings.weekendMode': 'Mode week-end',
+  'settings.weekendMode.desc': 'Détecter les week-ends → pas de pause auto le week-end',
+  'settings.queueFallback': 'File d\u2019attente de secours',
+  'settings.queueFallback.desc': 'Repli sur la file d\u2019attente verrouillée quand la passerelle personnalisée est indisponible (fail-open)',
+  'settings.retryEnabled': 'Nouvelle tentative auto',
+  'settings.retryEnabled.desc': 'Reprise auto après échec transitoire (désactivé par défaut, conservateur)',
+  'settings.timezone': 'Fuseau horaire',
+  'settings.peakWindows': 'Plages horaires de pic',
+  'settings.providerGuard': 'Garde source officielle',
+  'settings.providerGuard.desc': 'En période de pic, seules les sources officielles DeepSeek sont bloquées ; les fournisseurs locaux/tiers continuent',
+  'settings.officialProviders': 'IDs de fournisseur officiels supplémentaires',
+  'settings.officialProviders.desc': 'Correspondance exacte, priorité maximale (séparés par des virgules)',
+  'settings.officialBaseURLs': 'Hôtes des points de terminaison officiels',
+  'settings.officialBaseURLs.desc': 'Hôtes après normalisation de la baseURL (séparés par des virgules)',
+  'settings.deferredMode': 'Mode d\u2019interception',
+  'settings.deferredMode.desc': 'Suspendre sans erreur, ou générer une erreur et mettre en file différée',
+  'settings.deferredResume': 'Reprise auto après le pic',
+  'settings.deferredResume.desc': 'Si désactivé, les requêtes/sessions différées restent en attente jusqu\u2019à un /resume manuel',
+  'settings.deferredResumeText': 'Message de reprise',
+  'settings.deferredResumeText.desc': 'Texte envoyé lorsqu\u2019une session en mode erreur reprend hors pic',
+  'settings.guardSubagents': 'Inclure les sous-agents',
+  'settings.guardSubagents.desc': 'Les requêtes des sous-agents sont aussi facturées ; gardées par défaut',
+  'settings.officialHint': 'Ordre de décision : liste d\u2019ids explicites → point de terminaison baseURL → point de terminaison par défaut du catalogue → id intégré. Pour un verdict erroné, ouvrez /session-guard/provider?provider=<id> et consultez matchedBy.',
+  'settings.unavailable': 'Paramètres indisponibles : assurez-vous que dsh-session-guard est assemblé dans ce profil.',
+  'status.normal': 'Fonctionnement normal',
+  'status.paused_peak': 'Pause pic en cours',
+  'status.peak_official': 'Pic · officiel uniquement',
+  'status.peak_all': 'Pic · tout en pause',
+}
+
+/** German dictionary (keys mirror zh). */
+export const de: Record<keyof typeof zh, string> = {
+  'badge.normal': 'Normal',
+  'badge.paused': 'Pausiert (Spitzenzeit)',
+  'badge_paused_peak': 'Spitzenzeit-Pause aktiv',
+  'settings.enabled': 'Auto-Pause zur Spitzenzeit',
+  'settings.enabled.desc': 'Laufende Sitzungen während der Spitzenzeiten automatisch pausieren',
+  'settings.offPeakAutoResume': 'Auto-Fortsetzung außerhalb der Spitzenzeit',
+  'settings.offPeakAutoResume.desc': 'Pausierte Sitzungen außerhalb der Spitzenzeiten automatisch fortsetzen',
+  'settings.weekendMode': 'Wochenendmodus',
+  'settings.weekendMode.desc': 'Wochenenden erkennen → keine Auto-Pause am Wochenende',
+  'settings.queueFallback': 'Fallback-Warteschlange',
+  'settings.queueFallback.desc': 'Auf Sperr-Warteschlange zurückgreifen, wenn eigenes Sitzungs-Gate nicht verfügbar ist (fail-open)',
+  'settings.retryEnabled': 'Automatischer Wiederholungsversuch',
+  'settings.retryEnabled.desc': 'Automatische Fortsetzung nach kurzzeitigem Fehler (standardmäßig aus, konservativ)',
+  'settings.timezone': 'Zeitzone',
+  'settings.peakWindows': 'Spitzenzeitfenster',
+  'settings.providerGuard': 'Offizielle-Quellen-Prüfung',
+  'settings.providerGuard.desc': 'Zur Spitzenzeit nur DeepSeek-offizielle Quellen blockieren; lokale/Dritt-Anbieter laufen weiter',
+  'settings.officialProviders': 'Zusätzliche offizielle Provider-IDs',
+  'settings.officialProviders.desc': 'Exakte Übereinstimmung, höchste Priorität (kommagetrennt)',
+  'settings.officialBaseURLs': 'Offizielle Endpunkt-Hosts',
+  'settings.officialBaseURLs.desc': 'Hosts nach baseURL-Normalisierung (kommagetrennt)',
+  'settings.deferredMode': 'Abfangmodus',
+  'settings.deferredMode.desc': 'Ohne Fehler anhalten oder Fehler erzeugen und in Warteschlange stellen',
+  'settings.deferredResume': 'Auto-Fortsetzung nach Spitzenzeit',
+  'settings.deferredResume.desc': 'Wenn aus, bleiben zurückgestellte Anfragen/Sitzungen bis zum manuellen /resume geparkt',
+  'settings.deferredResumeText': 'Fortsetzungsnachricht',
+  'settings.deferredResumeText.desc': 'Text, der gesendet wird, wenn eine Sitzung im Fehlermodus nach der Spitzenzeit fortgesetzt wird',
+  'settings.guardSubagents': 'Unteragenten einbeziehen',
+  'settings.guardSubagents.desc': 'Anfragen von Unteragenten werden ebenfalls abgerechnet; standardmäßig überwacht',
+  'settings.officialHint': 'Entscheidungsreihenfolge: explizite ID-Liste → baseURL-Endpunkt → Katalog-Standardendpunkt → eingebaute ID. Bei Fehlentscheidung /session-guard/provider?provider=<id> öffnen und matchedBy prüfen.',
+  'settings.unavailable': 'Einstellungen nicht verfügbar: Stellen Sie sicher, dass dsh-session-guard in diesem Profil eingebunden ist.',
+  'status.normal': 'Normaler Betrieb',
+  'status.paused_peak': 'Spitzenzeit-Pause aktiv',
+  'status.peak_official': 'Spitzenzeit · nur offizielle',
+  'status.peak_all': 'Spitzenzeit · alle pausiert',
+}
+
+/** Italian dictionary (keys mirror zh). */
+export const it: Record<keyof typeof zh, string> = {
+  'badge.normal': 'Normale',
+  'badge.paused': 'In pausa (picco)',
+  'badge_paused_peak': 'Pausa di picco attiva',
+  'settings.enabled': 'Pausa automatica durante il picco',
+  'settings.enabled.desc': 'Metti automaticamente in pausa le sessioni attive durante le ore di picco',
+  'settings.offPeakAutoResume': 'Ripresa automatica fuori picco',
+  'settings.offPeakAutoResume.desc': 'Riprendi automaticamente le sessioni in pausa durante le ore fuori picco',
+  'settings.weekendMode': 'Modalità fine settimana',
+  'settings.weekendMode.desc': 'Rileva i fine settimana → nessuna pausa automatica nel weekend',
+  'settings.queueFallback': 'Coda di riserva con blocco',
+  'settings.queueFallback.desc': 'Ripiega sulla coda di attesa bloccata quando il gate di sessione personalizzato non è disponibile (fail-open)',
+  'settings.retryEnabled': 'Nuovo tentativo automatico',
+  'settings.retryEnabled.desc': 'Ripresa automatica dopo errore transitorio (disattivato per impostazione predefinita, conservativo)',
+  'settings.timezone': 'Fuso orario',
+  'settings.peakWindows': 'Finestre temporali di picco',
+  'settings.providerGuard': 'Guardia sorgente ufficiale',
+  'settings.providerGuard.desc': 'Durante il picco blocca solo le sorgenti ufficiali DeepSeek; i provider locali/terzi continuano a funzionare',
+  'settings.officialProviders': 'ID provider ufficiali aggiuntivi',
+  'settings.officialProviders.desc': 'Corrispondenza esatta, priorità massima (separati da virgola)',
+  'settings.officialBaseURLs': 'Host degli endpoint ufficiali',
+  'settings.officialBaseURLs.desc': 'Host dopo la normalizzazione della baseURL (separati da virgola)',
+  'settings.deferredMode': 'Modalità di intercettazione',
+  'settings.deferredMode.desc': 'Sospendi senza errore, oppure genera errore e accoda come differito',
+  'settings.deferredResume': 'Ripresa automatica dopo il picco',
+  'settings.deferredResume.desc': 'Se disattivato, le richieste/sessioni differite restano in attesa fino a un /resume manuale',
+  'settings.deferredResumeText': 'Messaggio di ripresa',
+  'settings.deferredResumeText.desc': 'Testo inviato quando una sessione in modalità errore riprende fuori picco',
+  'settings.guardSubagents': 'Includi sottoagenti',
+  'settings.guardSubagents.desc': 'Anche le richieste dei sottoagenti sono fatturate; protette per impostazione predefinita',
+  'settings.officialHint': 'Ordine di decisione: elenco id espliciti → endpoint baseURL → endpoint predefinito del catalogo → id integrato. Per un verdetto errato apri /session-guard/provider?provider=<id> e controlla matchedBy.',
+  'settings.unavailable': 'Impostazioni non disponibili: assicurati che dsh-session-guard sia integrato in questo profilo.',
+  'status.normal': 'Funzionamento normale',
+  'status.paused_peak': 'Pausa di picco attiva',
+  'status.peak_official': 'Picco · solo ufficiale',
+  'status.peak_all': 'Picco · tutto in pausa',
+}
+
+/** Russian dictionary (keys mirror zh). */
+export const ru: Record<keyof typeof zh, string> = {
+  'badge.normal': 'Норма',
+  'badge.paused': 'Приостановлено (пик)',
+  'badge_paused_peak': 'Пиковая пауза активна',
+  'settings.enabled': 'Автопауза в час пик',
+  'settings.enabled.desc': 'Автоматически приостанавливать активные сессии в часы пиковой нагрузки',
+  'settings.offPeakAutoResume': 'Автопродолжение вне пика',
+  'settings.offPeakAutoResume.desc': 'Автоматически возобновлять приостановленные сессии в непиковые часы',
+  'settings.weekendMode': 'Режим выходных',
+  'settings.weekendMode.desc': 'Определять выходные → не приостанавливать автоматически в выходные',
+  'settings.queueFallback': 'Резервная очередь блокировки',
+  'settings.queueFallback.desc': 'Откат к очереди блокировки, когда собственный гейт сессий недоступен (fail-open)',
+  'settings.retryEnabled': 'Автоповтор',
+  'settings.retryEnabled.desc': 'Автоматическое продолжение после временного сбоя (по умолчанию выключено, консервативно)',
+  'settings.timezone': 'Часовой пояс',
+  'settings.peakWindows': 'Пиковые временные окна',
+  'settings.providerGuard': 'Проверка официального источника',
+  'settings.providerGuard.desc': 'В час пик блокируются только официальные источники DeepSeek; локальные/сторонние провайдеры работают',
+  'settings.officialProviders': 'Дополнительные ID официальных провайдеров',
+  'settings.officialProviders.desc': 'Точное совпадение, наивысший приоритет (через запятую)',
+  'settings.officialBaseURLs': 'Хосты официальных эндпоинтов',
+  'settings.officialBaseURLs.desc': 'Хосты после нормализации baseURL (через запятую)',
+  'settings.deferredMode': 'Режим перехвата',
+  'settings.deferredMode.desc': 'Приостановить без ошибки, или выдать ошибку и поставить в отложенную очередь',
+  'settings.deferredResume': 'Автопродолжение после пика',
+  'settings.deferredResume.desc': 'Если выключено, отложенные запросы/сессии ожидают ручного /resume',
+  'settings.deferredResumeText': 'Сообщение возобновления',
+  'settings.deferredResumeText.desc': 'Текст, отправляемый при возобновлении сессии в режиме ошибки после пика',
+  'settings.guardSubagents': 'Включить субагентов',
+  'settings.guardSubagents.desc': 'Запросы субагентов также тарифицируются; по умолчанию защищаются',
+  'settings.officialHint': 'Порядок принятия решения: явный список id → эндпоинт baseURL → эндпоинт по умолчанию из каталога → встроенный id. При ошибочном вердикте откройте /session-guard/provider?provider=<id> и проверьте matchedBy.',
+  'settings.unavailable': 'Настройки недоступны: убедитесь, что dsh-session-guard подключён к этому профилю.',
+  'status.normal': 'Штатная работа',
+  'status.paused_peak': 'Пиковая пауза активна',
+  'status.peak_official': 'Пик · только официальные',
+  'status.peak_all': 'Пик · все приостановлены',
+}
+
+/** Spanish dictionary (keys mirror zh). */
+export const es: Record<keyof typeof zh, string> = {
+  'badge.normal': 'Normal',
+  'badge.paused': 'Pausado (pico)',
+  'badge_paused_peak': 'Pausa por pico activa',
+  'settings.enabled': 'Pausa automática en hora pico',
+  'settings.enabled.desc': 'Pausar automáticamente las sesiones activas durante las horas pico',
+  'settings.offPeakAutoResume': 'Reanudación automática fuera de pico',
+  'settings.offPeakAutoResume.desc': 'Reanudar automáticamente las sesiones pausadas durante las horas valle',
+  'settings.weekendMode': 'Modo fin de semana',
+  'settings.weekendMode.desc': 'Detectar fines de semana → sin pausa automática el fin de semana',
+  'settings.queueFallback': 'Cola de bloqueo de reserva',
+  'settings.queueFallback.desc': 'Alternativa a la cola de bloqueo cuando la puerta de sesión personalizada no está disponible (fail-open)',
+  'settings.retryEnabled': 'Reintento automático',
+  'settings.retryEnabled.desc': 'Reanudación automática tras fallo transitorio (desactivado por defecto, conservador)',
+  'settings.timezone': 'Zona horaria',
+  'settings.peakWindows': 'Ventanas horarias de pico',
+  'settings.providerGuard': 'Protección de fuente oficial',
+  'settings.providerGuard.desc': 'En hora pico solo se bloquean las fuentes oficiales de DeepSeek; los proveedores locales/terceros siguen funcionando',
+  'settings.officialProviders': 'IDs de proveedor oficiales adicionales',
+  'settings.officialProviders.desc': 'Coincidencia exacta, prioridad máxima (separados por comas)',
+  'settings.officialBaseURLs': 'Hosts de endpoints oficiales',
+  'settings.officialBaseURLs.desc': 'Hosts tras normalización de la baseURL (separados por comas)',
+  'settings.deferredMode': 'Modo de intercepción',
+  'settings.deferredMode.desc': 'Suspender sin error, o generar error y encolar como diferido',
+  'settings.deferredResume': 'Reanudación automática tras el pico',
+  'settings.deferredResume.desc': 'Si se desactiva, las solicitudes/sesiones diferidas quedan en espera hasta un /resume manual',
+  'settings.deferredResumeText': 'Mensaje de reanudación',
+  'settings.deferredResumeText.desc': 'Texto enviado cuando una sesión en modo error se reanuda fuera de pico',
+  'settings.guardSubagents': 'Incluir subagentes',
+  'settings.guardSubagents.desc': 'Las solicitudes de subagentes también se facturan; protegidas por defecto',
+  'settings.officialHint': 'Orden de decisión: lista explícita de ids → endpoint de baseURL → endpoint predeterminado del catálogo → id integrado. Para un veredicto erróneo abra /session-guard/provider?provider=<id> y consulte matchedBy.',
+  'settings.unavailable': 'Configuración no disponible: asegúrese de que dsh-session-guard esté integrado en este perfil.',
+  'status.normal': 'Funcionamiento normal',
+  'status.paused_peak': 'Pausa por pico activa',
+  'status.peak_official': 'Pico · solo oficial',
+  'status.peak_all': 'Pico · todo pausado',
+}
+
 /** Dictionary key union. */
 export type SessionGuardKey = keyof typeof zh
+
+/** Combined dictionary map — all 9 languages, for one-call registration. */
+export const dictionaries: Record<string, Record<string, string>> = { zh, en, ja, ko, fr, de, it, ru, es }

package/src/client/shims.d.ts

@@ -0,0 +1,21 @@
+/** Minimal type stubs for optional peer deps not installed locally. */
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+  export interface SlotMap {}
+}
+declare module '@deepseek-ai/dsh-client-locale' {
+  export interface LocaleService {
+    register(ns: string, dicts: Record<string, Record<string, string>>): () => void
+  }
+}
+declare module '@deepseek-ai/dsh-client-ui-settings' {
+  export {}
+}
+declare module '@deepseek-ai/dsh-client-ui-renderer' {
+  export {}
+}
+declare module '@deepseek-ai/dsh-client-ui-conversation' {
+  export {}
+}
+declare module '@deepseek-ai/dsh-client-runtime' {
+  export {}
+}