@sqdr2/dsh-fusion 0.0.0-stage → 0.3.2

package/src/client/FusionCache.tsx

@@ -0,0 +1,130 @@
+import { useEffect, useState } from 'react'
+import { tr, useLang, type Lang } from './i18n.js'
+import { FUSION_API_PATH } from '../identity.js'
+
+type Mode = 'auto' | 'on' | 'off'
+interface Totals { waits: number; waitHits: number; pings: number; pingHits: number; pingTokens: number; pingOutputTokens?: number; keptWarmTokens: number; resentTokens: number }
+interface CacheModel {
+  provider: string; model: string; role?: 'lead' | 'worker'
+  mode: Mode; intervalSeconds: number
+  modeSource: 'user' | 'pair' | 'role' | 'route' | 'family' | 'generic'
+  intervalSource: 'user' | 'learned' | 'route' | 'family' | 'generic'
+  setting: { mode?: Mode; intervalSeconds?: number }
+  defaults: { mode: Mode; intervalSeconds: number; source: string
+    family?: { label: string; lifetime: { zh: string; en: string }; discount: string; docs: string }
+    route?: { label: string; reason: { zh: string; en: string } } }
+  totals: Totals | null; learnedIntervalSeconds: number | null; suggestion: number | null
+  recent: { gapSeconds: number; ping: boolean; hit: boolean }[]
+}
+
+const tokens = (value: number) => value >= 1e6 ? `${(value / 1e6).toFixed(1)}M` : value >= 1e3 ? `${Math.round(value / 1e3)}k` : String(value)
+const minutes = (seconds: number) => seconds % 60 ? `${(seconds / 60).toFixed(1)} min` : `${seconds / 60} min`
+const modeName = (lang: Lang, mode: Mode) => ({ auto: tr(lang, '自动', 'Auto'), on: tr(lang, '开启', 'On'), off: tr(lang, '关闭', 'Off') })[mode]
+
+function modeSource(lang: Lang, row: CacheModel): string {
+  switch (row.modeSource) {
+    case 'user': return tr(lang, '你的设置', 'your setting')
+    case 'pair': return tr(lang, '旧版组合设置', 'older pair setting')
+    case 'role': return tr(lang, 'Sidekick 默认关闭（它很少长时间等待）', 'Sidekick default off (it rarely waits long)')
+    case 'route': return `${row.defaults.route!.label}: ${lang === 'zh' ? row.defaults.route!.reason.zh : row.defaults.route!.reason.en}`
+    case 'family': return tr(lang, `${row.defaults.family!.label} 官方默认`, `${row.defaults.family!.label} documented default`)
+    default: return tr(lang, '通用默认', 'generic default')
+  }
+}
+function intervalSource(lang: Lang, row: CacheModel): string {
+  if (row.intervalSource === 'user') return tr(lang, '你的设置', 'your setting')
+  if (row.intervalSource === 'learned') return tr(lang, '自动学习：保活多次未命中，已缩短', 'learned: pings kept missing, shortened')
+  return tr(lang, '默认', 'default')
+}
+
+function ModelCard({ row, onSaved }: { row: CacheModel; onSaved(): void }) {
+  const lang = useLang()
+  const [interval, setInterval] = useState(String(row.setting.intervalSeconds ? row.setting.intervalSeconds / 60 : ''))
+  const [busy, setBusy] = useState(false), [error, setError] = useState<string>()
+  const save = async (body: Record<string, unknown>) => {
+    setBusy(true); setError(undefined)
+    try {
+      const response = await fetch(FUSION_API_PATH, { method: 'POST', credentials: 'same-origin', headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ action: 'cache-setting', provider: row.provider, model: row.model, ...body }) })
+      const result = await response.json() as { error?: string }
+      if (!response.ok) throw new Error(result.error ?? tr(lang, '保存失败', 'Save failed'))
+      onSaved()
+    } catch (reason) { setError(reason instanceof Error ? reason.message : String(reason)) }
+    finally { setBusy(false) }
+  }
+  const t = row.totals
+  const family = row.defaults.family
+  return <div className="fusion-cache-model">
+    <strong>{row.model}<small>{row.provider}{row.role ? ` · ${row.role === 'lead' ? 'Lead' : 'Sidekick'}` : ''}</small></strong>
+    <p>{tr(lang, '现在', 'Now')}: <b>{modeName(lang, row.mode)}</b>{row.mode !== 'off' && <>{tr(lang, '，每 ', ', every ')}<b>{minutes(row.intervalSeconds)}</b>{tr(lang, ' 续一次', '')}</>}
+      <small>{tr(lang, '开关来源', 'Mode')}: {modeSource(lang, row)} · {tr(lang, '间隔来源', 'Interval')}: {intervalSource(lang, row)}</small></p>
+    {family && <p><small>{tr(lang, '官方文档', 'Documented')}: {lang === 'zh' ? family.lifetime.zh : family.lifetime.en}；{tr(lang, '缓存价约为全价', 'cached price ≈')} {family.discount} · <a href={family.docs} target="_blank" rel="noreferrer">{tr(lang, '来源', 'source')}</a></small></p>}
+    <div className="fusion-cache-controls">
+      <label>{tr(lang, '保活', 'Keepalive')}<select aria-label={`${row.model} keepalive`} disabled={busy} value={row.setting.mode ?? ''}
+        onChange={event => { void save({ mode: event.target.value || null, intervalSeconds: row.setting.intervalSeconds ?? null }) }}>
+        <option value="">{tr(lang, `默认（${modeName(lang, row.defaults.mode)}）`, `Default (${modeName(lang, row.defaults.mode)})`)}</option>
+        <option value="auto">{tr(lang, '自动：该模型返回过缓存命中后才开启', 'Auto: only after this model reports cache hits')}</option>
+        <option value="on">{tr(lang, '开启', 'On')}</option>
+        <option value="off">{tr(lang, '关闭（按请求次数计费的套餐选这个）', 'Off (choose for plans billed per request)')}</option>
+      </select></label>
+      <label>{tr(lang, '间隔（分钟）', 'Interval (min)')}<input type="number" min="1" max="59" step="0.5" disabled={busy} value={interval}
+        placeholder={String(+(row.intervalSeconds / 60).toFixed(2))} onChange={event => setInterval(event.target.value)}
+        onBlur={() => { if (interval !== String(row.setting.intervalSeconds ? row.setting.intervalSeconds / 60 : ''))
+          void save({ mode: row.setting.mode ?? null, intervalSeconds: interval ? Math.round(Number(interval) * 60) : null }) }} /></label>
+      <button type="button" disabled={busy || (!row.setting.mode && !row.setting.intervalSeconds)} onClick={() => { setInterval(''); void save({ reset: true }) }}>{tr(lang, '恢复默认', 'Reset')}</button>
+    </div>
+    {row.suggestion && <p role="status">{tr(lang, `观察到等待 ${minutes(row.suggestion)} 以上缓存仍然命中，可以把间隔放宽到 ${minutes(row.suggestion)}（不会自动修改）。`,
+      `Cache still hit after waits over ${minutes(row.suggestion)}; you can lengthen the interval to ${minutes(row.suggestion)} (not changed automatically).`)}</p>}
+    {t ? <p>{tr(lang, '效果', 'Effect')}: {tr(lang, `等待后命中 ${t.waitHits}/${t.waits} 次`, `hit after ${t.waitHits}/${t.waits} waits`)}{t.waits ? ` (${Math.round(100 * t.waitHits / t.waits)}%)` : ''}；
+      {tr(lang, ` 保活 ${t.pings} 次（${t.pingHits} 次命中，读取 ${tokens(t.pingTokens)} token，多为缓存价${t.pingOutputTokens != null ? `，输出 ${tokens(t.pingOutputTokens)} token` : ''}）；`, ` ${t.pings} pings (${t.pingHits} hit, ${tokens(t.pingTokens)} tokens read, mostly at cache price${t.pingOutputTokens != null ? `, ${tokens(t.pingOutputTokens)} output` : ''}); `)}
+      {tr(lang, ` 等待后仍从缓存读取 ${tokens(t.keptWarmTokens)} token，按全价重发 ${tokens(t.resentTokens)} token。`, ` after waits ${tokens(t.keptWarmTokens)} tokens served from cache, ${tokens(t.resentTokens)} resent at full price.`)}
+      {t.pings >= 5 && t.pingHits / t.pings < 0.5 && <b>{tr(lang, ' 保活大多没命中，建议关闭或缩短间隔。', ' Most pings missed: turn it off or shorten the interval.')}</b>}</p>
+      : <p>{tr(lang, '还没有数据：Lead 等待 Sidekick 之后才会产生记录。', 'No data yet: records appear after the Lead waits for the Sidekick.')}</p>}
+    {!!row.recent.length && <p><small>{tr(lang, '最近', 'Recent')}: {row.recent.map((item, i) => <span key={i}>{item.ping ? '↻' : ''}{minutes(item.gapSeconds)}{item.hit ? ' ✓' : ' ✗'}{i < row.recent.length - 1 ? ' · ' : ''}</span>)}</small></p>}
+    {error && <p role="alert">{error}</p>}
+  </div>
+}
+
+/** Per-model cache keepalive: what applies and why, the documented default, and what was observed. */
+export function FusionCache({ refresh }: { refresh: number }) {
+  const lang = useLang()
+  const [rows, setRows] = useState<CacheModel[]>(), [checked, setChecked] = useState<string>(), [error, setError] = useState<string>()
+  const [reload, setReload] = useState(0)
+  const [open, setOpen] = useState(false)
+  useEffect(() => {
+    const abort = new AbortController()
+    void fetch(`${FUSION_API_PATH}?view=cache`, { credentials: 'same-origin', cache: 'no-store', signal: abort.signal })
+      .then(async response => { if (!response.ok) throw new Error(tr(lang, '无法读取缓存设置', 'Cannot read cache settings')); return response.json() as Promise<{ checked: string; models: CacheModel[] }> })
+      .then(value => { setRows(value.models); setChecked(value.checked) })
+      .catch(reason => { if (!abort.signal.aborted) setError(String(reason)) })
+    return () => abort.abort()
+  }, [refresh, reload, lang])
+  return <details
+    className="fusion-cache"
+    aria-label={tr(lang, '缓存保活', 'Cache keepalive')}
+    data-ud-check="fusion-cache"
+    {...(open ? { open: true } : {})}
+    onToggle={event => {
+      if (!event.target || event.target === event.currentTarget) {
+        setOpen(event.currentTarget.open)
+      }
+    }}
+  >
+    <summary className="fusion-cache-summary">
+      <span className="fusion-cache-title">
+        <h3>{tr(lang, '缓存保活', 'Cache keepalive')}</h3>
+      </span>
+      <span className="fusion-cache-indicator">
+        <small>{open ? tr(lang, '点击收起', 'Collapse') : tr(lang, '点击展开', 'Expand')}</small>
+        <span className="fusion-cache-chevron" aria-hidden="true" />
+      </span>
+    </summary>
+    <div className="fusion-cache-content">
+      <p>{tr(lang, 'Lead 等 Sidekick 干活时可能要等几分钟，模型的输入缓存过期后，下一次请求会按全价重读整段对话。保活在等待期间定时把 Lead 上一次的请求原样再发一遍，末尾只加一句“Reply OK”，模型只回一个 OK，缓存就不会过期。默认值来自各家官方文档，每个模型都可以单独调整。',
+        'While the Lead waits for the Sidekick, the model\'s prompt cache can expire and the next request re-reads the whole conversation at full price. Keepalive resends the Lead\'s previous request at intervals with only “Reply OK” appended; the model answers OK and the cache stays warm. Defaults come from each provider\'s documentation; every model can be adjusted.')}</p>
+      {checked && <p><small>{tr(lang, `官方默认值核对日期：${checked}。`, `Documented defaults checked on ${checked}.`)}</small></p>}
+      {error && <p role="alert">{error}</p>}
+      {rows?.map(row => <ModelCard key={`${row.provider}/${row.model}/${row.setting.mode ?? ''}/${row.setting.intervalSeconds ?? ''}`} row={row} onSaved={() => setReload(value => value + 1)} />)}
+    </div>
+  </details>
+}

