dsh-session-guard 4.0.2 → 4.1.5

package/src/client/shell-overlay.tsx

@@ -0,0 +1,69 @@
+/**
+ * dsh-session-guard — 无设置页宿主（0.1.0/0.1.1）的兜底配置入口。
+ *
+ * 壳级 `shell.overlay` 席位渲染：右下角固定齿轮钮，点开固定定位浮层承载
+ * SessionGuardCard（page 形态，默认展开）。配置存储全在 host 侧（settings
+ * 服务），浮层与宿主设置页解耦——壳再老也不影响读写。有设置页的宿主上
+ * 该齿轮与行配置卡/家族 tab 并存，作为全局快捷入口。
+ */
+import { useState } from 'react'
+import { SessionGuardCard } from './settings-card'
+import type { SessionGuardConfig } from './settings-card'
+import type { SettingsScope } from './scope-face'
+
+export function ShellSettingsEntry(props: {
+  scope: SettingsScope<SessionGuardConfig>
+}): JSX.Element {
+  const [open, setOpen] = useState(false)
+  return (
+    <div style={{ position: 'fixed', right: 16, bottom: 64, zIndex: 10000 }}>
+      {open && (
+        <div
+          onClick={() => setOpen(false)}
+          style={{ position: 'fixed', top: 0, left: 0, right: 0, bottom: 0, background: 'rgba(0,0,0,.45)', zIndex: 10000 }}
+        />
+      )}
+      {open && (
+        <div
+          style={{
+            position: 'fixed',
+            top: '6vh',
+            left: '50%',
+            transform: 'translateX(-50%)',
+            width: 'min(760px, 92vw)',
+            maxHeight: '84vh',
+            overflowY: 'auto',
+            zIndex: 10001,
+          }}
+        >
+          <button
+            type="button"
+            onClick={() => setOpen(false)}
+            style={{ position: 'sticky', top: 6, float: 'right', marginRight: 8, zIndex: 2 }}
+          >
+            ✕ 关闭
+          </button>
+          <SessionGuardCard scope={props.scope} />
+        </div>
+      )}
+      <button
+        type="button"
+        title="会话守护设置"
+        onClick={() => setOpen(state => !state)}
+        style={{
+          width: 40,
+          height: 40,
+          borderRadius: '50%',
+          border: '1px solid rgba(127,127,127,.4)',
+          background: 'rgba(30,30,32,.85)',
+          color: 'inherit',
+          cursor: 'pointer',
+          fontSize: 16,
+          boxShadow: '0 4px 16px rgba(0,0,0,.35)',
+        }}
+      >
+        🛡
+      </button>
+    </div>
+  )
+}

package/src/client/status-badge.tsx

@@ -4,6 +4,9 @@
  * 轮询 host 的 /session-guard/status（全局当前阶段），显示 高峰/谷时/周末；
  * 高峰期按二维判定区分「只拦官方」与「全部暂停」（文案见 badge-text.ts）。
  * 仅展示，不做任何队列/会话动作；冻结按钮由 input-traffic 经桥接管（D6/D8）。
+ *
+ * 自适应退避（universal-rc）：视口宽度不足（< PEAK_BADGE_MIN_VIEWPORT，窄窗/
+ * 分屏）或新空会话（sessionId 未落盘为 undefined）→ 整体退避隐藏。
  */
 import { useEffect, useState } from 'react'
 import { badgeTitle, peakLabel, type Status } from './badge-text'
@@ -15,10 +18,15 @@ export interface StatusBadgeProps {
 }
 
 const POLL_MS = 15_000
+/** 视口宽度退避阈值：低于此值隐藏徽标（窄窗/分屏下输入区放不下）。 */
+const PEAK_BADGE_MIN_VIEWPORT = 960
 
 /** 状态徽标：轮询全局阶段，显示 高峰/谷时/周末（enabled 关闭或请求失败时静默隐藏）。 */
 export function StatusBadge({ sessionId }: StatusBadgeProps) {
   const [status, setStatus] = useState<Status | null>(null)
+  const [viewportNarrow, setViewportNarrow] = useState(
+    () => typeof window !== 'undefined' && window.innerWidth < PEAK_BADGE_MIN_VIEWPORT,
+  )
 
   injectClientCss()
 
@@ -42,6 +50,15 @@ export function StatusBadge({ sessionId }: StatusBadgeProps) {
     }
   }, [sessionId])
 
