dsh-session-guard 0.1.2 → 0.2.0-beta.1

package/package.json

@@ -1,79 +1,102 @@
 {
-    "peerDependencies":  {
-                             "@deepseek-ai/dsh-llm":  "0.1.1-rc.2"
-                         },
-    "version":  "0.1.2",
-    "license":  "MIT",
-    "files":  [
-                  "src/",
-                  "lib/",
-                  "cordis.patch.yml",
-                  "README.md",
-                  "README.en.md",
-                  "README.ja.md",
-                  "README.ko.md",
-                  "INSTALL.md",
-                  "INSTALL.zh.md",
-                  "INSTALL.ja.md",
-                  "INSTALL.ko.md",
-                  "CHANGELOG.md",
-                  "CHANGELOG.ja.md",
-                  "CHANGELOG.ko.md",
-                  "LICENSE"
-              ],
-    "dependencies":  {
-                         "@deepseek-ai/schemastery":  "^3.18.1"
-                     },
-    "name":  "dsh-session-guard",
-    "type":  "module",
-    "exports":  {
-                    "./client":  "./lib/client.js",
-                    "./package.json":  "./package.json",
-                    ".":  "./src/index.js"
-                },
-    "description":  "Peak auto session gate: weekend mode + peak auto-pause + session-level freeze + backend auto-retry",
-    "engines":  {
-                    "node":  "\u003e=20"
-                },
-    "dsh":  {
-                "client":  {
-                               "inject":  [
-                                              "@deepseek-ai/dsh-client-runtime",
-                                              "@deepseek-ai/dsh-client-locale",
-                                              "@deepseek-ai/dsh-client-ui-slots",
-                                              "@deepseek-ai/dsh-client-ui-settings"
-                                          ],
-                               "platform":  "web"
-                           },
-                "bundle":  {
-                               "patch":  "./cordis.patch.yml"
-                           }
-            },
-    "keywords":  [
-                     "deepseek-harness",
-                     "dsh",
-                     "plugin",
-                     "peak",
-                     "off-peak",
-                     "weekend",
-                     "pause",
-                     "freeze",
-                     "retry",
-                     "session-gate"
-                 ],
-    "scripts":  {
-                    "test":  "node --test \"tests/*.test.mjs\"",
-                    "build":  "tsdown",
-                    "lint":  "eslint src tests"
-                },
-    "devDependencies":  {
-                            "tsdown":  "^0.22.2",
-                            "eslint":  "^10.8.1",
-                            "typescript":  "^5.6.0",
-                            "@types/react":  "~18.3.1",
-                            "typescript-eslint":  "^8.67.0",
-                            "react":  "^18.2.0",
-                            "@eslint/js":  "^10.0.1"
-                        },
-    "main":  "src/index.js"
-}
+  "name": "dsh-session-guard",
+  "version": "0.2.0-beta.1",
+  "type": "module",
+  "description": "高峰自动会话门：周末模式 + 高峰自动暂停 + 官方源二维判定 + 会话级冻结 + 后端自动重试。",
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "plugin",
+    "peak",
+    "off-peak",
+    "weekend",
+    "pause",
+    "freeze",
+    "retry",
+    "session-gate"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/drscrewdriver/session-guard.git"
+  },
+  "homepage": "https://github.com/drscrewdriver/session-guard",
+  "main": "src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src/",
+    "lib/",
+    "cordis.patch.yml",
+    "dsh.plugin.json",
+    "README.md",
+    "README.en.md",
+    "README.ja.md",
+    "README.ko.md",
+    "INSTALL.md",
+    "INSTALL.zh.md",
+    "INSTALL.ja.md",
+    "INSTALL.ko.md",
+    "CHANGELOG.md",
+    "CHANGELOG.ja.md",
+    "CHANGELOG.ko.md",
+    "LICENSE"
+  ],
+  "dsh": {
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-renderer"
+      ],
+      "platform": "web"
+    },
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "scripts": {
+    "build": "tsdown",
+    "lint": "eslint src tests",
+    "test": "node --test \"tests/*.test.mjs\""
+  },
+  "engines": {
+    "node": ">=20",
+    "dsh": ">=0.1.0-rc.7 <0.2.0-0"
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.1"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-locale": ">=0.1.0-rc.7 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.0-rc.7 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.0-rc.7 <0.2.0-0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-locale": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-settings": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-slots": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/react": "~18.3.1",
+    "eslint": "^10.8.1",
+    "react": "^18.2.0",
+    "tsdown": "^0.22.2",
+    "typescript": "^5.6.0",
+    "typescript-eslint": "^8.67.0"
+  }
+}