package/src/client/FusionHint.tsx

@@ -0,0 +1,39 @@
+import { tr, useLang } from './i18n.js'
+import { useEffect, useState, useSyncExternalStore } from 'react'
+import type { ModelDirectoryState } from '@deepseek-ai/dsh-client-ui-model-selection/client'
+import type { ObservableSnapshot } from '@deepseek-ai/dsh-client-store'
+import { onSettingsChanged } from './settings-events.js'
+import { FusionStatus } from './FusionStatus.js'
+import { FUSION_API_PATH, isFusionSelection } from '../identity.js'
+
+export interface FusionHintProps { sessionId: string; directory: ObservableSnapshot<ModelDirectoryState>; load(): void }
+
+/** Additive composer hint. The original selector and its selection state stay native. */
+export function FusionHint({ sessionId, directory, load }: FusionHintProps) {
+  const selected = useSyncExternalStore(directory.subscribe, directory.getSnapshot).current
+  // A session that selected Fusion before the rename stored the old route.
+  const fusion = isFusionSelection(selected ?? undefined)
+  const lang = useLang()
+  const [message, setMessage] = useState<string>()
+  useEffect(() => { load() }, [load])
+  useEffect(() => {
+    if (!fusion) { setMessage(undefined); return }
+    let active = true
+    const abort = new AbortController()
+    const refresh = () => {
+      void fetch(`${FUSION_API_PATH}?view=settings`, { credentials: 'same-origin', cache: 'no-store', signal: abort.signal })
+        .then(async response => { if (!response.ok) throw new Error('unavailable'); return response.json() as Promise<{ pair: unknown; authorized: boolean }> })
+        .then(state => { if (active) setMessage(!state.pair ? tr(lang, 'Fusion 尚未配置模型，请前往设置 → Fusion 选择 Lead 和 Sidekick。', 'Fusion has no models yet: open Settings → Fusion and choose a Lead and a Sidekick.')
+          : !state.authorized ? tr(lang, 'Fusion 当前配置未就绪，请前往设置 → Fusion 查看。', 'The Fusion setup is not ready: see Settings → Fusion.') : undefined) })
+        .catch(() => { if (active) setMessage(tr(lang, '暂时无法确认 Fusion 配置，请前往设置 → Fusion 查看。', 'Cannot confirm the Fusion setup right now: see Settings → Fusion.')) })
+    }
+    refresh()
+    const off = onSettingsChanged(refresh)
+    return () => { active = false; abort.abort(); off() }
+  }, [fusion, lang])
+  if (!fusion) return null
+  return <>
+    {message && <p role="status" style={{ margin: '8px 12px', color: 'var(--dsw-alias-label-secondary)', fontSize: 12, lineHeight: '18px' }}>{message}</p>}
+    <FusionStatus sessionId={sessionId} attentionOnly />
+  </>
+}

