@sqdr2/dsh-fusion 0.0.0-stage → 0.3.2

package/src/client/FusionSettings.tsx

@@ -0,0 +1,205 @@
+import { FusionHistory } from './FusionHistory.js'
+import { FusionCache } from './FusionCache.js'
+import { useEffect, useState } from 'react'
+import type { PhysicalRoute } from '../contracts.js'
+import type { PairChoice, SettingsCatalog } from '../host/settings.js'
+import { settingsChanged } from './settings-events.js'
+import { tr, useLang } from './i18n.js'
+import { FUSION_API_PATH } from '../identity.js'
+
+interface SettingsState {
+  revision: number
+  catalog: SettingsCatalog
+  pair: PairChoice | null
+  authorized: boolean
+  managedAuthorization?: boolean
+  reason?: string
+}
+const styles = `
+.fusion-page{box-sizing:border-box;width:100%;height:100%;min-width:0;min-height:0;flex:1 1 auto;overflow:auto;display:flex;flex-direction:column;align-items:center;scrollbar-gutter:stable;padding:0 clamp(24px,4vw,48px) 48px;--dsh-scrollbar-width:9px;--dsh-scrollbar-thumb-border:2px}
+.fusion-settings{box-sizing:border-box;width:100%;max-width:680px;margin:0 auto;color:var(--dsw-alias-label-primary);display:flex;flex-direction:column;gap:18px}
+.fusion-settings h2{margin:0;font-size:22px;line-height:30px;font-weight:600}
+.fusion-settings p{margin:0;font-size:13px;line-height:21px;color:var(--dsw-alias-label-secondary)}
+.fusion-settings header{display:flex;flex-direction:column;gap:8px;padding-top:28px}
+[data-platform='darwin'] .fusion-settings header{padding-top:calc(28px + var(--dsh-frame-top-clearance,0px))}
+.fusion-settings .fusion-card{padding:20px;border:1px solid var(--dsw-alias-border-l2);border-radius:12px;display:flex;flex-direction:column;gap:20px;background:var(--dsw-alias-bg-module-platform)}
+.fusion-settings fieldset{padding:0;margin:0;border:0;min-inline-size:0;display:flex;flex-direction:column;gap:10px}
+.fusion-settings legend{font-size:15px;font-weight:600;padding:0 0 4px}
+.fusion-settings label{display:grid;grid-template-columns:85px minmax(0,1fr);align-items:center;gap:12px;font-size:13px}
+.fusion-settings :is(select,option,optgroup){background-color:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);color-scheme:inherit}
+.fusion-settings select{box-sizing:border-box;min-width:0;width:100%;min-height:36px;border:1px solid var(--dsw-alias-border-l2);border-radius:7px;padding:5px 9px;font:inherit}
+.fusion-settings .fusion-actions{display:flex;align-items:center;justify-content:space-between;gap:12px;flex-wrap:wrap}
+.fusion-settings button{border:1px solid var(--dsw-alias-border-l2);border-radius:18px;background:var(--dsw-alias-button-primary-fill,var(--dsw-alias-brand-primary));color:var(--dsw-alias-label-primary-foreground,#fff);padding:7px 18px;font:inherit;font-size:13px;cursor:pointer}
+.fusion-settings button:disabled{opacity:.5;cursor:default}
+.fusion-settings :is(button,select):focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:2px}
+.fusion-settings [role=alert]{color:var(--dsw-alias-state-error-primary);overflow-wrap:anywhere}
+.fusion-settings details{font-size:13px;line-height:21px}
+.fusion-settings summary{cursor:pointer;font-weight:500}
+.fusion-settings .fusion-limits{display:flex;flex-direction:column;gap:12px;padding-top:14px}
+.fusion-settings input[type=number]{min-width:0;width:100%;box-sizing:border-box;background-color:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);border:1px solid var(--dsw-alias-border-l2);border-radius:7px;padding:8px;font:inherit}
+.fusion-settings .fusion-consent{display:flex;align-items:flex-start;gap:8px;font-size:12px;line-height:18px}
+.fusion-cache{box-sizing:border-box;width:100%;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-module-platform);padding:16px;display:flex;flex-direction:column;gap:12px}
+.fusion-cache h3{margin:0}
+.fusion-cache-summary{cursor:pointer;font-weight:600;font-size:14px;display:flex;align-items:center;justify-content:space-between;list-style:none;user-select:none;padding:2px 0}
+.fusion-cache-summary::-webkit-details-marker{display:none}
+.fusion-cache-summary:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:2px;border-radius:4px}
+.fusion-cache-title{display:inline-flex;align-items:center;gap:6px}
+.fusion-cache-title h3{margin:0;font-size:15px;font-weight:600}
+.fusion-cache-indicator{display:inline-flex;align-items:center;gap:6px;font-size:12px;font-weight:400;color:var(--dsw-alias-label-secondary)}
+.fusion-cache-chevron{display:inline-block;width:7px;height:7px;border-right:2px solid var(--dsw-alias-label-secondary);border-bottom:2px solid var(--dsw-alias-label-secondary);transform:rotate(-45deg);transition:transform .15s ease;margin-left:2px}
+.fusion-cache[open] .fusion-cache-chevron{transform:rotate(45deg)}
+.fusion-cache-content{display:flex;flex-direction:column;gap:12px;padding-top:12px;border-top:1px solid var(--dsw-alias-border-l2);margin-top:4px}
+.fusion-cache-model{display:flex;flex-direction:column;gap:8px;padding:14px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px}
+.fusion-cache-model small{display:block;color:var(--dsw-alias-label-secondary);overflow-wrap:anywhere}
+.fusion-cache-controls{display:grid;grid-template-columns:minmax(0,2fr) minmax(0,1fr) auto;gap:10px;align-items:end}
+.fusion-cache-controls label{grid-template-columns:1fr;gap:4px}
+.fusion-cache a{color:var(--dsw-alias-brand-primary)}
+@media(max-width:560px){.fusion-cache-controls{grid-template-columns:1fr}}
+.fusion-history{box-sizing:border-box;width:100%;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-module-platform);padding:16px;display:flex;flex-direction:column;gap:12px}
+.fusion-history-summary{cursor:pointer;font-weight:600;font-size:14px;display:flex;align-items:center;justify-content:space-between;list-style:none;user-select:none;padding:2px 0}
+.fusion-history-summary::-webkit-details-marker{display:none}
+.fusion-history-summary:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:2px;border-radius:4px}
+.fusion-history-title{display:inline-flex;align-items:center;gap:6px}
+.fusion-history-title h3{margin:0;font-size:15px;font-weight:600}
+.fusion-history-indicator{display:inline-flex;align-items:center;gap:6px;font-size:12px;font-weight:400;color:var(--dsw-alias-label-secondary)}
+.fusion-history-chevron{display:inline-block;width:7px;height:7px;border-right:2px solid var(--dsw-alias-label-secondary);border-bottom:2px solid var(--dsw-alias-label-secondary);transform:rotate(-45deg);transition:transform .15s ease;margin-left:2px}
+.fusion-history[open] .fusion-history-chevron{transform:rotate(45deg)}
+.fusion-history-content{display:flex;flex-direction:column;gap:12px;padding-top:12px;border-top:1px solid var(--dsw-alias-border-l2);margin-top:4px}
+.fusion-history-header{display:flex;align-items:flex-start;justify-content:space-between;gap:12px;flex-wrap:wrap}
+.fusion-history-panel{box-sizing:border-box;width:100%;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-module-platform);padding:16px;display:flex;flex-direction:column;gap:12px}
+.fusion-history-usage h3{margin:0;font-size:14px;font-weight:600}
+.fusion-history table{width:100%;border-collapse:collapse;font-size:12px;text-align:left}
+.fusion-history :is(th,td){padding:8px;border-bottom:1px solid var(--dsw-alias-border-l2);font-weight:400;vertical-align:top}
+.fusion-history caption{text-align:left;font-size:13px;margin-bottom:8px}
+.fusion-history small{display:block;color:var(--dsw-alias-label-secondary);overflow-wrap:anywhere}
+.fusion-history ol{padding-left:20px;margin:0}
+.fusion-history li{padding:10px 0;border-bottom:1px solid var(--dsw-alias-border-l2)}
+.fusion-history li:last-child{border-bottom:0}
+.fusion-history h3{margin:0;font-size:14px;font-weight:600}
+.fusion-history p{overflow-wrap:anywhere}
+.fusion-history-tasks-summary{cursor:pointer;font-weight:600;font-size:14px;display:flex;align-items:center;justify-content:space-between;list-style:none;user-select:none;padding:2px 0}
+.fusion-history-tasks-summary::-webkit-details-marker{display:none}
+.fusion-history-tasks-summary:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:2px;border-radius:4px}
+.fusion-history-tasks-title{display:inline-flex;align-items:center;gap:6px}
+.fusion-history-count{font-size:13px;font-weight:400;color:var(--dsw-alias-label-secondary)}
+.fusion-history-tasks-indicator{display:inline-flex;align-items:center;gap:6px;font-size:12px;font-weight:400;color:var(--dsw-alias-label-secondary)}
+.fusion-history-tasks-chevron{display:inline-block;width:7px;height:7px;border-right:2px solid var(--dsw-alias-label-secondary);border-bottom:2px solid var(--dsw-alias-label-secondary);transform:rotate(-45deg);transition:transform .15s ease;margin-left:2px}
+.fusion-history-tasks[open] .fusion-history-tasks-chevron{transform:rotate(45deg)}
+.fusion-history-tasks-content{display:flex;flex-direction:column;gap:12px;padding-top:12px;border-top:1px solid var(--dsw-alias-border-l2);margin-top:4px}
+.fusion-history-item-header{display:flex;align-items:center;justify-content:space-between;gap:12px}
+.fusion-history-item-header h3{margin:0;font-size:14px;font-weight:600}
+.fusion-history-actions{display:flex;align-items:center;gap:8px;flex-shrink:0}
+.fusion-history-actions button{padding:3px 12px;font-size:12px;border-radius:14px}
+.fusion-history-actions button.fusion-btn-subtle{background:transparent;color:var(--dsw-alias-label-primary)}
+.fusion-history-confirm-text{font-size:12px;color:var(--dsw-alias-label-secondary)}
+@media(max-width:480px){.fusion-page{padding:0 16px 32px}.fusion-settings label{grid-template-columns:1fr;gap:6px}.fusion-settings .fusion-card{padding:16px}}
+`
+
+const key = (route: PhysicalRoute | undefined) => route ? JSON.stringify([route.provider, route.model]) : ''
+
+export function ModelChoice({ role, route, catalog, onChange }: {
+  role: 'Lead' | 'Sidekick' | 'compactor'; route?: PhysicalRoute; catalog: SettingsCatalog; onChange(route: PhysicalRoute | undefined): void
+}) {
+  const lang = useLang()
+  const name = role === 'compactor' ? tr(lang, '压缩', 'Compaction') : role
+  const model = catalog.groups.find(group => group.id === route?.provider)?.models.find(model => model.id === route?.model)
+  return <fieldset>
+    <legend>{name}</legend>
+    <p>{role === 'Lead' ? tr(lang, '回答问题、制定方案并审查结果。', 'Answers, plans and reviews.') : role === 'Sidekick' ? tr(lang, '执行命令和修改，接收反馈后继续。', 'Runs commands and makes changes, then continues with feedback.') : tr(lang, '整理较早的上下文，供 Lead 或 Worker 继续工作。', 'Summarises older context so the Lead or Sidekick can continue.')}</p>
+    <label>{tr(lang, '模型', 'Model')}<select aria-label={tr(lang, `${name} 模型`, `${name} model`)} value={key(route)} onChange={event => {
+      if (!event.target.value) { onChange(undefined); return }
+      const [provider, model] = JSON.parse(event.target.value) as [string, string]
+      onChange({ provider, model })
+    }}>
+      <option value="" disabled={role !== 'compactor'}>{role === 'compactor' ? tr(lang, '使用当前角色模型', 'Use the role\'s own model') : tr(lang, '选择已连接的模型', 'Choose a connected model')}</option>
+      {catalog.groups.map(group => <optgroup key={group.id} label={group.name}>
+        {group.models.map(model => <option key={model.id} value={key({ provider: group.id, model: model.id })}>{model.name}</option>)}
+      </optgroup>)}
+    </select></label>
+    {model?.reasoning && route && <label>{tr(lang, '推理强度', 'Reasoning')}<select aria-label={tr(lang, `${name} 推理强度`, `${name} reasoning`)} value={route.reasoningEffort ?? ''} onChange={event => {
+      const { reasoningEffort: _old, ...physical } = route
+      onChange({ ...physical, ...(event.target.value ? { reasoningEffort: event.target.value } : {}) })
+    }}>
+      <option value="">{tr(lang, '模型默认', 'Model default')}{model.reasoning.defaultEffort ? ` · ${model.reasoning.defaultEffort}` : ''}</option>
+      {model.reasoning.efforts.map(effort => <option key={effort.id} value={effort.id}>{effort.name}</option>)}
+    </select></label>}
+  </fieldset>
+}
+
+export function FusionSettings() {
+  const lang = useLang()
+  const [state, setState] = useState<SettingsState>()
+  const [draft, setDraft] = useState<Partial<PairChoice>>({})
+  const [error, setError] = useState<string>()
+  const [notice, setNotice] = useState<string>()
+  const [saving, setSaving] = useState(false)
+  const chooseModel = (role: 'lead' | 'worker', route: PhysicalRoute) => setDraft(value => ({ ...value, [role]: route,
+    ...(value.cacheKeepalive ? { cacheKeepalive: { ...value.cacheKeepalive, [role]: role === 'lead' ? 'auto' : false } } : {}) }))
+  useEffect(() => {
+    const abort = new AbortController()
+    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(tr(lang, '无法读取 Fusion 设置', 'Cannot read Fusion settings')); return response.json() as Promise<SettingsState> })
+      .then(value => { setState(value); setDraft(value.pair ?? {}) })
+      .catch(error => { if (!abort.signal.aborted) setError(String(error)) })
+    return () => abort.abort()
+  }, [])
+  const save = async () => {
+    if (!state || !draft.lead || !draft.worker) return
+    setSaving(true); setError(undefined); setNotice(undefined)
+    try {
+      const { outputTokens, ...rest } = draft
+      const limits = Object.fromEntries(Object.entries(outputTokens ?? {}).filter(([, tokens]) => Number.isSafeInteger(tokens) && Number(tokens) > 0))
+      const pair = { ...rest, ...(Object.keys(limits).length ? { outputTokens: limits } : {}) }
+      const response = await fetch(FUSION_API_PATH, { method: 'POST', credentials: 'same-origin',
+        headers: { 'content-type': 'application/json' }, body: JSON.stringify({ action: 'configure', revision: state.revision, pair }) })
+      const result = await response.json() as { revision: number; error?: string }
+      if (!response.ok) throw new Error(result.error ?? tr(lang, '保存失败，请刷新后重试', 'Save failed; refresh and try again'))
+      const current = await fetch(`${FUSION_API_PATH}?view=settings`, { credentials: 'same-origin', cache: 'no-store' })
+      if (!current.ok) throw new Error(tr(lang, '配置已提交，但暂时无法确认，请刷新', 'Saved, but not confirmed yet; refresh'))
+      const confirmed = await current.json() as SettingsState
+      setState(confirmed); setDraft(confirmed.pair ?? {})
+      settingsChanged()
+      setNotice(tr(lang, '组合已保存并启用。可以在模型菜单中选择 Fusion · 自动。', 'Pair saved and enabled. Choose Fusion · auto in the model menu.'))
+    } catch (error) { setError(error instanceof Error ? error.message : String(error)) }
+    finally { setSaving(false) }
+  }
+  return <div className="fusion-page">
+    <style>{styles}</style>
+    <div className="fusion-settings">
+      <header data-window-drag><h2>Fusion</h2><p>{tr(lang, '选择 Lead 和 Sidekick。Lead 处理日常请求、安排工作并审查结果；Sidekick 执行委派的任务。', 'Choose a Lead and a Sidekick. The Lead handles requests, plans and reviews; the Sidekick does the delegated work.')}</p>
+        <p><b>{tr(lang, '搭配建议', 'Pairing tip')}</b>: {tr(lang, 'Fusion 省钱靠的是 Sidekick 比 Lead 便宜得多。选一个强的前沿模型当 Lead，再选一个价格低很多（最好 5 倍以上）的模型当 Sidekick；两者价格越接近，越省不了钱。',
+          'Fusion saves money because the Sidekick is much cheaper than the Lead. Pick a strong frontier Lead and a Sidekick that costs far less (ideally 5× or more); the closer their prices, the smaller the saving.')}</p></header>
+      {error && <p role="alert">{error}</p>}
+      {!state && !error && <p role="status">{tr(lang, '正在读取模型…', 'Loading models…')}</p>}
+      {state && <>
+        <fieldset className="fusion-card" disabled={saving}>
+          <ModelChoice role="Lead" route={draft.lead} catalog={state.catalog} onChange={route => { if (route) chooseModel('lead', route) }} />
+          <ModelChoice role="Sidekick" route={draft.worker} catalog={state.catalog} onChange={route => { if (route) chooseModel('worker', route) }} />
+          <details><summary>{tr(lang, '上下文压缩模型 · 可选', 'Compaction model · optional')}</summary>
+            <div className="fusion-limits">
+              <p>{tr(lang, '默认由当前角色模型压缩。也可以单独选择已连接的模型；请求由所选账号计费。', 'By default each role compacts with its own model. You can pick another connected model; its account is billed.')}</p>
+              <ModelChoice role="compactor" route={draft.compactor?.route} catalog={state.catalog} onChange={route => setDraft(value => {
+                const { compactor, ...rest } = value
+                return route ? { ...rest, compactor: { route, maxOutputTokens: compactor?.maxOutputTokens ?? 8192 } } : rest
+              })} />
+              {draft.compactor && <label>{tr(lang, '输出 Token 上限', 'Output token limit')}<input aria-label={tr(lang, '压缩输出 Token 上限', 'Compaction output token limit')} type="number" min="1" max="128000"
+                value={draft.compactor.maxOutputTokens} onChange={event => { const maxOutputTokens = Number(event.target.value)
+                  setDraft(value => value.compactor ? { ...value, compactor: { ...value.compactor, maxOutputTokens } } : value) }} /></label>}
+              <p>{tr(lang, '已选中的会话仍使用原配置。', 'Conversations already using Fusion keep their setup.')}</p>
+            </div>
+          </details>
+        </fieldset>
+        <div className="fusion-actions"><p>{tr(lang, '已选中的会话保留原组合；新选择使用新组合。额度耗尽后要换当前任务的 Sidekick，用该会话的 Fusion 恢复面板，而不是只改这里。', 'Conversations already using Fusion keep their pair; new selections use the new one. After a quota stop, switch this conversation\'s Sidekick from its Fusion recovery panel, not only here.')}</p>
+          <button disabled={saving || !draft.lead || !draft.worker || JSON.stringify(draft) === JSON.stringify(state.pair)} onClick={() => { void save() }}>{saving ? tr(lang, '正在保存…', 'Saving…') : tr(lang, '保存组合', 'Save pair')}</button>
+        </div>
+        {notice && <p role="status">{notice}</p>}
+        <p>{tr(lang, '输出参数跟随原生模型设置，Fusion 不额外限制请求次数或任务轮数。', 'Output settings follow the native model settings; Fusion adds no request or round limits.')}</p>
+        <p>{tr(lang, '保存即表示允许 Fusion 使用所选模型的现有账号；费用由这些账号计入，当前未提供可靠的实际账单金额。', 'Saving lets Fusion use the chosen models\' existing accounts; they are billed there, and no reliable billed amount is available here.')}</p>
+        {state.pair && !state.authorized && <p role="status">{tr(lang, '组合需要重新保存后才能使用', 'Save the pair again before use')}{state.reason ? `: ${state.reason}` : ''}</p>}
+        {state.managedAuthorization && <p>{tr(lang, '运行额度由外部授权配置管理。', 'Run limits are managed by an external authorization file.')}</p>}
+      </>}
+      <FusionCache refresh={state?.revision ?? 0} />
+      <FusionHistory />
+    </div>
+  </div>
+}