+  useEffect(() => {
+    const onResize = () => setViewportNarrow(window.innerWidth < PEAK_BADGE_MIN_VIEWPORT)
+    window.addEventListener('resize', onResize)
+    return () => window.removeEventListener('resize', onResize)
+  }, [])
+
+  // 视口宽度不足:退避隐藏。新空会话隐藏需会话空态信号(UseChat 契约),
+  // 留待后续(sessionId 在新会话同样有值,不能作判定)。
+  if (viewportNarrow) return null
   if (!status || !status.enabled) return null
 
   const cls = status.phase === 'peak' ? 'sg-peak' : status.phase === 'weekend' ? 'sg-weekend' : 'sg-off'

package/src/client/styles.ts

@@ -1,30 +1,30 @@
-/**
- * dsh-session-guard — 客户端样式（与 composer 右侧 input-traffic 冻结按钮同一视觉语言）。
- *
- * 为什么注入 `<style>` 而不是 CSS Modules：本插件的 tsdown 配置没有 CSS Modules 管线
- * （input-traffic 有），而 settings-card 已经用 `<style data-plugin-css>` 的既有约定。
- * 这里只做一件事：把「暂停会话 / 继续会话」按钮与状态徽标对齐到同一行的其它控件
- * （高度 24px、圆角 6px、12px 字号、同样的 border / hover / pressed 令牌）。
- */
-
-/** 与 `dsh-input-traffic/src/client/freeze-button.module.css` 对齐的控件外观。 */
-export const CLIENT_CSS = `
-.sg-pause{display:inline-flex;align-items:center;gap:4px;height:24px;padding:0 8px;border:1px solid var(--dsw-alias-border-l3,rgba(0,0,0,.12));border-radius:6px;background:transparent;color:var(--dsw-alias-label-secondary,#6b7280);font-size:12px;line-height:1;cursor:pointer;white-space:nowrap;flex:none}
-.sg-pause:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover,rgba(0,0,0,.04))}
-.sg-pause:disabled{opacity:.55;cursor:default}
-.sg-pause[aria-pressed='true']{border-color:var(--dsw-alias-state-warning-primary,#d97706);color:var(--dsw-alias-state-warning-primary,#d97706);background:color-mix(in srgb,var(--dsw-alias-state-warning-primary,#d97706) 8%,transparent)}
-.sg-status{display:inline-flex;align-items:center;height:24px;padding:0 8px;border:1px solid var(--dsw-alias-border-l3,rgba(0,0,0,.12));border-radius:6px;font-size:12px;line-height:1;color:var(--dsw-alias-label-secondary,#6b7280);white-space:nowrap;flex:none}
-.sg-status.sg-peak{border-color:var(--dsw-alias-state-warning-primary,#d97706);color:var(--dsw-alias-state-warning-primary,#d97706)}
-.sg-status.sg-weekend{border-color:var(--dsw-alias-state-success-primary,#30a46c);color:var(--dsw-alias-state-success-primary,#30a46c)}
-`
-
-/** 注入一次（幂等；无 document 时静默跳过）。 */
-export function injectClientCss(): void {
-  if (typeof document === 'undefined') return
-  if (document.querySelector('style[data-plugin-css="session-guard-client"]') !== null) return
-  const tag = document.createElement('style')
-  tag.dataset.plugin = 'dsh-session-guard'
-  tag.dataset.pluginCss = 'session-guard-client'
-  tag.textContent = CLIENT_CSS
-  document.head.appendChild(tag)
-}
+/**
+ * dsh-session-guard — 客户端样式（与 composer 右侧 input-traffic 冻结按钮同一视觉语言）。
+ *
+ * 为什么注入 `<style>` 而不是 CSS Modules：本插件的 tsdown 配置没有 CSS Modules 管线
+ * （input-traffic 有），而 settings-card 已经用 `<style data-plugin-css>` 的既有约定。
+ * 这里只做一件事：把「暂停会话 / 继续会话」按钮与状态徽标对齐到同一行的其它控件
+ * （高度 24px、圆角 6px、12px 字号、同样的 border / hover / pressed 令牌）。
+ */
+
+/** 与 `dsh-input-traffic/src/client/freeze-button.module.css` 对齐的控件外观。 */
+export const CLIENT_CSS = `
+.sg-pause{display:inline-flex;align-items:center;gap:4px;height:24px;padding:0 8px;border:1px solid var(--dsw-alias-border-l3,rgba(0,0,0,.12));border-radius:6px;background:transparent;color:var(--dsw-alias-label-secondary,#6b7280);font-size:12px;line-height:1;cursor:pointer;white-space:nowrap;flex:none}
+.sg-pause:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover,rgba(0,0,0,.04))}
+.sg-pause:disabled{opacity:.55;cursor:default}
+.sg-pause[aria-pressed='true']{border-color:var(--dsw-alias-state-warning-primary,#d97706);color:var(--dsw-alias-state-warning-primary,#d97706);background:color-mix(in srgb,var(--dsw-alias-state-warning-primary,#d97706) 8%,transparent)}
+.sg-status{display:inline-flex;align-items:center;height:24px;padding:0 8px;border:1px solid var(--dsw-alias-border-l3,rgba(0,0,0,.12));border-radius:6px;font-size:12px;line-height:1;color:var(--dsw-alias-label-secondary,#6b7280);white-space:nowrap;flex:none}
+.sg-status.sg-peak{border-color:var(--dsw-alias-state-warning-primary,#d97706);color:var(--dsw-alias-state-warning-primary,#d97706)}
+.sg-status.sg-weekend{border-color:var(--dsw-alias-state-success-primary,#30a46c);color:var(--dsw-alias-state-success-primary,#30a46c)}
+`
+
+/** 注入一次（幂等；无 document 时静默跳过）。 */
+export function injectClientCss(): void {
+  if (typeof document === 'undefined') return
+  if (document.querySelector('style[data-plugin-css="session-guard-client"]') !== null) return
+  const tag = document.createElement('style')
+  tag.dataset.plugin = 'dsh-session-guard'
+  tag.dataset.pluginCss = 'session-guard-client'
+  tag.textContent = CLIENT_CSS
+  document.head.appendChild(tag)
+}