package/src/client/FusionHistory.tsx

@@ -0,0 +1,247 @@
+import { useEffect, useState } from 'react'
+import type { HistoryView, HistoryTotals } from '../host/history.js'
+import { tr, useLang, type Lang } from './i18n.js'
+import { FUSION_API_PATH } from '../identity.js'
+
+export function formatCompact(tokens: number): string {
+  if (tokens < 1000) return `${tokens}`
+  if (tokens < 1_000_000) {
+    const k = tokens / 1000
+    return `${k >= 100 ? Math.round(k) : Number(k.toFixed(1))}K`
+  }
+  const m = tokens / 1_000_000
+  return `${m >= 100 ? Math.round(m) : Number(m.toFixed(m >= 10 ? 1 : 2))}M`
+}
+
+export function outputTokens(lang: Lang, usage: HistoryTotals, calls: number): string {
+  if (!calls) return '—'
+  const total = usage.totalOutput
+  const hasTotal = Boolean(total && total.reported > 0)
+  const hasVisible = Boolean(usage.output && usage.output.reported > 0)
+  const hasReasoning = Boolean(usage.reasoning && usage.reasoning.reported > 0)
+
+  if (!hasTotal) {
+    if (hasVisible) {
+      const vis = formatCompact(usage.output.known)
+      const cov = usage.output.reported < calls ? tr(lang, `（${usage.output.reported}/${calls} 次有报告）`, ` (${usage.output.reported}/${calls} reported)`) : ''
+      return `${tr(lang, `至少 ${vis}，推理未提供`, `at least ${vis}, reasoning unavailable`)}${cov}`
+    }
+    return tr(lang, '未提供', 'not reported')
+  }
+
+  const totalStr = formatCompact(total!.known)
+  const visibleStr = hasVisible ? formatCompact(usage.output.known) : tr(lang, '未提供', 'not reported')
+  const reasoningStr = hasReasoning ? formatCompact(usage.reasoning!.known) : tr(lang, '未提供', 'not reported')
+  const coverageStr = total!.reported < calls ? tr(lang, `（${total!.reported}/${calls} 次有报告）`, ` (${total!.reported}/${calls} reported)`) : ''
+  const splitStr = tr(lang, `（可见 ${visibleStr} + 推理 ${reasoningStr}）`, ` (visible ${visibleStr} + reasoning ${reasoningStr})`)
+  return `${totalStr} ${splitStr}${coverageStr}`
+}
+
+const takeoverReason = (lang: Lang, reason: string) => ({
+  'checks-still-failing': tr(lang, '返工后检查仍失败', 'checks still failing after rework'),
+  'worker-step-limit': tr(lang, 'Sidekick 步数用尽', 'Sidekick step limit'),
+  'worker-stalled': tr(lang, 'Sidekick 反复停滞', 'Sidekick stalled repeatedly'),
+} as Record<string, string>)[reason] ?? reason
+const tokens = (lang: Lang, field: HistoryTotals['input'], calls: number) => !calls ? '—' : !field.reported ? tr(lang, '未提供', 'not reported')
+  : `${formatCompact(field.known)} (${field.known.toLocaleString()})${field.reported < calls ? tr(lang, `（${field.reported}/${calls} 次有报告）`, ` (${field.reported}/${calls} reported)`) : ''}`
+const purpose = (lang: Lang, value: string) => ({ conversation: tr(lang, '任务', 'task'), compaction: tr(lang, '压缩', 'compaction'),
+  'cache-keepalive': tr(lang, '保活', 'keepalive'), 'session-title': tr(lang, '标题', 'title') } as Record<string, string>)[value] ?? value
+/** What still holds the task, so a refusal says why instead of only that it refused. */
+const blockerText = (lang: Lang, blocker?: string) => ({
+  agent: tr(lang, 'Lead 或 Sidekick 仍在运行', 'its Lead or Sidekick is still running'),
+  tool: tr(lang, '有原生工具调用尚未返回', 'a native tool call has not returned'),
+  job: tr(lang, '有后台任务尚未停止', 'a background job has not stopped'),
+  lease: tr(lang, '仍持有工作区写入租约', 'it still holds the workspace write lease'),
+  'foreign-process': tr(lang, '另一个 Host 进程仍在处理它', 'another Host process is still working on it'),
+} as Record<string, string>)[blocker ?? ''] ?? tr(lang, '仍有活动写入方', 'something is still writing to it')
+
+export function FusionHistory() {
+  const lang = useLang()
+  const [page, setPage] = useState<HistoryView>()
+  const [cursor, setCursor] = useState('')
+  const [error, setError] = useState('')
+  const [refresh, setRefresh] = useState(0)
+  const [loading, setLoading] = useState(false)
+  const [confirmingId, setConfirmingId] = useState<string | null>(null)
+  const [deletingId, setDeletingId] = useState<string | null>(null)
+  const [rowError, setRowError] = useState<{ id: string; message: string } | null>(null)
+  const [open, setOpen] = useState(false)
+  const [tasksOpen, setTasksOpen] = useState(false)
+
+  useEffect(() => {
+    const abort = new AbortController()
+    setLoading(true); setError('')
+    void fetch(`${FUSION_API_PATH}?view=history&cursor=${encodeURIComponent(cursor)}`, { credentials: 'same-origin', cache: 'no-store', signal: abort.signal })
+      .then(async response => {
+        if (!response.ok) {
+          const body = await response.json().catch(() => null) as { error?: string } | null
+          if (cursor && (response.status === 409 || body?.error?.includes('cursor') || body?.error?.includes('Cursor'))) {
+            setCursor('')
+            return
+          }
+          throw new Error(body?.error || tr(lang, '历史记录暂时无法读取', 'History is unavailable right now'))
+        }
+        return response.json() as Promise<HistoryView>
+      })
+      .then(data => { if (data) setPage(data) })
+      .catch(error => { if (!abort.signal.aborted) setError(String(error)) })
+      .finally(() => { if (!abort.signal.aborted) setLoading(false) })
+    return () => abort.abort()
+  }, [cursor, refresh, lang])
+
+  const handleDelete = async (taskId: string) => {
+    setDeletingId(taskId)
+    setRowError(null)
+    setError('')
+    try {
+      const res = await fetch(`${FUSION_API_PATH}?taskId=${encodeURIComponent(taskId)}`, {
+        method: 'DELETE',
+        credentials: 'same-origin',
+      })
+      if (!res.ok) {
+        const data = await res.json().catch(() => null) as { error?: string; blocker?: string } | null
+        const raw = data?.error || ''
+        const msg = raw === 'Cannot delete a running task'
+          ? tr(lang, `当前任务仍在运行或尚未安全终止，无法清除：${blockerText(lang, data?.blocker)}`,
+              `Cannot delete while it still runs: ${blockerText(lang, data?.blocker)}`)
+          : (raw || tr(lang, '清除任务失败', 'Failed to delete task'))
+        throw new Error(msg)
+      }
+      setPage(prev => prev ? {
+        ...prev,
+        totalTasks: Math.max(0, prev.totalTasks - 1),
+        tasks: prev.tasks.filter(task => task.id !== taskId),
+      } : prev)
+      setConfirmingId(null)
+      setRowError(null)
+      if (cursor === taskId) setCursor('')
+      setRefresh(v => v + 1)
+    } catch (err) {
+      setRowError({ id: taskId, message: err instanceof Error ? err.message : String(err) })
+    } finally {
+      setDeletingId(null)
+    }
+  }
+
+  return <details
+    className="fusion-history"
+    aria-label={tr(lang, 'Fusion 历史与统计', 'Fusion history and statistics')}
+    data-ud-check="fusion-history"
+    {...(open ? { open: true } : {})}
+    onToggle={event => {
+      if (!event.target || event.target === event.currentTarget) {
+        setOpen(event.currentTarget.open)
+      }
+    }}
+  >
+    <summary className="fusion-history-summary">
+      <span className="fusion-history-title">
+        <h3>{tr(lang, '历史与统计', 'History and statistics')}</h3>
+      </span>
+      <span className="fusion-history-indicator">
+        <small>{open ? tr(lang, '点击收起', 'Collapse') : tr(lang, '点击展开', 'Expand')}</small>
+        <span className="fusion-history-chevron" aria-hidden="true" />
+      </span>
+    </summary>
+    <div className="fusion-history-content">
+      <div className="fusion-history-header">
+        <p>{tr(lang, '按实际模型请求汇总，包含任务、压缩、保活及已有标题请求。未报告的用量不算作 0；金额与节省率尚无可靠数据。',
+          'Totals of actual model requests: tasks, compaction, keepalive and title requests. Unreported usage is not counted as 0; no reliable billed amount or saving rate is available.')}</p>
+        <button disabled={loading} onClick={() => setRefresh(value => value + 1)}>{tr(lang, '刷新记录', 'Refresh')}</button>
+      </div>
+    {error && <p role="alert">{error}</p>}{loading && !page && <p role="status">{tr(lang, '正在读取记录…', 'Loading…')}</p>}
+    {page && <>
+      <div className="fusion-history-panel fusion-history-usage" aria-label={tr(lang, '用量统计', 'Usage statistics')}>
+        <h3>{tr(lang, '用量统计', 'Usage statistics')}</h3>
+        <p>{tr(lang, `${page.totalTasks} 项任务 · ${page.totals.calls} 次原生请求 · ${page.totals.final} 次用量定稿 · ${page.totals.provisional} 次暂报 · ${page.totals.unreported} 次未提供`,
+          `${page.totalTasks} tasks · ${page.totals.calls} native requests · ${page.totals.final} final usage · ${page.totals.provisional} provisional · ${page.totals.unreported} unreported`)}</p>
+        <p>{tr(lang, '未缓存输入', 'Uncached input')} {tokens(lang, page.totals.input, page.totals.calls)} · {tr(lang, '缓存读取', 'cache read')} {tokens(lang, page.totals.cacheRead, page.totals.calls)} · {tr(lang, '总输出', 'Total output')} {outputTokens(lang, page.totals, page.totals.calls)} Token</p>
+        <p>{tr(lang, `Lead 接手改代码 ${page.takeovers?.total ?? 0} 次（${page.takeovers?.tasks ?? 0} 项任务）`, `Lead takeovers: ${page.takeovers?.total ?? 0} (${page.takeovers?.tasks ?? 0} tasks)`)}
+          {page.takeovers?.total ? `: ${Object.entries(page.takeovers.reasons).map(([reason, count]) => `${takeoverReason(lang, reason)} ${count}`).join(', ')}` : ''}
+          {tr(lang, '。只有 Sidekick 确实完成不了时，程序才会解锁接手。', '. The Host unlocks a takeover only when the Sidekick demonstrably cannot finish.')}</p>
+        <div style={{ overflowX: 'auto' }} tabIndex={0} aria-label={tr(lang, '按实际模型统计', 'By actual model')}>
+          <table><caption>{tr(lang, '按角色、实际模型和请求用途', 'By role, actual model and purpose')}</caption><thead><tr>
+            <th scope="col">{tr(lang, '角色 / 模型', 'Role / model')}</th><th scope="col">{tr(lang, '用途', 'Purpose')}</th><th scope="col">{tr(lang, '请求', 'Requests')}</th><th scope="col">{tr(lang, '总输出 Token（可见 / 推理）', 'Total output tokens (visible / reasoning)')}</th></tr></thead>
+            <tbody>{page.groups.map(group => <tr key={JSON.stringify([group.role, group.provider, group.model, group.purpose])}>
+              <th scope="row">{group.role === 'lead' ? 'Lead' : 'Sidekick'} · {group.model}<small>{group.provider}</small></th>
+              <td>{purpose(lang, group.purpose)}</td><td>{group.calls}</td><td>{outputTokens(lang, group, group.calls)}</td>
+            </tr>)}</tbody>
+          </table>
+        </div>
+        <p><small>{tr(lang, `更新于 ${new Date(page.observedAt).toLocaleString()}。供应商内部重试次数未知。`, `Updated ${new Date(page.observedAt).toLocaleString()}. Provider-internal retries are unknown.`)}</small></p>
+      </div>
+      <details
+        className="fusion-history-panel fusion-history-tasks"
+        {...(tasksOpen ? { open: true } : {})}
+        onToggle={event => setTasksOpen(event.currentTarget.open)}
+      >
+        <summary className="fusion-history-tasks-summary">
+          <span className="fusion-history-tasks-title">
+            <strong>{tr(lang, '任务记录', 'Tasks')}</strong>{' '}
+            <span className="fusion-history-count">({page.totalTasks})</span>
+          </span>
+          <span className="fusion-history-tasks-indicator">
+            <small>{tasksOpen ? tr(lang, '点击收起', 'Collapse') : tr(lang, '点击展开', 'Expand')}</small>
+            <span className="fusion-history-tasks-chevron" aria-hidden="true" />
+          </span>
+        </summary>
+        <div className="fusion-history-tasks-content">
+          {!page.tasks.length && <p>{tr(lang, '还没有 Fusion 任务。', 'No Fusion tasks yet.')}</p>}
+          <ol>{page.tasks.map(task => <li key={task.id}>
+            <div className="fusion-history-item-header">
+              <div>
+                <strong>{task.title}</strong>
+                <small>
+                  {new Date(task.createdAt).toLocaleString()} · {task.mode === 'completed' ? tr(lang, '已结束', 'finished') : task.phase} · {tr(lang, `${task.usage.calls} 次请求`, `${task.usage.calls} requests`)}{task.takeovers ? tr(lang, ` · Lead 接手 ${task.takeovers} 次`, ` · ${task.takeovers} Lead takeovers`) : ''}
+                </small>
+              </div>
+              <div className="fusion-history-actions">
+                {confirmingId === task.id ? (
+                  <>
+                    <span className="fusion-history-confirm-text">{tr(lang, '确定清除？', 'Delete?')}</span>
+                    <button
+                      type="button"
+                      disabled={Boolean(deletingId)}
+                      onClick={() => void handleDelete(task.id)}
+                    >
+                      {deletingId === task.id ? tr(lang, '正在清除…', 'Deleting…') : tr(lang, '确认', 'Confirm')}
+                    </button>
+                    <button
+                      type="button"
+                      className="fusion-btn-subtle"
+                      disabled={Boolean(deletingId)}
+                      onClick={() => { setConfirmingId(null); setRowError(null) }}
+                    >
+                      {tr(lang, '取消', 'Cancel')}
+                    </button>
+                  </>
+                ) : (
+                  <button
+                    type="button"
+                    disabled={Boolean(deletingId)}
+                    onClick={() => { setError(''); setRowError(null); setConfirmingId(task.id) }}
+                    aria-label={tr(lang, `清除任务 ${task.title}`, `Delete task ${task.title}`)}
+                  >
+                    {tr(lang, '清除记录', 'Clear')}
+                  </button>
+                )}
+              </div>
+            </div>
+            {rowError?.id === task.id && (
+              <p role="alert" className="fusion-history-row-error" style={{ color: 'var(--dsw-alias-state-error-primary, #e5484d)', margin: '6px 0 0', fontSize: '12px' }}>
+                {rowError.message}
+              </p>
+            )}
+            <details><summary>{tr(lang, '记录详情', 'Details')}</summary><p>{tr(lang, '任务', 'Task')}: {task.id}</p><p>{tr(lang, '会话', 'Session')}: {task.sessionId}</p>
+              <p>{tr(lang, `验证状态：${task.verification}。历史运行状态不代表当前仍在执行。`, `Verification: ${task.verification}. A recorded state does not mean it is still running.`)}</p>
+              <p>{tr(lang, '输入', 'Input')} {tokens(lang, task.usage.input, task.usage.calls)} · {tr(lang, '缓存读取', 'cache read')} {tokens(lang, task.usage.cacheRead, task.usage.calls)} · {tr(lang, '总输出', 'Total output')} {outputTokens(lang, task.usage, task.usage.calls)} Token</p>
+            </details>
+          </li>)}</ol>
+          <div className="fusion-actions"><button disabled={loading || !cursor} onClick={() => setCursor('')}>{tr(lang, '最新记录', 'Newest')}</button>
+            <button disabled={loading || !page.nextCursor} onClick={() => setCursor(page.nextCursor!)}>{tr(lang, '更早记录', 'Older')}</button></div>
+        </div>
+      </details>
+    </>}
+    </div>
+  </details>
+}