package/src/client/FusionStatus.tsx

@@ -0,0 +1,103 @@
+import { FusionRecovery } from './FusionRecovery.js'
+import { Fragment, useState } from 'react'
+import { useFusionStatus } from './status-polling.js'
+import type { UsageSubtotal } from '../status.js'
+import { tr, useLang, type Lang } from './i18n.js'
+
+const styles = `
+.fusion-status{margin:8px 12px;color:var(--dsw-alias-label-primary);font-size:13px;line-height:1.5;overflow-wrap:anywhere}
+.fusion-status>summary{cursor:pointer;min-height:44px;display:flex;align-items:center;gap:12px;list-style:none;border-top:1px solid var(--dsw-alias-border-l2);outline-offset:2px}
+.fusion-status>summary::before{content:'›';font-size:18px;flex:none}.fusion-status[open]>summary::before{content:'⌄'}
+.fusion-status>summary:focus-visible{outline:2px solid var(--dsw-alias-brand-primary)}
+.fusion-status .fusion-status-label{font-weight:600}.fusion-status .fusion-status-count{margin-left:auto;color:var(--dsw-alias-label-secondary);white-space:nowrap}
+.fusion-status .fusion-status-detail{max-height:320px;overflow:auto;padding:4px 4px 12px 0;scrollbar-gutter:stable}
+.fusion-status .fusion-recovery fieldset{border:0;padding:0;display:flex;flex-direction:column;gap:10px}.fusion-recovery :is(button,select,input){font:inherit;color:var(--dsw-alias-label-primary);border:1px solid var(--dsw-alias-border-l2);border-radius:6px;padding:7px;max-width:100%}.fusion-recovery :is(select,input,option,optgroup){background-color:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);color-scheme:inherit}.fusion-recovery button{cursor:pointer;background-color:var(--dsw-alias-button-elevated-fill)}.fusion-recovery :is(button,input,select):focus-visible{outline:2px solid var(--dsw-alias-brand-primary)}.fusion-recovery [role=alert]{color:var(--dsw-alias-state-error-primary)}
+.fusion-status:has(.fusion-recovery) .fusion-status-detail{max-height:min(65vh,640px)}.fusion-recovery details>summary{padding:8px 0;cursor:pointer}
+.fusion-status p{margin:4px 0 12px}.fusion-status h3{font-size:13px;margin:16px 0 4px;font-weight:600}
+.fusion-status dl{margin:0;display:grid;grid-template-columns:minmax(72px,auto) minmax(0,1fr);gap:4px 12px}
+.fusion-status dt{color:var(--dsw-alias-label-secondary)}.fusion-status dd{margin:0;min-width:0}
+.fusion-status ul{list-style:none;margin:0;padding:0}.fusion-status li{padding:6px 0;border-bottom:1px solid var(--dsw-alias-border-l2)}
+.fusion-status small{display:block;color:var(--dsw-alias-label-secondary);font-size:12px}
+@media(max-width:400px){.fusion-status>summary{gap:8px}.fusion-status .fusion-status-detail{max-height:280px}}
+`
+
+const role = (value: string) => value === 'lead' ? 'Lead' : 'Sidekick'
+const purposeOf = (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
+const outcomeOf = (lang: Lang, value: string) => ({ entered: tr(lang, '请求中', 'in progress'), stop: tr(lang, '已返回', 'returned'), 'tool-calls': tr(lang, '调用工具', 'tool calls'),
+  'max-tokens': tr(lang, '输出截断', 'output truncated'), aborted: tr(lang, '已中断', 'aborted'), error: tr(lang, '请求失败', 'failed'), unknown: tr(lang, '结束状态未知', 'unknown end') } as Record<string, string>)[value] ?? value
+const toolStateOf = (lang: Lang, value: string) => ({ 'dispatch-started': tr(lang, '执行未收尾', 'unfinished'), returned: tr(lang, '已返回', 'returned'),
+  'outcome-unknown': tr(lang, '结果未知', 'outcome unknown'), inspected: tr(lang, '已人工检查', 'inspected') } as Record<string, string>)[value] ?? value
+const countOf = (lang: Lang, value: UsageSubtotal) => value.totalRequests === 0 ? '—' : value.reportedRequests === 0 ? tr(lang, '未提供', 'not reported')
+  : `${value.knownTokens.toLocaleString()}${value.reportedRequests < value.totalRequests ? tr(lang, `（${value.reportedRequests}/${value.totalRequests} 次有报告）`, ` (${value.reportedRequests}/${value.totalRequests} reported)`) : ''}`
+const noteStyle = { margin: '8px 12px', color: 'var(--dsw-alias-label-secondary)', fontSize: 12, lineHeight: 1.5 }
+
+/** Visible-session polling reads the plugin ledger; it never sends a chat message. */
+export function FusionStatus({ sessionId, attentionOnly = false }: { sessionId: string; attentionOnly?: boolean }) {
+  const lang = useLang()
+  const purpose = (value: string) => purposeOf(lang, value), outcome = (value: string) => outcomeOf(lang, value)
+  const toolState = (value: string) => toolStateOf(lang, value), count = (value: UsageSubtotal) => countOf(lang, value)
+  const [expandedTask, setExpandedTask] = useState<string>()
+  const snapshot = useFusionStatus(sessionId, expandedTask, attentionOnly)
+  if (!snapshot || snapshot.sessionId !== sessionId) return attentionOnly ? null : <p style={noteStyle} role="status">{tr(lang, '正在读取 Fusion 状态…', 'Loading Fusion status…')}</p>
+  if (snapshot.failed) return attentionOnly ? null : <p style={noteStyle} role="status">{tr(lang, 'Fusion 状态暂时无法更新，恢复连接后会重试。可用 /fusion status 查看。', 'Fusion status cannot update right now; it retries when reconnected. Use /fusion status.')}</p>
+  const task = snapshot.status?.task
+  if (!snapshot.status?.selected || !task) return null
+  if (attentionOnly && !task.attention) return null
+  const { usage } = task
+  const verification = task.automatedChecks === 0 && task.verification === 'verified' ? tr(lang, '仅经 Lead 审查（未运行自动检查）', 'Lead review only (no automated checks ran)')
+    : ({ verified: tr(lang, '验证通过', 'verified'), partial: tr(lang, '部分验证', 'partly verified'), unverified: tr(lang, '尚未验证', 'unverified') })[task.verification]
+  const stage = lang === 'en' ? task.stageEn ?? task.stage : task.stage, detail = lang === 'en' && task.detailEn !== undefined ? task.detailEn : task.detail
+  const share = (role: 'lead' | 'worker') => {
+    const total = usage.byRole.lead.output.knownTokens + usage.byRole.worker.output.knownTokens
+    return total ? tr(lang, ` · 输出占 ${Math.round(usage.byRole[role].output.knownTokens / total * 100)}%`, ` · ${Math.round(usage.byRole[role].output.knownTokens / total * 100)}% of output`) : ''
+  }
+  return <details className="fusion-status" key={task.id} onToggle={event => setExpandedTask(event.currentTarget.open ? task.id : undefined)}>
+    <style>{styles}</style>
+    <summary aria-label={tr(lang, `Fusion · ${stage}，任务详情`, `Fusion · ${stage}, task details`)} data-ud-check="fusion-status-summary">
+      <span className="fusion-status-label" role="status">Fusion · {stage}</span>
+      <span className="fusion-status-count">{tr(lang, `${usage.calls} 次请求`, `${usage.calls} requests`)}</span><span>{tr(lang, '详情', 'Details')}</span>
+    </summary>
+    <div className="fusion-status-detail" tabIndex={0} aria-label={tr(lang, 'Fusion 任务详情', 'Fusion task details')} data-ud-check="fusion-status-detail">
+      <p>{detail ?? (task.stage === '完成' ? tr(lang, `本轮任务已结束 · ${verification}`, `This task has finished · ${verification}`) : tr(lang, `本轮任务 · ${verification}`, `This task · ${verification}`))}</p>
+      {task.modelControl && task.stage !== '完成' && <FusionRecovery sessionId={sessionId} task={task} />}
+      <dl>
+        <dt>Lead</dt><dd>{task.models.lead.model}<small>{task.models.lead.provider}</small></dd>
+        <dt>Sidekick</dt><dd>{task.models.worker.model}<small>{task.models.worker.provider}{task.workerId ? tr(lang, ' · 已建立持续会话', ' · persistent session') : tr(lang, ' · 尚未委派', ' · not delegated yet')}</small></dd>
+        {task.models.compactor && <><dt>{tr(lang, '压缩模型', 'Compaction')}</dt><dd>{task.models.compactor.model}<small>{task.models.compactor.provider}</small></dd></>}
+        <dt>{tr(lang, '待确认', 'Pending approvals')}</dt><dd>{task.pendingApprovals}</dd>
+        <dt>{tr(lang, '未收尾工具', 'Unsettled tools')}</dt><dd>{task.unsettledTools}</dd>
+      </dl>
+      <h3>{tr(lang, '本轮用量', 'Usage this task')}</h3>
+      <dl>
+        <dt>{tr(lang, '模型请求', 'Model requests')}</dt><dd>{usage.calls}<small>{tr(lang, `含压缩 ${usage.compactionCalls} 次、保活 ${usage.keepaliveCalls} 次`, `incl. ${usage.compactionCalls} compaction, ${usage.keepaliveCalls} keepalive`)}</small></dd>
+        <dt>{tr(lang, '用量报告', 'Usage reports')}</dt><dd>{tr(lang, `${usage.finalCalls} 次已定稿 · ${usage.provisionalCalls} 次暂报 · ${usage.unreportedCalls} 次未提供`, `${usage.finalCalls} final · ${usage.provisionalCalls} provisional · ${usage.unreportedCalls} unreported`)}</dd>
+        <dt>{tr(lang, '输入 Token', 'Input tokens')}</dt><dd>{count(usage.input)}<small>{tr(lang, '已报告的未缓存输入', 'reported uncached input')}</small></dd>
+        <dt>{tr(lang, '缓存读取', 'Cache read')}</dt><dd>{count(usage.cacheRead)}</dd>
+        <dt>{tr(lang, '输出 Token', 'Output tokens')}</dt><dd>{count(usage.output)}</dd>
+        <dt>{tr(lang, '实际费用', 'Actual cost')}</dt><dd>{tr(lang, '未知', 'unknown')}<small>{tr(lang, '当前账号未提供可靠账单金额', 'the account reports no reliable billed amount')}</small></dd>
+      </dl>
+      <h3>{tr(lang, '按角色', 'By role')}</h3>
+      <dl>
+        {(['lead', 'worker'] as const).map(role => <Fragment key={role}>
+          <dt>{role === 'lead' ? 'Lead' : 'Sidekick'}</dt>
+          <dd>{tr(lang, `${usage.byRole[role].calls} 次`, `${usage.byRole[role].calls} requests`)} · {tr(lang, '输出', 'output')} {count(usage.byRole[role].output)}
+            <small>{tr(lang, '输入', 'input')} {count(usage.byRole[role].input)} · {tr(lang, '缓存读取', 'cache read')} {count(usage.byRole[role].cacheRead)}{share(role)}</small></dd>
+        </Fragment>)}
+      </dl>
+      <small>{tr(lang, 'Token 数包含暂报数据；缺失字段不计为 0。请求数来自 DSH，供应商内部重试次数未知。', 'Token counts include provisional data; missing fields are not counted as 0. Request counts come from DSH; provider-internal retries are unknown.')}</small>
+      <h3>{tr(lang, '最近上下文检查', 'Recent context checks')}</h3>
+      {task.contexts.length ? <ul>{task.contexts.map(context => <li key={context.role}>{role(context.role)} · {purpose(context.purpose)} · {context.admitted ? tr(lang, '可发送', 'admitted') : tr(lang, '超出预算', 'over budget')}
+        <small>{context.inputTokens.toLocaleString()} / {context.budget.toLocaleString()} Token · {context.quality === 'exact' ? tr(lang, '精确计数', 'exact') : tr(lang, '估算', 'estimated')}</small>
+      </li>)}</ul> : <small>{tr(lang, '尚无上下文检查记录。', 'No context checks yet.')}</small>}
+      <h3>{tr(lang, '最近模型请求', 'Recent model requests')}</h3>
+      {task.requests.length ? <ul>{task.requests.map(request => <li key={request.id}>{role(request.role)} · {purpose(request.purpose)} · {outcome(request.outcome)}
+        <small>{request.model} · {request.provider} · {request.authority === 'final' ? tr(lang, '用量已定稿', 'usage final') : request.authority === 'provisional' ? tr(lang, '用量暂报', 'usage provisional') : tr(lang, '用量未提供', 'usage not reported')}</small>
+      </li>)}</ul> : <small>{tr(lang, '尚未发出模型请求。', 'No model requests yet.')}</small>}
+      <h3>{tr(lang, '最近命令与写入', 'Recent commands and writes')}</h3>
+      {task.tools.length ? <ul>{task.tools.map(tool => <li key={tool.id}>{role(tool.role)} · {tool.name} · {tool.failed ? tr(lang, '返回错误', 'error') : toolState(tool.state)}</li>)}</ul>
+        : <small>{tr(lang, '尚无工具执行记录。', 'No tool runs yet.')}</small>}
+      <small>{tr(lang, '显示最近 12 次请求、8 项命令或写入操作；用量汇总覆盖本轮全部请求。读取操作仍可在会话中查看。', 'Shows the last 12 requests and 8 commands or writes; usage totals cover all requests of this task. Reads remain visible in the conversation.')}</small>
+    </div>
+  </details>
+}

package/src/client/FusionTool.tsx

@@ -0,0 +1,66 @@
+import type { ToolCallViewProps } from '@deepseek-ai/dsh-client-ui-tool/client'
+import { useEffect, useMemo, useState } from 'react'
+import type { FusionActivity, FusionActivityPage } from '../activity.js'
+import { activityRows } from './activity-model.js'
+import { tr, useLang } from './i18n.js'
+import { ActivityCard, activityStyles } from './ActivityRows.js'
+import { FUSION_API_PATH } from '../identity.js'
+
+export const fusionControlTools = ['fusion_read_state', 'fusion_delegate_text', 'fusion_explore', 'fusion_delegate', 'fusion_rework', 'fusion_wait', 'fusion_review_result',
+  'fusion_submit_result', 'fusion_takeover', 'fusion_finish_direct', 'fusion_read_evidence'] as const
+
+/** Keep internal coordination out of the normal conversation. Errors remain visible. */
+export function FusionTool({ block, sessionId, callId, toolName, cwd, openFile }: ToolCallViewProps) {
+  const lang = useLang()
+  const settled = 'kind' in block
+  const tracksActivity = toolName === 'fusion_delegate_text' || toolName === 'fusion_explore' || toolName === 'fusion_delegate' || toolName === 'fusion_rework'
+  const [snapshot, setSnapshot] = useState<{ key: string; events: FusionActivity[]; done: boolean; failed?: boolean }>()
+  const key = `${sessionId}:${callId}`
+  useEffect(() => {
+    if (!tracksActivity) return
+    let active = true, busy = false, cursor = -1, timer: ReturnType<typeof setTimeout> | undefined
+    const events = new Map<number, FusionActivity>()
+    let abort: AbortController | undefined
+    const visible = () => document.visibilityState !== 'hidden'
+    const refresh = async () => {
+      if (!active || busy || !visible()) return
+      busy = true; abort = new AbortController()
+      const deadline = setTimeout(() => abort?.abort(), 10000)
+      let again = true, delay = 2000
+      try {
+        const response = await fetch(`${FUSION_API_PATH}?view=activity&sessionId=${encodeURIComponent(sessionId)}&callId=${encodeURIComponent(callId)}&after=${cursor}`,
+          { credentials: 'same-origin', cache: 'no-store', signal: abort.signal })
+        if (!response.ok) throw new Error('Activity unavailable')
+        const page = await response.json() as FusionActivityPage
+        if (!Array.isArray(page.events) || !Number.isSafeInteger(page.cursor) || page.cursor < cursor) throw new Error('Invalid activity page')
+        for (const event of page.events) if (event.parentCallId === callId) events.set(event.source.seq, event)
+        cursor = page.cursor; again = page.more || !page.done || !settled; delay = page.more ? 0 : 2000
+        if (active) setSnapshot({ key, events: [...events.values()].sort((a, b) => a.source.seq - b.source.seq), done: page.done })
+      } catch {
+        if (active) setSnapshot(previous => ({ key, events: previous?.key === key ? previous.events : [], done: false, failed: true }))
+      } finally {
+        clearTimeout(deadline); busy = false
+        if (active && again && visible()) timer = setTimeout(() => { void refresh() }, delay)
+      }
+    }
+    const visibility = () => { if (timer) clearTimeout(timer); if (document.visibilityState === 'hidden') abort?.abort(); else void refresh() }
+    void refresh(); document.addEventListener('visibilitychange', visibility)
+    return () => { active = false; abort?.abort(); if (timer) clearTimeout(timer); document.removeEventListener('visibilitychange', visibility) }
+  }, [sessionId, callId, key, tracksActivity, settled])
+  const current = tracksActivity && snapshot?.key === key ? snapshot : undefined
+  const rows = useMemo(() => activityRows(current?.events ?? []), [current?.events])
+  const text = settled ? block.content.flatMap(part => part.type === 'text' ? [part.text] : []).join('\n') : ''
+  let problem = settled && block.isError ? text : ''
+  if (!problem) {
+    try {
+      const result = JSON.parse(text) as { status?: string; reason?: string }
+      if (result.status === 'needs-decision') problem = result.reason ?? tr(lang, '任务需要进一步处理。', 'The task needs attention.')
+    } catch { /* Non-JSON successful evidence carries no user action. */ }
+  }
+  return <>
+    {rows.length > 0 && <style>{activityStyles}</style>}
+    {rows.map(row => <ActivityCard key={row.id} row={row} done={current?.done ?? false} cwd={cwd} openFile={openFile} />)}
+    {current?.failed && <p role="status">{tr(lang, '执行记录暂时无法加载，正在重试。', 'Activity is unavailable; retrying.')}</p>}
+    {problem && <p role="status" style={{ fontSize: 13, whiteSpace: 'pre-wrap' }}>{problem}</p>}
+  </>
+}

package/src/client/activity-model.ts

@@ -0,0 +1,31 @@
+import type { DiffHunk } from '@deepseek-ai/dsh-client-ui-primitives'
+import type { FusionActivity } from '../activity.js'
+import { activityCallId } from '../activity.js'
+
+export interface ActivityRow {
+  id: string
+  call: Extract<FusionActivity['source'], { type: 'tool/call' }>
+  result?: Extract<FusionActivity['source'], { type: 'tool/result' }>
+}
+
+export function activityRows(events: readonly FusionActivity[]): ActivityRow[] {
+  const rows = new Map<string, ActivityRow>()
+  for (const event of events) {
+    const id = activityCallId(event)
+    if (event.source.type === 'tool/call') rows.set(id, { id, call: event.source })
+    else {
+      const row = rows.get(id)
+      if (row) rows.set(id, { ...row, result: event.source })
+    }
+  }
+  return [...rows.values()]
+}
+
+/** Only actual result-time metadata is labelled an applied diff. */
+export function activityDiffs(row: ActivityRow): DiffHunk[] {
+  if (!row.result || row.result.data.message.isError) return []
+  const meta = row.result.data.meta as { diffs?: unknown } | undefined
+  if (!Array.isArray(meta?.diffs)) return []
+  return meta.diffs.filter((hunk): hunk is DiffHunk => hunk && typeof hunk === 'object'
+    && typeof hunk.path === 'string' && (typeof hunk.oldText === 'string' || hunk.oldText === null) && typeof hunk.newText === 'string')
+}

package/src/client/i18n.ts

@@ -0,0 +1,30 @@
+import { useSyncExternalStore } from 'react'
+
+/** The DSH client locale service (`ctx.locale`), used by structure only. */
+interface LocaleSource { getSnapshot(): { active: string }; subscribe(listener: () => void): () => void }
+
+let source: LocaleSource | undefined
+const listeners = new Set<() => void>()
+const notify = () => { for (const listener of listeners) listener() }
+
+/** Called from the client entry when DSH's locale service is available; follows the user's language setting. */
+export function bindLocale(next: LocaleSource): () => void {
+  source = next
+  notify()
+  const unsubscribe = next.subscribe(notify)
+  return () => { unsubscribe(); if (source === next) { source = undefined; notify() } }
+}
+
+export type Lang = 'zh' | 'en'
+const current = (): Lang => {
+  const id = source?.getSnapshot().active ?? (typeof navigator === 'undefined' ? 'en' : navigator.language)
+  return id.toLowerCase().startsWith('zh') ? 'zh' : 'en'
+}
+
+/** The UI language: Chinese for any zh locale, English otherwise (DSH's own fallback). */
+export function useLang(): Lang {
+  return useSyncExternalStore(listener => { listeners.add(listener); return () => { listeners.delete(listener) } }, current, () => 'en')
+}
+
+/** Pick the text for the active language. */
+export const tr = (lang: Lang, zh: string, en: string) => lang === 'zh' ? zh : en

package/src/client/index.ts

@@ -0,0 +1,50 @@
+import type { Context } from '@deepseek-ai/cordis'
+import type {} from '@deepseek-ai/dsh-client-ui-renderer/client'
+import type {} from '@deepseek-ai/dsh-client-ui-slots'
+import type {} from '@deepseek-ai/dsh-client-ui-conversation/client'
+import type {} from '@deepseek-ai/dsh-client-ui-model-selection/client'
+import { FusionSettings } from './FusionSettings.js'
+import { FusionPanelIcon } from './FusionPanelIcon.js'
+import { FusionHint } from './FusionHint.js'
+import { FusionTool, fusionControlTools } from './FusionTool.js'
+import { bindLocale } from './i18n.js'
+
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+  interface SlotMap {
+    'main': { kind: 'keyed'; scope: 'root' }
+    'sidebar.panellist': {
+      kind: 'list'
+      scope: 'root'
+      owner: { size: number; active: boolean }
+    }
+  }
+}
+
+export const name = 'dsh-fusion/client'
+export const inject = ['slots']
+export const FUSION_PANEL_ID = 'fusion'
+
+export { FusionPanelIcon } from './FusionPanelIcon.js'
+
+export function apply(ctx: Context): void {
+  // Follow DSH's language setting (Chinese or English) when the locale service is present.
+  ctx.inject(['locale'], scope => { scope.effect(() => bindLocale((scope as unknown as { locale: Parameters<typeof bindLocale>[0] }).locale)) })
+  for (const tool of fusionControlTools) ctx.slots.inject('tool.call.toolview', () => ctx.slots.register({
+    name: 'tool.call.toolview', key: tool,
+  }, FusionTool))
+  ctx.slots.inject('main', () => ctx.slots.register({
+    name: 'main', key: FUSION_PANEL_ID,
+  }, FusionSettings))
+  ctx.slots.inject('sidebar.panellist', () => ctx.slots.register({
+    name: 'sidebar.panellist', id: FUSION_PANEL_ID, order: 40, label: () => 'Fusion',
+  }, FusionPanelIcon))
+  ctx.inject(['modelDirectories'], scope => {
+    scope.slots.inject('conversation.input.dock', () => scope.slots.register({
+      name: 'conversation.input.dock', id: 'fusion-configuration', order: 20,
+      inject: sessionId => {
+        const directory = scope.modelDirectories.directoryFor(sessionId)
+        return { sessionId, directory: directory.store, load: () => { void directory.load().catch(() => undefined) } }
+      },
+    }, FusionHint))
+  })
+}