package/src/detect.js

@@ -1,27 +1,27 @@
-/**
- * dsh-session-guard — 自动检测（D7，诚实边界）。
- *
- * - host 可自动探测：`ctx.get('taskControl')`（会话门）、`ctx.get('sessionGuard')`。
- * - client 可自动探测：input-traffic 补的「最小桥」标记 `window.__DSH_SESSION_GUARD_BRIDGE__`
- *   （方案 A 中 input-traffic 冻结按钮触发时会调 sessionGuard.stopNextTurn）。
- *   探测不到 → 本插件客户端使用自带回退冻结（fallback），fail-open 不报错（D8）。
- */
-
-/** host：会话门（dsh-task-control）是否可用。 */
-export function detectTaskControl(ctx) {
-  return !!(ctx && typeof ctx.get === 'function' && ctx.get('taskControl'))
-}
-
-/** host：sessionGuard 服务是否已提供（其他插件探测用）。 */
-export function detectSessionGuard(ctx) {
-  return !!(ctx && typeof ctx.get === 'function' && ctx.get('sessionGuard'))
-}
-
-/**
- * client：input-traffic 最小桥是否已注册。
- * @param {object} [g] 显式传入全局对象（便于测试）；默认 globalThis
- */
-export function detectInputTrafficBridge(g) {
-  const root = g || (typeof globalThis !== 'undefined' ? globalThis : {})
-  return !!(root && root.__DSH_SESSION_GUARD_BRIDGE__ && typeof root.__DSH_SESSION_GUARD_BRIDGE__.stopNextTurn === 'function')
-}
+/**
+ * dsh-session-guard — 自动检测（D7，诚实边界）。
+ *
+ * - host 可自动探测：`ctx.get('taskControl')`（会话门）、`ctx.get('sessionGuard')`。
+ * - client 可自动探测：input-traffic 补的「最小桥」标记 `window.__DSH_SESSION_GUARD_BRIDGE__`
+ *   （方案 A 中 input-traffic 冻结按钮触发时会调 sessionGuard.stopNextTurn）。
+ *   探测不到 → 本插件客户端使用自带回退冻结（fallback），fail-open 不报错（D8）。
+ */
+
+/** host：会话门（dsh-task-control）是否可用。 */
+export function detectTaskControl(ctx) {
+  return !!(ctx && typeof ctx.get === 'function' && ctx.get('taskControl'))
+}
+
+/** host：sessionGuard 服务是否已提供（其他插件探测用）。 */
+export function detectSessionGuard(ctx) {
+  return !!(ctx && typeof ctx.get === 'function' && ctx.get('sessionGuard'))
+}
+
+/**
+ * client：input-traffic 最小桥是否已注册。
+ * @param {object} [g] 显式传入全局对象（便于测试）；默认 globalThis
+ */
+export function detectInputTrafficBridge(g) {
+  const root = g || (typeof globalThis !== 'undefined' ? globalThis : {})
+  return !!(root && root.__DSH_SESSION_GUARD_BRIDGE__ && typeof root.__DSH_SESSION_GUARD_BRIDGE__.stopNextTurn === 'function')
+}