package/src/client/FusionPanelIcon.tsx

@@ -0,0 +1,39 @@
+import type { ReactNode } from 'react'
+
+export interface FusionPanelIconProps {
+  /** Square size in pixels requested by the host sidebar (defaults to 16). */
+  size?: number
+  /** Whether the panel is currently active/selected in the main column. */
+  active?: boolean
+  className?: string
+}
+
+/**
+ * Compact, accessible icon for the Fusion sidebar entry.
+ * Renders a dual-node convergence (Lead + Sidekick models fusing into one) SVG glyph.
+ */
+export function FusionPanelIcon({ size = 16, active = false, className }: FusionPanelIconProps): ReactNode {
+  return (
+    <svg
+      role="img"
+      aria-label="Fusion"
+      aria-hidden="true"
+      focusable="false"
+      viewBox="0 0 16 16"
+      width={size}
+      height={size}
+      fill="none"
+      stroke="currentColor"
+      strokeWidth={active ? 1.5 : 1.2}
+      strokeLinecap="round"
+      strokeLinejoin="round"
+      className={className}
+    >
+      <circle cx="4" cy="4.5" r="2" />
+      <circle cx="4" cy="11.5" r="2" />
+      <circle cx="12" cy="8" r="2" />
+      <path d="M6 4.5h1.5a3 3 0 0 1 2.7 1.7L10.5 6.8" />
+      <path d="M6 11.5h1.5a3 3 0 0 0 2.7-1.7l.3-.6" />
+    </svg>
+  )
+}

