@dsh-plus/llm-pi 0.1.0

package/src/client/card.tsx

@@ -0,0 +1,239 @@
+/**
+ * 「LLM 路由」配置卡片：注册进 settings.plugin.item 插槽（官方插件配置页）。
+ * 顶部：enabled / catalogUrl / catalogRefreshHours / 只读状态行（kitSource、
+ * modelsDevStatus）+ 保存（PUT 全量）与错误/成功提示；下方为 providers 路由
+ * 列表（新增/删除/字段编辑/compat/模型目录，见 views/）。
+ * 交互对齐官方卡片与 notify-email：折叠/展开、staged draft、未保存标记。
+ * @module llm-pi/client/card
+ */
+import { useEffect, useMemo, useState, type ReactElement } from 'react'
+
+import { fetchConfig, refreshCatalog, saveConfig, type WireConfig, type WireModelsDevStatus } from './api.ts'
+import { draftFromWire, emptyProviderDraft, numTextOk, toPatch, type Draft, type ProviderDraft } from './draft.ts'
+import { CheckRow, TextField } from './fields.tsx'
+import { ProvidersSection } from './views/providers.tsx'
+
+export interface CardProps {
+  t(key: string): string
+}
+
+interface Status {
+  kind: 'idle' | 'ok' | 'error'
+  text: string
+}
+
+const IDLE_STATUS: Status = { kind: 'idle', text: '' }
+
+function modelsDevText(status: WireModelsDevStatus | null, t: (key: string) => string): string {
+  if (status === null) return t('modelsDevEmpty')
+  if (status.error !== null) return `${t('modelsDevError')}${status.error}`
+  if (status.fetchedAt === null) return t('modelsDevEmpty')
+  return `${t('modelsDevStatusLine')}：${status.providers} 个 provider，快照 ${status.fetchedAt}`
+}
+
+export function LlmPiCard(props: CardProps): ReactElement | null {
+  const { t } = props
+  const [open, setOpen] = useState(false)
+  const [wire, setWire] = useState<WireConfig | null>(null)
+  const [draft, setDraft] = useState<Draft | null>(null)
+  const [epoch, setEpoch] = useState(0)
+  const [failed, setFailed] = useState(false)
+  const [saving, setSaving] = useState(false)
+  const [refreshing, setRefreshing] = useState(false)
+  const [status, setStatus] = useState<Status>(IDLE_STATUS)
+
+  useEffect(() => {
+    let alive = true
+    fetchConfig()
+      .then((loaded) => {
+        if (!alive) return
+        setWire(loaded)
+        setDraft(draftFromWire(loaded))
+      })
+      .catch(() => {
+        if (alive) setFailed(true)
+      })
+    return () => {
+      alive = false
+    }
+  }, [])
+
+  const dirty = useMemo(
+    () =>
+      wire !== null &&
+      draft !== null &&
+      JSON.stringify(toPatch(draft)) !== JSON.stringify(toPatch(draftFromWire(wire))),
+    [wire, draft],
+  )
+  const invalid = useMemo(() => {
+    if (draft === null) return false
+    return (
+      !numTextOk(draft.catalogRefreshHours) ||
+      Object.values(draft.providers).some((provider) =>
+        provider.models.some((model) => model.id.trim() === ''),
+      )
+    )
+  }, [draft])
+
+  if (failed) return null
+  if (wire === null || draft === null) {
+    return <li className="lpc-card"><p className="lpc-readOnly">{t('loading')}</p></li>
+  }
+
+  const setProvider = (route: string, patch: Partial<ProviderDraft>): void => {
+    const current = draft.providers[route] ?? emptyProviderDraft()
+    setDraft({ ...draft, providers: { ...draft.providers, [route]: { ...current, ...patch } } })
+    setStatus(IDLE_STATUS)
+  }
+  const onAddRoute = (key: string): void => {
+    setDraft({ ...draft, providers: { ...draft.providers, [key]: emptyProviderDraft() } })
+    setStatus(IDLE_STATUS)
+  }
+  const onRemoveRoute = (route: string): void => {
+    const next = { ...draft.providers }
+    delete next[route]
+    setDraft({ ...draft, providers: next })
+    setStatus(IDLE_STATUS)
+  }
+  const onSave = (): void => {
+    setSaving(true)
+    saveConfig(toPatch(draft))
+      .then((saved) => {
+        setWire(saved)
+        setDraft(draftFromWire(saved))
+        setEpoch((value) => value + 1)
+        setStatus({ kind: 'ok', text: t('saveOk') })
+      })
+      .catch((error: unknown) => {
+        const message = error instanceof Error ? error.message : String(error)
+        setStatus({ kind: 'error', text: `${t('saveFailed')}${message}` })
+      })
+      .finally(() => setSaving(false))
+  }
+  const onDiscard = (): void => {
+    setDraft(draftFromWire(wire))
+    setEpoch((value) => value + 1)
+    setStatus(IDLE_STATUS)
+  }
+  const onRefreshCatalog = (): void => {
+    setRefreshing(true)
+    refreshCatalog()
+      .then((result) => {
+        setWire({ ...wire, modelsDevStatus: result.status })
+        setStatus({ kind: 'ok', text: t('refreshOk') })
+      })
+      .catch((error: unknown) => {
+        const message = error instanceof Error ? error.message : String(error)
+        setStatus({ kind: 'error', text: `${t('refreshFailed')}${message}` })
+      })
+      .finally(() => setRefreshing(false))
+  }
+
+  const disabled = !wire.writable
+  return (
+    <li className={`lpc-card${open ? ' lpc-cardOpen' : ''}`}>
+      <button
+        type="button"
+        className="lpc-header"
+        aria-expanded={open}
+        aria-label={`${t(open ? 'collapse' : 'expand')}: ${t('title')}`}
+        onClick={() => setOpen(!open)}
+      >
+        <span className="lpc-headText">
+          <span className="lpc-name">{t('title')}</span>
+          <span className="lpc-description">{t('description')}</span>
+        </span>
+        {dirty ? <span className="lpc-pending">{t('unsaved')}</span> : null}
+        <span className={`lpc-chevron${open ? ' lpc-chevronOpen' : ''}`}>▾</span>
+      </button>
+      {open ? (
+        <div className="lpc-body">
+          {disabled ? <p className="lpc-readOnly" role="status">{t('readOnly')}</p> : null}
+          <CheckRow
+            id="lpc-enabled"
+            label={t('enabled')}
+            checked={draft.enabled}
+            disabled={disabled}
+            onEdit={(value) => {
+              setDraft({ ...draft, enabled: value })
+              setStatus(IDLE_STATUS)
+            }}
+          />
+          <TextField
+            id="lpc-catalogUrl"
+            label={t('catalogUrl')}
+            hint={t('catalogUrlHint')}
+            value={draft.catalogUrl}
+            disabled={disabled}
+            onEdit={(value) => {
+              setDraft({ ...draft, catalogUrl: value })
+              setStatus(IDLE_STATUS)
+            }}
+          />
+          <TextField
+            id="lpc-catalogRefresh"
+            label={t('catalogRefreshHours')}
+            hint={t('catalogRefreshHoursHint')}
+            value={draft.catalogRefreshHours}
+            numeric
+            disabled={disabled}
+            invalid={!numTextOk(draft.catalogRefreshHours)}
+            invalidLabel={t('invalidNumber')}
+            onEdit={(value) => {
+              setDraft({ ...draft, catalogRefreshHours: value })
+              setStatus(IDLE_STATUS)
+            }}
+          />
+          <TextField
+            id="lpc-catalogProxy"
+            label={t('catalogProxy')}
+            hint={t('catalogProxyHint')}
+            value={draft.catalogProxy}
+            disabled={disabled}
+            onEdit={(value) => {
+              setDraft({ ...draft, catalogProxy: value })
+              setStatus(IDLE_STATUS)
+            }}
+          />
+          <p className="lpc-statusRow">{t('kitSource')}：{wire.kitSource}</p>
+          <div className="lpc-statusRow">
+            <span>{t('modelsDevStatus')}：{modelsDevText(wire.modelsDevStatus, t)}</span>
+            <button
+              type="button"
+              className="lpc-btn lpc-btnGhost lpc-btnSmall lpc-refreshBtn"
+              disabled={disabled || refreshing}
+              onClick={onRefreshCatalog}
+            >
+              {t(refreshing ? 'refreshingCatalog' : 'refreshCatalog')}
+            </button>
+          </div>
+          <ProvidersSection
+            providers={draft.providers}
+            epoch={epoch}
+            disabled={disabled}
+            t={t}
+            onAddRoute={onAddRoute}
+            onRemoveRoute={onRemoveRoute}
+            onPatchProvider={setProvider}
+          />
+          <div className="lpc-footer">
+            {status.kind !== 'idle' ? (
+              <p className={`lpc-status${status.kind === 'error' ? ' lpc-statusError' : ''}`} role="status">
+                {status.text}
+              </p>
+            ) : null}
+            <button type="button" className="lpc-btn lpc-btnGhost" disabled={!dirty || saving}
+              onClick={onDiscard}>
+              {t('discard')}
+            </button>
+            <button type="button" className="lpc-btn lpc-btnPrimary"
+              disabled={!dirty || invalid || saving || disabled}
+              onClick={onSave}>
+              {t(saving ? 'saving' : 'save')}
+            </button>
+          </div>
+        </div>
+      ) : null}
+    </li>
+  )
+}