package/src/bridge.js

@@ -16,8 +16,10 @@ import { idleState } from './store.js'
  * @param {object} ctx host context
  * @param {ReturnType<import('./gate.js').createGate>} gate
  * @param {ReturnType<import('./store.js').createStore>} store
+ * @param {ReturnType<import('./pause-gate.js').createPauseGate>} [pauseGate]
+ * @param {ReturnType<import('./step-gate.js').createStepGate>} [stepGate] step 级门控（v0.2.0）
  */
-export function createBridge(ctx, gate, store, pauseGate) {
+export function createBridge(ctx, gate, store, pauseGate, stepGate) {
   function taskControlState(sessionId) {
     let tcState = null
     try {
@@ -55,11 +57,64 @@ export function createBridge(ctx, gate, store, pauseGate) {
       const next = gate.unlockQueue(sessionId)
       return { ok: true, state: next }
     },
+    /**
+     * 手动请求 step 级暂停（「暂停会话」按钮）。
+     * 不打断当前 step：在下一次 `agent/pre-step` 边界拉门（step 1 也拦，且不受峰谷/provider 限制）。
+     * @param {string} sessionId
+     */
+    stepPause(sessionId) {
+      if (!stepGate || typeof stepGate.requestPause !== 'function') {
+        return { requested: false, held: false, reason: 'no-step-gate' }
+      }
+      try {
+        return stepGate.requestPause(sessionId)
+      } catch {
+        return { requested: false, held: false, reason: 'error' }
+      }
+    },
+    /**
+     * 解开 step 门（v0.2.0）：放行被挂起的 step。
+     * 默认 `bypass=true`（用户手动「继续」）——本高峰窗口内不再拦该会话；
+     * 退峰/非官方切换等自动释放请用 `{ bypass: false }`。
+     * @param {string} sessionId
+     * @param {{bypass?:boolean, reason?:string}} [opts]
+     */
+    stepResume(sessionId, opts = {}) {
+      if (!stepGate || typeof stepGate.release !== 'function') {
+        return { released: false, bypass: false, reason: 'no-step-gate' }
+      }
+      const reason = opts.reason ?? 'manual'
+      let r
+      try {
+        r = stepGate.release(sessionId, reason)
+      } catch {
+        return { released: false, bypass: false, reason }
+      }
+      const released = !!(r && r.released === true)
+      let bypassed = false
+      if (released && opts.bypass !== false && typeof stepGate.markBypass === 'function') {
+        try {
+          stepGate.markBypass(sessionId)
+          bypassed = true
+        } catch {
+          /* ignore */
+        }
+      }
+      return { released, bypass: bypassed, reason }
+    },
     /** 读一会话状态。 */
     state(sessionId) {
       const cur = store.get(sessionId)
       const base = cur || idleState(sessionId)
       const pausedState = pauseGate ? (pauseGate.state(sessionId) || {}) : {}
+      let stepState = {}
+      if (stepGate && typeof stepGate.state === 'function') {
+        try {
+          stepState = stepGate.state(sessionId) || {}
+        } catch {
+          stepState = {}
+        }
+      }
       return {
         sessionId: String(sessionId),
         queueLocked: base.queueLocked === true,
@@ -67,6 +122,11 @@ export function createBridge(ctx, gate, store, pauseGate) {
         // 自研会话门真暂停状态（脱离 task-control）。
         paused: pausedState.paused === true,
         pausedForced: pausedState.forced === true,
+        // step 级门控（v0.2.0）：paused 保持布尔以兼容既有消费者，step 态用独立字段。
+        pausedStep: stepState.held === true,
+        stepHeldSince: stepState.since ?? null,
+        stepBypass: stepState.bypass === true,
+        stepManual: stepState.manual === true,
         taskControlAvailable: gate.taskControlAvailable(),
         taskControl: taskControlState(sessionId),
         updatedAt: base.updatedAt ?? null,

package/src/client/badge-text.ts

@@ -0,0 +1,49 @@
+/**
+ * dsh-session-guard — 状态徽标文案（纯函数，零依赖，可单测）。
+ *
+ * 分离出来的原因：徽标语义（高峰期「只拦官方」vs「全部暂停」）需要单测，
+ * 而组件文件是 TSX（含 React 运行时）。这里只有字符串逻辑。
+ */
+
+/** /session-guard/status 返回的全局阶段（组件与测试共用）。 */
+export interface Status {
+  phase: 'peak' | 'off-peak' | 'weekend'
+  enabled: boolean
+  weekendMode: boolean
+  /** 官方源二维判定是否开启（开启时高峰期只拦官方源）。 */
+  providerGuard?: boolean
+  /** 当前被挂起的请求数（hold 模式）。 */
+  held?: number
+  /** error 模式记下的延后会话数。 */
+  deferred?: number
+  /** 当前被 step 门挂起的会话数（v0.2.0）。 */
+  stepHeld?: number
+  timezone: string
+}
+
+/** 阶段文案。 */
+export const PHASE_LABELS = {
+  peak: '高峰',
+  'off-peak': '谷时',
+  weekend: '周末',
+} as const
+
+/** 高峰期的徽标文案：二维判定开启时区分「只拦官方」与「全部暂停」。 */
+export function peakLabel(status: Pick<Status, 'phase' | 'providerGuard'>): string {
+  if (status.phase !== 'peak') return PHASE_LABELS[status.phase]
+  return status.providerGuard === true ? '高峰·拦官方' : '高峰·全部暂停'
+}
+
+/** 悬浮说明：把判定口径与当前挂起/延后数量写清楚。 */
+export function badgeTitle(status: Status): string {
+  const base = `${PHASE_LABELS[status.phase]} · ${status.timezone}${status.weekendMode ? ' · 周末模式' : ''}`
+  if (status.phase !== 'peak') return base
+  const mode = status.providerGuard === true ? '仅拦截 DeepSeek 官方源' : '全部会话暂停（未启用二维判定）'
+  const held = status.held ?? 0
+  const deferred = status.deferred ?? 0
+  const stepHeld = status.stepHeld ?? 0
+  const extra = held > 0 || deferred > 0 || stepHeld > 0
+    ? ` · 挂起 ${held} · 延后 ${deferred} · step 挂起 ${stepHeld}`
+    : ''
+  return `${base} · ${mode}${extra}`
+}

package/src/client/index.ts

@@ -14,6 +14,7 @@
  */
 import { StatusBadge } from './status-badge'
 import { SessionGuardCard } from './settings-card'
+import { PauseButton } from './pause-button'
 
 /** 客户端所需服务：slots（状态徽标 + 设置卡片）+ locale + settingsScope（设置卡片绑定）。 */
 export const inject = ['slots', 'locale', 'settingsScope']
@@ -35,11 +36,20 @@ interface ClientCtx {
 const NS = 'session-guard'
 
 export function apply(ctx: ClientCtx) {
+  // 暂停会话按钮（v0.2.0）：step 级门控的状态显示 + 手动解除。
+  // order 20 < input-traffic 冻结按钮的 30 → 排在左侧，两者并列互不取代（ADR-001/002）。
+  ctx.slots.inject('conversation.input.right', () => ctx.slots.register({
+    name: 'conversation.input.right',
+    id: 'session-guard-pause',
+    order: 20,
+    locale: 'session-guard',
+  }, PauseButton))
+
   // 状态徽标：输入区右侧，纯展示。
   ctx.slots.inject('conversation.input.right', () => ctx.slots.register({
     name: 'conversation.input.right',
     id: 'session-guard-status',
-    order: 50,
+    order: 40,
     locale: 'session-guard',
   }, StatusBadge))
 

package/src/client/locales.ts

@@ -1,95 +1,163 @@
-/** `session-guard` client dictionaries (zh / en / ja / ko). */
-
-/** Dictionary namespace owned by this plugin. */
-export const NS = 'session-guard'
-
-/** Simplified Chinese dictionary (the key-set source of truth). */
-export const zh = {
-  '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.unavailable': '设置不可用：请确认 dsh-session-guard 已装配进 profile。',
-  'status.normal': '正常运行',
-  'status.paused_peak': '峰值暂停中',
-} satisfies Record<string, string>
-
-/** English dictionary (keys mirror zh). */
-export const en: Record<keyof typeof zh, string> = {
-  'badge.normal': 'Normal',
-  'badge.paused': 'Paused (peak)',
-  'badge_paused_peak': 'Peak paused',
-  'settings.enabled': 'Peak auto-pause',
-  'settings.enabled.desc': 'Auto-pause running sessions during peak hours',
-  'settings.offPeakAutoResume': 'Off-peak auto-resume',
-  'settings.offPeakAutoResume.desc': 'Auto-resume paused sessions during off-peak hours',
-  'settings.weekendMode': 'Weekend mode',
-  'settings.weekendMode.desc': 'Detect weekends → no auto-pause on weekends',
-  'settings.queueFallback': 'Fallback lock-wait queue',
-  'settings.queueFallback.desc': 'Fallback to lock-wait queue when custom session gate is unavailable (fail-open)',
-  'settings.retryEnabled': 'Auto-retry',
-  'settings.retryEnabled.desc': 'Transient failure auto-resume (off by default, conservative)',
-  'settings.timezone': 'Timezone',
-  'settings.peakWindows': 'Peak time windows',
-  'settings.unavailable': 'Settings unavailable: make sure dsh-session-guard is assembled into this profile.',
-  'status.normal': 'Running normally',
-  'status.paused_peak': 'Peak paused',
-}
-
-/** Japanese dictionary (keys mirror zh). */
-export const ja: 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.unavailable': '設定利用不可：dsh-session-guard が profile に組み込まれているか確認してください。',
-  'status.normal': '通常実行中',
-  'status.paused_peak': 'ピーク一時停止中',
-}
-
-/** Korean dictionary (keys mirror zh). */
-export const ko: 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.unavailable': '설정 사용 불가: dsh-session-guard가 이 profile에 조립되었는지 확인하세요.',
-  'status.normal': '정상 실행 중',
-  'status.paused_peak': '피크 일시정지 중',
-}
-
-/** Dictionary key union. */
-export type SessionGuardKey = keyof typeof zh
+/** `session-guard` client dictionaries (zh / en / ja / ko). */
+
+/** Dictionary namespace owned by this plugin. */
+export const NS = 'session-guard'
+
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export const zh = {
+  '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 官方源；本地/第三方 provider 照常跑',
+  'settings.officialProviders': '追加官方 provider id',
+  'settings.officialProviders.desc': '精确匹配，优先级最高（逗号分隔）',
+  'settings.officialBaseURLs': '官方端点名单',
+  'settings.officialBaseURLs.desc': 'baseURL 归一化后的 host（逗号分隔）',
+  'settings.deferredMode': '拦截方式',
+  'settings.deferredMode.desc': '挂起等待不报错；或报错并记入延后队列',
+  'settings.deferredResume': '退峰自动继续',
+  'settings.deferredResume.desc': '关闭后延后的请求/会话不自动续跑，需手动 /resume',
+  'settings.deferredResumeText': '退峰续跑文案',
+  'settings.deferredResumeText.desc': 'error 模式退峰时发送的消息内容',
+  'settings.guardSubagents': '纳入子代理请求',
+  'settings.guardSubagents.desc': '子代理请求同样计费，默认一并拦截',
+  'settings.officialHint': '判定口径：显式 id 名单 → baseURL 端点 → catalog 默认端点 → 内置 id。排查误判访问 /session-guard/provider?provider=<id> 看 matchedBy。',
+  'settings.unavailable': '设置不可用：请确认 dsh-session-guard 已装配进 profile。',
+  'status.normal': '正常运行',
+  'status.paused_peak': '峰值暂停中',
+  'status.peak_official': '高峰·拦官方',
+  'status.peak_all': '高峰·全部暂停',
+} satisfies Record<string, string>
+
+/** English dictionary (keys mirror zh). */
+export const en: Record<keyof typeof zh, string> = {
+  'badge.normal': 'Normal',
+  'badge.paused': 'Paused (peak)',
+  'badge_paused_peak': 'Peak paused',
+  'settings.enabled': 'Peak auto-pause',
+  'settings.enabled.desc': 'Auto-pause running sessions during peak hours',
+  'settings.offPeakAutoResume': 'Off-peak auto-resume',
+  'settings.offPeakAutoResume.desc': 'Auto-resume paused sessions during off-peak hours',
+  'settings.weekendMode': 'Weekend mode',
+  'settings.weekendMode.desc': 'Detect weekends → no auto-pause on weekends',
+  'settings.queueFallback': 'Fallback lock-wait queue',
+  'settings.queueFallback.desc': 'Fallback to lock-wait queue when custom session gate is unavailable (fail-open)',
+  'settings.retryEnabled': 'Auto-retry',
+  'settings.retryEnabled.desc': 'Transient failure auto-resume (off by default, conservative)',
+  'settings.timezone': 'Timezone',
+  'settings.peakWindows': 'Peak time windows',
+  'settings.providerGuard': 'Official-source guard',
+  'settings.providerGuard.desc': 'During peak hours only DeepSeek official sources are blocked; local/third-party providers keep running',
+  'settings.officialProviders': 'Extra official provider ids',
+  'settings.officialProviders.desc': 'Exact match, highest priority (comma separated)',
+  'settings.officialBaseURLs': 'Official endpoint hosts',
+  'settings.officialBaseURLs.desc': 'Hosts after baseURL normalization (comma separated)',
+  'settings.deferredMode': 'Interception mode',
+  'settings.deferredMode.desc': 'Hold without error, or fail and queue as deferred',
+  'settings.deferredResume': 'Auto-resume after peak',
+  'settings.deferredResume.desc': 'When off, deferred requests/sessions stay parked until a manual /resume',
+  'settings.deferredResumeText': 'Resume message',
+  'settings.deferredResumeText.desc': 'Text sent when an error-mode session resumes off-peak',
+  'settings.guardSubagents': 'Guard subagent requests',
+  'settings.guardSubagents.desc': 'Subagent requests are billed too; guarded by default',
+  'settings.officialHint': 'Decision order: explicit id list → baseURL endpoint → catalog default endpoint → builtin id. For a wrong verdict open /session-guard/provider?provider=<id> and read matchedBy.',
+  'settings.unavailable': 'Settings unavailable: make sure dsh-session-guard is assembled into this profile.',
+  'status.normal': 'Running normally',
+  'status.paused_peak': 'Peak paused',
+  'status.peak_official': 'Peak · official only',
+  'status.peak_all': 'Peak · all paused',
+}
+
+/** Japanese dictionary (keys mirror zh). */
+export const ja: 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 公式ソースのみ停止。ローカル/第三者 provider は通常どおり実行',
+  'settings.officialProviders': '公式 provider id を追加',
+  'settings.officialProviders.desc': '完全一致、最優先（カンマ区切り）',
+  'settings.officialBaseURLs': '公式エンドポイント host',
+  'settings.officialBaseURLs.desc': 'baseURL 正規化後の host（カンマ区切り）',
+  'settings.deferredMode': '遮断方式',
+  'settings.deferredMode.desc': 'エラーなしで保留、またはエラーにして延後キューへ',
+  'settings.deferredResume': 'ピーク後の自動再開',
+  'settings.deferredResume.desc': 'オフにすると延後したリクエスト/セッションは手動 /resume まで停止',
+  'settings.deferredResumeText': '再開メッセージ',
+  'settings.deferredResumeText.desc': 'error モードでピーク後に送るテキスト',
+  'settings.guardSubagents': 'サブエージェントも対象',
+  'settings.guardSubagents.desc': 'サブエージェントのリクエストも課金対象。既定で遮断',
+  'settings.officialHint': '判定順：明示 id リスト → baseURL エンドポイント → catalog 既定エンドポイント → 内蔵 id。誤判定は /session-guard/provider?provider=<id> の matchedBy を確認。',
+  'settings.unavailable': '設定利用不可：dsh-session-guard が profile に組み込まれているか確認してください。',
+  'status.normal': '通常実行中',
+  'status.paused_peak': 'ピーク一時停止中',
+  'status.peak_official': 'ピーク・公式のみ',
+  'status.peak_all': 'ピーク・全停止',
+}
+
+/** Korean dictionary (keys mirror zh). */
+export const ko: 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': '공식 소스 2차 판정',
+  'settings.providerGuard.desc': '피크 시간에는 DeepSeek 공식 소스만 차단, 로컬/서드파티 provider는 정상 실행',
+  'settings.officialProviders': '공식 provider id 추가',
+  'settings.officialProviders.desc': '정확히 일치, 최우선(쉼표 구분)',
+  'settings.officialBaseURLs': '공식 엔드포인트 host',
+  'settings.officialBaseURLs.desc': 'baseURL 정규화 후 host(쉼표 구분)',
+  'settings.deferredMode': '차단 방식',
+  'settings.deferredMode.desc': '오류 없이 보류, 또는 오류로 연기 후 큐에 기록',
+  'settings.deferredResume': '피크 후 자동 재개',
+  'settings.deferredResume.desc': '끄면 보류된 요청/세션은 수동 /resume 전까지 멈춤',
+  'settings.deferredResumeText': '재개 메시지',
+  'settings.deferredResumeText.desc': 'error 모드에서 피크 후 보내는 텍스트',
+  'settings.guardSubagents': '서브에이전트 포함',
+  'settings.guardSubagents.desc': '서브에이전트 요청도 과금 대상, 기본 포함',
+  'settings.officialHint': '판정 순서: 명시 id 목록 → baseURL 엔드포인트 → catalog 기본 엔드포인트 → 내장 id. 오판정은 /session-guard/provider?provider=<id> 의 matchedBy 확인.',
+  'settings.unavailable': '설정 사용 불가: dsh-session-guard가 이 profile에 조립되었는지 확인하세요.',
+  'status.normal': '정상 실행 중',
+  'status.paused_peak': '피크 일시정지 중',
+  'status.peak_official': '피크·공식만',
+  'status.peak_all': '피크·전체 정지',
+}
+
+/** Dictionary key union. */
+export type SessionGuardKey = keyof typeof zh