@waterwx/dsh-novel-forge 1.3.1 → 1.3.2-alpha

package/src/client/panel/MarketRadarView.tsx

@@ -0,0 +1,377 @@
+/**
+ * 「热门题材雷达」：对齐上游市场雷达页（真实榜单扫榜 → 候选勾选 → 分析 → 信号卡片 → 影响模式 → 用信号创作）。
+ */
+import { useMemo, useState } from 'react'
+import type { NovelApi } from '../api.ts'
+import type { MarketRadarResult, MarketCreativeBrief, IdeaInspirationResult } from '../../protocol.ts'
+import css from './panel.module.css'
+import { SubPage } from './SubPage.tsx'
+
+const PLATFORMS = ['fanqie', 'qidian', 'jinjiang']
+const PLATFORM_LABELS: Record<string, string> = { fanqie: '番茄小说', qidian: '起点中文网', jinjiang: '晋江文学城' }
+const MAX_SIGNALS = 5
+
+interface ScanItem { rank: number; title: string; author?: string; tags?: string[]; synopsis?: string; category?: string; heatLabel?: string }
+interface ScanGroup { platform: string; platformLabel: string; listKey: string; listLabel: string; status: 'ok' | 'error'; error?: string; items: ScanItem[] }
+
+const KIND_LABELS: Record<string, string> = {
+  genre: '题材', protagonist: '主角', advantage: '金手指', opening: '开篇', relationship: '关系', title_pattern: '标题', opportunity: '机会', crowding: '拥挤',
+}
+const MODE_LABELS: Record<string, string> = {
+  follow_hot: '跟随热门',
+  differentiate: '差异化',
+  light: '轻度参考',
+}
+
+export default function MarketRadarView({ api, bookId }: { api: NovelApi; bookId?: string }): JSX.Element {
+  const [platforms, setPlatforms] = useState<string[]>(['fanqie', 'qidian', 'jinjiang'])
+  const [feedText, setFeedText] = useState('')
+  const [scanGroups, setScanGroups] = useState<ScanGroup[] | null>(null)
+  const [selectedCandidates, setSelectedCandidates] = useState<Set<string>>(new Set())
+  const [viewPlatform, setViewPlatform] = useState('fanqie')
+  const [scanning, setScanning] = useState(false)
+  const [analyzing, setAnalyzing] = useState(false)
+  const [error, setError] = useState('')
+  const [result, setResult] = useState<MarketRadarResult | null>(null)
+  const [selectedIds, setSelectedIds] = useState<Set<string>>(new Set())
+  const [influenceMode, setInfluenceMode] = useState<'follow_hot' | 'differentiate' | 'light'>('differentiate')
+  const [briefBusy, setBriefBusy] = useState(false)
+  const [brief, setBrief] = useState<MarketCreativeBrief | null>(null)
+  const [ideas, setIdeas] = useState<IdeaInspirationResult['ideas'] | null>(null)
+  const [ideaBusy, setIdeaBusy] = useState(false)
+  const [applyBusy, setApplyBusy] = useState(false)
+  const [applied, setApplied] = useState('')
+  const [syncBusy, setSyncBusy] = useState(false)
+  const [syncedMsg, setSyncedMsg] = useState('')
+
+  const candKey = (g: ScanGroup, item: ScanItem): string => `${g.platform}:${g.listKey}:${item.rank}`
+  const togglePlatform = (p: string): void => {
+    setPlatforms(prev => prev.includes(p) ? (prev.length === 1 ? prev : prev.filter(x => x !== p)) : [...prev, p])
+  }
+  const platformList = useMemo(() => {
+    const set = new Set((scanGroups ?? []).map(g => g.platform))
+    return PLATFORMS.filter(p => set.has(p))
+  }, [scanGroups])
+
+  const scan = async (): Promise<void> => {
+    setScanning(true)
+    setError('')
+    setResult(null)
+    setBrief(null)
+    try {
+      const r = await api.marketRadarScan({ platforms })
+      const groups = r.result.groups
+      setScanGroups(groups)
+      const firstP = PLATFORMS.find(p => groups.some(g => g.platform === p))
+      if (firstP !== undefined) setViewPlatform(firstP)
+      // 默认不自动全选，交给用户手动勾选或用「全选」按钮。
+      setSelectedCandidates(new Set())
+    } catch (err) {
+      setError((err as Error).message)
+    } finally {
+      setScanning(false)
+    }
+  }
+
+  const toggleCandidate = (key: string): void => {
+    setSelectedCandidates(prev => {
+      const next = new Set(prev)
+      if (next.has(key)) next.delete(key)
+      else next.add(key)
+      return next
+    })
+  }
+
+  const selectAll = (): void => {
+    const next = new Set<string>()
+    for (const g of scanGroups ?? []) if (g.platform === viewPlatform && g.status === 'ok') for (const it of g.items) next.add(candKey(g, it))
+    setSelectedCandidates(next)
+  }
+
+  const clearSelection = (): void => setSelectedCandidates(new Set())
+
+  const selectGroup = (g: ScanGroup): void => {
+    setSelectedCandidates(prev => {
+      const next = new Set(prev)
+      for (const it of g.items) next.add(candKey(g, it))
+      return next
+    })
+  }
+
+  const analyze = async (): Promise<void> => {
+    if (scanGroups === null) return
+    const candidates: Array<{ title: string; author?: string; tags?: string[]; synopsis?: string; category?: string }> = []
+    for (const g of scanGroups) if (g.status === 'ok') for (const it of g.items) if (selectedCandidates.has(candKey(g, it))) candidates.push({ title: it.title, author: it.author, tags: it.tags, synopsis: it.synopsis, category: it.category })
+    setAnalyzing(true)
+    setError('')
+    setBrief(null)
+    try {
+      const r = await api.marketRadar({ candidates, feedText: feedText.trim() })
+      setResult(r.result)
+      const rec = r.result.signals.filter(s => s.recommended === true).map(s => s.id)
+      setSelectedIds(new Set(rec.slice(0, MAX_SIGNALS)))
+    } catch (err) {
+      setError((err as Error).message)
+    } finally {
+      setAnalyzing(false)
+    }
+  }
+
+  const toggleSignal = (id: string): void => {
+    setSelectedIds(prev => {
+      const next = new Set(prev)
+      if (next.has(id)) next.delete(id)
+      else if (next.size < MAX_SIGNALS) next.add(id)
+      return next
+    })
+  }
+
+  const createBrief = async (): Promise<void> => {
+    if (result === null) return
+    const signals = result.signals.filter(s => selectedIds.has(s.id))
+    setBriefBusy(true)
+    setError('')
+    try {
+      const r = await api.marketRadarBrief({ influenceMode, signals })
+      setBrief(r.creativeBrief)
+    } catch (err) {
+      setError((err as Error).message)
+    } finally {
+      setBriefBusy(false)
+    }
+  }
+
+  const createIdeas = async (): Promise<void> => {
+    if (result === null) return
+    const signals = result.signals.filter(s => selectedIds.has(s.id))
+    setIdeaBusy(true)
+    setError('')
+    try {
+      const r = await api.marketIdeaInspiration({ signals, foundation: result.productionFoundation, brief: brief ?? undefined, count: 5 })
+      setIdeas(r.result.ideas)
+    } catch (err) {
+      setError((err as Error).message)
+    } finally {
+      setIdeaBusy(false)
+    }
+  }
+
+  const apply = async (): Promise<void> => {
+    if (result === null) return
+    setApplyBusy(true)
+    setError('')
+    setApplied('')
+    try {
+      const r = await api.marketRadarApply({ bookId, foundation: result.productionFoundation })
+      setApplied(` 已应用到《${r.bookName}》：后续规划/生成将按此题材与推进模式。`)
+    } catch (err) {
+      setError((err as Error).message)
+    } finally {
+      setApplyBusy(false)
+    }
+  }
+
+  const sync = async (): Promise<void> => {
+    if (result === null) return
+    setSyncBusy(true)
+    setError('')
+    setSyncedMsg('')
+    try {
+      const r = await api.marketRadarSync({ foundation: result.productionFoundation })
+      const parts: string[] = []
+      if (r.synced.genre) parts.push('题材')
+      if (r.synced.primaryMode) parts.push('主推进')
+      if (r.synced.secondaryMode) parts.push('辅推进')
+      setSyncedMsg(parts.length > 0 ? ` 已同步到全局资源库：${parts.join('、')}` : '已在资源库中，无新增。')
+    } catch (err) {
+      setError((err as Error).message)
+    } finally {
+      setSyncBusy(false)
+    }
+  }
+
+  const badge = (kind: string): string => (kind === 'opportunity' ? 'var(--nf-success)' : kind === 'crowding' ? 'var(--nf-error)' : 'var(--nf-accent)')
+
+  return (
+    <SubPage
+      title="热门题材雷达"
+      meta="扫榜 → 选候选 → 分析 → 拿本期判断与可用信号，影响后续开书的题材与推进。"
+    >
+      {/* 平台扫榜 */}
+      <div className={`${css.card} ${css.settingsCard}`} style={{ gap: 'var(--nf-space-12)' }}>
+        <div style={{ display: 'flex', flexWrap: 'wrap', gap: 'var(--nf-space-6)' }}>
+          {PLATFORMS.map(p => (
+            <button key={p} type="button" onClick={() => togglePlatform(p)} style={{ padding: '4px 12px', borderRadius: 999, border: '1px solid var(--nf-border)', cursor: 'pointer', background: platforms.includes(p) ? 'var(--nf-accent-soft)' : 'var(--nf-bg-inset)', color: 'var(--nf-text)', fontWeight: platforms.includes(p) ? 600 : 400 }}>
+              {PLATFORM_LABELS[p]}
+            </button>
+          ))}
+        </div>
+        <div style={{ display: 'flex', flexDirection: 'column', gap: 'var(--nf-space-6)' }}>
+          <label className={css.fieldLabel}>榜单文本兜底（可选，粘贴公开榜单文本；扫榜失败时可用于人工候选）</label>
+          <textarea className={css.input} style={{ minHeight: 90, resize: 'vertical' }} value={feedText} onChange={e => setFeedText(e.target.value)} placeholder="粘贴一份公开榜单文本…" />
+        </div>
+        <div style={{ display: 'flex', alignItems: 'center', gap: 8, flexWrap: 'wrap' }}>
+          <button type="button" className={`${css.button} ${css.buttonPrimary}`} disabled={scanning} onClick={() => { void scan() }}>
+            {scanning ? '正在扫榜…' : '扫榜'}
+          </button>
+          {scanning && <span style={{ fontSize: 12, color: 'var(--nf-text-2)' }}>正在抓取公开榜单（{platforms.map(p => PLATFORM_LABELS[p]).join('、')}），多平台并行，约 10–30 秒…</span>}
+          {scanGroups !== null && (
+            <button type="button" className={css.button} style={{ marginLeft: 8 }} disabled={analyzing || selectedCandidates.size === 0} onClick={() => { void analyze() }}>
+              {analyzing ? '分析中…' : `开始 分析（${selectedCandidates.size} 本）`}
+            </button>
+          )}
+        </div>
+      </div>
+
+      {error !== '' && <div style={{ color: 'var(--nf-error)', fontSize: 13 }}> {error}</div>}
+
+      {/* 榜单候选：平台 tabs 切换 + 平台内榜单横排(最多三列) + 每列 10 条可滚 */}
+      {scanGroups !== null && (
+        <div className={`${css.card} ${css.settingsCard}`} style={{ gap: 'var(--nf-space-10)' }}>
+          <span className={css.cardTitle}>公开榜单候选</span>
+          <div style={{ display: 'flex', flexWrap: 'wrap', gap: 'var(--nf-space-6)' }}>
+            {platformList.map(p => {
+              const active = viewPlatform === p
+              const count = (scanGroups ?? []).filter(g => g.platform === p && g.status === 'ok').reduce((a, g) => a + g.items.length, 0)
+              return (
+                <button key={p} type="button" onClick={() => setViewPlatform(p)} style={{ padding: '4px 12px', borderRadius: 999, border: '1px solid ' + (active ? 'var(--nf-accent)' : 'var(--nf-border)'), cursor: 'pointer', background: active ? 'var(--nf-accent-soft)' : 'var(--nf-bg-inset)', color: 'var(--nf-text)', fontWeight: active ? 600 : 400 }}>
+                  {PLATFORM_LABELS[p]} ({count})
+                </button>
+              )
+            })}
+          </div>
+          <div style={{ display: 'flex', alignItems: 'center', gap: 8, flexWrap: 'wrap' }}>
+            <button type="button" className={`${css.button} ${css.buttonSmall}`} onClick={selectAll}>全选当前平台</button>
+            <button type="button" className={`${css.button} ${css.buttonSmall}`} onClick={clearSelection}>清空</button>
+            <span style={{ fontSize: 11, color: 'var(--nf-text-2)' }}>已选 {selectedCandidates.size} 条</span>
+          </div>
+          <div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(340px, 1fr))', gap: 'var(--nf-space-10)' }}>
+            {(scanGroups ?? []).filter(g => g.platform === viewPlatform).map(g => (
+              <div key={`${g.platform}:${g.listKey}`} style={{ border: '1px solid var(--nf-border)', borderRadius: 10, padding: 'var(--nf-space-8)', background: 'var(--nf-bg-inset)', display: 'flex', flexDirection: 'column', minHeight: 0 }}>
+                <div style={{ display: 'flex', alignItems: 'center', gap: 8, fontSize: 13, fontWeight: 600 }}>
+                  {g.listLabel}
+                  <span style={{ fontSize: 10, padding: '1px 6px', borderRadius: 99, color: g.status === 'ok' ? 'var(--nf-success)' : 'var(--nf-error)', background: g.status === 'ok' ? 'rgba(79,191,139,0.14)' : 'rgba(212,99,79,0.16)' }}>{g.status === 'ok' ? `${g.items.length} 条` : '读取失败'}</span>
+                  {g.status === 'ok' && <button type="button" className={`${css.button} ${css.buttonSmall}`} onClick={() => selectGroup(g)}>全选本榜</button>}
+                </div>
+                {g.status === 'error' && <div style={{ fontSize: 11, color: 'var(--nf-error)', marginTop: 4 }}>{g.error}</div>}
+                {g.status === 'ok' && (
+                  <div style={{ marginTop: 6, maxHeight: 400, overflowY: 'auto', display: 'flex', flexDirection: 'column' }}>
+                    {g.items.map(it => {
+                      const key = candKey(g, it)
+                      const sel = selectedCandidates.has(key)
+                      return (
+                        <label key={key} onClick={e => { if ((e.target as HTMLElement).tagName !== 'INPUT') toggleCandidate(key) }} style={{ display: 'flex', alignItems: 'flex-start', gap: 7, padding: '5px 2px', fontSize: 13.5, cursor: 'pointer' }}>
+                          <input type="checkbox" checked={sel} onChange={() => toggleCandidate(key)} onClick={e => e.stopPropagation()} style={{ marginTop: 3 }} />
+                          <span style={{ lineHeight: 1.5 }}>
+                            <b style={{ fontSize: 14 }}>{it.rank}. {it.title}</b>
+                            {it.author !== undefined && it.author !== '' ? <span style={{ color: 'var(--nf-text-2)', fontSize: 12.5 }}>（{it.author}）</span> : null}
+                            {(it.tags ?? []).length > 0 ? <span style={{ color: 'var(--nf-info)', fontSize: 12.5 }}> [{it.tags!.slice(0, 3).join('、')}]</span> : null}
+                          </span>
+                        </label>
+                      )
+                    })}
+                  </div>
+                )}
+              </div>
+            ))}
+          </div>
+        </div>
+      )}
+
+      {/* 本期判断 + 信号 */}
+      {result !== null && (
+        <>
+          <div className={`${css.card} ${css.settingsCard}`} style={{ gap: 'var(--nf-space-10)' }}>
+            <span className={css.cardTitle}>本期判断</span>
+            <div style={{ fontSize: 13, lineHeight: 1.7 }}>
+              <div><span style={{ color: 'var(--nf-text-2)' }}>题材基底：</span>{result.productionFoundation.genre.name}（{result.productionFoundation.genre.description}）</div>
+              <div><span style={{ color: 'var(--nf-text-2)' }}>主要推进：</span>{result.productionFoundation.primaryStoryMode.name} —— {result.productionFoundation.primaryStoryMode.driver}</div>
+              {result.productionFoundation.secondaryStoryMode !== undefined && (
+                <div><span style={{ color: 'var(--nf-text-2)' }}>辅助推进：</span>{result.productionFoundation.secondaryStoryMode.name} —— {result.productionFoundation.secondaryStoryMode.driver}</div>
+              )}
+            </div>
+            <div style={{ display: 'flex', alignItems: 'flex-start', gap: 'var(--nf-space-8)', flexWrap: 'wrap' }}>
+              <button type="button" className={`${css.button} ${css.buttonPrimary}`} disabled={applyBusy} onClick={() => { void apply() }}>
+                {applyBusy ? '应用…' : '应用到当前书'}
+              </button>
+              <button type="button" className={css.button} disabled={syncBusy} onClick={() => { void sync() }}>
+                {syncBusy ? '同步…' : '同步到全局资源库'}
+              </button>
+              <div style={{ display: 'flex', flexDirection: 'column', gap: 2 }}>
+                {applied !== '' && <span style={{ fontSize: 12, color: 'var(--nf-success)' }}>{applied}</span>}
+                {syncedMsg !== '' && <span style={{ fontSize: 12, color: 'var(--nf-info)' }}>{syncedMsg}</span>}
+              </div>
+            </div>
+          </div>
+
+          <div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(240px, 1fr))', gap: 'var(--nf-space-10)' }}>
+            {result.signals.map(s => {
+              const selected = selectedIds.has(s.id)
+              return (
+                <article key={s.id} onClick={() => toggleSignal(s.id)} style={{ border: '1px solid var(--nf-border)', borderRadius: 12, padding: 'var(--nf-space-12)', cursor: 'pointer', background: selected ? 'var(--nf-accent-soft)' : 'var(--nf-bg)', boxShadow: selected ? '0 0 0 2px var(--nf-accent)' : 'none' }}>
+                  <div style={{ display: 'flex', alignItems: 'center', justifyContent: 'space-between', gap: 8 }}>
+                    <span style={{ fontSize: 11, fontWeight: 600, padding: '1px 7px', borderRadius: 99, color: '#fff', background: badge(s.kind) }}>{KIND_LABELS[s.kind] ?? s.kind}</span>
+                    {selected && <span style={{ fontSize: 11, color: 'var(--nf-accent)', fontWeight: 600 }}>已选</span>}
+                  </div>
+                  <div style={{ marginTop: 8, fontSize: 15, fontWeight: 600 }}>{s.title}</div>
+                  <p style={{ marginTop: 6, fontSize: 12, color: 'var(--nf-text-2)', lineHeight: 1.6 }}>{s.detail}</p>
+                  <div style={{ marginTop: 8, display: 'flex', gap: 10, fontSize: 11, color: 'var(--nf-text-2)' }}>
+                    <span>{s.direction === 'rising' ? '正在升温' : s.direction === 'falling' ? '正在降温' : s.direction === 'stable' ? '相对稳定' : '当前高频'}</span>
+                    {s.recommended === true && <span style={{ color: 'var(--nf-success)' }}>★推荐</span>}
+                  </div>
+                </article>
+              )
+            })}
+          </div>
+        </>
+      )}
+
+      {/* 底部：影响模式 + 用信号创作 */}
+      {result !== null && (
+        <div style={{ position: 'sticky', bottom: 12, display: 'flex', alignItems: 'center', justifyContent: 'space-between', gap: 12, flexWrap: 'wrap', padding: 'var(--nf-space-10) var(--nf-space-12)', border: '1px solid var(--nf-accent)', borderRadius: 12, background: 'color-mix(in srgb, var(--nf-bg) 92%, transparent)', backdropFilter: 'blur(6px)', boxShadow: 'var(--nf-shadow)' }}>
+          <div>
+            <div style={{ fontSize: 13, fontWeight: 600 }}>已选 {selectedIds.size}/{MAX_SIGNALS} 项市场信号</div>
+            <div style={{ fontSize: 11, color: 'var(--nf-text-2)' }}>推荐已自动勾选，可替换后再开书。</div>
+          </div>
+          <div style={{ display: 'flex', gap: 8, alignItems: 'center', flexWrap: 'wrap' }}>
+            <select className={css.input} style={{ width: 'auto', padding: '4px 8px' }} value={influenceMode} onChange={e => setInfluenceMode(e.target.value as 'follow_hot' | 'differentiate' | 'light')}>
+              {Object.entries(MODE_LABELS).map(([v, l]) => <option key={v} value={v}>{l}</option>)}
+            </select>
+            <button type="button" className={`${css.button} ${css.buttonPrimary}`} disabled={selectedIds.size === 0 || briefBusy} onClick={() => { void createBrief() }}>
+              {briefBusy ? '生成中…' : '用这些信号创作'}
+            </button>
+          </div>
+        </div>
+      )}
+
+      {brief !== null && (
+        <div className={`${css.card} ${css.settingsCard}`} style={{ gap: 'var(--nf-space-10)' }}>
+          <span className={css.cardTitle}> 开书创意简报</span>
+          <div style={{ display: 'flex', flexDirection: 'column', gap: 'var(--nf-space-8)', fontSize: 13, lineHeight: 1.7 }}>
+            <div><b>创作约束</b>：{brief.promptBlock}</div>
+            <div><b>开篇想法</b>：{brief.openingIdea}</div>
+            <div><b>核心优势</b>：{brief.coreAdvantage}</div>
+            <div><b>追读卖点</b>：{brief.bookSellingPoint}</div>
+            <div><b>前30章承诺</b>：{brief.first30ChapterPromise}</div>
+          </div>
+          <button type="button" className={`${css.button} ${css.buttonPrimary}`} disabled={ideaBusy || selectedIds.size === 0} onClick={() => { void createIdeas() }}>
+            {ideaBusy ? '生成灵感中…' : ' 用这些信号生成灵感'}
+          </button>
+        </div>
+      )}
+
+      {ideas !== null && ideas.length > 0 && (
+        <div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(260px, 1fr))', gap: 'var(--nf-space-10)' }}>
+          {ideas.map((it, i) => (
+            <div key={i} className={`${css.card} ${css.settingsCard}`} style={{ gap: 'var(--nf-space-6)' }}>
+              <div style={{ fontSize: 15, fontWeight: 600 }}>{it.title}</div>
+              <div style={{ fontSize: 12, color: 'var(--nf-success)' }}>{it.genre} · {it.pov}</div>
+              <div style={{ fontSize: 13 }}>钩子：{it.hook}</div>
+              <div style={{ fontSize: 12, color: 'var(--nf-text-2)' }}>兑现：{it.payoff}</div>
+            </div>
+          ))}
+        </div>
+      )}
+    </SubPage>
+  )
+}