package/src/client/client.ts

@@ -0,0 +1,63 @@
+/**
+ * 浏览器半入口：注册 locale 字典 + 向 settings.plugin.item 插槽注册「LLM 路由」卡片。
+ * 构建产物为 window.__ModuleLoader__.load({id, factory}) 形式的 CJS factory
+ * （包装见 tsdown.config.ts）；样式沿用官方 data-plugin-css 约定，HMR 据此卸载。
+ *
+ * 类型说明：浏览器半只用到 slots/locale 的很窄一面，此处以最小本地接口声明，
+ * 避免为构建期类型引入整条官方 client 依赖树；运行时契约以官方
+ * dsh-client-ui-settings-plugins 的 settings.plugin.item 插槽为准。
+ * @module @dsh-plus/llm-pi/client
+ */
+import type { Context } from '@deepseek-ai/cordis'
+
+import { LlmPiCard } from './card.tsx'
+import { en, NS, zh } from './i18n.ts'
+import { injectStyle } from './styles.ts'
+
+export const name = 'dsh-plus-llm-pi'
+
+/** 浏览器半需要的 cordis 服务 key（loader 据此注入；package.json 的 dsh.client.inject 管包加载顺序）。 */
+export const inject = ['slots', 'locale'] as const
+
+interface SlotsLike {
+  inject(key: string, callback: () => unknown): unknown
+  register(options: Record<string, unknown>, component: unknown): () => void
+}
+
+interface LocaleLike {
+  register(ns: string, dict: { zh: Record<string, string>; en: Record<string, string> }): () => void
+  bind(ns: string): (key: string) => string
+}
+
+interface ClientContext {
+  slots: SlotsLike
+  locale: LocaleLike
+  effect(execute: () => () => void, label?: string): unknown
+}
+
+export function apply(ctx: Context): void {
+  const c = ctx as unknown as ClientContext
+  const tag = injectStyle()
+  c.effect(
+    () => () => {
+      tag?.remove()
+    },
+    'llm-pi: style',
+  )
+  c.effect(
+    () => c.locale.register(NS, { zh, en }),
+    'llm-pi: locale',
+  )
+  c.slots.inject('settings.plugin.item', () =>
+    c.slots.register(
+      {
+        name: 'settings.plugin.item',
+        id: 'llm-pi',
+        order: 110,
+        locale: NS,
+        inject: () => ({ t: c.locale.bind(NS) }),
+      },
+      LlmPiCard,
+    ),
+  )
+}