package/src/client/FusionRecovery.tsx

@@ -0,0 +1,69 @@
+import { useState } from 'react'
+import { tr, useLang } from './i18n.js'
+import type { FusionStatus } from '../status.js'
+import type { PhysicalRoute } from '../contracts.js'
+import type { SettingsCatalog } from '../host/settings.js'
+import { ModelChoice } from './FusionSettings.js'
+import { FUSION_API_PATH, isFusionProvider } from '../identity.js'
+
+export function FusionRecovery({ sessionId, task }: { sessionId: string; task: NonNullable<FusionStatus['task']> }) {
+  const lang = useLang()
+  const control = task.modelControl!
+  const [role, setRole] = useState<'lead' | 'worker'>('lead')
+  const [route, setRoute] = useState<PhysicalRoute>()
+  const [catalog, setCatalog] = useState<SettingsCatalog>()
+  const [dueAt, setDueAt] = useState('')
+  const [busy, setBusy] = useState(false)
+  const [notice, setNotice] = useState('')
+  const [error, setError] = useState('')
+  const action = async (name: string) => {
+    setBusy(true); setError(''); setNotice('')
+    try {
+      const response = await fetch(FUSION_API_PATH, { method: 'POST', credentials: 'same-origin',
+        headers: { 'content-type': 'application/json' }, body: JSON.stringify({ action: name, sessionId, taskId: task.id,
+          revision: control.revision, role, route, ...(dueAt ? { dueAt: new Date(dueAt).toISOString() } : {}) }) })
+      const result = await response.json() as { error?: string }
+      if (!response.ok) throw new Error(result.error ?? tr(lang, '操作未完成，请刷新状态', 'Not completed; refresh the status'))
+      setNotice(name === 'schedule' ? tr(lang, '已设置一次定时继续。Host 需要运行；新消息会取消安排。', 'One scheduled continuation is set. The Host must be running; a new message cancels it.') : name === 'cancel-schedule' ? tr(lang, '已取消定时继续。', 'Scheduled continuation cancelled.') : tr(lang, '已提交继续操作，状态将自动更新。', 'Continuation submitted; the status updates automatically.'))
+    } catch (error) { setError(error instanceof Error ? error.message : String(error)) }
+    finally { setBusy(false) }
+  }
+  const loadCatalog = async () => {
+    setError('')
+    try {
+      const response = await fetch(`${FUSION_API_PATH}?view=catalog`, { credentials: 'same-origin', cache: 'no-store' })
+      if (!response.ok) throw new Error(tr(lang, '无法读取模型列表', 'Cannot read the model list'))
+      const value = await response.json() as SettingsCatalog
+      setCatalog({ ...value, groups: value.groups.filter(group => !isFusionProvider(group.id)) })
+    } catch (error) { setError(String(error)) }
+  }
+  return <section className="fusion-recovery" aria-label={tr(lang, 'Fusion 恢复操作', 'Fusion recovery')}>
+    <h3>{tr(lang, '继续当前任务', 'Continue this task')}</h3>
+    {Object.entries(control.waits).filter(([, wait]) => wait?.taskId === task.id).map(([key, wait]) => <p key={key}>
+      {key === 'lead' ? 'Lead' : 'Sidekick'} · {wait!.code} · {wait!.code === 'NO_PROGRESS' ? tr(lang, '重复操作没有进展，请调整做法', 'Repeated steps made no progress; change the approach') : wait!.code === 'WORKFLOW_INCOMPLETE' ? tr(lang, '报告、委派或审查尚未完成，请检查任务后继续', 'A report, handoff or review is unfinished; check the task, then continue') : wait!.code.includes('QUOTA') ? tr(lang, '额度重置时间未知', 'Quota reset time unknown') : tr(lang, '需要处理模型错误', 'A model error needs attention')}
+      {wait!.retryNotBefore && <small>{tr(lang, '服务商建议重试时间', 'Provider retry hint')}: {new Date(wait!.retryNotBefore).toLocaleString()} {tr(lang, '（不代表额度重置）', '(not a quota reset)')}</small>}
+    </p>)}
+    {control.schedule && <p role="status">{tr(lang, '定时继续', 'Scheduled continuation')}: {new Date(control.schedule.dueAt).toLocaleString()} · {
+      ({ scheduled: tr(lang, '已安排', 'scheduled'), cancelled: tr(lang, '已取消', 'cancelled'), fired: tr(lang, '已执行一次', 'ran once'), failed: tr(lang, '未能执行', 'failed') })[control.schedule.state]}{control.schedule.reason ? ` · ${control.schedule.reason}` : ''}</p>}
+    {control.operation && ['prepared', 'dispatching'].includes(control.operation.state) && <p role="alert">{tr(lang, '上次继续操作的投递结果尚未确认。请检查会话；系统不会自动重发。', 'Delivery of the last continuation is unconfirmed. Check the conversation; nothing is resent automatically.')}</p>}
+    {(task.recovering || task.outcomeUnknown) && <p role="alert">{tr(lang, '中断的操作尚未核对。继续和更换模型都不会生效，本次也不会切换模型。请先用 /fusion recover <检查记录> 提交核对，再继续或更换 Sidekick。设置里保存的新组合不会改写这个会话。', 'Interrupted operations are not inspected yet. Continue and model switching do nothing, and this attempt does not change the model. Record the inspection with /fusion recover <note>, then continue or switch the Sidekick. A new pair saved in Settings does not rewrite this conversation.')}</p>}
+    {error && <p role="alert">{error}</p>}{notice && <p role="status">{notice}</p>}
+    <fieldset disabled={busy || task.unsettledTools > 0 || task.pendingApprovals > 0 || task.recovering || task.outcomeUnknown}>
+      <button onClick={() => { void action('continue') }}>{tr(lang, '继续一次', 'Continue once')}</button>
+      <details><summary onClick={() => { if (!catalog) void loadCatalog() }}>{tr(lang, '更换角色模型并继续', 'Switch a role model and continue')}</summary>
+        <label>{tr(lang, '角色', 'Role')} <select value={role} onChange={event => { setRole(event.target.value as 'lead' | 'worker'); setRoute(undefined) }}>
+          <option value="lead">Lead</option><option value="worker">Sidekick</option>
+        </select></label>
+        {catalog && <ModelChoice role={role === 'lead' ? 'Lead' : 'Sidekick'} route={route} catalog={catalog} onChange={setRoute} />}
+        <p>{tr(lang, '仅更换当前会话的角色模型，保留任务与 Sidekick 会话。后续请求使用新模型的账号。', 'Changes this conversation\'s role model only; the task and the Sidekick session are kept. Later requests use the new model\'s account.')}</p>
+        <button disabled={!route} onClick={() => { void action('switch-role') }}>{tr(lang, '更换并继续一次', 'Switch and continue once')}</button>
+      </details>
+      <details><summary>{tr(lang, '定时继续一次', 'Continue once at a time')}</summary>
+        <label>{tr(lang, '本地时间', 'Local time')} <input aria-label={tr(lang, '定时继续时间', 'Continuation time')} type="datetime-local" value={dueAt} onChange={event => setDueAt(event.target.value)} /></label>
+        <p>{tr(lang, '按你选择的时间尝试一次；再次遇到额度错误会停止。此时间不代表服务商承诺的恢复时间。', 'Tries once at the time you choose and stops on another quota error. It is not a provider-promised reset time.')}</p>
+        <button disabled={!dueAt} onClick={() => { void action('schedule') }}>{tr(lang, '设置时间', 'Set time')}</button>
+        {control.schedule?.state === 'scheduled' && <button onClick={() => { void action('cancel-schedule') }}>{tr(lang, '取消安排', 'Cancel')}</button>}
+      </details>
+    </fieldset>
+  </section>
+}