@waterwx/dsh-novel-forge 1.8.0 → 1.9.0

package/src/client/panel/SettingsView.tsx

@@ -8,27 +8,20 @@ import { Brain, PenLine, Palette, Folder, Sparkles, RotateCcw, PlugZap, Plus, Tr
 import type { NovelApi } from '../api.ts'
 import type { NovelConfig, ImageModelConfig } from '../../protocol.ts'
 import { tt } from './helpers.ts'
+import { ModelManager } from './ModelManager.tsx'
+import { ReasoningSection } from './ReasoningSection.tsx'
 import css from './panel.module.css'
 
-const MODEL_PRESETS = ['deepseek-v4-flash', 'deepseek-v4-pro', 'deepseek-chat', 'deepseek-reasoner'] as const
-const REASONING_OPTIONS = ['off', 'low', 'high', 'max'] as const
-const REASONING_LABEL: Record<string, string> = {
-  off: tt('settings.reasoning.off'),
-  low: tt('settings.reasoning.low'),
-  high: tt('settings.reasoning.high'),
-  max: tt('settings.reasoning.max'),
-}
 
-const SETTINGS_SECTIONS: Array<{ id: 'model' | 'writing' | 'image' | 'files' | 'appearance' | 'background'; label: string; icon: JSX.Element }> = [
+const SETTINGS_SECTIONS: Array<{ id: 'model' | 'writing' | 'image' | 'files' | 'appearance'; label: string; icon: JSX.Element }> = [
   { id: 'model', label: '模型与推理', icon: <Brain size={16} /> },
   { id: 'writing', label: '写作与审稿', icon: <PenLine size={16} /> },
   { id: 'image', label: '生图模型', icon: <Palette size={16} /> },
   { id: 'files', label: '路径与文件', icon: <Folder size={16} /> },
   { id: 'appearance', label: '外观与主题', icon: <Sparkles size={16} /> },
-  { id: 'background', label: '自定义背景', icon: <Image size={16} /> },
 ];
 
-type SettingsTab = 'model' | 'writing' | 'image' | 'files' | 'appearance' | 'background'
+type SettingsTab = 'model' | 'writing' | 'image' | 'files' | 'appearance'
 type ThemeMode = 'system' | 'light' | 'dark'
 type ThemeName = 'liquid' | 'neumorph' | 'macos' | 'clay'
 type ThemeDensity = 'comfort' | 'compact' | 'spacious'
@@ -53,8 +46,7 @@ export function SettingsView({ api, onTheme, onSettingsTab, onEditorFontSize, on
   const [busy, setBusy] = useState(false);
   const [error, setError] = useState('');
   const [notice, setNotice] = useState('');
-  const [modelCustomMode, setModelCustomMode] = useState(false);
-  const [settingsTab, setSettingsTabState] = useState<SettingsTab>(() => readLS<SettingsTab>('dsh-novel-forge.settings.tab', 'model', ['model','writing','image','files','appearance','background'] as const));
+  const [settingsTab, setSettingsTabState] = useState<SettingsTab>(() => readLS<SettingsTab>('dsh-novel-forge.settings.tab', 'model', ['model','writing','image','files','appearance'] as const));
   const [imageTestState, setImageTestState] = useState<Record<string, { testing: boolean; ok?: boolean; ms?: number; message?: string; modelFound?: boolean }>>({});
   const [editorFontSize, setEditorFontSize] = useState<number>(() => { try { const v = Number(window.localStorage.getItem('dsh-novel-forge.editor.fontSize')); return v >= 12 && v <= 24 ? v : 14 } catch { return 14 } });
   const [panelTheme, setPanelTheme] = useState<ThemeName>(() => readLS<ThemeName>('dsh-novel-forge.theme', 'liquid', ['liquid','neumorph','macos','clay'] as const));
@@ -97,6 +89,7 @@ export function SettingsView({ api, onTheme, onSettingsTab, onEditorFontSize, on
         themeBackgroundBlur: configDraft.themeBackgroundBlur ?? 0,
         themeOpacity: configDraft.themeOpacity ?? 100,
         imageModels: configDraft.imageModels ?? [],
+        savedModels: configDraft.savedModels ?? [],
       });
       setConfig(result.config);
       setConfigDraft(result.config);
@@ -180,8 +173,10 @@ export function SettingsView({ api, onTheme, onSettingsTab, onEditorFontSize, on
 
   return (
     <div className={css.authorPageBody} data-nf-theme={panelTheme} data-nf-mode={themeMode === 'system' ? undefined : themeMode} data-nf-density={themeDensity}>
-      <div className={css.authorPageHeader}>
-        <div><h2 className={css.panelTitle} style={{ margin: 0 }}>⚙️ 设置</h2><span className={css.meta}>当前：{config?.provider} / {config?.model} · {config?.outputDir}</span></div>
+      <div className={css.card + ' ' + css.settingsCard} style={{ gap: 'var(--nf-space-6)' }}>
+        <h2 className={css.panelTitle} style={{ margin: 0 }}>⚙️ 设置</h2>
+        <span className={css.meta}>当前模型：{config?.provider} / {config?.model}</span>
+        <span className={css.meta}>输出目录：{config?.outputDir}</span>
       </div>
 
       <div className={css.row} style={{ gap: 'var(--nf-space-8)', flexWrap: 'wrap' }}>
@@ -194,13 +189,25 @@ export function SettingsView({ api, onTheme, onSettingsTab, onEditorFontSize, on
       {notice !== '' && <div className={css.meta}>{notice}</div>}
 
       {settingsTab === 'model' && (
-        <div className={css.card + ' ' + css.settingsCard} style={{ gap: 'var(--nf-space-24)' }}>
-          <span className={css.cardTitle}><Brain size={18} style={{ verticalAlign: -3 }} /> 模型与推理</span>
-          <div className={css.field}><label className={css.fieldLabel}>{tt('settings.provider')}</label><input className={css.input} value={configDraft.provider} onChange={e => setConfigDraft({ ...configDraft, provider: e.target.value })} /></div>
-          <div className={css.field}><label className={css.fieldLabel}>{tt('settings.model')}</label><select className={css.input} value={modelCustomMode ? '__custom__' : configDraft.model} onChange={e => { const v = e.target.value; if (v === '__custom__') setModelCustomMode(true); else { setModelCustomMode(false); setConfigDraft({ ...configDraft, model: v }) } }}>{MODEL_PRESETS.map(m => <option key={m} value={m}>{m}</option>)}<option value="__custom__">{tt('settings.modelCustom')}</option></select>{modelCustomMode && <input className={css.input} value={configDraft.model} placeholder={tt('settings.modelCustomPlaceholder')} onChange={e => setConfigDraft({ ...configDraft, model: e.target.value })} />}</div>
-          <div className={css.field}><label className={css.fieldLabel}>{tt('settings.reasoningEffort')}</label><select className={css.input} value={configDraft.reasoningEffort ?? 'off'} onChange={e => setConfigDraft({ ...configDraft, reasoningEffort: e.target.value as NovelConfig['reasoningEffort'] })}>{REASONING_OPTIONS.map(v => <option key={v} value={v}>{REASONING_LABEL[v]}</option>)}</select><span className={css.meta}>{tt('settings.reasoningHint')}</span></div>
-          <div className={css.field}><label className={css.fieldLabel}>{tt('settings.analysisReasoning')}</label><select className={css.input} value={configDraft.analysisReasoning ?? 'low'} onChange={e => setConfigDraft({ ...configDraft, analysisReasoning: e.target.value as NovelConfig['analysisReasoning'] })}>{REASONING_OPTIONS.map(v => <option key={v} value={v}>{REASONING_LABEL[v]}</option>)}</select><span className={css.meta}>{tt('settings.analysisReasoningHint')}</span></div>
-        </div>
+        <>
+          <div className={css.card + ' ' + css.settingsCard} style={{ gap: 'var(--nf-space-24)' }}>
+            <span className={css.cardTitle}><Brain size={18} style={{ verticalAlign: -3 }} /> 模型与推理</span>
+            <ModelManager
+              api={api}
+              provider={configDraft.provider}
+              model={configDraft.model}
+              savedModels={configDraft.savedModels ?? []}
+              onProvider={v => setConfigDraft({ ...configDraft, provider: v })}
+              onModel={v => setConfigDraft({ ...configDraft, model: v })}
+              onSavedModels={models => setConfigDraft({ ...configDraft, savedModels: models })}
+            />
+          </div>
+          <ReasoningSection
+            reasoningEffort={configDraft.reasoningEffort ?? 'off'}
+            analysisReasoning={configDraft.analysisReasoning ?? 'low'}
+            onChange={patch => setConfigDraft({ ...configDraft, ...patch })}
+          />
+        </>
       )}
 
       {settingsTab === 'writing' && (
@@ -218,7 +225,7 @@ export function SettingsView({ api, onTheme, onSettingsTab, onEditorFontSize, on
 
       {settingsTab === 'image' && (
         <div className={css.card + ' ' + css.settingsCard} style={{ gap: 'var(--nf-space-24)' }}>
-          <div className={css.row} style={{ justifyContent: 'space-between', flexWrap: 'wrap', alignItems: 'center' }}><span className={css.cardTitle}><Palette size={18} style={{ verticalAlign: -3 }} /> 生图模型</span><span className={css.meta}>启用生图功能</span></div>
+          <div className={css.row} style={{ justifyContent: 'space-between', flexWrap: 'wrap', alignItems: 'center' }}><span className={css.cardTitle}><Palette size={18} style={{ verticalAlign: -3 }} /> 生图模型</span><span className={css.row} style={{ gap: 'var(--nf-space-8)', alignItems: 'center' }}><span className={css.meta}>启用生图功能</span><button type="button" role="switch" aria-checked={configDraft.imageApiEnabled === true} className={`${css.switch} ${configDraft.imageApiEnabled === true ? css.switchOn : ''}`} onClick={() => { setConfigDraft(prev => prev === null ? prev : { ...prev, imageApiEnabled: prev.imageApiEnabled !== true }) }}><span className={css.switchKnob} /></button></span></div>
           <span className={css.meta}>支持多套 OpenAI 兼容生图接口（豆包 / 即梦 / 其他平台）；启用一条作为生成模型。</span>
           {(configDraft.imageModels ?? []).map(m => (
             <div key={m.id} style={{ border: m.enabled ? '1px solid var(--nf-accent)' : '1px solid var(--nf-border)', borderRadius: 'var(--nf-radius-12)', padding: 'var(--nf-space-14)', display: 'flex', flexDirection: 'column', gap: 'var(--nf-space-12)', background: m.enabled ? 'var(--nf-accent-soft)' : 'transparent' }}>
@@ -249,34 +256,34 @@ export function SettingsView({ api, onTheme, onSettingsTab, onEditorFontSize, on
       )}
 
       {settingsTab === 'appearance' && (
-        <div className={css.card + ' ' + css.settingsCard}>
-          <span className={css.cardTitle}><Sparkles size={18} style={{ verticalAlign: -3 }} /> 外观与主题</span>
-          <div className={css.field}><label className={css.fieldLabel}>显示模式</label><select className={css.input} value={themeMode} onChange={e => changeTheme(panelTheme, e.target.value as ThemeMode, themeDensity)}><option value="system">跟随系统</option><option value="light">浅色</option><option value="dark">深色</option></select></div>
-          <div className={css.field}><label className={css.fieldLabel}>主题风格</label><select className={css.input} value={panelTheme} onChange={e => changeTheme(e.target.value as ThemeName, themeMode, themeDensity)}><option value="liquid">液态玻璃 · 清新绿（默认）</option><option value="neumorph">新拟物 · 柔和浅色</option><option value="macos">macOS · 玻璃（蓝，随外观浅/深）</option><option value="clay">粘土拟态 · 柔和黏土</option></select></div>
-          <div className={css.field}><label className={css.fieldLabel}>界面密度</label><select className={css.input} value={themeDensity} onChange={e => changeTheme(panelTheme, themeMode, e.target.value as ThemeDensity)}><option value="comfort">舒适（默认）</option><option value="compact">紧凑</option><option value="spacious">宽松</option></select></div>
-          <div className={css.field}><label className={css.fieldLabel}>玻璃透明度（0-100）</label><input className={css.input} type="range" min={0} max={100} value={configDraft.themeOpacity ?? 100} onChange={e => applyOpacity(Number(e.target.value))} /><span className={css.meta}>100=当前主题原样；调低会让玻璃/卡片变透，新拟态、黏土等实色主题能透出背景图。</span></div>
-          <div className={css.row} style={{ justifyContent: 'flex-end' }}><button type="button" className={css.button} onClick={resetTheme}><RotateCcw size={14} style={{ verticalAlign: -2 }} /> 恢复默认主题</button></div>
-        </div>
-      )}
-
-      {settingsTab === 'background' && (
-        <div className={css.card + ' ' + css.settingsCard} style={{ gap: 'var(--nf-space-12)' }}>
-          <span className={css.cardTitle}><Image size={18} style={{ verticalAlign: -3 }} /> 自定义背景</span>
-          <span className={css.meta}>填图片 URL 或上传图片作为小说工坊背景（首页 + 书内）。留空 = 使用主题默认背景。</span>
-          <div className={css.row} style={{ gap: 'var(--nf-space-8)', flexWrap: 'wrap' }}>
-            <input className={css.input} style={{ flex: 1, minWidth: 220 }} placeholder="https://… 图片地址" value={(configDraft.themeBackground ?? '').startsWith('data:') ? '' : (configDraft.themeBackground ?? '')} onChange={e => applyBackground(e.target.value.trim() !== '' ? e.target.value.trim() : undefined)} />
-            <button type="button" className={css.button + ' ' + css.buttonSmall} onClick={() => bgFileRef.current?.click()}><Upload size={13} style={{ verticalAlign: -2 }} /> 上传图片</button>
-            <button type="button" className={css.button + ' ' + css.buttonSmall} onClick={() => applyBackground(undefined)}><X size={13} style={{ verticalAlign: -2 }} /> 清除</button>
+        <>
+          <div className={css.card + ' ' + css.settingsCard}>
+            <span className={css.cardTitle}><Sparkles size={18} style={{ verticalAlign: -3 }} /> 外观与主题</span>
+            <div className={css.field}><label className={css.fieldLabel}>显示模式</label><select className={css.input} value={themeMode} onChange={e => changeTheme(panelTheme, e.target.value as ThemeMode, themeDensity)}><option value="system">跟随系统</option><option value="light">浅色</option><option value="dark">深色</option></select></div>
+            <div className={css.field}><label className={css.fieldLabel}>主题风格</label><select className={css.input} value={panelTheme} onChange={e => changeTheme(e.target.value as ThemeName, themeMode, themeDensity)}><option value="liquid">液态玻璃 · 清新绿（默认）</option><option value="neumorph">新拟物 · 柔和浅色</option><option value="macos">macOS · 玻璃（蓝，随外观浅/深）</option><option value="clay">粘土拟态 · 柔和黏土</option></select></div>
+            <div className={css.field}><label className={css.fieldLabel}>界面密度</label><select className={css.input} value={themeDensity} onChange={e => changeTheme(panelTheme, themeMode, e.target.value as ThemeDensity)}><option value="comfort">舒适（默认）</option><option value="compact">紧凑</option><option value="spacious">宽松</option></select></div>
+            <div className={css.field}><label className={css.fieldLabel}>玻璃透明度（0-100）</label><input className={css.input} type="range" min={0} max={100} value={configDraft.themeOpacity ?? 100} onChange={e => applyOpacity(Number(e.target.value))} /><span className={css.meta}>100=当前主题原样；调低会让玻璃/卡片变透，新拟态、黏土等实色主题能透出背景图。</span></div>
+            <div className={css.row} style={{ justifyContent: 'flex-end' }}><button type="button" className={css.button} onClick={resetTheme}><RotateCcw size={14} style={{ verticalAlign: -2 }} /> 恢复默认主题</button></div>
           </div>
-          <input ref={bgFileRef} type="file" accept="image/*" style={{ display: 'none' }} onChange={e => { void onBgFile(e.target.files?.[0]); e.target.value = '' }} />
-          {(configDraft.themeBackground ?? '') !== '' && (
-            <div className={css.adaptInputCard} style={{ padding: 8 }}>
-              <div style={{ width: 180, height: 100, borderRadius: 10, backgroundImage: 'url(' + configDraft.themeBackground + ')', backgroundSize: 'cover', backgroundPosition: 'center' }} />
-              <div className={css.meta}>已设置背景（预览）</div>
+
+          <div className={css.card + ' ' + css.settingsCard} style={{ gap: 'var(--nf-space-12)' }}>
+            <span className={css.cardTitle}><Image size={18} style={{ verticalAlign: -3 }} /> 自定义背景</span>
+            <span className={css.meta}>填图片 URL 或上传图片作为小说工坊背景（首页 + 书内）。留空 = 使用主题默认背景。</span>
+            <div className={css.row} style={{ gap: 'var(--nf-space-8)', flexWrap: 'wrap' }}>
+              <input className={css.input} style={{ flex: 1, minWidth: 220 }} placeholder="https://… 图片地址" value={(configDraft.themeBackground ?? '').startsWith('data:') ? '' : (configDraft.themeBackground ?? '')} onChange={e => applyBackground(e.target.value.trim() !== '' ? e.target.value.trim() : undefined)} />
+              <button type="button" className={css.button + ' ' + css.buttonSmall} onClick={() => bgFileRef.current?.click()}><Upload size={13} style={{ verticalAlign: -2 }} /> 上传图片</button>
+              <button type="button" className={css.button + ' ' + css.buttonSmall} onClick={() => applyBackground(undefined)}><X size={13} style={{ verticalAlign: -2 }} /> 清除</button>
             </div>
-          )}
-          <div className={css.field}><label className={css.fieldLabel}>遮罩 / 模糊强度（0-80）</label><input className={css.input} type="range" min={0} max={80} value={configDraft.themeBackgroundBlur ?? 0} onChange={e => applyBlur(Number(e.target.value))} /><span className={css.meta}>越大背景越暗，保证文字可读（图很花时调高）。</span></div>
-        </div>
+            <input ref={bgFileRef} type="file" accept="image/*" style={{ display: 'none' }} onChange={e => { void onBgFile(e.target.files?.[0]); e.target.value = '' }} />
+            {(configDraft.themeBackground ?? '') !== '' && (
+              <div className={css.adaptInputCard} style={{ padding: 8 }}>
+                <div style={{ width: 180, height: 100, borderRadius: 10, backgroundImage: 'url(' + configDraft.themeBackground + ')', backgroundSize: 'cover', backgroundPosition: 'center' }} />
+                <div className={css.meta}>已设置背景（预览）</div>
+              </div>
+            )}
+            <div className={css.field}><label className={css.fieldLabel}>遮罩 / 模糊强度（0-80）</label><input className={css.input} type="range" min={0} max={80} value={configDraft.themeBackgroundBlur ?? 0} onChange={e => applyBlur(Number(e.target.value))} /><span className={css.meta}>越大背景越暗，保证文字可读（图很花时调高）。</span></div>
+          </div>
+        </>
       )}
 
       <div className={css.row}><button type="button" className={css.button + ' ' + css.buttonPrimary} disabled={busy} onClick={() => { void save() }}>{busy ? '保存中…' : tt('settings.save')}</button></div>

package/src/engine.ts

@@ -75,11 +75,24 @@ import type {
   StoryboardShot,
   StoryboardPrompt,
   ChapterStoryboard,
+  AddModelRequest,
+  AddModelResponse,
+  SavedModel,
+  LlmModelOption,
+  LlmModelsResponse,
+  LlmVendorOption,
+  LlmVendorsResponse,
+  LlmProvidersResponse,
+  RemoveProviderRequest,
+  RemoveProviderResponse,
+  LlmTestRequest,
+  LlmTestResponse,
   MangaRoleCandidate,
   MangaRoleCard,
   Volume,
   WorldState,
 } from './protocol.ts'
+import { LLM_VENDORS } from './protocol.ts'
 
 /** Project state file name inside the output dir. */
 export const PROJECT_FILE = 'novel-project.json'
@@ -2343,6 +2356,214 @@ export async function testImageEndpoint(baseURL: string, apiKey: string, model?:
   }
 }
 
+// ---------------------------------------------------------- llm catalog/test
+
+/** LLM 连通性失败的错误码 → 人话（供设置页“测试连通”回显）。 */
+const LLM_TEST_ERROR_HINT: Record<string, string> = {
+  NO_ADAPTER: '提供商路由不存在或未启用',
+  UNKNOWN_MODEL: '模型不在该提供商的目录里',
+  MISSING_CREDENTIAL: 'API Key 未配置（检查 DSH 凭据里的引用）',
+  INVALID_CREDENTIAL: 'API Key 格式无效',
+  AUTH: '认证失败：API Key 无效或无权限',
+  RATE_LIMIT: '触发提供商限流，请稍后再试',
+  QUOTA: '配额/余额不足',
+  CONTEXT_WINDOW_EXCEEDED: '上下文超限（测试调用不应触发，请核实模型配置）',
+  EMPTY_RESPONSE: '端点连通但返回空响应（模型可能暂不可用）',
+  TIMEOUT: '连接超时',
+  ABORTED: '测试超时（30 秒无响应）',
+  UNSUPPORTED_REASONING_EFFORT: '推理档位不受此模型支持',
+}
+
+function describeLlmTestError(err: Error & { code?: string }): string {
+  const code = typeof err.code === 'string' ? err.code : ''
+  const hint = code !== '' ? LLM_TEST_ERROR_HINT[code] : undefined
+  const detail = err.message !== '' ? err.message : '未知错误'
+  return hint !== undefined ? `${hint}（${detail}）` : detail
+}
+
+/** 对选中的提供商/模型发一次最小真实调用（maxTokens=16），验证 Key / 端点 / 模型可用。 */
+export async function testLlmModel(ctx: Context, provider: string, model: string): Promise<LlmTestResponse> {
+  const start = Date.now()
+  const messages: Message[] = [createUserMessage({
+    content: [{ type: 'text', text: '只回复两个字：OK' }],
+    source: { kind: 'plugin', plugin: 'dsh-novel-forge' },
+  })]
+  const request: GenerateOptions = {
+    provider,
+    model,
+    messages,
+    maxTokens: 16,
+    temperature: 0,
+  }
+  // 真实流式调用 + 30 秒超时（GenerateOptions.signal 由适配器响应并中止）。
+  const controller = new AbortController()
+  const timer = setTimeout(() => controller.abort(), 30_000)
+  try {
+    const assembler = new BlockAssembler()
+    let sawBlock = false
+    for await (const chunk of ctx.llm.stream({ ...request, signal: controller.signal })) {
+      assembler.push(chunk)
+      // 拿到第一个完整块即判定连通并提前结束，省 token。
+      if (chunk.type === 'block-end') { sawBlock = true; break }
+    }
+    if (sawBlock) return { ok: true, ms: Date.now() - start }
+    const finish = assembler.finish
+    if (finish !== undefined && (finish.kind === 'error' || finish.kind === 'aborted')) {
+      const failure = finish.failure
+      throw Object.assign(new Error(failure.message), { code: failure.code })
+    }
+    // 正常 finish（stop/max-tokens）但没有文本块，同样视为已连通。
+    return { ok: true, ms: Date.now() - start }
+  } catch (error) {
+    const err = error as Error & { code?: string }
+    return { ok: false, ms: Date.now() - start, code: err.code, message: describeLlmTestError(err) }
+  } finally {
+    clearTimeout(timer)
+  }
+}
+
+/** 确保 pi-ai 的一条 provider 路由存在（settings seam 深度合并，保留已有字段）。 */
+async function ensurePiAiProvider(ctx: Context, route: string, cfg: Record<string, unknown>): Promise<void> {
+  const settings = ctx.get('settings') as { update: (ns: string, patch: object) => Promise<void> } | undefined
+  if (settings === undefined) throw new Error('DSH settings 服务不可用，无法注册路由')
+  await settings.update('llm-pi-ai', { providers: { [route]: cfg } })
+}
+
+/** 运行时厂商目录：DSH pi-ai 可配置提供方 + 内置适配器，作为「添加模型」下拉。 */
+export async function listLlmVendors(ctx: Context): Promise<LlmVendorsResponse> {
+  const map = new Map<string, LlmVendorOption>()
+  // 预置厂商（有名称/模型建议/apiKeyEnv）
+  for (const v of LLM_VENDORS) {
+    map.set(v.route, { id: v.route, name: v.name, models: v.models, apiKeyEnv: v.apiKeyEnv, builtin: v.builtin })
+  }
+  // DSH pi-ai 可配置提供方目录（DSH 添加模型下拉的数据源）
+  try {
+    for (const p of ctx.llm.listConfigurableProviders()) {
+      if (!map.has(p.provider)) {
+        map.set(p.provider, {
+          id: p.provider,
+          name: p.displayName !== '' ? p.displayName : p.provider,
+          models: [],
+          apiKeyEnv: 'PI_AI_' + p.provider.toUpperCase().replace(/[^A-Z0-9]+/g, '_') + '_API_KEY',
+        })
+      }
+    }
+  } catch { /* 单个目录读取失败跳过 */ }
+  // 已注册的适配器路由（如 deepseek-official）
+  try {
+    for (const p of ctx.llm.listProviders()) {
+      if (!map.has(p.id)) {
+        map.set(p.id, { id: p.id, name: p.name !== '' && p.name !== p.id ? p.name : p.id, models: [], builtin: true })
+      }
+    }
+  } catch { /* ignore */ }
+  return { vendors: [...map.values()] }
+}
+
+/** 查询某个 provider 当前可用模型（添加成功后可即时刷新下拉）。 */
+export async function listLlmModels(ctx: Context, provider: string): Promise<LlmModelsResponse> {
+  if (provider.trim() === '') return { models: [] }
+  try {
+    const models = await ctx.llm.listModels(provider.trim())
+    return { models: models.map(m => ({ id: m.id, name: m.name })) }
+  } catch {
+    // provider 未激活/目录不可用 → 返回空，让前端回退到手填。
+    return { models: [] }
+  }
+}
+
+/** 当前已注册的提供方路由列表（提供方管理卡片）。 */
+export async function listLlmProviders(ctx: Context): Promise<LlmProvidersResponse> {
+  try {
+    const providers = ctx.llm.listProviders().map(p => ({ id: p.id, name: p.name !== '' && p.name !== p.id ? p.name : p.id }))
+    return { providers }
+  } catch {
+    // 兜底：至少总是有内置 DeepSeek。
+    return { providers: [{ id: 'deepseek-official', name: 'DeepSeek' }] }
+  }
+}
+
+/** 移除一个提供方：unset 凭据 ref + 移除 llm-pi-ai providers 路由。 */
+export async function removeLlmProvider(ctx: Context, req: RemoveProviderRequest): Promise<RemoveProviderResponse> {
+  const provider = (req.provider ?? '').trim()
+  if (provider === '') throw new Error('缺少 provider')
+  if (provider === 'deepseek-official') throw new Error('内置 DeepSeek 提供方不可删除')
+
+  const creds = ctx.get('credentials') as { unset?: (ref: string) => Promise<void> } | undefined
+  if (creds?.unset !== undefined && req.apiKeyEnv !== undefined && req.apiKeyEnv.trim() !== '') {
+    await creds.unset(req.apiKeyEnv.trim())
+  }
+
+  const settings = ctx.get('settings') as { mutate?: (ns: string, ops: { op: 'unset'; path: string[] }[]) => Promise<void> } | undefined
+  if (settings?.mutate !== undefined) {
+    await settings.mutate('llm-pi-ai', [{ op: 'unset', path: ['providers', provider] }])
+  }
+
+  return { ok: true, message: '已移除提供方 ' + provider }
+}
+
+/**
+ * 添加模型（DSH 同款体验）：厂商直填 API Key，或自定义 OpenAI 兼容路由。
+ * 写入 DSH 凭据 refs，并（必要时）注册/更新 llm-pi-ai provider 路由。
+ */
+export async function registerLlmModel(ctx: Context, req: AddModelRequest): Promise<AddModelResponse> {
+  const apiKey = req.apiKey?.trim() ?? ''
+  const model = req.model?.trim() ?? ''
+  if (apiKey === '') throw new Error('API Key 不能为空')
+  if (model === '') throw new Error('模型 id 不能为空')
+
+  const creds = ctx.get('credentials') as { set(ref: string, value: string): Promise<void> } | undefined
+  if (creds === undefined) throw new Error('DSH credentials 服务不可用，无法写入 API Key')
+
+  let route: string
+  let env: string
+  let displayName: string
+  let message: string
+
+  if (req.mode === 'vendor') {
+    const vendorId = (req.vendor ?? '').trim()
+    if (vendorId === '') throw new Error('请选择厂商')
+    const v = LLM_VENDORS.find(x => x.route === vendorId)
+    route = vendorId
+    env = req.apiKeyEnv?.trim() || v?.apiKeyEnv || ('PI_AI_' + vendorId.toUpperCase().replace(/[^A-Z0-9]+/g, '_') + '_API_KEY')
+    displayName = v?.name ?? vendorId
+    const isBuiltin = v?.builtin === true || vendorId === 'deepseek-official'
+    await creds.set(env, apiKey)
+    // 内置适配器（如 deepseek-official）不需 pi-ai 路由；其余 catalog 路由写 apiKeyEnv 即可。
+    if (isBuiltin) {
+      message = '已写入 DSH 凭据（' + env + '）'
+    } else {
+      await ensurePiAiProvider(ctx, route, { apiKeyEnv: env })
+      message = '已写入 DSH 凭据并注册路由 ' + route
+    }
+  } else {
+    route = (req.provider ?? '').trim()
+    const baseURL = (req.baseURL ?? '').trim()
+    if (route === '') throw new Error('自定义模式需填提供商路由 id')
+    if (baseURL === '') throw new Error('自定义模式需填接口地址 (baseURL)')
+    env = 'NOVEL_CUSTOM_' + route.toUpperCase().replace(/[^A-Z0-9]+/g, '_') + '_API_KEY'
+    displayName = req.name?.trim() || ('Custom ' + route)
+    await creds.set(env, apiKey)
+    await ensurePiAiProvider(ctx, route, {
+      displayName,
+      apiKeyEnv: env,
+      api: 'openai-completions',
+      baseURL,
+      models: [{ id: model }],
+      compat: { supportsDeveloperRole: false, maxTokensField: 'max_tokens' },
+    })
+    message = '已写入 DSH 凭据并注册路由 ' + route
+  }
+
+  const saved: SavedModel = {
+    id: 'saved-' + Date.now().toString(36) + '-' + Math.random().toString(36).slice(2, 6),
+    name: req.name?.trim() || (displayName + ' · ' + model),
+    provider: route,
+    model,
+  }
+  return { ok: true, saved, provider: route, message }
+}
+
 /** 底层：按形象锚点调用生图接口生成定妆图（不写库；写库由上层调用方负责）。 */
 async function generateReferenceImageFrom(
   config: NovelConfig,

package/src/index.ts

@@ -109,7 +109,7 @@ export const Config: z<Config> = z.object({
   themeBackground: z.string().default(''),
   themeBackgroundBlur: z.number().default(0),
   themeOpacity: z.number().default(100),
-  enableAdaptMode: z.boolean().default(false),
+  enableAdaptMode: z.boolean().default(true),
 })
 
 /** Schema defaults, re-read for hand-built test contexts. */
@@ -172,7 +172,7 @@ export function resolveConfig(value: Partial<Config> | undefined): NovelConfig {
     themeBackground: value?.themeBackground ?? '',
     themeBackgroundBlur: value?.themeBackgroundBlur ?? 0,
     themeOpacity: value?.themeOpacity ?? 100,
-    enableAdaptMode: value?.enableAdaptMode ?? false,
+    enableAdaptMode: value?.enableAdaptMode ?? true,
   }
 }
 

package/src/protocol.ts

@@ -64,6 +64,18 @@ export const NOVEL_API = {
   storyboardPrompts: '/api/dsh-novel-forge/storyboard/prompts',
   /** 生图接口连通性测试（设置页每个模型条目用）。 */
   imageTest: '/api/dsh-novel-forge/image-test',
+  /** LLM 模型连通性测试：真实最小调用，验证 Key / 端点 / 模型可用。 */
+  llmTest: '/api/dsh-novel-forge/llm-test',
+  /** 添加模型：厂商直填 key 或自定义路由，写进 DSH 凭据与 llm-pi-ai 路由。 */
+  addModel: '/api/dsh-novel-forge/llm-add',
+  /** 运行时厂商目录（DSH pi-ai 可配置提供方 + 内置适配器）。 */
+  llmVendors: '/api/dsh-novel-forge/llm-vendors',
+  /** 查询某个 provider 当前可用的模型（添加成功后可即时刷新）。 */
+  llmModels: '/api/dsh-novel-forge/llm-models',
+  /** 已注册的提供方路由列表（提供方管理）。 */
+  llmProviders: '/api/dsh-novel-forge/llm-providers',
+  /** 移除一个提供方。 */
+  llmRemove: '/api/dsh-novel-forge/llm-remove',
   /** 重置项目（可选携带新大纲）：清空设定/卷/章节/伏笔/资产/事实库。 */
   reset: '/api/dsh-novel-forge/reset',
   /** 全书一致性质检：LLM 扫描已生成章节，输出矛盾问题清单。 */
@@ -1057,6 +1069,23 @@ export interface ImageTestResponse {
   modelFound?: boolean
 }
 
+/** POST /llm-test 请求：对选中的提供商/模型发一次最小真实调用。 */
+export interface LlmTestRequest {
+  provider: string
+  model: string
+}
+
+/** POST /llm-test 响应。 */
+export interface LlmTestResponse {
+  ok: boolean
+  /** 连通延迟（毫秒）。 */
+  ms?: number
+  /** 失败原因（已映射为人话）。 */
+  message?: string
+  /** 稳定错误码（LlmError code），便于排查。 */
+  code?: string
+}
+
 /** POST /roles 响应。 */
 export interface RolesResponse {
   roles: RoleRecord[]
@@ -1235,6 +1264,133 @@ export interface ImageModelConfig {
 }
 
 /** Runtime config surface exposed to the panel (subset of plugin Config). */
+/** 手动添加的模型库条目（只存插件内，不改 DSH 全局）。 */
+export interface SavedModel {
+  /** 唯一 id（前端生成的短 id）。 */
+  id: string
+  /** 展示名（可为空，回退到 model）。 */
+  name: string
+  /** DSH 提供商路由（如 zai-coding-cn）。 */
+  provider: string
+  /** 模型 id（如 glm-5.3-flash）。 */
+  model: string
+}
+
+/** DSH 模型添加：厂商预设（选择厂商，直接填 API Key）。 */
+export interface LlmVendor {
+  id: string
+  name: string
+  /** 该厂商对应的 provider 路由。 */
+  route: string
+  /** DSH 凭据引用名（写入 .credentials.yaml 的 refs）。 */
+  apiKeyEnv: string
+  /** 默认模型 id。 */
+  defaultModel: string
+  /** 建议可选模型 id 列表（下拉 data-list 用）。 */
+  models: string[]
+  /** 内置适配器（如 deepseek-official），无需注册 pi-ai 路由。 */
+  builtin?: boolean
+}
+
+/** 预置的常见厂商（id=provider 路由；添加模型下拉兜底用，其余厂商由运行时目录动态补充）。 */
+export const LLM_VENDORS: LlmVendor[] = [
+  { id: 'deepseek-official', name: 'DeepSeek', route: 'deepseek-official', apiKeyEnv: 'DEEPSEEK_API_KEY', defaultModel: 'deepseek-v4-flash', models: ['deepseek-v4-flash', 'deepseek-v4-pro', 'deepseek-chat', 'deepseek-reasoner'], builtin: true },
+  { id: 'zai-coding-cn', name: '智谱 GLM', route: 'zai-coding-cn', apiKeyEnv: 'ZAI_CODING_CN_API_KEY', defaultModel: 'glm-5.3-flash', models: ['glm-4.5-air', 'glm-4.7', 'glm-5-turbo', 'glm-5.1', 'glm-5.2', 'glm-5.3', 'glm-5.3-flash', 'glm-5v-turbo'] },
+  { id: 'qwen-token-plan-cn', name: '千问百炼', route: 'qwen-token-plan-cn', apiKeyEnv: 'QWEN_TOKEN_PLAN_CN_API_KEY', defaultModel: 'qwen3.7-max', models: ['qwen3.6-flash', 'qwen3.6-plus', 'qwen3.7-max', 'qwen3.7-plus', 'qwen3.8-max', 'qwen3.8-max-preview'] },
+  { id: 'openrouter', name: 'OpenRouter', route: 'openrouter', apiKeyEnv: 'OPENROUTER_API_KEY', defaultModel: 'z-ai/glm-5.3-flash', models: ['z-ai/glm-4.6', 'z-ai/glm-4.7', 'z-ai/glm-5', 'z-ai/glm-5-turbo', 'z-ai/glm-5.1', 'z-ai/glm-5.2', 'z-ai/glm-5.3-flash', 'auto', 'deepseek/deepseek-v4-flash', 'anthropic/claude-sonnet-4.6'] },
+]
+
+/** 运行时厂商目录的一项（添加到模型下拉；由 DSH 的 pi-ai 可配置提供方动态生成）。 */
+export interface LlmVendorOption {
+  /** provider 路由 id（也是厂商下拉的值）。 */
+  id: string
+  /** 展示名。 */
+  name: string
+  /** 建议模型 id（可为空，用户手填）。 */
+  models: string[]
+  /** 已知 DSH 凭据引用名；为空时 host 生成 `PI_AI_<ID>_API_KEY`。 */
+  apiKeyEnv?: string
+  /** 内置适配器（只写凭据，不注册 pi-ai 路由）。 */
+  builtin?: boolean
+}
+
+/** GET /llm-vendors 响应。 */
+export interface LlmVendorsResponse {
+  vendors: LlmVendorOption[]
+}
+
+/** /llm-models 里的一条模型。 */
+export interface LlmModelOption { id: string; name: string }
+
+/** GET /llm-models?provider=x 响应。 */
+export interface LlmModelsResponse {
+  models: LlmModelOption[]
+}
+
+/** GET /llm-providers 响应：当前已注册的提供方路由。 */
+export interface LlmProvidersResponse {
+  providers: { id: string; name: string }[]
+}
+
+/** POST /llm-remove 请求：移除一个提供方（unset key + 移除 llm-pi-ai 路由）。 */
+export interface RemoveProviderRequest {
+  provider: string
+  /** 该提供方对应的 DSH 凭据引用名（用于 unset）。 */
+  apiKeyEnv?: string
+}
+
+/** POST /llm-remove 响应。 */
+export interface RemoveProviderResponse {
+  ok: boolean
+  message?: string
+}
+
+/** GET /llm-providers 响应：当前已注册的提供方路由。 */
+export interface LlmProvidersResponse {
+  providers: { id: string; name: string }[]
+}
+
+/** POST /llm-remove 请求：移除一个提供方（unset key + 移除 llm-pi-ai 路由）。 */
+export interface RemoveProviderRequest {
+  provider: string
+  /** 该提供方对应的 DSH 凭据引用名（用于 unset）。 */
+  apiKeyEnv?: string
+}
+
+/** POST /llm-remove 响应。 */
+export interface RemoveProviderResponse {
+  ok: boolean
+  message?: string
+}
+
+/** POST /llm-add 请求：添加一个模型（厂商直填 key，或自定义路由）。 */
+export interface AddModelRequest {
+  mode: 'vendor' | 'custom'
+  /** 厂商模式用：provider 路由 id（来自 /llm-vendors）。 */
+  vendor?: string
+  /** 厂商已知的 DSH 凭据引用名（可选；为空时 host 生成）。 */
+  apiKeyEnv?: string
+  /** 自定义模式用：provider 路由 id。 */
+  provider?: string
+  /** 模型 id。 */
+  model: string
+  /** API Key。 */
+  apiKey: string
+  /** 展示名（可选）。 */
+  name?: string
+  /** 自定义模式用：OpenAI 兼容 base URL。 */
+  baseURL?: string
+}
+
+/** POST /llm-add 响应。 */
+export interface AddModelResponse {
+  ok: boolean
+  saved: SavedModel
+  provider: string
+  message?: string
+}
+
+/** 手动添加的模型库条目（只存插件内，不改 DSH 全局）。 */
 export interface NovelConfig {
   /** Absolute path of the default docx outline to load. */
   outlinePath: string
@@ -1278,6 +1434,8 @@ export interface NovelConfig {
   themeOpacity?: number
   /** 是否启用改编模式（默认关闭；发布后开启）。 */
   enableAdaptMode?: boolean
+  /** 手动添加的模型库（「我的模型」条目；只存插件内）。 */
+  savedModels?: SavedModel[]
 }
 
 /** GET /status response. */
@@ -1503,6 +1661,8 @@ export interface ConfigPatch {
   enableAdaptMode?: boolean
   /** 生图模型库（完整替换保存）。 */
   imageModels?: ImageModelConfig[]
+  /** 手动添加的模型库（完整替换保存）。 */
+  savedModels?: SavedModel[]
 }
 
 // ------------------------------------------------------------ assistant