dsh-session-guard 3.2.5 → 4.0.1

package/src/client/locales.ts

@@ -1,4 +1,4 @@
-/** `session-guard` client dictionaries (zh / en / ja / ko / fr / de / it / ru / es). */
+/** `session-guard` client dictionaries (zh / en / ja / ko). */
 
 /** Dictionary namespace owned by this plugin. */
 export const NS = 'session-guard'
@@ -159,203 +159,5 @@ 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/pause-button-text.ts

@@ -1,60 +1,60 @@
-/**
- * dsh-session-guard — 暂停/继续按钮文案与状态投影（纯函数，零依赖，可单测）。
- *
- * 交互（v0.2.0 修订）：
- * - 未暂停 → 「暂停会话」（**可点**：点击 = 在下一次 step 边界手动暂停该会话）；
- * - 已暂停（step 门已拉 / 已请求但未到边界）→ 「继续会话」（点击 = 放行并本峰不再拦）。
- * 按钮不置灰：step 暂停虽然会自动发生，但按钮同时是**手动暂停**入口。
- */
-
-/** 按钮状态。 */
-export interface PauseButtonState {
-  /** 是否处于暂停态（step 门已挂起，或已请求暂停但还没到边界） */
-  paused: boolean
-  /** 挂起起始时间戳（毫秒）；未知为 null */
-  heldSince?: number | null
-  /** 暂停是否来自用户手动请求（而非高峰自动拉门） */
-  manual?: boolean
-}
-
-/** 按钮文案。 */
-export function pauseButtonLabel(state: PauseButtonState): string {
-  return state.paused === true ? '继续会话' : '暂停会话'
-}
-
-/** 悬浮说明：写清当前状态与点击后的语义。 */
-export function pauseButtonTitle(state: PauseButtonState): string {
-  if (state.paused !== true) {
-    return '暂停会话：在下一次 step 的模型请求前暂停（高峰 + 官方源时会自动暂停）'
-  }
-  const since = typeof state.heldSince === 'number' && Number.isFinite(state.heldSince) ? new Date(state.heldSince) : null
-  const at = since === null ? null : `${String(since.getHours()).padStart(2, '0')}:${String(since.getMinutes()).padStart(2, '0')}`
-  const why = state.manual === true ? '手动暂停' : '高峰自动暂停'
-  const base = at === null ? `已暂停（${why}）` : `已暂停（${why}，自 ${at}）`
-  return `${base} · 点击继续：放行当前 step，且本高峰内不再拦该会话`
-}
-
-/** 把 `/session-guard/state` 的响应体投影为按钮状态（形状异常 → 未暂停，fail-open）。 */
-export function readPauseState(body: unknown): PauseButtonState {
-  const b = (body ?? {}) as {
-    ok?: unknown
-    paused?: { step?: unknown; manual?: unknown }
-    stepGate?: { since?: unknown; manual?: unknown }
-    state?: { pausedStep?: unknown; stepHeldSince?: unknown; stepManual?: unknown }
-  }
-  if (b.ok !== true) return { paused: false, heldSince: null, manual: false }
-  const manual = b.paused?.manual === true || b.stepGate?.manual === true || b.state?.stepManual === true
-  const paused = b.paused?.step === true || b.state?.pausedStep === true || manual
-  const raw = b.stepGate?.since ?? b.state?.stepHeldSince ?? null
-  const heldSince = typeof raw === 'number' && Number.isFinite(raw) ? raw : null
-  return { paused, heldSince, manual }
-}
-
-/** 把 SSE `/session-guard/events` 的 `state` 快照投影为按钮状态。 */
-export function readStepSnapshot(snapshot: unknown): PauseButtonState {
-  const s = (snapshot ?? {}) as { held?: unknown; since?: unknown; manual?: unknown }
-  const manual = s.manual === true
-  const paused = s.held === true || manual
-  const heldSince = typeof s.since === 'number' && Number.isFinite(s.since) ? s.since : null
-  return { paused, heldSince, manual }
-}
+/**
+ * dsh-session-guard — 暂停/继续按钮文案与状态投影（纯函数，零依赖，可单测）。
+ *
+ * 交互（v0.2.0 修订）：
+ * - 未暂停 → 「暂停会话」（**可点**：点击 = 在下一次 step 边界手动暂停该会话）；
+ * - 已暂停（step 门已拉 / 已请求但未到边界）→ 「继续会话」（点击 = 放行并本峰不再拦）。
+ * 按钮不置灰：step 暂停虽然会自动发生，但按钮同时是**手动暂停**入口。
+ */
+
+/** 按钮状态。 */
+export interface PauseButtonState {
+  /** 是否处于暂停态（step 门已挂起，或已请求暂停但还没到边界） */
+  paused: boolean
+  /** 挂起起始时间戳（毫秒）；未知为 null */
+  heldSince?: number | null
+  /** 暂停是否来自用户手动请求（而非高峰自动拉门） */
+  manual?: boolean
+}
+
+/** 按钮文案。 */
+export function pauseButtonLabel(state: PauseButtonState): string {
+  return state.paused === true ? '继续会话' : '暂停会话'
+}
+
+/** 悬浮说明：写清当前状态与点击后的语义。 */
+export function pauseButtonTitle(state: PauseButtonState): string {
+  if (state.paused !== true) {
+    return '暂停会话：在下一次 step 的模型请求前暂停（高峰 + 官方源时会自动暂停）'
+  }
+  const since = typeof state.heldSince === 'number' && Number.isFinite(state.heldSince) ? new Date(state.heldSince) : null
+  const at = since === null ? null : `${String(since.getHours()).padStart(2, '0')}:${String(since.getMinutes()).padStart(2, '0')}`
+  const why = state.manual === true ? '手动暂停' : '高峰自动暂停'
+  const base = at === null ? `已暂停（${why}）` : `已暂停（${why}，自 ${at}）`
+  return `${base} · 点击继续：放行当前 step，且本高峰内不再拦该会话`
+}
+
+/** 把 `/session-guard/state` 的响应体投影为按钮状态（形状异常 → 未暂停，fail-open）。 */
+export function readPauseState(body: unknown): PauseButtonState {
+  const b = (body ?? {}) as {
+    ok?: unknown
+    paused?: { step?: unknown; manual?: unknown }
+    stepGate?: { since?: unknown; manual?: unknown }
+    state?: { pausedStep?: unknown; stepHeldSince?: unknown; stepManual?: unknown }
+  }
+  if (b.ok !== true) return { paused: false, heldSince: null, manual: false }
+  const manual = b.paused?.manual === true || b.stepGate?.manual === true || b.state?.stepManual === true
+  const paused = b.paused?.step === true || b.state?.pausedStep === true || manual
+  const raw = b.stepGate?.since ?? b.state?.stepHeldSince ?? null
+  const heldSince = typeof raw === 'number' && Number.isFinite(raw) ? raw : null
+  return { paused, heldSince, manual }
+}
+
+/** 把 SSE `/session-guard/events` 的 `state` 快照投影为按钮状态。 */
+export function readStepSnapshot(snapshot: unknown): PauseButtonState {
+  const s = (snapshot ?? {}) as { held?: unknown; since?: unknown; manual?: unknown }
+  const manual = s.manual === true
+  const paused = s.held === true || manual
+  const heldSince = typeof s.since === 'number' && Number.isFinite(s.since) ? s.since : null
+  return { paused, heldSince, manual }
+}