package/src/client/constants.ts

@@ -0,0 +1,97 @@
+/**
+ * 浏览器半内联常量：与服务端 packages/llm-pi/src/config.ts、compat.ts 逐字对齐。
+ * 浏览器半不能 import 服务端模块（tsdown 只打包 client 侧入口），
+ * 改动服务端这些常量时必须同步本文件。
+ * @module llm-pi/client/constants
+ */
+
+/** 协议枚举（来源：config.ts PROTOCOL_IDS）。 */
+export const PROTOCOL_IDS = ['openai-completions', 'openai-responses', 'anthropic-messages'] as const
+
+/** thinking 档位（来源：config.ts THINKING_LEVELS）。 */
+export const THINKING_LEVELS = ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max'] as const
+
+/** 请求模态（来源：config.ts MODALITIES）。 */
+export const MODALITIES = ['text', 'image'] as const
+
+/** cacheRetention 枚举（来源：config.ts providerProfile.cacheRetention）。 */
+export const CACHE_RETENTION_OPTIONS = ['none', 'short', 'long'] as const
+
+/** transport 枚举（来源：config.ts providerProfile.transport）。 */
+export const TRANSPORT_OPTIONS = ['sse', 'websocket', 'websocket-cached', 'auto'] as const
+
+/** thinkingBudgets 档位键（来源：config.ts thinkingBudgets）。 */
+export const BUDGET_KEYS = ['minimal', 'low', 'medium', 'high'] as const
+
+type CompatValue = 'boolean' | 'object' | readonly string[]
+
+/** 逐协议 compat 字段表（来源：compat.ts FIELDS_BY_PROTOCOL）。 */
+const COMPAT_FIELDS: Record<string, Record<string, CompatValue>> = {
+  'openai-completions': {
+    supportsStore: 'boolean',
+    supportsDeveloperRole: 'boolean',
+    supportsReasoningEffort: 'boolean',
+    supportsUsageInStreaming: 'boolean',
+    maxTokensField: ['max_completion_tokens', 'max_tokens'],
+    requiresToolResultName: 'boolean',
+    requiresAssistantAfterToolResult: 'boolean',
+    requiresThinkingAsText: 'boolean',
+    requiresReasoningContentOnAssistantMessages: 'boolean',
+    thinkingFormat: [
+      'openai',
+      'openrouter',
+      'deepseek',
+      'together',
+      'zai',
+      'qwen',
+      'chat-template',
+      'qwen-chat-template',
+      'string-thinking',
+      'ant-ling',
+    ],
+    chatTemplateKwargs: 'object',
+    openRouterRouting: 'object',
+    vercelGatewayRouting: 'object',
+    zaiToolStream: 'boolean',
+    supportsOpenAIGrammarTools: 'boolean',
+    supportsStrictMode: 'boolean',
+    cacheControlFormat: ['anthropic'],
+    sendSessionAffinityHeaders: 'boolean',
+    deferredToolsMode: ['kimi'],
+    sessionAffinityFormat: ['openai', 'openai-nosession', 'openrouter'],
+    supportsLongCacheRetention: 'boolean',
+  },
+  'openai-responses': {
+    supportsDeveloperRole: 'boolean',
+    sessionAffinityFormat: ['openai', 'openai-nosession', 'openrouter'],
+    supportsLongCacheRetention: 'boolean',
+    supportsStrictMode: 'boolean',
+    supportsOpenAIGrammarTools: 'boolean',
+    supportsToolSearch: 'boolean',
+    supportsExplicitPromptCacheMode: 'boolean',
+  },
+  'anthropic-messages': {
+    supportsEagerToolInputStreaming: 'boolean',
+    supportsLongCacheRetention: 'boolean',
+    sendSessionAffinityHeaders: 'boolean',
+    supportsCacheControlOnTools: 'boolean',
+    supportsTemperature: 'boolean',
+    forceAdaptiveThinking: 'boolean',
+    allowEmptySignature: 'boolean',
+    supportsStrictTools: 'boolean',
+    supportsToolReferences: 'boolean',
+  },
+}
+
+/** 某协议的全部合法 compat 键（与服务端 compatFieldsOf 一致）。 */
+export function compatFieldsOf(api: string): readonly string[] {
+  return Object.keys(COMPAT_FIELDS[api] ?? {})
+}
+
+/** 某协议某字段的取值约束（与服务端 compatFieldSpec 一致）。 */
+export function compatFieldSpec(api: string, field: string): CompatValue | undefined {
+  return COMPAT_FIELDS[api]?.[field]
+}
+
+/** api 未设置时的渲染回退组（最常见的协议；保存仍由后端按实际协议校验）。 */
+export const COMPAT_FALLBACK_API = 'openai-completions'