package/src/gate.js

@@ -1,93 +1,93 @@
-/**
- * dsh-session-guard — 会话门驱动（D3/D5/D6，自研真实锁定）。
- *
- * **主路径**（替换 dsh-task-control）：经自研 `pauseGate` 真暂停 session 推进——
- * `pauseGate.pause(id,{mode,reason})` 调用 agent.cancel / goals.pause / session/event
- * 安全边界落地（见 src/pause-gate.js），不再依赖 `ctx.get('taskControl')`，也不再退化成
- * 只写 `queueLocked` 标记。
- *
- * **降级路径**（fail-open，D8）：仅当自研暂停因 agent 不可用而失败时，按 `queueFallback`
- * 回退为只锁等待队列（`queueLocked` 持久化标记，供前端/重试让路）。
- *
- * resume 对称：自研 resume（从暂停点续跑）或清 queueLock。
- */
-import { idleState } from './store.js'
-
-/**
- * @param {object} deps
- * @param {()=>object|null} deps.getCtx 取当前 host ctx（懒，便于测试）
- * @param {()=>object} deps.getSettings 读实时配置（pauseMode/pauseReason）
- * @param {ReturnType<import('./store.js').createStore>} deps.store 持久化队列锁
- * @param {ReturnType<import('./pause-gate.js').createPauseGate>} [deps.pauseGate] 自研会话门引擎
- * @param {(event:string, sessionId:string, payload?:object)=>void} [deps.emit] 状态变化通知
- */
-export function createGate({ getCtx: _getCtx, getSettings, store, pauseGate, emit }) {
-  function lockQueue(sessionId, reason) {
-    const cur = store.get(sessionId)
-    const next = { ...(cur || idleState(sessionId)), queueLocked: true, lockReason: reason, updatedAt: Date.now() }
-    store.set(sessionId, next)
-    if (emit) emit('queue-lock', sessionId, { reason })
-    return next
-  }
-
-  function unlockQueue(sessionId) {
-    const cur = store.get(sessionId)
-    const next = { ...(cur || idleState(sessionId)), queueLocked: false, lockReason: null, updatedAt: Date.now() }
-    store.set(sessionId, next)
-    if (emit) emit('queue-unlock', sessionId)
-    return next
-  }
-
-  /**
-   * 停掉 session 的下一回合（真实锁定推进）。
-   * ① 自研 pauseGate.pause（真暂停）；② 自研失败/agent 不可用 → 按 queueFallback 降级锁队列。
-   * @param {string} sessionId
-   * @param {object} [opts] { mode, reason }
-   */
-  async function stopNextTurn(sessionId, opts = {}) {
-    const cfg = getSettings()
-    if (pauseGate) {
-      try {
-        const mode = opts.mode ?? cfg.pauseMode ?? 'safe'
-        const reason = opts.reason ?? cfg.pauseReason ?? 'wait'
-        const r = pauseGate.pause(sessionId, { mode, reason })
-        if (r && r.kind === 'success') return { ok: true, via: 'pauseGate', result: r }
-        // kind === 'error'（如 no live agent）→ 落到降级，语义如实上报。
-      } catch {
-        // 自研内部异常 → fail-open 降级，绝不中断冻结动作。
-      }
-    }
-    // 无自研门或自研失败 → 回退只锁等待队列（自带实现，D5）。
-    if (cfg.queueFallback === false) {
-      return { ok: false, via: 'queueLock', error: 'queueFallback disabled' }
-    }
-    lockQueue(sessionId, 'peak')
-    return { ok: true, via: 'queueLock' }
-  }
-
-  /**
-   * 恢复 session 推进（从暂停点续跑）。
-   * ① 自研 resume（confirm + choice）；② 降级清 queueLock。
-   */
-  async function resume(sessionId, opts = {}) {
-    if (pauseGate) {
-      try {
-        const r = pauseGate.resume(sessionId, { confirm: true, choice: opts.choice ?? 'rerun' })
-        if (r && r.kind === 'success') return { ok: true, via: 'pauseGate', result: r }
-      } catch {
-        // 降级清队列锁。
-      }
-    }
-    unlockQueue(sessionId)
-    return { ok: true, via: 'queueLock' }
-  }
-
-  return {
-    stopNextTurn,
-    resume,
-    lockQueue,
-    unlockQueue,
-    /** 自研会话门是否可用（自研后恒视为可用；供 detect/UI 展示）。 */
-    taskControlAvailable: () => (pauseGate ? pauseGate.taskControlAvailable() : false),
-  }
-}
+/**
+ * dsh-session-guard — 会话门驱动（D3/D5/D6，自研真实锁定）。
+ *
+ * **主路径**（替换 dsh-task-control）：经自研 `pauseGate` 真暂停 session 推进——
+ * `pauseGate.pause(id,{mode,reason})` 调用 agent.cancel / goals.pause / session/event
+ * 安全边界落地（见 src/pause-gate.js），不再依赖 `ctx.get('taskControl')`，也不再退化成
+ * 只写 `queueLocked` 标记。
+ *
+ * **降级路径**（fail-open，D8）：仅当自研暂停因 agent 不可用而失败时，按 `queueFallback`
+ * 回退为只锁等待队列（`queueLocked` 持久化标记，供前端/重试让路）。
+ *
+ * resume 对称：自研 resume（从暂停点续跑）或清 queueLock。
+ */
+import { idleState } from './store.js'
+
+/**
+ * @param {object} deps
+ * @param {()=>object|null} deps.getCtx 取当前 host ctx（懒，便于测试）
+ * @param {()=>object} deps.getSettings 读实时配置（pauseMode/pauseReason）
+ * @param {ReturnType<import('./store.js').createStore>} deps.store 持久化队列锁
+ * @param {ReturnType<import('./pause-gate.js').createPauseGate>} [deps.pauseGate] 自研会话门引擎
+ * @param {(event:string, sessionId:string, payload?:object)=>void} [deps.emit] 状态变化通知
+ */
+export function createGate({ getCtx: _getCtx, getSettings, store, pauseGate, emit }) {
+  function lockQueue(sessionId, reason) {
+    const cur = store.get(sessionId)
+    const next = { ...(cur || idleState(sessionId)), queueLocked: true, lockReason: reason, updatedAt: Date.now() }
+    store.set(sessionId, next)
+    if (emit) emit('queue-lock', sessionId, { reason })
+    return next
+  }
+
+  function unlockQueue(sessionId) {
+    const cur = store.get(sessionId)
+    const next = { ...(cur || idleState(sessionId)), queueLocked: false, lockReason: null, updatedAt: Date.now() }
+    store.set(sessionId, next)
+    if (emit) emit('queue-unlock', sessionId)
+    return next
+  }
+
+  /**
+   * 停掉 session 的下一回合（真实锁定推进）。
+   * ① 自研 pauseGate.pause（真暂停）；② 自研失败/agent 不可用 → 按 queueFallback 降级锁队列。
+   * @param {string} sessionId
+   * @param {object} [opts] { mode, reason }
+   */
+  async function stopNextTurn(sessionId, opts = {}) {
+    const cfg = getSettings()
+    if (pauseGate) {
+      try {
+        const mode = opts.mode ?? cfg.pauseMode ?? 'safe'
+        const reason = opts.reason ?? cfg.pauseReason ?? 'wait'
+        const r = pauseGate.pause(sessionId, { mode, reason })
+        if (r && r.kind === 'success') return { ok: true, via: 'pauseGate', result: r }
+        // kind === 'error'（如 no live agent）→ 落到降级，语义如实上报。
+      } catch {
+        // 自研内部异常 → fail-open 降级，绝不中断冻结动作。
+      }
+    }
+    // 无自研门或自研失败 → 回退只锁等待队列（自带实现，D5）。
+    if (cfg.queueFallback === false) {
+      return { ok: false, via: 'queueLock', error: 'queueFallback disabled' }
+    }
+    lockQueue(sessionId, 'peak')
+    return { ok: true, via: 'queueLock' }
+  }
+
+  /**
+   * 恢复 session 推进（从暂停点续跑）。
+   * ① 自研 resume（confirm + choice）；② 降级清 queueLock。
+   */
+  async function resume(sessionId, opts = {}) {
+    if (pauseGate) {
+      try {
+        const r = pauseGate.resume(sessionId, { confirm: true, choice: opts.choice ?? 'rerun' })
+        if (r && r.kind === 'success') return { ok: true, via: 'pauseGate', result: r }
+      } catch {
+        // 降级清队列锁。
+      }
+    }
+    unlockQueue(sessionId)
+    return { ok: true, via: 'queueLock' }
+  }
+
+  return {
+    stopNextTurn,
+    resume,
+    lockQueue,
+    unlockQueue,
+    /** 自研会话门是否可用（自研后恒视为可用；供 detect/UI 展示）。 */
+    taskControlAvailable: () => (pauseGate ? pauseGate.taskControlAvailable() : false),
+  }
+}

