dsh-session-guard 0.1.0

package/src/client/index.ts

@@ -0,0 +1,56 @@
+/**
+ * dsh-session-guard — 浏览器 half。
+ *
+ * 职责（全部 fail-open，D8）：
+ * - 在 composer 输入区右侧注册一个**纯展示**状态徽标（高峰/谷时/周末），轮询
+ *   /session-guard/status；
+ * - 注册 `settings.plugin.item` 设置卡片，经 `settingsScope.bind({ namespace })`
+ *   绑定 host 已注册的 `session-guard` 命名空间——这正是“插件配置”面板显示本
+ *   插件的**必要**机制（对齐 dsh-thinking-levels / dsh-context）；
+ * - **不做**冻结/会话动作——冻结按钮由 input-traffic 接管并经 /session-guard/rpc
+ *   桥接 host 会话门；本插件客户端不注册任何按钮，避免与 input-traffic 冲突。
+ *
+ * 构建：tsdown → lib/client.js（__ModuleLoader__.load 注册，与 input-traffic 同构）。
+ */
+import { StatusBadge } from './status-badge'
+import { SessionGuardCard } from './settings-card'
+
+/** 客户端所需服务：slots（状态徽标 + 设置卡片）+ locale + settingsScope（设置卡片绑定）。 */
+export const inject = ['slots', 'locale', 'settingsScope']
+
+/** 轻量 ctx 类型（仅本客户端用到的方法；构建时类型被剥离）。 */
+interface SlotsFace {
+  inject: (_name: string, _fn: () => unknown) => () => void
+  register: (_options: Record<string, unknown>, _component: unknown) => () => void
+}
+interface SettingsScopeFace {
+  bind: (_spec: { namespace: string }) => unknown
+}
+interface ClientCtx {
+  slots: SlotsFace
+  settingsScope: SettingsScopeFace
+}
+
+/** host 侧 src/settings.js 注册的命名空间（保持一致）。 */
+const NS = 'session-guard'
+
+export function apply(ctx: ClientCtx) {
+  // 状态徽标：输入区右侧，纯展示。
+  ctx.slots.inject('conversation.input.right', () => ctx.slots.register({
+    name: 'conversation.input.right',
+    id: 'session-guard-status',
+    order: 50,
+    locale: 'session-guard',
+  }, StatusBadge))
+
+  // 插件配置卡片：绑定 session-guard 命名空间，经 settingsScope 渲染并提交。
+  ctx.slots.inject('settings.plugin.item', () => ctx.slots.register({
+    name: 'settings.plugin.item',
+    id: NS,
+    key: NS,
+    locale: 'session-guard',
+    inject: () => ({
+      scope: ctx.settingsScope.bind({ namespace: NS }),
+    }),
+  }, SessionGuardCard))
+}

package/src/client/settings-card.tsx

