@waterwx/dsh-novel-forge 1.7.3 → 1.8.0

package/src/client/panel/SettingsView.tsx

@@ -0,0 +1,285 @@
+/**
+ * 共享设置页（作者首页「设置」与书内「设置」同入口）。
+ * 自给自足：挂载时通过 api.status() 拉取全局配置，支持 model/writing/image/files/appearance 五组，
+ * 保存走 api.patchConfig。不与某个书绑定，因此新装用户无书也能用。
+ */
+import { useEffect, useRef, useState } from 'react'
+import { Brain, PenLine, Palette, Folder, Sparkles, RotateCcw, PlugZap, Plus, Trash2, Upload, X, Image } from 'lucide-react'
+import type { NovelApi } from '../api.ts'
+import type { NovelConfig, ImageModelConfig } from '../../protocol.ts'
+import { tt } from './helpers.ts'
+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 }> = [
+  { 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 ThemeMode = 'system' | 'light' | 'dark'
+type ThemeName = 'liquid' | 'neumorph' | 'macos' | 'clay'
+type ThemeDensity = 'comfort' | 'compact' | 'spacious'
+
+function readLS<T extends string>(key: string, fallback: T, allowed: readonly T[]): T {
+  try {
+    const v = window.localStorage.getItem(key) as T | null
+    return v !== null && (allowed as readonly string[]).includes(v) ? v : fallback
+  } catch { return fallback }
+}
+
+export function SettingsView({ api, onTheme, onSettingsTab, onEditorFontSize, onBackground, onOpacity }: {
+  api: NovelApi;
+  onTheme?: (theme: ThemeName, mode: ThemeMode, density: ThemeDensity) => void;
+  onSettingsTab?: (tab: SettingsTab) => void;
+  onEditorFontSize?: (n: number) => void;
+  onBackground?: (bg: string | undefined, blur: number) => void;
+  onOpacity?: (n: number) => void;
+}) {
+  const [config, setConfig] = useState<NovelConfig | null>(null);
+  const [configDraft, setConfigDraft] = useState<NovelConfig | null>(null);
+  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 [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));
+  const [themeMode, setThemeMode] = useState<ThemeMode>(() => readLS<ThemeMode>('dsh-novel-forge.theme.mode', 'system', ['system','light','dark'] as const));
+  const [themeDensity, setThemeDensity] = useState<ThemeDensity>(() => readLS<ThemeDensity>('dsh-novel-forge.theme.density', 'comfort', ['comfort','compact','spacious'] as const));
+
+  const loadConfig = async (): Promise<void> => {
+    try {
+      const res = await api.status();
+      setConfig(res.config);
+      setConfigDraft(res.config);
+    } catch (err) { setError((err as Error).message) }
+  };
+  useEffect(() => { void loadConfig() }, []);
+
+  useEffect(() => { try { window.localStorage.setItem('dsh-novel-forge.settings.tab', settingsTab) } catch { /* ignore */ } }, [settingsTab]);
+
+  const changeSettingsTab = (next: SettingsTab): void => { setSettingsTabState(next); onSettingsTab?.(next) };
+
+  const save = async (): Promise<void> => {
+    if (configDraft === null) return;
+    setBusy(true); setError(''); setNotice('');
+    try {
+      const result = await api.patchConfig({
+        outlinePath: configDraft.outlinePath,
+        outputDir: configDraft.outputDir,
+        provider: configDraft.provider,
+        model: configDraft.model,
+        reasoningEffort: configDraft.reasoningEffort ?? 'off',
+        chapterChars: configDraft.chapterChars,
+        maxTokens: configDraft.maxTokens,
+        reviewPassScore: configDraft.reviewPassScore,
+        autoReview: configDraft.autoReview,
+        autoAuthorReview: configDraft.autoAuthorReview,
+        autoReviewAfterRevise: configDraft.autoReviewAfterRevise,
+        imageApiKey: configDraft.imageApiKey,
+        imageApiModel: configDraft.imageApiModel,
+        imageApiEnabled: configDraft.imageApiEnabled ?? false,
+        themeBackground: configDraft.themeBackground ?? '',
+        themeBackgroundBlur: configDraft.themeBackgroundBlur ?? 0,
+        themeOpacity: configDraft.themeOpacity ?? 100,
+        imageModels: configDraft.imageModels ?? [],
+      });
+      setConfig(result.config);
+      setConfigDraft(result.config);
+      setNotice(tt('settings.saved'));
+    } catch (err) { setError((err as Error).message) } finally { setBusy(false) }
+  };
+
+  // 生图模型操作
+  const patchImageModel = (id: string, patch: Partial<ImageModelConfig>): void => {
+    setConfigDraft(prev => prev === null ? prev : { ...prev, imageModels: (prev.imageModels ?? []).map(m => m.id === id ? { ...m, ...patch } : m) })
+  };
+  const addImageModel = (): void => {
+    setConfigDraft(prev => prev === null ? prev : { ...prev, imageModels: [...(prev.imageModels ?? []), { id: 'img-' + Date.now().toString(36), name: '', baseURL: '', apiKey: '', model: '', enabled: (prev.imageModels ?? []).length === 0 }] })
+  };
+  const removeImageModel = (id: string): void => {
+    setConfigDraft(prev => prev === null ? prev : { ...prev, imageModels: (prev.imageModels ?? []).filter(m => m.id !== id) })
+  };
+  const enableImageModel = (id: string): void => {
+    setConfigDraft(prev => prev === null ? prev : { ...prev, imageModels: (prev.imageModels ?? []).map(m => ({ ...m, enabled: m.id === id })) })
+  };
+  const testImageModel = async (m: ImageModelConfig): Promise<void> => {
+    if (m.baseURL.trim() === '' || m.apiKey.trim() === '') { setImageTestState(prev => ({ ...prev, [m.id]: { testing: false, ok: false, message: '请先填写接口地址和 API Key' } })); return }
+    setImageTestState(prev => ({ ...prev, [m.id]: { testing: true } }));
+    try { const r = await api.imageTest({ baseURL: m.baseURL, apiKey: m.apiKey, model: m.model }); setImageTestState(prev => ({ ...prev, [m.id]: { testing: false, ok: r.ok, ms: r.ms, message: r.message } })) } catch (err) { setImageTestState(prev => ({ ...prev, [m.id]: { testing: false, ok: false, message: (err as Error).message } })) }
+  };
+
+  // 主题/密度/字号（写 localStorage，可选通知父级）
+  const changeTheme = (theme: ThemeName, mode: ThemeMode, density: ThemeDensity): void => {
+    setPanelTheme(theme); setThemeMode(mode); setThemeDensity(density);
+    try {
+      window.localStorage.setItem('dsh-novel-forge.theme', theme);
+      window.localStorage.setItem('dsh-novel-forge.theme.mode', mode);
+      window.localStorage.setItem('dsh-novel-forge.theme.density', density);
+    } catch { /* ignore */ }
+    onTheme?.(theme, mode, density);
+  };
+  const changeEditorFont = (n: number): void => {
+    const v = Math.min(24, Math.max(12, n)); setEditorFontSize(v);
+    try { window.localStorage.setItem('dsh-novel-forge.editor.fontSize', String(v)) } catch { /* ignore */ }
+    onEditorFontSize?.(v);
+  };
+  const bgFileRef = useRef<HTMLInputElement | null>(null);
+  const applyBackground = (bg: string | undefined): void => {
+    setConfigDraft(prev => prev === null ? prev : { ...prev, themeBackground: bg ?? '' });
+    onBackground?.(bg ?? undefined, configDraft?.themeBackgroundBlur ?? 0);
+  };
+  const applyBlur = (blur: number): void => {
+    setConfigDraft(prev => prev === null ? prev : { ...prev, themeBackgroundBlur: blur });
+    onBackground?.(configDraft?.themeBackground ?? undefined, blur);
+  };
+  const applyOpacity = (n: number): void => {
+    setConfigDraft(prev => prev === null ? prev : { ...prev, themeOpacity: n });
+    onOpacity?.(n);
+  };
+  const onBgFile = async (file: File | undefined): Promise<void> => {
+    if (file === undefined) return;
+    const dataUrl = await new Promise<string>((resolve, reject) => {
+      const fr = new FileReader();
+      fr.onload = () => resolve(fr.result as string);
+      fr.onerror = () => reject(fr.error ?? new Error('读取失败'));
+      fr.readAsDataURL(file);
+    });
+    try {
+      // 上传到服务端存盘，返回可访问 URL（不往 settings.yaml 塞大 base64）。
+      const res = await api.themeBackgroundUpload(dataUrl);
+      applyBackground(res.url);
+    } catch (err) {
+      setError((err as Error).message);
+    }
+  };
+  const resetTheme = (): void => {
+    try { window.localStorage.removeItem('dsh-novel-forge.theme'); window.localStorage.removeItem('dsh-novel-forge.theme.mode'); window.localStorage.removeItem('dsh-novel-forge.theme.density') } catch { /* ignore */ }
+    changeTheme('liquid', 'system', 'comfort');
+  };
+
+  if (configDraft === null) {
+    return (
+      <div className={css.authorPageBody}><div className={css.meta}>正在加载设置…</div>{error !== '' && <div className={css.noticeError}>{error}</div>}</div>
+    );
+  }
+
+  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>
+
+      <div className={css.row} style={{ gap: 'var(--nf-space-8)', flexWrap: 'wrap' }}>
+        {SETTINGS_SECTIONS.map(s => (
+          <button key={s.id} type="button" className={css.button + (settingsTab === s.id ? ' ' + css.buttonPrimary : '')} style={{ flex: 1, minWidth: 104, justifyContent: 'center' }} onClick={() => changeSettingsTab(s.id)}>{s.icon} {s.label}</button>
+        ))}
+      </div>
+
+      {error !== '' && <div className={css.noticeError}>{error}</div>}
+      {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>
+      )}
+
+      {settingsTab === 'writing' && (
+        <div className={css.card + ' ' + css.settingsCard} style={{ gap: 'var(--nf-space-24)' }}>
+          <span className={css.cardTitle}><PenLine size={18} style={{ verticalAlign: -3 }} /> 写作与审稿</span>
+          <div className={css.field}><label className={css.fieldLabel}>{tt('settings.chapterChars')}</label><input className={css.input} type="number" min={1000} max={20000} value={configDraft.chapterChars} onChange={e => setConfigDraft({ ...configDraft, chapterChars: Number(e.target.value) })} /></div>
+          <div className={css.field}><label className={css.fieldLabel}>{tt('settings.maxTokens')}</label><input className={css.input} type="number" min={2000} max={64000} value={configDraft.maxTokens} onChange={e => setConfigDraft({ ...configDraft, maxTokens: Number(e.target.value) })} /></div>
+          <div className={css.field}><label className={css.fieldLabel}>{tt('settings.reviewPassScore')}</label><input className={css.input} type="number" min={0} max={100} value={configDraft.reviewPassScore} onChange={e => setConfigDraft({ ...configDraft, reviewPassScore: Number(e.target.value) })} /><span className={css.meta}>通过判定：综合评分 ≥ 此分数（默认 70），或无 high 级问题且评分 ≥ 60；建议设 60-80。</span></div>
+          <div className={css.field}><label className={css.fieldLabel}>{tt('settings.autoReview')}</label><select className={css.input} value={configDraft.autoReview ? '1' : '0'} onChange={e => setConfigDraft({ ...configDraft, autoReview: e.target.value === '1' })}><option value="1">✓ 是</option><option value="0">✗ 否</option></select></div>
+          <div className={css.field}><label className={css.fieldLabel}>{tt('settings.autoAuthorReview')}</label><select className={css.input} value={configDraft.autoAuthorReview ? '1' : '0'} onChange={e => setConfigDraft({ ...configDraft, autoAuthorReview: e.target.value === '1' })}><option value="1">✓ 是</option><option value="0">✗ 否</option></select><span className={css.meta}>{tt('settings.autoAuthorReviewHint')}</span></div>
+          <div className={css.field}><label className={css.fieldLabel}>{tt('settings.autoReviewAfterRevise')}</label><select className={css.input} value={configDraft.autoReviewAfterRevise ? '1' : '0'} onChange={e => setConfigDraft({ ...configDraft, autoReviewAfterRevise: e.target.value === '1' })}><option value="1">✓ 是</option><option value="0">✗ 否</option></select><span className={css.meta}>{tt('settings.autoReviewAfterReviseHint')}</span></div>
+          <div className={css.field}><label className={css.fieldLabel}>编辑器字号（正文编辑 / 工作区）</label><select className={css.input} value={editorFontSize} onChange={e => changeEditorFont(Number(e.target.value))}>{[12,13,14,15,16,18,20,22,24].map(v => <option key={v} value={v}>{v}px</option>)}</select></div>
+        </div>
+      )}
+
+      {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>
+          <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' }}>
+              <div className={css.row} style={{ alignItems: 'flex-end', flexWrap: 'wrap' }}>
+                <div className={css.field} style={{ flex: 1, minWidth: 160 }}><label className={css.fieldLabel}>名称</label><input className={css.input} value={m.name} onChange={e => patchImageModel(m.id, { name: e.target.value })} /></div>
+                <div className={css.field} style={{ flex: 1, minWidth: 150 }}><label className={css.fieldLabel}>模型 id</label><input className={css.input} value={m.model} onChange={e => patchImageModel(m.id, { model: e.target.value })} /></div>
+                <div className={css.field} style={{ flex: 1, minWidth: 200 }}><label className={css.fieldLabel}>接口地址</label><input className={css.input} value={m.baseURL} onChange={e => patchImageModel(m.id, { baseURL: e.target.value })} /></div>
+              </div>
+              <div className={css.field}><label className={css.fieldLabel}>API Key</label><input className={css.input} type="password" value={m.apiKey} onChange={e => patchImageModel(m.id, { apiKey: e.target.value })} /></div>
+              <div className={css.row} style={{ gap: 'var(--nf-space-8)', flexWrap: 'wrap', alignItems: 'center' }}>
+                <button type="button" className={css.button + ' ' + css.buttonSmall + (m.enabled ? ' ' + css.buttonPrimary : '')} onClick={() => enableImageModel(m.id)}>{m.enabled ? '✓ 已启用' : '设为启用'}</button>
+                <button type="button" className={css.button + ' ' + css.buttonSmall} disabled={imageTestState[m.id]?.testing === true} onClick={() => { void testImageModel(m) }}><PlugZap size={13} style={{ verticalAlign: -2 }} /> {imageTestState[m.id]?.testing === true ? '测试中…' : '测试'}</button>
+                <button type="button" className={css.button + ' ' + css.buttonSmall} onClick={() => removeImageModel(m.id)}><Trash2 size={13} style={{ verticalAlign: -2 }} /> 删除</button>
+              </div>
+            </div>
+          ))}
+          <div className={css.row}><button type="button" className={css.button} onClick={addImageModel}><Plus size={13} style={{ verticalAlign: -2 }} /> 添加生图模型</button></div>
+        </div>
+      )}
+
+      {settingsTab === 'files' && (
+        <div className={css.card + ' ' + css.settingsCard} style={{ gap: 'var(--nf-space-24)' }}>
+          <span className={css.cardTitle}><Folder size={18} style={{ verticalAlign: -3 }} /> 路径与文件</span>
+          <div className={css.field}><label className={css.fieldLabel}>{tt('settings.outlinePath')}</label><input className={css.input} value={configDraft.outlinePath} onChange={e => setConfigDraft({ ...configDraft, outlinePath: e.target.value })} /></div>
+          <div className={css.field}><label className={css.fieldLabel}>{tt('settings.outputDir')}</label><input className={css.input} value={configDraft.outputDir} onChange={e => setConfigDraft({ ...configDraft, outputDir: e.target.value })} /></div>
+          <div className={css.row}><button type="button" className={css.button} onClick={() => { void api.openFolder() }}>{tt('settings.openFolder')}</button></div>
+        </div>
+      )}
+
+      {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>
+          <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>
+    </div>
+  );
+}