package/src/client/pause-button.tsx

@@ -1,129 +1,129 @@
-/**
- * dsh-session-guard — 「暂停会话 / 继续会话」按钮（`conversation.input.right`，order 20）。
- *
- * 交互（v0.2.0 修订）：
- * - 未暂停 → 「暂停会话」，**可点**：点击 POST `{action:'stepPause'}`，在**下一次 step 边界**暂停
- *   （不打断当前 step；step 1 也拦，不受峰谷 / provider 限制）；
- * - 已暂停（高峰自动拉门 **或** 手动请求已登记）→ 「继续会话」，点击 POST `{action:'stepResume'}`；
- * - 状态更新双通道：① SSE `/session-guard/events?session=<id>` 即时推送；② 10s 轮询兜底
- *   （SSE 不可用 / 断线时仍能收敛）。全部 fail-open，绝不抛错。
- *
- * 与 input-traffic 的「❄ 冻结追加 / 恢复追加」并列（order 30 在其右侧），互不取代：
- * 本按钮控 step 门，冻结按钮控回合级冻结 + 队列摘除。
- */
-import { useEffect, useState } from 'react'
-import {
-  pauseButtonLabel,
-  pauseButtonTitle,
-  readPauseState,
-  readStepSnapshot,
-  type PauseButtonState,
-} from './pause-button-text'
-import { injectClientCss } from './styles'
-
-/** slot 运行时注入的会话级 props。 */
-export interface PauseButtonProps {
-  sessionId?: string
-}
-
-/** SSE 不可用时的兜底轮询间隔（正常路径由事件驱动，几乎不触发）。 */
-const POLL_MS = 10_000
-
-const IDLE: PauseButtonState = { paused: false, heldSince: null, manual: false }
-
-/** 暂停 / 继续会话按钮。 */
-export function PauseButton({ sessionId }: PauseButtonProps) {
-  const [state, setState] = useState<PauseButtonState>(IDLE)
-  const [busy, setBusy] = useState(false)
-
-  injectClientCss()
-
-  useEffect(() => {
-    if (sessionId === undefined || sessionId === '') return
-    let cancelled = false
-
-    const poll = async (): Promise<void> => {
-      try {
-        const res = await fetch(`/session-guard/state?session=${encodeURIComponent(sessionId)}`)
-        const body = await res.json().catch(() => null)
-        if (cancelled) return
-        setState(readPauseState(body))
-      } catch {
-        // fail-open：路由不存在 / 网络失败 → 保持上一次状态。
-      }
-    }
-    void poll()
-    const timer = setInterval(() => {
-      void poll()
-    }, POLL_MS)
-
-    let source: EventSource | undefined
-    try {
-      source = new EventSource(`/session-guard/events?session=${encodeURIComponent(sessionId)}`)
-      source.onmessage = (ev: MessageEvent<string>) => {
-        try {
-          const msg = JSON.parse(ev.data) as { type?: string; state?: unknown }
-          if (cancelled || msg?.type !== 'step') return
-          setState(readStepSnapshot(msg.state))
-        } catch {
-          /* 非法负载：忽略，等下一次推送或轮询 */
-        }
-      }
-      // onerror：EventSource 会自行重连；轮询同时兜底。
-      source.onerror = () => undefined
-    } catch {
-      // 浏览器不支持 EventSource → 只靠轮询。
-    }
-
-    return () => {
-      cancelled = true
-      clearInterval(timer)
-      try {
-        source?.close()
-      } catch {
-        /* ignore */
-      }
-    }
-  }, [sessionId])
-
-  if (sessionId === undefined || sessionId === '') return null
-
-  const paused = state.paused === true
-  const onClick = async (): Promise<void> => {
-    if (busy) return
-    setBusy(true)
-    try {
-      const action = paused ? 'stepResume' : 'stepPause'
-      const res = await fetch('/session-guard/rpc', {
-        method: 'POST',
-        headers: { 'content-type': 'application/json' },
-        body: JSON.stringify({ sessionId, action }),
-      })
-      const body = await res.json().catch(() => null)
-      if (body?.ok === true) {
-        // 立即乐观更新；SSE / 轮询随后校正。
-        setState(paused ? IDLE : { paused: true, heldSince: null, manual: true })
-      }
-    } catch {
-      // fail-open：下一轮轮询会纠正显示。
-    } finally {
-      setBusy(false)
-    }
-  }
-
-  return (
-    <button
-      type="button"
-      className="sg-pause"
-      disabled={busy}
-      aria-pressed={paused || undefined}
-      title={pauseButtonTitle(state)}
-      data-sg-step-paused={paused ? 'on' : 'off'}
-      onClick={() => {
-        void onClick()
-      }}
-    >
-      {pauseButtonLabel(state)}
-    </button>
-  )
-}
+/**
+ * dsh-session-guard — 「暂停会话 / 继续会话」按钮（`conversation.input.right`，order 20）。
+ *
+ * 交互（v0.2.0 修订）：
+ * - 未暂停 → 「暂停会话」，**可点**：点击 POST `{action:'stepPause'}`，在**下一次 step 边界**暂停
+ *   （不打断当前 step；step 1 也拦，不受峰谷 / provider 限制）；
+ * - 已暂停（高峰自动拉门 **或** 手动请求已登记）→ 「继续会话」，点击 POST `{action:'stepResume'}`；
+ * - 状态更新双通道：① SSE `/session-guard/events?session=<id>` 即时推送；② 10s 轮询兜底
+ *   （SSE 不可用 / 断线时仍能收敛）。全部 fail-open，绝不抛错。
+ *
+ * 与 input-traffic 的「❄ 冻结追加 / 恢复追加」并列（order 30 在其右侧），互不取代：
+ * 本按钮控 step 门，冻结按钮控回合级冻结 + 队列摘除。
+ */
+import { useEffect, useState } from 'react'
+import {
+  pauseButtonLabel,
+  pauseButtonTitle,
+  readPauseState,
+  readStepSnapshot,
+  type PauseButtonState,
+} from './pause-button-text'
+import { injectClientCss } from './styles'
+
+/** slot 运行时注入的会话级 props。 */
+export interface PauseButtonProps {
+  sessionId?: string
+}
+
+/** SSE 不可用时的兜底轮询间隔（正常路径由事件驱动，几乎不触发）。 */
+const POLL_MS = 10_000
+
+const IDLE: PauseButtonState = { paused: false, heldSince: null, manual: false }
+
+/** 暂停 / 继续会话按钮。 */
+export function PauseButton({ sessionId }: PauseButtonProps) {
+  const [state, setState] = useState<PauseButtonState>(IDLE)
+  const [busy, setBusy] = useState(false)
+
+  injectClientCss()
+
+  useEffect(() => {
+    if (sessionId === undefined || sessionId === '') return
+    let cancelled = false
+
+    const poll = async (): Promise<void> => {
+      try {
+        const res = await fetch(`/session-guard/state?session=${encodeURIComponent(sessionId)}`)
+        const body = await res.json().catch(() => null)
+        if (cancelled) return
+        setState(readPauseState(body))
+      } catch {
+        // fail-open：路由不存在 / 网络失败 → 保持上一次状态。
+      }
+    }
+    void poll()
+    const timer = setInterval(() => {
+      void poll()
+    }, POLL_MS)
+
+    let source: EventSource | undefined
+    try {
+      source = new EventSource(`/session-guard/events?session=${encodeURIComponent(sessionId)}`)
+      source.onmessage = (ev: MessageEvent<string>) => {
+        try {
+          const msg = JSON.parse(ev.data) as { type?: string; state?: unknown }
+          if (cancelled || msg?.type !== 'step') return
+          setState(readStepSnapshot(msg.state))
+        } catch {
+          /* 非法负载：忽略，等下一次推送或轮询 */
+        }
+      }
+      // onerror：EventSource 会自行重连；轮询同时兜底。
+      source.onerror = () => undefined
+    } catch {
+      // 浏览器不支持 EventSource → 只靠轮询。
+    }
+
+    return () => {
+      cancelled = true
+      clearInterval(timer)
+      try {
+        source?.close()
+      } catch {
+        /* ignore */
+      }
+    }
+  }, [sessionId])
+
+  if (sessionId === undefined || sessionId === '') return null
+
+  const paused = state.paused === true
+  const onClick = async (): Promise<void> => {
+    if (busy) return
+    setBusy(true)
+    try {
+      const action = paused ? 'stepResume' : 'stepPause'
+      const res = await fetch('/session-guard/rpc', {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ sessionId, action }),
+      })
+      const body = await res.json().catch(() => null)
+      if (body?.ok === true) {
+        // 立即乐观更新；SSE / 轮询随后校正。
+        setState(paused ? IDLE : { paused: true, heldSince: null, manual: true })
+      }
+    } catch {
+      // fail-open：下一轮轮询会纠正显示。
+    } finally {
+      setBusy(false)
+    }
+  }
+
+  return (
+    <button
+      type="button"
+      className="sg-pause"
+      disabled={busy}
+      aria-pressed={paused || undefined}
+      title={pauseButtonTitle(state)}
+      data-sg-step-paused={paused ? 'on' : 'off'}
+      onClick={() => {
+        void onClick()
+      }}
+    >
+      {pauseButtonLabel(state)}
+    </button>
+  )
+}