@@ -0,0 +1,191 @@
+/**
+ * dsh-session-guard — 插件配置卡片（settings.plugin.item 面）。
+ *
+ * 对齐 dsh-thinking-levels / dsh-tidychat 的卡片语法：一个可展开的 `<li>`，
+ * header 按钮（插件名 + 描述 + chevron）切换字段体；开关为 pill switch
+ * （track + thumb），不是复选框对勾。
+ *
+ * 通过 `settingsScope.bind({ namespace: NS })` 绑定 host 已注册的
+ * `session-guard` 命名空间；每次变更立即经 scope 提交（无 staged form）。
+ * 仅依赖 react；CSS 经 `<style data-plugin-css>` 注入一次，控件为原生 HTML，
+ * 客户端 bundle 无 value-import @deepseek-ai/* 平台包（类型导入被构建擦除）。
+ */
+import { useState, useSyncExternalStore } from 'react'
+import type { JSX } from 'react'
+import type { SettingsScope } from '@deepseek-ai/dsh-client-ui-settings/client'
+
+/** 命名空间值形状（与 host 的 DEFAULT_SETTINGS 对应）。 */
+export interface SessionGuardConfig {
+  enabled: boolean
+  offPeakAutoResume: boolean
+  weekendMode: boolean
+  queueFallback: boolean
+  retryEnabled: boolean
+  timezone: string
+  pauseMode: 'safe' | 'force'
+  pauseReason: 'wait' | 'stop'
+}
+
+/** 注入给卡片的面：绑定到 session-guard 命名空间的 settings scope。 */
+export interface SettingsCardInjected {
+  scope: SettingsScope<SessionGuardConfig>
+}
+
+export type SettingsCardProps = SettingsCardInjected
+
+/** 卡片样式，注入一次（保持 bundle CSS-free）。 */
+const CARD_CSS = `
+.sgCard{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:12px;list-style:none;transition:border-color .16s,background .16s}
+.sgCard:hover{border-color:var(--dsw-alias-label-dimmed)}
+.sgCard-open{background:var(--dsw-alias-bg-layer-2);border-color:var(--dsw-alias-label-dimmed)}
+.sgCardHeader{appearance:none;width:100%;font:inherit;color:inherit;text-align:left;cursor:pointer;background:transparent;border:0;border-radius:12px;align-items:center;gap:12px;padding:14px 16px;display:flex}
+.sgCardHeadtext{flex-direction:column;flex:1;gap:4px;min-width:0;display:flex}
+.sgCardName{color:var(--dsw-alias-label-primary);font-size:15px;font-weight:600;line-height:1.4}
+.sgCardDesc{color:var(--dsw-alias-label-tertiary);font-size:13px;line-height:1.5}
+.sgCardChevron{color:var(--dsw-alias-label-tertiary);flex:none;transition:transform .16s}
+.sgCardChevron-open{transform:rotate(180deg)}
+.sgCardBody{border-top:1px solid var(--dsw-alias-border-l2);margin:0 16px;padding:4px 0 12px}
+.sgRow{border-bottom:1px solid var(--dsw-alias-border-l2);align-items:center;gap:8px;padding:16px 0;display:flex}
+.sgRow:last-child{border-bottom:0}
+.sgRowText{flex-direction:column;flex:1;gap:4px;min-width:0;padding-right:48px;display:flex}
+.sgTitle{color:var(--dsw-alias-label-primary);font-size:14px;font-weight:400;line-height:22px}
+.sgDesc{color:var(--dsw-alias-label-tertiary);font-size:12px;font-weight:400;line-height:18px}
+.sgSwitch{position:relative;width:40px;height:22px;flex:none}
+.sgSwitch>input{position:absolute;inset:0;width:100%;height:100%;opacity:0;margin:0;cursor:pointer}
+.sgSwitch>input:disabled{cursor:not-allowed}
+.sgSwitchTrack{position:absolute;inset:0;border-radius:22px;background:var(--dsw-alias-interactive-bg-hover);transition:background .16s}
+.sgSwitch>input:checked+.sgSwitchTrack{background:var(--dsw-alias-button-primary-fill)}
+.sgSwitchThumb{position:absolute;top:2px;left:2px;width:18px;height:18px;border-radius:50%;background:#fff;box-shadow:0 1px 2px rgba(0,0,0,.25);transition:transform .16s}
+.sgSwitch>input:checked~.sgSwitchThumb{transform:translateX(18px)}
+.sgReadonly{color:var(--dsw-alias-label-tertiary);font-size:12px;margin:8px 0 0}
+`
+
+/** 注入一次卡片样式。 */
+function injectCss(): void {
+  if (typeof document !== 'undefined' && document.querySelector('style[data-plugin-css="session-guard-card"]') === null) {
+    const tag = document.createElement('style')
+    tag.dataset.plugin = 'dsh-session-guard'
+    tag.dataset.pluginCss = 'session-guard-card'
+    tag.textContent = CARD_CSS
+    document.head.appendChild(tag)
+  }
+}
+
+/** 一行 pill switch（滑块开关，绑定 scope）。 */
+function SwitchRow(props: {
+  label: string
+  description?: string
+  checked: boolean
+  disabled: boolean
+  onChange: (_next: boolean) => void
+}): JSX.Element {
+  const { label, description, checked, disabled, onChange } = props
+  return (
+    <div className="sgRow">
+      <div className="sgRowText">
+        <div className="sgTitle">{label}</div>
+        {description !== undefined && <div className="sgDesc">{description}</div>}
+      </div>
+      <label className="sgSwitch">
+        <input
+          type="checkbox"
+          checked={checked}
+          disabled={disabled}
+          onChange={(e) => onChange(e.currentTarget.checked)}
+        />
+        <span className="sgSwitchTrack" />
+        <span className="sgSwitchThumb" />
+      </label>
+    </div>
+  )
+}
+
+/** 插件配置卡片主体：可展开的 <li> + header 按钮 + pill switch 字段体。 */
+export function SessionGuardCard({ scope }: SettingsCardProps): JSX.Element {
+  const snapshot = useSyncExternalStore(
+    (listener) => scope.subscribe(listener),
+    () => scope.getSnapshot(),
+  )
+  const unavailable = snapshot.status === 'unavailable'
+  const readonly = unavailable || !snapshot.writable
+  const value = (snapshot.value ?? {}) as Partial<SessionGuardConfig>
+  const [open, setOpen] = useState(false)
+
+  injectCss()
+
+  const toggle = (field: keyof SessionGuardConfig, next: boolean) => { void scope.set(field, next) }
+
+  return (
+    <li className={'sgCard' + (open ? ' sgCard-open' : '')}>
+      <button
+        type="button"
+        className="sgCardHeader"
+        aria-expanded={open}
+        onClick={() => setOpen(!open)}
+      >
+        <span className="sgCardHeadtext">
+          <span className="sgCardName">会话守护门禁</span>
+          <span className="sgCardDesc">高峰自动暂停运行会话，周末模式无视峰谷畅快跑</span>
+        </span>
+        <svg
+          className={'sgCardChevron' + (open ? ' sgCardChevron-open' : '')}
+          viewBox="0 0 14 14"
+          width={14}
+          height={14}
+          fill="none"
+          aria-hidden="true"
+        >
+          <path d="M3.5 5.5L7 9l3.5-3.5" stroke="currentColor" strokeWidth={1.5} strokeLinecap="round" strokeLinejoin="round" />
+        </svg>
+      </button>
+      {open && (
+        <div className="sgCardBody">
+          {unavailable ? (
+            <p style={{ margin: '0', padding: '12px 0', fontSize: '13px', color: 'var(--dsw-alias-label-tertiary)' }}>
+              设置命名空间不可用：请确认 dsh-session-guard 已装配进此 profile。
+            </p>
+          ) : (
+            <>
+              <SwitchRow
+                label="高峰自动暂停冻结会话"
+                description="高峰时段自动暂停运行会话"
+                checked={value.enabled ?? true}
+                disabled={readonly}
+                onChange={(next) => toggle('enabled', next)}
+              />
+              <SwitchRow
+                label="低谷自动恢复"
+                description="低峰时段自动恢复被暂停的会话"
+                checked={value.offPeakAutoResume ?? true}
+                disabled={readonly}
+                onChange={(next) => toggle('offPeakAutoResume', next)}
+              />
+              <SwitchRow
+                label="周末模式"
+                description="识别周末，无视峰谷畅快跑"
+                checked={value.weekendMode ?? true}
+                disabled={readonly}
+                onChange={(next) => toggle('weekendMode', next)}
+              />
+              <SwitchRow
+                label="回退锁队列"
+                description="无会话门时锁等待队列"
+                checked={value.queueFallback ?? true}
+                disabled={readonly}
+                onChange={(next) => toggle('queueFallback', next)}
+              />
+              <SwitchRow
+                label="自动重试"
+                description="后端重试，默认关（保守）"
+                checked={value.retryEnabled ?? false}
+                disabled={readonly}
+                onChange={(next) => toggle('retryEnabled', next)}
+              />
+              {!snapshot.writable && <p className="sgReadonly">当前只读，无法修改。</p>}
+            </>
+          )}
+        </div>
+      )}
+    </li>
+  )
+}