package/src/client/panel/panel.module.css

@@ -41,6 +41,8 @@ body[data-ds-dark-theme] .entry {
   align-items: center;
   justify-content: center;
   flex-shrink: 0;
+  width: 20px;
+  height: 20px;
 }
 
 .entryLabel {
@@ -658,6 +660,7 @@ body[data-ds-dark-theme] .panel[data-nf-theme='neumorph'] .buttonPrimary {
   z-index: 0;
   pointer-events: none;
   background:
+    linear-gradient(rgba(0, 0, 0, calc(var(--nf-glass-bg-dim, 0) / 100)), rgba(0, 0, 0, calc(var(--nf-glass-bg-dim, 0) / 100))),
     var(--nf-glass-bg-image, none) center / cover no-repeat,
     radial-gradient(46% 36% at 18% 12%, var(--nf-glass-orb-a), transparent 70%),
     radial-gradient(52% 42% at 88% 22%, var(--nf-glass-orb-b), transparent 72%),
@@ -981,6 +984,10 @@ body[data-ds-dark-theme] .panel[data-nf-theme='neumorph'] .buttonPrimary {
 .navTabIcon {
   flex: none;
   width: 22px;
+  height: 22px;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
   text-align: center;
   font-size: var(--nf-fs-16, 17px);
   line-height: 1;
@@ -2079,6 +2086,28 @@ select.input {
   gap: var(--nf-space-10, 10px);
 }
 
+/* 按分类分组的资产列表 */
+.assetGroups {
+  display: flex;
+  flex-direction: column;
+  gap: var(--nf-space-14, 14px);
+}
+.assetGroup {
+  display: flex;
+  flex-direction: column;
+  gap: var(--nf-space-10, 10px);
+}
+.assetGroupHeader {
+  font-size: 14px;
+  font-weight: 600;
+  color: var(--nf-accent);
+  padding-bottom: 2px;
+  border-bottom: 1px solid var(--nf-glass-border);
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
 .assetStat {
   border: 1px solid var(--nf-glass-border);
   border-radius: var(--nf-radius-14, 14px);
@@ -2498,6 +2527,279 @@ select.input {
   gap: var(--nf-container-gap, 14px);
 }
 
+/* ---- 作者级首页（书架左侧导航 + 内容区） ---- */
+.authorHome {
+  display: flex;
+  flex: 1;
+  min-height: 0;
+  overflow: hidden;
+  position: relative;
+  z-index: 1;
+}
+.authorRail {
+  width: 180px;
+  flex-shrink: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding: 14px 10px;
+  border-right: 1px solid var(--nf-glass-border);
+  background: var(--nf-glass-face);
+}
+.authorRailTitle {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  font-weight: 600;
+  padding: 4px 8px 12px;
+  color: var(--nf-accent);
+}
+.authorRailBtn {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 8px 12px;
+  border-radius: 10px;
+  background: transparent;
+  border: 1px solid transparent;
+  color: var(--nf-text);
+  cursor: pointer;
+  text-align: left;
+  width: 100%;
+  font-size: 14px;
+}
+.authorRailBtn:hover { background: color-mix(in srgb, var(--nf-accent) 12%, transparent); color: var(--nf-text); }
+.authorRailBtnActive {
+  background: color-mix(in srgb, var(--nf-accent) 16%, var(--nf-glass-face));
+  border-color: var(--nf-accent);
+  color: var(--nf-accent);
+  font-weight: 600;
+  box-shadow: inset 0 0 0 1px var(--nf-accent);
+}
+.authorRailAbout { padding: 8px 12px; }
+.authorContent { flex: 1; min-width: 0; display: flex; flex-direction: column; overflow: hidden; }
+
+/* ---- 作者级页面通用 ---- */
+.authorPageBody {
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+  padding: var(--nf-container-pad, 20px 22px);
+  overflow: auto;
+  flex: 1;
+  min-height: 0;
+}
+.authorPageHeader {
+  display: flex;
+  align-items: flex-end;
+  justify-content: space-between;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.authorPageHero {
+  display: flex;
+  flex-direction: column;
+  gap: var(--nf-space-12, 12px);
+  padding: var(--nf-card-pad, 20px 22px);
+  border: 1px solid var(--nf-glass-border);
+  border-radius: var(--nf-radius-22, 22px);
+  background: var(--nf-glass-face);
+  box-shadow: var(--nf-shadow), inset 0 1.5px 0 var(--nf-glass-sheen);
+  -webkit-backdrop-filter: blur(26px) saturate(175%);
+  backdrop-filter: blur(26px) saturate(175%);
+}
+.noticeError {
+  padding: 10px 14px;
+  border-radius: 10px;
+  background: color-mix(in srgb, var(--nf-error) 14%, transparent);
+  color: var(--nf-error);
+  border: 1px solid var(--nf-error);
+}
+.rowEnd { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
+
+/* ---- 作者资产库 ---- */
+.assetFilterBar { display: flex; flex-wrap: wrap; gap: 8px; }
+.assetFilterChip {
+  padding: 4px 10px;
+  border-radius: 999px;
+  border: 1px solid var(--nf-glass-border);
+  background: transparent;
+  color: var(--nf-text);
+  cursor: pointer;
+}
+.assetFilterChipActive { background: var(--nf-accent); color: #fff; border-color: transparent; }
+.assetEditor {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  padding: 16px;
+  border: 1px solid var(--nf-glass-border);
+  border-radius: 14px;
+  background: var(--nf-glass-face);
+}
+.assetEditorRow { display: flex; gap: 12px; flex-wrap: wrap; }
+.assetLabel {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  font-size: 12px;
+  color: var(--nf-muted);
+  flex: 1;
+  min-width: 180px;
+}
+.assetTextarea { min-height: 160px; resize: vertical; font-family: inherit; }
+.assetGrid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(300px, 1fr));
+  gap: 14px;
+}
+.assetCard {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 14px;
+  border: 1px solid var(--nf-glass-border);
+  border-radius: 14px;
+  background: var(--nf-glass-face);
+  box-shadow: var(--nf-shadow), inset 0 1px 0 var(--nf-glass-sheen);
+}
+.assetCardTop { display: flex; align-items: center; justify-content: space-between; gap: 8px; }
+.assetKind { font-size: 12px; font-weight: 600; }
+.assetCardName { font-weight: 600; }
+.assetCardContent { white-space: pre-wrap; font-size: 13px; color: var(--nf-text); max-height: 150px; overflow: auto; }
+.assetCardFooter { display: flex; flex-wrap: wrap; gap: 6px; align-items: center; }
+.iconBtn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  padding: 4px;
+  border: 1px solid transparent;
+  background: transparent;
+  border-radius: 8px;
+  color: var(--nf-text);
+  cursor: pointer;
+}
+.iconBtn:hover { background: rgba(0,0,0,0.06); }
+
+/* ---- 改编模式 ---- */
+.adaptInputCard {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  padding: 16px;
+  border: 1px solid var(--nf-glass-border);
+  border-radius: 14px;
+  background: var(--nf-glass-face);
+}
+.adaptTextarea { min-height: 220px; resize: vertical; }
+.adaptResult { display: flex; flex-direction: column; gap: 14px; }
+.adaptOutline {
+  padding: 10px 14px;
+  border-radius: 12px;
+  background: var(--nf-glass-face);
+  border: 1px solid var(--nf-glass-border);
+}
+.adaptMatrix {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(320px, 1fr));
+  gap: 12px;
+}
+.dimCard {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 14px;
+  border: 1px solid var(--nf-glass-border);
+  border-radius: 14px;
+  background: var(--nf-glass-face);
+}
+.dimCardHead { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; }
+.dimTitle { font-weight: 600; }
+.dimCurrent { font-size: 13px; white-space: pre-wrap; }
+.dimCardSelected { border-color: var(--nf-accent); box-shadow: 0 0 0 1px var(--nf-accent); }
+.dimEdit { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
+.adaptOutlinePre { white-space: pre-wrap; font-size: 13px; max-height: 260px; overflow: auto; margin: 0; font-family: inherit; }
+.adaptProposal {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 14px;
+  border: 1px solid var(--nf-glass-border);
+  border-radius: 14px;
+  background: var(--nf-glass-face);
+}
+.adaptTable { width: 100%; border-collapse: collapse; font-size: 13px; }
+.adaptTable th, .adaptTable td { border: 1px solid var(--nf-glass-border); padding: 6px 8px; text-align: left; }
+.adaptImpacts { display: flex; flex-direction: column; gap: 4px; }
+.adaptImpact { font-size: 13px; }
+
+/* ---- 首页 AI 进度 ---- */
+.progressOverview {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(140px, 1fr));
+  gap: 12px;
+}
+.progressOverviewCard {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding: 14px;
+  border: 1px solid var(--nf-glass-border);
+  border-radius: 14px;
+  background: var(--nf-glass-face);
+  box-shadow: var(--nf-shadow), inset 0 1px 0 var(--nf-glass-sheen);
+}
+.progressOverviewNum {
+  font-size: 24px;
+  font-weight: 700;
+  color: var(--nf-accent);
+}
+.progressTotalBar {
+  position: relative;
+  height: 14px;
+  border-radius: 999px;
+  background: var(--nf-glass-face);
+  border: 1px solid var(--nf-glass-border);
+  overflow: hidden;
+}
+.progressTotalFill {
+  position: absolute;
+  inset: 0 auto 0 0;
+  height: 100%;
+  background: linear-gradient(90deg, var(--nf-accent), var(--nf-info));
+  border-radius: 999px;
+}
+.progressTotalBar .meta {
+  position: absolute;
+  inset: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 11px;
+  font-weight: 600;
+  color: var(--nf-text);
+}
+.progressBookList {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+.progressBook {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 14px;
+  border: 1px solid var(--nf-glass-border);
+  border-radius: 14px;
+  background: var(--nf-glass-face);
+}
+.progressBookActive { border-color: var(--nf-accent); box-shadow: 0 0 0 1px var(--nf-accent); }
+.progressBookHead { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; }
+.progressBookName { font-weight: 600; }
+.progressLive { color: var(--nf-accent); font-weight: 600; }
+.progressBookBar { height: 8px; border-radius: 999px; background: var(--nf-glass-face-hover, rgba(0,0,0,0.05)); overflow: hidden; }
+.progressBookFill { height: 100%; background: var(--nf-accent); border-radius: 999px; }
+
 .shelfHeader {
   display: flex;
   flex-direction: column;
@@ -3847,3 +4149,26 @@ select.input {
 .switchOn .switchKnob {
   transform: translateX(18px);
 }
+
+/* ---- 玻璃透明度滑块：实色主题（新拟态/黏土）调低时变透，透出背景图 ---- */
+/* 默认 --nf-glass-opacity=100%，color-mix 透明 0% → 与主题原值一致，不改动现有效果。 */
+.panel[data-nf-theme='neumorph']:not([data-nf-mode='dark']),
+body:not([data-ds-dark-theme]) .panel[data-nf-theme='neumorph'][data-nf-mode='light'] {
+  --nf-glass-face: color-mix(in srgb, #e4e9f2, transparent calc(100% - var(--nf-glass-opacity, 100%)));
+  --nf-bg-raise: color-mix(in srgb, #e4e9f2, transparent calc(100% - var(--nf-glass-opacity, 100%)));
+}
+.panel[data-nf-mode='dark'][data-nf-theme='neumorph'],
+body[data-ds-dark-theme] .panel[data-nf-theme='neumorph']:not([data-nf-mode]) {
+  --nf-glass-face: color-mix(in srgb, #2b2f36, transparent calc(100% - var(--nf-glass-opacity, 100%)));
+  --nf-bg-raise: color-mix(in srgb, #2b2f36, transparent calc(100% - var(--nf-glass-opacity, 100%)));
+}
+.panel[data-nf-theme='clay']:not([data-nf-mode='dark']),
+body:not([data-ds-dark-theme]) .panel[data-nf-theme='clay'][data-nf-mode='light'] {
+  --nf-glass-face: color-mix(in srgb, #efe4d6, transparent calc(100% - var(--nf-glass-opacity, 100%)));
+  --nf-bg-raise: color-mix(in srgb, #efe4d6, transparent calc(100% - var(--nf-glass-opacity, 100%)));
+}
+.panel[data-nf-mode='dark'][data-nf-theme='clay'],
+body[data-ds-dark-theme] .panel[data-nf-theme='clay']:not([data-nf-mode]) {
+  --nf-glass-face: color-mix(in srgb, #37302b, transparent calc(100% - var(--nf-glass-opacity, 100%)));
+  --nf-bg-raise: color-mix(in srgb, #37302b, transparent calc(100% - var(--nf-glass-opacity, 100%)));
+}

package/src/client/sidebar-entry.ts

@@ -11,7 +11,7 @@ import css from './panel/panel.module.css'
 export const ENTRY_SELECTOR = '[data-dsh-novelforge-entry]'
 
 /** Inline icon: an open book / writing glyph. */
-const ICON = '<svg viewBox="0 0 16 16" width="14" height="14" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M2.5 3.5h4a2 2 0 0 1 2 2v7a2 2 0 0 0-2-2h-4z"/><path d="M13.5 3.5h-4a2 2 0 0 0-2 2v7a2 2 0 0 1 2-2h4z"/><path d="M8 5.5v7"/></svg>'
+const ICON = '<svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M12.67 19a2 2 0 0 0 1.416-.588l6.154-6.172a6 6 0 0 0-8.49-8.49L5.586 9.914A2 2 0 0 0 5 11.328V18a1 1 0 0 0 1 1z"/><path d="M16 8 2 22"/><path d="M17.5 15H9"/></svg>'
 
 /** Find the sidebar shell root element. */
 function sidebarRoot(): HTMLElement | undefined {