package/src/client/settings-events.ts

@@ -0,0 +1,3 @@
+const listeners = new Set<() => void>()
+export const onSettingsChanged = (listener: () => void): (() => void) => { listeners.add(listener); return () => { listeners.delete(listener) } }
+export const settingsChanged = (): void => { for (const listener of listeners) listener() }

package/src/client/status-polling.ts

@@ -0,0 +1,88 @@
+import { useCallback, useEffect, useRef, useSyncExternalStore } from 'react'
+import type { FusionStatus } from '../status.js'
+import { FUSION_API_PATH } from '../identity.js'
+
+interface Snapshot { sessionId: string; status?: FusionStatus; failed: boolean }
+interface Entry {
+  snapshot?: Snapshot
+  listeners: Map<() => void, () => boolean>
+  busy: boolean
+  timer?: ReturnType<typeof setTimeout>
+  abort?: AbortController
+  visibility: () => void
+}
+const entries = new Map<string, Entry>()
+const visible = () => document.visibilityState !== 'hidden'
+const running = new Set(['分析', '执行', '修改', '审查', '验证', '正在停止'])
+
+function subscribe(sessionId: string, listener: () => void, expanded: () => boolean): () => void {
+  let entry = entries.get(sessionId)
+  if (!entry) {
+    entry = { listeners: new Map(), busy: false, visibility: () => {} }
+    entries.set(sessionId, entry)
+    const own = entry
+    const active = () => entries.get(sessionId) === own && own.listeners.size > 0
+    const publish = (snapshot: Snapshot) => {
+      if (!active()) return
+      own.snapshot = snapshot
+      for (const notify of own.listeners.keys()) notify()
+    }
+    const refresh = async () => {
+      if (!active() || own.busy || !visible()) return
+      clearTimeout(own.timer)
+      own.busy = true
+      const abort = new AbortController(); own.abort = abort
+      const deadline = setTimeout(() => {
+        if (active() && visible()) publish({ sessionId, failed: true })
+        abort.abort()
+      }, 10000)
+      try {
+        const response = await fetch(`${FUSION_API_PATH}?view=status&sessionId=${encodeURIComponent(sessionId)}`,
+          { credentials: 'same-origin', cache: 'no-store', signal: abort.signal })
+        if (!response.ok) throw new Error('unavailable')
+        const status = await response.json() as FusionStatus
+        if (status.schemaVersion !== 1 || status.sessionId !== sessionId) throw new Error('mismatched status')
+        if (!abort.signal.aborted) publish({ sessionId, status, failed: false })
+      } catch {
+        if (!abort.signal.aborted) publish({ sessionId, failed: true })
+      } finally {
+        clearTimeout(deadline); own.busy = false
+        if (active() && visible()) {
+          const fast = [...own.listeners.values()].some(value => value()) && running.has(own.snapshot?.status?.task?.stage ?? '')
+          own.timer = setTimeout(() => { void refresh() }, fast ? 2000 : 15000)
+        }
+      }
+    }
+    own.visibility = () => {
+      clearTimeout(own.timer)
+      if (!visible()) own.abort?.abort()
+      else void refresh()
+    }
+    document.addEventListener('visibilitychange', own.visibility)
+  }
+  entry.listeners.set(listener, expanded)
+  if (entry.listeners.size === 1 || expanded()) entry.visibility()
+  const own = entry
+  return () => {
+    own.listeners.delete(listener)
+    if (own.listeners.size) return
+    entries.delete(sessionId)
+    clearTimeout(own.timer); own.abort?.abort()
+    document.removeEventListener('visibilitychange', own.visibility)
+  }
+}
+
+/** One in-flight read per mounted session; collapsed hints still discover new attention states. */
+export function useFusionStatus(sessionId: string, expandedTask: string | undefined, attentionOnly = false): Snapshot | undefined {
+  const expandedRef = useRef(expandedTask), attentionRef = useRef(attentionOnly)
+  expandedRef.current = expandedTask; attentionRef.current = attentionOnly
+  useEffect(() => { if (expandedTask) entries.get(sessionId)?.visibility() }, [sessionId, expandedTask])
+  return useSyncExternalStore(
+    useCallback(listener => subscribe(sessionId, listener, () => {
+      const task = entries.get(sessionId)?.snapshot?.status?.task
+      return expandedRef.current !== undefined && task?.id === expandedRef.current && (!attentionRef.current || task.attention)
+    }), [sessionId]),
+    useCallback(() => entries.get(sessionId)?.snapshot, [sessionId]),
+    () => undefined,
+  )
+}