package/src/client/panel/ModelManager.tsx

@@ -0,0 +1,205 @@
+/**
+ * 模型管理（DSH 风格）：两块分区——
+ * ① 模型（提供方管理）：提供方卡片（编辑/删除）+ 添加提供方 / 添加自定义提供方；
+ * ② 当前写作模型：提供商/模型下拉 + 测试连通 + 推理强度。
+ */
+import { useCallback, useEffect, useState } from 'react'
+import { PlugZap, Plus, RefreshCw, X } from 'lucide-react'
+import type { NovelApi } from '../api.ts'
+import type { SavedModel, LlmModelOption, LlmVendorOption } from '../../protocol.ts'
+import { LLM_VENDORS } from '../../protocol.ts'
+import { tt } from './helpers.ts'
+import css from './panel.module.css'
+
+/** 目录不可用时回退的内置预设（对齐当前模型目录）。 */
+export const FALLBACK_MODEL_PRESETS = ['deepseek-flash', 'deepseek-v4-pro', 'deepseek-chat', 'deepseek-reasoner'] as const
+
+const CUSTOM = '__custom__'
+interface TestState { testing: boolean; ok?: boolean; ms?: number; message?: string }
+interface ProviderInfo { id: string; name: string }
+type AddPanel = 'none' | 'standard' | 'custom'
+
+export interface ModelManagerProps {
+  api: NovelApi
+  provider: string
+  model: string
+  savedModels: SavedModel[]
+  onProvider: (provider: string) => void
+  onModel: (model: string) => void
+  onSavedModels: (models: SavedModel[]) => void
+}
+
+function fallbackVendors(): LlmVendorOption[] {
+  return LLM_VENDORS.map(v => ({ id: v.route, name: v.name, models: v.models, apiKeyEnv: v.apiKeyEnv, builtin: v.builtin }))
+}
+
+export function ModelManager({ api, provider, model, onProvider, onModel }: ModelManagerProps): JSX.Element {
+  // ---- 当前写作模型
+  const [configuredProviders, setConfiguredProviders] = useState<ProviderInfo[]>([])
+  const [providerModels, setProviderModels] = useState<LlmModelOption[]>([])
+  const [modelsLoading, setModelsLoading] = useState(false)
+  const [providerCustom, setProviderCustom] = useState(false)
+  const [modelCustom, setModelCustom] = useState(false)
+  const [test, setTest] = useState<TestState>({ testing: false })
+
+  // ---- 提供方管理
+  const [vendors, setVendors] = useState<LlmVendorOption[]>(fallbackVendors())
+  const [addPanel, setAddPanel] = useState<AddPanel>('none')
+  const [editTarget, setEditTarget] = useState('')
+  const [vendorId, setVendorId] = useState('zai-coding-cn')
+  const [addModel, setAddModel] = useState('')
+  const [addApiKey, setAddApiKey] = useState('')
+  const [addName, setAddName] = useState('')
+  const [custProvider, setCustProvider] = useState('')
+  const [custName, setCustName] = useState('')
+  const [custBaseURL, setCustBaseURL] = useState('')
+  const [custProtocol, setCustProtocol] = useState('openai-completions')
+  const [custModel, setCustModel] = useState('')
+  const [custApiKey, setCustApiKey] = useState('')
+  const [savingAdd, setSavingAdd] = useState(false)
+  const [addMsg, setAddMsg] = useState('')
+  const [addErr, setAddErr] = useState('')
+
+
+  const loadProviders = useCallback(async (): Promise<void> => {
+    try { const r = await api.llmProviders(); if (r.providers.length > 0) setConfiguredProviders(r.providers) } catch { /* 兜底 */ }
+  }, [api])
+  const loadVendors = useCallback(async (): Promise<void> => {
+    try { const r = await api.llmVendors(); if (r.vendors.length > 0) setVendors(r.vendors) } catch { /* 静态兜底 */ }
+  }, [api])
+  const loadProviderModels = useCallback(async (p: string): Promise<void> => {
+    setModelsLoading(true)
+    try { const r = await api.llmModels(p); setProviderModels(r.models) } catch { setProviderModels([]) } finally { setModelsLoading(false) }
+  }, [api])
+
+  useEffect(() => { void loadProviders(); void loadVendors() }, [api, loadProviders, loadVendors])
+  useEffect(() => { if (provider !== '') void loadProviderModels(provider) }, [provider, loadProviderModels])
+
+  const currentVendor = vendors.find(v => v.id === vendorId)
+
+  const runTest = async (): Promise<void> => {
+    const p = provider.trim(); const m = model.trim()
+    if (p === '' || m === '' || test.testing) return
+    setTest({ testing: true })
+    try { const r = await api.llmTest(p, m); setTest({ testing: false, ok: r.ok, ms: r.ms, message: r.message }) }
+    catch (err) { setTest({ testing: false, ok: false, message: (err as Error).message }) }
+  }
+
+  const openPanel = (panel: AddPanel, target = ''): void => {
+    setAddPanel(panel); setEditTarget(target); setAddMsg(''); setAddErr('')
+    if (panel === 'standard') { setVendorId(target !== '' ? target : 'zai-coding-cn'); setAddModel(''); setAddApiKey(''); setAddName('') }
+    else if (panel === 'custom') { setCustProvider(target); setCustName(''); setCustBaseURL(''); setCustModel(''); setCustApiKey('') }
+  }
+
+  const saveStandard = async (): Promise<void> => {
+    if (vendorId.trim() === '') { setAddErr('请选择提供方'); return }
+    if (addApiKey.trim() === '') { setAddErr('请填写 API 密钥（或留空使用环境认证）'); return }
+    const modelId = addModel.trim()
+    setSavingAdd(true); setAddMsg(''); setAddErr('')
+    try {
+      const res = await api.addModel({ mode: 'vendor', vendor: vendorId, model: modelId || vendorId, apiKey: addApiKey.trim(), apiKeyEnv: currentVendor?.apiKeyEnv, name: addName.trim() || undefined })
+      setAddMsg(res.message ?? '已保存'); setAddPanel('none'); setAddApiKey(''); setAddModel(''); setAddName(''); setEditTarget('')
+      await loadProviders()
+    } catch (err) { setAddErr((err as Error).message) } finally { setSavingAdd(false) }
+  }
+
+  const saveCustom = async (): Promise<void> => {
+    if (custProvider.trim() === '') { setAddErr('请填 Provider ID'); return }
+    if (custBaseURL.trim() === '') { setAddErr('请填 API 地址'); return }
+    if (custApiKey.trim() === '') { setAddErr('请填 API 密钥（或留空使用环境认证）'); return }
+    if (custModel.trim() === '') { setAddErr('请填模型 id（或点“获取可用模型”）'); return }
+    setSavingAdd(true); setAddMsg(''); setAddErr('')
+    try {
+      const res = await api.addModel({ mode: 'custom', provider: custProvider.trim(), model: custModel.trim(), apiKey: custApiKey.trim(), baseURL: custBaseURL.trim(), name: custName.trim() || undefined })
+      setAddMsg(res.message ?? '已创建提供方'); setAddPanel('none'); setCustProvider(''); setCustName(''); setCustBaseURL(''); setCustModel(''); setCustApiKey('')
+      await loadProviders()
+    } catch (err) { setAddErr((err as Error).message) } finally { setSavingAdd(false) }
+  }
+
+  const removeProvider = async (p: ProviderInfo): Promise<void> => {
+    if (!window.confirm('删除提供方「' + (p.name !== '' ? p.name : p.id) + '」？将移除 DSH 配置与 API 密钥。')) return
+    try { const vendor = vendors.find(v => v.id === p.id); await api.removeProvider({ provider: p.id, apiKeyEnv: vendor?.apiKeyEnv }); await loadProviders() }
+    catch (err) { setAddErr((err as Error).message) }
+  }
+
+
+  const providerOptions: ProviderInfo[] = configuredProviders.some(p => p.id === provider) ? configuredProviders : (provider !== '' && provider !== CUSTOM ? [{ id: provider, name: provider }, ...configuredProviders] : configuredProviders)
+
+  const modelOptions: LlmModelOption[] = modelCustom ? [] : (provider === 'deepseek-official'
+    ? [...FALLBACK_MODEL_PRESETS.map(id => ({ id, name: id })), ...providerModels.filter(m => !(FALLBACK_MODEL_PRESETS as readonly string[]).includes(m.id))]
+    : providerModels)
+  const modelInList = modelOptions.some(m => m.id === model)
+  const modelValue = modelCustom || (!modelInList && model !== '' && modelOptions.length > 0) ? CUSTOM : model
+  const providerValue = providerCustom ? CUSTOM : provider
+
+
+  return (
+    <div style={{ display: 'flex', flexDirection: 'column', gap: 'var(--nf-space-24)', minWidth: 0, width: '100%' }}>
+      {/* ① 模型（提供方管理） */}
+      <div className={css.card + ' ' + css.settingsCard} style={{ gap: 'var(--nf-space-16)' }}>
+        <span className={css.cardTitle}>模型</span>
+        <span className={css.meta}>填入各提供方的 API 密钥即可使用其模型。</span>
+        {configuredProviders.map(p => {
+          const isBuiltin = p.id === 'deepseek-official'
+          const isKnownVendor = vendors.some(v => v.id === p.id)
+          return (
+            <div key={p.id} style={{ border: '1px solid var(--nf-border)', borderRadius: 'var(--nf-radius-12)', padding: 'var(--nf-space-12)', display: 'flex', alignItems: 'center', gap: 'var(--nf-space-8)', flexWrap: 'wrap', justifyContent: 'space-between' }}>
+              <div style={{ display: 'flex', alignItems: 'center', gap: 'var(--nf-space-8)' }}><span style={{ fontWeight: 600 }}>{p.name !== '' && p.name !== p.id ? p.name : p.id}</span><span style={{ width: 8, height: 8, borderRadius: '50%', background: 'var(--nf-success)' }} /></div>
+              <div style={{ display: 'flex', gap: 'var(--nf-space-6)', alignItems: 'center' }}>
+                {!isBuiltin && <button type="button" className={css.button + ' ' + css.buttonSmall} onClick={() => openPanel(isKnownVendor ? 'standard' : 'custom', p.id)}>{tt('settings.edit')}</button>}
+                {!isBuiltin && <button type="button" className={css.button + ' ' + css.buttonSmall} style={{ color: 'var(--nf-error)' }} onClick={() => { void removeProvider(p) }}>{tt('settings.delete')}</button>}
+              </div>
+            </div>
+          )
+        })}
+        <div className={css.row} style={{ gap: 'var(--nf-space-10)', flexWrap: 'wrap' }}>
+          <button type="button" className={css.button + ' ' + css.buttonSmall} onClick={() => openPanel('standard')}><Plus size={13} style={{ verticalAlign: -2 }} /> 添加提供方</button>
+          <button type="button" className={css.button + ' ' + css.buttonSmall} onClick={() => openPanel('custom')}><Plus size={13} style={{ verticalAlign: -2 }} /> 添加自定义提供方</button>
+        </div>
+
+        {addPanel !== 'none' && (
+          <div style={{ border: '1px solid var(--nf-border)', borderRadius: 'var(--nf-radius-12)', padding: 'var(--nf-space-12)', display: 'flex', flexDirection: 'column', gap: 'var(--nf-space-12)' }}>
+            <div className={css.row} style={{ justifyContent: 'space-between', alignItems: 'center' }}><span className={css.fieldLabel}>{addPanel === 'standard' ? (editTarget !== '' ? '编辑提供方' : '添加提供方') : '自定义提供方'}</span><button type="button" className={css.button + ' ' + css.buttonSmall} onClick={() => openPanel('none')}><X size={13} style={{ verticalAlign: -2 }} /> 关闭</button></div>
+            {addPanel === 'standard' ? (
+              <>
+                <div className={css.field}><label className={css.fieldLabel}>提供方</label><select className={css.input} value={vendorId} onChange={e => setVendorId(e.target.value)}>{vendors.map(v => <option key={v.id} value={v.id}>{v.name}</option>)}</select></div>
+                <div className={css.field}><label className={css.fieldLabel}>API 密钥</label><input className={css.input} type="password" value={addApiKey} onChange={e => setAddApiKey(e.target.value)} placeholder="输入 API 密钥，或留空使用环境认证" /></div>
+                <div className={css.field}><label className={css.fieldLabel}>模型 id（可选）</label><input className={css.input} value={addModel} onChange={e => setAddModel(e.target.value)} placeholder="例如 glm-5.3-flash" /></div>
+                <div className={css.row} style={{ justifyContent: 'flex-end', gap: 'var(--nf-space-8)' }}><button type="button" className={css.button + ' ' + css.buttonSmall} onClick={() => openPanel('none')}>取消</button><button type="button" className={css.button + ' ' + css.buttonSmall + ' ' + css.buttonPrimary} disabled={savingAdd} onClick={() => { void saveStandard() }}>{savingAdd ? '保存中…' : '保存'}</button></div>
+              </>
+            ) : (
+              <>
+                <div className={css.field}><label className={css.fieldLabel}>Provider ID</label><input className={css.input} value={custProvider} onChange={e => setCustProvider(e.target.value)} placeholder="acme-gateway" /></div>
+                <div className={css.field}><label className={css.fieldLabel}>显示名称</label><input className={css.input} value={custName} onChange={e => setCustName(e.target.value)} placeholder="显示名称" /></div>
+                <div className={css.field}><label className={css.fieldLabel}>API 地址</label><input className={css.input} value={custBaseURL} onChange={e => setCustBaseURL(e.target.value)} placeholder="https://gateway.example/v1" /></div>
+                <div className={css.field}><label className={css.fieldLabel}>API 协议</label><select className={css.input} value={custProtocol} onChange={e => setCustProtocol(e.target.value)}><option value="openai-completions">openai-completions</option></select></div>
+                <div className={css.field}><label className={css.fieldLabel}>API 密钥</label><input className={css.input} type="password" value={custApiKey} onChange={e => setCustApiKey(e.target.value)} placeholder="输入 API 密钥" /></div>
+                <div className={css.field}><label className={css.fieldLabel}>模型目录 / 模型 id</label><input className={css.input} value={custModel} onChange={e => setCustModel(e.target.value)} placeholder="例如 glm-5.3-flash" /></div>
+                <div className={css.row} style={{ justifyContent: 'flex-end', gap: 'var(--nf-space-8)' }}><button type="button" className={css.button + ' ' + css.buttonSmall} onClick={() => openPanel('none')}>取消</button><button type="button" className={css.button + ' ' + css.buttonSmall + ' ' + css.buttonPrimary} disabled={savingAdd} onClick={() => { void saveCustom() }}>{savingAdd ? '创建中…' : '创建提供方'}</button></div>
+              </>
+            )}
+          </div>
+        )}
+        {addMsg !== '' && <span className={css.meta} style={{ color: 'var(--nf-success)' }}>✓ {addMsg}</span>}
+        {addErr !== '' && <span className={css.meta} style={{ color: 'var(--nf-error)' }}>✗ {addErr}</span>}
+      </div>
+
+      {/* ② 当前写作模型 */}
+      <div className={css.card + ' ' + css.settingsCard} style={{ gap: 'var(--nf-space-16)' }}>
+        <span className={css.cardTitle}>当前写作模型</span>
+        <div className={css.field}><label className={css.fieldLabel}>{tt('settings.provider')}</label><select className={css.input} value={providerValue} onChange={e => { const v = e.target.value; if (v === CUSTOM) setProviderCustom(true); else { setProviderCustom(false); onProvider(v) } }}>{providerOptions.map(p => <option key={p.id} value={p.id}>{p.name !== '' && p.name !== p.id ? p.name + '（' + p.id + '）' : p.id}</option>)}<option value={CUSTOM}>{tt('settings.customProvider')}</option></select>{providerCustom && <input className={css.input} style={{ marginTop: 'var(--nf-space-6)' }} value={provider} placeholder="provider 路由 id" onChange={e => onProvider(e.target.value)} />}</div>
+        <div className={css.field}>
+          <label className={css.fieldLabel}>{tt('settings.model')}</label>
+          <div className={css.row} style={{ gap: 'var(--nf-space-8)', flexWrap: 'wrap' }}>
+            <select className={css.input} style={{ flex: 1, minWidth: 200 }} value={modelValue} onChange={e => { const v = e.target.value; if (v === CUSTOM) setModelCustom(true); else { setModelCustom(false); onModel(v) } }}>{modelOptions.map(m => <option key={m.id} value={m.id}>{m.name !== '' && m.name !== m.id ? m.name + '（' + m.id + '）' : m.id}</option>)}<option value={CUSTOM}>{tt('settings.modelCustom')}</option></select>
+            <button type="button" className={css.button + ' ' + css.buttonSmall} disabled={modelsLoading || provider === ''} title="刷新模型" onClick={() => { void loadProviderModels(provider) }}><RefreshCw size={13} style={{ verticalAlign: -2 }} /> {modelsLoading ? '…' : tt('settings.refreshModels')}</button>
+            <button type="button" className={css.button + ' ' + css.buttonSmall} disabled={test.testing || provider.trim() === '' || model.trim() === ''} onClick={() => { void runTest() }} title={tt('settings.testHint')}><PlugZap size={13} style={{ verticalAlign: -2 }} /> {test.testing ? tt('settings.testRunning') : tt('settings.testConnection')}</button>
+          </div>
+          {modelCustom && <input className={css.input} style={{ marginTop: 'var(--nf-space-6)' }} value={model} placeholder={tt('settings.modelCustomPlaceholder')} onChange={e => onModel(e.target.value)} />}
+          <span className={css.meta} style={{ color: test.ok === true ? 'var(--nf-success)' : test.ok === false ? 'var(--nf-error)' : undefined }}>{test.testing ? tt('settings.testRunning') + '…' : test.ok === true ? '✓ ' + tt('settings.testOk') + ' · ' + (test.ms ?? '?') + 'ms' : test.ok === false ? '✗ ' + tt('settings.testFail') + (test.message !== undefined ? '：' + test.message : '') : tt('settings.testHint')}</span>
+        </div>
+      </div>
+    </div>
+  )
+}
+