package/src/client/status-badge.tsx

@@ -0,0 +1,66 @@
+/**
+ * dsh-session-guard — 状态徽标（纯展示，fail-open）。
+ *
+ * 轮询 host 的 /session-guard/status（全局当前阶段），显示 高峰/谷时/周末。
+ * 仅展示，不做任何队列/会话动作；冻结按钮由 input-traffic 经桥接管（D6/D8）。
+ */
+import { useEffect, useState } from 'react'
+
+/** slot 运行时注入的会话级 props（sessionId 由 dsh 的 SessionStandardProps 提供）。 */
+export interface StatusBadgeProps {
+  sessionId?: string
+}
+
+/** /session-guard/status 返回的全局阶段。 */
+export interface Status {
+  phase: 'peak' | 'off-peak' | 'weekend'
+  enabled: boolean
+  weekendMode: boolean
+  timezone: string
+}
+
+const LABELS = {
+  peak: '高峰',
+  'off-peak': '谷时',
+  weekend: '周末',
+} as const
+
+const POLL_MS = 15_000
+
+/** 状态徽标：轮询全局阶段，显示 高峰/谷时/周末（enabled 关闭或请求失败时静默隐藏）。 */
+export function StatusBadge({ sessionId }: StatusBadgeProps) {
+  const [status, setStatus] = useState<Status | null>(null)
+
+  useEffect(() => {
+    if (!sessionId) return
+    let cancelled = false
+    const poll = async () => {
+      try {
+        const res = await fetch('/session-guard/status')
+        const body = await res.json().catch(() => null)
+        if (!cancelled && body?.ok && body.status) setStatus(body.status)
+      } catch {
+        // fail-open：路由/网络不可达 → 静默，徽标隐藏。
+      }
+    }
+    void poll()
+    const timer = setInterval(poll, POLL_MS)
+    return () => {
+      cancelled = true
+      clearInterval(timer)
+    }
+  }, [sessionId])
+
+  if (!status || !status.enabled) return null
+
+  const cls = status.phase === 'peak' ? 'sg-peak' : status.phase === 'weekend' ? 'sg-weekend' : 'sg-off'
+  return (
+    <span
+      className={`sg-status ${cls}`}
+      title={`${LABELS[status.phase]} · ${status.timezone}${status.weekendMode ? ' · 周末模式' : ''}`}
+      data-sg-phase={status.phase}
+    >
+      {LABELS[status.phase]}
+    </span>
+  )
+}

package/src/detect.js

@@ -0,0 +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')
+}

package/src/gate.js

@@ -0,0 +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),
+  }
+}