package/src/client/draft.ts

@@ -0,0 +1,293 @@
+/**
+ * 可编辑草稿模型与 WireConfig ↔ Draft 双向转换。
+ * 设计：数值字段用字符串承载（'' = 未设置/不写入），多选枚举用布尔 map，
+ * 转换时剔除空值，保证 dirty 比较（toPatch 双侧）与保存形状稳定。
+ * @module llm-pi/client/draft
+ */
+import type { WireConfig, WireModel, WirePatchInput, WireProvider } from './api.ts'
+
+export interface HeaderPair {
+  key: string
+  value: string
+}
+
+export interface InputDraft {
+  text: boolean
+  image: boolean
+}
+
+export interface BudgetDraft {
+  minimal: string
+  low: string
+  medium: string
+  high: string
+}
+
+/** reasoningEfforts：false = 非推理模型；levels 键为档位，'' = 未设置。 */
+export interface ReasoningDraft {
+  nonReasoning: boolean
+  levels: Record<string, string>
+}
+
+export interface ModelDraft {
+  id: string
+  extends: string
+  name: string
+  contextWindow: string
+  maxTokens: string
+  input: InputDraft
+  reasoningEfforts: ReasoningDraft
+  compat: Record<string, unknown>
+}
+
+export interface ProviderDraft {
+  extends: string
+  displayName: string
+  api: string
+  baseURL: string
+  apiKeyEnv: string
+  headers: HeaderPair[]
+  compat: Record<string, unknown>
+  defaultContextWindow: string
+  defaultMaxTokens: string
+  input: InputDraft
+  reasoning: string
+  thinkingBudgets: BudgetDraft
+  cacheRetention: string
+  transport: string
+  timeoutMs: string
+  websocketConnectTimeoutMs: string
+  streamIdleTimeoutMs: string
+  retryPolicy: unknown
+  models: ModelDraft[]
+}
+
+export interface Draft {
+  enabled: boolean
+  catalogUrl: string
+  catalogRefreshHours: string
+  catalogProxy: string
+  providers: Record<string, ProviderDraft>
+}
+
+export function numToText(value: number | undefined): string {
+  return value === undefined ? '' : String(value)
+}
+
+/** 数字文本 → 数值；空串/非法返回 undefined（不写入）。 */
+export function toNum(text: string): number | undefined {
+  const trimmed = text.trim()
+  if (trimmed === '') return undefined
+  const value = Number(trimmed)
+  return Number.isFinite(value) ? value : undefined
+}
+
+export function numTextOk(text: string): boolean {
+  return text.trim() !== '' && Number.isFinite(Number(text.trim()))
+}
+
+export function headersToPairs(headers: Record<string, string> | undefined): HeaderPair[] {
+  return Object.entries(headers ?? {}).map(([key, value]) => ({ key, value }))
+}
+
+export function pairsToHeaders(pairs: HeaderPair[]): Record<string, string> | undefined {
+  const out: Record<string, string> = {}
+  for (const pair of pairs) {
+    if (pair.key.trim() !== '') out[pair.key.trim()] = pair.value
+  }
+  return Object.keys(out).length > 0 ? out : undefined
+}
+
+function inputFromWire(list: string[] | undefined): InputDraft {
+  return { text: list?.includes('text') ?? false, image: list?.includes('image') ?? false }
+}
+
+function inputToWire(input: InputDraft): string[] | undefined {
+  const out: string[] = []
+  if (input.text) out.push('text')
+  if (input.image) out.push('image')
+  return out.length > 0 ? out : undefined
+}
+
+function reasoningFromWire(value: false | Record<string, string | null> | undefined): ReasoningDraft {
+  if (value === false) return { nonReasoning: true, levels: {} }
+  const levels: Record<string, string> = {}
+  for (const [level, line] of Object.entries(value ?? {})) levels[level] = line ?? ''
+  return { nonReasoning: false, levels }
+}
+
+function reasoningToWire(value: ReasoningDraft): false | Record<string, string> | undefined {
+  if (value.nonReasoning) return false
+  const out: Record<string, string> = {}
+  for (const [level, line] of Object.entries(value.levels)) {
+    if (line.trim() !== '') out[level] = line.trim()
+  }
+  return Object.keys(out).length > 0 ? out : undefined
+}
+
+function budgetFromWire(value: { minimal: number; low: number; medium: number; high: number } | undefined): BudgetDraft {
+  return {
+    minimal: numToText(value?.minimal),
+    low: numToText(value?.low),
+    medium: numToText(value?.medium),
+    high: numToText(value?.high),
+  }
+}
+
+function budgetToWire(value: BudgetDraft): { minimal: number; low: number; medium: number; high: number } | undefined {
+  const out: Record<string, number> = {}
+  for (const key of ['minimal', 'low', 'medium', 'high'] as const) {
+    const num = toNum(value[key])
+    if (num !== undefined) out[key] = num
+  }
+  return Object.keys(out).length > 0 ? (out as { minimal: number; low: number; medium: number; high: number }) : undefined
+}
+
+/** 剔除空值：undefined / '' / 空数组 / 空对象。 */
+function omitEmpty(obj: Record<string, unknown>): Record<string, unknown> {
+  const out: Record<string, unknown> = {}
+  for (const [key, value] of Object.entries(obj)) {
+    if (value === undefined || value === '') continue
+    if (Array.isArray(value) && value.length === 0) continue
+    if (typeof value === 'object' && value !== null && Object.keys(value).length === 0) continue
+    out[key] = value
+  }
+  return out
+}
+
+function modelDraftFromWire(model: WireModel): ModelDraft {
+  return {
+    id: model.id,
+    extends: model.extends ?? '',
+    name: model.name ?? '',
+    contextWindow: numToText(model.contextWindow),
+    maxTokens: numToText(model.maxTokens),
+    input: inputFromWire(model.input),
+    reasoningEfforts: reasoningFromWire(model.reasoningEfforts),
+    compat: { ...(model.compat ?? {}) },
+  }
+}
+
+function modelToWire(model: ModelDraft): WireModel {
+  const reasoningEfforts = reasoningToWire(model.reasoningEfforts)
+  return omitEmpty({
+    id: model.id.trim(),
+    extends: model.extends.trim(),
+    name: model.name.trim(),
+    contextWindow: toNum(model.contextWindow),
+    maxTokens: toNum(model.maxTokens),
+    input: inputToWire(model.input),
+    ...(reasoningEfforts === undefined ? {} : { reasoningEfforts }),
+    compat: model.compat,
+  }) as WireModel
+}
+
+function providerDraftFromWire(provider: WireProvider): ProviderDraft {
+  return {
+    extends: provider.extends ?? '',
+    displayName: provider.displayName ?? '',
+    api: provider.api ?? '',
+    baseURL: provider.baseURL ?? '',
+    apiKeyEnv: provider.apiKeyEnv ?? '',
+    headers: headersToPairs(provider.headers),
+    compat: { ...(provider.compat ?? {}) },
+    defaultContextWindow: numToText(provider.defaultContextWindow),
+    defaultMaxTokens: numToText(provider.defaultMaxTokens),
+    input: inputFromWire(provider.defaultInput),
+    reasoning: provider.reasoning ?? '',
+    thinkingBudgets: budgetFromWire(provider.thinkingBudgets),
+    cacheRetention: provider.cacheRetention ?? '',
+    transport: provider.transport ?? '',
+    timeoutMs: numToText(provider.timeoutMs),
+    websocketConnectTimeoutMs: numToText(provider.websocketConnectTimeoutMs),
+    streamIdleTimeoutMs: numToText(provider.streamIdleTimeoutMs),
+    retryPolicy: provider.retryPolicy,
+    models: (provider.models ?? []).map(modelDraftFromWire),
+  }
+}
+
+function providerToWire(provider: ProviderDraft): WireProvider {
+  return omitEmpty({
+    extends: provider.extends.trim(),
+    displayName: provider.displayName.trim(),
+    api: provider.api,
+    baseURL: provider.baseURL.trim(),
+    apiKeyEnv: provider.apiKeyEnv.trim(),
+    headers: pairsToHeaders(provider.headers),
+    compat: provider.compat,
+    defaultContextWindow: toNum(provider.defaultContextWindow),
+    defaultMaxTokens: toNum(provider.defaultMaxTokens),
+    input: inputToWire(provider.input),
+    reasoning: provider.reasoning,
+    thinkingBudgets: budgetToWire(provider.thinkingBudgets),
+    cacheRetention: provider.cacheRetention,
+    transport: provider.transport,
+    timeoutMs: toNum(provider.timeoutMs),
+    websocketConnectTimeoutMs: toNum(provider.websocketConnectTimeoutMs),
+    streamIdleTimeoutMs: toNum(provider.streamIdleTimeoutMs),
+    retryPolicy: provider.retryPolicy,
+    models: provider.models.map(modelToWire),
+  }) as WireProvider
+}
+
+export function emptyProviderDraft(): ProviderDraft {
+  return {
+    extends: '',
+    displayName: '',
+    api: '',
+    baseURL: '',
+    apiKeyEnv: '',
+    headers: [],
+    compat: {},
+    defaultContextWindow: '',
+    defaultMaxTokens: '',
+    input: { text: false, image: false },
+    reasoning: '',
+    thinkingBudgets: { minimal: '', low: '', medium: '', high: '' },
+    cacheRetention: '',
+    transport: '',
+    timeoutMs: '',
+    websocketConnectTimeoutMs: '',
+    streamIdleTimeoutMs: '',
+    retryPolicy: undefined,
+    models: [],
+  }
+}
+
+export function emptyModelDraft(): ModelDraft {
+  return {
+    id: '',
+    extends: '',
+    name: '',
+    contextWindow: '',
+    maxTokens: '',
+    input: { text: false, image: false },
+    reasoningEfforts: { nonReasoning: false, levels: {} },
+    compat: {},
+  }
+}
+
+export function draftFromWire(wire: WireConfig): Draft {
+  return {
+    enabled: wire.enabled,
+    catalogUrl: wire.catalogUrl,
+    catalogRefreshHours: String(wire.catalogRefreshHours),
+    catalogProxy: wire.catalogProxy,
+    providers: Object.fromEntries(
+      Object.entries(wire.providers).map(([route, provider]) => [route, providerDraftFromWire(provider)]),
+    ),
+  }
+}
+
+/** 提交补丁：完整配置对象，providers 全量替换；空值一律剔除。 */
+export function toPatch(draft: Draft): WirePatchInput {
+  return {
+    enabled: draft.enabled,
+    catalogUrl: draft.catalogUrl.trim(),
+    catalogRefreshHours: toNum(draft.catalogRefreshHours),
+    catalogProxy: draft.catalogProxy.trim(),
+    providers: Object.fromEntries(
+      Object.entries(draft.providers).map(([route, provider]) => [route, providerToWire(provider)]),
+    ),
+  }
+}