package/src/client/scope-face.ts

@@ -1,20 +1,20 @@
-/**
- * 0.1.7-rc.2 停止从 `@deepseek-ai/dsh-client-ui-settings/client` 导出
- * `SettingsScope`；卡片消费的结构化面移到此处，字段逐一镜像
- * `configForms.get(entryId)` 返回的 ConfigForm。
- */
-export interface SettingsScope<T> {
-  getSnapshot(): {
-    status: 'loading' | 'ready' | 'unavailable'
-    value: T | undefined
-    revision: number | undefined
-    writable: boolean
-    base: unknown
-    user: unknown
-    mode: 'host' | 'memory'
-  }
-  subscribe(listener: () => void): () => void
-  set(field: string, value: unknown): Promise<boolean>
-  unset(field: string): Promise<boolean>
-  mutate?(ops: readonly { path: readonly string[]; op: string; value?: unknown }[]): Promise<boolean>
-}
+/**
+ * 0.1.7-rc.2 停止从 `@deepseek-ai/dsh-client-ui-settings/client` 导出
+ * `SettingsScope`；卡片消费的结构化面移到此处，字段逐一镜像
+ * `configForms.get(entryId)` 返回的 ConfigForm。
+ */
+export interface SettingsScope<T> {
+  getSnapshot(): {
+    status: 'loading' | 'ready' | 'unavailable'
+    value: T | undefined
+    revision: number | undefined
+    writable: boolean
+    base: unknown
+    user: unknown
+    mode: 'host' | 'memory'
+  }
+  subscribe(listener: () => void): () => void
+  set(field: string, value: unknown): Promise<boolean>
+  unset(field: string): Promise<boolean>
+  mutate?(ops: readonly { path: readonly string[]; op: string; value?: unknown }[]): Promise<boolean>
+}