package/src/index.js

@@ -43,10 +43,12 @@ export function apply(ctx, config = {}) {
   let lastState = null
 
   /** 读实时设置（settings 服务不可用时回退默认）。 */
+  let configSource = config
   /** 组合条目快照：volatile 字段解引，供默认值合并。 */
   function resolveEntryConfig() {
+    const source = configSource ?? config
     const out = {}
-    for (const key of Object.keys(DEFAULT_SETTINGS)) out[key] = readVolatileValue(config[key])
+    for (const key of Object.keys(DEFAULT_SETTINGS)) out[key] = readVolatileValue(source?.[key])
     return out
   }
 
@@ -59,6 +61,39 @@ export function apply(ctx, config = {}) {
     }
   }
 
+  // ── ≤0.1.5(含 0.1.0/0.1.1)设置命名空间 legacy 注册(universal-rc)──────
+  // 0.1.7+ 由 loader 自动注册 ns,无需此块;老线必须经 settings 服务手动注册,
+  // 否则 client 配置卡报「设置命名空间不可用」。两条 legacy 路径按服务能力
+  // 自动分派:0.1.2/0.1.5 = 服务实例 installSection;0.1.0/0.1.1 = 模块级
+  // installSettingsSection + settingsNamespace。fail-open:失败仅告警。
+  try {
+    ctx.inject(['settings'], (sctx) => {
+      const service = sctx.settings
+      if (service === undefined || service === null) return
+      const hooks = {
+        setSource: (source) => {
+          configSource = typeof source === 'function' ? source() : source
+        },
+        onChange: () => {
+          // 状态机按 tick 读 readCfg(),无需即时动作。
+        },
+      }
+      if (typeof service.installSection === 'function') {
+        service.installSection(ctx, NS, SettingsSchema, resolveEntryConfig(), hooks)
+        console.warn('dsh-session-guard: settings registered via service.installSection (<=0.1.5)')
+        return
+      }
+      void import('@deepseek-ai/dsh-settings').then((legacy) => {
+        if (typeof legacy.installSettingsSection === 'function' && typeof legacy.settingsNamespace === 'function') {
+          legacy.installSettingsSection(ctx, legacy.settingsNamespace(NS), SettingsSchema, resolveEntryConfig(), hooks)
+          console.warn('dsh-session-guard: settings registered via module installSettingsSection (0.1.0/0.1.1)')
+        }
+      }).catch(() => {})
+    })
+  } catch (error) {
+    console.warn('dsh-session-guard: legacy settings registration skipped:', error)
+  }
+
   // ── SSE 推送（v0.2.0）：step 门状态变化时立刻推给对应会话页面 ──
   // 客户端「暂停会话 / 继续会话」按钮据此更新，无需等轮询。
   const sseClients = new Set()